hmRep_Create VStructure Field ( Area ; tableNo ; fieldNo ; caption) → ID

Introduced in v4.0, Preemptive: yes

Parameter	Type	In/Out	Description
Area	Longint	→	hmReports area
TableNo	Longint	→	Table number
FieldNo	Longint	→	Field number
Caption	Text	→	Caption of the field
ID	Longint	←	ID of the item

Description

The command hmRep_Create VStructure Field creates a Virtual Structure item for a 4D Field. Pass the internal 4D Table number in the parameter tableNo. Pass the internal 4D Field number in the parameter fieldNo. To set a custom caption for the field, you can set the name in the parameter caption. If the command was successful, the unique ID is returned.

If the caption is an empty string, the field is not visible in the table drop down menu in the object properties.

If you want to add this virtual structure to the global virtual structure, just pass 0 in the parameter area. If you pass a valid area, the record goes to the virtual structure of the area.

Example

The example shows, how the create a Virtual Structure Item with a custom Table name:

var $vl_id : Integer

$vl_id:=hmRep_Create VStructure Field(hmRep; Table(->[x_Customers]); Field(->[x_Customers]x_ID); "ID")

The following example shows, how to hide a field in the object properties:

var $vl_id : Integer

$vl_id:=hmRep_Create VStructure Field(hmRep; Table(->[x_Customers]); Field(->[x_Customers]x_ID); "")