Please enable JavaScript to view this site.

Navigation: Client Functions

UpdatePartial

Scroll Prev Top Next More

Modifies one or more attributes of one or more file records

UpdatePartial function enables recording one or more attributes from a register. WRITE sentence is used in order to optimize recording and letting execution of possible Triggers

 

* filename

string

 

 

Name of file being updated.

* recordIds

string

 

 

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

* records

 

string

 

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

Dictionaries

string

Only MV Input String type

List of dictionaries to write, separated by space. In MV output format is mandatory. You may use the format LKFLDx where x is the attribute number

originalRecords

string

 

Original records for Optimistic Lock verification, separated by the Record Separator character (30) : LinkarCommon.ASCII_Chars.RS.

 

updateOptions

See below

 

 

 

UpdateOptions provides details about how the update operation(s) will be done.

inputStringType

 


 

Format of the data being used to update 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

 

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.

 

updateOptions. Contains the options for the Update functions

 

 

optimisticLockControl

boolean

false

checks out if the file has not been modified by another user

 

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.