GET_RELATION[4007!LINKHASHID!LINKART!LINK_KEY_ID_NAME!LINK_ACTION!USER_ID]
Folgende Übergabeparameter
- LINKHASHID
Hier den 32-Byte HASH-Wert angeben oder optional LINKART und LINK_KEY_ID - LINKART
(OPTIONAL/ wenn LINKHASHID Leer) Art des Links, wurde beim Erzeugen angegeben, Vorgabe Bei Aufruf 40 zwingend - LINK_KEY_ID_NAME
(OPTIONAL/wenn LINKHASHID Leer) wurde beim Erzeugen angegeben - Link Aktion 0..99
LINK_ACTION 0..19 Lesen von Merkmalen0 ▶ Letzter Status GETREL[4006
Gebe letzten Status-Code der letzten Abfrage GetRel 4006 zurück (Code + Meldung) Rückgabe: OK / ERR-Fehlermeldung: OK1 ▶ Letzter status GETREL[4007
Gebe letzten Status-Code der letzten Abfrage GetRel 4007 zurück (Code + Meldung)
Rückgabe: OK / ERR-Fehlermeldung: OK2 ▶ Gebe Link Info: Liste aller Felder des Links
Rückgabe: Leer=Fehler,Wert = Liste getrennt mit ! wie im folgendem Definiert: LINKART!LINK_KEY_ID_NAME!ERLAUBT_AB!ERLAUBT_BIS!ERLAUBT_MAX_AUFRUFE! BISHER_AUFGERUFEN!LINK_DESC!START_WORKFLOW!WORKFLOW_PARAM_FORMAT!WORKFLOW_PARAM TER! LINK_USER_ID!ANONYM_MAX_AUFRUFE!ANONYM_ANZAHL_AUFRUFE3 ▶ Gebe LINK-HASH-HTTP
Rückgabe: Leer=Fehler, HTTP-HASH-Format, hierbei wird die URL zum WW- Server/Server-Link zurückgegeben, Wert kann direkt in einem Browser ausgeführt werden4 ▶ Gebe LINK-HASH-HTML
Rückgabe: Leer=Fehler, HTML-HASH-Format, hierbei wird ein <a href..> HTML Element mit Beschreibung und Server-Link zurückgegeben5 ▶ Gebe LINK Gültig bis zurück
Rückgabe Leer=Fehler, Datum Gültigkeitsdauer, falls nicht eingeschränkt wird 31.12.2999 zurückgegeben6 ▶ Gebe LINK Anzahl Aufrufe
Rückgabe Leer=Fehler, 0..x=Anzahl Aufrufe des Links7 ▶ Gebe aktuellen Status des Links: (Ist Link gültig)
Rückgabe Leer=Fehler, 1=Neu, 2=Verfügbar benutzt, 3=gesperrt, 9=gelöscht8 ▶ Gebe Einmal-Kennwort für Aktionen GETREL: 4006(11 und 21), sollte direkt nach dem Erzeugen ausgelesen werden
Rückgabe Leer=Fehler, Text des Einmalkennwortes9 ▶ Gebe LinkArt für LINKHASHID
Rückgabe Leer=Fehler, LINK_ART siehe Definition GETREL[4006]10 ▶ Gebe LINK_KEY_ID_NAME für LINKHASHID
Rückgabe Leer=Fehler bzw. kein LINK_KEY_ID_NAME bei Erzeugen gesetzt, Manueller KEY der für den HASH-LINK vorgegeben wurde.11 ▶ Gebe Benutzer-Nummer
Rückgabe Leer=Fehler, 0..999999 hinterlegte Benutzer-Nummer abhängig von LINK- Art ob Public/Intern12 ▶ Gebe definierter WORKFLOW-Name für die Ausführung des LINKS
Rückgabe Leer=Fehler, Wert=Workflow-Name13 ▶ Gebe Parameter-Format „Versions-Nummer“ für Parameter Liste des LINKS
Rückgabe Leer=Fehler, Wert: 0.99999 Versions-Nummer die beim Erzeugen vorgegeben wurde14 ▶ Gebe Parameter-Liste
Rückgabe Leer=Fehler, Wert: Parameter-Liste bereits umgesetzt mit ? Trenner15 ▶ Gebe LINK-Beschreibung
Rückgabe Leer=Fehler, Wert: Beschreibung des Links18 ▶ Gebe die aktuelle LINK-ID aus dem Cache zurück (Benötigt keine weiteren Aufrufparameter)
Rückgabe Leer=Fehler(Keine Daten im Cache), Wert=HashID19 ▶ Lese die Daten für den LINK in den internen Cache
Rückgabe 0=Fehler, 1=OK - LINK_ACTION 20..29 Intern User Lese-Funktionen Read/Read-Next20 ▶ Gebe First-LINK-ID für INTERN-USER-ID, (LINKHASHID oder (LINKART+LINK_KEY_ID_NAME)) + USER_ID
Rückgabe Leer=Fehler, HASHID für ersten Link des internen Benutzers21 ▶ Gebe NEXT-LINK-ID für INTERN-USER-ID, LINKHASHID + USER_ID
Rückgabe Leer=Ende erreicht, Wert für Folge HASHID - LINK_ACTION 30..39 Intern User Lese-Funktionen Read/Read-Next30 ▶ Gebe First-LINK-ID für PUBLIC-USER-ID (LINKHASHID oder (LINKART+LINK_KEY_ID_NAME)) + USER_ID
Rückgabe Leer=Fehler, HASHID für ersten Link des Public Benutzers31 ▶ Gebe NEXT-LINK-ID für PUBLIC-USER-ID LINKHASHID + USER_ID
Rückgabe Leer=Ende erreicht, Wert für Folge LINK-HASHID - LINK_ACTION 40..49 Individuelle Such-Funktion mit Angabe von LINK-Art Read/Read-Next40 ▶ Gebe First-LINK-ID für LINK-Art Nur Übergabe LINKART Rückgabe Leer=Fehler, HASHID für ersten Link der LINKART
41 ▶ Gebe NEXT-LINK-ID für LINKART, LINKHASHID + LINKART Rückgabe Leer=Ende erreicht, Wert für Folge LINK-HASHID - LINK_ACTION 50..99 Setze Status des Links, bzw. Verwaltungs-Funktionen50 ▶ Status des Links auf Gesperrt setzen
Rückgabe 0:Fehler / 1:OK51 ▶ Status des Links auf Aktiv setzen, (Keine Änderung an Stammdaten)
Rückgabe 0:Fehler / 1:OK52 ▶ Status des Links auf Aktiv und Frei setzen mit RESET. Dabei werden die Zähler (Aufgerufen, und Anonyme Zugänge zurückgesetzt).
Rückgabe 0:Fehler / 1:OK99 ▶ Link löschen
Rückgabe 0:Fehler / 1:OK
- LINK_ACTION 100..299 Zugriff auf die Programm-Aufruf Parameter100 ▶ Gebe Anzahl Parameter für diesen WW-LINK 0..99
101-199 ▶ Gebe Parameter mit Nummer 1..99200 ▶ Gebe Länge Parameter-String201-299 ▶ Gebe Länge für den entsprechenden Parameter, 1..99
- USER_ID
Wird nur für die Abfragen 20,21,30,31 benötigt
Beispiel eines Aufrufs in einem Workflow-Script:
SCRSE5009_5362_32=GET_RELATION[4006!12!!!!10!Hier Klicken!SE5009!!SCRSE5009_5311_10!9!!]
Hier wird ein anonymer Public-User WWLKINK erstellt für Public-User-Nummer 9.