SharePoint

Windows 認証情報認証タイプ

Windows 認証情報認証タイプを有効にするには、次の手順を完了する必要があります。

1. PSC を構成し、エンドポイント アタッチメントを作成します。
2. Google Cloudで認証情報を指定します。

PSC を構成してエンドポイント アタッチメントを作成する

1. SharePoint がホストされている IP を使用してインスタンス グループを作成します。
2. 内部パススルー ネットワーク ロードバランサを作成し、作成したインスタンス グループをバックエンドとして使用します。TCP 内部ロードバランサでグローバル アクセスが有効になっている必要があります。
3. Private Service Connect でロードバランサを公開します。サービス アタッチメントは、ロードバランサの公開後に生成されます。
4. サービスを公開し、作成したロードバランサを指定します。
5. サービス アタッチメントを使用して、エンドポイント アタッチメントを作成します。
6. エンドポイント アタッチメントを作成したら、エンドポイント アタッチメントの IP を使用して SharePoint 接続を作成します。

エンドポイント アタッチメントの作成の詳細については、エンドポイント アタッチメントを作成するをご覧ください。

Google Cloudで Windows 認証情報の詳細を指定する

Integration Connectors で接続を作成するときは、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [Windows 認証情報] を選択し、次の詳細を入力します。

• ユーザー名: ユーザー名を入力します。
• パスワード: パスワードを選択します。
• シークレット バージョン: シークレット バージョンを入力します。

Windows 認証情報の接続タイプ

次の表に、Windows 認証情報接続タイプのサンプル構成値を示します。

Azure AD 認証タイプ

Azure AD 認証タイプを有効にするには、次の操作を行います。

1. アプリを登録して、OAuthClientId と OAuthClientSecret を取得します。
2. Google Cloudで認証情報を指定します。
3. Google Cloudで接続を承認します。
4. リダイレクト URL をアプリに追加します。

アプリを登録して OAuthClientId と OAuthClientSecret を取得する

アプリを登録して、アプリの OAuthClientId と OAuthClientSecret を取得するには、次の操作を行います。

1. Azure Portal にログインします。
2. [Azure サービス] で、[アプリの登録]、[新規登録] の順に選択します。
3. アプリケーション名を入力し、[Any Microsoft Entra ID tenant - Multitenant] を選択します。
4. [Register] をクリックします。
5. アプリを作成したら、[証明書とシークレット] ページに移動します。
6. アプリケーションのクライアント シークレットを作成し、クライアント シークレットの値を保存します。
7. [API 権限] ページに移動します。
8. [権限を追加] をクリックします。
9. [API のアクセス許可の要求] ダイアログで、次の表から API、タイプ、権限を選択して、アプリケーションでオペレーションを実行します。

接続を有効にするには、Microsoft Graph API の Sites.Read.All 権限を付与する必要があります。

API	権限名	タイプ
Microsoft Graph	ConsentRequest.Read.All	Application/ Delegated
Microsoft Graph	ConsentRequest.ReadWrite.All	Application/ Delegated
Microsoft Graph	DelegatedAdminRelationship.Read.All	Application/ Delegated
Microsoft Graph	DelegatedAdminRelationship.ReadWrite.All	Application/ Delegated
Microsoft Graph	DelegatedPermissionGrant.Read.All	Application/ Delegated
Microsoft Graph	DelegatedPermissionGrant.ReadWrite.All	Application/ Delegated
Microsoft Graph	Files.Read.All	Application/ Delegated
Microsoft Graph	Files.ReadWrite.All	Application/ Delegated
Microsoft Graph	Sites.FullControl.All	Application/ Delegated
Microsoft Graph	Sites.Manage.All	Application/ Delegated
Microsoft Graph	Sites.Read.All	Application/ Delegated
Microsoft Graph	Sites.ReadWrite.All	Application/ Delegated
Microsoft Graph	Sites.Selected	Application/ Delegated
Microsoft Graph	TermStore.Read.All	Application/ Delegated
Microsoft Graph	TermStore.ReadWrite.All	Application/ Delegated
Microsoft Graph	User.Export.All	Application/ Delegated
Microsoft Graph	User.Read	Delegated
Microsoft Graph	User.Read.All	Application/ Delegated
Microsoft Graph	User.ReadWrite.All	Application/ Delegated
SharePoint	EnterpriseResource.Read	Delegated
SharePoint	EnterpriseResource.Write	Delegated
SharePoint	Project.Read	Delegated
SharePoint	Project.Write	Delegated
SharePoint	ProjectWebApp.FullControl	Delegated
SharePoint	ProjectWebAppReporting.Read	Delegated
SharePoint	TaskStatus.Submit	Delegated

