使用 MS SharePoint“共享文件”活动

使用“共享文件”活动以在 MS SharePoint 中共享现有文件。

关于此任务

使用此任务以在 MS SharePoint 实例中与内部或外部用户共享文件。对此活动的调用是同步调用,其中会将输入数据发送到该活动以进行处理并将响应发送回到编排。

过程

  1. 右键单击“编排”部分,然后选择新编排。
  2. 将新创建的 MS SharePoint 端点拖至编排,然后选择共享文件活动。 这会将共享文件活动添加到编排。 双击该活动。这样会显示 MS SharePoint“共享文件”核对表
  3. 在“核对表”中,单击重试。复审缺省设置并进行所需的更改。
    注: 有关更多信息,请参阅为 MS SharePoint REST API 活动指定重试选项
  4. 核对表中选择映射输入。 从此操作生成的“XML 模式”显示为至活动面板中请求输入参数下的节点。
  5. 创建活动的编排变量与输入参数之间的映射。
    必填字段:
    • resourceAddress(想要共享的文档的完整 URL)
    • additiveMode
    • UserRoleAssignments
      • Role(Role 属性标识分配的许可权。1 = 查看,2 = 编辑,3 = 所有者,0 = 无)
      • userId(UserId 属性可以是用户或角色名称)。
    注:

    AdditiveMode:指示许可权设置是使用附加方式还是严格方式的标记。如果该值为“true”,那么许可权设置使用附加方式,这意味着会将指定的许可权添加到用户的当前许可权列表(如果尚不存在);如果该值为“false”,那么许可权设置使用严格方式,这意味着指定的许可权将替换用户的当前许可权。在想要停止与人员或组共享文档时,此参数非常有用。在此情况下,使用 Role = 0 将 AdditiveMode 设置为 false。

    样本输入请求:

      <ShareFile xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/sharefile">
         <ShareFileRequestDetails xmlns="">
            <resourceAddress>/shared documents/file1.txt</resourceAddress>
            <UserRoleAssignments>
               <Role>1</Role>
               <UserId>khushbu_khatuja@persistent.com</UserId>
            </UserRoleAssignments>
            <validateExistingPermissions>true</validateExistingPermissions>
            <additiveMode>true</additiveMode>
            <sendServerManagedNotification>true</sendServerManagedNotification>
            <customMessage>hello</customMessage>
            <includeAnonymousLinksInNotification>true</includeAnonymousLinksInNotification>
         </ShareFileRequestDetails>
      </ShareFile>
    注: 在运行时必须为输入结构的必要元素提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
  6. 核对表中选择映射输出。 所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
  7. 创建输出参数与编排变量之间的映射。

结果

您已配置 MS SharePoint“共享文件”活动。
注:

您可以使用此活动一次性共享多个文件,因为输入变量不受限制。