# 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 ``` Если в ячейках таблицы храниться массив. А такое возможно? --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/dataconnections/primary_dc/update_rows.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.