Copy アクティビティで SharePoint Online リストを構成する方法

この記事では、データ パイプラインの Copy アクティビティを使用して、SharePoint Online リストからデータをコピーする方法について説明します。

前提条件

1. SharePoint List Online コネクタでは、サービス プリンシパル認証を使用して SharePoint に接続されます。 設定するには、次の手順を実行します。

2. SharePoint テナントで、PowerShell を介して DisableCustomAppAuthentication を無効にします。

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell`  
   Connect-SPOService -Url https://<your-domain>-admin.sharepoint.com`  
   Set-SPOTenant -DisableCustomAppAuthentication $false`  
   Disconnect-SPOService
   

3. Microsoft ID プラットフォームにアプリケーションを登録する。 方法については、「クイック スタート: Microsoft ID プラットフォームにアプリケーションを登録する」を参照してください。 これらの値を記録しておきます。これらは接続を定義するときに使います。

   • アプリケーション ID
   • アプリケーション キー
   • テナント ID

4. 以下の手順を使用して、登録したアプリケーションに SharePoint Online サイトのアクセス許可を付与します。 アクセス許可を付与するには、サイト管理者の役割が必要になります。

   1. SharePoint Online サイト リンクを開きます。たとえば、https://[your_site_url]/_layouts/15/appinv.aspx (サイトの URL は置き換えてください)。

   2. 登録したアプリケーション ID を検索し、空欄に入力して [作成] を選択します。

      • アプリ ドメイン: contoso.com

      • リダイレクト URL: https://www.contoso.com

      • 権限の要求 XML:

        <AppPermissionRequests AllowAppOnlyPolicy="true">
            <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read"/>
        </AppPermissionRequests>
        

      

      Note

      SharePoint コネクタを構成するコンテキストでは、アプリ ドメインとリダイレクト URL は、SharePoint データへのアクセスを許可するために Microsoft Entra ID に登録した SharePoint アプリを指します。 アプリ ドメインは、SharePoint サイトがホストされているドメインです。 たとえば、SharePoint サイトが https://contoso.sharepoint.com にある場合、アプリ ドメインは contoso.sharepoint.com になります。 リダイレクト URL は、ユーザーが SharePoint アプリを認証し、そのアプリにアクセス許可を付与した後、そのアプリがリダイレクトされる先の URL です。 この URL は、アプリがアクセス許可を持つ SharePoint サイト上のページである必要があります。 たとえば、ライブラリ内のファイルの一覧を表示するページや、ドキュメントの内容を表示するページの URL を使用できます。

   3. このアプリに対して [Trust It] (信頼する) をクリックします。

サポートされている構成

コピー アクティビティの下の各タブの構成については、それぞれ次のセクションを参照してください。

• 全般
• ソース
• マッピング
• [設定]

全般

[全般] タブの構成で、[全般] に移動します。

ソース

Copy アクティビティの [ソース] タブの SharePoint Online リストでは、次のプロパティがサポートされています。

次のプロパティは必須です。

• [Data store type] (データ ストアの種類): [外部] を選択します。

• [接続]: 接続リストから SharePoint Online リスト接続を選択します。 接続が存在しない場合は、[新規] を選択して新しい HTTP 接続を作成します。

• [クエリの使用]: 使用するクエリとして [リスト名] または [クエリ] を選択します。 各設定の構成は次のとおりです。

  • [リスト名]: SharePoint Online リストの名前。

    

  • [クエリ]: SharePoint Online リストのデータをフィルター処理する OData クエリ。 たとえば、"$top=1" のようにします。

    

[詳細設定] では、次のフィールドを指定できます。

• [Request timeout] (要求のタイムアウト): SharePoint Online から応答を取得するための待機時間。 既定値は 5 分 (00:05:00) です。

• [追加の列]: ソース ファイルの相対パスまたは静的値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。

  

マッピング

[マッピング] タブの構成については、「[マッピング] タブでマッピングを構成する」を参照してください。

設定

[設定] タブの構成については、「[設定] タブで他の設定を構成する」を参照してください。

表の概要

次の表に、SharePoint Online リストの Copy アクティビティの詳細を示します。

ソース

名前	Description	Value	必須	JSON スクリプト プロパティ
データ ストアの種類	データ ストアの種類。	外部品目番号	はい	/
接続	ソース データ ストアへの実際の接続。	<接続>	はい	つながり
クエリの使用	使用するクエリとして [リスト名] または [クエリ] を選択できます。	-リスト名 -クエリ	いいえ	type
リスト名	SharePoint Online リストの名前。	<接続>	はい	listName
要求タイムアウト	SharePoint Online から応答を取得するための待機時間。 既定値は 5 分 (00:05:00) です。	TimeSpan	いいえ	requestTimeout
追加の列	ソース ファイルの相対パスまたは静的値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。	• 名前 • 値	いいえ	additionalColumns: •名前 • value

関連するコンテンツ

• SharePoint Online リスト接続を設定する