Novell Documentation: Identity Manager Drivers

4.1 配置驱动程序参数

在更改驱动程序参数时，可以调整驱动程序行为，使其符合您的网络环境要求。例如，您可能会发现发布者默认巡回检测间隔比同步要求的间隔短。增大间隔可提高网络性能，并保持正确的同步。

驱动程序参数被分为以下几种设置：

驱动程序（请参见驱动程序设置。）
订购者（请参见订购者设置。）
发布者（请参见发布者设置。）

配置驱动程序参数：

在 iManager 中，选择 Identity Manager >《Identity Manager 概述》。
使用《查找》、《浏览》或《搜索》功能查找 Identity Manager Driver for Delimited Text 集。

下图说明了如何使用《搜索》功能。
单击驱动程序图标（定界文本），查看驱动程序概述。
再次单击驱动程序图标以访问《驱动程序配置》页。
滚动至《驱动程序参数》部分，进行更改，然后单击《确定》。

要更改《驱动程序设置》部分，请参见驱动程序设置。

要更改《订购者设置》部分，请参见订购者设置。

要更改《发布者设置》部分，请参见发布者设置。

4.1.1 驱动程序设置

下图说明了样本配置中的驱动程序设置及其默认值。

字段分界符

Field Delimiter（字段分界符）指定用于分隔输入文件中字段值的字符。它必须是一个字符。

如果任何输入字段值中包含该字符，需用引号将整个值引起来，以免将其看作分界符。

NOTE:如果使用订购者，那么在将分界符参数更改为逗号以外的其它字符时，不会自动更改输出文件中使用的分界符。要更改输出文件中的分界符，请编辑《输出转换》样式表。分界符将指派给靠近该样式表顶部的变量。

字段名

Field Names（字段名）是一个以逗号分隔的特性名列表，可以在《纲要映射》规则中引用这些特性名。在输入文件中，记录的字段必须与此列表中名称的顺序和位置相对应。

例如，如果在此参数中列出 8 个字段名，则输入文件的每条记录都应包含以字段分界符分隔的这 8 个字段。在 NetWare® 和 Windows 上，请参见 delimitedtext/samples 目录中的 sample.csv 示例。在 Solaris 和 Linux 上，sample.csv 位于 /usr/lib/dirxml/rules/delim 目录中。

下表列出了默认值：

参数	样本配置值
字段名（字段 1, 字段 2, 字段 3...）	姓、名、职务、电子邮件、工作电话、传真、无线电话、说明

对象类名称

《对象类名称》是在创建与输入文件相对应的新对象时应使用的 Novell® eDirectory™ 类名称。

允许驱动程序消耗自身输出

使用此参数可防止出现以下意外情形：驱动程序写入输出文件，但输出文件被立即作为此驱动程序的输入再次读取。

默认值为《否》。默认情况下，如果满足下列所有条件，则驱动程序不装载其自身输出：

同时拥有订购者通道和发布者通道。
输入和输出目录相同。
输入和输出文件扩展名相同。

如果采用将订购者通道的输出传递到订购者通道的输入这一方式来检测 Identity Vault 事件，以触发 Identity Vault 中的其它更改，请将此参数设为《是》。例如，要在《名》、《姓氏》或《姓名首字母》特性更新时更新《全名》特性，请将此参数设为《是》。

4.1.2 订购者设置

下图说明了样本配置中的订购者设置及其默认值。

输出文件路径

Output File Path（输出文件路径）是本地文件系统上的目录，将在其中创建输出文件。如果此目录不存在，则会出现错误。

平台	样本配置值
Windows	c:\csvsample\output
Solaris 或 Linux	/csvsample/output
NetWare	指定卷（如 sys:csvsample\output）

输出文件扩展名

输出文件具有一个以 Output File Extension（输出文件扩展名）参数中字符结尾的唯一名称。如果来自订购者通道的输出文件用作另一个 Identity Manager Driver for Delimited Text 的发布者通道的输入文件，则目标文件扩展名必须与第二个驱动程序的源文件扩展名参数相符。

目标文件字符编码

如果 Destination File Character Encoding（目标文件字符编码）参数中不包含值，则使用您的语言环境默认的 Java 字符编码。

