使用 MS SharePoint“检索列表”活动

使用“检索列表”活动以从 MS SharePoint 检索列表属性。

关于此任务

使用此任务以从 MS SharePoint 实例检索列表属性。对此活动的调用是同步调用,在此调用中会将输入数据发送到该活动以进行处理并将响应发送回编排。

过程

  1. 右键单击“编排”部分,然后选择新编排。
  2. 将新创建的 MS SharePoint 端点拖至编排,然后选择检索列表活动。 这会将检索列表活动添加到编排。双击该活动。这样会显示 MS SharePoint“检索列表”核对表
  3. 在“核对表”中,单击重试。复审缺省设置并进行所需的更改。
    注: 有关更多信息,请参阅为 MS SharePoint REST API 活动指定重试选项
  4. 核对表中选择映射输入。 从此操作生成的“XML 模式”显示为至活动面板中请求输入参数下的节点。
  5. 创建活动的编排变量与输入参数之间的映射。
    必填字段:
    • retrieveType(有效值为 ALL 和 SPECIFIC)
    • retrieveListBy(有效值为 LIST_ID 和 LIST_TITLE)
    • listId(如果将 retrieveType 指定为 SPECIFIC 并将 retrieveListBy 指定为 LIST_ID,那么是必需的)
    • listTitle(如果将 retrieveType 指定为 SPECIFIC 并将 retrieveListBy 指定为 LIST_TITLE,那么是必需的)

    样本输入请求

    <?xml version="1.0" encoding="UTF-8"?>
    <RetrieveList xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/retrievelist">
    <!--1.	retrieveType value as ALL-->
    
    <RetrieveListRequestDetails xmlns="">
    <retrieveType>ALL</retrieveType>
    </RetrieveListRequestDetails>
    
    
    <!--2.	retrieveType value as SPECIFIC and retrieveListBy as LIST_TITLE-->
         <RetrieveListRequestDetails xmlns="">
            <retrieveType>SPECIFIC</retrieveType>
            <retrieveListBy>LIST_TITLE</retrieveListBy>
            <listTitle>List103</listTitle>
         </RetrieveListRequestDetails>
    
    
    <!--3.	retrieveType value as SPECIFIC and retrieveListBy as LIST_ID-->
         <RetrieveListRequestDetails xmlns="">
            <retrieveType>SPECIFIC</retrieveType>
            <retrieveListBy>LIST_ID</retrieveListBy>
            <listId>efb347bd-2b4f-4859-b67c-80c7e60ed8fa</listId>
         </RetrieveListRequestDetails>
      </RetrieveList>
    注: 在运行时必须为输入结构的必要元素提供值。可以通过为元素指定缺省值或通过将元素与输入节点链接来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
  6. 核对表中选择映射输出。 所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
  7. 创建输出参数与编排变量之间的映射。

结果

您已配置 MS SharePoint“检索列表”活动。
注:

您可以使用此活动一次检索多个列表的属性,因为输入变量不受限制。

限制:

“检索列表”活动中的 ExpandChildren 选项不适用于 SharePoint On-Premise。这是 SharePoint On-Premise 的已知 API 行为。