Ubiqod by Skiply
Ubiqod は、Skiply IoT ボタンと Qod をサード パーティのプラットフォームに接続するためのシンプルで強力なプラットフォームを提供します。 このコネクタは、構成されたグループに属する IoT デバイスまたは Qod のいずれかによってデータが送信されるたびにフローをトリガーします。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Skiply サポート |
| [URL] | https://desk.zoho.com/portal/skiply |
| メール | ubiqod@skiply.zohodesk.com |
| Connector Metadata | |
|---|---|
| 発行者 | Skiply |
| Web サイト | https://www.ubiqod.com/ |
| プライバシー ポリシー | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| カテゴリ | IoT |
前提条件
続行するには、以下ものが必要です。
- Microsoft Power Apps または Power Automate プラン
- Ubiqod サブスクリプション Ubiqod API キーは、Ubiqod バックエンドの「アカウント」セクションにあります。
IoT デバイスと Qod を準備する
Power Automate で Ubiqod トリガーを使用する前に、次の点に注意してください。
- コネクタはグループにリンクされます: Ubiqod バックエンドに少なくとも 1 つのグループが存在することを確認してください。
- IoT デバイスまたは Qod がコード リストにリンクされていない場合、コードの生の値が送信されます (または IoT デバイスのボタン インデックス)。
- IoT デバイスまたは Qod がコード リストにリンクされていますが、入力されたコードが関連するコード リストで定義されていない場合、コードの生の値が送信されます (または IoT デバイスのボタン インデックス)。
コネクタのセットアップ
- 「デバイスからデータを受信したとき」のトリガーを選択する
- 要求があれば、API キーを入力する
- グループ フィールドから、聞きたい IoT デバイスや Qod を含むグループを選択する
- 次に、選択したステップを追加する
使用可能なフィールド
次のフィールドをマッピングに使用できます。
- タイムスタンプ: Qod スキャンまたは IoT デバイス メッセージ送信の日時
- 識別子: Qod または IoT デバイスの識別子 (s/n)
- Qod または IoT デバイスのラベル: Qod または IoT デバイスのラベル
- サイト ID: Qod または IoT デバイスがリンクされているサイト ID
- サイト ラベル: Qod または IoT デバイスがリンクされているサイト名
- 顧客連絡先メール: サイトで定義された顧客連絡先メール
- 顧客連絡先電話: サイトで定義されている顧客連絡先の電話番号
- サイト マネージャーのメール: サイトで定義されたサイト マネージャーのメール
- サイト マネージャーの電話: サイトで定義されているサイト マネージャーの電話番号
- アクション値: 関連するコード リストにそのようなコードが定義されていない場合はコード ラベルまたは生の値 (そのようなコードが定義されていない場合は IoT デバイスのボタン インデックス)
- GPS 条件: 条件が有効な場合は 1、そうでない場合は 0 - ユーザーの GPS 位置がサイト位置から検証距離内にある場合は条件が有効、そうでない場合またはユーザーが位置を指定することを拒否した場合は 0
- デバイス上の条件: 条件が有効な場合は 1、そうでない場合は 0 - IoT デバイスの場合: 磁気バッジがスワイプされたときに条件が有効 / S-Qodの場合: 動的 QR コードがデバイスからスキャンされて検証されたときに条件が有効 Ubiqod サーバーによる
- コード条件: 条件が有効な場合は 1、そうでない場合は 0 - 入力したコードが関連コード リストで定義されている場合、条件は有効
- GPS 値: 使用可能な場合、ユーザーの位置の GPS 座標
- 検証コード値: 使用可能な場合、検証コード ラベル、または関連コード リストにそのようなコードが定義されていない場合は生の値
- プレス数: IoT デバイスのみ、ボタンが押された回数
- カスタム field_1: フォーム、フィールド #1 の値を持つ Qod の場合のみ
- カスタム field_2: フォーム、フィールド #2 の値を持つ Qod の場合のみ
- カスタム field_3: フォーム、フィールド #3 の値を持つ Qod の場合のみ
- カスタム field_4: フォーム、フィールド #4 の値を持つ Qod の場合のみ
通常モードとコード モード (IoT デバイスのみ)
IoT デバイスの構成では、「コード モード」の使用を強制できます。 「通常モード」でボタン 1 とボタン 2 を押すと、2 つの別々の要求が送信されます (ボタンごとに 1 つ)。 「コード モード」では、同じシーケンスのプレスで、コード「12」の要求が 1 つだけ送信されます (コード リストで関連するラベルを構成できます)。
接続をテストする
- Ubiqod アカウントには、IoT デバイスとまったく同じように動作する仮想デバイスが含まれています。 IoT デバイス リストの「再生ボタン」を押してシミュレーターを起動します。 1 つまたは複数のボタンを押し、3 つの緑色のライトが 1 秒間点灯するまで待ちます (通常、最初に押してから 4 秒間)。
サポートされている操作
コネクタは、1 つのパブリック操作のみをサポートします。
- DataIn (ボタンがデータを送信するたびにトリガーされる)
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| API キー | securestring | API キーを入力します。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
トリガー
| IoT デバイスまたは Qod からデータを受信したとき |
この操作は、ターゲット グループ内の IoT デバイスまたは Qod の 1 つがデータを送信したときにトリガーされます。 |
IoT デバイスまたは Qod からデータを受信したとき
この操作は、ターゲット グループ内の IoT デバイスまたは Qod の 1 つがデータを送信したときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
グループ名
|
group_id | True | integer |
このトリガーにリンクする Ubiqod グループの名前。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
識別子
|
device_name | string |
Qod または IoT デバイスの識別子 (s/n) |
|
Qod または IoT デバイスのラベル
|
device_label | string |
Qod または IoT デバイスのラベル。 |
|
タイムスタンプ
|
request_date | string |
Qod スキャンまたは IoT デバイス メッセージ送信の日時。 |
|
アクション値
|
button_label | string |
関連するコード リストにそのようなコードが定義されていない場合は、コード ラベルまたは生の値 (そのようなコードが定義されていない場合は IoT デバイスのボタン インデックス)。 |
|
プレス数
|
times_button_pressed | integer |
IoT デバイスの場合のみ、ボタンが押された回数 |
|
サイト ID
|
site_id | integer |
Qod または IoT デバイスがリンクされているサイト ID。 |
|
サイト ラベル
|
site_label | string |
Qod または IoT デバイスがリンクされているサイト名。 |
|
デバイス上の状態
|
badge | integer |
条件が有効な場合は 1、そうでない場合は 0 - IoTデバイスの場合: 磁気バッジがスワイプされたときに条件が有効 / S-Qod の場合: 動的 QR コードがデバイスからスキャンされ、Ubiqod サーバーによって検証されたときに条件が有効になります。 |
|
顧客連絡先メール
|
customer_contact_email | string |
サイトで定義された顧客連絡先メール。 |
|
顧客連絡先電話
|
customer_contact_phone | string |
サイトで定義された顧客連絡先の電話番号。 |
|
サイト マネージャーのメール
|
site_manager_email | string |
サイトで定義されたサイト マネージャーのメール。 |
|
サイト マネージャーの電話
|
site_manager_phone | string |
サイトで定義されたサイト マネージャーの電話番号。 |
|
GPS 条件
|
gps_condition | integer |
GPS 条件: 条件が有効な場合は 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 |
フォーム、フィールド #2 の値を持つ Qod の場合のみ。 |
|
カスタム フィールド 3
|
custom_field_3 | string |
フォーム、フィールド #3 の値を持つ Qod の場合のみ。 |
|
カスタム フィールド 4
|
custom_field_4 | string |
フォーム、フィールド #4 の値を持つ Qod の場合のみ。 |