Интеграция с 1C: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 8: Строка 8:




Сейчас между ПланФикс и 1С поддерживается обмен контактами.
Сейчас между ПланФикс и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по ссылке.




Строка 39: Строка 39:




Если в вашей конфигурации 1С включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:


 
*Перейдите в раздел '''НСИ и Администрирование''' — '''Печатные формы, отчеты и обработки''':
 
== На стороне 1С ==
 
Если в вашей конфигурации включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:
*Перейдите в раздел '''НСИ и Администрирование''' - '''Печатные формы, отчеты и обработки''':


https://p.pfx.so/pf/L5/erWY2L.png
https://p.pfx.so/pf/L5/erWY2L.png




*нажмите на '''Дополнительные отчеты и обработки''':
*Нажмите на '''Дополнительные отчеты и обработки''':


https://p.pfx.so/pf/I6/jzPhRb.png
https://p.pfx.so/pf/I6/jzPhRb.png




*Кликните на '''Добавить из файла''', выберите файл обработки, загруженный по ссылке выше:
*Кликните на '''Добавить из файла''', выберите файл обработки, загруженный по ссылке ранее:


https://p.pfx.so/pf/KS/8lfPCV.png
https://p.pfx.so/pf/KS/8lfPCV.png
Строка 76: Строка 72:




Второй вариант, как можно использовать модуль: открыть обработку через '''Меню''' - '''Файл''' - '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке :
Второй вариант использования модуля.
 
Открыть обработку через '''Меню''' — '''Файл''' — '''Открыть'''. В данном случае файл обработки должен храниться в локальной или общедоступной папке:


https://p.pfx.so/pf/LA/xCynJ7.png
https://p.pfx.so/pf/LA/xCynJ7.png




== '''Настройка интеграции''' ==
== Настройка модуля интеграции ==
Настройка модуля интеграции:
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С.
*Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С
*Нажмите '''Тест подключения''', в сообщениях должно появиться — '''Запрос успешно выполнен''':
*Нажмите '''Тест подключения''', в сообщениях должно появиться - '''Запрос успешно выполнен'''


https://p.pfx.so/pf/Ve/ialagW.png
https://p.pfx.so/pf/Ve/ialagW.png




*Переходите во вкладку '''Контакты'''
*Перейдите во вкладку '''Контакты'''.
*Выбираете шаблон для создания контакта в Планфикс.
*Выберите шаблон для создания контакта в ПланФиксе.
*Выбираете шаблон для создания компании в Планфикс.
*Выберите шаблон для создания компании в ПланФиксе.
*Устанавливаете опцию параметров импорта.
*Установите опцию параметров импорта.
*Выбираете поле, по совпадению которого определяется, что контакт существует.
*Выберите поле, по совпадению которого определяется, что контакт существует.
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Также есть возможность установить флаг выгрузки помеченных на удаление объектов.
*Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов:


https://p.pfx.so/pf/6v/W36EZG.png
https://p.pfx.so/pf/6v/W36EZG.png


В таблице слева есть возможность сопоставить пользовательские поля Планфикса реквизитам справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник '''Контрагенты''' или справочник '''Партнеры'''. Это дополнительный функционал, настраивать сопоставление необязательно.
 
В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник '''Контрагенты''' или справочник '''Партнеры'''. Это дополнительный функционал, настраивать сопоставление необязательно:


https://p.pfx.so/pf/f3/fkgvAk.png
https://p.pfx.so/pf/f3/fkgvAk.png


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


Строка 112: Строка 111:




Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактной информации в 1С
Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактов информации в 1С:


https://p.pfx.so/pf/T6/bxVS1b.png
https://p.pfx.so/pf/T6/bxVS1b.png
Строка 121: Строка 120:




Не забудьте сохранить настройки.


После необходимо нажать на Сохранить настройки.


== Выполнение обмена ==
== Выполнение обмена ==
<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена настоятельно рекомендуем  сделать бэкап информационной базы.</div>


<div style="background-color:#ffcaca; border: 1px solid #fd9292;padding:10px;"> Перед выполнением обмена настоятельно рекомендуется сделать backup информационной базы.</div>
Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку '''Отправить данные'''. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.


Так как сопоставление и хранение информации о связи между объектами Планфикса и базой 1С, происходит на стороне Планфикса, первым этапом рекомендуется выполнить выгрузку контактов в Планфикс, нажать на кнопку '''Отправить данные'''. Произойдет отправка всех контрагентов/партнеров/контактных лиц в Планфикс, где будет произведен импорт согласно настроек.
При первом обмене получите все данные из ПланФикса, нажав кнопку '''Получить все данные'''. При последующих обменах можно получать только измененные данные кнопкой '''Получить данные (только измененные)'''.   
После этого при первом обмене нужно получить все данные из Планфикс, нажатием кнопки '''Получить все данные''', далее при последующих обменах можно получать только измененные данные с момента последнего обмена, кнопкой '''Получить данные (только измененные)'''.   
 
При использовании механизма Дополнительных обработок, есть возможность настроить автоматический обмен по расписанию. Можно настроить только выгрузку или только загрузку или двусторонний обмен.
При использовании механизма '''Дополнительных обработок''', можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:


https://p.pfx.so/pf/1E/9vFWCr.png
https://p.pfx.so/pf/1E/9vFWCr.png




