OD Insert in context

version 1.5

OD Insert in context (context_ID{; index}) Integer

Parameter	Type		Description
context_ID	Longint		Context identifier
index	Integer		Index of table
Function result	Integer		Error code
			1 = the operation is successful
			-1 = an error occurs

OD Insert in context creates a new row on the Oracle server using 4th Dimension objects that have been specified in context binds.

context_ID must be a previously created and active context identifier.

index applies only to binds involving arrays. If index is not specified, OD Insert in context creates a new row using the array elements corresponding to the number of the current row. If the number of the row is greater than the size of the array, OD Insert in context returns -1.

If index is specified, OD Insert in context creates a new row using the lines of the array at index index. If index is greater than the size of the array, OD Insert in context returns -1.

OD Insert in context sends a SQL query of the INSERT… type and specifies only the columns that are part of the context and that have the kForUpdate option set (see OD ADD TO CONTEXT).

Executing OD Insert in context does not modify the current row and does not place the new row in the context.

OD Insert in context returns 1 if it succeeds and -1 if an error occurs.

OD Delete in context, OD Update in context.