Импорт данных

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

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

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

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

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

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

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

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


Если в настройках конфигурации был изменен формат разделителя (подробнее см. Заполнение шаблона миграции данных объектов), обязательно пересохраните тип объекта, чтобы новый формат разделителя применился в файле шаблона.


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

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

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

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

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


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

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

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

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

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


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

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


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

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

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

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

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


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

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

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

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


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

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

Импорт объектов

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

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

  • Название импорта
  • Тип — тип объекта для импорта
  • Дата начала — дата загрузки файла импорта
  • Статус:
    • В процессе – Х% — статус с процентом выполнения загрузки отображается во время выполнения импорта
    • Завершен — статус отображается после завершения загрузки файла импорта

Чек-лист подготовки к импорту

Прежде чем приступить к загрузке файла импорта убедитесь, что:

  1. Параметры разделителей полей и значений полей мультиблоков и мультистрок, указанные для шаблона импорта в настройках конфигурации Case.one и в самом файле импорта, совпадают:
    • Разделитель для полей (по умолчанию — ",")
    • Разделитель для значений полей мультиблоков и мультистрок (по умолчанию — ";")
  2. В файле шаблона импорта не нарушена структура (подробнее — Заполнение шаблона миграции данных объектов):
    • Соблюдены базовые правила формирования файла в формате *.csv
    • Все значения заключены в кавычки (если они использовались)
    • Не добавлены пробелы между значениями полей
    • Выгруженные из типа объекта системные и кастомные поля отображаются первой строкой
    • Количество значений полей соответствует количеству полей типа объекта в шаблоне
    • Соблюдены правила заполнения полей различных форматов (подробнее — Заполнение шаблона миграции данных объектов)
    • Заполнены все обязательные системные и кастомные поля
    • Количество строк в файле не превышает максимально разрешенное значение, которое указано в настройках конфигурации Case.one (по умолчанию — 10000 строк)
  3. В Case.one заранее созданы все сущности, значения которых указаны в файле импорта: типы объектов и дел, пользователи, участники, справочники, карточки объектов и дел.
  4. Для типа объекта корректно настроены правила определения дубликатов, поскольку при автоматическом создании карточек объектов в результате импорта учитываются параметры определения дубликатов.
  5. Ваша подписка Case.one позволяет создать нужное количество дел и объектов.
  6. В группах пользователей настроен автоматический доступ к делам, чтобы созданные карточки объектов и дел были сразу доступны заинтересованным сотрудникам.

Загрузка файла импорта

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

Чтобы загрузить файл импорта:

  1. Нажмите кнопку .
  2. Заполните поля формы нового импорта:
    • Введите название импорта (максимальное количество символов — 450)
    • Выберите тот тип объекта из списка, шаблон импорта которого был заполнен:
      • В списке отображаются все типы объектов с указанием класса объекта
      • Возможен поиск типа объекта
      • Доступно выбрать только одно значение
    • Добавьте файл импорта
  3. Нажмите кнопку Импортировать. Будут выполнены проверки файла и импорт данных объектов из файла.

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


Если успешно пройдены все проверки и выполнен импорт:

  1. Статус импорта изменится на Завершен, вы сможете скачать файл лога импорта.
  2. В разделе Администрирование — Действия в системе будут добавлены записи о создании карточек объектов от имени системного пользователя Service Workflow.
  3. В ленте событий отобразятся записи о создании карточек объектов от имени системного пользователя Service Workflow.
  4. В созданных объектах и делах будет заполнена информация из файла импорта.

Если на инстансе настроены сценарии автоматизации с оператором Ожидать — Создание объекта/дела, в результате создания объектов через импорт такие сценарии не будут срабатывать.


Особенности выполнения импорта

Одновременно вы (или другой пользователь) можете запустить только одну сессию импорта — запуск сразу нескольких сессий импорта невозможен.

Если импорт данных еще не завершен, при попытке добавления новой сессии импорта отобразится уведомление: "Идет процесс импорта данных. Пожалуйста, дождитесь окончания импорта и попробуйте снова".


Отменить уже запущенный импорт объектов недоступно.


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

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

Логика заполнения системных полей объектов

При заполнении системных полей:

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

