# Изменение ссылочного поля

> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.


**Update Reference Field** · Resource: `operation` · Operation: `referenceFieldUpdate`

Выбрать ссылочное значение по ID, через live-поиск или кэш и записать его в существующий объект.

**Нода 0.4.1 · Ядро ЛДО 6.9**.

## Подключение и разрешения

Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/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 требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).

## Команды контракта

`n8n.reference.search (только live)`, `n8n.document.fields.update или n8n.catalog.fields.update`

Это справочные идентификаторы, а не публичные HTTP endpoints.

## Связанные материалы

[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)