アクティビティ

Microsoft 365 Azure アプリを設定する

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

アプリケーションを統合し、アクセス許可を割り当て、オートメーションプロジェクトの構築に着手するには、以下の手順を実行します。

アプリケーションを登録する
API のアクセス許可を追加する
プロジェクトをビルドする

Microsoft 365 アプリケーションを登録すると、Azure Active Directory は一意のアプリケーション (クライアント) ID を割り当てます。この ID を、アクセス許可を割り当てたサービス (ファイル、メール、予定表など) とともに [Microsoft Office 365 スコープ] アクティビティに入力します。

セットアップ

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

個人、会社、または学校の Microsoft 365 アカウントを使って Azure ポータルにサインインします。
左側のナビゲーションパネルにある [Azure Active Directory] をクリックします。
[Azure Active Directory] のページが開いたら、[アプリの登録] をクリックします。
上部のナビゲーションバーで [+ 新規登録] をクリックします。
アプリケーションの [名前] を入力します (例: "Office365App")。
[サポートされているアカウントの種類] のセクションで、該当するオプションを選択します。選択するオプションに関する詳細として、以下に Microsoft による推奨事項を示します。
- この組織のディレクトリ内のアカウントのみ - ターゲットオーディエンスが組織内のユーザーである場合、このオプションを使用します。
- 任意の組織のディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) - ターゲットオーディエンスが、業務または教育関連の顧客であり、マルチテナントを有効化するには、このオプションを使用します。
- 任意の組織のディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) および個人用の Microsoft アカウント (例: Skype、Xbox) - 最も広範な Microsoft ID をターゲットとし、マルチテナントを有効化するには、このオプションを使用します。
[リダイレクト URI] (任意) に、URI アドレスを入力します (該当する場合)。

Microsoft 認証ライブラリ (MSAL.NET) は、既定のリダイレクト URI https://login.microsoftonline.com/common/oauth2/nativeclientを使用します。認証の種類として対話型トークンを使用する場合、おそらくこの値で問題ありません。
- 選択は、使用する認証の種類によって決まります。このトピックの詳細については、[Microsoft 365 スコープ] アクティビティの詳細に関するページの「無人オートメーションと有人オートメーション」セクションをご覧ください。
- 今回の例の組織は、マルチテナントの認証をサポートし、認証の種類としてはリダイレクト URI を必要とする対話型トークンのみを使用できます。
- 対話型トークンと既定の Microsoft リダイレクト URI を使用する場合は、種類がモバイルアプリケーションとデスクトップアプリケーションのプラットフォームを追加する必要があります。詳しくは、Microsoft のドキュメントをご覧ください。
- 認証の種類が統合 Windows 認証またはユーザー名とパスワードの場合、アプリケーションのリダイレクト URI の登録は不要です。これらのフローでは、Microsoft ID プラットフォーム v2.0 エンドポイントまでのラウンドトリップが行われ、アプリケーションが特定の URI でコールバックされることはありません。
- .NET 5.0 をターゲットにする UiPath Studio プロジェクトで Microsoft 365 を使用する場合、クライアントはカスタムアプリケーションのリダイレクト URI に http://localhost を追加する必要があります。
  
  詳細については、Microsoft ID プラットフォームのドキュメントのデスクトップアプリの登録に関する項をご覧ください。
[登録] をクリックします。次のスクリーンショットに、設定例を示します。
注: この設定は一例に過ぎません。ドキュメントに記載された手順に従い、組織のポリシーに基づいて設定を選択してください。

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

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

