알림

알림은 새로운 규칙 추가 드롭다운 메뉴를 통해 액션에 추가할 수 있습니다. 알림을 추가하는 방법에 대해 더 알아보기.

알림을 구성하려면 수신자와 콘텐츠를 명시해야 합니다. 다음 섹션에서 이러한 옵션에 대해 자세히 설명합니다.

수신자

알림의 수신자 옵션을 구성하면 액션이 실행될 때 알림을 받을 Foundry 사용자 집합을 지정할 수 있습니다. 알림은 각 수신자에게 개별적으로 전송됩니다. 이메일 알림에 CC(참조) 수신자로 사용자를 추가하는 것은 지원되지 않습니다.

수신자를 지정하는 데에는 여러 가지 방법이 지원됩니다:

• 고정: 구성에서 액션이 실행될 때 항상 알림을 받을 사용자나 그룹의 집합을 선택할 수 있습니다.

• 파라미터로부터: 액션에 Foundry 사용자나 그룹 ID가 파라미터로 있다면, 이를 알림의 수신자로 지정할 수 있습니다.

  • 이는 이 액션을 사용하는 애플리케이션이나 모듈의 사용자 인터페이스에서 보내는 사람이 하나 이상의 수신자를 선택하도록 하거나, 액션을 실행하는 사용자를 자동으로 감지하고 알림을 보내는 데 사용할 수 있습니다.

• 오브젝트 파라미터의 속성으로부터: 액션에 오브젝트 파라미터가 있고, 그 오브젝트의 속성 중 하나가 Foundry 사용자나 그룹 ID를 포함하고 있다면, 파라미터의 해당 속성을 수신자로 지정할 수 있습니다. 이는 Foundry 사용자와 그룹 ID의 목록에 대해서도 가능합니다.

• Function에서: 위의 옵션으로 유즈케이스를 커버할 수 없는 경우, 액션 파라미터를 입력으로 받아 알림을 받아야 하는 사용자나 그룹의 목록을 반환하는 커스텀 Function을 작성할 수 있습니다. 사용자나 그룹의 목록을 반환하는 Function을 작성하는 방법에 대해 더 알아보기.

  Function을 기반으로 한 수신자에 대한 유즈케이스 예시:

  • 수신자의 다른 옵션을 결합; 예를 들어, 오브젝트 파라미터의 속성에서 지정된 assignee에게 알림을 보내고, 항상 고정된 추가 수신자 집합에게 알림을 보냅니다.
  • 다른 파라미터나 파라미터의 속성 값에 기반한 수신자 선택; 예를 들어, EMEA에 새로운 작업이 있을 때마다 한 사용자 집합에게 알림을 보내고, 북미에 새로운 작업이 있을 때마다 다른 사용자 집합에게 알림을 보냅니다.
  • 구조화된 옵션에 들어맞지 않는 다른 커스텀 로직.

콘텐츠

알림 콘텐츠를 커스터마이징하는 데에는 여러 가지 옵션이 있습니다. 콘텐츠는 템플릿을 통해 구성하거나 커스텀 Function을 통해 제공할 수 있습니다. 템플릿 콘텐츠를 선택하면 구성 대화 상자에서 전체 콘텐츠를 직접 구성할 수 있습니다. Function 콘텐츠는 적절한 알림 유형을 반환하는 발행된 Function이 필요하게 됩니다.

콘텐츠 구성 요소

1. 제목: 일반적으로 콘텐츠에는 제목 줄이 포함됩니다. 기본적으로, 이는 모든 전달 방식에 대해 동일하게 적용됩니다.
2. 본문: 알림의 본문입니다. 플랫폼 내 알림의 경우, 이는 알림 토스트 내부에 표시됩니다. 이메일의 경우, 이는 이메일 본문 내부에 렌더링됩니다.
3. 링크: 링크를 지정할 수 있습니다. 이는 알림의 본문 콘텐츠 바로 아래에 버튼으로 나타납니다. 버튼의 텍스트는 커스터마이징할 수 있습니다.
   • 링크를 구성하는 데에는 다음 옵션이 사용 가능합니다:
     • 기존 오브젝트 파라미터로의 링크
     • Workshop 애플리케이션으로의 링크
     • Carbon 워크스페이스로의 링크
     • 새로 생성된 오브젝트로의 링크
