Сохранить таблицу в CSV Версия 21 (Net)
Группа действий: Таблицы
Описание
Данное действие предназначено для сохранения таблицы в формате CSV.
Иконка действия
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Таблица | Таблица, для которой будет совершено действие | Robin.DataTable | Да | |
Кодировка | Кодировка результирующего файла. По умолчанию UTF-8 | Robin.String | Нет | |
Разделитель строк | Символ, которым будут разделяться строки. По умолчанию rn | Robin.String | Нет | |
Разделитель столбцов | Символ, которым разделяются столбцы в исходном файле. Значение по умолчанию равно ";" | Robin.String | Нет | |
Имя файла | Имя файла (без расширения), который будет создан. Расширение .csv будет добавляться автоматически действием | Robin.String | Да | |
Папка | Путь к папке, где следует сохранить созданный файл. | Robin.FolderPath | C:\doc\img | Да |
С заголовком | Если значение true, заголовок таблицы будет вставлен в документ вместе с ее строками | Robin.Boolean | true | Нет |
Результаты | ||||
Результат | Путь к созданному CSV файлу | Robin.FilePath |
Особые условия использования
Для параметра "С заголовком":
- При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
- При "false", действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Пример использования
Задача
Имеется Excel файл с таблицей.
.
Необходимо ее сохранить в формате CSV с заголовком на рабочий стол.
Решение
Воспользоваться действиями "Открыть", "Взять таблицу", "Сохранить таблицу в CSV".
Реализация
- Собрать схему робота, состоящую из действий.
- Настроить параметр для действия "Открыть".
- Настроить параметры для действия "Взять таблицу".
- Настроить параметры для действия "Сохранить таблицу в CSV".
- В поле "Таблица" указать переменную типа "Таблица" с данными.
- В поле "Кодировка" проставить значение UTF-8.
- В поле "Разделитель строк" - \r\n.
- В поле "Разделить столбцов" - ;.
- Имя файла указать - Новый.
- В поле "Папка" указать путь до нового CSV файла.
- В поле "С заголовком" проставить чекбокс = true.
- В поле "Результат" указать переменную типа "путь к файлу", в которой будет записан путь до нового файла.
Результат
Программный робот отработал успешно.
Таблица сохранена в CSV. Файл расположен по заданному пути.
Дополнительно: если в действии "Сохранить таблицу в CSV" не проставлен чекбокс "С заголовком", то таблица будет сохранена без заголовка.