read_list_row
Reads multiple columns of a specific dynamic-list row in one call, optionally targeting the row by column value first; returns the row's data.
Instructions
Read SEVERAL columns of a dynamic-list row in ONE call. Opens the list at open_link (e.g.
e1cib/list/Справочник.Товары) and reads each name in columns (e.g. ["Код", "Наименование"]) of the
standard dynlist table Список. Returns {table, nav_link, row: {column: value}, list_refresh} (+ where
when given).
where selects the ROW: omit it to read the FIRST (current) row; pass a single {column: value} (e.g.
{"Наименование": "Молоко"}) to position the list to the row WHERE column == value first — the «в таблице
"Список" я перехожу к строке: | col | value |» equivalent — then read THAT row. The where-row path is a faithful
full-sequence replay of a genuine DYNLIST go-to-row-by-value capture (a splice of the FORM-table «перехожу к
строке» onto a live dynlist did NOT reposition; the full-sequence replay does), value retargeted in-frame;
live-verified on Товары (Наименование=Молоко -> Код 000000026 vs OData). Matching by «Наименование» is the
verified path. One row read per fresh launch_test_client (the cold-client boundary), reading all requested
columns inside the one materialised session (message-id kept, sequence bumped). CURRENCY:
refresh=True (default) forces an «Обновить»/F5 requery + poll-until-stable so an all-None row is only ever a
genuinely empty row, not a not-yet-loaded list; refresh=False opts out. For iterating every row use
read_list_grid; read_list_column for a single cell; read_table_cell for FORM tables.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | 127.0.0.1 | |
| port | No | ||
| where | No | ||
| columns | Yes | ||
| refresh | No | ||
| open_link | Yes | ||
| capture_dir | No | listform-read |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||