Mit diesem Kommando kann ein Token in der Datenbank angelegt werden. Ein Token kann für Aktionen wie eine automatische Benutzeranmeldung, oder einen direkten Funktionszugriff ohne vorherige Anmeldung genutzt werden.
Anwendung A legt z.B. ein Token an, mit einer bestimmten eindeutigen Kennung. Zu diesem Token werden bestimmte Informationen gespeichert. Anwendung B erhält nun als Aufrufparameter dieses Token und weiss damit, dass ein Zugriff erlaubt ist und kann die zum Token gehörenden Informationen auslesen.
Beide Anwendungen kommunizieren also mittels der Datenbanktabelle "DLEUSRTOKEN". Das Kommando hier hilft bei der Anlage eines Tokens aus der DLE heraus. Die notwendigen Implementierungen der Funktionalität und Dingen wie Gültigkeit, Benutzer und Org.-Einheit Zuordnung, Löschen des Tokens etc. sind durch die Anwendung(en) selber umzusetzen.
Parameter
- Ergebnisfeld: Hier wird das ermittelte Token gespeichert. Das Token setzt sich zusammen aus Präfix und Token Parameter.
- Präfix: (optional) Ein optionaler Präfix, wird dem Token vorangestellt.
- Token: (optional) Hier kann ein Token angegeben werden. Wird der Wert leer gelassen, wird ein eindeutiger Token (UUID) ermittelt.
- Gültig bis: (optional) Hier kann dem Token ein Gültigkeitsdatum mitgegeben werden.
- Benutzer ID: (optional) Ein dem Token zugeordneter Benutzer.
- Org.-Einheit ID: (optional) Eine dem Token zugeordnete Org.-Einheit.
- Ordnername: (optional) Ein dem Token zugeordneter Aufrufordner.
- Brickname: (optional) Ein dem Token zugeordneter Brickname im Aufrufordner (abhängig vom Ordnername).
- JSON Text: (optional) Ein beliebiger Text (Max 2000 Zeichen), üblicherweise ein JSON Konstrukt mit Daten zum Token.
- JSON Blob: (optional) Ein beliebiger größerer Text, wird in einem Blob-Feld gespeichert. Wie der Text üblicherweise ein JSON Konstrukt mit Daten zum Token.
- Einmalnutzung: (optional) Hier kann ein Flag (Y oder N also Ja-/Nein) gesetzt werden um den Konsumenten eines Tokens darauf hinzuweisen, das das Token nur einmal benutzt werden soll. Der Konsument sollte es dann nach Nutzung löschen.
