Parameterelemente für Benutzergruppen

Auf Benutzergruppen kann mit Hilfe von Funktionselementen zugegriffen werden. Mit dem group-get-Element kann man beispielsweise die Werte sämtlicher Benutzergruppen-Parameter ermitteln. Welche Benutzergruppeneigenschaften ausgelesen oder gesetzt werden sollen, spezifiziert man mit Parameterelementen. Im Folgenden werden die Parameterelemente für Benutzergruppen aufgeführt.

displayTitle
Bedeutung: Der in der HTML-Benutzerschnittstelle angezeigte Bezeichner der Gruppe. Dieser Titel ist eine Kombination aus dem Namen und dem vollen Namen.

Definition:

<!ELEMENT displayTitle (%cm.atom;)>
getKeys
Bedeutung: Die Liste der mit group-get abfragbaren Parameter.

Definition:

<!ELEMENT getKeys (listitem)*>
<!ELEMENT listitem (%cm.atom; | listitem | dictitem)*>
<!ELEMENT dictitem (key, value)>
<!ELEMENT key (%cm.atom;)>
<!ELEMENT value (%cm.atom; | listitem | dictitem)*>
globalPermissions
Bedeutung: Die Liste der globalen Rechte.

Definition:

<!ELEMENT globalPermissions (listitem)*>
<!ELEMENT listitem (%cm.atom; | listitem | dictitem)*>
<!ELEMENT dictitem (key, value)>
<!ELEMENT key (%cm.atom;)>
<!ELEMENT value (%cm.atom; | listitem | dictitem)*>
name
Bedeutung: Der Name der Gruppe.

Definition:

<!ELEMENT name (%cm.atom;)>
hasGlobalPermission
Bedeutung: Überprüft, ob die Gruppe das angegebene globale Recht hat.

Definition:

<!ELEMENT hasGlobalPermission (%cm.atom;)>
<!ATTLIST hasGlobalPermission
          permission (permissionGlobalExport | 
                      permissionGlobalRoot | 
                      permissionGlobalRTCEdit | 
                      permissionGlobalUserAttributesEdit | 
                      permissionGlobalUserEdit) CDATA #REQUIRED
>

Bedeutung der Attribute:

  • permission: spezifiziert ein globales Recht.

Beispiel:

<cm-request...>
  <group-where>
    <name>NewsMasters</name>
  </group-where>
  <group-get>
    <hasGlobalPermission permission="permissionGlobalRTCEdit"/>
  </group-get>
</cm-request>
 
<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <group>
      <hasGlobalPermission permission="permissionGlobalRTCEdit">0
      </hasGlobalPermission>
    </group>
  </cm-code>
</cm-response>
owner
Bedeutung: Der Verwalter der Benutzergruppe. Im Parameter owner einer Gruppe ist der Name des Verwalters der Gruppe (ein Benutzer- oder Gruppenname) gespeichert. Der Verwalter darf die Parameter und Rechte einer Gruppe ändern.

Definition:

<!ELEMENT owner (%cm.atom; | %cm.user-get;)*>

cm.user-get: siehe <user-where> <user-get> oder CRUL als DTD.

realName
Bedeutung: Der volle Name der Gruppe.

Definition:

<!ELEMENT realName (%cm.atom;)>
setKeys
Bedeutung: Die Liste der mit group-set setzbaren Parameter.

Definition:

<!ELEMENT setKeys (listitem)*>
<!ELEMENT listitem (%cm.atom; | listitem | dictitem)*>
<!ELEMENT dictitem (key, value)>
<!ELEMENT key (%cm.atom;)>
<!ELEMENT value (%cm.atom; | listitem | dictitem)*>
users
Bedeutung: Die Liste der Benutzer, die Mitglieder der Gruppe sind.

Definition:

<!ELEMENT users ((user)* | (listitem)*)>
<!ELEMENT user (%cm.atom; | %cm.user-get;)*>
<!ELEMENT listitem (%cm.atom; | listitem | dictitem)*>
<!ELEMENT dictitem (key, value)>
<!ELEMENT key (%cm.atom;)>
<!ELEMENT value (%cm.atom; | listitem | dictitem)*>
 

cm.user-get: siehe <user-where> <user-get> oder CRUL als DTD.