공지
관리자는 알림을 사용하여 이벤트를 기반으로 ThingWorx 사용자에게 이메일 또는 문자 메시지를 보낼 수 있습니다.
알림은 하나 이상의 트리거로 구성됩니다. 트리거는 지정된 이벤트를 수신할 사용자와 해당 메시지를 정의합니다. 트리거를 생성할 때 다음을 정의해야 합니다.
• 소스 - 알림이 전송되도록 하는 소스 엔티티 및 이벤트입니다.
• 처리기 - 알림 메시지를 보내는 서비스를 제공하는 엔티티입니다. 처리기는 전송할 수 있는 콘텐츠 유형을 정의합니다. 다음 처리기를 사용할 수 있습니다.
◦ MailServer - Mail 확장 프로그램(버전 3.5.0 이상 확장)의 사물입니다.
메시지에는 제목과 본문이 포함됩니다.
◦ Twilio - Twilio 확장(버전 3.1.0 이상 확장)의 사물입니다.
메시지에는 본문이 포함됩니다.
PTC 지원 사이트에서 이러한 확장을 다운로드할 수 있습니다.
 |
알림은 동일한 처리기 엔티티를 사용하는 트리거를 둘 이상 가질 수 없습니다. 동일한 처리기를 사용하는 트리거가 두 개 이상 있는 경우 다른 알림 엔티티를 생성해야 합니다.
|
• 콘텐츠 - 사용자에게 보낼 메시지입니다. 콘텐츠에는 데이터 셰이프에 정의된 이벤트 데이터 패킷을 포함하여 알림을 트리거한 이벤트의 추가 데이터가 포함될 수 있습니다(사물 이벤트 참조). 이중 대괄호 및 콜론 표시법을 사용하여 이벤트 데이터를 포함할 수 있습니다. 예를 들어, [[:<event_data>:]]입니다. 여기서 event_data는 이벤트 매개 변수의 이름을 나타냅니다. 이는 이벤트 구독을 추가할 때 사용되는 것과 동일한 이름입니다(사물 구독 참조).
사용 가능한 이벤트 매개 변수를 찾으려면 다음을 수행하십시오.
1. Composer에서 > , 사물 템플릿 또는 사물 형태를 찾은 다음 엔티티를 엽니다.
2. 구독 영역에서 임시 구독을 추가하려면 추가 버튼을 클릭합니다.
3. 입력 영역을 클릭한 다음 드롭다운 목록에서 이벤트를 선택합니다.
4. 필요한 경우 드롭다운 목록에서 속성을 선택할 수 있습니다.
입력 목록이 나타납니다.
5. 스크립트 영역에 매개 변수를 추가하려면 화살표(
) 아이콘을 클릭합니다.
) 아이콘을 클릭합니다.스크립트 영역에 나타나는 매개 변수 이름을 알림 콘텐츠에 사용할 수 있습니다.
6. 완료를 클릭합니다.
알림 콘텐츠의 가장 좋은 방법은 기본 로컬리제이션 테이블에 토큰을 생성하고 텍스트를 정의하여 텍스트를 국제화하는 것입니다. [[<token_name>]]과 같이 로컬리제이션 토큰 이름을 이중 대괄호로 지정하여 알림 콘텐츠를 정의할 수 있습니다.
| | 처리기 구현 및 메시지를 보내는 데 사용되는 최종 서비스에 따라 보낼 수 있는 항목에 제한이 있을 수 있습니다. 예를 들어, 특정 메일 서버가 보낸 이메일 본문의 길이에는 크기 제한이 있을 수 있습니다. Twilio는 SMS 메시지에 글자 수 제한이 있습니다. 자세한 내용은 메시징 서비스에서 제공하는 설명서를 참조하고 해당 콘텐츠 제한을 준수하는지 확인하십시오. |
• 수신자 - 알림 메시지를 보낼 한 명 이상의 ThingWorx 사용자입니다.
| | 사용자가 이메일 및/또는 문자 메시지를 성공적으로 수신할 수 있도록 사용자 확장 구성(UserExtensions 사물 형태)에 유효한 이메일 주소(emailAddress 속성) 및/또는 휴대폰 전화 번호(mobilePhone 속성)가 지정되어야 합니다. 문자 메시지가 지정된 휴대폰 번호로 전송되며 SMS 주소(smsAddress 속성)로는 전송되지 않습니다. |
알림 이벤트
알림이 트리거되면 다음 이벤트가 발생합니다.
• NotificationSent
• NotificationFailed
이러한 이벤트를 구독하여 이벤트에 응답(예: 스트림 또는 로그 파일에 엔트리 작성)하려면 다음을 수행하십시오.
1. Composer에서 > 을 찾은 다음 알림 사물을 선택합니다.
2. 입력 탭을 클릭하고 구독에 대한 입력으로 NotificationSent 또는 NotificationFailed 이벤트를 선택합니다.
3. 구독 논리를 입력합니다.
자세한 내용은 사물 구독을 참조하십시오.
알림 가져오기 또는 내보내기
알림은 기본 알림 정보 및 관련 트리거 정보(예: NotificationDefinition_<name>.xml)가 포함된 하나의 파일로 내보내집니다.
또는 Composer의 > > > 에서 또는 > > 에서 모든 시스템 엔티티를 내보낼 수 있습니다. 여기서는 지정된 저장소의 NotificationDefinitions 및 NotificationContents 폴더 아래에 있는 고유한 파일로 알림과 트리거를 내보냅니다. 트리거는 모델 태그 또는 프로젝트 이름을 지정하여 내보낼 수 없습니다.
다음은 알림 가져오기를 위한 사전 요구 사항입니다.
• 소스 엔티티 및 이벤트가 있는지 확인하십시오.
• 처리기 엔티티(MailServer 사물 또는 Twilio 사물)가 있어야 합니다.
• 수신자로 지정된 사용자 엔티티가 존재합니다.
자세한 내용은 알림 추가 항목을 참조하십시오.