Crear filas

# Crear filas

### Crear una sola fila

Puedes crear una nueva fila en una tabla de {{%link href="/es/cloud-scale/help/data-store/introduction"%}}Data Store{{%/link%}} de la instancia dada usando el método {{%badge%}}**newRow()**{{%/badge%}}. Debes establecer los valores de las filas en la tabla, especificando el nombre de la columna y el valor de fila correspondiente como un par clave-valor.

El {{%badge%}}&lt;ROW_INSTANCE&gt;{{%/badge%}} utilizado en la sintaxis de código a continuación es la instancia definida en la {{%link href="/es/sdk/flutter/v2/cloud-scale/data-store/create-row-instance"%}}página de instancia de fila{{%/link%}}.

{{%code class="language-bash line-numbers"%}}Future<(APIResponse, ZCatalystRow)> &lt;ROW_INSTANCE&gt;.create(){{%/code%}}

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Si una columna fue creada con la propiedad {{%badge%}}{{%bold%}}is_unique{{%/bold%}}{{%/badge%}} o {{%badge%}}{{%bold%}}is_mandatory{{%/bold%}}{{%/badge%}} habilitada, debes asegurarte de que el valor sea único o se pase obligatoriamente, respectivamente. También debes asegurarte de que los datos que pases para una columna sean del tipo de dato configurado de la columna.{{%/note%}}

A continuación se muestra un fragmento de código de ejemplo con la creación de una instancia de fila:

{{%code class="language-bash line-numbers"%}}var row = ZCatalystApp.getInstance()
      .getDataStoreInstance()
      .getTableInstance(identifier: 'Products')
      .newRow(); //Definir la instancia de fila para la tabla y pasar los datos clave-valor de la fila
  row.setColumnValue('product_name', 'power_bank');
  row.setColumnValue('product_price', 2000);
  row.setColumnValue('product_quantity', 2);

try {
   var (response, row) = await row.create();
   print('New row created successfully : ${row.id}');
} on ZCatalystException catch (ex) {
  print('Failed to create the row: $exception');
}{{%/code%}}

<br>

### Crear múltiples filas

Catalyst Flutter SDK te permite crear múltiples filas a la vez en una tabla de la instancia dada. Esto se hace pasando una lista que contiene las filas que necesitan ser insertadas en la tabla. La lista se pasa como argumento al método {{%badge%}}**createRows()**{{%/badge%}}, como se muestra en la sintaxis de código a continuación.

El {{%badge%}}&lt;TABLE_INSTANCE&gt;{{%/badge%}} utilizado en el código a continuación es la instancia definida en la {{%link href="/es/sdk/flutter/v2/cloud-scale/data-store/create-table-instance"%}}página de instancia de tabla{{%/link%}}.

{{%code class="language-bash line-numbers"%}}Future<(APIResponse, List&lt;ZCatalystRow&gt;)> &lt;TABLE_INSTANCE&gt;.createRows(List&lt;ZCatalystRow&gt; rows){{%/code%}}

**Parámetros**:

* {{%badge%}}**rows**{{%/badge%}}: El array de filas a crear

A continuación se muestra un fragmento de código de ejemplo con la creación de instancias de fila:

{{%code class="language-bash line-numbers"%}}List&lt;ZCatalystRow&gt; newRows = []; //Crear un array
//Definir instancias de fila para las filas a crear
  ZCatalystRow row1 = 
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row1.setColumnValue('product_name', 'a');
  row1.setColumnValue('product_price', 25);
  row1.setColumnValue('product_quantity', 50);

ZCatalystRow row2 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row2.setColumnValue('product_name', 'b');
  row2.setColumnValue('product_price', 30);
  row2.setColumnValue('product_quantity', 40);

ZCatalystRow row3 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row3.setColumnValue('product_name', 'c');
  row3.setColumnValue('product_price', 25);
  row3.setColumnValue('product_quantity', 70);