10. 変更を保存します。
11. 管理者権限が必要な権限を使用するように選択した場合は、[API 権限] ページで現在のテナントから権限を付与できます。
12. スコープを追加するには、[API を公開する] セクションに移動して AllSites.Manage, Sites.FullControl.All スコープを追加し、制御できるユーザー（管理者とユーザー）を選択します。
13. [保存] をクリックします。

Google Cloudで認証情報を指定する

Integration Connectors で接続を作成するときは、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [AzureAD] を選択し、次の詳細を入力します。

• クライアント ID: アクセス トークンのリクエストに使用するクライアント ID を入力します。
• スコープ: 必要なスコープをカンマ区切りのリストで入力します。例: Sites.FullControl.All
• クライアント シークレット: 作成した接続されているアプリのクライアント シークレットを含む Secret を入力します。
• シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
• 認証 URL: OAuth クライアントの作成時に生成する認証 URL。URL を https://login.microsoftonline.com/TENANT_IDENTIFIER/oauth2/v2.0/authorize?prompt=consent の形式で入力します。例: https://login.microsoftonline.com/9byyyyyyyyy8112/oauth2/v2.0/authorize?prompt=consent。

Google Cloudで接続を承認する

1. 接続ページで、新しく作成された接続を見つけます。

   新しいコネクタの [ステータス] は [承認が必要] になります。

2. [承認が必要] をクリックします。

   これにより、[承認の編集] ペインが表示されます。

3. [リダイレクト URI] の値を外部アプリケーションにコピーします。詳しくは、アプリにリダイレクト URL を追加するをご覧ください。
4. 認可の詳細を確認します。
5. [承認] をクリックします。

   認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

リダイレクト URL をアプリに追加する

1. Azure ポータルで、[Azure サービス > アプリの登録] をクリックします。
2. アプリ名をクリックします。
3. [リダイレクト URI を追加] をクリックします。
4. [プラットフォームを追加] をクリックします。
5. [ウェブ] ダイアログで、 Google Cloudで接続を承認したときにコピーしたリダイレクト URI を貼り付けます。

Azure AD 接続タイプ

次の表に、Azure AD 接続タイプのサンプル構成値を示します。

OAuth 2.0 - JWT Bearer 認証タイプを使用したクライアント認証情報

OAuth 2.0 - JWT ベアラー認証タイプでクライアント認証情報を有効にするには、次の手順を完了する必要があります。

1. 証明書を作成します。
2. 証明書を Azure ポータルにアップロードします。
3. 秘密鍵を取得します。
4. セットアップを完了します。
5. Google Cloudで OAuth 2.0 JWT Bearer 認証情報を指定します。

証明書を作成する

1. パソコンに空のフォルダを作成します。
2. フォルダにテキスト ファイルを作成します。
3. Azure AD アプリ専用ページからアクセス権を付与する の PowerShell スクリプトをコピーし、テキスト ファイルに貼り付けます。
4. テキスト ファイルの名前を Create-SelfSignedCertificate.ps1 に変更します。
5. フォルダで Windows PowerShell を実行します。
6. テキスト ファイルが含まれているディレクトリに移動します。
7. 次のコマンドをコピーします。 .\Create-SelfSignedCertificate.ps1 -CommonName "CERTIFICATE_NAME" -StartDate 2022-09-25 -EndDate 2023-10-25

   CERTIFICATE_NAME に一意の名前を入力します。StartDate を現在の日付に、EndDate を任意の日付に変更します。

8. コピーしたコマンドに変更を加えて Windows PowerShell に貼り付け、Enter キーを押します。

   Windows PowerShell で、秘密鍵を保護するためのパスワードの入力を求めるメッセージが表示されます。後で使用できるように、パスワードを保存しておいてください。

   Windows PowerShell によって、MyCertificate.pfx と MyCertificate.cer の 2 つのファイルが作成されます。

Azure ポータルに証明書をアップロードする

1. Azure Portal にログインし、次の詳細を指定して新しいアプリケーションを登録します。
   • 名前: アプリケーションの名前を入力します。
   • [サポートされているアカウントの種類]: [この組織ディレクトリ内のアカウントのみ（アカウント名のみ - 単一テナント）] を選択します。
