알림 효과
알림 효과는 조건이 충족되었을 때 사용자나 그룹에 플랫폼 알림과 전자우편을 보냅니다. 본문은 화면에서 정적으로 정의하거나 함수로 생성할 수 있으며, PDF 첨부 또는 본문에 삽입하는 이미지를 추가할 수 있습니다.
객체를 묶는 방식
객체 추가, 제거, 수정 조건이 제공하는 영향받은 객체를 어떻게 묶을지 선택합니다.
| 모드 | 수신자별 알림 수와 함수 입력 |
|---|---|
| Execute once for all objects | 같은 시점에 발동시킨 객체 전체를 한 번 알립니다. 함수는 전체 객체 집합을 받습니다. |
| Execute once for each group of objects | 선택한 속성 값이 같은 그룹마다 알립니다. 함수는 해당 그룹의 객체 집합을 받습니다. |
| Execute once for each object | 객체마다 알립니다. 함수는 개별 객체와 그 속성 값을 사용할 수 있습니다. |
Support Ticket 3개가 함께 발동한 전체 실행 예에서는 수신자마다 한 번 알리고, 함수에 티켓 3개의 집합을 전달합니다.
Category로 그룹을 나누고 Billing 티켓 2개와 Technical Support 티켓 1개가 있다면 수신자마다 두 알림을 보냅니다. 첫 함수 호출에는 Billing 2개, 두 번째 호출에는 Technical Support 1개를 전달합니다.
그룹의 속성 값은 정확히 일치해야 합니다. 배열 속성도 원소의 순서까지 같아야 같은 그룹입니다.
객체별 실행에서는 티켓 3개에 대해 각각 별도 알림을 보냅니다.
수신자와 권한
수신자는 Foundry 사용자 또는 그룹입니다. 활성 사용자와 사전 등록 사용자 모두 다음 조건이 필요하며, 정적 수신자와 동적 수신자에게 같은 조건을 적용합니다.
- 자동화에 적어도 Viewer 권한이 있어야 합니다.
- 발동시킨 객체 인스턴스에 Viewer 권한이 있어야 합니다.
- 다중 데이터 소스 객체이면 해당 객체의 모든 속성에 Viewer 권한이 있어야 합니다.
- 함수 기반 알림이면 함수가 접근하는 모든 객체 인스턴스에 Viewer 권한이 있어야 합니다.
수동 실행은 트리거 조건을 우회하므로 트리거 객체에 대한 위 검사를 수행하지 않습니다. 입력 객체 집합 평가와 효과별 권한은 자동화 권한을 따릅니다.
정적 수신자
Static의 입력란에서 사용자나 그룹을 선택합니다.
객체 속성으로 결정
영향받은 객체 입력을 제공하는 객체 집합 조건이 있어야 합니다. 사용자 ID 또는 그룹 ID를 저장한 속성을 선택하며, 자료형은 String 또는 String 배열이어야 합니다.
다음 예는 Contract 수정 조건에서 사용자 ID 배열인 Contract Owners를 수신자 목록으로 사용합니다.
화면에서 본문 작성
Plain notification에는 Heading과 Message가 필수입니다. URL Link도 바꿀 수 있습니다. 기본값은 전자우편에 표시하는 플랫폼 내 알림 링크입니다.
Advanced email configuration을 사용하면 전자우편의 제목, 본문과 링크를 따로 설정할 수 있습니다. 기본적으로 플랫폼 알림의 Heading, Message와 URL Link를 사용하며 HTML도 사용할 수 있습니다.
데이터셋 조건에서는 Append dataset preview로 전자우편 본문에 최대 50행을 포함할 수 있습니다. 표시할 열을 선택하는 옵션도 제공합니다.
/를 입력하면 수신자 이름 같은 템플릿 값을 넣을 수 있습니다. 객체 조건의 Per-object execution에서는 객체 속성의 현재 값과 이전 값도 사용할 수 있지만, 이전 값은 실시간 감시에서만 제공합니다.
변경 사항은 오른쪽에서 미리 볼 수 있습니다. 알림은 수신자별로 렌더링하므로 각 사용자가 받는 내용이 다를 수 있습니다.
함수로 본문 생성
화면 템플릿으로 요구를 충족할 수 없을 때 알림 함수를 사용합니다. 함수는 Notification 또는 Notification | undefined를 반환해야 합니다. undefined를 반환하면 해당 알림을 보내지 않으므로 함수 안에서 발송 여부를 결정할 수 있습니다.
게시한 함수와 버전을 선택하면 필요한 입력이 표시됩니다.
함수의 User 입력에는 Recipient를 연결하여 현재 알림을 렌더링하는 수신자를 전달할 수 있습니다. 조건 입력도 연결할 수 있지만 함수 매개변수의 유형과 일치해야 합니다. 입력 형태는 조건과 객체 실행 모드에 따라 달라집니다.
다음 예는 Recipient와 Contract modified 입력을 함께 사용하여 수신자와 변경된 계약에 맞는 본문을 생성합니다.
첨부 파일
전자우편에는 Notepad 문서, Notepad 템플릿 또는 Contour 대시보드에서 생성한 파일을 첨부할 수 있습니다. 실행할 때 수신자별로 생성합니다.
첨부 영역에서 + Select로 리소스를 선택하고 File name을 지정합니다. 리소스 유형에 따라 필요한 입력을 더 제공합니다.
| 설정 | 동작 |
|---|---|
| Render Inline | 별도 PDF 대신 렌더링한 문서를 이미지로 전자우편 본문에 삽입합니다. |
| Attachment rendering locale | 날짜, 숫자와 텍스트를 렌더링할 로캘을 선택합니다. |
Notepad 템플릿 입력
템플릿과 Template version을 선택하면 필요한 Template Inputs가 표시됩니다. 정적 값과 조건 효과 입력을 전달할 수 있습니다. 객체나 객체 집합 입력에는 같은 유형의 조건 입력을 연결해야 합니다.
Notepad 템플릿은 객체 입력의 객체 유형 정보를 노출하지 않습니다. 값을 연결하는 사람이 실제 객체 유형이 일치하는지 확인해야 합니다.
다음 예는 Support tickets overview 템플릿의 support tickets 입력에 New Support Tickets를 연결합니다. 조건을 발동시킨 객체로 문서를 생성하여 PDF로 내보냅니다.