Marketplace ユーザーガイド

最終更新日時 2024年9月5日

セットアップ

はじめに

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

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

大事な： UiPath アプリを使用している場合は、管理者の同意を追加していることを確認する必要があります。

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

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

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

注:

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

アクセス許可を追加すると、[ Microsoft Office 365 スコープ] アクティビティと [Microsoft Teams スコープ] アクティビティの両方で同じ アプリケーション ID を使用できます。

手順

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

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

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

今後、Microsoft は既定のリダイレクト URI を https://<span>login.microsoftonline.com/common/oauth2/nativeclient</span>に変更する予定です。代わりにこれを使用することを検討してください。

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

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

登録済みアプリケーションのページ (Azure Portal > Azure Active Directory > アプリの登録 > Office365App) の左側ナビゲーションパネルにある [API のアクセス許可] をクリックします。
[API のアクセス許可] ページが開いたら、[+ アクセス許可の追加] をクリックします ([API アクセス許可の要求] ウィンドウが開きます)。
[API を選択します] の下の [Microsoft API] をクリックします (既定で開いている場合もあります)。
[よく使用される Microsoft API] の下の [Microsoft Graph] をクリックします。
[ アプリケーションに必要なアクセス許可の種類] の下で [ 委任されたアクセス許可 ] をクリックして、アクセス許可のリストを表示します。
- [アプリケーションのアクセス許可] でも機能しますが、アクティビティは、Microsoft Graph API に [委任されたアクセス許可] が割り当てられたアプリ向けに設計されています。
- アクセス許可の種類について詳しくは、Microsoft Azure のドキュメント「クイックスタート: Web API にアクセスするようにクライアントアプリケーションを構成する」をご覧ください。
検索バーを使用するか、アルファベット順のリストをスクロールして、以下のアクセス許可を選択します。
- Chat.ReadWrite
- Group.ReadWrite.All
- User.Read.All
[アクセス許可の追加] をクリックします ([API のアクセス許可] リストに戻ります)。
API の アクセス許可 に、 追加したチャット、 グループ、 ユーザー の権限が含まれるかどうかを確認します。

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

新しいオートメーションプロジェクトを作成します。
1. UiPath Studio を開きます。
2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。
3. プロジェクトの [名前]、[場所]、[説明] を入力します。
4. [作成] をクリックします。
UiPath.MicrosoftTeamsActivities パッケージを インストールします。
1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
2. [すべてのパッケージ] の下の [Go!] をクリックします。
3. 検索バーに「 Teams」と入力します。
4. [インストール] をクリックし UiPath.Teams.Activitiesのライセンスに同意します。
  - UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

完了です!

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

次の手順

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

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