2. [API 権限] > [権限を追加] > [API 権限をリクエスト] > [SharePoint] に移動します。
3. [アプリケーションの権限] を選択し、必要な権限を追加します。
4. [管理者の同意を得る] を選択し、[はい] を選択します。
5. アプリを作成したら、[証明書とシークレット] セクションに移動します。
6. [証明書をアップロード] を選択し、パソコンから CER 証明書をアップロードします。アップロードが完了したら、[追加] を選択します。

   クライアント シークレットは、証明書ベースの認証フローを妨げるため、アプリに追加しないでください。

7. マニフェストに移動し、KeyCredentials を見つけて、customKeyIdentifier をサムプリントとしてコピーします。この値は後で使用します。これで、アプリの登録と証明書のリンクが完了しました。

秘密鍵を取得する

秘密鍵を取得するには、OpenSSL を使用して PFX ファイルを PEM ファイルに変換します。

1. コマンド プロンプトで、PFX ファイルを含むフォルダに移動し、次のコマンドを実行します。 openssl pkcs12 -in MyCertificate.pfx -out MyCertificate.pem -nodes
2. 証明書の作成プロセスで使用した PFX パスワードを入力します。
3. テキスト エディタで PEM ファイルを開き、テキスト全体（秘密鍵）をコピーします。

セットアップを完了する

1. Azure ポータルで新しく登録したアプリからクライアント ID とテナント ID をコピーします。
2. 次の認証情報を使用して、SharePoint リスト サービス プリンシパルの認証でログインします。
• クライアント ID
• テナント ID
• 秘密鍵
• Thumbprint（秘密鍵のパスワード）

Google Cloudで OAuth 2.0 JWT Bearer 認証情報を指定する

Integration Connectors で接続を作成するときは、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [JWT ベアラーを使用した OAuth 2.0 クライアント認証情報] を選択し、次の詳細を入力します。

• [クライアント ID] フィールドに、アクセス トークンのリクエストに使用するクライアント ID を入力します。これは、Azure ポータルでアプリを登録したときに生成されたコンシューマー キーです。
• [秘密鍵] フィールドで、PEM 形式の秘密鍵ファイルの内容を含む Secret Manager のシークレットを選択します。秘密鍵は、コネクタに提供された公開鍵/証明書と一致する必要があります。
• [シークレットのバージョン] フィールドで、上で選択したシークレットのバージョンを選択します。
• [秘密鍵パスワード] フィールドで、秘密鍵ファイルのパスワード（言い回し）を含む Secret Manager のシークレットを選択します。証明書の作成時に秘密鍵の保護に設定したパスワードと同じパスワードを使用します。
• [シークレットのバージョン] フィールドで、上で選択したシークレットのバージョンを選択します。
• [Azure テナント] フィールドに、データへのアクセスに使用されている Microsoft オンライン テナントを入力します。

JWT Bearer 証明書接続タイプ

次の表に、OAuth 2.0 JWT Bearer 証明書接続タイプのサンプル構成値を示します。

OAuth 2.0 - クライアント シークレットの接続タイプ

OAuth 2.0 クライアント シークレット接続タイプを有効にするには、次の手順を完了する必要があります。

1. アドインを登録します。
2. アドオンに権限を付与します。
3. Google Cloudで OAuth 2.0 クライアント認証情報を指定する
4. 認証コードの再認可

アドインを登録する

1. 次の URL（ https://<SITE_NAME>.SharePoint.com/_layouts/15/appregnew.aspx）を使用して、[Register Add-In] ページに移動します。
2. [アプリ情報] セクションで、クライアント ID とクライアント シークレットを生成します。
3. タイトル、アプリのドメイン、リダイレクト URI の値を指定します。
4. [作成] をクリックします。アドインが登録され、SharePoint アプリに作成された情報が表示されます。

アドオンに権限を付与する

1. 次の URL（https://<SITE_NAME>-admin.sharepoint.com/_layouts/15/appinv.aspx）を使用して SharePoint サイトに移動します。[権限の付与] ページにリダイレクトされます。
2. [アプリ ID] 欄に、先ほど生成したクライアント ID を入力し、[参照] をクリックします。[タイトル]、[アプリのドメイン]、[リダイレクト URL] の値が入力されます。
3. 次の権限リクエストを XML 形式で入力します。

         <AppPermissionRequests AllowAppOnlyPolicy="true">
         <AppPermissionRequest Scope="http://sharepoint.com/content/tenant" Right="FullControl"/>
         </AppPermissionRequests>
           

4. [作成] をクリックします。SharePoint アプリに権限の同意ダイアログが表示されます。
5. [Trust it]（信頼する）をクリックします。

Google Cloudで OAuth 2.0 クライアント認証情報を指定する

