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.
어디에서 찾을 수 있나요?
- 기준 치수: 플랫폼
- 그룹: 오토메이션
- 부분: Extension Hooks
- 화면: Extension Hooks
콘솔에 표시된 주소: /platform/extension-hooks
목록 · 11 컬럼 · 15 그 양식의 필드 · 4 그중 필요한 것들 · 4 행위
목록이 보여주는 것
다음은 목록의 열이며, 표시된 순서대로 나열되어 있습니다. 각 열은 정렬, 필터링, 숨기기 또는 내보내기가 가능합니다.
| 열 | 친절한 | 필드 이름 |
|---|---|---|
| Hook | 텍스트 | name |
| Point | 상태 | point |
| 기준 치수 | 암호 | module_key |
| 화면 | 암호 | resource_key |
| 하다 | 상태 | action_kind |
| 방법 | 상태 | mode |
| 실행 | 숫자 | run_count |
| 거부됨 | 숫자 | veto_count |
| 오류 | 숫자 | error_count |
| ~에 | 예 또는 아니오 | is_active |
| Last problem | 텍스트 | last_error |
양식
레코드를 생성할 때 요청되는 정보입니다. 필수 필드는 표시되어 있으며, 구성 목록에서 선택하는 경우 관리자는 릴리스 없이도 기능을 확장할 수 있습니다.
| 필드 | 유형 | 선택 | 메모 |
|---|---|---|---|
| 이름 필수의 | 텍스트 | A name people will recognise in the run log. | |
| 이것은 무엇을 위한 것인가 | 긴 글 | Why this rule exists. | |
| Point 필수의 | 선택 | 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. |
| 화면 필수의 | 선택 | 기존 기록에서 조회함 | 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). |
| 하다 필수의 | 선택 | 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. |
| 상태 | 긴 글 | 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. | |
| 메시지 | 텍스트 | What a person is told. {field} is replaced by the record's value. | |
| Message (as an expression) | 텍스트 | Optional: work the message out, e.g. concat("Over budget by ", total - 10000). | |
| Only when moving to | 텍스트 | For the status points: comma-separated statuses; empty means any move. | |
| 웹훅 | 선택 | 기존 기록에서 조회함 | One of this company's outbound webhooks. It signs and screens the target like every delivery. |
| What is sent | 텍스트 | A set of named expressions, e.g. {"number": "record_no", "total": "total"}. Empty sends the record without personal or secret fields. | |
| 주문하다 | 숫자 | Hooks at the same point run in this order. | |
| Time budget (ms) | 숫자 | 10 to 500. A run over it is skipped and counted as an error. | |
| Runs per minute | 숫자 | A ceiling for warnings, sends and log lines (a refusal is never throttled). | |
| ~에 | 예 또는 아니오 | A hook that fails ten runs in a row is switched off with the reason; switch it on again after fixing it. |
여기서 할 수 있는 일
시험 주요한
Try this hook without running it
요청 사항: Sample record (JSON) Or a real record id
Switch live
확인을 요청합니다: Switch this hook live? It will refuse, warn or send on real saves from now on.
Back to dry run
확인을 요청합니다: Put this hook back in dry run? It stops acting at once and is only evaluated and logged.
Run log
여기에 적용되는 규칙
이 화면의 모든 항목은 자체 규칙이 아닌 플랫폼 규칙을 따릅니다. 사용하기 전에 알아두면 좋은 규칙은 다음과 같습니다.
- 목록 좁히기 — 검색, 조건 설정, 정렬, 합계, 내보내기 및 저장된 보기 기능.
- 무엇이 바뀔 수 있을까요? — 음반을 수정할 수 없는 다섯 가지 사유.
- 회사 및 사업부 — 이 목록 위에 있는 스위처가 무엇을 하고 있는지.
- 레코드 생성 — 필수 입력 항목, 선택 항목의 출처 및 개수 할당 방식.
- 스프레드시트 가져오기 — 이 화면은 하나의 입력을 받으며, 타이핑할 때와 동일한 규칙을 따릅니다.