Set up your Microsoft 365 Azure application

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

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

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

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

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

Tip: This process is described in detail in the Microsoft documentation in Quickstart: Register an application with the Microsoft identity platform. Please note that the Microsoft UI may have changed since these steps were first documented.

1. 個人、会社、または学校の Microsoft 365 アカウントを使って Azure ポータルにサインインします。
2. 左側のナビゲーション パネルにある [Azure Active Directory] をクリックします。
3. [Azure Active Directory] のページが開いたら、[アプリの登録] をクリックします。

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

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

6. Under Supported account types, select the option that applies to you. For more information about which option to select, refer to Who can sign in to you app?:

   • Accounts in this organizational directory only - Use this option if your target audience is internal to your organization. This represents a single tenant application.
   • Accounts in any organizational directory (Any Azure AD directory - Multitenant) - Use this option if your target audience is business or educational customers. This represents a multitenant application.
   • Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox) - Use this option to target the widest set of Microsoft identities. This represents a multitenant application.
7. Under Redirect URI (optional), enter a URI address (if applicable). The Microsoft Authentication Library (MSAL.NET) uses a default redirect URI: https://login.microsoftonline.com/common/oauth2/nativeclient. This value will likely work for you when using the Interactive Token authentication type.
   • Your selection is dependent on your authentication type. For more information on this topic, see How to connect to Microsoft 365 activities).
   • In our example, the organization supports multi-tenant authentication and can only use the Interactive Token authentication type which requires a redirect URI.
     • If you use Interactive Token and the default Microsoft Redirect URI, you must add a platform of type Mobile and desktop applications. For more information, see Configure platform settings in the Microsoft documentation.
     • If your authentication type is Integrated Windows Authentication or Username and Password, you don't need to register a redirect URI for your application. These flows do a round trip to the Microsoft identity platform v2.0 endpoint, and your application won't be called back on any specific URI.
   • When working with Microsoft 365 in a UiPath Studio project targeting .NET 5.0, add http://localhost to the Redirect URI of your custom applications.

     詳細については、Microsoft ID プラットフォームのドキュメントのデスクトップ アプリの登録に関する項をご覧ください。

8. Select Register. An example configuration is available in the image below.

   注: この設定は一例に過ぎません。ドキュメントに記載された手順に従い、組織のポリシーに基づいて設定を選択してください。
   
   

   

   
   

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

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

1. 登録済みアプリケーションのページ (Azure Portal > Azure Active Directory > アプリの登録 > Office365App) の左側ナビゲーション パネルにある [API のアクセス許可] を選択します。
2. [API のアクセス許可] ページが開いたら、[+ アクセス許可の追加] をクリックします ([API アクセス許可の要求] ウィンドウが開きます)。
3. [API を選択します] の下の [Microsoft API] をクリックします (既定で開いている場合もあります)。

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

5. Under What type of permissions does your application require?, click Delegated permissions or Application permissions to show the list of permissions. Select Application permissions if you are using ApplicationIdAndSecret or ApplicationIdAndCertificate authentication type. The other authentication types available in Microsoft 365 Scope activity require Delegated permissions.

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

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

   Note: These permissions are not all mandatory. The provided list represents the complete set of permissions required to run all Microsoft 365 activities. You can restrict permissions depending on your particular use case. Check out the activities documentation pages to learn what permissions they need.

   • 予定表/カレンダー

     • 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
   • ユーザー
     • User.Read

   • Shared (scopes needed to access resources that are shared with, but not owned by, the user.)

     • Mail.Read.Shared
     • Mail.ReadWrite.Shared
     • Mail.Send.Shared
     • Calendars.Read.Shared
     • Calendars.ReadWrite.Shared

   • Select Add permissions to return to your list of API permissions.

     
     

     

     
     

7. Make sure your API permissions include your added Calendars, Files, User, and Mail permissions.

   
   

   

   
   

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

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

   1. UiPath Studio を開きます。

   2. Under New Project, click Process. This opens a New Blank Process window.

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

   4. [対応 OS] を選択します。既定では Windows が選択されています。

   5. [作成] をクリックします。

2. UiPath.MicrosoftOffice365.Activities パッケージをインストールします。

   1. From the Design ribbon, select Manage Packages.
   2. [すべてのパッケージ] の下の [検索] バーに、「Office 365」または「Microsoft」と入力します。
   3. Select the package version you want, then select Install.
   4. [保存] ボタンをクリックします。
   UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

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

次のステップ

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

To learn more about the Microsoft 365 activities (including example property inputs/outputs), see the Classic activities for a complete list and links to the activity detailed pages.