CreateRecord

CreateRecord(datasource)

Creates a new table and table key index (if required), a new blank record and sets the current record for the specified Data Source to that record.

All

datasource - required

Specifies the Data Source to be acted on – click here for the format of this parameter.

nothing

• The blank record is created in memory and will only be appended to the local database on the mobile device when UpdateCurrentRecord is called.

  • Any columns in the record which have a default value specified in the Data Source definition will only have the default value inserted when the record is appended to the local database providing the column is empty when written to the local database. Default value(s) are not inserted into the blank record created by this Method. This is because default values are notified to the SQL engine when a table is created in the local database and are entered into empty columns by the SQL engine when a record is created. Default values are not inserted into columns by the Digitise Apps Client.

• You can call this Method whilst an asynchronous data transfer is in progress but we don't recommend it as you can't call UpdateCurrentRecord to save the record to the local database whilst the transfer is running.

• This Method isn't relevant for use with Custom Views.