ObjectInsertObject (Method)

Overview

Type:

Method

Available as of:

V1.5.4.0

Functional Description

This method is used to insert a new object in the hierarchy level as the selected element. The object is inserted as the next element from the selected element.

The return value of type BOOL indicates TRUE if the execution has been processed successfully.

Interface

Input

Data type

Description

i_sName

STRING

Represents the name of the inserted object.

NOTE: By executing this method, a previously detected error indicated by the corresponding properties is reset. The parent element of the selected element must be of type TypeObject. Refer to ET_JsonValueType.

Example

Calling the method inserts the element marked in bold in the example:

Initial State

After Executing the Method 

{
"SelectedObject" : {},
"ExistingValue" : TRUE
}

{
"SelectedObject" : {},
"NewObject" : {},
"ExistingValue" : TRUE
}