更新 Domino 文档
使用“更新文档”活动可更新 Domino® 数据库中的文档。已更新的每个文档必须可通过其 UniversalID 或 NotesID 唯一标识。
使用更新活动
- 右键单击项目窗格中的编排,然后单击新建编排以创建一个编排,或者打开一个编排。 这样会显示编排窗格。
- 选择活动选项卡并展开 Domino 文件夹。
- 将更新活动从 Domino 文件夹拖至编排上。这样会显示编排的图形表示以及“核对表”窗格。
- 核对表窗格列出了为配置出站活动而必须完成的任务(摘要、选取端点、配置、映射输入、映射输出)。
- 单击选取端点,然后选择 Domino 端点。
有关创建或编辑 Domino 端点的指示信息,请参阅创建或编辑 Domino 活动的端点
- 单击“核对表”中的配置。这样会显示“配置”窗格。
- 单击浏览以从“浏览 Domino 数据库”窗格中选择现有数据库。“浏览 Domino 数据库”显示所选端点的所有数据库。
- 单击下一步以从“浏览 Domino 表单”窗格中选择现有表单。“浏览 Domino 表单”显示 Domino 服务器的所选数据库中的所有表单。
注: 仅在选择数据库名称后才会启用下一步按钮。
指定更新活动的映射输入
更新活动的输入参数是 UniversalID 或 NotesID,并且必须更新所有业务数据字段(特定于所选表单)。
- 单击核对表窗格中的映射输入。此时在至活动窗格下会显示此特定 Domino 活动的输入参数。下表定义了输入参数。
参数名称 描述 UniversalID 文档的 UniversalID 是一个读/写属性,用于在数据库的所有副本中唯一标识文档。 在字符格式中,UniversalID 是十六进制数字(0-9 和 A-F)的 32 字符组合。UniversalID 也称为唯一标识或 UNID。数据类型为字符串。 NotesID 文档的 NotesID 是一个只读属性,具有最多由 8 个字符构成的十六进制值,该值在特定数据库中唯一标识文档。 NotesID 表示文档在特定数据库文件内的位置。因此,文档的副本文档通常具有不同的 Notes 标识。 NotesID 不会更改,除非删除文档。 注: 必须映射活动的输入参数。注: 要填充动态添加的 Domino 文档字段(不是映射输入结构的一部分),可使用 AdditionalFields 属性并在 FieldDetails 部分中提供字段名称和字段值。
对于在多个数据库中均相同的“表单类型”,您现在可以指定数据库名称作为映射输入中可选参数的一部分,在这些输入中可使用相同的编排对不同数据库执行出站操作。要执行该操作,必须在 databaseName 可选参数中指定数据库名称(如表 1 所述)。如果为 databaseName 参数填充了一个值,那么将对 databaseName 参数中指定的数据库执行出站操作。 如果未指定值,将会使用在配置期间指定的数据库名称来执行出站操作。
Domino 活动的可选参数
下面是为更新活动定义的可选参数。
参数名称 | 描述 |
---|---|
MarkAsRead | 指定在更新操作期间是否要将文档标记为已读取。它为布尔类型。 |
MakeResponse | 指定是否要将文档用作已保存文档的响应,即使其他用户修改并保存该文档也如此。它为布尔类型。 |
ForceSave | 指定在更新操作发生冲突期间是否要强制保存文档。它为布尔类型。 |
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 字段类型为摘要标志设置适当的许可权。自 Domino 服务器 V8.5.3 开始支持该功能。
例如:
- 如果为类型为作者的 Domino 字段设置值 CN=SYSTEM/O=IBM,那么摘要标志将为 SUMMARY READ/WRITE-ACCESS NAMES "CN=SYSTEM/O=IBM"。
- 如果为类型为读者的 Domino 字段设置值 CN=SYSTEM/O=IBM,那么摘要标志将为 SUMMARY READ-ACCESS NAMES "CN=SYSTEM/O=IBM"。
- 如果为类型为名称的 Domino 字段设置值 CN=SYSTEM/O=IBM,那么摘要标志将为 SUMMARY NAMES "CN=SYSTEM/O=IBM"。