@programLinkData

Die komplexe Eigenschaft @programLinkData gibt Details für die Übertragung der Steuerung an ein anderes VGWebTransaction-Programm an, wenn der Benutzer ein Formular übergibt oder auf einen Hypertext-Link klickt.

Der Prozess der Übertragung von Informationen aus einem VGWebTransaction-Programm in ein anderes ist einigermaßen komplex und verschiedene Eigenschaftenfelder in @programLinkData sind davon betroffen. Sie übergeben eine VGUI-Datensatzvariable an das neue Programm und verwenden @linkParameter-Eigenschaften, um diesen Datensatz zu laden.

Diese komplexe Eigenschaft enthält die folgenden Eigenschaftsfelder:
programName
Eine Zeichenfolge (STRING), die das Programm angibt, das aufgerufen werden soll, wenn der Benutzer das Formular übergibt oder auf den Hypertext-Link klickt. Ein Alias wird während der Generierung verwendet, wenn Sie den Alias angeben oder wenn Sie den Namen eines Programmabschnitts angeben, falls dieser Abschnitt über einen Alias verfügt und sich im aktuellen Arbeitsbereich befindet.
Falls das VGWebTransaction-Programm definiert und aus dem aktuellen Arbeitsbereich zugänglich ist, wird der Paketname für das VGWebTransaction-Programm in der Bean generiert, die zur Laufzeit eingesetzt werden soll. Andernfalls wird der Paketname für das Programm aus dem Wert 'javaProperty' des Anwendungseintrags in der Eigenschaftendatei 'hptLinkage' abgerufen.
uiRecordName
Eine Zeichenfolge (STRING), die einen zu sendenden VGUI-Datensatz angibt (falls vorhanden). Dieser Datensatz enthält Daten aus dem Webformular und/oder aus Linkparametern. Ein Alias wird während der Generierung verwendet, wenn Sie den Alias angeben oder wenn Sie den Namen eines VGUIRecord-Abschnitts angeben, falls dieser Abschnitt über einen Alias verfügt und sich im aktuellen Arbeitsbereich befindet.
Falls der für das uiRecordName-Feld angegebene VGUIRecord-Abschnitt definiert und aus dem aktuellen Arbeitsbereich während der Generierung zugänglich ist, wird der Paketname für den VGUIRecord-Abschnitt in der Bean generiert, die zur Laufzeit eingesetzt werden soll. Andernfalls wird der für das Programm verwendete Paketname auch für den VGUI-Datensatz verwendet.
newWindow
Ein boolescher Wert, der angibt, ob die von dem aufgerufenen Programm dargestellte Webseite in einem anderen Browserfenster geöffnet wird als dem Browserfenster, in dem der Benutzer das Formular übergeben oder auf den Hypertext-Link geklickt hat. Folgende Werte sind gültig:
no (Standardwert)
Die Webseite wird in demselben Fenster geöffnet. Falls das aktuelle Format von einer Anweisung show mit einer Rückgabeklausel oder von einer Anweisung converse dargestellt wird, unterbricht ein neues Fenster den bestehenden Datenaustausch mit dem Benutzer.
yes
Die Webseite wird in einem anderen Fenster geöffnet.
linkParms
Dies ist eine Feldgruppe komplexer @linkParameter-Eigenschaften (weiter unten beschrieben). Die Mitglieder dieser Feldgruppe stellen die Abfrageparameter dar, die an das Gateway-Servlet übergeben werden. Das Eigenschaftsfeld linkParms enthält die folgende komplexe Eigenschaft:
@linkParameter
Gibt die Werte an, die in den Eingabedatensatz des empfangenden Programms eingefügt werden sollen. Die komplexe Eigenschaft @linkParameter enthält die folgenden Eigenschaftsfelder:
name
Eine Zeichenfolge (STRING), die den Namen des Abfrageparameters enthält. Weitere Informationen finden Sie unter Gateway-Abfrageparameter für Webtransaktionen.
value
Ein Literalzeichenfolgewert (STRING), der an den Parameter übergeben werden soll.
valueRef
Eine Zeichenfolge (STRING), die den Namen eines Felds in dem Datensatz enthält, der an das aufgerufene Programm gesendet wird. Der Wert dieses Felds wird dem Parameter zugewiesen.

Sie können nicht sowohl value als auch valueRef in derselben Eigenschaft @linkParameter angeben.

Beispiel

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

Feedback