Создание таблиц
Таблицы данных - хранилища для любой информации. Данные из таблиц можно выводить в письмо или использовать для сегментации клиентов.
Вы можете посмотреть как используются таблицы данных в реальных проектах на примере одного из наших клиентов.
Таблицы данных находятся в разделе Таблицы меню Данные.
Для создания новой таблицы необходимо задать название, добавить нужные столбцы и их тип данных. Для названия самой таблицы или ее столбцов допустимы только латинские символы в нижнем регистре без пробелов, также цифры и символ '-', '_' (не может начинаться с цифры, '-', '_').
Первичный ключ - используется для уникальности данных в таблице. При добавлении новых строк вручную или через импорт, данные будут проверяться на уникальность именно по этому столбцу. Можно задать несколько первичных ключей, тогда и сверка будет происходить по их комбинации, которая должна быть уникальной.
В таблице, в которой уже есть данные, нельзя изменять/добавлять первичный ключ.
Обязательность столбца - пометка для столбца о том, что при добавлении новых строк вручную или через импорт, это поле должно быть обязательно заполненным, иначе строка не будет добавлена.
Значение по умолчанию - при создании или изменении таблицы вы можете заполнить любой столбец единым значением.
Редактирование таблицы
Для редактирования столбцов в таблице, а также ее копирования или удаления, нажмите на соответствующую иконку при наведении на нужную таблицу. Аналогичные операции можно произвести из деталей таблицы при нажатии кнопки «Действия».
Обратите внимание, что вы не можете изменить тип данных столбца, если в нем уже есть какие-то данные.
Добавление строки вручную
Для добавления строки в таблицу вручную перейдите в ее детали, кликнув по ее названию в списке таблиц.
Далее нажмите на «Добавить новую строку». Заполните поля нужными значениями и нажмите «Создать».
В поисковой строке таблицы вы можете искать нужные данные по любому полю таблицы.
Импорт в таблицу
Чтобы импортировать файл в таблицу данных, необходимо открыть просмотр таблицы и нажать кнопку «Импорт в таблицу»
После загрузки файла необходимо проставить соответствие между столбцами таблицы и столбцами из файла, если это не было сделано автоматически, здесь же можно выбрать столбцы, которые не нужно импортировать
После запуска импорта начнется сверка файла. Чтобы продолжить импорт после завершения сверки, нужно перейти в раздел системы enKod » Импорты, найти в списке нужный импорт и нажать кнопку «Начать импорт».
В окне настройки импорта необходимо выбрать, что сделать с новыми, дублирующими или некорректными строками, если такие были найдены.
Для новых (не найденных по первичному ключу) строк в таблице доступны варианты:
- Добавить - строки будут добавлены в таблицу
- Игнорировать - строки не будут добавлены в таблицу
Для существующих (найденных по первичному ключу) строк в таблице доступны варианты:
- [ВРЕМЕННО НЕДОСТУПНО] Обновить - данные в таблице будут дополнены данными из файла, существующие данные не будут перезаписаны
- Заменить - данные в таблице будут полностью перезаписаны на данные из файла, в том числе на пустые значения, если они есть в файле (при наличии значения по умолчанию - вместо пустоты будет проставлено оно)
- Игнорировать - строки не будут добавлены или изменены
Обратите внимание, что при наличии первичного ключа вы не сможете загрузить в таблицу более одной строки с совпадением по этому ключу.
После нажатия кнопки «Начать импорт» нужно дождаться завершения процесса импорта. Детали импорта можно посмотреть в списке импортов по кнопке «Открыть историю»
Обратите внимание, что некорректные строки хранятся 10 дней, необходимо выгрузить их до момента, указанного в окне истории импорта. Сделать это позже будет нельзя
Добавление строки по API
Ознакомиться со всеми доступными на данный момент методами работы с таблицами данных по API вы можете в соответствующем разделе мануала.
Все строковые и текстовые параметры в запросах (например: дата в формате yyyy-mm-dd, дата-время в формате yyyy-mm-dd hh:mm:ss, емейл в формате [email protected]) необходимо оборачивать в кавычки.
Тип данных
Для импорта и ручного добавления строк допустимы следующие типы данных:
- Число - целые числа, от минус 9 до плюс 9 знаков;
- Дробное число - от 9 знаков до и после запятой, в том числе - отрицательные значения. Для отделения целочисленной части используйте точку, а не запятую, использование запятой приведет к ошибке;
- Email - в формате [email protected], служит для связи между группами рассылок и таблицами данных. Таким образом, если адреса подписчиков будут указаны в полях не с типом «емейл», такую таблицу нельзя будет использовать для сегментации;
- Телефон - строка (из которой будут удалены все лишние символы), допускаются символы «+()-», пробел не допускается;
- Текст - любые символы;
- Логический тип - логическая величина со значениями true/false или 0/1;
- Дата - строго в формате yyyy-mm-dd или в формате timestamp (только для обновления по АПИ) (прим. 1620853200);
- Дата-время - строго в формате yyyy-mm-dd hh:mm:ss или в формате timestamp (только для обновления по АПИ) (прим. 1620853211).
- Форматы «yyyy-mm-dd» и «yyyy-mm-dd hh:mm:ss» не изменяемые. То есть импорт строк с форматом вида «yyyy-mm», «yyyy-mm-dd hh», «yyyy-mm-dd hh:mm» приведет к ошибке.
- При необходимости использовать запятую внутри текстового поля используйте экранирование (двойные кавычки с двух сторон от запятой).
- Разделителями в csv файле могут быть как запятые, так и точки с запятой. Обратите внимание на наличие этих символов в содержимом ячеек, чтобы избежать некорректного разбиения данных на столбцы.
Динамический контент для работы с таблицами данных
Ознакомиться со всеми методами динамического контента для работы с таблицами данных вы можете в этом разделе мануала.
Экспорт таблицы данных
Экспорт таблицы в csv-формате доступен при открытии просмотра таблицы (ЛКМ по названию таблицы в списке) ➔ Действия ➔ Экспорт таблицы