# Поиск документов

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


**Search Documents** · Resource: `operation` · Operation: `documentSearch`

Найти разрешённые объекты по фильтрам локальной политики без ручного UUID.

**Нода 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/).

- Отдельный search-grant; штатное Чтение и RLS. Запись ссылочного поля не требуется.
- Имена реквизитов задаются только в локальной политике; клиент выбирает опубликованный ID фильтра.

## Настройка в n8n

Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.

| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Document Type Name or ID / `searchObjectType` | options · да | `""` | Динамический список из подключённой базы: getSearchDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Filters / `searchFilters` | fixedCollection · да | `{}` | Своя очередь, Прямой HTTP, MSRV |
| Result Mode / `searchResultMode` | options · нет | `"list"` | List: list; Single Match: single; Своя очередь, Прямой HTTP, MSRV |
| Return All / `searchReturnAll` | boolean · нет | `false` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой HTTP, MSRV |
| Limit / `searchLimit` | number · нет | `20` | Показывается при {"searchResultMode": ["list"], "searchReturnAll": [false]}; Границы: {"min": 1, "max": 50}; Своя очередь, Прямой HTTP, MSRV |
| Cursor / `searchCursor` | string · нет | `""` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой 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С. Пустое значение не отменяет локальные разрешения.

### Вложенные параметры

Поля коллекции и варианты Match из описания ноды:

```json
{
  "searchFilters": [
    {
      "name": "conditions",
      "displayName": "Filter",
      "values": [
        {
          "displayName": "Filter Name or ID",
          "name": "field",
          "type": "options",
          "default": "",
          "required": true,
          "description": "Choose from the list, or specify an ID using an <a href=\"https://docs.n8n.io/code/expressions/\">expression</a>",
          "typeOptions": {
            "loadOptionsMethod": "getSearchFilters",
            "loadOptionsDependsOn": [
              "searchObjectType"
            ]
          }
        },
        {
          "displayName": "Match",
          "name": "match",
          "type": "options",
          "default": "exact",
          "options": [
            {
              "name": "Between Dates",
              "value": "between"
            },
            {
              "name": "Contains",
              "value": "contains"
            },
            {
              "name": "Exact",
              "value": "exact"
            },
            {
              "name": "Starts With",
              "value": "startsWith"
            }
          ],
          "description": "Only modes permitted by the selected local filter are accepted"
        },
        {
          "displayName": "Value",
          "name": "value",
          "type": "string",
          "default": "",
          "required": true,
          "description": "Text, reference ID, or calendar date YYYY-MM-DD; for Between Dates this is the first day"
        },
        {
          "displayName": "Last Day",
          "name": "to",
          "type": "string",
          "default": "",
          "description": "Inclusive last calendar day YYYY-MM-DD for Between Dates"
        }
      ]
    }
  ]
}
```

## Результат

- Отдельный output item на объект: object.type/id, revision, values
- _ldo.command_id и _ldo.search.has_more/next_cursor

## Пример workflow

Search → Get Fields с выражениями object.type/id из результата.

```text
Входной номер/наименование → Search (Single Match) → Get Fields
```

ID следующего шага: `={{$json.object.id}}`; тип: `={{$json.object.type}}`.

[Полное руководство по универсальному поиску](https://ldo.msrv.tech/docs/n8n/search/).

## Ограничения

- Single Match требует ровно один результат; пустой List возвращает ноль items.
- Return All ограничен локальной политикой (не более 200); размер страницы 1–50.
- Курсор связан с профилем, ревизией и фильтрами; политика проверяется при каждой странице.
- Документы: номер и календарная дата/период. Справочники: наименование/код; дополнительные поля (например ИНН) задаются локальным отображением метаданных.

## Ошибки и отказы

- access_denied, invalid_filter, filter_not_allowed, search_too_broad, object_not_found, ambiguous_match, cursor_invalid, search_limit_exceeded

## Совместимость

Доступно с нодой **0.4.0** и ядром **6.8** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).

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

`n8n.document.search`

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

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

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