//Agregar instancias de fila al arreglo
  newRows.add(row1);
  newRows.add(row2);
  newRows.add(row3);
try{
  var (response, rows) = await dataStore.getTableInstance(identifier: 'Products').createRows(rows: newRows);
  for (var row in rows) {
            print(row.id); //Acciones a ejecutar cuando se creen las filas correctamente
  }
} on ZCatalystException catch (ex) {
  print('The IDs of the rows that were successfully created are listed below:')
}{{%/code%}}

Crear una sola fila

Puedes crear una nueva fila en una tabla de Data Store de la instancia dada usando el método newRow(). Debes establecer los valores de las filas en la tabla, especificando el nombre de la columna y el valor de fila correspondiente como un par clave-valor.

El <ROW_INSTANCE> utilizado en la sintaxis de código a continuación es la instancia definida en la página de instancia de fila.

copy

         Future<(APIResponse, ZCatalystRow)> <ROW_INSTANCE>.create()

Nota: Si una columna fue creada con la propiedad is_unique o is_mandatory habilitada, debes asegurarte de que el valor sea único o se pase obligatoriamente, respectivamente. También debes asegurarte de que los datos que pases para una columna sean del tipo de dato configurado de la columna.

A continuación se muestra un fragmento de código de ejemplo con la creación de una instancia de fila:

copy

var row = ZCatalystApp.getInstance()
      .getDataStoreInstance()
      .getTableInstance(identifier: 'Products')
      .newRow(); //Definir la instancia de fila para la tabla y pasar los datos clave-valor de la fila
  row.setColumnValue('product_name', 'power_bank');
  row.setColumnValue('product_price', 2000);
  row.setColumnValue('product_quantity', 2);
try {
var (response, row) = await row.create();
print(‘New row created successfully : ${row.id}’);
} on ZCatalystException catch (ex) {
print(‘Failed to create the row: $exception’);
}

Crear múltiples filas

Catalyst Flutter SDK te permite crear múltiples filas a la vez en una tabla de la instancia dada. Esto se hace pasando una lista que contiene las filas que necesitan ser insertadas en la tabla. La lista se pasa como argumento al método createRows(), como se muestra en la sintaxis de código a continuación.

El <TABLE_INSTANCE> utilizado en el código a continuación es la instancia definida en la página de instancia de tabla.

copy

         Future<(APIResponse, List<ZCatalystRow>)> <TABLE_INSTANCE>.createRows(List<ZCatalystRow> rows)

Parámetros:

rows: El array de filas a crear

A continuación se muestra un fragmento de código de ejemplo con la creación de instancias de fila:

copy

List<ZCatalystRow> newRows = []; //Crear un array
//Definir instancias de fila para las filas a crear
  ZCatalystRow row1 = 
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row1.setColumnValue('product_name', 'a');
  row1.setColumnValue('product_price', 25);
  row1.setColumnValue('product_quantity', 50);
ZCatalystRow row2 =
dataStore.getTableInstance(identifier: ‘Products’).newRow();
row2.setColumnValue(‘product_name’, ‘b’);
row2.setColumnValue(‘product_price’, 30);
row2.setColumnValue(‘product_quantity’, 40);
ZCatalystRow row3 =
dataStore.getTableInstance(identifier: ‘Products’).newRow();
row3.setColumnValue(‘product_name’, ‘c’);
row3.setColumnValue(‘product_price’, 25);
row3.setColumnValue(‘product_quantity’, 70);
//Agregar instancias de fila al arreglo
newRows.add(row1);
newRows.add(row2);
newRows.add(row3);
try{
var (response, rows) = await dataStore.getTableInstance(identifier: ‘Products’).createRows(rows: newRows);
for (var row in rows) {
print(row.id); //Acciones a ejecutar cuando se creen las filas correctamente
}
} on ZCatalystException catch (ex) {
print(‘The IDs of the rows that were successfully created are listed below:’)
}

Última actualización 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Data Store Records Insert Row - API