액션 알림의 수신자, 내용과 권한
액션(Action)의 Add new rule에서 Notification을 추가하고 수신자 및 내용을 구성합니다.
수신자 선택
알림은 Foundry 사용자별로 따로 보냅니다. 이메일의 CC 수신자 추가와 이메일 주소 직접 지정은 지원하지 않습니다.
| 방식 | 사용 방법 |
|---|---|
| Static | 항상 알릴 사용자 또는 그룹을 선택합니다. |
| From a parameter | Foundry 사용자 또는 그룹 ID 입력을 사용합니다. 앱에서 수신자를 선택하게 하거나 실행자를 지정하는 데 사용할 수 있습니다. |
| From an attribute of an object parameter | 객체 참조의 속성에 있는 사용자 또는 그룹 ID를 사용합니다. ID 목록도 지원합니다. |
| From a function | 액션 입력을 받아 수신자 또는 그룹 목록을 반환하는 게시 함수를 사용합니다. |
함수는 객체의 assignee와 고정 수신자를 결합하거나 EMEA와 North America에 따라 서로 다른 수신자를 고르는 등 구조화된 선택지만으로 표현하기 어려운 로직에 사용합니다.
그룹은 개인 사용자로 풀어 각자의 데이터 권한을 검사합니다. 정적 선택기에는 구성자가 볼 권한이 있는 사용자와 그룹만 표시합니다. ID는 Settings의 Account에서 확인할 수 있으며 객체 속성에는 ID 문자열을 저장합니다. 이름 표시는 사용자 ID 값 서식으로 구성할 수 있습니다.
수신자는 개인 설정에 따라 브라우저 알림만 받거나 이메일과 함께 받을 수 있습니다. 액션 알림을 꺼도 Workspace의 Notifications에서 See All로 저장된 알림을 볼 수 있습니다.
내용 생성 방식
Template은 대화상자에서 내용을 구성합니다. From a Function은 적절한 Notification 객체를 반환하는 게시 함수를 선택합니다.
템플릿에는 다음 구성 요소가 있습니다.
| 요소 | 동작 |
|---|---|
| Subject | 기본적으로 전달 채널에 공통으로 쓰는 제목입니다. |
| Body | 플랫폼 알림 안이나 이메일 본문에 표시합니다. |
| Link | 본문 아래의 버튼이며 레이블을 지정합니다. 기존 객체 입력, Workshop 앱, Carbon 작업 공간 또는 새로 만든 객체를 연결할 수 있습니다. |
| Advanced Email Configuration | 이메일 전용 HTML 본문을 별도로 구성합니다. 미리보기는 매개변수 참조가 치환된 결과를 포함하지 않습니다. 수신자가 이메일을 선택했을 때만 이 내용을 받습니다. |
제목, 본문과 링크에는 세 겹 중괄호 참조를 사용할 수 있습니다. 편집기에서 입력이나 사용자 속성을 선택하면 올바른 참조 문자열이 자동 생성됩니다.
함수를 사용하는 경우
From a Function에서는 위의 각 영역을 따로 입력하지 않고 함수가 완성된 Notification 값을 반환합니다. 다음과 같은 요구에 사용할 수 있습니다.
- 수신자나 입력에 따라 전체 내용이 달라집니다.
- 이메일과 플랫폼 알림의 제목을 다르게 만듭니다.
- Foundry 밖의 앱이나 시스템으로 향하는 전체 URL을 사용합니다.
- 연결 탐색, 집계나 입력에 없는 자료 조회를 수행하여 내용을 만듭니다.
- 템플릿에서 지원하지 않는 내용을 구성합니다.
수신자 계산 함수와 내용 생성 함수는 별도 선택입니다.
생성 시점과 새 객체 링크
알림에 사용하는 온톨로지 값은 현재 액션의 편집이 적용되기 전 상태입니다. 최신 상태를 보게 하려면 객체 링크를 넣을 수 있습니다.
새 객체의 자동 링크는 Create object 규칙으로 만든 경우에 지원하며 함수가 만든 객체에는 같은 경로를 사용하지 않습니다. 알림을 렌더링할 때 새 객체 RID가 아직 없으므로 기본 키(Primary key)를 참조합니다. 자동 생성할 task ID를 입력으로 준비한 경우에도 그 키를 사용합니다.
함수 내용의 링크는 전체 URL 또는 상대 경로를 사용할 수 있습니다. 경로 템플릿은 다음과 같으며 중괄호 부분에는 실제 값을 사용합니다.
- 전체:
https://{foundryHost}/workspace/module/view/latest/{moduleRid} - 상대:
/module/view/latest/{moduleRid}
수신자와 길이 한도
| 내용 생성 방식 | 최대 수신자 |
|---|---|
| Template | 500명 |
| From a Function | 50명 |
함수 내용의 수신자 수는 실행할 때마다 검사합니다. 한도를 넘으면 오류 알림을 표시하고 액션 실행에 실패합니다.
제목은 최대 250자, 일반 본문은 1,000자, 이메일 사용자 지정 HTML은 51,200자입니다. 동적으로 렌더링한 결과가 길이를 넘으면 잘라내고 끝에 ...를 표시합니다.
수신자의 데이터 권한
수신자는 내용에 사용한 객체 데이터에 접근할 수 있어야 합니다. Security & Submission Criteria 아래에서 권한 부족을 어떻게 처리할지 선택합니다.
| 선택 | 처리 |
|---|---|
| Require all users to have permissions, 기본값 | 한 수신자라도 필요한 권한이 없으면 적용 시 오류가 나고 객체를 편집하거나 알림을 보내지 않습니다. |
| Require any user to have permissions | 적어도 한 명이 자료를 볼 수 있으면 액션이 성공하고 권한이 있는 수신자에게만 보냅니다. |
이 제출 전 권한 검증과 커밋 후의 이메일 또는 알림 전송 실패는 다릅니다. 전송에 실패해도 이미 적용한 온톨로지 편집은 성공한 상태일 수 있습니다.
이메일 내용 가림
플랫폼 인스턴스(Enrollment)에 Strict Redaction이나 Group Redaction이 활성화되어 있으면 사용자 지정 알림 내용 대신 일반 안내 이메일을 보냅니다. View로 Foundry에 들어가 전체 알림 내용을 확인하는 방식입니다.
조직(Organization) 설정이 허용한 경우에만 특정 액션에서 이메일 가림을 재정의할 수 있습니다. Security & Submission의 Notification settings에서 Disable notification redaction을 선택하는 경로입니다.
이 선택은 민감한 내용을 외부 이메일에 노출할 수 있으므로 조직 정책과 해당 액션의 내용을 검토합니다.