Центр документации
Карта сайта

Создай визитку сам!


Самоучитель по интеграции дизайна и настройке Amiro.CMS на примере демонстрационной версии пакета Визитка »


Общая информация об обмене

Обмен данными в CSV формате предоставляет возможность импортировать данные из MS Excel. Для этого необходимо сохранить Excel таблицу в CSV формате:

  1. Меню – Сохранить как
  2. Тип файла – CSV
  3. Во всплывающих предупреждениях нажать «Ок» и «Да».

Сохраненный таким образом CSV файл можно использовать при импорте в Amiro CMS. При этом следует помнить, что порядок столбцов в Excel файле – это порядок столбцов в CSV формате, причем нумерация столбцов в документации начинается с 0. При изменении порядка столбцов в XLS файле, необходимо произвести изменения в настройках Amiro CMS. Как правило, каждая запись - это одна строка в файле.

ВАЖНО! Все строки файла импорта должны содержать одинаковое число полей, равное количеству элементов для обмена, заданных в настройках модуля обмена данными.

ВАЖНО! В файле должно быть не менее 6 столбцов для обычного CSV-импорта, 2 столбца для ускоренного.

При сохранении файла из другого приложения или формирования программным кодом из базы данных необходимо соблюдать следующие правила формата CSV:

Разделителем записей является символ перевода строки (ASCII/LF=0x0A), или пары возврат каретки/перевод строки (ASCII/CRLF=0x0D 0x0A).
В некоторых случаях, поля могут содержать вложенные разрывы строк (см. ниже), таким образом запись может содержать более одной строки.

Поля разделены символом точка с запятой ";" (предпочтительно, по умолчанию) или ",".
Пример: John;Doe;120 any st.;"Anytown; WW";08123

Поля с вложенными символами точка с запятой должны быть ограничены символами двойной кавычки. В вышеупомянутом примере "Anytown; WW" должно было быть ограничено символами двойной кавычки, потому что это поле имеет вложенный символ точка с запятой.

Поля, которые содержат символы двойной кавычки, должны быть окружены двойными кавычками, и вложенные двойные кавычки должны каждый быть представлены парой последовательных двойных кавычек.
Так, John "Da Man" Doe должно быть преобразовано в "John ""Da Man"" Doe"; 120 any st.;...

Поле, которое содержит вложенные разрывы строки, должно быть окружено двойными кавычками.
Так:
Поле 1: Conference room 1
Поле 2: John,
Please bring the M. Mathers file for review
-J.L.
Поле 3: 10/18/2002
...

должно быть преобразовано в:
Conference room 1; "John,
Please bring the M. Mathers file for review
-J.L.";10/18/2002;...
Заметьте, что это - одна(единая) запись CSV, даже при том, что она содержит более чем одну строку в файле CSV. Это работает, потому что разрывы строки вложены в двойных кавычках поля.

Поля, начинающие или заканчивающие символом пробела, должны быть ограничены символами двойной кавычки.
Чтобы сохранить пробелы вокруг фамилии выше: John ;" Doe ";...

Версия для печати

Установка и настройка Руководство пользователя Интеграция дизайна Разработчикам (API)
 2000 – 2019 © Amiro.CMS Все права защищены.