添加 Enterprise Content Management (ECM) 服务器

Draft comment:
This topic is shared by BAW, CP4BA, CP4BASaaS. Last updated on 2025-01-20 10:38
您开发的服务至少需要一个 Enterprise Content Management (ECM) 服务器。 在 流程应用程序的 " 流程应用程序设置服务器 " 页面上指定用于访问 ECM 服务器的连接属性。 也可以在 Toolkit 的“Toolkit 设置服务器”页面上指定连接属性。 将服务器添加到“Toolkit 设置服务器”页面允许复用连接属性。

关于本任务

要添加服务器,请完成下列步骤。

过程

  1. 从编辑器中选择 服务器 选项卡。 首次从新创建的 流程应用程序中单击 在 Designer 中打开 时,您将看到编辑器。 或者,您可以从 Designer 中的工具栏下拉列表中选择 Process App 设置
  2. 服务器下,单击 +。 在 详细信息下,输入有意义的服务器名称。 从类型字段的下拉列表中,选择 Enterprise Content Management 服务器。 在描述字段中,输入有意义的服务器描述。 此字段是可选字段。

    如果要使用 IBM® Process Designer 桌面编辑器,请在 " 服务器" 下单击 添加 以添加服务器

  3. 缺省值 选项卡中输入服务器配置属性。
    • 缺省选项卡包含您的缺省环境类型的服务器配置属性。 您可以通过单击 + 来添加多种环境类型。您可以添加的其他环境类型如下所示:
      • 开发:在其中开发服务的环境。
      • 测试:在其中测试服务的环境。
      • 登台: 用于部署服务以进行生产前测试的环境。
      • 生产:在其中部署服务以供组织使用的环境。
      您可以在部署后使用 updateBPMConfig 管理命令来修改环境类型。 请参阅修改 IBM Workflow Server 环境类型
    • 主机名:Enterprise Content Management 服务器的主机名。 请指定 IP 地址或主机名和域。 例如: myHost.labwide.ibm.com
    • 端口:Enterprise Content Management 服务器的端口号。
    • 上下文路径:服务器上 Content Management Interoperability Services (CMIS) Web Service 应用程序的路径。 必须使用 Web Service 协议(而非 Atom 协议)通过 Content Management Interoperability Services (CMIS) 建立连接。
      • 缺省 CMIS 上下文路径为 /fncmis ,端口为 9443
    • 安全服务器 :选择此选项可指定您是否希望服务是安全的,即使用超文本传输安全协议 HTTPS )。 如果您选择 HTTPS 协议,那么必须配置 HTTPS 安全性。
    • 存储库: 存储库的名称。 如果使用 FileNet® Content Manager 作为 ECM 服务器,那么对象库名称为 CMIS 存储库名称。
    • 用户标识:要连接到 Enterprise Content Management 服务器的用户标识。
    • 密码:连接到 Enterprise Content Management 服务器的用户标识的密码。
    • 始终使用此连接信息:如果选择此项(缺省值),那么只使用此用户标识和密码进行认证。 例如,已配置“文档列表”和“文档查看器”时服务与其关联的人员服务还具有用户上下文。 管理员会使用“管理用户”功能指定人员服务用户。 选择此复选框意味着此用户标识和密码将覆盖任何其他用户信息。
    • ECM 文档授权服务:一种在您希望检查用户的许可权时创建和选择的服务。 当响应文档资源管理器、响应文档列表和响应文档查看器 Coach 视图执行无法使用 Ajax 服务进行定制的操作时,便会从 Content Management (SYSCM) Toolkit 中使用此服务。 这些控件的较早传统 Coach 视图也会使用此服务。 这些操作包括文档的创建、更新和下载。 当您直接在人员服务、Ajax 服务和集成服务编辑器中调用内容集成操作时,不会使用该服务。
      重要信息: 要将文档上载到服务器,必须通过创建服务并在脚本任务中输入以下字符串来配置 ECM 文档授权服务:
      tw.local.authorized=true;
    • ECM 查询授权服务: 您创建并选择是否要编写定制逻辑以验证与此服务器关联的入局 CMIS 查询的服务。 选择 始终使用此连接信息时,需要设置此服务。 此服务可帮助您编写用于验证查询并运行使用已验证查询的查询的定制逻辑。
      重要说明:

      要对服务器启用查询验证,必须通过创建服务并编写定制逻辑来配置 ECM 查询授权服务,以验证与此服务器关联的入局 CMIS 查询。

      选中 始终使用此连接信息 复选框时,将执行此服务。 例如:
      var inquery = tw.local.inCmisQuery;
      // Sample CMIS query
      // SELECT cmis:objectId, cmis:name, cmis:lastModificationDate, cmis:versionLabel, cmis:contentStreamMimeType FROM  cmis:document WHERE IN_FOLDER('idf_088B1B67-1FF1-4A73-8E3A-8A52842A6B4B') ORDER BY cmis:name ASC
      var folderId = null;// Parse and get the folderId from the CMIS query
      if(inquery.indexOf("WHERE") != -1) {
          if(inquery.indexOf("IN_FOLDER") != -1) {
              var start = inquery.indexOf("('") + 2;
              var end = inquery.indexOf("')");
              folderId = inquery.substring(start + "idf_".length, end);
              folderId = "{" + folderId + "}";
          }
      }
      // For each server, one can have different validation logic
      if(serverName == "ecm") {
          if(folderId != null) {
              // Fetch folder path using a JS API getECMFolderPath defined in the scope of a system namespace       
              var folderPath = tw.system.getECMFolderPath(serverName, folderId);
              if(folderPath != null && folderPath != "/") {
                  // Check if the folder path is not Root (meaning access to all content under Root folder)           
                   // You might have set a folder path such as /Invoices or /Receipts or any other custom folder under the Root as part of configuration setting in the ECM Coach Control. Check if the path matches. Here /Invoices or /Receipts is just an example. Please change it appropriately to your custom folder path           
                  if(folderPath == "/Invoices" || folderPath == "/Receipts")
                  {                
                       // Valid folder               
                       // Rebuild the cmis query or set the outCmisQuery to the inCmisQuery   
                       tw.local.outCmisQuery = tw.local.inCmisQuery;            
                  }
              }
          }
      }
    • 事件广播者:指定其内容事件能够触发文档开始事件或前置条件求值的团队。 该团队必须包括此服务器的技术用户。 将仅从这些用户处理内容事件。

    如果您正在使用 IBM Process Designer 桌面编辑器,请输入类似的服务器配置属性。 但是,环境类型的选择是通过下拉列表完成的。

  4. 单击 测试连接 以确认与服务器的连接是否正常工作。
  5. 单击 保存完成编辑

下一步

可以在运行时更改这些设置。 有关更多信息,请参阅使用 Process Admin Console 更改 ECM 服务器设置