检索 Domino 文档

通过使用“检索活动”,可以从 Domino® 数据库中检索文档。检索到的各文档均通过其 UniversalID 或 NotesID 进行唯一标识。 检索基于输入(即 UniversalID 或 NotesID)来完成。

使用检索活动

  1. 右键单击“项目”窗格中的编排,然后单击新建编排以创建一个编排,或者打开一个编排。这样会显示编排窗格。
  2. 选择“活动”选项卡并展开 Domino 文件夹。
  3. 检索活动从 Domino 文件夹拖至编排上。 这样会显示编排的图形表示以及核对表
  4. “核对表”窗格列出了完成出站活动配置而必须执行的任务(摘要、选取端点、配置、映射输入、映射输出)
  5. 单击选取端点,然后选择 Domino 端点。

    有关创建或编辑 Domino 端点的指示信息,请参阅创建或编辑 Domino 活动的端点

  6. 单击“核对表”中的配置。这样会显示“配置”窗格。
    • 单击浏览以从“浏览 Domino 数据库”窗格中选择现有数据库。“浏览 Domino 数据库”显示所选端点的所有数据库。
    • 单击下一步以从“浏览 Domino 表单”窗格中选择现有表单。“浏览 Domino 表单”显示 Domino 服务器的所选数据库中的所有表单。
      注: 仅在选择数据库名称后才会启用下一步按钮。
    • 具有规范名称的字段接受具有规范名称(例如 John Smith/IBM/COUNTRY)的字段作为值,这些字段之间用逗号分隔。如果希望将这些字段中的值转换为因特网邮件地址(例如 johnsmith@country.ibm.com),请在该字段中指定规范名称。下面为一些字段名称示例:“收件人”、“发件人”、“抄送人”、“主席”、“必需出席者”等。

指定检索活动的映射输入

检索活动的输入参数是 UniversalID 或 NotesID。如果提供了这两个参数,那么将使用 UniversalID 来检索 Domino 文档。
  1. 单击“核对表”窗格中的映射输入
    此时在目标活动窗格下会显示此特定 Domino 活动的输入参数。下表定义了其中一些常见输入参数。
    参数名称 描述
    UniversalID UniversalID 参数是一个读/写属性,用于在数据库的所有副本中唯一标识文档。在字符格式中,唯一标识参数是十六进制数字(0-9 和 A-F)的 32 字符组合。UniversalID 也称为唯一标识或 UNID。数据类型为字符串。
    NotesID 文档的 Notes® 标识是一个只读属性,具有最多由 8 个字符构成的十六进制值,该值在特定数据库中唯一标识文档。 Notes 标识表示文档在特定数据库文件内的位置。因此,互为副本的文档通常具有不同的 Notes 标识。 Notes 标识不会更改,除非删除文档。
    注: 必须映射活动的输入参数。

对于在多个数据库中均相同的“表单类型”,您现在可以指定数据库名称作为映射输入中可选参数的一部分,在这些输入中可使用相同的编排对不同数据库执行出站操作。要执行该操作,必须在 databaseName 可选参数中指定数据库名称(如表 1 所述)。如果为 databaseName 参数填充了一个值,那么将对 databaseName 参数中指定的数据库执行出站操作。 如果未指定值,将会使用在配置期间指定的数据库名称来执行出站操作。

可选参数
下表中描述了可选输入参数:
表 1. 可选参数
参数名 描述
databaseName databaseName 是从中检索文档的数据库的名称。如果为该参数设置了值,那么将覆盖配置面板中的数据库值。该参数适用于必须使用相同编排从多个数据库中检索具有相同结构(表单)的文档的情况。
Domino 连接器还支持从端点动态连接到其他 Domino 服务器。在运行时期间,如果要动态连接到端点页面中配置的 Domino 服务器之外的 Domino 服务器,可在映射输入的 dominoConnectionProperties 中添加新的可选参数。下表中描述了 dominoConnectionProperties 的参数:
表 2. 可选连接参数
参数 描述
dominoConnectionProperties 参数
hostName 指定运行 Domino 服务器的机器的主机名或 IP 地址。
diiopPort 指定 Domino Internet Inter-ORB Protocol (DIIOP) 端口,该端口允许 Java™ applet 或应用程序使用 CORBA 远程访问 Domino 数据。缺省值为 63148。
username 指定用于连接到 Domino 服务器的用户名。
password 指定与用于连接到 Domino 服务器的用户名关联的密码。
connectionPool 参数
minimumConnections 指定 Integration Appliance 在连接池中保持打开的最小 Domino 服务器连接数。支持输入 0(零)。缺省值为 5。
maximumConnections 指定 Integration Appliance 在连接池中保持打开的最大 Domino 服务器连接数。输入 0(零)意味着最大连接数不受限制。缺省值为 25。
maxIdleTime 指定 Domino 服务器连接在被 Integration Appliance 关闭之前可以在空闲状态下保持打开状态的时间量(分钟)。指定 0 意味着,当连接返回到池中时便已关闭,即无空闲时间。缺省值为 120 分钟。
maxWait 指定 Integration Appliance 在池中所有连接都已用尽时等待连接的时间长度(秒)。如果在该等待时间后未获得连接,会抛出异常。缺省值为 300 秒。
reclaimConnections 指定接口检查空闲连接的时间间隔。接口会回收空闲连接,直至达到在“最小连接数”参数中指定的最小连接数。缺省值为 5 分钟。

指定检索活动的映射输出

  1. 单击核对表窗格中的映射输出

    此时在源活动窗格下会显示 Domino 活动的输出参数。

    注: 您可以映射基于需求的活动的输出参数。
    注: 存在于 Domino 文档中且未在映射输入/输出结构中生成的动态添加的字段由 Domino 连接器处理。在使用该活动检索文档时,这些字段的数据在映射输出部分的 AdditionalFields 下可用。



反馈 | 声明


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/Domino_retrieve_outactivity.html