Office365

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

• エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。

  ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。

• オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
  • リスト
  • 取得
  • 作成
  • 更新
  • 削除

  使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。

• アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

アクション

このセクションには、コネクタでサポートされているアクションが一覧表示されます。アクションの構成方法については、アクションの例をご覧ください。

CancelEvent アクション

このアクションにより、予定をキャンセルできます。

CancelEvent アクションの入力パラメータ

CancelEvent アクションの構成方法の例については、アクションの例をご覧ください。

MoveMail アクション

このアクションにより、メールを移動できます。

MoveMail アクションの入力パラメータ

MoveMail アクションの構成方法の例については、アクションの例をご覧ください。

AssignLicense アクション

このアクションを行うと、ライセンスを割り当てることができます。

AssignLicense アクションの入力パラメータ

AssignLicense アクションの構成方法の例については、アクションの例をご覧ください。

ForwardEvent アクション

このアクションにより、予定を転送できます。

ForwardEvent アクションの入力パラメータ

ForwardEvent アクションの構成方法の例については、アクションの例をご覧ください。

UploadFile アクション

このアクションにより、ファイルをアップロードできます。

UploadFile アクションの入力パラメータ

UploadFile アクションの構成方法の例については、アクションの例をご覧ください。

DownloadFile アクション

このアクションにより、ファイルをダウンロードできます。

DownloadFile アクションの入力パラメータ

DownloadFile アクションの構成方法の例については、アクションの例をご覧ください。

CreateFolder アクション

このアクションにより、フォルダを作成できます。

CreateFolder アクションの入力パラメータ

CreateFolder アクションの構成方法の例については、アクションの例をご覧ください。

SendMail アクション

このアクションにより、メールを送信できます。

SendMail アクションの入力パラメータ

SendMail アクションの構成方法の例については、アクションの例をご覧ください。

ForwardMail アクション

このアクションにより、メールを転送できます。

ForwardMail アクションの入力パラメータ

ForwardMail アクションの構成方法の例については、アクションの例をご覧ください。

DownloadEmail アクション

このアクションにより、メールをアップロードできます。

DownloadEmail アクションの入力パラメータ

DownloadMail アクションの構成方法の例については、アクションの例をご覧ください。

DownloadAttachments アクション

このアクションにより、メールの添付ファイルをダウンロードできます。

DownloadAttachments アクションの入力パラメータ

DownloadAttachments アクションの構成方法の例については、アクションの例をご覧ください。

アクションの例

このセクションでは、このコネクタでいくつかのアクションを実行する方法について説明します。

例 - イベントをキャンセルする

この例では、指定された ID のイベントをキャンセルします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [CancelEvent] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
   "Comment": "Canceled due to rain"
   }

アクションが成功すると、CancelEvent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - ライセンスの割り当てと削除を行う

この例では、指定したユーザーにライセンスを割り当て、削除します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [AssignLicense] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

アクションが成功すると、AssignLicense タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - イベントを転送する

この例では、イベントを転送します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [ForwardEvent] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
   "Comment": "forwarded due to rain",   
   "ToRecipients": "test99@example.com"
   }

アクションが成功すると、ForwardEvent タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - ファイルをアップロードする

この例では、ファイルをアップロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [UploadFile] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "FileName": "Document1234.docx",   
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "Content": "test"
   }

アクションが成功すると、UploadFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

例 - ファイルをダウンロードする

この例では、ファイルをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadFile] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

アクションが成功すると、DownloadFile タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

例 - フォルダを作成する

この例では、フォルダを作成します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [CreateFolder] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "FolderName": "outbox1234"
   }

アクションが成功すると、CreateFolder タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例: メールを送信する

この例では、指定した受信者にメールを送信します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [SendMail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "ToRecipients": "test097@example.com",   
   "Content": "Testing",   
   "Subject": "Test subject",   
   "FileName": "Google"
   }

アクションが成功すると、SendMail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - メールを転送する

この例では、メールを転送します。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [ForwardMail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
   "ToRecipients": "test097@example.com",   
   "Comment": "forwarded message"
   }

アクションが成功すると、ForwardMail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success"
}]

例 - メールをダウンロードする

この例では、メールをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadEmail] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

アクションが成功すると、DownloadEmail タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Status": "Success",   
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

例 - 添付ファイルをダウンロードする

この例では、添付ファイルをダウンロードします。

1. [Configure connector task] ダイアログで、[Actions] をクリックします。
2. [DownloadAttachments] アクションを選択してから、[完了] をクリックします。
3. [コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、Default Valueフィールドに次のような値を入力します。

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
   "DownloadTo": "My files/Office355/reports/"}
   }

アクションが成功すると、DownloadAttachments タスクの connectorOutputPayload レスポンス パラメータの値は次のようになります。

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]