Tribal (プレビュー)
Tribal Admissions などの Tribal Edge モジュールは、教育の世界で成功するために必要なツールをスタッフと学生に提供します。 Tribal Connector を使用して Tribal Edge のモジュールと接続し、情報の管理、アプリケーションのクリアランス チェックなどを行うことができます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Tribal グループ |
| [URL] | https://www.tribalgroup.com |
| メール | servicedesk@tribalgroup.com |
| Connector Metadata | |
|---|---|
| 発行者 | Tribal グループ |
| Web サイト | https://www.tribalgroup.com |
| プライバシー ポリシー | https://www.tribalgroup.com/privacy-policy |
| カテゴリー | ビジネス管理 |
Tribal Admissions などの Tribal Edge モジュールは、教育の世界で成功するために必要なツールをスタッフと学生に提供します。 Tribal コネクタを使用すると、イベントの通知の受信や、Tribal Edge モジュール内のエンティティの照会や操作をすることができます。
前提条件
Tribal Connector を使用するには、選択したモジュールの Tribal Edge ユーザーである必要があります。
資格情報の入手方法
Tribal Connector にアクセスするには、次の権限を持つユーザーがテナントに存在する必要があります:
- イベントの購読
- Tribal Edge内 でアクション/クエリを実行します。参照データを取得したい場合は、「参照データ - 読み取り」権限が必要です
Power Automate で接続を作成すると、次のように昇格されます:
- アクセスしたい環境のタイプ (ライブ、テスト、開発など)。
- EMEA または APAC 内の地域
- Tribal Edge への参加時に受け取ったテナント
資格情報を入力すると同意を求められます。以下が必須となります
- イベント コネクタ エンドポイント
- Web hook への接続
コネクタの使用を開始する
Tribal コネクタの目的は、あらゆる Power Automate コネクタと統合し、Tribal Edge のロジックを内部で提供できる範囲を超えて拡張できるようにすることです。 Tribal コネクタは、次のような通知へのトリガーを提供します。申請者の詳細が更新され、Tribal Edge 内で実行可能なアクション (新しいクリアランス チェック タイプの作成など) が表示されます。
以下では、2 つの一般的なシナリオを取り上げます。
- Excel コネクタを使用して、クラウドでホストされている Excel スプレッド シートから行を取得し、Tribal の作成および更新アクションを使用して参照データを設定します。
- Tribal コネクタを使用して、個人が更新されたかどうかをリッスンし、その個人に関する詳細を取得し、Teams コネクタを通じてスタッフ メンバーに通知します。
既知の問題と制限事項
- Tribal Edge 経由で生成されたトリガーは、さらにクエリを必要とする一意の ID のみを継続します。 詳細を確認するには、アクセス許可によって保護されている詳細を取得する別のアクションを実行できます。
- トリガーとアクションは現在開発中です。準備が整い次第、コネクタで使用できるようになります。
一般的なエラーと解決策
- アクションを実行すると、権限エラーが発生する場合があります。 これは、管理者から権限をリクエストすることで解決できます。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Environment | string | Environment | True |
| Region | string | Region | True |
| Edge テナント Id | string | Tribal Edge の Tenant Id | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| HTTP 要求 |
HTTP リクエストを Edge に送信します |
| エンティティ コレクションの読み込み |
エンティティ コレクションの読み込み |
| エンティティの作成 |
エンティティの作成 |
| エンティティの削除 |
エンティティの削除 |
| エンティティの置換 |
これにより、エンティティの内容が置き換えられます。 含まれていないすべてのプロパティがエンティティから削除されます。 |
| エンティティの読み込み |
エンティティの読み込み |
| ドキュメントをエンティティにアップロード |
ドキュメントをエンティティにアップロード |
| ドキュメントを子エンティティにアップロード |
ドキュメントを子エンティティにアップロード |
| 子 エンティティの作成 |
子 エンティティの作成 |
| 子 エンティティの削除 |
子 エンティティの削除 |
| 子 エンティティの読取り |
子 エンティティの読取り |
| 子エンティティ コレクションの読み込み |
子エンティティ コレクションの読み込み |
| 子エンティティの置換 |
これにより、子エンティティの内容が置き換えられます。 含まれていないすべてのプロパティがエンティティから削除されます。 |
HTTP 要求
HTTP リクエストを Edge に送信します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | string |
情報を含むサービス |
|
|
key
|
key | string |
key |
|
|
価値
|
value | string |
価値 |
|
|
動詞
|
verb | True | string |
HTTP 動詞 |
|
Body
|
body | string |
要求の本文 |
|
|
相対 URL 例: /api/referenceData
|
relativeUrl | True | string |
相対 URL |
エンティティ コレクションの読み込み
エンティティ コレクションの読み込み
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
読み込まれるエンティティ |
|
スキップするレコード
|
skip | True | integer |
スキップするレコードの数 |
|
取得するレコード
|
take | True | integer |
取得するレコード数 |
|
フィルター
|
filter | string |
Open Data Protocol 構文を使用してレコードをフィルターする |
戻り値
エンティティの作成
エンティティの作成
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
作成中の子エンティティ |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
|
|
body
|
body | True | dynamic |
戻り値
エンティティの削除
エンティティの削除
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
削除された子エンティティ |
|
Id
|
id | True | string |
エンティティ ID |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
エンティティの置換
これにより、エンティティの内容が置き換えられます。 含まれていないすべてのプロパティがエンティティから削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
更新中のエンティティ |
|
Id
|
id | True | string |
エンティティ ID |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
|
|
If-Match
|
If-Match | True | string |
If-Match ヘッダーに追加された ETag |
|
body
|
body | True | dynamic |
戻り値
エンティティの読み込み
エンティティの読み込み
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
読み込まれるエンティティ |
|
Id
|
id | True | string |
エンティティ ID |
戻り値
ドキュメントをエンティティにアップロード
ドキュメントをエンティティにアップロード
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
作成中の子エンティティ |
|
Id
|
id | True | string |
エンティティ ID |
|
操作を実行する入力ファイル。
|
file | True | file |
操作を実行する入力ファイル。 |
|
アップロードされるドキュメントの種類
|
documentTypeName | string |
アップロードされるドキュメントの種類 |
|
|
ドキュメントの作成者
|
createdBy | string |
ドキュメントの作成者 |
ドキュメントを子エンティティにアップロード
ドキュメントを子エンティティにアップロード
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
子の親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
子の親エンティティに対する一意識別子 |
|
子エンティティ
|
childEntity | True | string |
ドキュメントをアップロードする子エンティティ |
|
子エンティティの ID
|
childId | True | string |
子エンティティの ID |
|
操作を実行する入力ファイル。
|
file | True | file |
操作を実行する入力ファイル。 |
|
アップロードされるドキュメントの種類
|
documentTypeName | string |
アップロードされるドキュメントの種類 |
|
|
ドキュメントの作成者
|
createdBy | string |
ドキュメントの作成者 |
子 エンティティの作成
子 エンティティの作成
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
子が作成される親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
子を作成する親エンティティの一意識別子 |
|
子エンティティ
|
childEntity | True | string |
作成中の子エンティティ |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
|
|
body
|
body | True | dynamic |
戻り値
子 エンティティの削除
子 エンティティの削除
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
削除される子の親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
親エンティティの ID |
|
子エンティティ
|
childEntity | True | string |
照会される子エンティティ |
|
子エンティティの ID
|
childId | True | string |
子エンティティの ID |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
子 エンティティの読取り
子 エンティティの読取り
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
読み込まれる子の親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
子を作成する親エンティティの一意識別子 |
|
子エンティティ
|
childEntity | True | string |
読み込まれる子エンティティ |
|
子エンティティの ID
|
childId | True | string |
子エンティティの ID |
戻り値
子エンティティ コレクションの読み込み
子エンティティ コレクションの読み込み
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
読み込まれる子の親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
子を作成する親エンティティの一意識別子 |
|
子エンティティ
|
childEntity | True | string |
読み込まれる子エンティティ |
|
スキップするレコード
|
skip | True | integer |
スキップするレコードの数 |
|
取得するレコード
|
take | True | integer |
取得するレコード数 |
|
フィルター
|
filter | string |
Open Data Protocol 構文を使用してレコードをフィルターする |
戻り値
子エンティティの置換
これにより、子エンティティの内容が置き換えられます。 含まれていないすべてのプロパティがエンティティから削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
親エンティティ
|
parentEntity | True | string |
更新される子の親エンティティ |
|
親エンティティ ID
|
parentId | True | string |
子が更新される親エンティティの一意な識別子 |
|
子エンティティ
|
childEntity | True | string |
更新される親エンティティ |
|
子エンティティの ID
|
childId | True | string |
子エンティティの ID |
|
関連付け ID
|
x-correlation-id | string |
x-correlation-id ヘッダーに追加された関連付け ID |
|
|
If-Match
|
If-Match | True | string |
If-Match ヘッダーに追加された ETag |
|
body
|
body | True | dynamic |
戻り値
トリガー
| エンティティが作成されたとき |
エンティティが作成されたとき |
| エンティティが削除されたとき |
エンティティが削除されたとき |
| エンティティが更新されたとき |
エンティティが更新されたとき |
| エンティティにイベントが発生した場合 |
エンティティにイベントが発生した場合 |
| エンティティに長時間実行操作を行った場合 |
エンティティに長時間実行操作を行った場合 |
エンティティが作成されたとき
エンティティが作成されたとき
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
作成中の子エンティティ |
|
Entity
|
key | string |
エンティティの高度なフィルター |
|
|
価値
|
value | string |
価値 |
戻り値
エンティティが削除されたとき
エンティティが削除されたとき
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
削除された子エンティティ |
|
Entity
|
key | string |
エンティティの高度なフィルター |
|
|
価値
|
value | string |
価値 |
戻り値
エンティティが更新されたとき
エンティティが更新されたとき
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
更新中のエンティティ |
|
Entity
|
key | string |
エンティティの高度なフィルター |
|
|
値
|
value | string |
値 |
戻り値
エンティティにイベントが発生した場合
エンティティにイベントが発生した場合
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
エンティティの種類
|
entityType | True | string |
トリガーされたエンティティ |
|
イベント タイプ
|
eventType | True | string |
操作のイベント タイプ |
|
Entity
|
key | string |
エンティティの高度なフィルター |
|
|
値
|
value | string |
値 |
戻り値
エンティティに長時間実行操作を行った場合
エンティティに長時間実行操作を行った場合
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サービス
|
service | True | string |
情報を含むサービス |
|
Entity
|
entityType | True | string |
エンティティ |
|
EventType
|
eventType | True | string |
イベントの種類 |
|
Property
|
key | string |
エンティティの高度なフィルター |
|
|
価値
|
value | string |
価値 |