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.
Weitere Informationen zu WWLINKs finden Sie hier: