使用“检索文件夹”活动在 MS SharePoint 中查看现有文件夹的文件夹属性。
关于此任务
使用此任务从 MS SharePoint 实例访存文件夹属性。对此活动的调用是同步调用,其中会将输入数据发送到该活动以进行处理并将响应发送回到编排。
过程
- 右键单击“编排”部分,然后选择新编排。
- 将新创建的 MS SharePoint 端点拖至编排上,然后选择检索文件夹活动。 这会将检索文件夹活动添加到编排。
双击该活动。这样会显示“MS SharePoint 检索文件夹”核对表。
- 在“核对表”中,单击重试。复审缺省设置并进行所需的更改。
- 从核对表中选择映射输入。
从此操作生成的“XML 模式”显示为至活动面板中请求输入参数下的节点。
- 创建活动的编排变量与输入参数之间的映射。
必填字段:
- 服务器相对 URL:(这是文件夹所在的路径。其格式为:/Site_Name/Subsite_Name/Folder_Name/(如果子站点中存在文件夹,那么需要提及子站点)
- 显示子项:(如值为 TRUE,则为布尔值字段;如未显示文件和文件夹的 FALSE 详细信息,将显示给定的 serverRelativeUrl 内存在的文件和文件夹的详细信息)
样本输入请求
<RetrieveFolderRequestDetails xmlns="">
<showChildren>true</showChildren>
<serverRelativeUrl>/Shared Documents/Folder1</serverRelativeUrl>
</RetrieveFolderRequestDetails>
注: 在运行时必须为输入结构的必要元素提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
- 从核对表中选择映射输出。
所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
- 创建输出参数与编排变量之间的映射。
结果
您已配置“MS SharePoint 检索文件夹”活动。
注: 您可以使用此活动一次性检索多个文件夹的详细信息,因为输入变量不受限制。
局限性:
检索文件夹活动中的过滤器选项对于 On Premise 无效。这是已知的 API 行为。