Integration Connectors で接続を作成するときは、次の詳細を指定する必要があります。

[認証] セクションで、認証タイプとして [クライアント シークレットを使用する OAuth 2.0 クライアント認証情報] を選択し、次の詳細を入力します。

• [クライアント ID] フィールドに、作成したアプリ用にコネクタから提供されたクライアント ID を入力します。
• [クライアント シークレット] フィールドで、作成した接続されているアプリのクライアント シークレットを含む Secret Manager のシークレットを選択します。
• [シークレットのバージョン] フィールドで、クライアント シークレットのバージョンを選択します。

認証コードの再認可

Authorization code 認証タイプを使用しているユーザーが、SharePoint アプリケーションの構成を変更した場合は、SharePoint 接続を再承認する必要があります。接続を再認可するには、次の手順を行います。

1. [接続] ページで必要な接続をクリックします。

   これにより、[接続の詳細] ページが開きます。

2. [編集] をクリックして、接続の詳細を編集します。
3. [認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。

   必要に応じて必要な変更を加えます。

4. [保存] をクリックします。接続の詳細ページに移動します。
5. [認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
6. [Authorize（承認）] をクリックします。

   認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。

クライアント認証情報の接続タイプ

次の表に、OAuth 2.0 クライアント認証情報の接続タイプのサンプル構成値を示します。

操作

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

DeleteAttachment アクション

このアクションにより、添付ファイルが削除されます。

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

CheckInDocument アクション

このアクションにより、ドキュメントをチェックインできます。

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

CheckOutDocument アクション

このアクションにより、ファイルをチェックアウトできます。

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

DiscardCheckOutDocument アクション

このアクションにより、ファイルのチェックアウトを元に戻すことができます。

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

CopyDocument アクション

このアクションにより、ファイルをある場所から別の場所にコピーできます。

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

UploadDocument アクション

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

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

DownloadDocument アクション

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

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

MoveAttachmentOrDocument アクション

このアクションにより、ファイルをフォルダ間で移動できます。

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

CreateFolder アクション

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

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

AddAttachments アクション

このアクションにより、添付ファイルを追加できます。

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

DownloadAttachments アクション

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

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

アクションの例

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

例 - 添付ファイルを削除する

この例では、指定したファイルを削除します。

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

   {
   "ListTitle": "My lists",
   "ItemId": "1",
   "FileName": "sitepages.txt"
   }

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

[{
"Status": "Success"
}]

例 - ドキュメントをチェックインする

この例では、ドキュメントをチェックインします。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt",
   "Comment": "Comment test"
   }

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

[{
"Status": "Success"
}]

例 - ファイルをチェックアウトする

この例では、ファイルをチェックアウトします。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.txt"
   }

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

[{
"Status": "Success"
}]

例 - チェックアウトを破棄する

この例では、ファイルのチェックアウトを元に戻します。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "DocumentName": "Document.docx"
   }

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

[{
"Status": "Success"
}]

例 - ファイルをコピーする

この例では、ファイルをある場所から別の場所にコピーします。

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

   {
   "SourceFileRelativeUrl": "/Shared Documents/Document.docx",
   "DestFileRelativeUrl": "/Shared Documents/TestFolder/Document123.docx"
   }

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

[{
"Status": "Success"
}]

例 - テキスト ファイルをアップロードする

この例では、指定した場所にテキスト ファイルをアップロードします。

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

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "Content": "abcd"
   }

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

[{
"Status": "Success"
}]

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

この例では、バイナリファイルを指定した場所にアップロードします。バイナリ ファイルをアップロードする場合は、アップロードするコンテンツを Base64 でエンコードされた文字列として指定します。

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

   {
   "FileName": "test.txt",
   "RelativeUrl": "/Shared Documents/TestFolder",
   "ContentBytes": "SGVsbG8gd29ybGQK",
   "HasBytes": "true"
   }

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

[{
"Status": "Success"
}]

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

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

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

   {
   "RemoteFile": "/TestFolder/test.txt",
   "Library": "Shared Documents"
   }

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

[{
"Success": "True",
"Content": "Test File",
}]

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

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

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

   {
   "RemoteFile": "/TestFolder/test1.png",
   "Library": "Shared Documents"
   "HasBytes": "true"  
   }

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

