Extension Hooks
Rules attached to named points in a record's life: before or after it is saved, posted or approved, and when its status changes. A hook is a condition (the same expression language as custom rules) and one action: refuse with a message, warn, send on one of this company's webhooks, or write a log line. A hook cannot change a record or run code. New hooks start in dry run: evaluated and logged, never acting, until you switch them live. To fill in, work out, check, show or lock a field, use Custom Logic instead.
Dónde encontrarlo
- Módulo: Plataforma
- Grupo: Automatización
- Sección: Extension Hooks
- Pantalla: Extension Hooks
Dirección en la consola: /platform/extension-hooks
Lista · 11 columnas · 15 campos en su forma · 4 de ellos requerido · 4 comportamiento
Lo que muestra la lista
Estas son las columnas de la lista, en el orden en que aparecen. Cualquiera de ellas puede ordenarse, filtrarse, ocultarse o exportarse.
| Columna | Amable | Nombre del campo |
|---|---|---|
| Hook | Texto | name |
| Point | Estado | point |
| Módulo | Código | module_key |
| Pantalla | Código | resource_key |
| Hace | Estado | action_kind |
| Modo | Estado | mode |
| Corre | Número | run_count |
| Rechazado | Número | veto_count |
| Errores | Número | error_count |
| En | sí o no | is_active |
| Last problem | Texto | last_error |
El formulario
Aquí se solicita la información que aparece al crear un registro. Los campos obligatorios están marcados; una opción de la lista de configuración es una que el administrador puede modificar sin necesidad de una nueva versión.
| Campo | Tipo | Opciones | Notas |
|---|---|---|---|
| Nombre requerido | Texto | A name people will recognise in the run log. | |
| Para qué sirve | Texto largo | Why this rule exists. | |
| Point requerido | Elección | Before a record is saved, After a record is saved, Before a document is posted, After a document is posted, Before an approval is given, After an approval is given, Before the status changes, After the status changed | When in the record's life the hook runs. |
| Pantalla requerido | Elección | Consultado a partir de registros existentes | The screen whose records the hook watches, e.g. CRM › Accounts, or a custom object. "Every screen" covers the whole module (not for a hook that refuses). |
| Hace requerido | Elección | Refuse with a message (before points only), Warn but allow (before points only), Send on a webhook (after points only), Only write it in the run log | Only a before hook can refuse or warn; only an after hook can send. |
| Condición | Texto largo | When the hook acts, e.g. total > 10000 and is_empty(project_code). Empty means always. You may use record fields, previous, changed, status, to_status, user and today. | |
| Mensaje | Texto | What a person is told. {field} is replaced by the record's value. | |
| Message (as an expression) | Texto | Optional: work the message out, e.g. concat("Over budget by ", total - 10000). | |
| Only when moving to | Texto | For the status points: comma-separated statuses; empty means any move. | |
| Webhook | Elección | Consultado a partir de registros existentes | One of this company's outbound webhooks. It signs and screens the target like every delivery. |
| What is sent | Texto | A set of named expressions, e.g. {"number": "record_no", "total": "total"}. Empty sends the record without personal or secret fields. | |
| Orden | Número | Hooks at the same point run in this order. | |
| Time budget (ms) | Número | 10 to 500. A run over it is skipped and counted as an error. | |
| Runs per minute | Número | A ceiling for warnings, sends and log lines (a refusal is never throttled). | |
| En | sí o no | A hook that fails ten runs in a row is switched off with the reason; switch it on again after fixing it. |
Qué puedes hacer aquí
Prueba primario
Try this hook without running it
Solicita: Sample record (JSON) Or a real record id
Switch live
Solicita confirmación: Switch this hook live? It will refuse, warn or send on real saves from now on.
Back to dry run
Solicita confirmación: Put this hook back in dry run? It stops acting at once and is only evaluated and logged.
Run log
Las reglas que se aplican aquí
Todo lo que aparece en esta pantalla obedece a las reglas de la plataforma, no a reglas propias. Estas son las que conviene conocer antes de usarla:
- Reducir la lista — Búsqueda, condiciones, ordenación, totales, exportación y vistas guardadas.
- ¿Qué puede cambiar? — Los cinco motivos por los que no se puede editar un registro.
- Empresas y unidades de negocio — lo que el conmutador que está encima de esta lista le está haciendo.
- Crear un registro — campos obligatorios, de dónde provienen las opciones y cómo se asigna el número.
- Importar una hoja de cálculo — Esta pantalla acepta uno y sigue las mismas reglas que al escribir.