1C OData предоставляет стандартный интерфейс OData v3 для приложений 1C:Enterprise (1C:Бухгалтерия, 1C:ERP, 1C:Управление торговлей и другие). Позволяет выполнять операции CRUD над любой сущностью 1C — справочниками, документами, регистрами — и поддерживает вызов функций бизнес-процессов.
С помощью интеграции 1C OData в AACFlow можно:
- Получить список сущностей: Запрашивать коллекции с фильтрацией, сортировкой и постраничной выборкой
- Получить сущность: Получить один запись сущности по ключу
- Создать сущность: Добавить новые записи в справочники или создать документы
- Обновить сущность: Изменить существующие записи
- Удалить сущность: Удалить записи
- Вызвать функцию: Вызвать функции бизнес-процессов 1C и HTTP-сервисы
Эта интеграция обеспечивает глубокую автоматизацию корпоративных систем 1C из рабочих процессов AACFlow.
Инструкции по использованию
Интегрируйте 1C OData в рабочий процесс. Требуется базовый URL стандартной конечной точки OData 1C (например, http://server/base/odata/standard.odata) и учетные данные базовой аутентификации (имя пользователя и пароль пользователя 1C с правами доступа к API).
Инструменты
1c_odata_list_entities
Запросить коллекцию сущностей 1C
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
baseUrl | string | Да | 1C OData endpoint base URL |
username | string | Да | 1C username |
password | string | Да | 1C password |
entity | string | Да | Entity name (e.g. Catalog_Номенклатура) |
filter | string | Нет | OData filter expression |
top | number | Нет | Maximum records to return |
skip | number | Нет | Records to skip for постраничная выборка |
select | string | Нет | Comma-separated field names |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
value | array | Массив entity records |
count | number | Total record count (if $count=true) |
1c_odata_get_entity
Получить a single entity by key
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
baseUrl | string | Да | 1C OData endpoint base URL |
username | string | Да | 1C username |
password | string | Да | 1C password |
entity | string | Да | Entity name |
key | string | Да | Entity key value (GUID or string) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
record | object | Entity record object |
1c_odata_create_entity
Создать новый entity record
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
baseUrl | string | Да | 1C OData endpoint base URL |
username | string | Да | 1C username |
password | string | Да | 1C password |
entity | string | Да | Entity name |
data | object | Да | Record field values |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
record | object | Created entity record |
success | boolean | Произошла ли record was created |
Ссылки
- Official API: https://v8.1c.ru/platforma/odata/
- AACFlow block source: apps/aacflow/blocks/blocks/1c_odata.ts