@programLinkData

The @programLinkData complex property specifies details for transferring control to another VGWebTransaction program when the user submits a form or clicks a hypertext link.

The process of transferring information from one VGWebTransaction program to another is somewhat complex, and various property fields within @programLinkData are concerned with this process. You pass a VGUI record variable to the new program, and use @linkParameter properties to load up that record.

This complex property contains the following property fields:

programName

A STRING that identifies the program to invoke when the user submits the form or clicks the hypertext link. An alias is used at generation time if you specify the alias or if you specify the name of a Program part when that part has an alias and is in the current workspace.

If the VGWebTransaction program is defined and accessible from the current workspace, the package name for the VGWebTransaction program is generated into the bean to be used at run time; otherwise, the package name for the program is derived from the javaProperty value of the application entry in the hptLinkage properties file.

uiRecordName

A STRING that identifies a VGUI record to send (if any). That record includes data from the web form, from linkage parameters, or both. An alias is used at generation time if you specify the alias or if you specify the name of a VGUIRecord part when that part has an alias and is in the current workspace.

If the VGUIRecord part specified for the uiRecordName field is defined and accessible from the current workspace during generation, the package name for the VGUIRecord part is generated into the bean to be used at run time; otherwise, the package name used for the program is also used for the VGUI record.

newWindow

A Boolean that indicates whether the web page presented by the invoked program apears in a browser window different from the one from which the user submitted the form or clicked the hypertext link. Valid values are as follows:

no (the default): The web page appears in the same window. If the current form was presented by a show statement with a returning clause or by a converse statement, a new window disrupts the existing conversation with the user.
yes: The web page appears in a different window

linkParms

This is an array of @linkParameter complex properties (described later). The members of this array represent the query parameters passed to the gateway servlet. The linkParms property field contains the following complex property:

@linkParameter

Identifies the values to be placed in the input record of the receiving program. The @linkParameter complex property includes the following property fields:

name: A STRING containing the name of a gateway query parameter. For more information, see Gateway query parameters for web transactions
value: A literal STRING value to assign to the parameter.
valueRef: A STRING containing the name of a field in the record being sent to the invoked program; the value of the field is assigned to the parameter.

You cannot specify both value and valueRef in the same @linkParameter property.

Example

DataItem Prog1LinkItem char(9) {
  @ProgramLinkData { 
    programName = "my.company.sys1.PROG1", 
    linkParms = [ 
      @LinkParameter {
        name="parm1", 
        value="abc"
        }, 
      @LinkParameter {
        name="parm2",
        value="efg"
        } 
      ] 
    } 
  } 
end