setDataField()

Purpose

For native Platform objects, this method sets the value of a single Field for a specified record.

Note: For external objects (such as those mapped to external tables, to OpenEdge Service objects, or through a HDP connection), you can use the method, setDataField2() .

Syntax

setDataField(string sessionId, string id, DataField df, boolean useIds);

Parameters

sessionId

A string containing the session ID obtained at log in.

id

A long value containing the record ID.

df

A new value for the field wrapped in a DataField container.

useIds

A boolean value: if true, use numeric IDs for lookup and picklist values; otherwise, use integration codes and record names.

Output

None

Permissions Required

Edit permission for the requested object type.

Example

// Populate data Field to be set for existing record
DataField Field = new DataField();
Field.setName("R34567");
Field.setValue("100088,100089");

// Call setDataField API
long id = 123456;	// Record id - required
binding.setDataField(sessionId, id, Field, true);