Set group properties

Home

4D v20 R7


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

Parameter	Typ	Beschreibung
GruppenNr	Lange Ganzzahl	Einmalige Gruppenkennziffer oder -1 für neue Gruppe
		Einmalige Kennziffer der hinzugefügten Gruppe (wenn vorhanden)
Auswahlname	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

Die Funktion Set group properties ändert die Eigenschaften einer bestehenden Gruppe mit der einmaligen Kennziffer GruppenNr oder fügt eine neue Gruppe hinzu, 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.

Wollen Sie eine neue Gruppe hinzufügen, übergeben Sie in GruppenNr -1 (siehe auch unten Hinweise für binäre Anwendungen).

Konnte die Gruppe erfolgreich hinzugefügt werden, enthält der Parameter GruppenNr die einmalige Kennziffer der Gruppe.

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

Im Parameter Name übergeben Sie den neuen Gruppenamen.

(Nur binäre Anwendungen) Im Parameter Eigentümer übergeben Sie die Kennziffer des neuen Eigentümers der Gruppe. Dieser Parameter wird im Projektmodus ignoriert.

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 die erhaltenen Werte für die Eigenschaften, die nicht geändert werden sollen.

Ohne 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.

Mit dem optionalen Parameter Mitglieder ändern Sie gesamte Mitgliederliste 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 Gruppe sein sollen.

Um alle Mitglieder aus einer Gruppe zu entfernen, übergeben Sie ein leeres Array Mitglieder.

Hinweise für binäre Anwendungen:

Die Kennziffern für Gruppen und Benutzer richten sich nach dem Ersteller (Designer, Administrator oder der Gruppe zugeordneter Eigentümer). Weitere Informationen dazu finden Sie im Abschnitt Kennziffern für Benutzer und Gruppen.
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.

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.

Siehe auch

GET GROUP LIST
GET GROUP PROPERTIES
GET USER LIST