4. 고급 이메일 구성: 알림을 구성할 때, 이메일로 알림을 전달할 때 사용할 커스텀 콘텐츠 본문을 지정할 수 있습니다. 이 옵션을 사용하면 플랫폼 내 알림에는 지원되지 않는 보다 고급 포맷팅에 HTML을 사용할 수 있습니다. 미리보기에서는 파라미터 참조를 제외하고 알림이 어떻게 보일지 확인할 수 있습니다. 수신자는 이메일로 알림을 받도록 선호 사항을 설정했을 때만 이 콘텐츠를 받게 됩니다.

5. Function에서: "Function에서"를 선택할 때, 위에 나열된 섹션을 구성하지 않습니다. 대신, 커스텀 콘텐츠의 각 섹션을 지정하는 적절한 속성을 가진 알림 오브젝트를 반환하는 Function을 제공해야 합니다. 아래의 경우에는 Function을 사용해야 할 수 있습니다:
   • 알림 콘텐츠가 수신자나 액션의 입력 파라미터에 따라 완전히 다른 경우.
   • 이메일과 플랫폼 내 알림에 대해 다른 제목 줄을 가지고 싶은 경우.
   • 완전한 링크 URL을 사용하고 싶은 경우, Foundry 외부에 있는 외부 시스템이나 애플리케이션으로의 링크를 포함합니다.
   • 콘텐츠를 렌더링할 때 파라미터를 통해 제공되는 데이터를 넘어서 데이터를 검색, 집계, 또는 쿼리하려는 경우.
   • 템플릿 콘텐츠 옵션을 통해 가능하지 않은 다른 커스텀 요구 사항이 있는 경우.

알림 반환 유형에 대한 자세한 정보는 Function 관련 문서에서 찾을 수 있습니다.

---

예제 구성

이것은 알림에 대한 예제 구성입니다.

1. 수신자 구성
2. 콘텐츠 구성
   • 템플릿에서 선택 (온톨로지 앱 대화 상자에서 직접 구성) 또는 Function (완전히 형성된 알림 오브젝트를 반환하는 Function 지정).
3. 템플릿 알림에 대한 제목 줄.
4. 액션에 대한 사용 가능한 파라미터는 그 파라미터를 참조하기 위한 {{{}}} 구문을 생성하기 위해 파라미터를 클릭합니다.
5. 템플릿 알림에 대한 본문 콘텐츠.
6. 템플릿 알림에 대한 링크 구성 (선택사항).
7. 템플릿 알림에 대한 이메일용 커스텀 HTML 콘텐츠 (선택사항).

---

기타 중요 정보

최대 수신자 제한

• 알림 콘텐츠를 렌더링하는 데 "Function에서" 옵션을 사용할 때 수신자의 최대 수는 50명입니다. 콘텐츠 구성 옵션에서 "Function에서"를 선택할 때 구성 패널에 경고가 표시되고, 액션이 실행될 때마다 수신자 수가 확인됩니다. 수신자 수가 제한을 초과하면 빨간색 오류 토스트가 표시되고 액션은 실행되지 않습니다.
• "템플릿" 옵션을 사용하여 구성 대화 상자에서 직접 콘텐츠를 구성할 때 단일 액션 알림에 대한 수신자의 최대 수는 500명입니다.

콘텐츠 길이 제한

• 최대 제목 길이는 250자입니다.
• 최대 본문 길이는 1,000자입니다. 이메일에 대한 커스텀 HTML 콘텐츠를 렌더링할 때, 최대 길이는 51,200자입니다.

