Экспорт в текстовый файл

Предназначен для экспорта набора данных в текстовый файл. Имеется возможность настройки преобразования набора данных в текстовый вид, определяя различные способы представления столбцов (с разделителями/фиксированной ширины), форматы типов данных, разделители и т.д.

Вход

Источник данных — таблица данных, подлежащая экспорту.
Управляющие переменные (необязательный порт) — переменными можно задать значения параметров мастера настройки.

Мастер настройки

Настройка компонента происходит в три этапа:

Шаг 1. Настройка форматов экспорта

Имя файла — задает путь к файлу-приемнику при локальном подключении, либо имя файла при использовании подключения к папке. Кнопка вызывает диалог выбора файла.
Группа параметров Разделители:
- Ограничитель строк — символ, обрамляющий данные ячейки набора данных. В качестве ограничителя строк могут быть использованы символы:
  - Двойная кавычка(")
  - Одинарная кавычка (')
  - Обратная кавычка (`)
  По умолчанию используется Двойная кавычка (").
- Десятичный разделитель — символ, разделяющий дробную и целую части числовых значений. Разделителем может быть Точка (.) или Запятая (,).
- Разделитель даты — символ, разделяющий компоненты даты. Доступные разделители:
  - Точка (.)
  - Слэш (/)
  - Обратный слэш (\)
- Разделитель времени — символ, разделяющий компоненты времени. Разделителем может быть Двоеточие (:) или Точка (.).
  
  В параметрах Десятичный разделитель, Разделитель даты и Разделитель времени в качестве значений по умолчанию используются локальные настройки.
Группа параметров Представление значений:
- Истина — текст, представляющий логическое значение ИСТИНА. По умолчанию используется строка True. Доступные значения: True, Истина, Да.
- Ложь — текст, представляющий логическое значение ЛОЖЬ. По умолчанию используется строка False. Доступные значения: False, Ложь, Нет.
- Пусто — текст, представляющий значение Null. По умолчанию используется символ знака вопроса ?. Доступные значения: ?, null, NULL.
Группа параметров Форматы:
- Формат даты — формат представления даты:
  - dd/mm/yyyy
  - mm/dd/yyyy
  - yyyy/mm/dd
  - dd/mm/yy
  - mm/dd/yy
  - yy/mm/dd
  Во всех форматах: dd — день месяца в виде 2-х цифр, mm — номер месяца в виде 2-х цифр, yy — год в виде 2-х цифр, yyyy - год в виде 4-х цифр.
- Формат времени — формат представления времени:
  - h:mm
  - hh:mm
  - h:mm:ss
  - hh:mm:ss
  Во всех форматах: h — часы без ведущего нуля, hh — часы в виде 2-х цифр, mm — минуты в виде 2-х цифр, ss — секунды в виде 2-х цифр.
  
  При заполнении этих параметров можно воспользоваться предлагаемыми в списке вариантами форматов, либо задать пользовательский формат.

Шаг 2. Экспорт в текстовый файл

Состояние входа — строка состояния входа Источник данных.
Группа параметров Представление столбцов:
- Формат данных — выбор одного из вариантов:
  - С разделителями — значения полей в исходном файле отделяются символом, заданным параметром Разделитель столбцов. Значение этого параметра выбирается из списка:
    - Символ табуляции
    - Точка с запятой
    - Пробел
    - Запятая
    - Точка
  - Фиксированной ширины — поля в исходном файле имеют заданную ширину.
Кодовая страница — кодировка, в которой сохранится текст. Доступные варианты:
- ANSI/Windows(0)
- ASCII/MS DOS(1)
- Кириллическая (1251)
- Западноевропейская (1252)
- UTF-8 (65001)
- UTF-16 LE (1200)
- UTF-16 BE (1201)
Добавить BOM — определяет, будет ли в начало файла добавлен BOM. По умолчанию флаг не поставлен.
Перевод строк — определяет последовательность символов, используемую для разделения записей (строк) в выходном файле. Значение этого параметра выбирается из выпадающего списка:
- Unix (LF)
- Windows (CRLF)
Строка заголовка — выбор способа задания наименования столбцов в экспортируемом файле:
- Метки столбцов (полей) — в качестве заголовков столбцов будут использованы Метки полей.
- Имена столбцов (полей) — в качестве заголовков столбцов будут использованы Имена полей.
- Нет строки заголовков — столбцы будут экспортированы без заголовков.
Предпросмотр — представляет ограниченное количество данных для ознакомления в виде таблицы.

Шаг 3. Описание узла

На данном этапе мастера настройки узла доступен выбор режима формирования метки узла:

Автоматическая метка — метка генерируется системой на основе имени(имён) файла(ов) или управляющей переменной.

Для узла автоматическая метка формируется по следующим правилам:

если задано имя импортируемого файла, то в метку пишется имя файла без пути;
если имя импортируемого файла задано управляющей переменной, то в метку пишется имя этой переменной.

Автоматически сформированная метка обновляется при изменении настроек импорта и отображается в сценарии без возможности редактирования напрямую. При необходимости можно принудительно обновить её через контекстное меню метки узла.

Пользовательская метка задаётся вручную и не меняется автоматически. В этом режиме можно ввести любое текстовое описание. Рядом с полем ввода отображается значок обновления, который становится активным, если текущая пользовательская метка отличается от метки компонента по умолчанию. Нажатие на значок обновления восстанавливает метку компонента по умолчанию.

Режим формирования метки можно изменить как в мастере настройки узла (через выпадающий список на третьем шаге мастера настройки), так и через контекстное меню метки узла в сценарии (правой кнопкой мыши по метке узла).

У скопированного или клонированного узла сохраняется режим формирования метки.

Если у исходного узла метка формируется автоматически, то у скопированных и клонированных узлов не будет добавляться индекс.

На этом шаге также можно задать описание узла на вкладке Заметка(markdown). При задании описания можно использовать синтаксис markdown, а результат верстки посмотреть на вкладке Предпросмотр. Описание команд панели инструментов приведено в статье Заметки.

Статьи в разделе:

Пользовательский формат дата/время