Definition:
<!ENTITY % cm.userConfig-getAttributes "
(key,
attributeNames?)
">
<!ELEMENT userConfig-getAttributes
%cm.userConfig-getAttributes;>
<!ATTLIST userConfig-getAttributes
login CDATA #IMPLIED
>
Aufgabe: Liefert zum angegebenen Benutzerkonfigurationselement die spezifizierten Tag-Attribute und deren Werte.
Bedeutung der Attribute:
-
login: das Login eines Benutzers.
Spezielle Parameter dieses Funktionselements:
-
key: enthält den Namen des Konfigurationselements, dessen Tag-Attribute gesucht werden. Werden keine Tag-Attribute angegeben, so werden alle Tag-Attribute, die es für dieses Konfigurationselement gibt, mit ihren Werten geliefert. -
attributeNames: enthält den Namen eines Tag-Attributs, dessen Wert geliefert werden soll.
Rückgabewert bei Erfolg: die Liste der Tag-Attribute mit ihren Werten.
Erforderliche Rechte: Möchten Sie die Tag-Attribute und deren Werte eines Benutzerkonfigurationselements eines beliebigen Benutzers abfragen, so müssen Sie ein Superuser oder der Verwalter des betreffenden Benutzers sein. Es gibt es keine Einschränkungen, wenn die Tag-Attribute von Konfigurationselementen des authentifizierten Benutzers ermittelt werden.
Beispiel:
<cm-request...>
<userConfig-getAttributes>
<key>dateTimeFormats</key>
</userConfig-getAttributes>
</cm-request>
<cm-response...>
<cm-code numeric="0" phrase="ok">
<userConfig-getAttributes>
<key>dateTimeFormats</key>
<attributeNames>
<listitem>countryKey</listitem>
<listitem>timeZone</listitem>
</attributeNames>
</userConfig-getAttributes>
</cm-code>
</cm-response>