Get Teams

概要

[チームを取得] アクティビティは、検索パラメーター ([クエリ オプション]) と指定したチーム リストの種類 ( フィルター - AllTeams または MyJoinedTeams ) を使用して、Microsoft Graph の ListAllTeams または ListJoinedTeams API を呼び出して、 クエリ に一致するチームを取得します。

チームを取得すると、アクティビティはそのプロパティと関係をオブジェクト Team[] 出力します。これは、後続のアクティビティ (例: 'Team(0)) で入力変数として使用できます。 [チャンネルを取得]、[チャンネルを 更新]などの ID)。

動作のしくみ

以下の手順とメッセージ シーケンス図は、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作方法の例を示したものです

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [Microsoft Teams スコープ] アクティビティを追加します。
3. [ Microsoft Teams スコープ] アクティビティ内に [チームを 取得 ] アクティビティを追加します。
4. [入力] セクションのプロパティに値を 入力 します。
5. [ 出力] セクションのプロパティのために Team[] 変数を作成し、入力します。

6. アクティビティを実行します。

   • 入力したプロパティ値は、 ListAllTeams または ListJoinedTeams API に渡されます。
   • API は、[出力] セクションのプロパティ変数に Team[] の値を返します。
     
     

     

     
     

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	Get Teams
許容値	String または String 型変数を入力します。
備考	N/A

入力

フィルター

取得したいチームの種類です。

属性	詳細
入力	ドロップダウン リスト
Required	はい
既定値	AllTeams
許容値	次の 2 つのオプションから選択します。 AllTeams - 所属する組織内の全チームを返します。 MyJoinedTeams - 所属しているチームのみを返します。
備考	以下のシーケンス画像の例は、両方のオプションの出力を示しています。

オプション

クエリ オプション

チームのリストを取得するときに適用する検索パラメータ。

属性	詳細
入力	QueryOption[] (OData 構文)
Required	いいえ
既定値	空
許容値	QueryOption[] または QueryOption 型変数を入力します。
備考	OData システム クエリ オプションを使用して値を入力します)。形式は次のとおりです: _{New QueryOption("Option", "OptionParameter")

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

出力

Teams

[リストの種類 ] と [ クエリ オプション ] の値に一致するチームの配列 (Team[] オブジェクト)。

属性	詳細
入力	Team[]
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合は必須)
既定値	空
許容値	Team[] 型変数を入力します。
備考	このプロパティ用に作成した変数は、後続のアクティビティ (例: 'Team(0)) で入力変数として使用できます。 [チャンネルを取得]、[チャンネルを 更新]などの ID)。 * この変数を入力プロパティの値として使用する場合、配列内の使用する項目を指定します (例: myTeams(0))。 Team オブジェクトには、他のアクティビティで使用できる複数のプロパティとリレーションシップが含まれます。下の画像の例に、返すことができるプロパティの一部を示します。 注 - デザイナーに表示されている一部のプロパティは、 Team オブジェクトには適用されません (例: Template)。 適用できる Team プロパティのリストは、上記のリンクから確認できます。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、「クイックスタート」ページをご覧ください。