Update Reference Field · Resource: operation · Operation: referenceFieldUpdate
Выбрать ссылочное значение по ID, через live-поиск или кэш и записать его в существующий объект.
Нода 0.4.1 · Ядро ЛДО 6.9.
Подключение и разрешения
Транспорты: Своя очередь, Прямой HTTP, MSRV.
- Ссылочное write-поле и соответствующий selection mode разрешены; штатные права записи.
Настройка в n8n
Выберите LDO 1C, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
|---|---|---|---|
Connection Name or ID / connectionId |
options · да | "" |
Динамический список из подключённой базы: getConnections; Своя очередь |
Object Type Name or ID / referenceObjectType |
options · да | "" |
Динамический список из подключённой базы: getReferenceWritableObjectTypes; Своя очередь, Прямой HTTP, MSRV |
Reference Field Name or ID / referenceFieldId |
options · да | "" |
Динамический список из подключённой базы: getReferenceWriteFields; Своя очередь, Прямой HTTP, MSRV |
Object ID / referenceOwnerId |
string · да | "" |
Своя очередь, Прямой HTTP, MSRV |
Expected Object Revision / referenceOwnerRevision |
string · да | "={{$json.revision}}" |
Своя очередь, Прямой HTTP, MSRV |
Value Source / referenceValueMode |
options · да | "id" |
ID: id; Search at Execution: live; From Cache: cache; Своя очередь, Прямой HTTP, MSRV |
Reference Value ID / referenceValueId |
string · да | "" |
Показывается при {"referenceValueMode": ["id"]}; Своя очередь, Прямой HTTP, MSRV |
Reference Search Query / referenceLiveQuery |
string · да | "" |
Показывается при {"referenceValueMode": ["live"]}; Своя очередь, Прямой HTTP, MSRV |
Cached Reference Value Name or ID / referenceCachedId |
options · да | "" |
Показывается при {"referenceValueMode": ["cache"]}; Динамический список из подключённой базы: getReferenceCacheValues; Своя очередь, Прямой HTTP, MSRV |
Timeout (Seconds) / timeoutSeconds |
number · нет | 900 |
Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
Poll Interval (Seconds) / pollSeconds |
number · нет | 2 |
Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
Результат
- object
- revision
- changes
- _ldo.reference: mode, id, presentation при наличии
Пример workflow
Get Document Fields → Update Reference Field: Search at Execution → единственное разрешённое значение → запись.
Ограничения
- Live-поиск должен вернуть ровно одно совпадение.
- Кэш ограничен политикой и повторно проверяется в 1С при записи.
- Операция синхронная; Wait for Result и пользовательский Command ID не управляют её составными шагами.
Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
- revision_conflict: документ изменился после чтения; прочитайте его снова и пересмотрите изменение.
- field_value_invalid: значение не соответствует разрешённому типу.
- Ноль или несколько совпадений; выбранное значение отсутствует в текущем кэше.
Совместимость
Доступно с нодой 0.3.0 и ядром 6.7 в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. Совместимость и ограничения.
Команды контракта
n8n.reference.search (только live), n8n.document.fields.update или n8n.catalog.fields.update
Это справочные идентификаторы, а не публичные HTTP endpoints.
Связанные материалы
Все операции · Начало работы · Другие возможности