4D Doc Center : Set group properties

Home

4D v14.3

Set group properties


Set group properties ( GruppenNr ; Name ; Eigentümer {; Mitglieder} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
GruppenNr	Lange Ganzzahl	Einmalige Gruppenkennziffer oder -1 für neue Designer-Gruppe oder -2 für neue Administrator-Gruppe
Name	String	Neuer Gruppenname
Eigentümer	Lange Ganzzahl	Kennziffer des neuen Gruppeneigentümers
Mitglieder	Array Lange Ganzzahl	Neue Gruppenmitglieder
Funktionsergebnis	Lange Ganzzahl	Einmalige Kennziffer der neuen Gruppe

Beschreibung

Mit der Funktion Set group properties können Sie die Eigenschaften einer bestehenden Gruppe mit der einmaligen Kennziffer GruppenNr ändern bzw. eine neue Gruppe hinzufügen, die dem Designer oder dem Administrator zugewiesen ist.

Ändern Sie die Eigenschaften einer bestehenden Gruppe, müssen Sie eine gültige Gruppenkennziffer übergeben, die der Befehl GET GROUP LIST zurückgibt. Gruppenkennziffern können folgende Werte oder 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.)

Wollen Sie eine neue Gruppe hinzufügen, die dem Designer zugeordnet ist, übergeben Sie in GruppenNr -1. Wollen Sie eine neue Gruppe hinzufügen, die dem Administrator zugeordnet ist, übergeben Sie in GruppenNr -2.

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

Vor dem Aufrufen übergeben Sie für die Gruppe den neuen Namen und Eigentümer in den entsprechenden Parametern. Wollen Sie nicht alle Eigenschaften der Gruppe ändern (mit Ausnahme der Mitglieder, Näheres siehe unten), rufen Sie zuerst GET GROUP PROPERTIES auf und übergeben Sie die erhaltenen Werte für die Eigenschaften, die nicht geändert werden sollen.

Übergeben Sie nicht den optionalen Parameter Mitglieder, bleibt die aktuelle Mitgliedsliste der Gruppe bestehen. Übergeben Sie beim Hinzufügen einer Gruppe keine Mitglieder, hat die Gruppe keine Mitglieder.

Hinweis: Der Gruppeneigentümer ist nicht automatisch Mitglied seiner Gruppe. Sie können ihn je nach Wunsch über den Parameter Mitglieder in die Gruppe einfügen.

Mit dem optionalen Parameter Mitglieder ändern Sie alle Mitgliederlisten für die Gruppe. Sie müssen das Array Mitglieder vor dem Aufrufen von Set group properties mit den Kennziffern der Benutzer und Gruppen füllen, die Mitglied der Gruppen sein sollen. Mitgliedskennziffern können folgende Bereiche haben:

Gruppenkennziffer	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.)
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 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 Mitglieder aus einer Gruppe zu entfernen, übergeben Sie ein leeres Array Mitglieder.

Fehlerverwaltung

Haben Sie keine Zugriffsberechtigung zum Aufrufen von Set group 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.