第四十二章 开发Productions - ObjectScript Productions - 使用记录映射器 - 通用控制字符

通用控制字符

在记录映射中，可以在多个位置使用文字控制字符和可打印字符。例如，可以指定制表符（常用控制字符）和逗号（可打印字符）作为分隔符。还可以将控制字符指定为填充字符或记录终止符之一。要在这些上下文之一中指定控制字符，必须为该字符指定十六进制转义序列。如果选择空格或制表符作为填充字符，或选择 CRLF（回车后跟换行符）、CR 或 LF 作为 Record Mapper 中的记录终止符，管理门户会自动生成十六进制表示。如果指定另一个控制字符作为填充字符或记录终止符或任何控制字符作为分隔符，则必须在相应的表单域中输入十六进制表示。下表列出了常用控制字符的十六进制转义序列：

Character	Hexadecimal representation
Tab	\x09
Line feed	\x0A
Carriage return	\x0D
Space	\x20

注意：如果在 RecordMap 中指定了记录终止符，则传入消息必须与记录终止符完全匹配。例如，如果指定 CRLF (\x0D\x0A)，则传入消息记录必须与该序列匹配。

编辑记录映射属性

无论是从向导生成的映射开始输入新记录映射的属性，还是编辑现有映射，过程都是相同的。对于记录本身，请在以下字段中输入或更新值：

RecordMap Name

记录映射的名称。应该用包名称限定记录映射名称。如果未提供程序包名称并指定了不合格的记录映射名称，则默认情况下记录映射类保存在用户程序包中。

Target Classname

表示记录的类的名称。默认情况下，记录映射器将目标类名称设置为与记录映射名称后跟“.Record”相同的限定名称，但可以更改目标类名称。应该用包名限定目标类名。如果不提供包名并指定非限定的目标类名，则默认情况下，目标类保存在用户包中。

Batch Class

应与此记录映射关联的批处理类的名称（如果有）。

Type

记录类型；选项包括以下内容：

• Delimited

• Fixed Width

Character Encoding

导入数据记录的字符编码。

Right justify

指定填充字符应出现在字段中数据左侧的标志。

Annotation

记录记录地图的目的和用途的文本。

Leading data

出现在实际记录内容的任何数据之前的静态字符。如果在复杂的记录映射中使用记录映射，则必须标识具有前导数据的记录。

Padding Character

用于填充值的字符。填充字符由业务服务从传入消息中删除，并由业务操作用于填充字段值以填充固定宽度记录映射中的字段。
- None

• Space

• Tab

• Other

Record Terminator

用于终止记录的一个或多个字符。

• None

• CRLF

• CR

• LF

• Other

Allow Early Terminator (fixed-width record maps only)

指定记录是否可以在结束前终止的标志。如果允许，记录将被视为用填充字符填充。

Allow Complex Batching

指定记录映射是否可用于复杂记录映射的标志。

Field separator (fixed-width record maps only)

用于分隔记录中固定宽度字段的可选单个字符。如果指定，输入消息必须在字段之间包含此字符，并且业务操作在字段之间写入此字符。

Field separator(s) (delimited record maps only)

字段分隔符列表。第一个分隔符分隔记录中的顶级字段。下一个分隔符分隔顶级复合字段中的字段。附加分隔符分隔嵌套复合字段中的字段。

Repeat separator (delimited record maps only)

在所有重复字段中使用的单个分隔符。

Quoting: None (delimited record maps only)

指定没有引号式转义的单选按钮。

Quote Escaping (delimited record maps only)

启用引号式转义以允许分隔符出现在字段值中的单选按钮。任何输入字段都可以用引号字符引起来。该字段被认为是开始引号和结束引号之间的所有字符。出现在引号内的任何分隔符都被视为文字字符，而不是分隔符。在输出时，任何在其值中包含分隔符的字段都用引号字符引用。

Quote All (delimited record maps only)

启用引号式转义以允许分隔符出现在字段值中的单选按钮。这与 Quote Escaping 具有相同的效果，除了在输出时所有字段都被引用，无论它们是否包含分隔符。

Quote character (delimited record maps with quote escaping only)

用于引用字段内容的字符。如果选择报价转义或报价全部单选按钮，则会显示此字段。如果使用控制字符作为引号，则必须以十六进制输入；请参阅公共控制字符。

Allow Embedded Record Terminator

确定当 Record Mapper 在引用字段中遇到 Record Terminator 时会发生什么。如果选中，记录映射器将转义记录终止符，将其视为字段数据的一部分，而不是将其视为记录的结尾。