Skip to main content

SharepointFiles SharePoint 输入工具

使用 SharePoint 输入工具从 CSV、XLSX、YXDB 文件以及 SharePoint 站点中的列表中读取数据。

重要

此工具不会随 Designer 自动安装。要使用此工具,请从 Alteryx Marketplace 下载。

在 SharePoint 工具 2.2.0 版中,我们将 SharePoint 文件输入重命名为 SharePoint 输入

在 SharePoint 工具 2.2.0 版中,我们还暂时移除了对 SharePoint 本地部署(2013 版和 2016 版)的支持。在 SharePoint 2.3.0 版中,我们重新启用了对 SharePoint 本地部署的支持。

SharePoint 文件输入 2.0.1 版还包含列表读取功能,这是一个独立的数据连接器。请参阅 Designer 与数据连接器的兼容性,以保持 SharePoint 连接器的全部功能。

登录到 SharePoint

所用身份验证方法是 OAuth 方法,因此您可以选择通过 Internet 浏览器登录来使用默认的 Alteryx 应用程序,也可以通过使用客户端 ID 和密码、租户 ID 连接到 URL 来提供自己的 API 应用程序。如需了解如何创建您自己的 API 应用程序,请参阅自定义 API 应用程序设置

您可以使用默认的 Alteryx 应用程序(通过 Internet 浏览器登录)来计划最长 6 个月的工作流。但是,如果您在选择使用客户端 ID 和密码、租户 ID 连接到 URL 后选择用作服务主体(仅限应用程序的身份验证),则可以根据公司策略设置令牌的过期,并且计划的工作流不会与单个用户关联。例如,如果用户离开公司且其帐户被禁用,这种设置将很方便,可导致工作流无法运行。

警告

SharePoint 文件输入 2.0.1 版需要客户端密码,即使是使用客户端 ID 和密码、租户 ID 进行连接(未用作服务主体)时,也是如此。请与管理员联系以请求密码,这是一个密码值,而不是“密码 ID”。

文件和列表可用的身份验证方法相同,但 SharePoint 版本的身份验证方法有所不同。此外,您需要输入站点级别的 SharePoint URL 才能读取列表:

  • SharePoint 365 (Cloud)

    • 以用户身份通过浏览器登录 (OAuth)

    • 应用程序登录(使用服务主体)

  • SharePoint 2013,2016(本地部署)

    • Windows 帐户

如果您要使用 GCC 高租户或自定义租户进行身份验证,请使用 DCM 并选择相应的技术。若要查找正确的 URL,请前往登录美国政府的 Power BIDCM - Designer

SharePoint 文件

选择文件

  1. 同时,如果您可以访问多个地理位置租户,请选择要访问的租户。

  2. 选择站点

  3. 选择文档库

  4. 在树视图中选择文件或输入文件路径

  5. 关于如何处理文件,您有这些选项:

    • 从文件读取数据:读取数据并通过输出锚点将其传递给其他工具。

    • 将文件下载到本地以备稍后处理:处理 SharePoint 输入不支持的文件类型的文件,或下载文件的离线副本。选择要保存文件的位置。默认位置为 %TEMP%。

    • 只读完整路径列表:只读路径列表,并通过输出锚点将其传递给其他工具。

注意

您也可以通过 SharePoint 站点上的复制链接按钮将文件的路径插入(按 Ctrl+VEnter)到文件路径

配置工具

在您选择文件时,系统会自动检测文件格式。

  • 数据范围选项将指定包含数据的工作表。选项包括所有工作表工作表名称工作表编号指定范围仅导入工作表名称列表

  • 选中第一个包含字段名称的行复选框,将第一行数据设置为列标题。

  • 使用从以下行开始导入数据以选择要开始导入的行。

  • 选择代码页来确定数据的编码方式。

  • 选择启用试运行以将所有字段传播到连接的工具,而不需要运行工作流。

  • 使用附加元数据来选择要附加到每个输入行的元数据。

  • 使用最大字段长度设置每个字段的最大长度。这使您可以控制字符串的截断。

  • 使用字段分隔符来选择要在字段之间使用的字段分隔符。选项包括逗号分号制表符竖线空格自定义分隔符

  • 选中第一个包含字段名称的行复选框,将第一行数据设置为列标题。

  • 使用从以下行开始导入数据以选择要开始导入的行。

  • 使用引号字符来选择引号的格式。选项包括单引号双引号自定义

  • 选择代码页来确定数据的编码方式。

  • 选择启用试运行以将所有字段传播到连接的工具,而不需要运行工作流。

  • 使用附加元数据来选择要附加到每个输入行的元数据。

  • 选择启用试运行以将所有字段传播到连接的工具,而不需要运行工作流。

  • 使用附加元数据来选择要附加到每个输入行的元数据。

SharePoint 列表

选择数据

  1. 选择列表

  2. (可选)选择视图

配置工具

  • 提取链接项目的值:选中此复选框可自动提取链接项目的值。

  • 记录限制:输入要读取的记录数。

  • 立即将字段传播到下一个工具:选中此复选框可将值传播到连接的工具,而不需要运行工作流。