コード化されたオートメーションのサービス用のコネクションを作成する

このセクションは、コード化されたオートメーション内の GSuite.Activities や Excel.Activities など、コネクションを使用するサービスから API にアクセスするために必要なコネクションを作成するのに役立ちます。

まず Integration Service でコネクションを作成します。このコネクションには、コード化されたオートメーション プロジェクトと同じ組織とテナント内でアクセスできます。コード化されたオートメーション内で、connections オブジェクトを使用して、先ほど Integration Service で作成したコネクションにアクセスし、対応する API にアクセスできます。

オートメーションが完成して Orchestrator にパブリッシュした後に、必要に応じて、コード内で設定した元のコネクションの設定を上書きできます。

前提条件

Integration Service でコネクションを作成します。

1. [Integration Service] に移動し、Studio が接続されているテナントを選択します。
2. [コネクション] に移動します。
3. [コネクションを追加] を選択し、次のいずれかのアプリケーションのコネクションを作成します。
   • Google ドライブ
   • Gmail
   • Google スプレッドシート
   • Microsoft Office 365

手順

1. 既存のコード化されたオートメーションを、最初にコネクションを作成した同じ組織とテナントから開きます。
2. Execute() の本体内に「connections」と入力し、Ctrl + Space キーを押して利用可能なコネクションを表示します。
   以前に connection を作成したアプリケーションに応じて、以下のコネクションの種類から選択できます。

   • Google ドライブ
   • Gmail
   • Google スプレッドシート
   • Excel
   • OneDrive
   • O365Mail
3. Orchestrator のフォルダーとサブフォルダーの名前、および特定のコネクションのアドレスを追加して、コネクションをさらに構成します。この情報を区切るには、アンダースコアを使用します。
   たとえば、Orchestrator の My Workspace フォルダーと My Gmail Worskapce サブフォルダー、および [e-mail] アドレスに対する Gmail のコネクションは、「connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com」とコードに記述します。

   推奨

   潜在的なエラーを避けるために、コネクションは 1 つのステップで作成することをお勧めします。また、コネクション用の変数を作成することもお勧めします。これにより、Integration Service で変更が発生しても、オートメーション全体でコネクションのすべてのインスタンスを更新する必要がなくなります。次の方法を使用します。

   var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

   以下のように、2 つのステップに分けてコネクションを作成するのは避けてください。

   var myGmailConnection = connections.Gmail;
   myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. connection を確立したら、その connection を通じて、サービスに固有の関連 API にアクセスできます。
   たとえば、Gmail のコネクションを var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com のように設定した場合、myGmailConnection を使用して、サービスの API を使用できます。

Orchestrator でコネクションをオーバーライドする

1. プロジェクトを Orchestrator にパブリッシュします。
2. プロジェクトをパブリッシュした Orchestrator フィードに移動します。
3. パブリッシュしたプロセスに移動し、[編集] を選択します。
4. [プロセスの設定] で、エントリ ポイントとして、設定したコネクションが含まれるコード化されたオートメーションを選択します。
5. [パッケージ要件] で、コード化されたオートメーションに対応するコネクションの種類を見つけて選択します。

   コード化されたオートメーションのコネクションの種類を選択する際は注意してください。このリストには、プロジェクト内の XAML ファイル用のコネクションも表示されます。

6. 実行時にそのコネクションに関連付ける予定のアカウントのアドレスを特定して選択します。

既知の制限事項

エクスポートされたライブラリの既定のコネクションは、インポートされたプロジェクトが元のライブラリ プロジェクトと同じテナント内にある場合にのみ、他のプロジェクトで動作します。