> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-forms-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/dataconnections/primary_dc/update_rows.md). # UpdateRows Set-проперти UpdateRows изменяет значения полей GetDataConnection в строках с указанными индексами на соответствующее значение из массива или матрицы. ## Шаблон UpdateRows ```xml True False True ``` ### Параметры #### Параметр **RowIndices** Обязательный параметр. Массив индексов строк для изменения.\ Ожидает линейный массив неотрицательных целочисленных значений. #### Параметр **ColumnNames** Обязательный параметр. Массив названий полей для обновления значений.\ Ожидает линейный массив строковых значений. #### Параметр **Values** Обязательный параметр. Массив или матрица новых значений.\ Ожидает линейный массив или матрицу любых значений. #### **П**араметр **ReplicateValues** Необязательный параметр. Признак, определяющий каким образом обрабатывать значение параметра Values.\ Ожидает логическое значение. По умолчанию используется значение True. Если параметр ReplicateValues имеет значение **False**, то значение **параметра Values** рассматривается **как матрица значений**, которые будут записаны в строки с индексами, указанными в параметре RowIndices. При этом будут соблюдаться правила: * Если количество элементов строки матрицы не совпадает с количеством полей, указанных в параметре ColumnNames, то в соответствующие ячейки ставится значение NULL; * Если количество строк матрицы не совпадает с количеством индексов, указанных в параметре RowIndices, то в ячейки строк, для которых отсутствуют строки в матрице, ставится значение NULL. Если параметр ReplicateValues имеет значение **True**, то значение **параметра** **Values** рассматривается **как линейный массив значений**, который заполняет каждую строку, подставляя элементы в соответствующие колонки. #### Параметр **RawValues** Необязательный параметр. Признак того, что значения необходимо подставлять "как они есть" - без преобразования в массив скалярных значений.\ Ожидается логическое значение. По умолчанию используется значение False. #### Параметр **FireChanged** Необязательный параметр. Признак того, что соединение с данными будет рассылать событие об изменении данных при выполнении set-проперти.\ Ожидается логическое значение. По умолчанию используется значение True. ## Примеры В примерах будем использовать PrimaryGetDataConnection вида: ```xml ``` В котором будет следующий набор данных:

### Одно значение в одно поле Если необходимо *в строках в одно поле* указать *одинаковое значение*, то в параметре Values достаточно передать *скалярное значение*, а параметру ReplicateValues оставить значение *True* (по умолчанию). Пример команды: ```xml 1 2 FourthField 99 True ``` В этом случае получим:

### Разные значение в одно поле Если необходимо в строках *в одно поле* указать *разные значения*, то в параметре Values необходимо передавать *матрицу значений* (таблицу), а параметру ReplicateValues задавать значение *False*. Пример команды: ```xml 1 2 FourthField 99 98 False ``` В этом случае получим:

#### Как не правильно Если в параметре Values передадим *массив значений* и параметру ReplicateValues оставим значение по умолчанию (True), то в каждую строку будет подставлено одно и тоже значение - первый элемент массива. Остальные элементы массива будут отброшены. Если в параметре Values передадим *массив значений* при этом для параметра ReplicateValues укажем значение *False*, то массив значений будет преобразован в *матрицу из одной строки* с элементами исходного массива. Заменится значение поля только первой строки первым элементом исходного массива. В остальных строках будет подставлено значение NULL. Сработало правило: > Если количество строк матрицы не совпадает с количеством индексов, указанных в параметре RowIndices, то в ячейки строк, для которых отсутствуют строки в матрице, ставится значение NULL. Пример команды: ```xml 1 2 4 FourthField 99 98 97 False ``` В этом случае получим:

### Одинаковые значения в разные строки Если необходимо в строках *в несколько полей* задать *одинаковые значения*, то в параметре Values необходимо передать *массив значений* и параметру ReplicateValues оставить значение *True* (по умолчанию). Тогда значения из массива будут подставлены в каждую строку. Пример команды: ```xml 1 2 SecondField FourthField New text 99 True ``` В этом случае получим:

### Разные значения в разные строки Если необходимо в строках *в несколько полей* задать *разные значения*, то в параметре Values необходимо передать *матрицу значений* и параметру ReplicateValues задать значение *False*. Тогда значения из матрицы будут построчно подставлены в соответствующую строку в порядке перечисления индексов и значений в матрице. Пример команды: ```xml 1 2 SecondField FourthField New text 99 Other text 98 False ``` В этом случае получим:

{% hint style="warning" %} Если в этом примере для параметра ReplicateValues оставим значение True (по умолчанию), то матрица значений: ``` +--------------+------+ | New text | 99 | | Other text | 98 | +--------------+------+ ``` преобразуется в линейный массив: ``` +------------+--------------+ | New text | Other text | +------------+--------------+ ``` Такая команда будет вставлять в каждую строку одинаковые значения. Если тип колонки не совпадает с типом вставляемого значений, то команда выбросит ошибку System.FormatException. {% endhint %} ### `` в качестве источника данных \ возвращает таблицу (матрицу) ```xml 1 2 SecondField FourthField New text 99 Some text 50 Other text 98 55 False ``` Если в ячейках таблицы храниться массив. А такое возможно?