CSV Microsoft Graph 連接器

CSV Microsoft Graph 連接器可讓您的組織從 SharePoint 文檔庫中儲存的 CSV 檔案擷取內容，並 Azure Data Lake Storage (ADLS) 。 設定連接器並從這些來源編製內容索引之後，終端使用者就可以在搜尋和 Microsoft 365 Copilot Microsoft中找到 CSV 檔案。

本文適用於設定、執行及監視 CSV Microsoft Graph 連接器的任何人。 它會補充一般設定程式，並顯示僅適用於此連接器的指示。

功能

• 保留您組織定義的 ACL
• 自訂您的編目頻率
• 使用此連線和來自 Microsoft Copilot Studio 的外掛程式來建立代理程式和工作流程

限制

• 目前不支援配置檔擴充案例
• 不支援 CSV 資料行標頭中的空格

必要條件

• 確定 CSV 標頭中沒有空格符

• 您可以從下列兩個數據源選項之一為 CSV 檔案編製索引： SharePoint 或 ADLS

  • 針對 SharePoint 數據源，您可以使用兩個 OAuth 提供者之一進行驗證：Microsoft Entra ID 或 SharePoint 提供者 (即將淘汰) 。

    • 若要使用 Microsoft Entra ID 進行驗證，您必須在 Microsoft Entra ID 上建立並註冊應用程式。
    • 若要使用 SharePoint 提供者進行驗證，您必須 使用 OAuth 組態建立 SharePoint 應用程式。

    提示

    一旦可用，您將能夠將已發佈連線的 OAuth 提供者從 SharePoint 切換至 Microsoft Entra ID

  • 針對 ADLS 數據源，您必須 建立 ADLS 儲存器帳戶。

SharePoint 資料來源

上傳 CSV 檔案

確認您想要編製索引的 .csv 檔案已上傳至 SharePoint 文檔庫。 您可以使用現有的 SharePoint 網站或建立新的網站。

在 Microsoft Entra ID 上建立應用程式

1. 移至 Azure 入口網站，並使用租用戶的系統管理員認證登入。

2. 從瀏覽窗格流覽至 [Microsoft Entra ID ->Manage ->應用程式註冊]，然後選取 [新增註冊]。

3. 提供應用程式的名稱，然後選取 [ 註冊]。

4. 記下應用程式 (用戶端) 識別碼。

5. 從瀏覽窗格開啟 API 許可權，然後選取 [ 新增許可權]。

6. 選取 [SharePoint ]，然後選 取 [委派的許可權]。

7. 搜尋下列許可權，然後選取 [新增許可權]。
   a. AllSites.Read
   b. User.Read.All

8. 選 取 [TenantName] 的 [授與系統管理員同意] ，然後選取 [ 是] 來確認。

9. 檢查許可權是否處於「已授與」狀態。

10. 從瀏覽窗格開啟 [驗證 ]，然後選 取 [新增平臺]。 在 [Web 應用程式] 底下選取 [Web]，然後在 [授權回呼 URI] ([重新導向 URI] 下方新增下列) ：

    • 針對 M365 企業版： https://gcs.office.com/v1.0/admin/oauth/callback
    • 針對 M365 Government： https://gcsgcc.office.com/v1.0/admin/oauth/callback

設定客戶端密碼以進行驗證

1. 移至 Azure 入口網站，並使用租用戶的系統管理員認證登入。

2. 從瀏覽窗格開啟 [應用程式註冊 ]，然後移至適當的應用程式。 在 [ 管理] 底下，選 取 [憑證和秘密]。

3. 選 取 [新增客戶端密碼 ]，然後選取秘密的到期期間。 複製產生的秘密並儲存它，因為它不會再次顯示。

4. 使用此客戶端密碼和應用程式識別碼來設定連接器。

使用 OAuth 設定建立 SharePoint 應用程式 (即將淘汰)

1. 移至https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx。
2. 在 [用戶端識別符] 和 [客戶端密碼] 字段上，選取 [ 產生]。
3. 針對 [標題]，輸入應用程式名稱。
4. 在[應用程式域] 欄位中，輸入 www.gcs.com。
5. 在 [重新導向 URL] 欄位中， 輸入 https://www.gcs.com。
6. 選取 [建立]。
7. 複製應用程式設定資訊，包括用戶端識別碼和客戶端密碼。 當您設定 CSV 連接器時，將會需要它。

啟用應用程式許可權以允許 customAppAuthentication

在 PowerShell (SharePoint Online 管理命令介面) 中，以系統管理模式執行這些命令。 使用設定連接器之系統管理員的電子郵件位址和您的組織名稱。 當密碼彈出窗口出現時，系統管理員應該輸入其密碼。

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

注意事項

如果您使用PowerShell 7，請先使用此命令 Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

注意事項

