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 应用程序设置。设置 Microsoft Azure API 应用程序
您可以使用默认的 Alteryx 应用程序(通过 Internet 浏览器登录)来计划最长 6 个月的工作流。但是,如果您在选择使用客户端 ID 和密码、租户 ID 连接到 URL 后选择用作服务主体(仅限应用程序的身份验证),则可以根据公司策略设置令牌的过期,并且计划的工作流不会与单个用户关联。例如,如果用户离开公司且其帐户被禁用,这种设置将很方便,可导致工作流无法运行。
文件和列表可用的身份验证方法相同,但 SharePoint 版本的身份验证方法有所不同。此外,您需要输入站点级别的 SharePoint URL 才能写入列表:
SharePoint 365 (Cloud)
以用户身份通过浏览器登录 (OAuth)
应用程序登录(使用服务主体)
SharePoint 2013,2016(本地部署)
Windows 帐户
如果您要使用 GCC 高租户或自定义租户进行身份验证,请使用 DCM 并选择相应的技术。若要查找正确的 URL,请前往登录美国政府的 Power BI。
SharePoint 文件
选择文件
同时,如果您可以访问多个地理位置租户,请选择要访问的租户。
选择站点和文档库。
在文件树中选择文件,或按名称进行搜索。您可以在文件路径字段中输入文件路径。
使用选项选项卡中的现有文件操作,选择现有文件的处理方式。
重命名:“重命名”选项将重命名文件(在文件名末尾附加一个唯一数字)。
覆盖文件:“覆盖”选项将删除现有文件并写入新文件内容。
覆盖工作表:“覆盖工作表”选项可重写选定工作表,且不更改其他工作表。
附加:“附加”选项会将新数据添加到现有文件中。
中止:选择“中止”后,如果有另一个同名文件,则不会上传该文件。
重要
如果在“现有文件操作”中选择覆盖文件、覆盖工作表或附加选项,则更新后的工作表将成为文件中的第一个工作表。这可能会影响使用工作表序号的工具。
添加文件夹
选择要在其中添加文件夹的站点和文档库。
选择添加文件夹。
选择按名称并输入新文件夹的名称。Designer 将添加该文件夹,而无需运行工作流。
选择按字段以根据数据中的指定字段添加多个文件夹。
在文件名字段中输入新文件的名称。
文件名字段要求输入文件名(包括文件类型扩展名)。
运行工作流以添加文件夹。
添加文件
选择要添加文件的站点和文档库。
选择添加文件。
选择按名称并输入新文件的名称。
文件名字段要求输入文件名(包括文件类型扩展名)。
选择按字段以根据数据中的指定字段添加多个文件。
SharePoint 输出将字段从写入的数据中排除。您可以通过选择将字段保留在输出中来保留它。
运行工作流以添加文件。
选择文件格式
数据范围选项指定要创建的工作表的名称。选项包括按工作表名称和按字段。
SharePoint 输出将字段从写入的数据中排除。您可以通过选择将字段保留在输出中来保留它。
警告
如果选择按字段选项,将根据在选择字段中选择的值来创建和命名多个工作表。
在起始单元格中输入单元格,以指定数据输出的起点。
选择写入标题以在输出数据中包括标题。
选择代码页来确定数据的编码方式。
使用最大字段长度设置每个字段的最大长度,从而控制字符串的剪切。
使用字段分隔符来选择要在字段之间使用的字段分隔符。选项包括逗号、分号、制表符、竖线、空格或自定义分隔符。
选择写入标题以在输出数据中包括标题。
使用引号字符来选择引号的格式。选项包括无、单引号、双引号或自定义。
选择代码页来确定数据的编码方式。
无选项。
SharePoint 列表
警告
SharePoint 输出无法写入名称以特殊字符开头的列。这适用于列的实际名称,而非显示名称。建议不要在列名称的开头使用特殊字符。
如果您输入的列名称以小写或大写字母 c 或 r 开头,且包含一个数字或不含其他字符,则列表的创建或修改将失败。
配置工具
选择列表。内容特定于您指定的 URL。如果您的 URL 包含一个目录,则只会显示该目录的列表。
在输出选项中,选择用于写入列表的选项:
追加到现有:将所有数据追加到现有表中。
Append: Appends all the data to an existing list.
Overwrite (Update Fields): Removes the existing rows and fields and creates new fields and data based on the incoming data.
Overwrite (Keep Existing Columns): Removes the existing rows and adds new rows based on the incoming fields. The fields have to match.
Update: Updates data based on the Primary Key.
Upsert: Updates existing data and inserts new data based on the Primary Key.