<obj-create>

Definition:

<!ENTITY % cm.obj-create "
  (name |
  objClass |
  suppressExport |
  contentType |
  blob |
  filter |
  file |
  xmlBlob)*
">
<!ELEMENT obj-create %cm.obj-create;>

Aufgabe: Erzeugt eine neue Datei mit den angegebenen Parameterwerten.

Spezielle Parameter dieses Funktionselements:

• blob: der in der Arbeitsversion der Datei zu speichernde Blob. Mit dem Attribut encoding und dessen Werten plain, base64 und stream werden Ursprung und Speicherformat des Blobs festgelegt:
  • plain: der Blob ist als Inhalt des Elements blob angegeben.
  • base64: der Blob ist als base64-kodierter Inhalt des Elements blob angegeben.
  • stream: der Inhalt des Elements blob ist ein Streaming-Ticket, unter dem der Blob zu finden ist. Zuvor wurde der Blob über das Streaming Interface zum Server übertragen, der das Ticket zurückgegeben hat (zum Streaming-Interface siehe auch das Handbuch zur Systemadministration / Entwicklung).
  • contentType: die Dateiendung der Arbeitsversion der Datei.
• file: ein relativer, aus höchstens zwei Komponenten bestehender Pfad zu der richtig kodierten zu importierenden Datei. Der Pfad bezieht sich auf das temporäre Verzeichnis des Benutzers und darf nicht mit dem übergeordneten Verzeichnis beginnen. file und blob schließen sich gegenseitig aus.
• filter: der Konverter, der beim Laden verwendet werden soll. Dieser Parameter ist aus Gründen der Kompatibilität noch vorhanden, wird jedoch ignoriert.

Rückgabewert bei Erfolg: die ID der neuen Datei.

Erforderliche Rechte: Der authentifizierte Benutzer muss das Recht permissionCreateChildren in dem darüber liegenden Ordner der späteren Datei und das in der Vorlage der späteren Datei definierte globale Dateierzeugungsrecht haben, um es anlegen zu dürfen.

Beispiel:

<cm-request...>
  <obj-where>
    <id>2001</id>
  </obj-where>
  <obj-create>
    <objClass>news</objClass>
    <name>2007-03-26</name>
    <contentType>html</contentType>
    <blob>Ein Hauptinhalt</blob>
  </obj-create>
</cm-request>

<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <obj>
      <id>2001</id>
    </obj>
  </cm-code>
</cm-response>