Set user properties

Home

4D v16.3

Set user properties


Set user properties ( BenutzerNr ; Auswahlname ; Startup ; Kennwort ; AnzLogin ; letztesLogin {; Gruppen {; GrEigentümer}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
BenutzerNr	Lange Ganzzahl	Einmalige Kennziffer des Benutzers, oder -1 für dem Designer zugeordnete Benutzer, oder -2 für dem Administrator zugeordnete Benutzer
Auswahlname	String	Neuer Benutzername
Startup	String	Name der neuen Startup-Methode des Benutzers
Kennwort	String	Neues (unverschlüsseltes) Kennwort oder * für unverändertes Kennwort
AnzLogin	Lange Ganzzahl	Neue Anzahl Benutzungen der Datenbank
letztesLogin	Datum	Neues Datum letzte Benutzung der Datenbank
Gruppen	Array Lange Ganzzahl	Gruppenkennziffern, zu denen der Benutzer gehört
GrEigentümer	Lange Ganzzahl	Referenznummer des Gruppeneigentümers
Funktionsergebnis	Lange Ganzzahl	Einmalige Kennziffer des neuen Benutzers

Beschreibung

Die Funktion Set user properties ermöglicht, die Eigenschaften eines bestehenden Benutzers mit der in BenutzerNr übergebenen Kennziffer zu ändern oder einen neuen Benutzer hinzufügen, der dem Designer oder Administrator zugewiesen ist.

Wollen Sie die Eigenschaften eines bestehenden Benutzers ändern, müssen Sie eine gültige Kennziffer übergeben, die der Befehl GET USER LIST zurückgibt.

Gibt es den Benutzer nicht oder wurde er gelöscht, erscheint der Fehler -9979. Sie können diesen Fehler mit ON ERR CALL in einer Fehlerverwaltungsmethode ausfindig machen. Sie können aber auch vor dem Aufrufen von Set user properties mit der Funktion Is user deleted prüfen, ob der Benutzer existiert. Benutzerkennziffern können folgende Werte bzw. Bereiche haben:

Benutzerkennziffer	Beschreibung
1	Designer
2	Administrator
3 bis 15000	Benutzer, die der Datenbank-Designer angelegt hat
	(Benutzernr. 3 ist der erste Benutzer,
	Benutzernr. 4 der zweite, usw.).
-11 bis -15000	Benutzer, die der Datenbank-Administrator angelegt hat
	(Benutzernr. -11 ist der erste Benutzer,
	Benutzernr. -12 der zweite, usw.).

Konnte der Benutzer er folgreich angelegt oder geändert werden, enthält der Parameter BenutzerNr die einmalige Kennummer des Benutzers.

Wollen Sie einen neuen Benutzer hinzufügen, der dem Designer zugeordnet ist, übergeben Sie in BenutzerNr -1. Wollen Sie einen neuen Benutzer hinzufügen, der dem Administrator zugeordnet ist, übergeben Sie in BenutzerNr -2. In beiden Fällen sucht 4D zuerst nach dem ersten verfügbaren inaktiven (gelöschter) Benutzereintrag. Ein neuer Eintrag wird nur erstellt, wenn kein inaktiver (gelöschter) Eintrag vorhanden ist. Wurde der Benutzer korrekt hinzugefügt, erscheint nach dem Aufrufen von Set user properties in BenutzerNr die dazugehörige einmalige Kennziffer.

Übergeben Sie weder -1, -2 noch eine gültige Kennziffer, hat Set user properties keine Auswirkung.

Vor dem Aufrufen übergeben Sie für den Benutzer den neuen Namen, die Startup Methode, das Kennwort, die Anzahl der Benutzungen und das Datum der letzten Benutzung in den entsprechenden Parametern. In Kennwort übergeben Sie ein unverschlüsseltes Kennwort, das 4D vor dem Sichern verschlüsselt. Mit dem optionalen Symbol * können Sie das bisherige Kennwort beibehalten.
Wollen Sie nicht alle Eigenschaften des Benutzers ändern (mit Ausnahme von Gruppen, Näheres siehe unten), rufen Sie zuerst GET USER PROPERTIES auf und übergeben Sie die erhaltenen Werte für die Eigenschaften, die nicht geändert werden sollen.

Übergeben Sie nicht den optionalen Parameter Gruppen, bleibt die aktuelle Gruppenzugehörigkeit der Benutzer bestehen. Fügen Sie einen Benutzer ohne den Parameter Gruppen hinzu, gehört der Benutzer zu keiner Gruppe.

Mit dem optionalen Parameter Gruppen ändern Sie alle Gruppenzugehörigkeiten für den Benutzer. Sie müssen das Array Gruppen vor dem Aufrufen von Set user properties mit den Kennziffern der Gruppen füllen, zu denen der Benutzer gehört.

Mit dem optionalen Parameter GrEigentümer setzen Sie die Kennziffer der Benutzergruppe "Eigentümer", z.B. die Standardgruppe "Eigentümer" für Objekte, die dieser Benutzer angelegt hat. Gruppenkennziffern können folgende Bereiche haben:

Gruppenkennziffer	Beschreibung
15001 bis 32767	Gruppe, angelegt vom Designer oder dem zugeordneten Gruppeneigentümer
	(Gruppennr. 15001 ist die erste Gruppe
	Gruppennr. 15002 die zweite usw.)
-15001 bis -32768	Gruppe, angelegt vom Administrator oder dem zugeordneten Gruppeneigentümer
	(Gruppennr. -15001 ist die erste Gruppe
	Gruppennr. -15002 die zweite usw.)

Um alle Gruppenzugehörigkeiten aufzuheben, übergeben Sie ein leeres Array Gruppen.

Fehlerverwaltung

Haben Sie keine Zugriffsberechtigung zum Aufrufen von Set user properties oder wird bereits von einem anderen Prozess aus auf das Kennwortsystem zugegriffen, erhalten Sie eine Fehlermeldung. Sie können diesen Fehler mit dem Befehl ON ERR CALL in einer Methode zur Fehlerverwaltung ausfindig machen.

Siehe auch

DELETE USER
GET GROUP LIST
GET USER LIST
GET USER PROPERTIES
Is user deleted
Validate password