德達克 SIGNL4
Derdack SIGNL4 是一款移動通知應用程序，可可靠地通知值班的運營團隊並提高他們的生產力。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| URL | https://www.signl4.com/feedback-we-love-hear-from-you/ |
| info@signl4.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 德達克有限公司 |
| 網站 | https://www.signl4.com |
| 隱私策略 | https://www.signl4.com/privacy-policy/ |
SIGNL4 連接器可讓您
- 透過自動升級發送持久的行動警報通知
- 追蹤送貨和確認
- 通過考慮團隊成員的及時可用性（例如隨叫隨到的值班、輪班）將警報路由給合適的人
- 獲得警報擁有權和回應的透明度
使用 SIGNL4 連接器在任何觸發器或從任何第 3 個系統傳送警示。 它還允許您擴展現有的 SIGNL4 用例。 例如，您可以根據 Microsoft Office 365、Microsoft StaffHub、Google 日曆等中的日曆讓用戶上下班。 另一種情況是定期從 SIGNL4 提取班次績效指標（例如警報響應、值班時間）到自定義審計跟踪中，例如簡單的 csv 文件。
當您建立與 SIGNL4 的連線時，只要使用您的 SIGNL4 使用者認證 （或任何其他支援的帳戶，例如 Microsoft 公司或學校帳戶） 登入，並同意所要求的權限。 之後，您將能夠在 SIGNL4 團隊範圍內呼叫 API 的所有動作。 這意味著您可以例如讓團隊中的其他人值班，但不能讓其他 SIGNL4 團隊的任何人。
有關該產品和 API 的更多信息，請訪問 https://www.signl4.com/。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 依識別碼取得使用者 |
傳回使用者的詳細資料，例如名稱、電子郵件地址等。 |
| 全部確認 |
此方法會確認您的團隊目前擁有的所有未處理警示。 |
| 取得所有使用者 |
傳回使用者物件清單，其中包含其電子郵件地址等詳細資訊。 只有屬於您團隊的使用者才會被傳回。 |
| 取得警示報告 |
傳回不同時段內發生警示數量的相關資訊，以及團隊成員回應行為 （已確認和未處理警示數量） 的相關資訊。 |
| 打卡用戶 |
使用此操作，指定的用戶將被打卡到值班中。 |
| 打掉用戶 |
使用此操作，指定的使用者將被打出值班。 |
| 觸發警報 |
為您的團隊觸發新警報。 所有值班團隊成員都會收到警報通知。 |
依識別碼取得使用者
傳回使用者的詳細資料，例如名稱、電子郵件地址等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
userId | True | string |
要取得的使用者識別碼。 使用「我」來取得目前登入使用者的相關資訊。 也可以是小組中使用者的電子郵件地址，或相關使用者物件的唯一識別碼。 |
傳回
使用者的基本資訊。
- 身體
- UserInfo
全部確認
此方法會確認您的團隊目前擁有的所有未處理警示。
取得所有使用者
取得警示報告
傳回不同時段內發生警示數量的相關資訊，以及團隊成員回應行為 （已確認和未處理警示數量） 的相關資訊。
傳回
一個物件，其中包含不同時段內發生的警示量的相關資訊，以及團隊成員的回應行為 （已確認和未處理的警示數量） 的相關資訊。
- 保存不同時段內發生警示磁碟區相關資訊的物件
- AlertReport
打卡用戶
使用此操作，指定的用戶將被打卡到值班中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
userId | True | string |
要打卡的使用者識別碼。 使用「我」來取得目前登入使用者的相關資訊。 也可以是小組中使用者的電子郵件地址，或相關使用者物件的唯一識別碼。 |
傳回
有關使用者職責狀態的資訊。
- 身體
- UserDutyInfo
打掉用戶
使用此操作，指定的使用者將被打出值班。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
userId | True | string |
要打孔的使用者識別碼。使用「我」來取得目前登入使用者的相關資訊。 也可以是小組中使用者的電子郵件地址，或相關使用者物件的唯一識別碼。 |
傳回
有關使用者職責狀態的資訊。
- 身體
- UserDutyInfo
觸發警報
為您的團隊觸發新警報。 所有值班團隊成員都會收到警報通知。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
外部ID
|
externalId | string |
系統中用於參考此警示的唯一識別碼。 您可以使用此欄位來比對您以該 ID 觸發的警示，例如稍後查詢警示的更新狀態時。 |
|
|
警示類別
|
category | string |
此警示應屬於 SIGNL4 小組中的系統或裝置類別名稱。 |
|
|
SIGNL4 中此附件的唯一 ID
|
id | string |
此附件在 SIGNL4 中的唯一 ID。 |
|
|
附件編碼
|
encoding | integer |
指出內容是否為 Base64 編碼 （1） 或非 （0）。 |
|
|
附件名稱
|
name | True | string |
此附件的名稱，例如原始圖像文件名。 |
|
附件 MIME 類型
|
contentType | True | string |
此附件的 MIME 內容類型，例如影像/jpg（編碼 1）或文字/純色（例如編碼 0）。 |
|
附件資料
|
content | True | string |
此附件的數據，例如代表 jpg 圖像的 Base64 字符串。 |
|
參數名稱
|
name | True | string |
此參數的名稱，例如溫度。 |
|
參數類型
|
type | integer |
此參數的類型。 此欄位保留供以後使用，且在設定時應一律符合 0。 |
|
|
參數值
|
value | True | string |
參數的值，例如 56F。 |
|
警示標題
|
title | True | string |
此警示的標題或主題，例如「溫度警示」。 |
|
警示詳細資料
|
text | True | string |
文字警報詳細信息，例如「過去 4 分鐘內溫度下降了 10 華氏度」。 |
傳回
- 身體
- AlertInfo
定義
UserInfo
使用者的基本資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
使用者識別碼
|
id | string |
用戶的識別碼。 |
|
Email
|
string |
使用者的郵件位址。 |
|
|
名稱
|
name | string |
使用者的名稱。 |
|
訂用帳戶識別碼
|
subscriptionId | string |
使用者所屬訂閱的識別碼。 |
AlertInfo
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
警示識別碼
|
id | string |
SIGNL4 中警示的唯一 ID。 |
|
外部ID
|
externalId | string |
系統中用於參考此警示的唯一識別碼。 您可以使用此欄位來比對您以該 ID 觸發的警示，例如稍後查詢警示的更新狀態時。 |
|
訂閱 ID
|
subscriptionId | string |
您的 SIGNL4 訂閱的唯一 ID。 |
|
團隊 ID
|
teamId | string |
您的 SIGNL4 團隊的唯一 ID。 |
|
類別識別碼
|
categoryId | string |
此警示所屬的 SIGNL4 團隊中系統或裝置類別的唯一 ID。 |
|
系統或裝置類別
|
category | string |
此警示所屬的 SIGNL4 小組中系統或裝置類別的名稱。 |
|
警報嚴重性
|
severity | integer |
SIGNL4 中此警示的嚴重性。 此欄位保留供以後使用。 |
|
為您的 SIGNL4 團隊觸發此警示的 API 或來源的唯一 ID
|
eventSourceId | string |
為您的 SIGNL4 團隊觸發此警示的 API 或來源的唯一 ID。 |
|
為您的 SIGNL4 團隊觸發此警示的 API 或來源類型
|
eventSourceType | integer |
為您的 SIGNL4 團隊觸發此警示的 API 或來源類型。 |
|
上次在 SIGNL4 中修改此警示的時間
|
lastModified | date-time |
上次在 SIGNL4 中修改此警示的時間。 |
|
附件集合，例如屬於此警示的影像
|
attachments | array of object |
屬於此警示的附件集合，例如影像。 |
|
SIGNL4 中此附件的唯一 ID
|
attachments.id | string |
此附件在 SIGNL4 中的唯一 ID。 |
|
指出內容是 Base64 或編碼 （1） 還是非編碼 （0）
|
attachments.encoding | integer |
指出內容是 Base64 或編碼 （1） 還是非編碼 （0）。 |
|
附件名稱
|
attachments.name | string |
此附件的名稱，例如原始圖像文件名。 |
|
MIME 內容類型
|
attachments.contentType | string |
此附件的 MIME 內容類型，例如 image/jpg。 |
|
附件內容
|
attachments.content | string |
此附件的內容。 |
|
使用者在此警示上留下的註解集合
|
annotations | array of object |
使用者在此警示上留下的註解集合。 |
|
註解類型
|
annotations.type | integer |
此註解的類型。 此欄位保留供以後使用。 |
|
使用者註解
|
annotations.text | string |
使用者留下的註解。 |
|
已離開註釋的 SIGNL4 使用者的唯一 ID
|
annotations.userId | string |
已離開註釋之 SIGNL4 使用者的唯一 ID。 |
|
索引鍵/值配對的集合，其中包含屬於此警示的其他裝置或系統參數
|
parameters | array of object |
索引鍵/值組的集合，其中包含屬於此警示的其他裝置或系統參數。 |
|
參數名稱
|
parameters.name | string |
此參數的名稱，例如溫度。 |
|
參數類型
|
parameters.type | integer |
此參數的類型。 此欄位保留供以後使用，且在設定時應一律符合 0。 |
|
參數值
|
parameters.value | string |
參數的值，例如 56F。 |
|
確認此警示的時間
|
history.acknowledged | date-time |
確認此警示的時間。 |
|
已確認警示的小組成員名稱
|
history.acknowledgedBy | string |
已確認警示的團隊成員名稱。 |
|
此警示關閉的時間
|
history.closed | date-time |
此警示關閉的時間。 |
|
已關閉警示的小組成員名稱
|
history.closedBy | string |
已關閉警示的團隊成員名稱。 |
|
在 SIGNL4 中建立此警示的時間
|
history.created | date-time |
在 SIGNL4 中建立此警示的時間。 |
|
警示狀態
|
status | integer |
SIGNL4 中警示的狀態。 1 代表未處理的警示，而 2 代表已確認的警示。 所有其他值都會保留供稍後使用，而且絕不應該是此物件實例的值。 |
|
更改標題
|
title | string |
此快訊的標題或主題。 |
|
文字警示詳細資料
|
text | string |
文字警報詳細資訊。 |
警示報告
一個物件，其中包含不同時段內發生的警示量的相關資訊，以及團隊成員的回應行為 （已確認和未處理的警示數量） 的相關資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
過去 24 小時內發生且您的團隊在該時間內確認的警示數量
|
last24Hours.acknowledged | integer |
過去 24 小時內發生且您的團隊在該時間內確認的警示數量。 |
|
此時間段已結束或將結束的時間
|
last24Hours.end | date-time |
此時間段已結束或將結束的時間。 |
|
上次此指標變更的時間
|
last24Hours.lastModified | date-time |
上次此指標變更的時間。 |
|
此時段已開始或將開始的時間
|
last24Hours.start | date-time |
此時段已開始或將要開始的時間。 |
|
過去 24 小時內發生且您的團隊在該時間內未確認的警示數量
|
last24Hours.unhandled | integer |
過去 24 小時內發生且您的團隊在該時間內尚未確認的警示數量。 |
|
您的 SIGNL4 訂閱的唯一 ID
|
subscriptionId | string |
您的 SIGNL4 訂閱的唯一 ID。 |
|
目前值班期間發生且您的團隊在該時間內確認的警示數量
|
teamCurrentDuty.acknowledged | integer |
目前值班期間發生且您的團隊在該時間內確認的警示數量。 |
|
本值班期已結束或將結束之時間
|
teamCurrentDuty.end | date-time |
本值班期已結束或將結束的時間。 |
|
上次此指標變更的時間
|
teamCurrentDuty.lastModified | date-time |
上次此指標變更的時間。 |
|
該值班期已開始或將開始的時間
|
teamCurrentDuty.start | date-time |
該值班期已經開始或將開始的時間。 |
|
目前值班期間發生且您的團隊在該時間內未確認的警示數量
|
teamCurrentDuty.unhandled | integer |
目前值班期間發生且您的團隊在該時間內未確認的警示數量。 |
|
建立/要求此警示報告之 SIGNL4 小組的唯一識別碼。 如果您的團隊已關閉 SIGNL4 值班助理，則將為空
|
teamId | string |
建立/要求此警示報告之 SIGNL4 小組的唯一識別碼。 如果您的團隊已關閉 SIGNL4 值班助理，則將為空。 |
|
在前一個值班期間發生且您的團隊在該時間內確認的警示數量
|
teamLastDuty.acknowledged | integer |
在前一個值班期間發生且您的團隊在該時間內確認的警示數量。 |
|
本值班期已結束或將結束之時間
|
teamLastDuty.end | date-time |
本值班期已結束或將結束的時間。 |
|
上次此指標變更的時間
|
teamLastDuty.lastModified | date-time |
上次此指標變更的時間。 |
|
該值班期已開始或將開始的時間
|
teamLastDuty.start | date-time |
該值班期已經開始或將開始的時間。 |
|
在前一個值班期間發生且您的團隊在該時間內未確認的警示數量
|
teamLastDuty.unhandled | integer |
在上一個值班期間發生且您的團隊在該時間內未確認的警示數量。 |
|
建立/要求此警示報告之 SIGNL4 使用者的唯一 ID。 如果您的團隊已開啟 SIGNL4 值班助理，則為空
|
userId | string |
建立/要求此警示報告之 SIGNL4 使用者的唯一 ID。 如果您的團隊已開啟 SIGNL4 值班助理，則為空。 |
|
自上次使用者職責狀態變更以來發生的警示數量，且她已在該時間內確認
|
userLastDutyChange.acknowledged | integer |
自上次使用者職責狀態變更以來發生的警示數量，且她已在該時間內確認。 |
|
此期間已結束或將結束的時間
|
userLastDutyChange.end | date-time |
此期間已結束或將結束的時間。 |
|
上次修改
|
userLastDutyChange.lastModified | date-time | |
|
此期間已開始或將開始的時間
|
userLastDutyChange.start | date-time |
此期間已開始或將開始的時間。 |
|
自上次使用者職責狀態變更以來發生的警示數量，且她在該時間內尚未確認
|
userLastDutyChange.unhandled | integer |
自上次使用者職責狀態變更以來發生的警示數量，且她在該時間內尚未確認。 |
用戶職責資訊
有關使用者職責狀態的資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
打卡 Date-Time
|
lastChange | date-time |
UTC 格式的日期時間。例如，yyyy-MM-ddTHH：mm：ss.fffZ（UTC 格式） |
|
值班
|
onDuty | boolean |
如果使用者值班，則為 True。 |
|
逾期
|
overdue | boolean |
如果使用者目前逾期，例如因為沒有其他人及時取代該使用者，則為 true。 |
GetAllUsers_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
UserInfo |
使用者的基本資訊。 |