Системные поля заполняются по следующей логике:

  • Стадия объекта — карточка объекта будет создана в начальной стадии, если:
    • Значение стадии не заполнено
    • В первой строке файла нет заголовка и тега стадии
    • Указано значение стадии, которого нет в типе объекта
    • Найдено две стадии с одинаковым названием
  • Проект — карточка объекта будет создана вне проекта, если:
    • Значение проекта не заполнено
    • В первой строке файла нет заголовка и тега проекта
    • Найдено два проекта с одинаковым названием
    • Указано значение проекта, которого нет для выбранного типа объекта
  • Название объекта:
    • Если в первой строке файла нет заголовка и тега для поля Название, импорт выполнен не будет
    • Если значение названия не заполнено, карточка такого объекта создана не будет, импорт остальных строк с данными объектов продолжится
    • Если длина значения поля Название превышает 400 символов, карточка такого объекта создана не будет, импорт остальных строк с данными объектов продолжится
  • Ответственный:
    • В карточке объекта будет указан ответственным системный пользователь Service Workflow, если:
      • В первой строке файла нет заголовка и тега для поля Ответственный
      • Значение для поля Ответственный не указано
      • Указан пользователь, которого нет в Case.one
      • Найдено несколько (2 и более) пользователей с идентичными данными
    • Если значение поля Ответственный заполнено, выполняется поиск указанного пользователя сначала по адресу электронной почты, затем по ФИО с учетом формата ФИО в настройках аккаунта:
      • Если пользователь найден, он будет указан ответственным в карточке объекта
      • Если пользователь не найден, ответственным в карточке объекта будет назначен системный пользователь Service Workflow
  • Клиент:
    • В карточке объекта поле будет не заполнено, если:
      • В первой строке файла нет заголовка и тега для поля Клиент
      • Значение для поля Клиент не указано
      • Указан участник, которого нет в Case.one
      • Найдено несколько (2 и более) участников с идентичными данными
    • Если значение поля Клиент заполнено, выполняется поиск указанного участника сначала по ИНН (10 или 12 символов), затем по наименованию (для организаций или ИП) или по ФИО с учетом формата ФИО в настройках аккаунта:
      • Если участник найден, он будет указан в качестве клиента в карточке объекта
      • Если участник не найден, поле Клиент не будет заполнено
  • Описание — поле не будет заполнено, если в первой строке файла нет заголовка и тега для поля Описание или не указано значение поля.

Логика заполнения системных полей участников

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

  • Название организации — поле обязательно для заполнения.
  • ИНН — при заполнении учитываются количество цифр.
  • КПП, ОГРН, ОКПО — выгрузка системных полей в шаблон зависит от настроек видимости системных полей для карточки участника в БД — если отображение полей отключено, они не выгружаются в шаблон
  • Организационно-правовая форма.
  • Телефон — указывается по маске: +ХХХХХХХХ, где "Х" — цифра, "+" — необязательный символ, другие символы недоступны для ввода.
  • Дополнительный телефон.
  • Почта — указывается по маске: ХХХ@УУУ, где:
    • Х — цифры, буквы (латиница или кириллица) или символы  (+, -, _ или .)
    • У — цифры, буквы (латиница или кириллица) или символы  (- или .)
  • Дополнительная электронная почта.
  • Сайт.
  • Адрес.

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

  • Имя — поле обязательно для заполнения.
  • Отчество.
  • Фамилия — поле обязательно для заполнения.
  • ИНН — при заполнении учитываются количество цифр.
  • Организация.
  • Дата рождения — указывается строго  по маске: yyyy-MM-dd.
  • Должность.
  • Телефон — указывается по маске: +ХХХХХХХХ, где "Х" — цифра, "+" — необязательный символ, другие символы недоступны для ввода.
  • Дополнительный телефон.
  • Почта — указывается по маске: ХХХ@УУУ, где:
    • Х — цифры, буквы (латиница или кириллица) или символы  (+, -, _ или .)
    • У — цифры, буквы (латиница или кириллица) или символы  (- или .)
  • Дополнительная электронная почта.
  • Сайт.
  • Адрес.

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

При заполнении кастомных полей:

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

Кастомные поля заполняются по следующей логике:

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

Описание проверок при импорте данных

При выполнении импорта предусмотрено несколько типов проверок:

  • Проверки целостности файла импорта
  • Проверки настроек Case.one

Проверки целостности файла импорта

Сразу после запуска импорта выполняются проверки целостности файла импорта. Если хотя бы одна из проверок целостности файла завершилась с ошибкой:

  • Импорт прекращается;
  • Запись о сессии импорта не будет добавлена в раздел Импорт.

