obj objRef createAndLoad

Verfügbar für: Content Management Server

Aufgabe: Legt eine neue Datei mit einer Arbeitsversion an und lädt den angegebenen Inhalt. Die angegebene Datei, in der die neue Datei angelegt werden soll, muss ein Ordner sein.

Syntax:

obj (withId objId) | (withPath path) | root createAndLoad {parameter value}

Zusatzinformationen:

• Einer der Parameter blob, blob.plain, blob.base64, blob.stream oder file muss angegeben werden. Werden mehrere dieser Parameter angegeben, so ist undefiniert, welcher ausgewertet wird.
• Der Parameter contentType muss angegeben werden.
• Die Angabe der Dateivorlage kann entfallen, wenn eine Dateiendung angegeben wurde, die lediglich in einer einzigen Dateivorlage als validContentType eingetragen ist, so dass die Dateivorlage eindeutig ermittelt werden kann.

Funktionsparameter:

• parameter ist der Name eines für die Dateierzeugung wichtigen Parameters. Der Wert des Parameters wird im entsprechenden value-Parameter angegeben. parameter kann sein:
  • blob, blob.plain, blob.base64 oder blob.stream gibt an, dass value den zu importierenden Inhalt in der richtigen Kodierung enthält bzw. dass value ein Streaming-Ticket enthält, unter dem der zu importierende Inhalt hochgeladen wurde. Werden mehrere dieser Parameter angegeben, so ist undefiniert, welcher ausgewertet wird.
  • charset: der Zeichensatz des Inhalts bei Dateien, die keine Bilder oder Ressourcen sind. Wird er nicht angegeben, so wird der Zeichensatz aus der Benutzereinstellung charset verwendet. Der Content Manager konvertiert den Inhalt nach UTF-8. Die Liste der verfügbaren Zeichensätze kann mit dem Tcl-Befehl encoding names ermittelt werden.
  • contentType: die Dateiendung, die der übergebene Inhalt hat.
  • 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. Dieser Parameter kann nur von Entwicklern sinnvoll eingesetzt werden.
  • objClass: der Name der Dateivorlage, das der neuen Datei zugeordnet werden soll.
  • name: der Name, den die neue Datei erhalten soll. Wird er nicht angegeben, so wird ein Name erzeugt.
  • suppressExport: gibt an, ob die Datei exportiert werden soll.
• value enthält den Wert des betreffenden Parameters.

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

Erforderliche Rechte (nur CM):

• Der Benutzer muss das Recht permissionCreateChildren im Zielordner haben.
• Der Benutzer muss das in der Vorlage des Zielordners gesetzte globale Dateianlegerecht haben.

Beispiel:

CM>obj root createAndLoad name news objClass newspub \
blob.base64 [encodeFile /opt/NPS/upload/newslist.html]
news