Пользовательская инструкция по настройке приложения «Импорт смарт-процессов»


Установка приложения в Битрикс24

Чтобы начать использовать приложение «Импорт смарт-процессов» на вашем портале Битрикс24, необходимо скачать его по ссылке или выполнить следующие действия:

1. Поиск приложения

Перейдите в раздел Маркетплейс вашего портала Битрикс24, в строке поиска введите название «Импорт смарт-процессов» и выберите его из предложенного списка.


2. Открытие страницы приложения

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


3. Установка приложения 

Нажмите кнопку «Установить» и проставьте галочки в чекбоксах условий соглашения, а затем снова нажмите на кнопку «Установить». 


4. Доступ к приложению

После завершения установки приложение будет доступно в главном меню вашего портала Битрикс24.



Интерфейс приложения

После установки на главной странице приложения будет представлено несколько пунктов меню:

  1. «Выберите смарт-процесс» — позволяет выбрать ранее созданный смарт-процесс на портале Битрикс24 для дальнейшей работы с ним.

  2. «Скачайте пустой шаблон для выбранного смарт-процесса» — позволяет скачать шаблон выбранного смарт-процесса с пустыми значениями в формате, который доступен для просмотра и редактирования через MS Excel или аналогичные программы.

  3. «Скачайте заполненный шаблон с данными всех элементов списка» — позволяет скачать шаблон со всеми данными выбранного смарт-процесса в формате, который доступен для просмотра и редактирования через MS Excel или аналогичные программы.

  4. «Загрузите заполненный шаблон для импорта» — позволяет загрузить Excel-файл, на основе которого будут созданы элементы в выбранном смарт-процессе на портале Битрикс24. 

  5. «Начать импорт» — позволяет начать импорт добавленного вами файла на портал Битрикс24.

  6. «Вы также можете привязать Telegram-чат для логов ошибок» — позволяет привязать Telegram-чат для сбора логов (истории) ошибок.



Настройки приложения

Экспорт смарт-процесса с незаполненными данными 

Для экспорта определенного смарт-процесса с незаполненными данными с портала Битрикс24 необходимо:

  1. Выбрать смарт-процесс в поле «Выберите смарт-процесс».

  2. Скачать шаблон с пустыми данными, воспользовавшись кнопкой «Скачать» рядом с пунктом «Скачайте пустой шаблон для выбранного смарт-процесса».


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


Обратите внимание, что для создания новых элементов заполнение первых двух столбцов не является обязательным. Остальные можно заполнять по вашему усмотрению.



Экспорт смарт-процесса с заполненными данными

Для экспорта определенного смарт-процесса с заполненными данными с портала Битрикс24 необходимо:

  1. Выбрать смарт-процесс в поле «Выберите смарт-процесс».

  2. Скачать шаблон с заполненными данными, воспользовавшись кнопкой «Скачать» рядом с пунктом «Скачайте заполненный шаблон с данными всех элементов списка».


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


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



Импорт смарт-процесса

Для импорта смарт-процесса необходимо:

  1. Нажать кнопку «Выберите файл» рядом с пунктом «Загрузите заполненный шаблон для импорта».

  2. Выбрать файл в формате XLSX на вашем устройстве.

  3. Нажать кнопку «Начать импорт».


После откроется страница со следующей информацией:

  • количество записей, переданных для создания;

  • список полей, которые будут заполнены;

  • количество записей, переданных для обновления;

  • список полей, которые будут изменены.


Необходимо подтвердить или отменить запуск импорта, используя соответствующие кнопки.


После подтверждения в открывшемся окне можно будет обновить или прервать импорт.


По завершении импорта будет отображена информация о количестве созданных и отредактированных элементов. В случае возникновения ошибок в процессе импорта они также будут указаны на данной вкладке.


Обновление имеющихся элементов

Обратите внимание, изменение элементов производится по id. Это означает, что в смарт-процессе на портале Битрикс24 будут обновлены те элементы, id которых указаны в файле. Если в строке не прописан id, будет создан новый элемент.


Для того, чтобы обновить элементы смарт-процессов, необходимо:

  1. Выбрать смарт-процесс в поле «Выберите смарт-процесс».

  2. Скачать шаблон с заполненными данными, воспользовавшись кнопкой «Скачать» рядом с пунктом «Скачайте заполненный шаблон с данными всех элементов списка».


3. Перейти в файл — в третьей строке столбцов, где требуется обновить данные, необходимо заменить текст «Обновить поле: нет» на «Обновить поле: да» в соответствующих ячейках.

Обратите внимание, если в импортируемом шаблоне после строки с признаком «Обновить поле: да» оставить пустое значение для элемента, то при загрузке этого шаблона на портал Битрикс24 соответствующее поле элемента будет очищено. То есть, пустое значение после отметки «да» приведет к удалению данных в этом поле на портале.


4. Нажать кнопку «Выберите файл» рядом с пунктом «Загрузите заполненный шаблон для импорта». Выбрать файл, который вы ранее редактировали. Затем нажать кнопку «Начать импорт». 


После откроется страница со следующей информацией:

  • количество записей, переданных для создания;

  • список полей, которые будут заполнены;

  • количество записей, переданных для обновления;

  • список полей, которые будут изменены.

Необходимо подтвердить запуск импорта, используя соответствующую кнопку.


Таким образом, элементы со значением «Обновить поле: нет» останутся без изменений, а со значением «Обновить поле: да» — обновятся.



Привязка Telegram чата

Чтобы привязать чат Telegram для сбора логов ошибок, необходимо нажать кнопку «Привязать» на главной странице приложения рядом с пунктом «Вы также можете привязать Telegram-чат для логов ошибок» и выбрать нужный чат.


После в приложении появится информация о привязке чата, а кнопка «Привязать» будет переименована в «Сказать Привет».


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


Комментарии