WWLINK Direkt-Links ausführen
REV: Beta-70523, WWS>= 13179
Es gibt im Bereich WWLINK-System 2 neue Link-Typen. Damit können Direkt-WWLINK-Meldungen von außen über den WW-Server an aktive Sitzungen gepostet werden. Ebenso ist es nun möglich, bei WWLINKs auch externe Parameter über URL-Parameter an die Verarbeitung weiterzugeben.
➜ Neue-Link-Arten
➜ Neu: Übergabe von URL-Parametern
➜ Steuerung der neuen WWLINK-Direkt Links im WW-System-Cockpit
➜ WWLINK im Sicherheits-Center
➜ Anpassung der GET_RELATION 4006 Anlegen eines WWLINK’s
➜ Neue Zugriffsrechte für die Steuerung der Verarbeitung
Neue-Link-Arten
Die GET_RELATION 4006 wurde um die beiden Link-Arten 40 und 41 erweitert.
- 40 Sitzungs-Link
Für den WWLINK wird die aktuelle Sitzungsnummer vermerkt. Bei Aufruf des WWLINKs wird im System die Sitzung gesucht und der WWLINK an diese übergeben. - 41 Benutzer-Sitzungs-Link
Für den WWLINK wird die Benutzer-Nummer hinterlegt. Bei Aufruf des WWLINKS wird im WW-Server die laufende Sitzung dieses Benutzers gesucht und der WWLINK an diese übergeben.
Neu: Übergabe von URL-Parametern
Für die GET_RELATION 4006 wurde ein neuer Parameter „OPTIONALE_PARAMETER“ eingeführt.
Damit lassen sich dynamische Parameter, welche manuell an den Link angehängt werden, an die Anwendung übergeben. Dabei werden die Parameter in URL-Notation an den Link angefügt.
Beispiel: Sie wollen die Parameter: PARA1=WEBWARE, PARA2=IST, PARA3=SUPER übergeben, dann sieht der Link so aus (xxxxx steht für den WWLINK-Hash):
https://[Server-Adresse]/@LNKxxxxx?PARA1=WEBWARE?PARA2=IST?PARA3=SUPER
Die Aktivierung der Erlaubnis erfolgt bei der Erzeugung des WWLINKS mit Angabe der Anzahl Parameter (0=Kein Parameter erlaubt), sowie über einen System-Wert im System-Cockpit:
Steuerung der neuen WWLINK-Direkt Links im WW-System-Cockpit
Die Erlaubnis zur Anlage sowie Ausführung der beiden neuen Direkt-WWLINK-Arten (40+41) kann jeweils im folgenden Bereich konfiguriert werden:
WWLINK im Sicherheits-Center
Diese Werte können außerdem direkt im WEBWARE-Sicherheits-Center verwaltet und eingesehen werden.
Anpassung der GET_RELATION 4006 Anlegen eines WWLINK’s
GET_RELATION[4006!LINKART!LINK_KEY_ID_NAME!ERLAUBT_AB!ERLAUBT_BIS!ERLAUBT_MAX_AUFRUFE!LINK_DESC !START_WORKFLOW!WORKFLOW_PARAM_FORMAT!WORKFLOW_PARAMTER!LINK_USER_ID!ANONYM_MAX_AUFRUFE!OPTIONA LE_URL_PARAMETER]
Folgende Übergabeparameter:
➜ Link-Art (Vorgabe, welche Art von Link erzeugt werden soll, Werte 10,11,12,20,21,30 und 31)
- 10 ▶ Public-User-Link, ein Link der in einer Public-User-Sitzung gültig ist.
- 11 ▶ Public-User-Einladung für die Neuanmeldung eines Public-Users, es wird ein Einmal-Passwort gesetzt.
- 12 ▶ Public User Anonym – Zugang für Public-User Sitzung ohne notwendige Anmeldung. Wichtig: Nutzer-ID vorgeben und die Anzahl erlaubter anonymer Anmeldungen vorgeben.
- 20 ▶ Benutzer Link der in einer Benutzer-Sitzung gültig ist.
- 21 ▶ Benutzer Einladung für einen Benutzer, für Neu-Anmeldung, es wird ein Einmal-Passwort gesetzt.
- 22 ▶ Benutzer Link für Erstellen einer Debug-Sitzung.
- 30 ▶ Service-Link erstellen, der vom System-Server ohne Benutzersitzung ausgeführt wird. Hier ist eine Anmeldung notwendig.
- 31 ▶ Service Anonym-Servicelink, der vom System-Server ohne Benutzersitzung ausgeführt wird. Hier ist keine Anmeldung notwendig.
- 40 ▶ Direkt Link der an die laufende Sitzung gebunden ist. Bei Eintreffen wird der Link an die laufende Sitzung weitergeleitet. Ist bei der Ausführung die Sitzung nicht vorhanden, wird „HTTP 404 Ressource not found“ zurückgegeben.
- 41 ▶ Direkt Link, der an den Benutzer gebunden ist. Bei Eintreffen wird eine laufende Sitzung für den Benutzer gesucht und der Link an die laufende Sitzung weitergeleitet. Ist die Benutzer-Sitzung nicht vorhanden, wird „HTTP 404 Ressource not found“ zurückgegeben.
➜ LINK_KEY_ID_NAME
Optionaler Name für den Link – dient zum späteren generischen Zugriff auf den erzeugten Link.
Länge Max 32 Zeichen, Nur Gross-Schreibung(Auto)
➜ ERLAUBT_AB
Vorgabe, ab wann der Link gültig ist.
Leer=Tagesdatum
➜ ERLAUBT_BIS
Vorgabe, bis wann der Link gültig ist.
Leer=Unbegrenzt
➜ ERLAUBT_MAX_AUFRUFE
Maximale Anzahl von Aufrufen erlaubt
➜ LINK_DESC
Beschreibung des Links in Text-Form – wird zum Beispiel für GetRel[4007, aktion=4LINK- HASH-HTML] verwendet.
Länge max 255 Zeichen
➜ WORKFLOW_START
Name des Workflows, der bei LINK-Aufruf ausgeführt werden soll (SE5009)
➜ WORKFLOW_PARAM_FORMAT
Angabe einer „Versions-Nummer“ für das Parameterformat, um auch bei Schnittstellenänderung kompatibel zu bleiben.
➜ WORKFLOW_PARAMETER
(Optional) Angabe einer Parameter Liste mit dem Trenner ?
Zum Beispiel: AFeld?BFeld?CFeld,
Liste wird bei Aufruf des Workflow als Einzel-Parmaeter aufgeteilt übergeben (max Länge 1024)
➜ LINK_USER_ID
Optional, bei Anonym-Zugang und Einladungen ist die Angabe notwendig.
Es ist aber für Intern/Public-User immer empfehlenswert, auch eine Benutzer-Nr mit anzugeben.
So kann der WW- LINK direkt an einen Benutzer gebunden werden.
ACHTUNG: Bei Mitarbeitern (LINKART 20 oder 21) die Login-Benutzer Nummer angegeben.
Bei öffentlichen Benutzern (LINKART 10,11,12) muss die Public-Worker-ID aus der IDB SE0125 angegeben werden.
➜ ANONYM_MAX_AUFRUFE
(Optionale) Angabe wie oft der Link ohne Anmeldung ausgeführt werden darf – nur bei LINKART = [10,11,32] erlaubt.
➜ OPTIONALE_PARAMETER
(Optional) dürfen an den Link weitere Parameter in der Form [LINK]?PARA1=..?Para2=..?Para3=.. übergeben werden.
Hier also Angabe der Anzahl von möglichen URL-Parametern, die an die Anwendung weitergegeben werden dürfen.
Hier ein Beispiel wie ein Link angelegt wird:
TMP_4000_32=GET_RELATION[4006!12!!!!10!Hier Klicken!SE5009!!90-30-20!9!!!]
4006: Erzeuge neuen WW-LINK
12: Erzeugen einen Anonymen Public-User-Zugang
10: Maximale Anzahl Aufrufe erlaubt
Hier Klicken: Dieser Text wird bei einem HTML-Link als Link-Text verwendet
SE5009: Angabe des Start-Workflow der gestartet werden soll
90-30-20: Parameter der an den Workflow übergeben wird
9: Benutzer-Nummer, hier die Public-User Nummer, da es sich um einen Public-Link handelt
Rückgabewert TMP_4000_32 bei erfolgreichem Anlegen die WW-LINK-Hash-ID, die für weitere Abfrage bei GET_RELATION[4007!TMP_4000_32!..] benutzt werden kann.
Rückgabewerte der GETREL 4006:
LEER ▶ Es wurde kein Link angelegt. Fehlerauswertung mit GETREL[4007 Aktions-Code 0 aufrufen.
WERT ▶Es wird die erstellte HASHID zurückgegeben (32-Byte Hash). Mit dieser kann mittels der GETREL[4007… auf weitere Funktionen des WWLINK’s zugegriffen werden.
Neuerungen in Version 1.1
2 neue Linkarten 40 + 41, sowie weiterer Parameter
Neue System-Werte im WW-System-Cockpit sowie neues Zugriffsrecht WEBWARE_30, 5 „bei eingehendem Direkt-WWLINK Frage ob dieser ausgeführt werden soll“.
Bei beiden Linkarten ist die Besonderheit, dass keine neue Sitzung gestartet wird, sondern dass ein WWLINK an eine bereits laufende Sitzung weitergegeben werden kann.
Das Ziel ist hier die Interaktion mit Fremdprogrammen welche per WWLINK Parameter an die WW-Sitzung übergeben können.
Bei der Linkart 40 (Session-Link) kann für die aktuelle Sitzung ein Link erstellt werden.
Bei der Linkart 41 (Benutzer-Session-Link) kann ein Link für einen Benutzer erstellt werden, wobei hier keine Sitzungs-Nummer Bindung besteht.
Bei Verarbeitung des WWLINKS im WW-Server wird geprüft ob für den angegebenen Benutzer eine Sitzung vorhanden ist und dann an diese der WWLINK weitergereicht.
Neue Zugriffsrechte für die Steuerung der Verarbeitung
Damit der Benutzer entscheiden kann ob er die Verarbeitung des Direkt-WWLINK durchführen will, gibt es ein Zugriffsrecht, mit sich die Abfrage zur Verarbeitung des Direkt-WWLINK an/abgeschaltet lässt. Damit ist es möglich, dass der Benutzer in den Ablauf der Verarbeitung eingreifen kann.
Dieser Systemwert ist im Auslieferungszustand aktiviert, so dass bei Eintreffen eines Direkt-WWLINKS der Benutzer die folgende Meldung zur Auswahl angezeigt bekommt:
