Set user properties

Version 2004 (Geändert)

Set user properties (BenutzerNr; Name; Startup; Kennwort; AnzLogin; letztesLogin{; Gruppen{; GrEigentümer}}) Numerisch

Mit der Funktion Set user properties können Sie die Eigenschaften eines bestehenden Benutzers mit der in BenutzerNr übergebenen Kennziffer ä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:

Nach dem Aufrufen von Set user properties finden Sie den Benutzernamen, die Startup Methode, einen leeren String für das Kennwort, die Anzahl der Benutzungen sowie Datum der letzten Benutzung der Datenbank in den entsprechenden Parametern.

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 4th Dimension 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:

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

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

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.