Для: Администраторы и Менеджеры
Найдите столбцы, необходимые для каждого импорта.
Обязательные и необязательные столбцы CSV для каждого типа импорта, с указанием форматов, которые принимает каждый из них.
В этой статье8 разделов
На этой странице перечислены столбцы, которые используются для хранения информации о каждом типе импорта, указанном в разделе Интеграция › Импорты. Также указано, как правильно записывать значения в эти столбцы.
Каждый импорт
- Первая строка содержит названия столбцов, которые могут располагаться в любом порядке. Следующие строки представляют собой отдельные записи. Сохраните файл в формате CSV UTF-8, чтобы имена с диакритическими знаками правильно отображались.
- Файл может содержать до 25 000 строк под названиями колонок. Файлы более длинные не работают должным образом; они не могут быть импортированы. Необходимо разделить файл на несколько файлов по 25 000 строк в каждом, а затем импортировать каждый из этих файлов отдельно.
- Пустая ячейка считается незаполненной. Применяется значение по умолчанию; ничего не удаляется из этой ячейки.
- Избегайте отображения столбцов, которые не перечислены здесь. Большинство из них игнорируются. Однако в разделе Изменение пользователей наличие неизвестного столбца приводит к отказу в обработке записи.
- Пишите даты в виде года первым, например 2026-03-15. Затем указывайте “да” или “нет”, используя символы
trueилиfalse. - В одном из столбцов разместите список элементов, разделенный запятыми, например:
role::staff,role::clients. - Назовите случай по его ID теговИдентификатор метки Постоянная метка, которую вы присваиваете делу, например, rear-end-2026, также отображается в качестве идентификатора ссылки и используется при импорте. или по его ID из списка случаев в административном панели. Назовите человека по его ID референса или ID пользователя, который можно найти в разделе «Изменение пользователя». Использование заглавных букв не имеет значения.
- Напишите роль…
role::И его название, например:role::clients. - Импортер не может заполнять поля, связанные с конфигурацией данных; кроме того, он не проверяет те поля, которые отмечены как необходимые. В результате поля для создаваемого случая или человека остаются пустыми. Необходимо заполнить эти поля позже, при создании соответствующего случая или человека.
Добавить пользователей
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
username | Их адрес электронной почты, или номер мобильного телефона с кодом страны, например +12035556677. Тот человек, который уже находится в вашем хабе, не проходит проверку. | Да. | — |
given_name | Имя | Да. | — |
family_name | Фамилия | Да. | — |
locale | Язык: ar, de, en, es, fr, id, it, ja, pl, pt, ru или zh | Нет. | en |
zoneinfo | Часовая зона, например: America/New_York | Нет. | US/Eastern |
host_ref_id | У вас должна быть своя идентификационная информация для них – например, номер клиента. Эта информация состоит из букв, цифр, диакритических знаков. Все символы должны писаться в строчных буквах. Ни один человек не может использовать одну и ту же информацию для нескольких людей. | Нет. | Ничего. |
host_default_role | Эта роль принимается в первую очередь, когда элементы добавляются в определенную структуру, например, в role::clients. Однако она не предоставляет никаких преимуществ. | Нет. | Ничего. |
host_staff_designation | Их обычные обозначения персонала: primary, attorney, paralegal, case_manager, lead_attorney или lead_paralegal | Нет. | primary |
birthdate | Дата рождения | Нет. | Ничего. |
gender | Male или Female | Нет. | Ничего. |
address1, address2, locality, region, postal_code | Адрес: второй столбец, город, штат и почтовый индекс | Нет. | Ничего. |
country | Двухбуквенный код страны, например: US | Нет. | Ничего. |
company, title | Компания и должность | Нет. | Ничего. |
host_create_case | true позволяет им создавать различные ситуации, подобные той, что происходит при использовании Можно создать дело в функции «Изменение пользователя». | Нет. | false |
host_add_case_user | Эти функции позволяют добавлять людей в определенную ситуацию, например, в структуру Можно добавить пользователя дела как. | Нет. | Ничего. |
host_remove_case_user | true позволяет им удалять людей из какого-либо случая, подобно Может удалить пользователя дела. | Нет. | false |
Все входящие пользователи являются таковыми по своей природе. Чтобы предоставить какому-либо человеку доступ к административному панелю, смотрите раздел “Предоставление доступа члену команды к административному панелю”.
Изменить пользователей
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
user_id | Человек, который должен быть изменен… Администратора нельзя изменить с помощью импорта. | Да. | — |
host_user_status | 0 отключает их, а 1 снова активирует их. | Нет. | Не изменилось. |
Любая колонка с именами пользователей, кроме username | Заменяет этот элемент детали. | Нет. | Не изменилось. |
Импортер не может изменять адрес электронной почты, номер телефона или тип пользователя у человека. Язык и часовой пояс остаются за человеком сразу после его входа в ваш центр управления. Изменение этих параметров здесь не влияет на то, что происходит с человеком в реальном времени.
Создать кейсы
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
ref_id | ID случая: буквы, цифры, знаки отрицания и слегка выделенные символы; все эти символы пишутся в строчной форме. ID случая другого типа не соответствует условиям для разбиения на ряды. | Да. | — |
title | Название дела | Да. | — |
case_type | Один из ваших хабов… Типы случаевТип дела Категория для конкретных случаев, например, «общие», используется для того, чтобы автоматизация выполнялась в нужных случаях., Написано так: настройки › Поля | Нет. | general |
case_status | 1 — для открытого состояния; 0 — для закрытого состояния. | Нет. | 1 |
date_opened | Дата начала рассмотрения дела | Нет. | Сегодня |
description | Описание дела | Нет. | Ничего. |
case_stage | Ид его этап/фазаЭтап Этап, через который проходит дело, например, прием заявки или отправка запроса, который фирма обозначает и описывает и который отображается на странице дела., Копировано из него. Идентификатор этапа внутри настройки › Этапы | Нет. | Никакой стадии |
hidden_modules | Разделы, которые нужно скрыть в данном случае. Разделы должны быть разделены запятыми. Пример: invoices,notes; case, convos, events, forms, signs, invoices, notes, tasks и team. | Нет. | Ничего не скрыто. |
Изменить регистры
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
case_id | Нужно изменить ситуацию. | Да. | — |
title, description, case_status, date_opened | Что касается функции «Создание случаев», то речь идет о замене содержания самого случая. | Нет. | Не изменилось. |
case_type | Один из типов случаев, связанных с вашим хабом, или сам тип случая – даже если вы уже удалили его из своих настроек. | Нет. | Не изменилось. |
case_stage | Этот этап позволяет переместить случай в нужное место. Импортера не может вывести случай из этого этапа. | Нет. | Не изменилось. |
hidden_modules | Заменяет те разделы, которые скрыты в случае. Импорт не может снова показать все эти разделы. | Нет. | Не изменилось. |
ID случая не может быть изменен.
Назначайте пользователей на обращения.
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
case_id | Дело/Ситуация | Да. | — |
user_id | Человек, которого нужно добавить. | Да. | — |
case_role_id | Их роль в этом деле заключается в использовании символа clients, как с одним, так и с двумя символами role::. | Да. | — |
case_notify | true отправляет им приглашение на участие в процедуре. | Да. | — |
client_designation | В роли клиента: primary или guardian | Нет. | primary |
staff_designation | В должности сотрудника или в любой из своих собственных должностей: primary, attorney, paralegal, case_manager, lead_attorney или lead_paralegal | Нет. | primary |
Заполните столбец, указывающий роль строки. Оставьте другие поля пустыми. Если в строке, относящейся к определенной должности или категории, значение primary или guardian, то эта строка не будет отображаться. Также строка не будет отображаться, если в ней указано имя сотрудника из коллектива клиентов. Строка также не будет отображаться, если в ней указано имя человека, уже работающего над данным делом, или если в деле уже работает 20 человек.
Создание сообщений о случаях
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
case_id | Дело/Ситуация | Да. | — |
user_id | От кого пост: это человек, который занимается данным делом. Его роль заключается в добавлении сообщений на сайт. Это может быть сотрудник организации. | Да. | — |
message | Текст сообщения | Да. | — |
permissions | Роли, которые могут это видеть, например role::staff | Нет. | Все, кто занимается этим делом… |
Каждый пост сообщает людям о том, что было добавлено самим автором этого поста. Строка для закрытых случаев отсутствует.
Удалить пользователей, назначенных на дела.
| Столбец | Что это делает | Необходимый | По умолчанию |
|---|---|---|---|
case_id | Дело/Ситуация | Да. | — |
user_id | Человек, который должен снять это. | Да. | — |
Тот, кто не занимается этим делом, не может считаться профессионалом в своей области.