Skiply 的 Ubiqod
Ubiqod 提供了一個簡單而強大的平台,可將您的 Skiply IoT 按鈕和 Qods 連接到第三方平台。 每次屬於已配置組的任何物聯網裝置或 Qods 傳送資料時,此聯結器都會觸發流量。
此連接器適用於以下產品和區域:
| 服務 | 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) |
| 連絡人 | |
|---|---|
| 名稱 | Skiply 支持 |
| URL | https://desk.zoho.com/portal/skiply |
| ubiqod@skiply.zohodesk.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 跳過 |
| 網站 | https://www.ubiqod.com/ |
| 隱私策略 | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| 類別 | 物聯網 |
先決條件
要繼續,您需要:
- Microsoft Power Apps 或 Power Automate 方案
- Ubiqod 訂閱 Ubiqod API 金鑰可以在 Ubiqod 後端的「帳戶」部分找到。
準備您的物聯網設備和 Qods
在 Power Automate 中使用 Ubiqod 觸發器之前,請注意以下幾點:
- 連接器將連結至群組:請確定 Ubiqod 後端中至少存在一個群組。
- 如果物聯網設備或 Qod 未鏈接到代碼列表,則將發送代碼的原始值(或物聯網設備的按鈕索引)。
- 如果物聯網設備或 Qod 鏈接到代碼列表,但輸入的代碼未在相關代碼列表中定義,則將發送代碼的原始值(或物聯網設備的按鈕索引)。
設定連接器
- 選擇觸發器「從裝置接收資料時」
- 如果需要,請輸入您的 API 金鑰
- 從Group欄位中,選擇包含要收聽的物聯網裝置和/或Qods的組
- 然後添加您選擇的步驟
可用的欄位
下列欄位可用於對應:
- 時間戳記:Qod 掃描或物聯網設備消息傳輸的日期時間
- 識別碼:Qod 或 IoT 裝置 (s/n) 的識別碼
- Qod 或 IoT 裝置標籤:Qod 或 IoT 裝置的標籤
- 站台 ID:Qod 或物聯網設備鏈接到的站台 ID
- 站台標籤:Qod 或 IoT 裝置連結到的站台名稱
- 客戶聯絡電子郵件:網站上定義的客戶聯絡電子郵件
- 客戶聯絡電話:網站上定義的客戶聯絡人的電話號碼
- 網站管理員電子郵件:網站上定義的網站管理員的電子郵件
- 站點經理電話:站點上定義的站點管理員的電話號碼
- 動作值:如果相關代碼清單中未定義此類代碼,則為代碼標籤或原始值(如果未定義此類代碼,則為物聯網裝置的按鈕索引)
- GPS 條件:如果條件有效,則為 1,如果無效,則為 0 - 當使用者 GPS 位置低於與站點位置的驗證距離時,條件有效,如果條件無效,則為 0,如果使用者拒絕提供其位置,則為 0
- 裝置上條件:如果條件有效,則為 1,如果無效,則為 0- 對於物聯網裝置:當磁性徽章已滑動時,條件有效 / 對於 S-Qod:當從裝置掃描動態 QR 碼並由 Ubiqod 伺服器驗證時,條件有效
- 代碼條件:條件有效則為 1,無效則為 0 - 相關代碼清單中定義了輸入的代碼時,條件有效
- GPS 值:如果有,使用者位置的 GPS 座標
- 驗證碼值:如果有的話,驗證碼標籤或原始值(如果相關代碼清單中未定義此類代碼)
- 按下次數:僅適用於物聯網設備,按下按鈕的次數
- 自訂field_1:僅適用於具有表單的 Qod,值為欄位 #1
- 自訂field_2:僅適用於具有表單的 Qod,值為欄位 #2
- 自訂field_3:僅適用於具有表單的 Qod,值為欄位 #3
- 自訂field_4:僅適用於具有表單的 Qod,值為欄位 #4
正常模式與代碼模式(僅適用於物聯網設備)
在物聯網設備的配置中,您可以強制使用“代碼模式”。 如果您按下按鈕 1 和按鈕 2,則在「正常模式」下,會傳送 2 個單獨的請求(每個按鈕一個)。 在「程式碼模式」中,相同的按壓順序僅發送一個請求,代碼為「12」(您可以在程式碼清單中配置關聯的標籤)。
測試連線
- Ubiqod 帳戶包括虛擬設備,其行為方式與物聯網設備完全相同。 按物聯網設備列表中的“播放按鈕”啟動模擬器。 按下一個或多個按鈕,然後等待 3 個綠燈持續亮起一秒鐘(通常在第一次按下後 4 秒)。
支援的作業
連接器僅支援一個公用作業:
- DataIn(每次按鈕發送數據時觸發)
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 提供您的 API 金鑰。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
觸發程序
| 從物聯網設備或 Qod 接收數據時 |
當目標組中的一個物聯網設備或 Qod 發送數據時,會觸發此操作。 |
從物聯網設備或 Qod 接收數據時
當目標組中的一個物聯網設備或 Qod 發送數據時,會觸發此操作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組名稱
|
group_id | True | integer |
您要連結至此觸發程式的 Ubiqod 群組名稱。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
device_name | string |
Qod或物聯網裝置的識別碼(s/n) |
|
Qod 或 IoT 裝置標籤
|
device_label | string |
Qod 或 IoT 裝置的標籤。 |
|
時間戳
|
request_date | string |
Qod 掃描或物聯網設備消息傳輸的日期時間。 |
|
行動價值
|
button_label | string |
如果相關代碼列表中沒有定義此類代碼,則為代碼標籤或原始值(如果未定義此類代碼,則為物聯網設備的按鈕索引)。 |
|
印刷機數量
|
times_button_pressed | integer |
僅適用於物聯網設備,按下按鈕的次數 |
|
網站識別碼
|
site_id | integer |
Qod 或 IoT 裝置連結到的站點 ID。 |
|
網站標籤
|
site_label | string |
Qod 或 IoT 裝置連結到的站點名稱。 |
|
裝置上狀況
|
badge | integer |
如果條件有效,則為 1,如果無效,則為 0- 對於物聯網設備:當磁性徽章被刷動時,條件有效 / 對於 S-Qod:當從設備掃描動態二維碼並由 Ubiqod 服務器驗證時,條件有效。 |
|
客戶聯絡電子郵件
|
customer_contact_email | string |
網站上定義的客戶聯繫人的電子郵件。 |
|
客戶聯絡電話
|
customer_contact_phone | string |
網站上定義的客戶聯繫方式的電話號碼。 |
|
網站管理員電子郵件
|
site_manager_email | string |
網站上定義的網站經理的電子郵件。 |
|
站點經理電話
|
site_manager_phone | string |
網站上定義的站點經理的電話號碼。 |
|
GPS 狀況
|
gps_condition | integer |
如果條件有效,則為 1,如果條件無效,則為 0 - 當使用者 GPS 位置低於與站點位置的驗證距離時,條件有效,如果條件無效,則為 0,如果使用者拒絕提供其位置。 |
|
程式碼條件
|
code_condition | integer |
如果條件有效,則為 1,如果無效,則為 0 - 當輸入的代碼在相關代碼清單中定義時,條件有效。 |
|
GPS 值
|
gps_value | string |
如果有的話,使用者位置的 GPS 座標。 |
|
驗證碼值
|
validation_code_value | string |
如果有的話,驗證碼標籤或原始值(如果相關代碼清單中未定義此類代碼)。 |
|
自訂欄位 1
|
custom_field_1 | string |
僅適用於表單為欄位 #1 的 Qod。 |
|
自訂欄位 2
|
custom_field_2 | string |
僅適用於具有表單的 Qod,值為欄位 #2。 |
|
自訂欄位 3
|
custom_field_3 | string |
僅適用於具有表單的 Qod,值為欄位 #3。 |
|
自訂欄位 4
|
custom_field_4 | string |
僅適用於表單的 Qod,值為欄位 #4。 |