通知
身為「管理員」,您可以根據
事件,使用通知傳送電子郵件或文字訊息給 ThingWorx 使用者。
通知是由一或多個觸發程式所組成。觸發程式定義哪些使用者會收到特定事件的通知,以及所收到的訊息內容。建立觸發程式時,必須定義下列各項:
• 來源 - 會導致系統傳送通知的來源實體與事件。
• 處理常式 - 提供服務以傳送通知訊息的實體。處理常式定義可以傳送的內容類型。您可以使用下列處理常式:
◦ MailServer - 來自郵件延伸功能 (3.5.0 版及更新版本的延伸功能) 的物件。
其訊息包含主旨與內文。
◦ Twilio - 來自 Twilio 延伸功能 (3.1.0 版及更新版本的延伸功能) 的物件。
其訊息包含一份內文。
您可以從 ThingWorx Foundation
下載頁下載這些延伸功能。
|
通知不能有多個使用相同處理常式實體的觸發程式。如果您有多個使用相同處理常式的觸發程式,則必須建立另一個通知實體。
|
• 內容 - 傳送給使用者的訊息。內容可以包含來自事件 (觸發通知的事件) 的其他資料,包括在資料形式中定義的事件資料封包 (請參閱
物件事件)。您可以使用雙方括號和冒號標記來包括事件資料。例如,
[[:<event_data>:]],其中
event_data 指事件參數的名稱。此名稱與新增事件訂閱時使用的名稱相同 (請參閱
物件訂閱)。
欲尋找可用的事件參數,請執行下列動作:
1. 從 Composer 瀏覽 > ,或者「物範本」或「物形式」,然後開啟一個實體。
2. 在「訂閱」區域,欲新增暫時訂閱,請按一下「新增」按鈕。
3. 按一下「輸入」區域,然後從下拉式清單中選取「事件」。
4. 或者,您可以從下拉式清單中選取內容。
隨即顯示輸入清單。
5. 欲將參數新增至指令集區域,請按一下箭頭 (
![](../../../../ThingWorx/images/IconArrow.png)
) 圖示。
指令集區域中顯示的參數名稱可用於通知內容。
6. 按一下「完成」。
通知內容的最佳工作模式是藉由在預設當地語系化表中建立權杖並定義其中文字,將文字國際化。您可以指定雙重方括號中的當地語系化權杖名稱,藉此定義通知內容,如 [[<token_name>]]。
| 可傳送的內容可能有限,取決於處理常式實行與用於傳送訊息的終端服務。例如,特定郵件伺服器所傳送的電子郵件內文可能有長度上的大小限制。Twilio 則對 SMS 訊息設有字元限制。如需詳細資訊,請參閱傳訊服務提供的文件集,以確保您遵守此類內容限制。 |
• 接收者 - 身為通知訊息傳送對象的一或多個 ThingWorx 使用者。
| 使用者的「使用者延伸功能」組態 (emailAddress 物形式) 中必須有有效的電子郵件位址 (mobilePhone 內容) 和/或行動電話號碼 (UserExtensions 內容),才能順利接收電子郵件和/或文字訊息。 文字訊息會被傳送至指定的行動電話號碼,而非 SMS 位址 (smsAddress 內容)。 |
通知事件
觸發通知後,會發生下列事件:
• NotificationSent
• NotificationFailed
欲訂閱這些事件以便您可對其進行回應 (例如,將項目寫入串流或記錄檔),請執行下列動作:
1. 從 Composer 瀏覽 > ,然後選取通知物件。
2. 按一下「輸入」標籤,然後選取 NotificationSent 或 NotificationFailed 事件作為訂閱的輸入。
3. 輸入訂閱邏輯。
匯入或匯出通知
會將通知匯出為一個檔案,其中包含基本通知資訊與相關的觸發器資訊 (例如,NotificationDefinition_<name>.xml)。
或者,您也可以從 > > > 或從匯 > > ,匯出 Composer 中的所有系統實體。這會將通知與觸發器匯出至指定存放庫之 NotificationDefinitions 與 NotificationContents 資料夾下它們自己的檔案中。不能藉由指定模型標籤或專案名稱的方式匯出觸發程式。
下列是匯入通知的先決條件:
• 請確定來源實體和事件存在。
• 應有處理常式實體 (MailServer 物件或 Twilio 物件)。
• 有指定為收件者的使用者實體。