Sharepoint Online

指定したSharePointライブラリーからファイルをインポートするために、SharePoint Onlineに接続します。

対応する機能

データモデル

コネクタは、任意のタイプのファイルをFoundryデータセットに転送できます。ファイル形式は保持され、転送中または転送後にスキーマは適用されません。出力データセットに必要なスキーマを適用するか、データにアクセスするために下流トランスフォームを書く。

パフォーマンスと制限

転送可能なファイルのサイズには制限はありません。しかし、ネットワークの問題により、大規模な転送が失敗することがあります。特に、2日以上かかる直接クラウド同期は中断されます。ネットワークの問題を避けるために、ファイルサイズを小さくし、同期の各実行で取り込むファイル数を制限することを推奨します。同期は頻繁に実行するようにスケジュール設定できます。

セットアップ

1. Data Connectionアプリケーションを開き、画面の右上にある**+ New Source**を選択します。
2. 利用可能なコネクタタイプからSharePoint Onlineを選択します。
3. インターネット上の直接接続を使用するか、または中間エージェント経由で接続するかを選択します。
4. 以下の情報を使用してコネクタのセットアップを続ける追加の設定プロンプトに従います。

Foundryでコネクタのセットアップについて詳しく学びましょう。

認証

Azureアプリケーション資格情報へのアクセスを開始するには、以下の手順に従います：

1. Microsoftのドキュメント↗の指示に従って、Azureでアプリケーション登録を作成します。
   • ステップ5では、この組織のディレクトリ内のアカウントのみを選択し、**リダイレクトURL（オプション）**をスキップします。
2. 登録が完了したら、クライアントIDとテナントIDを記録します。

次に、利用可能な2つの認証方法のいずれかを選択します：

• クライアント資格情報： すべてのSharePointサイトに対して広範なアクセスが必要な場合に推奨します。
• ユーザー名/パスワード： 一つまたは数個のSharePointサイトへのアクセスを制限する場合に推奨します。

クライアント資格情報

Microsoft Entraの管理センターで以下の手順を完了します：

1. 左側のサイドバーでAPI Permissionsに移動します。

2. Add a Permissionを選択します。

3. Microsoft Graphを選択します。

4. Application Permissionsを選択します。

   • アプリケーションがすべてのSharePointサイトを読み取るようにしたい場合は、Sites.Read.Allを追加します。
     • エクスポートタスクを設定する予定の場合は、代わりにSites.ReadWrite.Allを使用します。
   • アプリケーションが選択したSharePointサイトを読み取るようにしたい場合は、Sites.Selectedを追加します。

5. Entraの管理者である場合は、**Grant admin consent for [tenant]**を選択します。

6. 上記でSites.Selectedを追加した場合、特定のサイトにアプリケーションを追加します↗。

   • "roles"配列パラメーターの利用可能なオプションは"write"および/または"read"です。"read"オプションは、SharePointサイトからファイルを取り込むのに十分です。
   • 適切な認証でPOSTを簡単に送信するには、Graph Explorer↗を使用します。
   • https://graph.microsoft.com/v1.0/sites/[tenantName]:/sites/[siteName]へのGETを送信することでサイトに関するメタデータを受け取ることができます（例：https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/mySite）。このリクエストは、Site collection hostname、Site collection unique ID、Site unique IDのいくつかの値から成るIDを返します。中央の値は、権限POSTを実行するために必要なsiteIdです。

7. クライアントシークレットを生成します。↗。

Data Connectionで以下のソース設定を設定します：

ユーザー名/パスワード

ユーザー名/パスワードのフローは、Microsoft 365にサインインできるユーザーアカウントを作成することを含みます。Graph APIは、ユーザー名/パスワード認証方法で二要素認証をサポートしていません。そのため、32文字以上のランダムに生成されたパスワードを作成することを強く推奨します。

Entraの管理センターで以下の手順を完了します：

1. 左側のサイドバーでAPI Permissionsに移動します。
2. Add a Permissionを選択します。
3. Microsoft Graphを選択します。
4. Delegated Permissionsを選択します。
5. Sites.Read.All権限を追加します。
   • エクスポートタスクを設定する予定の場合は、代わりにSites.ReadWrite.Allを使用します。
6. Azureの管理者である場合は、**Grant admin consent for [tenant]**を選択します。
7. 左側のサイドバーでAuthenticationに移動します。
8. Allow public client flowsをYesに変更します。
9. 最低32文字のランダムに生成されたパスワードで Microsoft Entra IDにユーザーを作成します。
10. そのユーザーを読み書きしたいSharePointサイトに追加します。

Data Connectionで以下のソース設定を設定します：

SharePoint Add-insに対するXMLベースの権限付与

SharePoint Add-insの認証と認可↗を使用しており、SharePoint Add-inが権限管理のためにXMLを使用している場合は、スコープURIに正しいスコープが設定されていることを確認する必要があります。これにより、SharePointへの接続時にアクセス問題が発生するのを避けることができます。

正しいスコープを確認し設定するには、以下の手順に従います：

1. SharePoint Add-inの権限設定が含まれるAppManifest.xmlファイルを探します。
2. AppManifest.xmlファイル内で、XMLファイル内のスコープURIを特定します。これは次のようになるはずです：

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

3. スコープの値（この例では、http://sharepoint/content/sitecollection/web）が接続しているSharePointサイトと一致していることを確認します。スコープの値が一致しない場合は、スコープの値を適切に調整します。

ネットワーキング

SharePoint Onlineコネクタは、443ポートの以下のドメインへのネットワークアクセスが必要です：

• login.microsoftonline.com
• graph.microsoft.com
• SharePointのURL。例：contoso.sharepoint.com

GovCloud Sharepointインスタンスを使用している場合は、代わりに443ポートの以下のドメインを使用します：

• login.microsoftonline.us
• graph.microsoft.us
• SharePointのURL。例：contoso.sharepoint.us

設定オプション

SharePoint Onlineコネクタには、以下の設定オプションが利用可能です：

Sharepoint Onlineからデータを同期

SharePoint Onlineコネクタは、ファイルベースの同期インターフェースを使用します。

SharePoint Onlineへのデータのエクスポート

SharePointサイトへエクスポートするには、まずSharePoint Onlineコネクタのエクスポートを有効にします。次に、新しいエクスポートを作成します。

エクスポート設定オプション