[{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

例 - 特定のサイトからファイルをダウンロードする

この例では、特定のサイトからファイルをダウンロードします。

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

   {
     "RemoteFile": "	http://z8**.sharepoint.com/sites/SharepointGCS/Docs/SharpointGCS.docx",
     "Library": "Docs",
     "HasBytes": true
   }
   

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

[
  {
    "Success": "True",
    "ContentBytes": "UEsDBAoAAAAAAAAAIQD/////TwEAAE8BAAAQAAAAW3RyYXNoXS8wMDAwLmRhdP////nFmjQeC1QbGmk9o7n0xjiLgudAMOrYQBpOZdZp5/OrWkWbudVPccasL5uVSKun3URrHAxow7iMUm2WSi7nlGy2Mr+sjJxQSrYFcFtDQyo/QSutWhbNcAODEWh14mklzxCS9C5CW3Fmwme/gMKGjGoXlSVyvtDoB+u0A6XtA8bkWTnPNHSvxcepoAKIdsR96imCvxe4MxOWqHWnQkLDyjNMOMrrQeMDF7nOMCCvPlVn5Vd6KlDYnHlW1zLOcQf6WmKl2xN4Z8WBXZfkrJZqPv6yNdWyp8ADRmgTdRSqDkPpQqzvqWj3qpdiRZqSwyBRtfr2kHBumkTNjSi6drBMFMxZEgrktw6ZxuEXcx3v16cXd6k5JVO3kOXMg/HFnH"
  }
]

特定のサイトからファイルをダウンロードするには、リモートファイルの完全なアドレスを指定する必要があります。

例 - 添付ファイルを移動する

この例では、添付ファイルをある場所から別の場所に移動します。

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

   {
   "SourceFileURL": "/Shared Documents/test.txt",
   "DestinationFolderURL": "/Shared Documents/TestFolder"
   }

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

[{
"Result": "Success"
}]

例 - フォルダを作成する

この例では、指定された場所にフォルダを作成します。

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

   {
   "RelativeURL": "/Shared Documents/TestFolder",
   "FolderName": "TestFolder123"
   }

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

[{
"Id": "110842b7-2393-4f11-9391-3d75214e9fb8",
"Status": "Success"
}]

例 - 添付ファイルを追加する

この例では、指定したリストに添付ファイルを追加します。

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

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment2",
   "Content": "abcd text",
   "ItemId": "1"
   }

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

[{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment2",
"Status": "Success"
}]

例 - バイナリの添付ファイルを追加する

この例では、指定したリストにバイナリの添付ファイルを追加します。

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

   {
   "ListTitle": "My Lists",
   "FileName": "TestAttachment3",
   "ContentBytes": "VGVzdCBGaWxl",
   "HasBytes": "true",  
   "ItemId": "1"
   }

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

[{
"RelativeUrl": "/Lists/My lists/Attachments/1/TestAttachment3",
"Status": "Success"
}]

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

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

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

   {
   "RemoteFile": "/Shared Documents/Document.txt"
   }

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

[{
"Success": "True",
"Content": "Test File",
}]

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

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

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

   {
   "RemoteFile": "/Shared Documents/Document.docx",
   "HasBytes": "true"
   }

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

[{
"Success": "True",
"ContentBytes": "VGVzdCBGaWxl",
}]

エンティティ オペレーションの例

このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。

例 - すべてのファイルを一覧表示する

この例では、Files エンティティ内のすべてのファイルを一覧表示します。

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から Files を選択します。
3. [List] オペレーションを選択してから、[完了] をクリックします。
4. 必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。 論理演算子を使用して複数のフィルタ条件を指定することもできます。

例 - リストを取得する

この例では、My Lists エンティティから、指定した ID のリストを取得します。

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から My Lists を選択します。
3. [Get] オペレーションを選択してから、[完了] をクリックします。
4. [コネクタタスクの [タスク入力 セクションで [entityId] をクリックし、[デフォルト値] フィールドに 3 を入力します。

   ここで、3 は My Lists エンティティの主キー値です。

例 - レコードを作成する

この例では、My Lists エンティティに レコードを作成します。

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

   {
   "AuthorId": 11.0, 
   "BaseName": "3_",
   "Attachments": false,
   "Title": "Created List New"
   }

   統合に成功すると、コネクタタスクの connectorOutputPayload フィールドの値は次のようになります。

   [{
   "ID": 3.0
   }]

例 - レコードを削除する

この例では、My Lists エンティティ内の指定された ID のレコードを削除します。

1. [Configure connector task] ダイアログで、[Entities] をクリックします。
2. Entity から My Lists を選択します。
3. [Delete] オペレーションを選択してから、[完了] をクリックします。
4. [コネクタタスクの [タスク入力 セクションで [entityId] をクリックし、[デフォルト値] フィールドに 2 を入力します。