Как скачать шаблон миграции данных объектов и дел?
С помощью шаблона миграции данных объектов вы можете переносить в Case.one данные дел и объектов из других систем, не тратя время на ручной ввод, и автоматически создавать карточки объектов и дел определенного типа из заполненного шаблона.
Шаблон миграции данных формируется автоматически для каждого типа объекта в формате *.csv. Вы можете скачать шаблон в конструкторе типов объектов.
Чтобы скачать шаблон импорта объекта:
Перейдите в раздел Администрирование — Объекты.
Выберите тип объекта из списка.
Перейдите на вкладку Настройки конструктора объектов.
В блоке Шаблон миграции данных нажмите кнопку и выберите пункт Скачать.
Название шаблона формируется по маске: Шаблон импорта <Название типа объекта>.csv.
В шаблоне импорта данных типа объекта содержится информация о системных и кастомных полях, которые настроены для выбранного типа объекта на вкладке Основное и на созданных вкладках (вне зависимости от настроек видимости вкладок).
Если в типе объекта есть несохраненные изменения, они не попадут в шаблон при скачивании.
Если в настройках конфигурации был изменен формат разделителя (подробнее см. Заполнение шаблона миграции данных объектов), обязательно пересохраните тип объекта, чтобы новый формат разделителя применился в файле шаблона.
Заполнение шаблона миграции данных объектов
Как заполнить в шаблоне информацию о делах и объектах?Какие особенности предусмотрены при заполнении различных типов полей?
В шаблоне импорта данных типа объекта содержится информация о системных и кастомных полях, которые настроены для выбранного типа объекта на вкладке Основное и на созданных вкладках (вне зависимости от настроек видимости вкладок).
В шаблон миграции данных не выгружаются:
Следующие форматы полей:
Встраиваемый код
Данные
Кнопка
Разделитель
Сообщение
Объект—Документ
Сведения из системных вкладок (События, Задачи, Участники и т.д.)
Сведения из блоков:
Ссылки
Изображения
Таблица
Системное поле Тип объекта
Поля с доступными форматами выгружаются, как из обычных строк и блоков, так и из мультистрок и мультиблоков.
В шаблоне импорта объекта:
Данные полей выгружаются отдельной строкой и формируются по маске: "<Наименование поля> (<Тег>)", где:
<Наименование поля> — зависит от типа поля:
Для системных полей — наименование поля в отчетах
Для кастомных полей — наименование поля в конструкторе объекта
<Тег> — зависит от типа поля:
Для системных полей — системные имена полей в механизме отчетов
Для кастомных полей — тег поля или идентификатор поля в блоке (если тег не присвоен полю)
Пример:
Системное поле Стадия отображается в шаблоне как: "Стадия (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 данные участников физических лиц, организаций и ИП из других систем, не тратя время на ручной ввод, и автоматически создавать карточки участников из заполненного шаблона.
Перейдите в раздел Администрирование — Системные объекты.
Выберите значение Участник в фильтре Тип объекта.
Выберите тип участника: Участник ▪ Организация или Участник ▪ Физическое лицо.
Перейдите на вкладку Настройки конструктора системных объектов.
В блоке Шаблон миграции данных нажмите кнопку и выберите пункт Скачать.
Название шаблона формируется по маске: Шаблон импорта <Название типа контакта>.csv.
В шаблоне импорта данных контактов содержится информация обо всех системных полях и дополнительных атрибутах, которые настроены для выбранного типа участника.
Если для типа участника есть несохраненные дополнительные атрибуты, они не попадут в шаблон при скачивании.
Если в настройках конфигурации был изменен формат разделителя (подробнее см. Заполнение шаблона миграции данных контактов), обязательно пересохраните тип участника, чтобы новый формат разделителя применился в файле шаблона.
Заполнение шаблона миграции данных контактов
Как заполнить в шаблоне информацию об участниках?Какие особенности предусмотрены при заполнении различных типов полей?
В шаблоне импорта данных участников ФЛ или организаций содержится информация обо всех системных полях и дополнительных атрибутах, которые настроены для выбранного типа участника.
В шаблон миграции данных контактов не выгружаются:
Поле с информацией о типе участника (физическое лицо или организация)
Данные из остальных вкладок карточки участника
Поле LEDES Client Id
В шаблоне импорта контактов:
Данные полей выгружаются отдельной строкой и формируются по маске: "<Наименование поля> (<Тег>)", где:
<Наименование поля> — зависит от типа поля:
Для системных полей — наименование поля в отчетах
Для полей доп. атрибутов — наименование поля в конструкторе объекта
<Тег> — зависит от типа поля:
Для системных полей — системные имена полей в механизме отчетов
Для доп. атрибутов — тег поля или идентификатор поля в блоке (если тег не присвоен полю)
Пример:
Системное поле Стадия отображается в шаблоне как: "Стадия (Project_Stage_Name)"
Кастомное поле Дата подписания с тегом — "Дата подписания (tag_1)"
Кастомное поле Вид документа с идентификатором (без тега) — "Вид документа (4b0f39b0-dbca-49b6-f82b-08dcf202860f)"
Данные каждого поля отделены друг от друга разделителем без пробела. Вид разделителя вы можете указать в настройках конфигурации. По умолчанию в качестве разделителя выбрана запятая — ",".
Сначала отображаются все системные поля слева направо:
Выгрузка системных полей КПП, ОГРН, ОКПО в шаблон зависит от настроек видимости системных полей для карточки участника в БД — если отображение полей отключено, они не выгружаются в шаблон
Выгрузка ФИО ФЛ не зависит от настроек ФИО в разделе Администрирование — Аккаунт (ФИО выгружается всегда)
После системных полей отображаются все настроенные доп. атрибуты, начиная с первой строки блока Дополнительно слева направо и далее построчно сверху вниз.
В шаблон загружаются данные полей доп. атрибутов с форматом:
Гиперссылка
Дата
Дата и время
Логический
Справочник
Текст
Текстовое расширяемое
Чекбокс
Число
Шаблон номера дела
Объект-Дело
Объект-Объект
Объект-Участник
После скачивания шаблона импорта внесите в файл данные участников, соблюдая следующие принципы заполнения:
Не изменяйте первую строку файла — выгруженные поля типа участника должны быть расположены в файле всегда первой строкой.
Мы не рекомендуем вносить изменения в выгруженные поля типа участника, чтобы не нарушать структуру файла импорта.
Укажите сведения участников, заполняя информацию о каждом участнике с новой строки в том же порядке, как поля типа участника в шаблоне.
По умолчанию значение каждого поля заключено в кавычки — вы можете указать значения без кавычек, например, если необходимо сформировать файл CSV из XLSX.
Убедитесь, что между значениями полей вы не добавили пробелы.
Проверьте, что для разграничения всех значений полей используется разделитель, который указан в настройках конфигурации Case.one (по умолчанию — ",").
Заполните все обязательные системные поля и дополнительные атрибуты.
Мы настоятельно рекомендуем заполнять все обязательные доп. атрибуты, но если нет такой возможности, вы можете удалить заголовок и тег такого доп. атрибута из файла шаблона.
Если для доп. атрибута, которое не обязательно для заполнения (например, Уставной капитал), в переносимом деле нет значения:
Для участников с типом Организация предусмотрены следующие особенности заполнения системных полей:
Название организации — поле обязательно для заполнения.
ИНН — при заполнении учитываются количество цифр.
КПП, ОГРН, ОКПО — выгрузка системных полей в шаблон зависит от настроек видимости системных полей для карточки участника в БД — если отображение полей отключено, они не выгружаются в шаблон
Организационно-правовая форма.
Телефон — указывается по маске: +ХХХХХХХХ, где "Х" — цифра, "+" — необязательный символ, другие символы недоступны для ввода.
Дополнительный телефон.
Почта — указывается по маске: ХХХ@УУУ, где:
Х — цифры, буквы (латиница или кириллица) или символы (+, -, _ или .)
У — цифры, буквы (латиница или кириллица) или символы (- или .)
Дополнительная электронная почта.
Сайт.
Адрес.
Для участников с типом Физическое лицо предусмотрены следующие особенности заполнения системных полей:
Имя — поле обязательно для заполнения.
Отчество.
Фамилия — поле обязательно для заполнения.
ИНН — при заполнении учитываются количество цифр.
Организация.
Дата рождения — указывается строго по маске: yyyy-MM-dd.
Должность.
Телефон — указывается по маске: +ХХХХХХХХ, где "Х" — цифра, "+" — необязательный символ, другие символы недоступны для ввода.
Дополнительный телефон.
Почта — указывается по маске: ХХХ@УУУ, где:
Х — цифры, буквы (латиница или кириллица) или символы (+, -, _ или .)
У — цифры, буквы (латиница или кириллица) или символы (- или .)
Дополнительная электронная почта.
Сайт.
Адрес.
Вы можете указать пустые значения для всех системных полей, кроме полей Названиеорганизации, Имя и Фамилия.
Импорт объектов и участников
Как загрузить файл импорта объектов? Как узнать статус создания дел?
Вы можете загрузить заполненный файл шаблона импорта данных объектов или участников для автоматического создания карточек дел (объектов) или участников ФЛ или организаций в разделе Администрирование — Импорт.
В разделе отображается список всех сессий импорта данных со следующей информацией:
Название сессии импорта.
Тип — тип объекта или тип участника (Организация или Физическое лицо) для импорта.
Дата начала — дата загрузки файла импорта.
Статус:
В процессе – Х% — статус с процентом выполнения загрузки отображается во время выполнения импорта
Завершен — статус отображается после завершения загрузки файла импорта
Чек-лист подготовки к импорту
Прежде чем приступить к загрузке файла импорта убедитесь, что:
Параметры разделителей полей и значений полей мультиблоков и мультистрок, указанные для шаблона импорта в настройках конфигурации Case.one и в самом файле импорта, совпадают:
Разделитель для полей (по умолчанию — ",")
Разделитель для значений полей мультиблоков и мультистрок (по умолчанию — ";")
Заполнены все обязательные системные и кастомные поля
Количество строк в файле не превышает максимально разрешенное значение, которое указано в настройках конфигурации Case.one (по умолчанию — 10000 строк)
В Case.one заранее созданы все сущности, значения которых указаны в файле импорта объектов: типы объектов и дел, пользователи, участники, справочники, карточки объектов и дел.
Для импортируемого типа объекта и типа участника корректно настроены правила определения дубликатов, поскольку при автоматическом создании карточек объектов и участников в результате импорта учитываются параметры определения дубликатов.
Ваша подписка Case.one позволяет создать нужное количество дел и объектов.
В группах пользователей настроен автоматический доступ к делам, чтобы созданные карточки объектов и дел были сразу доступны заинтересованным сотрудникам.
Загрузка файла импорта
Мы рекомендуем выполнять импорт данных в нерабочие или наименее загруженные часы, поскольку автоматическое создание всех карточек объектов или участников может занять некоторое время.
Чтобы загрузить файл импорта:
Нажмите кнопку .
Выберите тип импорта:
Импортировать контакты
Импортировать объекты
Заполните поля формы нового импорта:
Введите название импорта (максимальное количество символов — 450)
Если вы указали импорт объектов, выберите тот тип объекта из списка, шаблон импорта которого был заполнен:
В списке отображаются все типы объектов с указанием класса объекта
Возможен поиск типа объекта
Доступно выбрать только одно значение
Если вы указали импорт контактов, выберите значение: Организация или Физическое лицо
Одновременный запуск нескольких импортов невозможен. Если импорт данных еще не завершен, добавить новый импорт будет недоступно, как вам, так и другим пользователям.
Если успешно пройдены все проверки и выполнен импорт:
Статус импорта изменится на Завершен, вы сможете скачать файл лога импорта.
В разделе Администрирование — Действия в системе будут добавлены записи о создании карточек объектов или участников от имени системного пользователя Service Workflow.
В ленте событий отобразятся записи о создании карточек объектов или участников от имени системного пользователя Service Workflow.
Если на инстансе настроены сценарии автоматизации с оператором Ожидать — Создание объекта/дела или Ожидать — Создание участника, в результате создания объектов или участников через импорт такие сценарии не будут срабатывать.
Особенности выполнения импорта
Как заполняются поля в результате импорта объектов? Как заполняются поля в результате импорта контактов?Как выполняется импорт?
Одновременно вы (или другой пользователь) можете запустить только одну сессию импорта — запуск сразу нескольких сессий импорта невозможен.
Если импорт данных еще не завершен, при попытке добавления новой сессии импорта отобразится уведомление: "Идет процесс импорта данных. Пожалуйста, дождитесь окончания импорта и попробуйте снова".
Отменить уже запущенный импорт объектов недоступно.
После загрузки файла импорта, если пройдены проверки, выполняется сопоставление значений полей данных в файле импорта с полями в типе объекта или типе участника (в зависимости от типа импорта) по следующей логике:
Сопоставление содержания строк — каждая строка в файле импорта после строки с выгруженными полями типа объекта/участника должна содержать данные одного объекта/участника.
Сопоставление формата разделителя и разграничения значений полей:
Параметры разделителей полей, указанные для шаблона импорта в настройках конфигурации Case.one и в файле импорта, должны совпадать
Если в файле использованы кавычки, каждое значение в строке должно быть заключено в кавычки
Наличие лишних пробелов — в значении поля будут удалены начальный и конечный пробел (при их наличии).
Сопоставление полей в строках для заполнения полей в создаваемых карточках объекта/участника — значения полей каждой строки файла импорта будут сопоставлены с полями в типе объекта/участника по тегу или идентификатору поля:
Если значения поля нет в файле, но поле есть в типе объекта/участника — поле в карточке объекта/участника останется пустым или будет указано значение по умолчанию (исключение: значение поля Название объекта/Название организации/Имя и Фамилия должно присутствовать в файле импорта обязательно)
Если значение поля есть в файле, но соответствующего поля нет в типе объекта/участника:
Значение поля не будет перенесено в карточку объекта/участника
Создание карточки объекта/участника будет продолжено
Если значение поля есть в файле, и соответствующее поле есть в типе объекта/участника, системные и кастомные поля будут заполнены в создаваемых карточках согласно настроенной логике и с учетом предусмотренных проверок
Логика заполнения системных полей объектов
При заполнении системных полей:
Если не настроено отображение системных полей в конструкторе объектов на вкладке Настройки в блоке Системные поля, они будут скрыты в результате импорта.
Если для обязательного системного поля в файле не заполнено значение, карточка объекта создана не будет.
Для всех ссылочных полей поиск значений в Case.one выполняется по точному совпадению значений в файле и системе.
Системные поля заполняются по следующей логике:
Стадия объекта — карточка объекта будет создана в начальной стадии, если:
Значение стадии не заполнено
В первой строке файла нет заголовка и тега стадии
Указано значение стадии, которого нет в типе объекта
Найдено две стадии с одинаковым названием
Проект — карточка объекта будет создана вне проекта, если:
Значение проекта не заполнено
В первой строке файла нет заголовка и тега проекта
Найдено два проекта с одинаковым названием
Указано значение проекта, которого нет для выбранного типа объекта
Название объекта:
Если в первой строке файла нет заголовка и тега для поля Название, импорт выполнен не будет
Если значение названия не заполнено, карточка такого объекта создана не будет, импорт остальных строк с данными объектов продолжится
Если длина значения поля Название превышает 400 символов, карточка такого объекта создана не будет, импорт остальных строк с данными объектов продолжится
Ответственный:
В карточке объекта будет указан ответственным системный пользователь Service Workflow, если:
В первой строке файла нет заголовка и тега для поля Ответственный
Значение для поля Ответственный не указано
Указан пользователь, которого нет в Case.one
Найдено несколько (2 и более) пользователей с идентичными данными
Если значение поля Ответственный заполнено, выполняется поиск указанного пользователя сначала по адресу электронной почты, затем по ФИО с учетом формата ФИО в настройках аккаунта:
Если пользователь найден, он будет указан ответственным в карточке объекта
Если пользователь не найден, ответственным в карточке объекта будет назначен системный пользователь Service Workflow
Клиент:
В карточке объекта поле будет не заполнено, если:
В первой строке файла нет заголовка и тега для поля Клиент
Значение для поля Клиент не указано
Указан участник, которого нет в Case.one
Найдено несколько (2 и более) участников с идентичными данными
Если значение поля Клиент заполнено, выполняется поиск указанного участника сначала по ИНН (10 или 12 символов), затем по наименованию (для организаций или ИП) или по ФИО с учетом формата ФИО в настройках аккаунта:
Если участник найден, он будет указан в качестве клиента в карточке объекта
Если участник не найден, поле Клиент не будет заполнено
Описание — поле не будет заполнено, если в первой строке файла нет заголовка и тега для поля Описание или не указано значение поля.
Логика заполнения системных полей участников
Для участников с типом Организация предусмотрены следующие особенности заполнения системных полей:
Название организации:
Если в первой строке файла нет заголовка и тега для поля Название организации, импорт выполнен не будет
Если значение названия не заполнено, карточка такой организации создана не будет, импорт остальных строк с данными контактов продолжится
Если длина значения поля Название организации превышает допустимое количество символов, карточка такой организации создана не будет, импорт остальных строк с данными организаций продолжится
ИНН — поле не будет заполнено, если в первой строке файла нет заголовка и тега для поля ИНН или не указано значение поля.
КПП, ОГРН, ОКПО — поля не будут заполнены, если в первой строке файла нет заголовка и тега для полей или не указаны значения полей.
Организационно-правовая форма — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Указано значение, которого нет в справочнике Организационно-правовая форма
Найдено два или более справочника с названием Организационно-правовая форма
Телефон — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Указано значение не по маске
Не указано значение поля
Если длина значения поля превышает допустимое количество символов
Дополнительный телефон — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Если длина значения поля превышает допустимое количество символов
Не указано значение поля
Почта — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Указано значение не по маске
Если длина значения поля превышает допустимое количество символов
Не указано значение поля
Дополнительная электронная почта — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Сайт — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Если длина значения поля превышает допустимое количество символов
Адрес — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Для участников с типом Физическое лицо предусмотрены следующие особенности заполнения системных полей:
Имя:
Если в первой строке файла нет заголовка и тега для поля, импорт выполнен не будет
Если значение названия не заполнено, карточка участника создана не будет, импорт остальных строк с данными контактов продолжится
Отчество — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Фамилия:
Если в первой строке файла нет заголовка и тега для поля, импорт выполнен не будет
Если значение названия не заполнено, карточка участника создана не будет, импорт остальных строк с данными контактов продолжится
ИНН — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Если длина значения поля превышает допустимое количество символов
Не указано значение поля
Организация — поле не будет заполнено, если:
Если в первой строке файла нет заголовка и тега для поля
Не указано значение поля
Указана организация, которой нет в Case.one — выполняется поиск организаций сначала по ИНН потом по наименованию
Дата рождения — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Указано значение не по маске
Не указано значение поля
Указана несуществующая дата
Должность — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Телефон — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Указано значение не по маске
Не указано значение поля
Если длина значения поля превышает допустимое количество символов
Дополнительный телефон — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Если длина значения поля превышает допустимое количество символов
Не указано значение поля
Почта — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Указано значение не по маске
Если длина значения поля превышает допустимое количество символов
Не указано значение поля
Дополнительная электронная почта — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Сайт — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Если длина значения поля превышает допустимое количество символов
Адрес — поле не будет заполнено, если:
В первой строке файла нет заголовка и тега для поля
Не указано значение поля
Логика заполнения кастомных полей
При заполнении кастомных полей или дополнительных атрибутов участников:
Значение поля будут перенесено в карточку объекта/участника вне зависимости от настроек:
Видимости вкладки, где находится поле
Видимости блока, где находится поле
Возможности редактирования поля
Если для обязательного кастомного поля значение в файле не заполнено, карточка объекта/участника создана не будет.
Если из файла импорта удален заголовок и тег обязательного кастомного поля, карточка объекта/участника будет создана.
Если поле не обязательно для заполнения, а в файле импорта нет значения поля или нет заголовка и тега в первой строке, такое поле останется пустым или будет заполнено значением по умолчанию (если оно предусмотрено для формата поля и указано в настройках типа объекта).
Кастомные поля заполняются по следующей логике:
Гиперссылка — не имеет особенностей заполнения.
Дата — поле будет не заполнено, если:
Значение даты внесено не по маске: 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
Проверки целостности файла импорта
Сразу после запуска импорта выполняются проверки целостности файла импорта. Если хотя бы одна из проверок целостности файла завершилась с ошибкой:
Импорт прекращается;
Запись о сессии импорта не будет добавлена в раздел Импорт.
Проверки выполняются до выявления первой ошибки:
Проверка формата файла импорта — если загружаемый файл не соответствует формату *.csv, отобразится ошибка: «Недопустимый формат файла. Разрешенный формат: csv».
Проверка корректно заполненного файла в формате *.csv (подробнее см. описание валидного формата *.csv), включая проверку количества выгруженных полей типа объекта с количеством значений полей в каждой строке с заполненными данными дел.
Проверка размера загружаемого файла — если размер файла превышает 100 Мб, отобразится ошибка: «Превышен максимальный размер файла. Максимальный размер файла не должен превышать 100 MB».
Проверка количества строк в файле — если количество строк превышает максимально разрешенное значение, которое указано в настройках конфигурации Case.one (по умолчанию — 10000 строк), отобразится ошибка: «Произошла ошибка. Превышено максимальное количество строк в файле: N» (N — максимальное количество строк).
Проверки настроек Case.one
Во время импорта также будут выполняться проверки настроек Case.one:
Проверка наличия дубликатов объектов/дел или участников:
В файл лога будет записана ошибка при выявлении хотя бы одного дубликата объекта/участника, если в типе объекта/участника, для которого загружается файл импорта, установлен запрет на создание дубликатов, объект/участник создан не будет
Если установлен запрет на создание дубликатов для организации, но не настроено правило определения дубликатов, при создании карточек участников будет выполнена существующая проверка на уникальность для контактов с типом Организация
Проверка на максимальное количество объектов по подписке — если в процессе импорта было достигнуто максимальное количество дел по подписке:
В лог будет записана ошибка
Импорт будет прерван
Остальные объекты (превышающие разрешенное количество по подписке) созданы не будут
Просмотр файла лога импорта
Как посмотреть результат импорта объектов? Как скачать файл лога импорта?
В файл лога записывается основная информация о состоянии настроек на момент запуска импорта, а также информация о результате создания или обновления каждого объекта из файла импорта.
Чтобы посмотреть результаты выполнения импорта:
Выберите сессию импорта в разделе Администрирование — Импорт.
Нажмите кнопку и выберите пункт Скачать лог.
Название файла формируется автоматически по маске: ImportLog <Название импорта> <Дата начала импорта>.txt.
В файл лога записывается следующая информация:
Этапы процесса импорта данных из файла:
Старт импорта данных <Название импорта> из файла <идентификатор файла> для типа дела <идентификатор типа дела>/для контакта <тип контакта>
Начало загрузки данных из файла: <идентификатор файла>
Завершение импорта:
Импорт данных из файла <идентификатор файла> завершен. Всего загружено строк: N, где N — количество строк с данными объектов/участников
Импорт данных из файла <идентификатор файла> завершился с ошибкой: <сведения об ошибке>
Результат операции по созданию карточки объекта/участника для каждой строки в файле импорта:
Если в результате обработки строк удалось создать объект/участника, отображается запись, например: На основании данных из строки A успешно создан объект/участник, где А — номер строки
Если во время импорта выявлены ошибки заполнения полей, указываются детали ошибки
Итоговый результат импорта объектов/участников:
Если в результате импорта были созданы карточки объектов/дел или участников, отображается запись: Импорт данных завершен со статусом Completed. Всего обработано строк: N, где N — количество дел/участников, данные которых были добавлены в файл одной строкой
Если в результате импорта не удалось создать карточки объектов/дел или участников, отображается запись: Импорт данных завершен со статусом Failed. Всего обработано строк: N, где N — количество дел/участников, данные которых были добавлены в файл одной строкой
Тип ошибки
Описание
Поля
Не заполнено обязательное поле
Ошибка: для указанного в строке {номер строки} поля {id/тег поля} не удалось найти обработчик значения
— Обязательное кастомное поле любого формата — Системное поле Название объекта — Обязательное поле участника ЮЛ: Наименование организации — Обязательные поля участника ФЛ: Имя, Фамилия
Если в Case.one не найдено значение из файла
Ошибка: указанное в файле импорта в строке {номер строки} значение для поля {id/тег поля} не найдено в системе
Ссылочные поля для объекта: — Стадия — Проект — Ответственный — Клиент — Справочник — Объект-Дело — Объект-Объект — Объект-Участник — Объект-Пользователь Поля для карточки участника: — Организационно-правовая форма — Справочник — Объект-Дело — Объект-Объект — Объект-Участник
Если в типе объекта найдено 2 и более одинаковых значений, указанных в файле
Ошибка: для поля {id/тег поля} в строке {номер строки} в системе найдены 2 или более одинаковых значений
Если значение в файле импорта заполнено в некорректном формате
Ошибка: некорректный формат данных в файле импорта в строке {номер строки} для поля {id/тег поля}
Поля для объекта: — Дата — Дата и время — Логический — Текст — Формула расчета — Чекбокс — Число Поля для карточки участника: — ИНН — Дата рождения — Телефон — Дата — Дата и время — Логический — Текст — Чекбокс — Число — Почта — Сайт — Название организации
Если значение в файле импорта соотносится с полем, которое в объекте расположено в мультистроке и в мультиблоке
Ошибка: указанное в строке {номер строки} поле {id/тег поля} имеет неподдерживаемый формат поля
Любое поле, которое одновременно находится в мультистроке и в мультиблоке
Если для значения в файле импорта не найдено поле с соответствующим тегом или идентификатором
Ошибка: указанное в файле импорта в строке {номер строки} значение для поля {id/тег поля} не найдено в типе дела/системе
и выберите пункт Скачать.
.
