セットアップ

はじめに

Microsoft Teams アクティビティを有効化するには、アプリケーションを Microsoft ID プラットフォーム と統合し、適切な Microsoft Graph API アクセス許可 を割り当てる必要があります。

アプリケーションを統合し、権限を割り当てて、オートメーション プロジェクトの構築を開始するには、まず独自のアプリを作成するか、UiPath アプリ (例: UiPathStudioO365App) を使用するかを決定する必要があります。

重要:

UiPath アプリを使用している場合は、管理者の同意を追加する必要があります。

管理者の同意を追加しない場合は、以下のエラーが表示されます。

独自のアプリを作成する場合は、以下の手順に従う必要があります。

Microsoft Office Teams アプリケーションを登録すると、Azure Active Directory は一意のアプリケーション (クライアント) ID を割り当てます。この ID を [Microsoft Office Teams スコープ] に入力します。

注:

Microsoft Office 365 アクティビティをすでに完了している場合、または既存の登録済みアプリケーションがある場合は、直接 [ API のアクセス許可を追加 ] セクションに移動して、Microsoft Teams アクティビティに必要なアクセス許可を追加できます。

権限を追加すると、[Microsoft Office 365 スコープ] アクティビティと [Microsoft Teams スコープ] アクティビティの両方で同じアプリケーション ID を使用できるようになります。

手順

1. アプリケーションを登録する

1. 個人、会社、または学校の Microsoft 365 アカウントを使って Azure ポータル にサインインします。

2. 左側のナビゲーション パネルにある [Azure Active Directory] をクリックします。

3. [Azure Active Directory] のページが開いたら、[アプリの登録] をクリックします。

4. 上部のナビゲーションバーで [+ 新規登録] をクリックします。

   

5. アプリケーションの [名前] を入力します (例: "Office365App")。

6. [サポートされているアカウントの種類] のセクションで、該当するオプションを選択します。

   • 選択するオプションに関する詳細として、以下に Microsoft による推奨事項を示します。
     • この組織ディレクトリのみに含まれるアカウント - ターゲット オーディエンスが組織内のユーザーである場合、このオプションを使用します。
     • 任意の組織ディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) - ターゲット オーディエンスが、業務または教育関連の顧客であり、マルチテナントを有効化するには、このオプションを使用します。
     • 任意の組織ディレクトリ (Azure AD ディレクトリ - マルチテナント) 内のアカウントと、個人用の Microsoft アカウント (Skype、Xbox など) - 最も広範な Microsoft ID をターゲットとし、マルチテナントを有効化するには、このオプションを使用します。
   • [リダイレクト URI] (任意) に、URI アドレスを入力します (該当する場合)。
   • 選択は、使用する認証の種類によって決まります。このトピックの詳細については、[ Microsoft Teams スコープ] アクティビティの詳細ページの「 無人オートメーションと有人オートメーション 」をご覧ください。
   • 今回の例の組織は、マルチテナントの認証をサポートし、認証の種類としてはリダイレクト URI を必要とする対話型トークンのみを使用できます。
   • 認証の種類が統合 Windows 認証またはユーザー名とパスワードの場合、アプリケーションのリダイレクト URI の登録は不要です。これらのフローでは、Microsoft ID プラットフォーム v2.0 エンドポイントまでのラウンド トリップが行われ、アプリケーションが特定の URI でコール バックされることはありません。
   • 詳細については、Microsoft ID プラットフォームのドキュメントのデスクトップ アプリの登録に関する項をご覧ください。

7. [登録] をクリックします。

   

   注:

   現在、Microsoft Authentication Library (MSAL.NET) は、既定のリダイレクト URI として urn:ietf:wg:oauth:2.0:oob を使用しています。認証の種類が対話型トークンの場合、おそらくこの値で問題ありません (UiPath ではすべての例と「クイックスタート」ページでこの値を使用しています)。

   将来、Microsoft は既定のリダイレクト URI を https://login.microsoftonline.com/common/oauth2/nativeclient に変更する予定であるため、代わりにこちらを使用することを検討してももよいでしょう。

これで完了です。それでは、登録したアプリケーションに API アクセス許可を割り当てましょう。

2. API のアクセス許可を追加する

1. 登録済みアプリケーションのページ (Azure Portal > Azure Active Directory > アプリの登録 > Office365App) の左側ナビゲーション パネルにある [API のアクセス許可] をクリックします。

2. [API のアクセス許可] ページが開いたら、[+ アクセス許可の追加] をクリックします ([API アクセス許可の要求] ウィンドウが開きます)。

3. [API を選択します] の下の [Microsoft API] をクリックします (既定で開いている場合もあります)。

4. [よく使用される Microsoft API] の下の [Microsoft Graph] をクリックします。

   

5. [ アプリケーションに必要なアクセス許可の種類] の下で [ 委任されたアクセス許可 ] をクリックして、アクセス許可のリストを表示します。

   • [アプリケーションのアクセス許可] でも機能しますが、アクティビティは、Microsoft Graph API に [委任されたアクセス許可] が割り当てられたアプリ向けに設計されています。
   • アクセス許可の種類について詳しくは、Microsoft Azure のドキュメント「クイック スタート:Web API にアクセスするようにクライアント アプリケーションを構成する」をご覧ください。

6. 検索バーを使用するか、アルファベット順のリストをスクロールして、以下のアクセス許可を選択します。

   • Chat.ReadWrite
   • Group.ReadWrite.All
   • User.Read.All

7. [アクセス許可の追加] をクリックします ([API のアクセス許可] リストに戻ります)。

   

8. [ API のアクセス許可 ] に、 チャット、 グループ、 およびユーザーの アクセス許可が追加されていることを確認します。

   

3. プロジェクトをビルドする

1. 新しいオートメーション プロジェクトを作成します。

   1. UiPath Studio を開きます。

   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。

   3. プロジェクトの [名前]、[場所]、[説明] を入力します。

   4. [Create] をクリックします。

      

2. UiPath.MicrosoftTeamsActivities パッケージをインストールします。
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [Go!] をクリックします。
   3. [検索] バーに「Teams」と入力します。
   4. [インストール] をクリックし UiPath.Teams.Activities のライセンスに同意します。

      • UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

        

完了です!

以上で設定が完了したので、プロジェクトへの Microsoft Teams アクティビティの追加を開始できます。

次のステップ

アクティビティの実践的な使い方を学び、すぐに使用を開始するには「クイックスタート」のページをご覧ください。これらのガイドには、各種アクティビティの実用的なサンプルを作成するためのステップバイステップの手順が記載されており、登録済みのアプリケーションへの接続を確認したり、入/出力プロパティに習熟したりすることができます。

Microsoft Teams アクティビティの詳細 (プロパティの入力/出力の例を含む) については、以下のアクティビティのページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

• Channels
• Chats
• Messages
• Teams