Перейти к основному содержимому
Версия: 1.20.1

Трансформация данных при импорте

В SimpleOne данные из источника импорта можно преобразовать перед записью в поля целевой таблицы.

Например, максимальная длина поля типа Phone составляет 15 символов, а данные из источника импорта содержат значение +7 (495)-181-85-20, что превышает максимально допустимую длину. Эти данные необходимо преобразовать, чтобы сохранить только числа в целевом значении.

Чтобы настроить преобразование и заполнить поле Телефон, в соответствующей записи таблица Соотношения полей укажите следующий скрипт для фильтрации значения номера телефона:

answer = (function transformEntry(source) {
const parsedDigits = source.imp_telephonenumber.match(/\d/g);
return parsedDigits ? `+${parsedDigits.join("")}` : null; // формат E.164 ИЛИ null
})(source);

imp_telephonenumber– имя колонки, содержащей номер телефона во временной _imp_ таблице. Эта таблица содержит данные из источника импорта.

Трансформация для полей типа Reference


Перед трансформацией сначала необходимо импортировать таблицы ссылочных полей.

Например, вам нужно преобразовать список компаний, в записях которых есть генеральные директора. На экземпляре поле CEO в целевой таблице Компания имеет тип Reference. Значения, хранящиеся в поле, представляют собой ID записей из таблицы Пользователей.

Для выполнения преобразования выполните следующие шаги:

  1. Импортируйте список пользователей. Этот список должен содержать пользователей, указанных в поле Генеральный директор.
  2. Импортируйте список компаний. В источнике импорта поле Генеральный директор содержит полное имя пользователя.
  3. Чтобы заполнить поле Генеральный директор, в связанной записи соотношения полей укажите следующий скрипт. Он преобразует полное имя пользователя в соответствующий ID записи пользователя из таблицы Пользователей.
answer = (function transformEntry(source) {
const user = new SimpleRecord('user');
user.get('display_name', source.imp_ceo);
return user.sys_id;
})(source);

  • user – системное имя существующей на экземпляре таблицы.
  • display_name – системное имя колонки, которая содержит полное имя пользователя (эта колонка существует в таблице Пользователи).
  • imp_ceo – системное имя колонки, которая содержит полное имя пользователя (эта колонка существует во временной _imp_ таблице).

Трансформация для полей типа Choice


Чтобы заполнить поля типа Choice при импорте данных, сначала необходимо создать опцию выбора в целевой колонке типа Choice.

Например, новая запись опции для колонки Статус занятости в таблице Сотрудники имеет следующее значение:

{instance address}/record/sys_choice?field_table_id=156873090301469473&field_language=en&field_column_id=156873090304832536&field_title=Worker&field_value=worker&field_order=100

В процессе импорта соответствующее значение data_value должно быть найдено с помощью импортированного отображаемого значения display_value.

Следующий скрипт преобразует отображаемое значение типа занятости в соответствующую опцию выбора в базе данных:

answer = (function transformEntry(source) {

// import source value : sys_choice value
const employeeTypeDict = {
"Worker": "worker",
"Employee": "employee",
"Self-employed": "self_employed",
"Director": "director",
"Contractor": "contractor"
}
return employeeTypeDict[source.imp_status] || source.imp_status
})(source);

imp_status – системное имя колонки, которая содержит тип занятости сотрудника во временной _imp_ таблице.