Общая информация
Платформа ROBIN поддерживает несколько вариантов работы с приложениями 1С:
- Через графический интерфейс. В этом случае робот имитирует поведение пользователя и работает с приложением используя действия групп "Машинное зрение", "Windows", "Имитация устройств".
- С помощью специальных действий по группы "1С". Действия этой групп позволяют работать с приложениями 1С не через графический интерфейс, окна и кнопки, а используя программные интерфейсы 1С. Такой способ работы является более надежным и предпочтительным для обработки больших массивов данных.
Включение oData на стороне сервера:
Одним из способов взаимодействия программных роботов с 1C через программные интерфейсы, является протокол oData. Это стандартизированный протокол работы с данными, в основе которого лежит REST. 1С активно развивает его с версии 8.3.5 и на сегодняшний день этот протокол является наиболее полным и стандартизованным, простым и безопасным способом работы с 1С*.
*https://infostart.ru/1c/articles/711302/
https://infostart.ru/public/403426/
Для того, чтобы роботом иметь возможность использовать стандартные методы 1C, необходимо включить oData на стороне сервера, для этого необходимо выполнить шаги:
- Запустить 1С от имени администратора.
- В пункте меню "Администрирование" выбрать "Публикация на веб-сервере".
- Включить "Публиковать стандартный интерфейс OData".
- Нажать "Опубликовать".
- После этого нужно будет определить состав интерфейса oData, т.е. указать — какие объекты конфигурации в него входят, а какие нет (изначально в составе нет ни одного объекта).
- Сформировать ссылку на опубликованный web-сервис можно по шаблону
http://<имя|АдресСервера1С>/<ИмяБазы1С >/odata/standard.odata - Все, теперь вы можете обращаться через программного робота в 1с.
Изменить объект / Modify object
Действие предназначено для модификации объекта OData 1C.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Соединение с сервисом 1C | Connection with 1C service | Контекст соединения с сервисом 1C | Robin.SimpleOData | Да | |
Коллекция сущностей 1C | 1C entity | Имя коллекции сущностей 1C (справочники, документы и т.п.) | Robin.String | Да | |
Ключ коллекции | Entity key | Ключевой идентификатор коллекции (Ref_Key). Подразумевается GUID либо любой приводимый к GUID тип. Например строка вида „B27E52AF-1FBF-4DA5-9460-619D4143AB37“ | Robin.Object | Да | |
Список изменений | Change list | Список (словарь) данных для модификации в виде ключ-значение | Robin.Dictionary | Да | |
Результаты | |||||
Измененная сущность | Modifyed entity | Содержимое сущности с результатами изменения | Robin.Object |
Особые условия
Отсутствуют.
Открыть соединение / Open connection
Действие предназначено для открытия соединения с сервисом OData 1C.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Урл сервиса | Service URL | Урл сервиса (как правило заканчивается на odata/standard.odata/) | Robin.String | Да | |
Логин | Login | Логин пользователя для доступа к сервису | Robin.String | Нет | |
Пароль | Password | Пароль пользователя для доступа к сервису | Robin.Password | Нет | |
Домен | Domain | Домен пользователя для доступа к сервису (если необходим) | Robin.String | Нет | |
Результаты | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие. | Robin.SimpleOData |
Особые условия
Отсутствуют.
Получить объект / Get single object
Действие предназначено для получения объекта OData 1C в единственном экземпляре.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Соединение с сервисом 1C | Connection with 1C service | Контекст соединения с сервисом 1C | Robin.SimpleODat a | Да | |
Коллекция сущностей 1C | 1C entity | Имя коллекции сущностей 1C (справочники, документы и т.п.) | Robin.String | Да | |
Фильтр для коллекции | Entity filter | Выражение фильтрации коллекции (например Description eq „Рога и Копыта“) | Robin.String | Да | |
Результаты | |||||
Найденная сущность | Founded entity | Содержимое найденой сущности | Robin.Object |
Особые условия
Отсутствуют.
Получить список объектов / Get objects collection
Действие предназначено для получения объектов OData 1C в виде таблицы.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | |||||
Соединение с сервисом 1C | Connection with 1C service | Контекст соединения с сервисом 1C | Robin.SimpleOData | Да | |
Коллекция сущностей 1C | 1C entity | Имя коллекции сущностей 1C (справочники, документы и т.п.) | Robin.String | Да | |
Фильтр для коллекции | Entity filter | Выражение фильтрации коллекции (например Description eq „Рога и Копыта“) | Robin.String | Да | |
Перечень запрашиваемых полей сущностей | Entity fields list | Перечень полей для получения через запятую (например Ref_Key, Description, DeletionMark) | Robin.String | Нет | |
Лимит отбора | Select limit | Каким количеством строк ограничивать возврат списка (по-умолчанию 10 строк) | Robin.Numeric | Нет | |
Результаты | |||||
Найденные сущности в виде таблицы | Founded entitys as table | Таблица найденных сущностей | Robin.DataTable |
Особые условия
Отсутствуют.