检索 Domino 文档
通过使用“检索活动”,可以从 Domino® 数据库中检索文档。检索到的各文档均通过其 UniversalID 或 NotesID 进行唯一标识。 检索基于输入(即 UniversalID 或 NotesID)来完成。
使用检索活动
- 右键单击“项目”窗格中的编排,然后单击新建编排以创建一个编排,或者打开一个编排。这样会显示编排窗格。
- 选择“活动”选项卡并展开 Domino 文件夹。
- 将检索活动从 Domino 文件夹拖至编排上。 这样会显示编排的图形表示以及核对表。
- “核对表”窗格列出了完成出站活动配置而必须执行的任务(摘要、选取端点、配置、映射输入、映射输出)。
- 单击选取端点,然后选择 Domino 端点。
有关创建或编辑 Domino 端点的指示信息,请参阅创建或编辑 Domino 活动的端点。
- 单击“核对表”中的配置。这样会显示“配置”窗格。
- 单击浏览以从“浏览 Domino 数据库”窗格中选择现有数据库。“浏览 Domino 数据库”显示所选端点的所有数据库。
- 单击下一步以从“浏览 Domino 表单”窗格中选择现有表单。“浏览 Domino 表单”显示 Domino 服务器的所选数据库中的所有表单。注: 仅在选择数据库名称后才会启用下一步按钮。
- 具有规范名称的字段接受具有规范名称(例如 John Smith/IBM/COUNTRY)的字段作为值,这些字段之间用逗号分隔。如果希望将这些字段中的值转换为因特网邮件地址(例如 johnsmith@country.ibm.com),请在该字段中指定规范名称。下面为一些字段名称示例:“收件人”、“发件人”、“抄送人”、“主席”、“必需出席者”等。
指定检索活动的映射输入
检索活动的输入参数是 UniversalID 或 NotesID。如果提供了这两个参数,那么将使用 UniversalID 来检索 Domino 文档。
- 单击“核对表”窗格中的映射输入。此时在至活动窗格下会显示此特定 Domino 活动的输入参数。下表定义了其中一些常见输入参数。
参数名称 描述 UniversalID UniversalID 参数是一个读/写属性,用于在数据库的所有副本中唯一标识文档。在字符格式中,唯一标识参数是十六进制数字(0-9 和 A-F)的 32 字符组合。UniversalID 也称为唯一标识或 UNID。数据类型为字符串。 NotesID 文档的 Notes® 标识是一个只读属性,具有最多由 8 个字符构成的十六进制值,该值在特定数据库中唯一标识文档。 Notes 标识表示文档在特定数据库文件内的位置。因此,互为副本的文档通常具有不同的 Notes 标识。 Notes 标识不会更改,除非删除文档。 注: 必须映射活动的输入参数。
对于在多个数据库中均相同的“表单类型”,您现在可以指定数据库名称作为映射输入中可选参数的一部分,在这些输入中可使用相同的编排对不同数据库执行出站操作。要执行该操作,必须在 databaseName 可选参数中指定数据库名称(如表 1 所述)。如果为 databaseName 参数填充了一个值,那么将对 databaseName 参数中指定的数据库执行出站操作。 如果未指定值,将会使用在配置期间指定的数据库名称来执行出站操作。
可选参数
下表中描述了可选输入参数:
参数名称 | 描述 |
---|---|
databaseName | databaseName 是从中检索文档的数据库的名称。如果为该参数设置了值,那么将覆盖配置面板中的数据库值。该参数适用于必须使用相同编排从多个数据库中检索具有相同结构(表单)的文档的情况。 |
Domino 连接器还支持从端点动态连接到其他 Domino 服务器。在运行时期间,如果要动态连接到端点页面中配置的 Domino 服务器之外的 Domino 服务器,可在映射输入的 dominoConnectionProperties 中添加新的可选参数。下表中描述了 dominoConnectionProperties 的参数:
参数 | 描述 |
---|---|
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 分钟。 |
指定检索活动的映射输出
- 单击核对表窗格中的映射输出。
此时在自活动窗格下会显示 Domino 活动的输出参数。
注: 您可以映射基于需求的活动的输出参数。注: 存在于 Domino 文档中且未在映射输入/输出结构中生成的动态添加的字段由 Domino 连接器处理。在使用该活动检索文档时,这些字段的数据在映射输出部分的 AdditionalFields 下可用。