Set user properties

4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 2004 (Geändert)


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

ParameterTypBeschreibung
BenutzerNrNumerischEinmalige Kennziffer des Benutzers, oder
-1 für dem Designer zugeordnete Benutzer,
oder -2 für dem Administrator zugeordnete
Benutzer
NameStringNeuer Benutzername
StartupStringName der neuen Startup-Methode
des Benutzers
KennwortStringNeues (unverschlüsseltes) Kennwort oder
* für unverändertes Kennwort
AnzLoginNumerischNeue Anzahl Benutzungen der Datenbank
letztesLoginDatumNeues Datum letzte Benutzung der Datenbank
GruppenArray numerischGruppenkennziffern, zu denen der Benutzer
gehört
GrEigentümerNumerischKennziffer der Benutzergruppe Eigentümer
FunktionsergebnisNumerischEinmalige Kennziffer des neuen Benutzersa

Beschreibung

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:

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

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:

GruppenkennzifferBeschreibung
15001 bis 32767Gruppe, angelegt vom Designer oder dem zugeordneten
Gruppeneigentümer
(Gruppennr. 15001 ist die erste Gruppe
Gruppennr. 15002 die zweite usw.).
-15001 bis -32768Gruppe, 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.

Referenz

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

Fehler verwalten

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.


4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next