Data Table Add Records
Add multiple rows to a DataTable from another table, a table asset, a table component, or a list of records/components.
Parameters
| Parameter | Description |
|---|---|
| Data Table Source | Select the destination DataTable. Set Source, then assign the matching table, asset, or component field that appears. |
| Data Definition | Optional table definition if the resolved destination table is not known at edit time. |
| Source | Choose where to read source rows from: DataTableComponent, DataTableAsset, DataTable, DataComponents, or DataRecords. |
| Source Selection | Assign the source field shown for the selected Source. For table-based sources this can be a DataTable, DataTableAsset, or DataTableComponent. |
| Records | List of DataRecord source rows (if Source=DataRecords). |
| Data Components | List of DataRecordComponent source rows (if Source=DataComponents). |
| Use Source Keys | Preserve source row keys if available. |
| Added Count | Output number of rows added. |
| Added | True if any rows were added. |
Details
- Resolves the destination table from
Data Table Source. - Selects the source rows based on
Source. - When
Sourceis set toDataTableComponent,DataTableAsset, orDataTable, it copies every row from that table into the destination table. - When
Sourceis set toDataComponentsorDataRecords, it copies each matching record from the selected list. - Supports copying row keys when
Use Source Keysis enabled.
Examples
- Copy all rows from a staging DataTable asset into a runtime table.
- Add all rows from a staging record list into a live table.
- Merge data from component-backed rows into a shared table.