Тег «Field» (FSD)
Элемент «Field» указывает единственное поле во входных или выходных данных.
Атрибуты
name
Указывает имя поля. Если для атрибута «output» установлено значение Да, это имя используется как имя XML-тега в выходных данных для сопоставления выбора с XML-тегом при обработке данных ввода.
output
Указывает необходимость включения поля в выходные данные. Допустимые значения этого атрибута:
- Да
Запись создает тег в выходных данных.
- Нет
Поле описывает только структуру данных и может использоваться, чтобы пропускать данные.
Значение по умолчанию — Да.
- Да
record-sep
Указывает для поля необязательную строку разделителя полей. Разделителем может быть любое строковое значение. Также можно использовать следующие специальные значения:
\r
Символ возврата каретки
\n
-
Символ перевода строки
\t
Символ табуляции
Данные с фиксированной длиной. Если разделитель полей не указан, используется атрибут «max-length» используется.
Для последнего поля в записи используется разделитель записей, а не разделитель полей.
valid-value
Определяет фиксированное значение для поля. Этот атрибут используется для проверки плоских данных и как часть элемента «Choice» при сопоставлении с образцом. Если для атрибута «output» установлено значение Нет для плоских данных, в плоские данные записывается атрибут «valid-value».
leading-chars
Указывает строку (если найдена), которую необходимо удалить из начала поля. Если атрибут «trailing-chars» не указан, первый из этих символов используется для дополнения значения слева, если оно короче длины, указанной в атрибуте «min-length».
trailing-chars
Указывает строку (если найдена), которую необходимо удалить из конца поля. Первый из этих символов используется для дополнения значения справа, если оно короче длины, указанной в атрибуте «min-length».
output-if-empty
Указывает на необходимость записи поля в выходные данные, если его содержимое пусто. Допустимые значения этого атрибута: Да и Нет. Значение по умолчанию — Нет.
max-length
Определяет максимальную длину данных. Это значение указывает, сколько данных должно быть считано. Значение по умолчанию — 128.
min-length
Определяет минимальную длину данных. Это значение используется для проверки и сопоставления с образцом в элементе «Choice», а также для дополнения поля слева или справа при указанных атрибутах «leading-chars» или «trailing-chars». Значение по умолчанию — 0.
truncate
Если установлено значение Да, данные, записываемые в плоский файл, усекаются до указанной максимальной длины «max-length». Значение по умолчанию — Нет.
quoted
Указывает на необходимость заключения данных в кавычки. Использование данного атрибута позволяет включать символ разделителя полей в выходные данные, поскольку обработчик FSD не выполняет поиск разделителей полей в строках, заключенных в кавычки. Для данного атрибута доступны следующие значения:
- Нет
Данные не обрабатываются как строка в кавычках, а записываются в плоский файл и вне плоского файла без изменения.
- Да
Данные обрабатываются как строка в кавычках. При преобразовании данных из плоского формата в формат XML все окружающие кавычки удаляются, а все маскированные кавычки преобразуются в одиночные кавычки.
При преобразовании данных из формата XML в плоский формат данные заключаются в кавычки. Все существующие кавычки будут маскированы, т.е. кавычки будут удвоены, а именно: вместо символа « будет записано «« и т.д.
- Нет
Auto
Этот атрибут применяется только при преобразовании данных плоского файла с разделителями в формат XML. Если данные содержат разделитель полей, он обрабатывается так, как если бы для атрибута «quoted» было установлено значение Да.
Значение по умолчанию — Автоматически.