История страницы
...
Table to CSV Version 21 (Net)
Группа действийAction group: ТаблицыTables
Описание
Данное действие предназначено для сохранения таблицы в формате CSV.
...
Description
The action saves tables in the CSV format
Action icon
...
Settings
Property |
---|
Description |
---|
Type |
---|
Filling example |
---|
Mandatory |
---|
field |
---|
Parameters |
---|
Таблица
Data table | Table for which the action will be performed. | Robin.DataTable |
Yes |
Кодировка
Encoding | Encoding of the resulting file. UTF-8 is default. | Robin.String |
No |
Разделитель строк
Line separator | The character used to separate the lines. Default is rn | Robin.String |
No |
Разделитель столбцов
Column separator | Character used to separate the columns in the source file. The default is «;». | Robin.String |
No |
Имя файла
File name | Name of the file (without extension) to be created. The extension .csv will be added automatically by the action. | Robin.String |
Yes |
Папка
Folder | Folder path where the created file will be saved. | Robin.FolderPath | C:\doc\img |
Yes |
Heading |
If true, the table header will be inserted into the document along with its rows. | Robin.Boolean | true |
No |
Results |
---|
Результат
Result | Path to the created CSV file. | Robin.FilePath |
...
Special conditions of use
Для параметра "С заголовком":
- При значении "true", действие запишет в документ строку заголовка исходной таблицы в качестве первой строки вместе с остальными основными строками таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 3 строки.
- При "false", действие запишет в документ только основные строки с содержимым исходной таблицы. Пример: в Студии указано, что в таблице "Столбцов: 3; строк: 2", при вставке в документе окажутся заполнены 3 столбца и 2 строки.
Пример использования
Задача: имеется Excel файл с таблицей . Необходимо ее сохранить в формате CSV с заголовком на рабочий стол.
Решение: воспользоваться действиями "Открыть", "Взять таблицу", "Сохранить таблицу в CSV".
Реализация:
- Собрать схему робота, состоящую из действий:
- Настроить параметр для действия "Открыть".
- Настроить параметры для действия "Взять таблицу".
- Настроить параметры для действия "Сохранить таблицу в CSV":
В поле "Таблица" указать переменную типа "Таблица" с данными.
В поле "Кодировка" проставить значение UTF-8.
В поле "Разделитель строк" - \r\n
В поле "Разделить столбцов" - ;
Имя файла указать - Новый;
В поле "Папка" указать путь до нового CSV файла;
В поле "С заголовоком" проставить чек-бокс = true.
В поле "Результат" указать переменную типа "путь к файлу", в которой будет записан путь до нового файла.
Результат:
Программный робот отработал успешно.
Таблица сохранена в CSV. Файл расположен по заданному пути.
Дополнительно: если в действии "Сохранить таблицу в CSV" не проставлен чек-бокс "С заголовком", то таблица будет сохранена без заголовка.
For a "With Header" parameter:
- When “true”, the action will write the header row of the source table into the document as the first row along with the rest of the main rows of the table. Example: the Studio specifies that the table “Columns: 3; rows: 2”, when pasted into the document, 3 columns and 3 rows will be filled in.
- If “false”, the action will only write to the document the main rows with the contents of the source table. Example: the Studio specifies that the table “Columns: 3; rows: 2”, when inserted into the document, 3 columns and 2 rows will be filled.
Example of use
Task:
You have an Excel file with the table
Save it in the CSV format with the heading to the workspace.
Solution
Use the "Open", "Get table", "Table to CSV" actions.
Implementation
- Assemble a robot scheme with the actions:
- Set the "Open" action parameters.
- Set the "Get table" action parameters.
- Set the "Table to CSV" action parameters:
In the “Table” field, specify a variable of the “Table” type with data.
In the "Encoding" field specify a UTF-8 value.
In the “Line Separator” field, enter \r\n.
In the "Line separate" field enter ;
In the "File name" enter "New".
In the "Folder" field set the path to the new CSV file.
In the "Heading" check the box = true.
In the "Result" field set the "Path to file" variable type that will have the path to the new file.
Result
The program robot completed successfully.
The table is saved in CSV. The file is located at the specified path.
Optional: if the “Heading” checkbox is not checked in the “Table to CSV” action, the table will be saved without a heading.