이러한 최대 콘텐츠 길이는 알림이 렌더링될 때 검증되고 잘립니다. 이는 렌더링된 콘텐츠가 동적일 경우(예를 들어, 알림 콘텐츠에 오브젝트 데이터가 포함된 경우) 허용된 최대 길이를 초과하는 모든 콘텐츠가 잘리고 뒤따르는 ...로 표시됨을 의미합니다.

엄격한 레다이션

"엄격한 레다이션" 또는 "그룹 레다이션"이 Foundry 인스턴스에 대해 이메일 알림을 보낼 때 활성화되어 있으면, 커스텀 알림 콘텐츠는 렌더링되지 않습니다. 대신, 사용자는 아래에 표시된 일반 메시지를 받게 됩니다. "보기"를 선택하면 그들을 Foundry로 이동시켜 전체 알림 콘텐츠를 볼 수 있습니다. Foundry에서 이메일 콘텐츠 레다이션에 대해 더 알아보기.

수신자 사용자 계정

• 그룹은 데이터에 대한 권한을 확인하기 위해 개별 사용자로 해결되어야 하며, 이후 알림이 전송됩니다.
• Foundry 사용자와 그룹 ID는 계정 아래 설정을 통해 찾을 수 있습니다. 알림의 구성 인터페이스는 액션을 구성하는 사람이 적절한 권한을 가진 사용자와 그룹에 대한 선택자를 제공할 때 고정 수신자 집합을 선택하는 데 사용됩니다.
• 수신자가 오브젝트 속성에 대한 참조를 통해 구성되는 경우, 속성이 Foundry 사용자나 그룹 ID를 스트링으로 저장하는지 확인하십시오. 연관된 사용자나 그룹 표시 이름을 표시하기 위해 조건적 포맷팅을 사용할 수 있습니다(자세한 내용은 값 포맷팅 문서를 참조하십시오).
• 이메일 주소로 직접 전송하는 것은 지원되지 않습니다.

새로 생성된 오브젝트로의 링크

알림이 렌더링될 때 오브젝트 RID가 생성되지 않으므로, 새 오브젝트를 링크할 때는 그 오브젝트의 기본 키를 참조해야 합니다.

예시: 새 작업 오브젝트를 생성하는 액션이 있고, 작업을 생성할 때 고유 ID를 생성하게 됩니다. 액션 알림 내에서는 Object Explorer에서 제공하는 파라미터 옵션을 사용하여 새로 생성된 오브젝트로의 링크를 렌더링합니다.

• Function에서 생성된 콘텐츠를 사용할 때 URL 링크를 지정하는 두 가지 방법이 지원됩니다:
  • 전체 링크 예시: https://<your-foundry-instance>.com/workspace/module/view/latest/<module-rid>
  • 상대 링크 예시: /module/view/latest/<module-rid>

수신자에게 필요한 데이터 접근

• 사용자는 보기 권한이 허용하는 데이터만 포함하는 알림을 받을 수 있습니다.
• 여러 수신자가 있는 경우, 모든 수신자는 알림 콘텐츠에 렌더링된 오브젝트 데이터에 대한 접근 권한을 가져야 합니다.
• 액션을 구성할 때, 알림 실패를 처리하는 두 가지 방법이 사이드바의 보안 & 제출 기준 탭 하단에서 사용 가능합니다:
  • 모든 사용자가 권한을 가져야 함 (기본값): 필요한 접근 권한을 가지지 않은 수신자가 있으면 액션을 적용하려고 시도할 때 오류가 표시됩니다. 이 경우, 어떠한 데이터도 편집되지 않고 어떠한 알림도 전송되지 않습니다.
  • 어떤 사용자라도 권한을 가져야 함: 하나 이상의 사용자가 오브젝트를 볼 수 있다면, 액션은 성공합니다. 권한이 있는 사용자만 알림을 받게 됩니다.