Definition:
<!ENTITY % cm.content-get " (anchors | blob | body | bodyTemplateName | channels | codeForActionPreview | codeForPreview | codeForSourceView | codeForThumbnail | contentType | displayTitle | editor | exportBlob | exportBlobForFrame | exportFiles | externalAttrNames | externalAttributes | frameNames | freeLinks | getKeys | height | hasThumbnail | id | isCommitted | isComplete | isEdited | isReleased | lastChanged | linkListAttributes | mimeType | nextEditGroup | nextSignGroup | objectId | reasonsForIncompleteState | setKeys | signatureAttrNames | signatureAttributes | sortKey1 | sortKey2 | sortKey3 | sortKeyLength1 | sortKeyLength2 | sortKeyLength3 | sortOrder | sortType1 | sortType2 | sortType3 | subLinks | thumbnail | thumbnailSize | title | validFrom | validSortKeys | validSortOrders | validSortTypes | validUntil | width | workflowComment | xmlBlob)* "> <!ELEMENT content-get %cm.content-get;>
Aufgabe: Liefert den Wert der angegebenen Versionsparameter für jede mit content-where ermittelte Version.
Verwendung: content-get muss immer auf content-where folgen, da zunächst die Versionen ermittelt werden müssen, auf die content-get angewendet werden soll, um Parameterwerte auszulesen.
Zusatzinformationen: Anders als bei content-set können bei content-get die Art der Übertragung und das Speicherformat des Blobs nicht vorgegeben werden. Wie der Server den Blob zurückgibt, zeigt er in der Antwort mit Hilfe des Attributs encoding beim Element blob an. Zur Erläuterung des Attributs und seiner Werte siehe <obj-create>. Mit dem Systemkonfigurationseintrag tuning.minStreamingDataLength lässt sich die Mindestgröße in Kilobytes festlegen, die ein Blob haben muss, damit der Server ihn per Streaming überträgt.
Rückgabewert bei Erfolg: der Wert der angegebenen Parameter.
Erforderliche Rechte: Der authentifizierte Benutzer muss das Recht permissionRead für die Datei haben, zu der die Versionen gehören. Für die Abfrage des Feldes exportBlob genügt auch das Recht permissionGlobalExport.
Beispiel:
<cm-request...>
<content-where>
<id>5628.14</id>
</content-where>
<content-get>
<editor/>
</content-get>
</cm-request>
<cm-response...>
<cm-code numeric="0" phrase="ok">
<content>
<editor>mustermann</editor>
</content>
</cm-code>
</cm-response>