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.