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

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

В шаблон миграции данных не выгружаются:

Следующие форматы полей:
- Встраиваемый код
- Данные
- Кнопка
- Разделитель
- Сообщение
- Объект—Документ
Сведения из системных вкладок (События, Задачи, Участники и т.д.)
Сведения из блоков:
- Ссылки
- Изображения
- Таблица
Системное поле Тип объекта

Поля с доступными форматами выгружаются, как из обычных строк и блоков, так и из мультистрок и мультиблоков.

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

Данные полей выгружаются отдельной строкой и формируются по маске: "<Наименование поля> (<Тег>)", где:
- <Наименование поля> — зависит от типа поля:
  - Для системных полей — наименование поля в отчетах
  - Для кастомных полей — наименование поля в конструкторе объекта
- <Тег> — зависит от типа поля:
  - Для системных полей — системные имена полей в механизме отчетов
  - Для кастомных полей — тег поля или идентификатор поля в блоке (если тег не присвоен полю)
- Пример:
  - Системное поле Стадия отображается в шаблоне как: "Стадия (Project_Stage_Name)"
  - Кастомное поле Дата подписания с тегом — "Дата подписания (tag_1)"
  - Кастомное поле Вид документа с идентификатором (без тега) — "Вид документа (4b0f39b0-dbca-49b6-f82b-08dcf202860f)"
Данные каждого поля отделены друг от друга разделителем без пробела. Вид разделителя вы можете указать в настройках конфигурации. По умолчанию в качестве разделителя выбрана запятая — ",".
Сначала отображаются все системные поля (без учета настроек видимости на вкладке Настройки в блоке Системные поля) типа объекта слева направо:
- Стадия объекта
- Проект
- Название объекта
- Ответственный
- Клиент
- Описание
После системных полей отображаются все кастомные поля (без учета их настроек в типе объекта), начиная с первой строки первого блока вкладки Основное построчно сверху вниз, и далее в том же порядке с созданных вкладок. В шаблон загружаются данные полей с форматом:
- Гиперссылка
- Дата
- Дата и время
- Логический
- Справочник
- Текст
- Текстовое расширяемое
- Формула расчета
- Чекбокс
- Число
- Шаблон номера дела
- Объект—Дело
- Объект—Объект
- Объект—Участник
- Объект—Пользователь

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

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

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

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

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

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

Особенности заполнения системных полей

Предусмотрены следующие особенности заполнения системных полей:

Стадия:
- При заполнении учитываются: регистр, пробелы, символы
- Указанная стадия присутствует в типе объекта в Case.one
Проект — если проект указан, он должен быть создан в Case.one в соответствующем разделе объектов.
Название — поле обязательно для заполнения, длина названия объекта не должна превышать 400 символов.
Ответственный — можно указать ФИО или email пользователя:
- При заполнении учитываются: регистр, пробелы, символы
- ФИО пользователя указано согласно настройкам ФИО в аккаунте, например, если в настройках аккаунта выбран формат:
  - И. Фамилия, в файле значение поля должно соответствовать формату: "А. Иванов"
  - Имя Отчество Фамилия, в файле значение поля должно соответствовать формату: "Алексей Иванович Иванов"
- Указанный пользователь есть в Case.one
- ФИО пользователя в Case.one и файле импорта полностью совпадают
Клиент:
- При заполнении учитываются: регистр, пробелы, символы
- ФИО клиента указано согласно настройкам формата ФИО в аккаунте
- Указанный клиент есть в Case.one
- ФИО клиента в Case.one и файле импорта полностью совпадают
Описание — можно прописать в файле импорта теги разметки HTML. Если указаны валидные теги, в результате импорта значение в поле отобразится с форматированием.

Вы можете указать пустые значения для всех системных полей, кроме поля Название.

Особенности заполнения кастомных полей

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

Гиперссылка — нет ограничений на количество символов.
Дата:
- Указывается строго по маске: yyyy-mm-dd
- В карточке объекта отображается с учетом настроек формата даты в настройках аккаунта
Дата и время:
- Указывается строго по маске: yyyy-mm-ddTHH:MM:SS.FFFZ в UTC
- В карточке объекта отображается с учетом настроек формата даты и времени в настройках аккаунта
Логический — в файле импорта можно указать (без учета регистра):
- Для значения Да: Yes, Да, true, 1
- Для значения Нет: No, Нет, false, 0
Справочник:
- При заполнении учитываются: регистр, пробелы, символы
- Указанное значение справочника есть в справочнике Case.one
Текст — если для поля предусмотрена маска заполнения, значение указывается по маске.
Текстовое расширяемое — можно прописать в файле импорта теги разметки HTML. Если указаны валидные теги, в результате импорта значение в поле отобразится с форматированием.
Формула расчета — ввод целого или дробного числа (дробная часть отделяется от целого числа точкой или запятой).
Чекбокс:
- Поле обязательно для заполнения вне зависимости от его настроек в типе объекта
- В файле импорта можно указать (без учета регистра):
  - Для значения Да: Yes, Да, true, 1
  - Для значения Нет: No, Нет, false, 0
Число — ввод целого или дробного числа (дробная часть отделяется от целого числа точкой или запятой).
Шаблон номера дела:
- Значение в файле может отличаться от установленного шаблона нумерации в настройках поля в типе объекта
- Нет ограничений на количество символов
Объект—Дело и Объект—Объект:
- При заполнении учитываются: регистр, пробелы, символы
- Указанные объекты и дела есть в Case.one
- Название объекта или дела в Case.one и файле импорта полностью совпадают
Объект—Участник и Объект—Пользователь:
- При заполнении учитываются: регистр, пробелы, символы
- ФИО участника и/или пользователя указано согласно настройкам формата ФИО в аккаунте
- Указанные участники и/или пользователи есть в Case.one
- ФИО участника и/или пользователя в Case.one и файле импорта полностью совпадают

Вы можете указать пустые значения для всех кастомных необязательных полей. Если для таких полей в настройках типа объекта предусмотрены значения по умолчанию, в результате импорта поля будут заполнены в карточке объекта.

С помощью шаблона импорта данных вы также можете заполнять поля, которые находятся в мультистроках или мультиблоках. При этом недоступно перенести значения полей, если они одновременно находится и мультистроке, и в мультиблоке — такие поля останутся незаполненными в карточках объектов, созданных с помощью файла импорта.

Значения полей из мультиблоков или мультистрок должны быть указаны в файле шаблона импорта данных через разделитель, который настроен в файле настроек конфигурации Case.one для разграничения значений полей из мультиблоков и мультистрок (по умолчанию — ";"):
- Если указаны значения из поля мультиблока — каждое значение будет добавлено в отдельный блок, начиная с первого значения
- Если указаны значения из поля мультистроки в стандартном блоке — каждое значение будет добавлено в отдельную строку, начиная с первого значения
Если в файле импорта при перечислении значений поля из мультиблока или мультистроки между двумя разделителями не указано значение, поле в карточке объекта заполнено не будет.
Если в файле импорта в значении поля, которое не находится в мультистроке или мультиблоке, указан разделитель значений мультистрок/мультиблоков (по умолчанию — ";"), такое значение будет перенесено вместе с символом разделителя с учетом особенностей переноса различных форматов полей.
Поля в мультиблоке будут заполнены вне зависимости от условий видимости этого блока.
Если в объекте уже создан дополнительный мультиблок блок для загружаемого значения, значение будет добавлено или обновлено в существующем мультиблоке.

Справочный центр Case.one

Заполнение шаблона миграции данных объектов

Особенности заполнения системных полей

Особенности заполнения кастомных полей