Bei der Anlage eines neuen BPaaS-Benutzers werden Vorname, Nachname und E-Mail-Adresse des Anwenders in der Benutzerverwaltung hinterlegt. Zusätzlich können weitere personenbezogene Informationen gespeichert werden.

In den Zusatzdaten können die folgenden Angaben gepflegt werden:

Firma
Abteilung
Telefonnummer
Fax
Straße
PLZ
Stadt

Diese Informationen aus der Benutzerverwaltung sind im sogenannten Benutzerobjekt zusammengefasst. Das Benutzerobjekt kann sowohl über den Container als auch über den Kontext der Plattform angesprochen werden. Die Inhalte des Benutzerobjekts sind daher in Apps verfügbar und können auch für das dynamische Filtern von Instanzdaten genutzt werden.

Note

title	Wichtige Hinweise zur Arbeit mit dem Benutzerobjekt

Im Benutzerobjekt stehen nur die Zusatzdaten zur Verfügung, die in der Benutzerverwaltung gepflegt wurden. Die Attribute loginId, firstname, lastname und email sind Pflichtfelder für die Benutzeranlage und enthalten daher immer Daten.

Bei den Inhalten des Benutzerobjektes handelt es sich um flüchtige Werte, die nur zur Laufzeit der App verfügbar sind.

Inhalte des Benutzerobjekts sind unveränderlich! Wenn Sie Inhalte des Benutzerobjekts in Formularfeldern anzeigen möchten, aktivieren Sie für die betreffenden Felder immer die Eigenschaft Nur lesbar. Wenn das Feld editierbar ist und Änderungen am Benutzerobjekt vorgenommen werden, werden diese Änderungen nicht gespeichert!

Das Benutzerobjekt im Container wird in Responsiven Formularen angesprochen über bpaas.userInfo.attributname.

Beispiel:
bpaas.userInfo.email liefert max.mustermann@scheer-group.com zurück.

In Mobilen Formularen wird das Benutzerobjekt im Container angesprochen über currentUser.attributname.

Beispiel:
currentUser.firstname liefert Max zurück.

Code Block

title	Kontext-Benutzerobjekt
linenumbers	true

{
"loginId": "max.mustermann",
"firstname": "Max",
"lastname": "Mustermann",
"email": "max.mustermann@scheer-group.com",
"company": "Mustermann GmbH",
"organisation": "Büro Musterstadt",
"department": "Geschäftsführung",
"phone": "0123-4567890",
"fax": "0987-6543210",
"street": "Musterstraße 2",
"zip": "99888",
"city": "Musterstadt",
"defLang" : "de"
}

Das Kontext-Benutzerobjekt wird angesprochen über user.attributname.

Beispiel:
user.firstname liefert Max zurück.

Benutzerobjekt in einem Responsiven Formular

Beispiel: Ausfüllen des Formularfelds Aktueller Bearbeiter mit dem Wert aus dem Container-Benutzerobjekt im Beschaffungsprozess der Mustermann GmbH

Tip
Für die Vorbelegung von Formularfeldern wird die Nutzung der Formularfunktionen empfohlen. Weiterführende Informationen zur Vorbelegung von Formularfeldern finden Sie auf der Seite Felder vorbelegen.

	In den Formularen des Beschaffungsprozesses soll angezeigt werden, welcher Mitarbeiter ein Formular jeweils gerade bearbeitet. Dafür fügt Max Mustermann das Feld Aktueller Bearbeiter in alle Formulare ein. Im Benutzerobjekt bpaas.userInfo steht neben dem Namen des Benutzers auch sein Login-Name zur Verfügung. Diesen möchte Max Mustermann verwenden, um das Feld Aktueller Bearbeiter beim Aufruf eines Formulars auszufüllen.
	Über den Feldnamen im Container können Attribute des Benutzerobjekts direkt angesprochen werden. Das Formularfeld Aktueller Bearbeiter erhält daher als Feldname im Container bpaas.userInfo.loginId. Da Inhalte des Benutzerobjekts nicht gespeichert werden können, markiert Max das Feld als Nur lesbar und deaktiviert auch die Eigenschaft Wert in Instanz speichern.
	Bei Ausführung der App wird die entsprechende Information aus dem Benutzerobjekt gezogen und im Feld Aktueller Bearbeiter angezeigt: Der Benutzer max.mustermann bearbeitet momentan den geöffneten Beschaffungsantrag.
	Wenn Melanie Mustermann als Leiterin der Buchhaltung des Genehmigungsformular öffnet, wird ihr Login-Name angezeigt.

Benutzerobjekt in einem Mobilen Formular

Beispiel: Vorbelegung der Formularfelder Nachname, Vorname und Firma im Formular Schadenerfassung mobil im Schadenmeldungsprozess der Mustermann GmbH

Mitarbeiter der Firma Mustermann können über das Formular Schadenerfassung mobil über die Scheer PAS Mobile App einen Schaden an ihrem Fahrzeug direkt von unterwegs melden.

Max Mustermann möchte, dass im Abschnitt Geschädigter die Felder Nachname, Vorname und Firma bereits vorausgefüllt sind, wenn ein Mitarbeiter das Formular öffnet.

Der angemeldete Mitarbeiter muss aber nicht unbedingt der Geschädigte sein. Daher soll der Eintrag lediglich ein Vorschlagswert sein, der vom Anwender abgeändert werden kann.

Im Editor für Mobile Formulare trägt er daher für die Felder Nachname, Vorname und Firma in der Eigenschaft Aktueller Wert Platzhalter ein, die auf den entsprechenden Eintrag des Benutzerobjekts verweisen:

# currentUser.lastname#
# currentUser.firstname#
# currentUser.company#

Beim Ausführen der App auf dem Smartphone werden die Platzhalter durch die Daten des aktuell eingeloggten Mitarbeiters ersetzt und als Vorschlagswert angezeigt.

Die Angaben können aber vor dem Speichern bearbeitet werden. Für den Fall dass der Mitarbeiter nicht der Geschädigte ist, kann er also die Vorschlagswerte einfach überschreiben.

Verwendung im Filter einer Übersicht

Beispiel: Dynamisches Filtern von Instanzen unter Verwendung des Kontext-Benutzerobjekts

In der Übersicht Beschaffungsanträge soll jeder Mitarbeiter der Mustermann GmbH nur seine eigenen Anträge sehen können.

	Ohne Filterung werden in der Übersicht Beschaffungsanträge jedoch alle Anträge angezeigt.
	Im Beschaffungsantrag wurde das Eingabefeld E-Mail eingefügt: Der Name des Feldes lautet E-Mail. Der Feldname im Container des Feldes lautet Email. Der Anwender muss in dieses Feld seine E-Mail-Adresse eintragen. Diese Information ist auch im Kontext-Benutzerobjekt vorhanden. Um nur die Instanzen des angemeldeten Nutzers auszufiltern, kann man prüfen, ob der Eintrag im Formularfeld E-Mail mit dem Eintrag email im Benutzerobjekt übereinstimmt.
	Im App-Projekt Beschaffung wird der Einstiegslink Übersicht Beschaffungsanträge markiert. In der Sidebar Editieren des Elementes findet sich die Option Such-Query. Der Editor wird über einen Klick auf das Zahnrad geöffnet.
	Der Filterausdruck, um die Mailadresse aus dem Eingabefeld mit der Mailadresse aus dem Benutzerobjekt zu vergleichen, lautet: `{"Email":#user.email#}`
	Die Übersicht zeigt anschließend nur noch Instanzen an, die vom angemeldeten Benutzer Max Mustermann angelegt wurden.