Создание таблиц
Таблицы данных - хранилища для любой информации. Данные из таблиц можно выводить в письмо или использовать для сегментации клиентов.
Вы можете посмотреть как используются таблицы данных в реальных проектах на примере одного из наших клиентов.
Таблицы данных находятся в разделе Таблицы меню Данные.
Для создания новой таблицы необходимо задать название, добавить нужные столбцы и их тип данных. Для названия самой таблицы или ее столбцов допустимы только латинские символы в нижнем регистре без пробелов, также цифры и символ '-', '_' (не может начинаться с цифры, '-', '_').
Первичный ключ - используется для уникальности данных в таблице. При добавлении новых строк вручную или через импорт, данные будут проверяться на уникальность именно по этому столбцу. Можно задать несколько первичных ключей, тогда и сверка будет происходить по их комбинации, которая должна быть уникальной.
В таблице, в которой уже есть данные, нельзя изменять/добавлять первичный ключ.
Обязательность столбца - пометка для столбца о том, что при добавлении новых строк вручную или через импорт, это поле должно быть обязательно заполненным, иначе строка не будет добавлена.
Значение по умолчанию - при создании таблицы вы можете заполнить любой столбец единым значением, если при добавлении новой строки это поле является пустым. При редактировании существующей таблицы данных вы можете установить значение по умолчанию только для тех столбцов, в которых ещё не заполнена ни одна ячейка.
Редактирование таблицы
Для редактирования столбцов в таблице, а также ее копирования или удаления, нажмите на соответствующую иконку при наведении на нужную таблицу. Аналогичные операции можно произвести из деталей таблицы при нажатии кнопки «Действия».
Добавление строки вручную
Для добавления строки в таблицу вручную перейдите в ее детали, кликнув по ее названию в списке таблиц.
Далее нажмите на «Добавить новую строку». Заполните поля нужными значениями и нажмите «Создать».
В поисковой строке таблицы вы можете искать нужные данные по любому полю таблицы.
Импорт в таблицу
Чтобы импортировать файл в таблицу данных, необходимо открыть просмотр таблицы и нажать кнопку «Импорт в таблицу»
После загрузки файла необходимо проставить соответствие между столбцами таблицы и столбцами из файла, если это не было сделано автоматически, здесь же можно выбрать столбцы, которые не нужно импортировать
После запуска импорта начнется сверка файла. Чтобы продолжить импорт после завершения сверки, нужно перейти в раздел системы 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-формате доступен при открытии просмотра таблицы (ЛКМ по названию таблицы в списке) ➔ Действия ➔ Экспорт таблицы
