Установка PT 1C Connector (стр. 4 )

Рисунок 40 - Настройка прав на объекты плана обмена

Типы интеграции

В PT 1C Connector существуют следующие типы интеграций:

bpm ->1C; 1C -> bpm; Двухсторонняя (мастер bpm); Двухсторонняя (мастер 1С).

Двухсторонняя интеграция с использованием мастера bpm’online выполняется в следующем порядке:

Интеграция в направлении bpm -> 1C; Интеграция в направлении 1C -> bpm.        

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

Интеграция в направлении 1C -> bpm; Интеграция в направлении bpm -> 1C.

Для интеграции типа Двухсторонняя (мастер bpm) действуют следующие правила:

Изменение записи. Запись изменена в bpm’online – изменения интегрируются в 1С. Запись изменена в 1С – в bpm’online изменения не передаются. Если в настройках интеграции установлен признак [Только новые], измененные на стороне bpm’online записи не будут переданы в 1С. Удаление записи. Запись, существующая в 1С и удаленная в bpm’online, будет заново добавлена в bpm’online. Запись, существующая в bpm’online и удаленная в 1С, будет заново добавлена в 1С. Если в настройках интеграции установлен признак [Только новые], удаленные на стороне 1С записи будут заново добавлены в 1С. Добавление записи. Запись добавлена в bpm’online – запись интегрируется в 1С. Запись добавлена в 1С – запись интегрируется в bpm’online.

Для интеграции типа Двухсторонняя (мастер 1С) действуют следующие правила:

Изменение записи. Запись изменена в bpm’online – после интеграции запись обновится значениями из 1С (если не настроен план обмена). Запись изменена в bpm’online – изменения применятся к соответствующей записи 1С (если настроен план обмена). Запись изменена в 1С – изменения передадутся в bpm’online. Если в настройках интеграции установлен признак [Только новые], изменения на стороне bpm’online не передаются в 1С. Удаление записи. Запись, существующая в 1С и удаленная в bpm’online, будет заново добавлена в bpm’online. Запись, существующая в bpm’online и удаленная в 1С, будет заново добавлена в 1С. Добавление записи. Запись добавлена в bpm’online – запись интегрируется в 1С. Запись добавлена в 1С – запись интегрируется в bpm’online.

Для интеграции типа bpm ->1C действуют следующие правила:

Изменение записи. Запись изменена в bpm’online – изменения интегрируются в 1С. Если в настройках интеграции установлен признак [Только новые], измененные на стороне bpm’online записи не будут переданы в 1С. Удаление записи. Запись, существующая в 1С и удаленная в bpm’online, не удалится в 1С. Запись, существующая в bpm’online и удаленная в 1С, будет заново добавлена в 1С.

Добавление записи. Запись добавлена в bpm’online – запись интегрируется в 1С. Запись добавлена в 1С – запись не передается в bpm’online.

Для интеграции типа 1C -> bpm действуют следующие правила:

Изменение записи. Запись изменена в 1С – изменения интегрируются в bpm’online. Запись изменена в bpm’online - изменения не интегрируются в 1С. Удаление записи. Запись, существующая в 1С и удаленная в bpm’online, добавится в bpm’online. Запись, существующая в bpm’online и удаленная в 1С, не будет заново добавлена в 1С. Добавление записи. Запись добавлена в bpm’online – запись не передается в 1С. Запись добавлена в 1С – запись интегрируется в bpm’online.

Основная информация

PT 1C Connector – специализированное решение для выполнения задач интеграции bpm’online с 1С. С помощью данного продукта, пользователь может самостоятельно настраивать интеграцию без использования кода.

Создание интеграции с 1С

Для того, чтобы настроить соединение с 1С, выполните следующие действия:

Перейдите в раздел [Интеграция с 1С] и нажмите кнопку [Добавить]. Во вкладке [Основная информация] в поле [Название] введите название новой интеграции, которое будет отображаться в списке интеграций. В поле [Web сервис 1С] введите адрес web-сервиса 1С, по средствам которого будет осуществляться интеграция. Ссылка на web-сервис 1С формируется при публикации сервиса в 1С (см. Публикация web-сервиса 1С). Данная ссылка должна иметь вид:

