チャンネルを作成

概要

[チャネルを作成] アクティビティは、Microsoft Graph の CreateChannel API を呼び出して、指定したチーム ([チーム ID]) 内に新しいチャネル ([名前]) を作成します。

新しいチャネルを作成すると、アクティビティはそのプロパティを Channel オブジェクトに出力します。このオブジェクトは、後続のアクティビティ (例: [メッセージを取得]、[メッセージを送信] などのChannel.Id) で入力変数として使用できます。

動作のしくみ

次の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入出力プロパティ) から実行時までのアクティビティの動作の例です。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ Microsoft Teams スコープ ] アクティビティを追加します。
3. Team.Id値を出力するアクティビティを追加するか、外部プロセスを実行します (例: [チームを取得])。
4. [Microsoft Teams スコープ] アクティビティ内に [チャネルを作成] アクティビティを追加します。
5. [入力] セクションのプロパティに値を入力します。
6. [出力] セクションのプロパティのために Channel 型変数を作成し、入力します。
7. アクティビティを実行します。

   • 入力したプロパティ値は、 CreateChannel API に渡されます。

   • API は、[出力] セクションのプロパティ変数に Channel の値を返します。

     

プロパティ

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

共通

表示名

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

属性	詳細
入力	String
Required	はい
既定値	チャンネルを作成
許容値	String または String 型変数を入力します。
備考	N/A

入力

名前

新しいチャネルの表示名。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	この値は Microsoft Teams アプリに表示されます。

TeamId

チャネルの作成に使用する Team オブジェクトの ID です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	Team.Id値を取得するには、出力に Team.Id 値を含む外部プロセスまたはアクティビティを使用します (例: [チームを取得] や外部 API 呼び出し)

その他

プライベート (Private)

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

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

オプション

説明

チャネルの説明 (任意)。

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

出力

Channel

作成したチャネルを表す Channel オブジェクトです。

属性	詳細
入力	Channel
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合は必須)
既定値	空
許容値	Channel 型変数を入力します。
備考	このプロパティ用に作成した変数は、後続のアクティビティ (例: [メッセージを取得]、[メッセージを送信] などのChannel.Id) で入力変数として使用できます。Channel オブジェクトには、他のアクティビティで使用できる複数のプロパティと関係が含まれます。下の画像の例に、返すことができるプロパティの一部を示します。注 - デザイナーに表示されているプロパティの中には、 Channel オブジェクトに適用できないものがあります ( Visibilityなど)。該当する Team プロパティのリストについては、上記のリンクをご覧ください。

例

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

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