Sie können Befehle über eine Abfragezeichenfolge an ein Gateway-Servlet übergeben.
Gateway-Abfrageparameter sind nicht dasselbe wie Gateway-Servletparameter, die das Servlet selbst konfigurieren. Informationen zu Gateway-Servletparametern finden Sie unter Gateway-Servlet-Parameter.
Die Abfrageparameter sind in der URL einer Webtransaktion eingeschlossen.
Sie können die Parameter auf zwei Arten erstellen:
Mit beiden Methoden können Sie eine beliebige Anzahl von angepassten Parametern übergeben.
Das Servlet erkennt die folgenden Parameternamen:
- hptAppId
- Der Name der auszuführenden Webtransaktion. Legen Sie diesen Wert im Feld programName der komplexen Eigenschaft @ProgramLinkData fest.
- hptExec
- Ein obligatorischer Parameter, der bewirkt, dass das Servlet die Seite ausführt.
EGL legt diesen Parameter automatisch auf Y fest, wenn Sie die komplexe Eigenschaft @ProgramLinkData verwenden.
- hptRecord
- Der Name des UI-Datensatzes, der an 'inputUIRecord' für die Webtransaktion übergeben werden soll. Legen Sie diesen Wert im Feld uiRecordName der komplexen Eigenschaft @ProgramLinkData fest.
- hptProgramPackage
- Der Name des Pakets, das die Webtransaktion enthält. Dieser Parameter überschreibt die Eigenschaft javaProperty in der Datei csogw.properties.
- hptUIRecordPackage
- Der Name des Pakets, das den UI-Datensatz enthält. Wenn dieser Parameter nicht festgelegt ist, aber der Parameter hptProgramPackage ist es, dann wird hptProgramPackage verwendet. Wenn keiner der beiden Parameter festgelegt ist, wird die Eigenschaft javaProperty aus der Datei csogw.properties verwendet.
- hptLogin
- Wenn dieser Parameter auf einen beliebigen Wert festgelegt ist, gibt er dem Gateway-Servlet vor, die von dem Servletparameter hptLogonPage angegebene Anmeldeseite anzuzeigen. Nach der Anmeldung sieht der Benutzer die Webtransaktion, die durch den Parameter hptAppId angegeben ist,
wenn sich dieser Parameter ebenfalls in der URL befindet. Wenn der Parameter hptAppId nicht in der URL enthalten ist, zeigt das Gateway-Servlet die Seite aus den Servletparametern hptEntryPage oder hptEntryApp an.
- Wenn die Servletparameter hptPublicUserId und hptPublicPassword korrekt festgelegt sind, wird der Benutzer automatisch angemeldet und direkt zu der durch hptAppId/hptEntryPage/hptEntryApp angegebenen Anwendung geführt.
- hptLogout
- Wenn dieser Parameter auf einen beliebigen Wert festgelegt ist, bewirkt er, dass das Gateway-Servlet den aktuellen Benutzer abmeldet, und hat dann dieselbe Wirkung wie der Parameter hptLogin.
Beispiel
Im folgenden Beispiel wird die URL für eine Webtransaktion angezeigt:
http://localhost:9080/Web/VAGenGatewayServlet?hptAppId=myWebTrans&
hptExec=Y&hptRecord=myRec&hptProgramPackage=myWebTransactions
Die folgende Datensatzdefinition zeigt die 'VGUIRecord'-Eigenschaften an, die diese URL generieren:
record uir type vguirecord
10 lnk char(2) {
uitype = programLink,
@ProgramLinkData {
programName = "myWebTrans",
uiRecordName = "myRec",
linkParms = [
@linkParameter { name = "hptProgramPackage", value = "myWebTransactions" }
]
}
};
end