Модуль интеграции общий

Предлагается загрузить утилиту для осуществления обменов с веб-сервисом в консольном режиме. Справка по работе с утилитой вызывается при запуске ее с ключом /help

F.A.Q

Часто задаваемые вопросы

Термин CRM может использоваться в двух значениях.


1. CRM (Customer Relationship Management) — устоявшийся термин, обозначающий технологию построения отношений с клиентами, путем сохранения информации о контактах с ними и последующем их анализе, а также программные продукты, обеспечивающие необходимый для этого фукнционал.


2. «МОНОЛИТ: CRM — мобильная торговля и услуги» (сокр. «Монолит: CRM» или просто CRM) — программный продукт компании Монолит-Инфо, в котором реализована возможность организации, контроля и планирования работы торговой компании с ее клиентами (более подробно см. здесь

СУП - система управления продажами. Термин употребляется по отношению к системе продаж, используемой дистрибьюторами.

СУП может быть построен на базе серийно поставляемых продуктов (например, 1С Предприятие) или являться самостоятельной разработкой. Компанией Монолит-Инфо разработаны типовые решения для обмена информацией между CRM и СУП 1С Предприятие версий 7.7 и 8.

Системная служба CRMDataExchangeService разработана специалистами компании Монолит-Инфо для работы модуля интеграции совместно с системами управления продажами, созданными на базе 1С Предприятия версий 7.7 и 8.

Данная сервисная служба реализует работу модуля в режиме автообмена. Расписание, созданное с помощью внешней обработки Exchange.ert и сохраненное в файле MIOConnect.config, проверяется через определенные интервалы времени и в случае совпадения указанного в расписании времени с текущим, происходит запуск СУП и выполнение соответствующего обмена.

Данная утилита разработана специалистами компании Монолит-Инфо для тех дистрибьюторов, которые используют системы управления продажами, созданные не на базе решений от компании 1С.

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

Внешняя компонента MIOConnect.dll была разработана специалистами компании Монолит-Инфо для обеспечения работы модуля интеграции совместно с системами управления продажами на базе 1С Предприятия версий 7.7 и 8.

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

Речь идет о настройке модуля интеграции, когда сопоставление контрагентов происходит на стороне дистрибьютора. Получить список торговых точек из CRM одним обменом нельзя. Технология работы модуля интеграции подразумевает получение данных только о тех торговых точках, заказы от которых получены в процессе обмена по схеме CRMOrder.

В случае, когда флаг сопоставления контрагентов на стороне дистрибьютора установлен, к схеме CRMOrder добавляется дополнительный набор данных CRMContragenOut, содержащий минимально необходимые данные для сопоставления (Код CRM, наименование и полное наименование торговой точки, адрес доставки). Данные из этого набора необходимо сохранить в таблице соответствия, после чего их можно будет сопоставить с данными из СУП. Таким образом, в течение одного цикла посещений торговых представителей будет получен весь список торговых точек.

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

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

- если появилось обновление внешнейн компоненты исервисной службы, тогда необходимо скачать новый дистрибутив, зайти в Панель Управления, выбрать пункт Установка и удаление программ и удалить "МОНОЛИТ: CRM. Модуль интеграции 1С.". После удаления модуля перезагружать компьютер не нужно, можно сразу установить новую версию. После установки новой версии модуля следует проверить настройки сервисной службы.

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

  1. Убедиться, что в папке, где установлен модуль есть файлы CRMDataExchangeService.exe и MIOConnect.dll
  2. Принудительно зарегистрировать их в системе. Для этого надо выполнить следующие команды: - для внешней компоненты MIOCOnnect.dll Microsoft.NETFrameworkv2.0.50727RegAsm.exe "C:Program FilesMonolit CRMMI1CMIOConnect.dll" C:Program FilesMonolit CRMMI1C - это путь, куда установлен модуль. Если у молуль установлен в другой каталог - указать его. - для сервисной службы CRMDataExchangeService: Microsoft.NETFrameworkv2.0.50727InstallUtil.exe CRMDataExchangeService.exe
  3. После этого необходимо удалить модуль стандартным способом В случае, если вышеописанные действия не помогли, придется прибегнуть к чистке реестра, то есть удалить все имеющиеся записи по MIOConnct и CCRMDataExchangeService

После установки модуля необходимо зайти в Панель управления - Администрирование - Службы. Открыть службу CRMDataExchangeService. На закладке «Вход в систему» (Log on) необходимо выбрать «Пользователь» (This account), указать пользователя, который будет использоваться при автообменах, указать его пароль, после чего следует запустить службу. 

В данной теме представлено описание общих принципов обработки заказов с КПК и возможные варианты их обработки в связке КПК - МОНОЛИТ: CRM - БД дистрибьютора.
Общие принципы обработки заказов с КПК следующие:
1. Торговый представитель создает заказ и отправляет его в CRM.
2. Тут же получает обменом сообщение "Принят в CRM".
3. Заказ из CRM поступает в СУП дистрибьютора.
4. Торговый представитель вносит в свой заказ изменения.
5. Заказ обрабатывается у дистрибьютора и удаляется, как ненужный.
6. Из СУП дистрибьютора статус заказа "Отменен" возвращается в CRM.
7. Торговый представитель проводит еще один обмен заказами.
Тут важно понимать, что если обмен заказами выполняется между CRM и СУП, то сначала выгружаются статусы, а потом по результатам обработки формируется набор данных по заказам. Если же обмен идет между КПК и CRM, то сначала выгружаются заказы, и только потом происходит обмен статусами. Поэтому в случае, когда торговый представитель отправляет статусы второй раз, у него статус заказа "Принят в CRM", тогда как в самой CRM он уже "Удален". Именно поэтому заказ повторно передается в CRM.
8. В CRM заказ снова приобретает статус "Принят в CRM"
9. Заказ передается в СУП дистрибьютора.
Если дистрибьютор использует модуль, разработанный нами, то в этом случае ему будет выдано сообщение, что такой заказ уже существует (и не важно какой статус он имеет), поэтому документ второй раз создаваться НЕ БУДЕТ. Однако, любой дистрибьютор может доработать модуль с тем, чтобы всякий приходящий заказ создавался вновь.
Поскольку по уже обработанному заказу статус дважды из СУП не передается, то в случае стандартного модуля данный заказ может передаваться несколько раз (пока не закончится срок его жизни - три дня).

Модуль интеграции CRM с 1С Предприятием версии 7.7 можно загрузить с сайта компании «Монолит-Инфо». В настоящее время он состоит из двух пакетов:

Первый пакет включает в себя исполняемый файл системной службы CRMDataExchangeService и файлы внешней компоненты MIOConnect.dll, обеспечивающей проведение обменов с веб-сервисом. Данный дистрибутив можно загрузить по ссылке: http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c.zip

Второй пакет включает в себя внешние обработки для запуска их в программе 1С. Они содержат интерфейсные формы для настройки, а программная часть включает в себя логику работы модуля интеграции. Данный пакет представляет собой zip-архив, содержимое которого следует выгружать в ту же директорию, в которой установлен первый пакет. Загрузить второй пакет можно по ссылке: http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c7_module.zip

Модуль интеграции CRM с 1С Предприятием версии 8 можно загрузить с сайта компании Монолит-Инфо. В настоящее время он состоит из двух пакетов.

Первый пакет включает в себя исполняемый файл системной службы CRMDataExchangeService и файлы внешней компоненты MIOConnect.dll, обеспечивающей проведение обменов с веб-сервисом. Данный дистрибутив можно загрузить по ссылке: http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c.zip

Второй пакет включает в себя внешние обработки для запуска их в программе 1С. Они содержат интерфейсные формы для настройки, а программная часть включает в себя логику работы модуля интеграции. Данный пакет представляет собой zip-архив, содержимое которого следует выгружать в ту же директорию, в которой установлен первый пакет. Загрузить второй пакет можно по ссылкам:

http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c8_module.zip - для 1С 8.0

http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c81_module.zip - для 1С 8.1

http://www.monolit.com/files/supportcrm/mi1c_bin/mi1c82_module.zip - для 1С 8.2

Данный флаг устанавливает местоположение таблицы сопоставления контрагентов (если флаг установлен - она находится у дистрибьютора, если нет - сопоставление происходит на сервере CRM). В случае, когда сопоставление происходит на стороне дистрибьютора, к каждому обмену CRMOrder добавляется набор данных CRMContragentOut, содержащий необходимую для сопоставления информацию (код, наименование, полное наименование и фактический адрес торговой точки). Эта информация сохраняется в таблице соответствия, после чего производится процедура сопоставления полученных данных с записями из справочников базы данных дистрибьютора. Если сопоставление происходит на стороне поставщика, то после установки модуля дистрибьютор настраивает обмен CRMExtClientAddressDef и выгружает информацию о контрагента и торговых точках, которая попадает в базу данных CRM поставщика, где и выполняется процедура сопоставления.

В связи с тем, что у дистрибьютора может быть несколько физических баз данных и, соответственно, несколько складов, к которым привязываются коды складов, переданные из систем управления продажами, компаний «Монолит-Инфо» была введена обязательная дополнительная привязка кодов баз данных к кодам складов в CRM.

В случае, если такая привязка не выполнена, при выполнении обмена CRMOrder дистрибьютор может получать заказы, относящиеся ко всем базам данных, которые зарегистрированы в CRM. Если такая ошибка возникает, необходимо уведомить отдел ИТ компании-поставщика, чтобы было проведено сопоставление кодов БД и складов.

Ошибка в версии модуля обмена для 1С Предприятия 7.7
Данная ошибка появляется в случае, когда в процессе работы модуля из-за системного сбоя происходит удаление информации из файла MIOConnect.config.

Данный файл представляет собой стандартный xml-файл, обращение к которому реализовано через вызов функций SetCongigParam и GetConfigParam внешней компоненты MIOConnect.dll. В случае, если структура файла нарушается, получить данные поля User (или любого другого поля) становится невозможно, о чем и сообщает данная ошибка.
Чтобы исправить ошибку необходимо восстановить файл MIOConnect.config из архива, или, если архива нет, переустановить модуль, предварительно сохранив внешние обработки в другом месте, чтобы они не были перезаписаны при инсталляции стандартной версии модуля. После чего придется вернуть внешние обработки на место и повторить интерактивные настройки модуля. 

Данная ошибка возникает при работе модуля интеграции с 1С версии 7.7. Необходимо в первую очередь проверить версию системы 1С, установленной на компьютере, с которого выполняется обмен. Модуль интеграции для 1С 7.7 работает с программой не старше версии 7.70.24.

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

Такое сообщение об ошибке выдается в том случае, если у дистрибьютора не установлен флаг «Согласование у дистрибутора». Модуль определяет наличие доп. набора CRMContragentOut (о чем формируется запись в журнале) и сообщает о возможной ошибке. Важно знать, что флаг «Согласование у дистрибьютора» должен быть выставлен как на стороне дистрибьютора, так и на стороне компании-поставщика и отсутствие флага необязательно означает неправильную настройку модуля у дистрибьютора. Поэтому обмен CRMOrder в любом случае будет выполнен.

При попытке выполнения обмена отгрузками или остатками выдается сообщение об ошибке "Error converting data type nvarchar to numeric". Такое сообщение возникает в случае, если при передаче числовых данных они представлены в формате с использованием разделителей разрядов (чаще всего таким разделителем служит пробел). Чтобы данная ошибка не возникала, надо изменить форматирование с разделителями на форматирование без разделителей.

Данное сообщение возникает в двух случаях.

1. При обработке набора данных CRMDespatch, анализируется информация о составе каждого входящего в набор документа. Если в документе один и тот же товар присутствует более одного раза (необходимо помнить, что экспорт отгрузок осуществляется в базовых единицах), то возникает ошибка записи в CRM, связанная с тем, что поле WareId является ключевым (в составе составного ключа). Метод решения: При формировании файла экспорта необходимо предварительно сгруппировать товары по коду CRM и просуммировать значения полей 'Количество' и 'Сумма'.

2. В набор данных CRMClientAddress заносится информация о контрагентах и торговых точках, отгрузки которым передаются в файле экспорта. В данном случае так же необходимо контролировать наличие только одной записи для каждого сочетания 'Контрагент' + 'Торговая точка'. Метод решения: аналогично предыдущему случаю, перед формированием файла создать список контрагентов и торговых точек с проверкой единственности вхождения.

Для того, чтобы обновить модуль иногда необходимо удалить уже установленную версию сервисной службы CRMExchangeService. Для обновления версии модуля необходимо удалить текущую версию. Иногда попытка удаления выдает ошибку. В этом случае может потребоваться повторная регистрация сервисной службы CRMExchangeService, которая выполняется командой: Microsoft.NETFrameworkv2.0.50727InstallUtil.exe CRMDataExchangeService.exe

После чего можно попробовать еще раз удалить модуль и установить новую версию.

Данное сообщение выдается в том случае, когда внешняя компонента по каким-либо причинам не зарегистрирована в реестре Windows. Для этого необходимо выполнить следующую команду:

Microsoft.NETFrameworkv2.0.50727RegAsm.exe

"C:Program FilesMonolit CRMMI1CMIOConnect.dll" C:Program FilesMonolit CRMMI1C - это путь, куда установлен модуль.

Если у вас модуль установлен в другой каталог - укажите его.

Если в системе CRM при просмотре документов отгрузки дистрибьютора внешние наименования выводятся в виде вопросительных знаков, это означает, что при загрузке данных была ошибочно указана неправильная кодировка.

Например, информация передается в 'UTF-8', а проставлена 'windows-1251'.

P. S. В обязательном порядке проверить правильность наименований обменов и тегов. Особенно обратить внимание на правильность написания прописных и строчных букв.

Если при попытке запуска MonolitWin.NET клиента выдается сообщение об ошибке, то необходимо скачать с сайта компании новую версию MonolitWin.NET клиента, взять из архива файл access.config и скопировать его в папку, куда установлен клиент.

з а г р у з к а