<obj-where> <obj-mirror>

Definition:

<!ENTITY % cm.obj-mirror "
 (parent |
  name)*
">
<!ELEMENT obj-mirror %cm.obj-mirror;>

Aufgabe: Von den mit obj-where ermittelten Dateien wird je eine Spiegeldatei angelegt.

Spezielle Parameter dieses Funktionselements:

• parent: spezifiziert die ID des Zielordners – fehlt der Parameter, wird als Ziel der Ordner angenommen, in dem sich die jeweils zu spiegelnde Datei befindet. Der Zielordner darf keine Spiegeldatei sein.
• name: gibt den Namen der jeweiligen neuen Spiegeldatei an. Fehlt der Name, wird der Name der jeweils zu spiegelnden Datei verwendet. Gibt es diesen in dem Zielordner bereits, wird ein neuer Name nach dem Muster NameX berechnet, wobei X eine Zahl ist.

Verwendung: Zunächst werden mit obj-where Dateien ermittelt, bevor obj-mirror verwendet wird, um diese Dateien zu spiegeln.

Rückgabewert bei Erfolg: die IDs der neuen Dateien.

Erforderliche Rechte: Der authentifizierte Benutzer muss das Recht permissionRead für die Quelldateien haben; der Benutzer muss ebenfalls das Recht permissionCreateChildren in dem Zielordner und das in der Vorlage der Zieldateien definierte globale Dateianlegerecht haben.

Beispiel:

<cm-request ...>
  <obj-where>
    <id type="string">44127</id>
  </obj-where>
  <obj-mirror>
    <parent type="string">93687</parent>
    <name type="string">ommit_me</name>
  </obj-mirror>
</cm-request>

<cm-response ...>
  <cm-code numeric="200" phrase="OK">
    <obj>
      <id>98617</id>
    </obj>
  </cm-code>
</cm-response>