^{Как скачать шаблон миграции данных? Как заполнить в шаблоне информацию о делах и объектах?}

С помощью шаблона миграции данных вы можете переносить в Case.one данные дел и объектов из других систем, не тратя время на ручной ввод, и автоматически создавать карточки объектов и дел определенного типа из заполненного шаблона.

Шаблон миграции данных формируется автоматически для каждого типа объекта в формате *.csv. Вы можете скачать шаблон в конструкторе типов объектов.

Чтобы скачать шаблон импорта объекта:

1. Перейдите в раздел Администрирование — Объекты.
2. Выберите тип объекта из списка.
3. Перейдите на вкладку Настройки конструктора объектов.
4. В блоке Шаблон миграции данных нажмите кнопку  и выберите пункт Скачать.

Название шаблона формируется по маске: Шаблон импорта <Название типа объекта>.csv.

В шаблоне импорта данных типа объекта содержится информация о системных и кастомных полях, которые настроены для выбранного типа объекта на вкладке Основное и на созданных вкладках (вне зависимости от настроек видимости вкладок). 

В шаблоне импорта объекта:

1. Данные полей выгружаются отдельной строкой и формируются по маске: "<Наименование поля> (<Тег>)", где:
   • <Наименование поля> — зависит от типа поля:
     • Для системных полей — наименование поля в отчетах
   • • Для кастомных полей — наименование поля в конструкторе объекта
   • <Тег> — зависит от типа поля:
     • Для системных полей — системные имена полей в механизме отчетов
     • Для кастомных полей — тег поля или идентификатор поля в блоке (если тег не присвоен полю)
2. Данные каждого поля отделены друг от друга разделителем без пробела. Вид разделителя вы можете указать в настройках конфигурации. По умолчанию в качестве разделителя выбрана запятая — ",".
3. Сначала отображаются все системные поля (без учета настроек видимости на вкладке Настройки в блоке Системные поля) типа объекта слева направо: 
   • Стадия объекта
   • Проект
   • Название объекта
   • Ответственный
   • Клиент
   • Описание
4. После системных полей отображаются все кастомные поля (без учета их настроек в типе объекта), начиная с первой строки первого блока вкладки Основное построчно сверху вниз, и далее в том же порядке с созданных вкладок. В шаблон загружаются данные полей с форматом:
   • Гиперссылка
   • Дата
   • Дата и время
   • Логический
   • Справочник
   • Текст
   • Текстовое расширяемое
   • Формула расчета
   • Чекбокс
   • Число
   • Шаблон номера дела
   • Объект—Дело
   • Объект—Объект
   • Объект—Участник
   • Объект—Пользователь

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

• Не изменяйте первую строку файла — выгруженные поля типа объекта должны быть расположены в файле всегда первой строкой.

Мы не рекомендуем вносить изменения в выгруженные поля типа объекта, чтобы не нарушать структуру файла импорта.

• Укажите сведения ваших дел, заполняя информацию о каждом объекте с новой строки в том же порядке, как поля типа объекта в шаблоне.
• Проверьте, что значение каждого поля заключено в кавычки.
• Убедитесь, что между значениями полей вы не добавили пробелы.
• Проверьте, что для разграничения всех значений полей используется разделитель, который указан в настройках конфигурации Case.one (по умолчанию — «,»).
• Заполните все обязательные системные и кастомные поля.

Мы настоятельно рекомендуем заполнять все обязательные кастомные поля, но если нет такой возможности, вы можете удалить заголовок и тег такого поля из файла шаблона.

• Если для поля в шаблоне, которое не обязательно для заполнения (например, Наименование проекта), в переносимом деле нет значения:
  • Внесите пустое значение по маске: ""
  • Поставьте разделитель («,» — по умолчанию)
• Если для поля предусмотрена маска заполнения (например, в текстовом поле предусмотрен ввод только цифр и букв), внесите значение строго по маске.
• Если для поля предусмотрен определенный формат заполнения (например, форматы ФИО пользователя или даты), внесите значение, соблюдая формат.
• Убедитесь что в Case.one предварительно созданы все сущности, значения которых вы указали в файле импорта:
  • Пользователи, которые указаны в поле Ответственный и в полях Объект—Пользователь
  • Участники, которые указаны в поле Клиент и в полях Объект—Участник
  • Стадии в выбранном типе объекта
  • Значения справочника в соответствующих справочниках Case.one
  • Объекты и дела, которые указаны в полях Объект—Объект и Объект—Дело

Все нюансы работы с шаблоном миграции данных и особенности заполнения полей различных форматов вы можете посмотреть в отдельной инструкции: