Create Login Request (Integration-Funktion)

Die Funktion Create Login Request (Integration-Funktion) erzeugt ausgehend von den Angaben für die Parameter (b bis e) die XML-Struktur für ein Integration Login-Objekt (LobsterDataLoginRequest) und speichert diese in der Variablen mit dem im Parameter a definierten Namen ab.

Auf diese Variable kann sich z. B. ein ImportResponder (Responder) (im Feld "Zusätzliche Parameter") beziehen, um den Anmeldekontext für einen Import festzulegen.
Auch die Funktion Import (Integration-Funktion) sieht einen eigenen Parameter für ein Integration Login-Objekt vor, dem diese Variable als Quelle zugewiesen werden kann.

images/download/attachments/201673980/image2020-10-19_17-52-10-version-1-modificationdate-1747043925434-api-v2.png

Parameter

Parameter	Beschreibung	Beispiel	Hinweis
a	Name der Variablen, in der das Integration Login-XML gespeichert werden soll.	`var__SCM_Login_Request`	Diesem Parameter muss der Name der Variablen als Textwert (typischerweise als statische Zuweisung mit Parametertyp "#") zugewiesen werden. ACHTUNG In Verbindung mit dem Parametertyp "%" würde der angegebene Variablenname als Quelle für den Textwert definiert, der den Namen der Zielvariablen definiert. Das ist in der Regel nicht zielführend. Allerdings kann ein vorübergehender Wechsel zum Paramertyp "%" hilfreich sein, wenn eine bestehende Variable per Dropdown ausgewählt werden soll. Anschließend muss der Parametertyp danach unbedingt wieder auf '#' gesetzt werden, damit der ausgewählte Variablenname zur Laufzeit als statischer Textwert zugeordnet wird.
b	Benutzername (`username`) eines Benutzers (s. Benutzer) Standard: `MSG_CALL_SCM_User_username`	`jabend`	Wie im Anmeldedialog wird die Groß-/Kleinschreibung bei der Identifikation des Benutzerkontos berücksichtigt. Ohne eine Zuweisung für diesen Parameter wird der Wert der Metadatenvariablen `MSG_CALL_SCM_User_username` verwendet, die bei einem Profilaufruf aus Lobster Data Platform / Orchestration automatisch vorbelegt ist.
c	ID (`id`) oder Name (`roleName`) einer Rolle (s. Rollen) Standard: `MSG_CALL_SCM_Role_id`	`Administrator` `101`	Die Groß-/Kleinschreibung bei der Identifikation einer Rolle über den Namen wird berücksichtigt. Ohne eine Zuweisung für diesen Parameter wird der Wert der Metadatenvariablen `MSG_CALL_SCM_Role_id` verwendet, die bei einem Profilaufruf aus Lobster Data Platform / Orchestration automatisch vorbelegt ist.
d	ID (`id`) oder der Name 1 (`address.Name1`) einer Firma (s. Firmen/Mandanten) Standard: `MSG_CALL_SCM_Company_id`	`Smart Logistics AG` `51`	Es kann entweder die ID einer Firma oder der exakte Namen des Feldes "Name 1" im Firmenkonto angegeben werden. Ohne eine Zuweisung für diesen Parameter wird der Wert der Metadatenvariablen `MSG_CALL_SCM_Company_id` verwendet, die bei einem Profilaufruf aus Lobster Data Platform / Orchestration automatisch vorbelegt ist.
e	Entscheidet, ob die Prüfung der Auswahl von Firma und Rolle (per Parameter c und d) gegen die dem per Parameter d identifizierten Benutzerkonto zugeordneten Firmen (`companies`) und Rollen (`roles`) entfallen soll. Standard: `false` ("Prüfung findet statt")	`true` `false`	Mit dem Wert `true` wird der spezifizierte Anmeldekontext ohne Rücksicht auf bestehende Zuordnungen für Firmen/Mandanten und Rollen im referenzierten Benutzerkonto akzeptiert. Sonst (z. B. mit dem Wert `false` oder falls kein Wert zugeordnet ist) findet eine Prüfung von Firma und Rolle gegen das referenzierte Benutzerkonto statt, wenn das Integration Login zur Laufzeit verarbeitet wird. Ist dann eine referenzierte Firma oder Rolle nicht im referenzierten Benutzerkonto "legitimiert", tritt dann ein Fehler auf. Diese Prüfung erfolgt aber nicht etwa schon beim Funktionsaufruf von Create Login Request (Integration-Funktion).

Beispiel

Ein Profilaufruf aus Lobster Data Platform / Orchestration soll u. a. das Löschen bestimmter Entitäten per Batch-Import bewirken, der mit einer Anmeldung in der Rolle "Super User" (mit der ID 1) ausgeführt werden soll, damit das Löschen ungeachtet von Besitzrechten und Rollenberechtigungen zuverlässig ausgeführt werden kann.

Derselbe Batch-Import soll unter bestimmten Umständen aber auch neue Entitäten erstellen, für die eine bestimmte Firma aus der bestehenden Hierarchie ("ACME Holding Ltd.") als Besitzer (ownerId) zuzuweisen ist.

Gleichzeitig soll der Benutzer, in dessen Kontext der Profilaufruf erfolgte, z. B. als "Ersteller" (creatorId) der hinzugefügten Entitäten nachvollziehbar sein.

Konfiguration:

In der Zielstruktur des Profils wird in einem Berechnungsfeld die Funktion Create Login Request (Integration-Funktion) wie folgt parametriert:

images/download/attachments/201673980/image2020-10-19_19-15-19-version-1-modificationdate-1747043925448-api-v2.png

Der Parameter a identifiziert den Namen einer Variablen, in der das Integration Login gespeichert werden soll, als var__RUNAS_SUPERUSER_HOLDING.
Der Parameter b erhält keine Zuordnung, so dass der angemeldete Benutzer aus der beim Profilaufruf initialisierten Variablen MSG_CALL_SCM_User_username übernommen wird.
Der Parameter c identifiziert die Rolle "Super User" über die interne ID 1.
Der Parameter d referenziert exakt den Namen (address.name1) eines existierenden Firmenkontos.
Der Parameter e stellt mit dem Wert true sicher, dass die Prüfung entfällt, ob derselbe Benutzer sich interaktiv als "Super User" im Kontext der "ACME Holding Ltd." anmelden könnte oder nicht.

Im für den Import eingerichteten Antwortweg verweist der ImportResponder (Responder) auf die im Mapping gesetzte Variable:

images/download/attachments/201673980/image2020-10-19_19-44-7-version-1-modificationdate-1747043925450-api-v2.png