Parameterelemente für Requests mit groupProxy-Elementen

Auf Benutzergruppen kann man über den Benutzermanager-Proxy mit Hilfe von Funktionselementen zugreifen. Mit dem groupProxy-get-Element lassen sich beispielsweise die Werte sämtlicher Benutzergruppen-Parameter ermitteln. Die Benutzergruppeneigenschaften, die ausgelesen oder gesetzt werden sollen, spezifiziert man mit Parameterelementen. Welche Parameterelemente verwendet werden können, ist vom externen Benutzermanager abhängig. Im Folgenden werden die groupProxy-Parameterelemente aufgeführt. Mit Ausnahme von description sind sie sind mit den Parameterelementen für Benutzergruppen identisch (siehe Parameterelemente für Benutzergruppen).

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;)>
description
Bedeutung: Liefert die Daten der angegebenen Benutzergruppe.

Definition:

<!ELEMENT description (dictitem)*>
<!ELEMENT dictitem (key, value)>
<!ELEMENT key (%cm.atom;)>
<!ELEMENT value (%cm.atom; | listitem | dictitem)*>
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...>
  <groupProxy-where>
    <name>NewsMasters</name>
  </groupProxy-where>
  <groupProxy-get>
    <hasGlobalPermission permission="permissionGlobalRTCEdit"/>
  </groupProxy-get>
</cm-request>
 
<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <groupProxy>
      <hasGlobalPermission permission="permissionGlobalRTCEdit">0
      </hasGlobalPermission>
    </groupProxy>
  </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.