创建 Domino 文档
使用“创建文档”活动可在 Domino® 服务器中创建文档。
使用创建活动
- 右键单击项目窗格中的编排,然后单击新建编排以创建一个编排,或者打开一个编排。 这样会显示编排窗格。
- 选择活动选项卡并展开 Domino 文件夹。
- 将创建文档活动从 Domino 文件夹拖至编排上。这样会显示编排的图形表示,包括核对表。
- 核对表窗格列出了为配置出站活动而必须完成的任务(摘要、选取端点、配置、映射输入、映射输出)。
- 单击选取端点,然后选择 Domino 端点。
有关创建或编辑 Domino 端点的指示信息,请参阅创建或编辑 Domino 活动的端点
- 单击“核对表”中的配置。这样会显示“配置”窗格。
- 单击浏览以从“浏览 Domino 数据库”窗格中选择现有数据库。“浏览 Domino 数据库”显示所选端点的所有数据库。
- 单击下一步以从“浏览 Domino 表单”窗格中选择现有表单。“浏览 Domino 表单”显示 Domino 服务器的所选数据库中的所有表单。
注: 仅在选择数据库名称后才会启用“下一步”按钮。
指定创建活动的映射输入
- 单击核对表窗格中的映射输入。此时在至活动窗格下会显示此特定 Domino 活动的输入参数。注: 必须映射数据来自前一个活动的活动的所有必需输入参数。注: 要填充动态添加的 Domino 文档字段(不是映射输入结构的一部分),可使用 AdditionalFields 属性并在 FieldDetails 部分中提供字段名称和字段值。
对于在多个数据库中均相同的“表单类型”,您现在可以指定数据库名称作为映射输入中可选参数的一部分,在这些输入中可使用相同的编排对不同数据库执行出站操作。要执行该操作,必须在 databaseName 可选参数中指定数据库名称(如下表所述)。如果为 databaseName 参数填充了一个值,那么将对 databaseName 参数中指定的数据库执行出站操作。 如果未指定值,将会使用在配置期间指定的数据库名称来执行出站操作。
下表中描述了可选输入参数:
表 1. 数据库名称可选参数 参数名称 描述 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 分钟。
指定创建活动的映射输出
- 单击核对表窗格中的映射输出。
此时在自活动窗格下会显示 Domino 活动的输出参数。
AdditionalFields 属性的响应也显示在自活动窗格中。
下表定义了其中一些常见输出参数。参数名称 描述 UniversalID 文档的 UniversalID 是一个读/写属性,用于在数据库的所有副本中唯一标识文档。 在字符格式中,UniversalID 是十六进制数字(0-9 和 A-F)的 32 字符组合。UniversalID 也称为 uniqueID 或 UNID。datatype 为字符串。 NotesID 文档的 NotesID 是一个只读属性,具有最多由 8 个字符构成的十六进制值,该值在特定数据库中唯一标识文档。 Notes 标识表示文档在特定数据库文件内的位置。因此,文档的副本文档通常具有不同的 Notes 标识。 Notes 标识不会更改,除非删除文档。 表单 表单提供用于创建和显示文档的结构,这些文档是存储数据库中数据的设计元素。 在表单中输入信息并进行保存时,信息便会另存为文档。打开文档时,文档使用表单作为模板来提供用于显示数据的结构。 注: 更改表单(例如,通过添加字段)不会更改先前通过该表单创建的文档,直至代理程序手动或自动修改并保存这些文档为止。除去表单中的某个字段不会从先前创建的文档中除去该字段的值。ParentDocumentUNID 文档的 parentdocumentUNID 是一个只读属性。 如果文档是响应文档,那么该属性将定义为文档父代的通用标识。如果文档没有父代,那么它返回空字符串 ("")。datatype 为字符串。 注: 您可以根据需求映射活动的输出参数。
摘要标志(字段标志)行为
当为包含“作者”、“读者”或“名称”类型字段的表单创建文档以及在映射输入中为这些字段设置数据时,根据 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"。