在复制活动中配置 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标识平台。 若要了解如何作,请转到 快速入门:将应用程序注册到Microsoft标识平台

    记下这些值 - 你将使用这些值来定义连接:

    • 应用程序 ID
    • 应用程序密钥
    • 租户 ID
  3. 向已注册的应用程序授予 SharePoint Online 网站权限。 此步骤需要站点管理员角色。

    1. 打开 SharePoint Online 网站链接,例如 https://[your_site_url]/_layouts/15/appinv.aspx (替换网站 URL)。

    2. 搜索已注册的应用程序 ID,填写空字段,然后选择“ 创建”。

      使用以下值:

      • 应用域contoso.com

      • 重定向 URLhttps://www.contoso.com

      • 权限请求 XML

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

      显示请求 XML 的屏幕截图。

      注释

      配置 SharePoint 连接器时, 应用域重定向 URL 是指在 Microsoft Entra ID 中注册的 SharePoint 应用,以允许访问 SharePoint 数据。

      应用程序域是托管 SharePoint 网站的域。 例如,如果 SharePoint 网站位于 https://contoso.sharepoint.com,则 应用域 将是 contoso.sharepoint.com

      重定向 URL 是 SharePoint 应用在用户进行身份验证并向应用授予权限后重定向到的 URL。 此 URL 应是应用程序有权访问的 SharePoint 网站上的页面。 例如,可以使用显示库中文件列表的页面的 URL,也可以使用显示文档内容的页。

    3. 为此应用选择 “信任它 ”。

配置选项

可以在复制活动下配置每个选项卡。 有关每个选项卡的详细信息,请转到以下部分:

概况

有关 “常规 ”选项卡配置,请参阅我们的 “常规设置”概述

来源

SharePoint Online 列表源支持复制活动的 “源 ”选项卡下的以下属性。

必需属性:

  • 连接:从连接列表中选择 SharePoint Online 列表连接。 如果不存在连接,请选择“ 全部浏览,然后按照连接指南创建一个新的 HTTP 连接,然后按照 连接指南 填写详细信息。

  • 使用查询:选择 “列表名称 ”或 “查询” 作为使用查询。 下面介绍如何配置每个设置:

    • 列表名称:SharePoint Online 列表的名称。

      显示列表名称的屏幕截图。

    • 查询:用于筛选 SharePoint Online 列表中的数据的 OData 查询。 例如,"$top=1"

      显示查询的屏幕截图。

高级选项:

在“高级”下,可以指定以下字段:

  • 请求超时:从 SharePoint Online 获取响应的等待时间。 默认值为 5 分钟(00:05:00)。

  • 其他列:添加其他数据列以存储源文件的相对路径或静态值。 后者支持表达式。

    显示其他列的屏幕截图。

映射

对于“映射”选项卡配置,请转到“映射”选项卡下的“配置映射”。

设置

对于“设置”选项卡配置,请转到“设置”选项卡下的“配置其他设置”。

属性参考

下表包含有关 SharePoint Online 列表中的复制活动的详细信息。

Name Description 价值 必选 JSON 脚本属性
连接 与源数据存储的连接。 <连接> 是的 连接
使用查询 可以选择 “列表名称 ”或 “查询” 作为使用查询。 - 列表名称
- 查询
类型
列表名称 SharePoint Online 列表的名称。 <连接> 是的 listName
请求超时 从 SharePoint Online 获取响应的等待时间。 默认值为 5 分钟(00:05:00)。 timespan requestTimeout
其他列 添加其他数据列以存储源文件的相对路径或静态值。 后者支持表达式。 • 姓名
•价值
附加列:
•名字
•价值