Обмен с 1С ODATA от ОКТЕТ

В данный момент обмен производится в одностороннем порядке из 1С в битрикс24. Аналогично методу GET протокола ODATA. В будущем планируется расширение функционала.

Особенности и ограничения:

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

Установка робота/Активити

Откройте приложение на вкладке «Конструктор обработчика»

В списке «выбор метаданных» выберите объект, который необходимо получать из 1С. В нашем примере будем получать информацию о Document_СчетНаОплатуПокупателю из 1С Бухгалтерия 8.3. Будем получать общую сумму в 1С по номеру счета.

По-умолчанию будут получены все поля объекта, что создаст лишнюю нагрузку на 1С и на весь механизм обмена, включая Б24, поэтому рекомендуется выбрать только необходимые поля. Для добавления полей в результат нажмите на иконку «+» напротив нужного свойства объекта

После этого в списке отбора полей появится выбранное свойство (В нашем случае это СуммаДокумента)

Далее требуется добавить фильтр. Если не добавлять фильтр, то в результате выполнения будет получен только первый документ(это связано с ограничениями возвращаемых значений Битрикс24).

Number — название выбранного свойства для фильтрации

string — тип поля(в данном случае строка)

Параметр — означает, то это свойство будет переменной, задаваемой в роботе или бизнес процессе. Если «галочка» снята, то в роботе постоянно будет устанавливаться значение заданное в поле «текст»

В выпадающем списке устанавливается оператор сравнения на основе которого будет выполняться фильтрация данного свойства.

Для проверки требуется заполнить поле «текст»

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

Получим следующий текст запроса:

Параметры, которые подлежат замене в бизнесс-процессе обрамляются фигурными скобками с процентами( {%переменная%} ), которые в процессе обработки заменяются на полученное от Битрикс24 значение. Например, если указан Number = 100 запрос к 1С будет такой: $filter=Number eq '100'&$select=Number

В виду того, что в формате запроса ODATA имеется множество нюансов, конструктор запросов в данный момент может работать лишь с меньшей частью, поэтому пользователю может самостоятельно вносить корректировку в текст запроса для выполнения более сложных фильтраций. Больше информации можно получить на сайте https://1cfresh.com/articles/data_odata

Когда текст запроса сформирован нажимаем «Отправить запрос»

Должен быть получен результат запроса в виде выбранного свойства и его значения.

Если в фильтре допущена ошибка или ни одного объекта по критериям не найдено, то будет возвращена ошибка

Нажмите «создать обработчик» для установки активити. Откроется окно настройки:

Введите название, которое будет отображаться в списке роботов и дизайнере бизнес-процессов. Название будет в виде НазваниеПриложение_ВашеНазвание.

Вы можете увидеть основную информацию об устанавливаемом активити.

Чекбокс «Добавить робота» указывает добавить ли робота и активити бизнес-процесса. Если чекбокс не отмечен, то будет добавлено только активити бизнесс-процесса.

Нажмите «создать» для завершения процесса установки активити.

Откроется вкладка «Установленные обработчики» с только что добавленным активити

Теперь в списке роботов появится новый в разделе «Другие роботы»

При добавления робота мы увидим параметры, которые указывали в фильтре

Либо в дизайнере бизнесс-процесса

Свойства действия:

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