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.1.0 版还包含列表写入功能,这是一个 独立的数据连接器 。请参阅 Designer 与数据连接器的兼容性 ,以保持 SharePoint 连接器的全部功能。
登录到 SharePoint
所用身份验证方法是 OAuth 方法,因此您可以选择 通过 Internet 浏览器登录 来使用默认的 Alteryx 应用程序,也可以通过 使用客户端 ID 和密码、租户 ID 连接到 URL 来提供自己的 API 应用程序。如需了解如何创建您自己的 API 应用程序,请参阅 自定义 API 应用程序设置 。
您可以使用默认的 Alteryx 应用程序( 通过 Internet 浏览器登录 )来计划最长 6 个月的工作流。但是,如果您在选择 使用客户端 ID 和密码、租户 ID 连接到 URL 后选择 用作服务主体(仅限应用程序的身份验证) ,则可以根据公司策略设置令牌的过期,并且计划的工作流不会与单个用户关联。例如,如果用户离开公司且其帐户被禁用,这种设置将很方便,可导致工作流无法运行。
文件和列表可用的身份验证方法相同,但 SharePoint 版本的身份验证方法有所不同。此外,您需要输入 站点级别的 SharePoint URL 才能写入列表:
SharePoint 365 (Cloud)
以用户身份通过浏览器登录 (OAuth)
应用程序登录(使用服务主体)
SharePoint 2013,2016(本地部署)
Windows 帐户
SharePoint 文件
选择文件
同时,如果您可以访问多个地理位置租户,请选择要访问的租户。
选择 站点 和 文档库 。
在文件树中选择文件,或按名称进行搜索。您可以在 文件路径 字段中输入文件路径。
使用 选项 选项卡中的 现有文件操作 ,选择现有文件的处理方式。
重命名 :“重命名”选项将重命名文件(在文件名末尾附加一个唯一数字)。
覆盖文件 :“覆盖”选项将删除现有文件并写入新文件内容。
覆盖工作表 :“覆盖工作表”选项可重写选定工作表,且不更改其他工作表。
附加 :“附加”选项会将新数据添加到现有文件中。
中止 :选择“中止”后,如果有另一个同名文件,则不会上传该文件。
重要
如果在“现有文件操作”中选择 覆盖文件 、 覆盖工作表 或 附加 选项,则更新后的工作表将成为文件中的第一个工作表。这可能会影响使用工作表序号的工具。
添加文件夹
选择要在其中添加文件夹的 站点 和 文档库 。
选择 添加文件夹 。
选择 按名称 并输入新文件夹的名称。Designer 将添加该文件夹,而无需运行工作流。
选择 按字段 以根据数据中的指定字段添加多个文件夹。
在 文件名 字段中输入新文件的名称。
文件名 字段要求输入文件名(包括文件类型扩展名)。
运行工作流以添加文件夹。
添加文件
选择要添加文件的 站点 和 文档库 。
选择 添加文件 。
选择 按名称 并输入新文件的名称。
文件名 字段要求输入文件名(包括文件类型扩展名)。
选择 按字段 以根据数据中的指定字段添加多个文件。
SharePoint 输出将字段从写入的数据中排除。您可以通过选择 将字段保留在输出中 来保留它。
运行工作流以添加文件。
选择文件格式
数据范围 选项指定要创建的工作表的名称。选项包括 按工作表名称 和 按字段 。
SharePoint 输出将字段从写入的数据中排除。您可以通过选择 将字段保留在输出中 来保留它。
警告
如果选择 按字段 选项,将根据在 选择字段 中选择的值来创建和命名多个工作表。
在 起始单元格 中输入单元格,以指定数据输出的起点。
选择 写入标题 以在输出数据中包括标题。
选择 代码页 来确定数据的编码方式。
使用 最大字段长度 设置每个字段的最大长度,从而控制字符串的剪切。
使用 字段分隔符 来选择要在字段之间使用的字段分隔符。选项包括 逗号 、 分号 、 制表符 、 竖线 、 空格 或 自定义分隔符 。
选择 写入标题 以在输出数据中包括标题。
使用 引号字符 来选择引号的格式。选项包括 无 、 单引号 、 双引号 或 自定义 。
选择 代码页 来确定数据的编码方式。
无选项。
SharePoint 列表
警告
SharePoint 输出无法写入名称以特殊字符开头的列。这适用于列的实际名称,而非显示名称。建议不要在列名称的开头使用特殊字符。
如果您输入的列名称以小写或大写字母 c 或 r 开头,且包含一个数字或不含其他字符,则列表的创建或修改将失败。
配置工具
选择 列表 。内容特定于您指定的 URL。如果您的 URL 包含一个目录,则只会显示该目录的列表。
在 输出选项 中,选择用于写入列表的选项:
追加到现有 :将所有数据追加到现有表中。
删除列表再追加 :删除表中的所有原始记录,然后将数据追加到现有表中。
更新;更新失败时发出警告 :仅更新您所指定 ID 的现有记录。如果记录无法更新,则会发出警告。
更新;更新失败时报告错误 仅更新您所指定 ID 的现有记录。如果记录无法更新,则会报告错误,并且停止处理。