コピー アクティビティで SharePoint Online リストを構成する

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

[前提条件]

SharePoint に接続するには、サービス プリンシパル認証を設定する必要があります。 これを行う方法を次に示します。

1. 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
   

2. アプリケーションを Microsoft ID プラットフォームに登録します。 方法については、「 クイック スタート: アプリケーションを Microsoft ID プラットフォームに登録する」を参照してください。

   これらの値をメモしておきます。接続を定義するために使用します。

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

3. 登録済みアプリケーションに SharePoint Online サイトのアクセス許可を付与します。 この手順にはサイト管理者の役割が必要です。

   1. https://[your_site_url]/_layouts/15/appinv.aspxなど、SharePoint Online サイト リンクを開きます (サイトの URL を置き換えます)。

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

      次の値を使用します。

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

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

      • アクセス許可要求 XML:

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

      

      注

      SharePoint コネクタを構成すると、 アプリ ドメイン と リダイレクト URL は、SharePoint データへのアクセスを許可するために Microsoft Entra ID に登録した SharePoint アプリを参照します。

      アプリ ドメインは、SharePoint サイトがホストされているドメインです。 たとえば、SharePoint サイトが https://contoso.sharepoint.comにある場合、 アプリ ドメイン は contoso.sharepoint.comされます。

      リダイレクト URL は、ユーザーが認証し、アプリへのアクセス許可を付与した後に SharePoint アプリがリダイレクトする URL です。 この URL は、アプリがアクセス許可を持つ SharePoint サイト上のページである必要があります。 たとえば、ライブラリ内のファイルの一覧を表示するページの URL や、ドキュメントの内容を表示するページを使用できます。

   3. このアプリ に対して [信頼 する] を選択します。

構成オプション

コピー アクティビティの下の各タブを構成できます。 各タブの詳細については、次のセクションを参照してください。

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

全般

[ 全般 ] タブの構成については、 全般設定の概要を参照してください。

情報源

SharePoint Online リスト ソースは、コピー アクティビティの [ ソース ] タブにある次のプロパティをサポートしています。

必須プロパティ:

• 接続: 接続リストから SharePoint Online リスト接続を選択します。 接続がない場合は、[ すべて参照]、[ SharePoint Online リスト] の順に選択し、 接続ガイド に従って詳細を入力して、新しい HTTP 接続を作成します。

• クエリを使用する: 使用クエリとして リスト名 または クエリ を選択します。 各設定を構成する方法を次に示します。

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

    

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

    

詳細オプション:

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

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

• その他の列: ソース ファイルの相対パスまたは静的値を格納する他のデータ列を追加します。 エクスプレッションは後者に対応しています。

  

地図作成

[ マッピング ] タブの構成については、[ マッピング] タブの [マッピングの構成] に移動します。

設定

設定 タブの構成については、設定タブのの下で他の設定を構成するに移動します。

プロパティ リファレンス

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

関連コンテンツ

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