Monkeybread Software - MBS FileMaker Plugin: Matrix.InsertRecords

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

Matrix.InsertRecords

Inserts records in FileMaker database from records in memory.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
Matrix	9.2	Yes	Yes	Yes	Yes	Yes

MBS( "Matrix.InsertRecords"; MatrixRef; InsertFileName; InsertTableName; FieldNames { ; StartRow; EndRow } ) More

Parameters

Parameter Description Example Flags

MatrixRef The matrix reference number. $matrix

InsertFileName The file name of where the insert table is inside. Can be empty to look for the table in all files. Get(FileName)

InsertTableName The name of the table to insert record into. "Assets"

FieldNames A list of field names for the insert.
Empty entries in the list are ignored. "Model"

StartRow The index of the start row in the current recordset.
First row is 0. 0 Optional

EndRow The index of the end row in the current recordset.
First row is 0. Last Row would be FM.SQL.RowCount-1. 0 Optional

Parameter	Description	Example	Flags
MatrixRef	The matrix reference number.	$matrix
InsertFileName	The file name of where the insert table is inside. Can be empty to look for the table in all files.	Get(FileName)
InsertTableName	The name of the table to insert record into.	"Assets"
FieldNames	A list of field names for the insert. Empty entries in the list are ignored.	"Model"
StartRow	The index of the start row in the current recordset. First row is 0.	0	Optional
EndRow	The index of the end row in the current recordset. First row is 0. Last Row would be FM.SQL.RowCount-1.	0	Optional

Result

Returns OK or error.

Description

Inserts records in FileMaker database from records in memory.
This function allows to easily copy a lot of records from a query in FileMaker database into a FileMaker table.
Please provide field names in FileMaker. The order has to match those in the record set.
Due to passing in new field names, you can even rearrange values from one column to other while copying. In the SQL you can use functions for sums or join data from several tables together to fill a new table.
Use FM.ExecuteSQL.LastErrorMessage and FM.ExecuteSQL.LastError to see error message.
Reports an error if field name list doesn't match column count of the query result.
Function will fail if data types in source and dest fields do not match for assignment. e.g. date and time fields will not work, only timestamp fields.

For insert from SQL Connection into FileMaker database, please use SQL.InsertRecords.

Blog Entries

Import CSV with Matrix functions

Release notes

Version 10.6
- Enhanced Matrix.InsertRecords to detect field data type and pass numbers and date/time/timestamp to FileMaker.

Created 8th April 2019, last changed 8th April 2019

Matrix.Height - Matrix.InsertRecordsToSQL