要使用语言环境默认编码以外的编码，请输入受支持的编码表中的某个规范名称。

NOTE:发布者通道和订购者通道可以使用不同的字符编码。

每个输出文件的最大事务数

使用此参数可确定写入单个输出文件的最大事务数。在达到文件事务限制时，该文件会关闭，同时会创建一个新的文件以写入后续事务。要限制写入单个文件的事务的数目，请将此参数保留为空或者将其设为零。

有关更多信息，请参见清理所有事务之前的最长时间（秒）。

清理所有事务之前的最长时间（秒）

在此参数中指定的时间内，如果没有新的事务写入输出文件，则该文件会关闭。如果需要写入新的事务，则会创建一个新的输出文件。如果不希望限制在关闭输出文件前等待的时间，请将此参数保留为空或者将其设为零。

清理所有事务的时间（本地时间）

如果为此参数提供一个值，则会在每天指定的时间关闭当前输出文件。后续事务将写入新的文件。另外，此参数不阻止 Maximum Number of Transactions per Output File（每个输出文件的最大事务数）或 Maximum Time in Seconds before Flushing All Transactions（清理所有事务之前的最长时间（秒））参数充当输出文件的阈值。如果要使用此参数并且希望每天只使用一个文件，请将其它两个参数设为零。

此参数的格式可以为 HH:MM:SS（使用 24 小时制），也可以为 H:MM:SS AM/PM。小时为必选项，而分钟和秒为可选项。由于此参数使用本地时间，因此将忽略值中包含的任何时区信息。

NOTE:以上三个参数（《每个输出文件的最大事务数》、《清理所有事务之前的最长时间（秒）》和 Time of Day to Flush All Transactions（清理所有事务的时间））均可以充当文件能够增长到的事务大小的阈值，或者文件需保持打开状态以接受新事务的时间的阈值。

只要输出文件还保持打开状态，以供定界文本驱动程序写入事务，那么就不应该将其视为已完成操作。在驱动程序关闭文件前，应避免在其它任何进程中打开该文件。鉴于此，必须设置上述这三个参数中的一个参数，以确保输出文件不会始终保持打开状态。为避免出现此情况，在驱动程序检测到所有三个参数均为空（或为零）时，它会自动将《每个输出文件的最大事务数》的值设为 1。

4.1.3 发布者设置

下表列出了样本配置中的发布者通道参数及其默认值。

Table 4-1 发布者参数默认值

参数	样本配置值
输入文件路径	在 Windows 上： c:\csvsample\input 在 Solaris 和 Linux 上 /usr/lib/dirxml/rules/delim 在 NetWare 上，需要指定卷（如 sys:csvsample\input）
输入文件扩展名	.csv
源文件字符编码（保留为空将使用默认值）	[空]
重命名文件扩展名（保留为空将删除文件）	.bak
巡回检测速率（秒）	10

输入文件路径

Input File Path（输入文件路径）是本地文件系统上的一个目录，发布者通道在该目录中查找新的输入文件。

输入文件扩展名

发布者通道只使用带有此参数中指定的扩展名的文件。在对文件进行处理后，Rename File Extension（重命名文件扩展名）参数值会附加到文件名后，因此发布者通道不会尝试再次处理该同一文件。如果《重命名文件扩展名》参数值留空，在处理源文件后会将其删除。

源文件字符编码

如果Source File Character Encoding（源文件字符编码）参数中不包含值，则使用您的语言环境默认的 Java 字符编码。

要使用语言环境默认编码以外的编码，请输入受支持的编码表中的某个规范名称。

如果《输入文件扩展名》参数为 .xml，则可以采用下面两种方式中的一种指定《源文件字符编码》：

如果在《源文件字符编码》参数中指定了值，则使用该值。
如果该参数为空，并且 XML 文档指定了一个编码声明（如 W3C XML 建议第 4.3.3 段中所述），那么将由 Metadirectory 引擎中的 XML 分析程序处理该编码声明。
Identity Manager XML 分析程序可处理以下字符编码：
- UTF-8
- UTF-16
- ISO-8859-1
- US-ASCII

NOTE:发布者通道和订购者通道可以使用不同的字符编码。