Проверки выполняются до выявления первой ошибки:

  1. Проверка формата файла импорта — если загружаемый файл не соответствует формату *.csv, отобразится ошибка: «Недопустимый формат файла. Разрешенный формат: csv».
  2. Проверка корректно заполненного файла в формате *.csv (подробнее см. описание валидного формата *.csv), включая проверку количества выгруженных полей типа объекта с количеством значений полей в каждой строке с заполненными данными дел.
  3. Проверка размера загружаемого файла — если размер файла превышает 100 Мб, отобразится ошибка: «Превышен максимальный размер файла. Максимальный размер файла не должен превышать 100 MB».
  4. Проверка количества строк в файле — если количество строк превышает максимально разрешенное значение, которое указано в настройках конфигурации Case.one (по умолчанию — 10000 строк), отобразится ошибка: «Произошла ошибка. Превышено максимальное количество строк в файле: N» (N — максимальное количество строк).

Проверки настроек Case.one

Во время импорта также будут выполняться проверки настроек Case.one:

  1. Проверка наличия дубликатов объектов или дел:
    • В файл лога будет записана ошибка при выявлении хотя бы одного дубликата объекта, если в типе объекта, для которого загружается файл импорта, установлен запрет на создание дубликатов
    • Объект создан не будет
  2. Проверка на максимальное количество объектов по подписке — если в процессе импорта было достигнуто максимальное количество дел по подписке:
    • В лог будет записана ошибка
    • Импорт будет прерван
    • Остальные объекты (превышающие разрешенное количество по подписке) созданы не будут

Просмотр файла лога импорта

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

Чтобы посмотреть результаты выполнения импорта:

  1. Выберите сессию импорта в разделе Администрирование — Импорт.
  2. Нажмите кнопку  и выберите пункт Скачать лог.

Название файла формируется автоматически по маске: ImportLog <Название импорта> <Дата начала импорта>.txt.

В файл лога записывается следующая информация:

  • Этапы процесса импорта данных из файла:
    • Старт импорта данных <Название импорта> из файла <идентификатор файла> для типа дела <идентификатор типа дела>
    • Начало загрузки данных из файла: <идентификатор файла>
    • Завершение импорта:
      • Импорт данных из файла <идентификатор файла> завершен. Всего загружено строк: N, где N — количество строк с данными объектов
      • Импорт данных из файла <идентификатор файла> завершился с ошибкой: <сведения об ошибке>
  • Результат операции по созданию объекта для каждой строки в файле импорта:
    • Если в результате обработки строк удалось создать объект, отображается запись: На основании данных из строки A успешно создан объект, где А — номер строки
    • Если во время импорта выявлены ошибки заполнения полей, указываются детали ошибки
  • Итоговый результат импорта объекта:
    • Если в результате импорта были созданы карточки объектов/дел, отображается запись: Импорт данных завершен со статусом Completed. Всего обработано строк: N, где N — количество дел, данные которых были добавлены в файл одной строкой
    • Если в результате импорта не удалось создать объекты/дела, отображается запись: Импорт данных завершен со статусом Failed. Всего обработано строк: N, где N — количество дел, данные которых были добавлены в файл одной строкой
Тип ошибкиОписаниеПоля
Не заполнено обязательное поле Ошибка: для указанного в строке {номер строки} поля {id/тег поля} не удалось найти обработчик значения— Обязательное кастомное поле любого формата
— Системное поле Название объекта
Если в Case.one не найдено значение из файлаОшибка: указанное в файле импорта в строке {номер строки} значение для поля {id/тег поля} не найдено в системеСсылочные поля:
Стадия
Проект
Ответственный
Клиент
Справочник
Объект—Дело
Объект—Объект
Объект—Участник
Объект—Пользователь
Если в типе объекта найдено 2 и более одинаковых значений, указанных в файлеОшибка: для поля {id/тег поля} в строке {номер строки} в системе найдены 2 или более одинаковых значений
Если значение в файле импорта заполнено в некорректном форматеОшибка: некорректный формат данных в файле импорта в строке {номер строки} для поля {id/тег поля}Поля:
Дата
Дата и время
Логический
Текст
Формула расчета
Чекбокс
Число 
Если значение в файле импорта соотносится с полем, которое в объекте расположено в мультистроке и в мультиблокеОшибка: указанное в строке {номер строки} поле {id/тег поля} имеет неподдерживаемый формат поляЛюбое поле, которое одновременно находится в мультистроке и в мультиблоке
Если для значения в файле импорта не найдено поле с соответствующим тегом или идентификаторомОшибка: указанное в файле импорта в строке {номер строки} значение для поля {id/тег поля} не найдено в типе делаЛюбой формат полей