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 帐户
SharePoint 文件
选择文件
同时,如果您可以访问多个地理位置租户,请选择要访问的租户。
选择 站点 。
选择 文档库 。
在树视图中选择 文件 或输入 文件路径 。
关于如何处理文件,您有这些选项:
从文件读取数据 :读取数据并通过输出锚点将其传递给其他工具。
将文件下载到本地以备稍后处理 :处理 SharePoint 输入不支持的文件类型的文件,或下载文件的离线副本。选择要保存文件的位置。默认位置为 %TEMP%。
只读完整路径列表 :只读路径列表,并通过输出锚点将其传递给其他工具。
注意
您也可以通过 SharePoint 站点上的 复制链接 按钮将文件的路径插入(按 Ctrl+V 和 Enter )到 文件路径 。
配置工具
在您选择文件时,系统会自动检测文件格式。
数据范围 选项将指定包含数据的工作表。选项包括 所有工作表 、 工作表名称 、 工作表编号 、 指定范围 或 仅导入工作表名称列表 。
选中 第一个包含字段名称的行 复选框,将第一行数据设置为列标题。
使用 从以下行开始导入数据 以选择要开始导入的行。
选择 代码页 来确定数据的编码方式。
选择 启用试运行 以将所有字段传播到连接的工具,而不需要运行工作流。
使用 附加元数据 来选择要附加到每个输入行的元数据。
使用 最大字段长度 设置每个字段的最大长度。这使您可以控制字符串的截断。
使用 字段分隔符 来选择要在字段之间使用的字段分隔符。选项包括 逗号 、 分号 、 制表符 、 竖线 、 空格 或 自定义分隔符 。
选中 第一个包含字段名称的行 复选框,将第一行数据设置为列标题。
使用 从以下行开始导入数据 以选择要开始导入的行。
使用 引号字符 来选择引号的格式。选项包括 无 、 单引号 、 双引号 或 自定义 。
选择 代码页 来确定数据的编码方式。
选择 启用试运行 以将所有字段传播到连接的工具,而不需要运行工作流。
使用 附加元数据 来选择要附加到每个输入行的元数据。
选择 启用试运行 以将所有字段传播到连接的工具,而不需要运行工作流。
使用 附加元数据 来选择要附加到每个输入行的元数据。
SharePoint 列表
选择数据
选择 列表 。
(可选)选择 视图 。
配置工具
提取链接项目的值 :选中此复选框可自动提取链接项目的值。
记录限制 :输入要读取的记录数。
立即将字段传播到下一个工具 :选中此复选框可将值传播到连接的工具,而不需要运行工作流。