http://<имя|АдресСервера1С>/<ИмяБазы1С>/ws/<ИмяФайлаВебСервиса>.1cws

Пример: http://stnd1CServer/testBase/ws/PT1CConnector.1cws.

В поля [Имя пользователя] и [Пароль] введите имя пользователя и пароль со стороны 1С. После внесения изменений нажмите на кнопку [Сохранить].

Примечание

Пользователь системы 1С, указанный в системе, должен являться администратором.

Рисунок 41 - Настройка соединения с 1С

Журналирование интеграции

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

Для этого:

Для записи сообщений в журнал интеграции в разделе [Логирование] поставьте галочку в пункте [Логировать в БД]. Иначе выполните п.2. В поле [Файл журнала] следует указать каталог файла, в котором будут сохраняться результаты интеграции. При этом необходимо раздать права доступа на каталог для пользователя, от которого запущен пул приложения bpm’online. В поле [Уровень логирования] выберите [Все сообщения], [Только ошибки] или [Не логировать]. После внесения изменений нажмите на кнопку [Сохранить].

Примечание

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

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

Рисунок 42 - Деталь [Логирование]

Для выгрузки сообщений системы о ходе интеграции в электронные таблицы с расширением. csv необходимо нажать на кнопку [Сохранить в CSV] на детали [Журнал интеграции с 1С].

Примечание

Чтобы экспорт в. csv выполнился корректно, количество записей в журнале интеграции не должно превышать 10000.

Рисунок 43 - Деталь [Журнал интеграции с 1С]

Кнопка [Обновить] предназначена для обновления содержимого журнала интеграции без выполнения перезагрузки страницы. При этом в самая последняя запись журнала отображается в верху списка.

Для удаления всех записей журнала интеграции необходимо нажать на кнопку [Очистить].

PT 1C Connector позволяет настраивать запуск интеграции по расписанию, поэтому возможен запуск нескольких интеграций одновременно. Очередной запуск интеграции создает новую сессию, данные о которой отображаются в журнале интеграции в виде набора записей, удобных для фильтрации как по дате начала, так и по номеру записи. Нумерация записей лога уникальна в рамках одной сессии интеграции.

Рисунок 44 - Наполнение журнала при выполнении интеграции

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

В настройках интеграции необходимо указывать путь к папке, в которую будут записываться все файлы вида «НАЗВАНИЕ_ИНТЕГРАЦИИ – НАЗВАНИЕ_СЕССИИ_ИНТЕГРАЦИИ. txt» в рамках одной сессии.

Рисунок 45 - Файлы журнала интеграции

Объекты интеграции

После добавления новой интеграции перед настройкой объектов интеграции, необходимо выполнить действие [Загрузить структуру конфигурации 1С] на странице объекта интеграции для загрузки объектов и типов объектов из конфигурации 1С.

Рисунок 46 - Действие [Загрузить структуру конфигурации 1С]

Во вкладке [Объекты интеграции] указаны все разделы, для которых настроена интеграция, их порядковый номер и тип синхронизации.

Рисунок 47 - Вкладка [Объекты интеграции]

Страница объекта интеграции

PT 1C Connector позволяет интегрировать объекты 1С типов Справочники, Документы и Регистры. В данном разделе описана интеграция объектов 1С типов Справочник и Документ.

Для добавления объекта интеграции выполните действие [Добавить Справочник/Документ] на детали [Объекты интеграции с 1С] страницы интеграции.

Рисунок 48 - Добавление объекта интеграции с типом [Справочник/Документ]

На странице редактирования объекта интеграции настраивается соответствие объектов интеграции, а также колонок объектов интеграции – это могут быть колонки, агрегируемые колонки, табличные части и регистры.

Для объекта интеграции необходимо заполнить следующие колонки:

[Порядковый номер] позволяет задать порядок интеграции объектов; [Объект bpm’online] – выпадающий список, в котором содержатся объекты, существующие в bpm’online; [Объект 1С] – выпадающий список, в котором содержится перечень объектов, загруженных из конфигурации 1С; [Тип интеграции] – выпадающий список с возможными направлениями интеграции:

[1С -> bpm]; [bpm -> 1C]; [Двухсторонняя (Мастер bpm)]; [Двухсторонняя (Мастер 1С)].

Подробное описание типов интеграции представлено в Типы интеграции.