Please enable JavaScript to view this site.

Creates one or more new file records.

 

 

* filename

string

char*

 

 

File name to write.

* recordIds

string

char*

 

 

The list of record keys, separated by the Record Separator character (30) : LinkarCommon.ASCII_Chars.RS.

If empty, use the newOptions parameter below.

 

* records

 

string

 

Dynamic array records to be created, separated by the Record Separator character (30) : LinkarCommon.ASCII_Chars.RS.

newOptions

See below

 

 

 

 

NewOptions provides details about how the new operation(s) will be done.

inputStringType

 

 

 


Format of the data being used to create new record(s) : MV, XML or JSON.

 

outputStringType

 

 


Format of the data to be returned: MV, XML, XML_DICT, XML_SCH, JSON, JSON_DICT, JSON_SCH.

 

customVars

string

optional

This is a free text field to send in the transaction. If not empty, subroutine SUB.LK.MAIN.CONTROL.CUSTOM will be called. Add custom code to that subroutine to define special behaviours for some or all transactions.

 

receiveTimeout

Numeric

 

-1

0

 

This is the maximum time in seconds that the client will wait for a response. Use 0 for no timeout. This is a function-specific override : -1 in a Persistent function defaults back to the timeout defined in the LinkarClt constructor.

 

 

 

newOptions. Contains the options for the New function

 

newRecordIdType

See below

null

options for the creation of codes. Linkar, Custom, Random. This is compulsory if record codes are not indicated

 

readAfter

boolean

false

reads the record again and returns it after the update. Calculated, dictionaries, conversion, formatSpec and originalBuffer will only be effective if this option is true

 

calculated

boolean

false

return the resulting values from the calculated dictionaries.

 

conversion

boolean

false

execute the defined conversions in the dictionaries before returning.

 

formatSpec

boolean

false

execute the defined formats in the dictionaries before returning.

 

originalRecords

boolean

false

return a copy of the records in MV format.

 

 

newRecordIdType.Contains the options to create New function codes

 

newRecordIdTypeLinkar

See below

null

the creation options of the Linkar type code

 

newRecordIdTypeRandom

See below

null

the creation options of the Random type code

 

custom

boolean

false

customized code creation

 

 

newRecordIdTypeLinkar. Contains the options to create New function Linkar type codes

 

active

 

boolean

false

activates the creation of Linkar type code

prefix

 

string

 

adding a prefix to the code

separator

 

string

 

the separator between the prefix and the code. The allowed separators list is: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~

formatSpec

 

string

 

the code format, under the database syntax

 

newRecordIdTypeRandom. Contains the options to create Random type codes from New function

 

active

 

boolean

false

activates the creation of Random type code

numeric

 

boolean

false

indicates if the code must be numeric

length

 

Numeric

0

length of the code to create. This must be bigger than 0