== Отладка и тестирование и доработка ==
== Отладка, тестирование, доработка ==
Исходный код модуля открыт для редактирования, поэтому при необходимости можно дорабатывать его под свои нужды. В этом случае последующие обновления модуля придется выполнять в ручном режиме, если они будут вам необходимы.
*Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
Также на форме обработки есть вкладка '''Отладка и тестирование''', где можно выполнять тестовые команды.
 
*Во вкладке '''Отладка и тестирование''' можно выполнять тестовые команды.
 
 
== Перейти ==
*[[Интеграции]]

Версия от 12:44, 10 июня 2021

В тестовом режиме поддерживается обмен данными с типовыми конфигурациями на базе 1С:Предприятие 8.3.


Сейчас между ПланФикс и 1С поддерживается обмен контактами. Скачать файл модуля интеграции можно по ссылке.


Поддерживаемые конфигурации

  • Управление торговлей 11
  • Комплексная автоматизация 2
  • ERP Управление предприятием 2
  • Управление нашей фирмой 1.6


Настройка интеграции

  • Перейдите в Управление аккаунтом — Интеграции — Другие сервисы и приложения — 1С:Предприятие 8:

BimIRJ.png


  • Нажмите Добавить:

YPAcQV.png


  • Задайте и сохраните имя интеграции. Рекомендуем назвать по имени типовой конфигурации, с которой будет производиться обмен:

9mFgbC.png


  • Добавленная конфигурация должна появиться в перечне конфигураций:

SS0Sf8.png


Если в вашей конфигурации 1С включена опция «Дополнительные отчеты и обработки», то встроить модуль в интерфейс программы можно следующим образом:

  • Перейдите в раздел НСИ и Администрирование — Печатные формы, отчеты и обработки:

erWY2L.png


  • Нажмите на Дополнительные отчеты и обработки:

jzPhRb.png


  • Кликните на Добавить из файла, выберите файл обработки, загруженный по ссылке ранее:

8lfPCV.png


  • Нажмите на кнопку Записать (иконка в виде дискеты).
  • Разместите обработку в нужном разделе программы.
  • Настройте быстрый доступ к команде Открыть форму настроек обмена с ПланФикс для пользователей:

yQNC55.png

LqzFcJ.png


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

tzHuwW.png

1qTqjs.png


Второй вариант использования модуля.

Открыть обработку через Меню — Файл — Открыть. В данном случае файл обработки должен храниться в локальной или общедоступной папке:

xCynJ7.png


Настройка модуля интеграции

  • Скопируйте адрес для принятия запросов и токен авторизации из настроек Планфикса и вставьте их в настройки интеграции в 1С.
  • Нажмите Тест подключения, в сообщениях должно появиться — Запрос успешно выполнен:

ialagW.png


  • Перейдите во вкладку Контакты.
  • Выберите шаблон для создания контакта в ПланФиксе.
  • Выберите шаблон для создания компании в ПланФиксе.
  • Установите опцию параметров импорта.
  • Выберите поле, по совпадению которого определяется, что контакт существует.
  • Если в конфигурации используются контактные лица, то можно установить флаг выгрузки их в контакты компаний. Можно установить флаг выгрузки помеченных на удаление объектов:

W36EZG.png


В таблице слева при необходимости сопоставьте пользовательские поля ПланФикса с реквизитами справочника 1С. В зависимости от настроек CRM и маркетинга в 1С, используется справочник Контрагенты или справочник Партнеры. Это дополнительный функционал, настраивать сопоставление необязательно:

fkgvAk.png


В правой части окна располагаются параметры импорта контактов в 1С:

  • Обновлять данные существующих контактов (если нужно).
  • Создавать при загрузке новых контрагентов/партнеров.
  • Опция, позволяющая создавать и обновлять контактные лица партнеров из контактов компаний в ПланФиксе.
  • Поля, по совпадению которых определяется, что компания/контакт существует.
  • Поле по умолчанию, если контакт/компания не найдены по заданному правилу выше:

m5Pjss.png


Для правильного обмена телефонами, необходимо выполнить сопоставление видов телефонов для различных групп контактов информации в 1С:

bxVS1b.png

PmGFHG.png

eFEpeO.png


Не забудьте сохранить настройки.


Выполнение обмена

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

Так как сопоставление и хранение информации о связи между объектами ПланФикса и базой 1С происходит на стороне ПланФикса, первым этапом рекомендуется выполнить выгрузку контактов в ПланФикс, нажав кнопку Отправить данные. Произойдет отправка всех контрагентов/партнеров/контактных лиц в ПланФикс, где будет произведен импорт согласно настроек.

При первом обмене получите все данные из ПланФикса, нажав кнопку Получить все данные. При последующих обменах можно получать только измененные данные кнопкой Получить данные (только измененные).

При использовании механизма Дополнительных обработок, можно настроить автоматический обмен по расписанию, выбрав только выгрузку или загрузку, либо двусторонний обмен:

9vFWCr.png


Отладка, тестирование, доработка

  • Исходный код модуля открыт для редактирования, поэтому при необходимости его можно дорабатывать. В этом случае последующие обновления модуля необходимо выполнять в ручном режиме.
  • Во вкладке Отладка и тестирование можно выполнять тестовые команды.


Перейти

Источник — http://planfix.com/ru/help/index.php?title=Интеграция_с_1C&oldid=33424