The complex property @programLinkData is used
in a program of type VGWebTransaction to specify details for transferring
control to another VGWebTransaction program when the user submits a form or
clicks a hypertext link.
The
@programLinkData property fields and their types are as follows:
- programName String
- 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 part field is defined
and accessible from the current workspace, the package name for the VGWebTransaction
part 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 hptLlinkage properties file.
- uiRecordName String
- 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 used for the UI record.
- newWindow Boolean
- Indicates whether the Web page presented by the invoked program will be
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 will be 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 will be in a different window
- @linkParms @linkParameter[]
- Identifies the values to be placed
in the input record of the receiving program.
The
@linkParameter property
fields and their types are as follows:
- name STRING
- The name of a field in the input record of the program being invoked
- value literal
- A literal value to be passed
- valueRef STRING
- A field in the record being sent to the invoked program; the content of
the record field is passed
You may not specify both value and valueRef in the
same @linkParameter property.