如果您使用多重要素驗證，請使用 Connect-SPOService -Url https://$orgName-admin.sharepoint.com。

完成應用程式設定

1. 移至https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx。

2. 在 [應用程式標識符] 字段中，貼上 SharePoint 應用程式的用戶端識別碼，然後選取 [查閱]。

3. 在 [要求 XML 許可權] 字段中，貼上此程式代碼，然後選取 [ 建立]。

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

4. 選取 [信任]。

ADLS 數據源

建立 ADLS 記憶體帳戶

如需逐步指引，請參閱 建立記憶體帳戶。 若要允許檔案儲存功能，請在 [進階] 索引標籤上，選取 [ 啟用階層命名空間 ] 和 [建立此網站的容器]。

當您設定 CSV Microsoft Graph 連接器時，您必須提供主要記憶體 連接字串。 若要尋找它，請開啟您建立的記憶體帳戶，然後選 取 [存取密鑰]。 選取 [顯示金鑰]，然後複製 Key1 的 連接字串。

開始使用

步驟 1：在 Microsoft 365 系統管理中心 中新增 Microsoft Graph 連接器

新增 CSV Microsoft Graph 連接器

請遵循一般 設定指示。

步驟 2：命名連線

請遵循一般 設定指示。

步驟 3：設定連線設定

SharePoint 和 ADLS 的數據源設定不同。

注意事項

請確定您的 csv 檔案沒有任何格式或空格 (『) 出現在標頭數據列中。

針對 SharePoint 來源

1. 在 [數據源設定] 中，選取 [SharePoint ] 作為您的數據源。

2. 例如，在 SharePoint 網站中，輸入網站 URL https://Org-Name.sharepoint.com/Site-Name。

3. 在 文檔庫中，輸入儲存 .csv 檔案的文件庫名稱。

4. 在 OAuth 提供者中，您可以選取 [SharePoint 提供者 (即將淘汰) 或 Microsoft Entra ID
   

   a. 針對 Microsoft Entra ID：
   1. 驗證類型，選 取 [Oauth2.0] (授權碼) 。
   2.輸入您在建立 Microsoft Entra ID 應用程式時複製的用戶端識別碼和客戶端密碼。
   3.選取 [登入]。 您應該會收到 連線成功 訊息。
   

   b. 針對 SharePoint 提供者， (即將淘汰) ：
   1.在 [驗證類型] 中，選 取 [Oauth2.0] (客戶端認證) 。
   2.輸入您在建立 SharePoint 應用程式時複製的用戶端識別碼和客戶端密碼。
   3.選取 [測試連線]。 您應該會收到 連線成功 訊息。

若要控制檔案層級的存取權，請輸入 Microsoft Entra 使用者或群組。

針對 ADLS 來源

1. 在 [數據源] 設定中，選取 Azure Data Lake Storage (ADLS) 作為您的數據源。

2. 在 [主要記憶體 連接字串 中，輸入您複製的 連接字串。

3. 輸入 [容器名稱 ] 和 [檔案名]。

4. 選 取 [測試連線]。 您應該會收到 連線成功 訊息。

   

注意事項

如果您的數據源包含多個具有相同標頭的 .csv 檔案，請選取 [ 在位置包含所有 CSV 檔案]。

若要控制檔案層級的存取權，請輸入 Microsoft Entra 使用者或群組。

步驟 4：多專案分隔符 (選擇性)

如果您的源數據行可以接受多個值，請輸入多專案分隔符、分號 (;例如 ) 。

步驟 5：剖析的屬性設定

此頁面會將您 .csv 檔案中的第一個數據列傳回為來源屬性。 若要修改資料類型，請在 [ 唯一標識符 ] 列表中選取至少一個選項。

若要控制專案層級的存取權，請選取對應至允許使用者和允許群組的數據行。 您應該在 .csv 檔案中包含兩個數據行 AllowedUsers 和 AllowedGroups。 每個數據列都應該包含 Microsoft Entra 識別碼。

注意事項

CSV Microsoft Graph 連接器支援檔案或專案層級訪問控制。 如果兩者都已啟用，則只會套用檔案層級訪問控制。

步驟 6：指派屬性標籤

請遵循一般 設定指示。

注意事項

IconURL 標籤預設會填入，且無法變更對應。

步驟 7：管理架構

請遵循一般 設定指示。

步驟 8：管理搜尋許可權

• 針對檔案或專案層級訪問控制，選取 [僅限具有此數據源存取權的人員]。
• 選取 [所有人 ] 可讓組織中的每個人查看此數據源的搜尋結果。

步驟 9：選擇重新整理設定

請遵循一般 設定指示。

步驟 10：檢閱連線

請遵循一般 設定指示。

疑難排解

發佈連線之後，您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除，請參閱 管理您的連接器。

您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應，請 連絡 Microsoft Graph |支援。