登録済みアプリケーションのページ (Azure Portal > Azure Active Directory > アプリの登録 > Office365App) の左側ナビゲーションパネルにある [API のアクセス許可] をクリックします。
[API のアクセス許可] ページが開いたら、[+ アクセス許可の追加] をクリックします ([API アクセス許可の要求] ウィンドウが開きます)。
[API を選択します] の下の [Microsoft API] をクリックします (既定で開いている場合もあります)。
[よく使用される Microsoft API] の下の [Microsoft Graph] をクリックします。
[アプリケーションに必要なアクセス許可の種類] の下で [委任されたアクセス許可] または [アプリケーションのアクセス許可] をクリックして、アクセス許可のリストを表示します。[Microsoft Office 365 スコープ] アクティビティの [認証の種類] の値が [ApplicationIdAndSecret] または [ApplicationIdAndCertificate] に設定されている場合、[アプリケーションのアクセス許可] を設定する必要があります。[Microsoft Office 365 スコープ] アクティビティで利用可能なその他の認証の種類には、[委任されたアクセス許可] を設定する必要があります。

アクセス許可の種類について詳しくは、Microsoft Azure のドキュメント「クイックスタート: Web API にアクセスするようにクライアントアプリケーションを構成する」をご覧ください。

重要:
一部のアクティビティ (例: [会議日時を検索]) は、認証の種類 [ApplicationIdAndSecret] または [ApplicationIdAndCertificate] に対応していません。

メールアクティビティの場合は、必ず [アカウント] パラメーターの値 (つまり、テナント内のすべてのメールボックスのどれを使用するか) を指定する必要があります。

この認証の種類を使用すると、アプリケーションにはテナント内のすべてのメールボックスに対するアクセス許可が付与されます。アプリケーション API の権限 Mail.Read はすべてのメールボックス内のメールの読み取りを意味し、Mail.ReadWrite はすべてのメールボックス内のメールの読み書きを意味しているからです。

それを避けたい場合は、アプリケーションのアクセス許可を特定のメールボックスに限定し、アプリケーションがそのメールボックスにしかアクセスできないようにします。

詳しくは、「アプリケーションのアクセス許可を Exchange Online の特定のメールボックスにスコーピングする」をご覧ください。

アプリケーションに (すべての SharePoint サイトコレクションではなく) 特定の SharePoint サイトコレクションへのアクセスのみを許可するには、アプリケーションのアクセス許可 Sites.Selected を使用します。
検索バーを使用するか、アルファベット順のリストをスクロールして、以下のアクセス許可を選択します。
- 予定表/カレンダー
  - Calendars.Read
  - Calendars.ReadWrite
- ファイル
  - Files.Read
  - Files.Read.All
  - Files.ReadWrite
  - Files.ReadWrite.All
- サイト
  - Sites.Read.All
  - Sites.ReadWrite.All
- メール
  - Mail.Read
  - Mail.ReadWrite
  - Mail.Send
- 共有\*
  - Mail.Read.Shared
  - Mail.ReadWrite.Shared
  - Mail.Send.Shared
  - Calendars.Read.Shared
  - Calendars.ReadWrite.Shared
    
    \* ユーザーと共有しているがそのユーザーが所有しているのではないリソースにアクセスするために必要なスコープ。
- [アクセス許可の追加] をクリックします ([API のアクセス許可] リストに戻ります)。
[API のアクセス許可] に、予定表、ファイル、メールのアクセス許可が追加されていることを確認します。

デスクトップ版の Studio でプロジェクトを構築する

新しいオートメーションプロジェクトを作成します。
- UiPath Studio を開きます。
- [新規プロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。
- プロジェクトの [名前]、[場所]、[説明] を入力します。
- [対応 OS] を選択します。既定では Windows が選択されています。
- [作成] をクリックします。
UiPath.MicrosoftOffice365.Activities パッケージをインストールします。
- [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
- [すべてのパッケージ] の下の [検索] バーに、「Office 365」または「Microsoft」と入力します。
- 目的のパッケージバージョンを選択し、[インストール] をクリックします。
- [保存] ボタンをクリックします。
  UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

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

次のステップ

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

Microsoft 365 アクティビティについて詳しくは (プロパティの入力/出力の例を含む) はクラシックアクティビティに関するこちらのページをご覧ください。すべてのアクティビティがまとめられたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。