4D v14.3Set user properties |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
Set user properties
|
Set user properties ( BenutzerNr ; Name ; 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 | |||||
Name | 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 | |||||
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 |
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.
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.
Produkt: 4D
Thema: Benutzer und Gruppen
Nummer:
612
Geändert: 4D 2004
DELETE USER
GET GROUP LIST
GET USER LIST
GET USER PROPERTIES
Is user deleted
Validate password
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)