|
|
|
|
|
|
|
|
|
|
Version 6.7 (Geändert)
Set group properties (GruppenNr; Name; Eigentümer{; Mitglieder}) 
Numerisch
| Parameter | Typ | Beschreibung | |
| GruppenNr | Numerisch | | Einmalige Gruppenkennziffer oder |
| -1 für neue Designer-Gruppe oder | |||
| -2 für neue Administrator-Gruppe | |||
| Name | String | | Neuer Gruppenname |
| Eigentümer | Numerisch | | Kennziffer des neuen Gruppen- |
| eigentümers | |||
| Mitglieder | Array Numerisch | | Neue Gruppeneigentümer |
| Funktionsergebnis | Numerisch |  | 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.
Referenz
GET GROUP LIST, GET GROUP PROPERTIES, GET USER LIST.
Fehler verwalten
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.
|
|
|
|
|
|
|
|
|
|