dms.XMLCopy

Dieser Job kopiert Objekte, es können Ordner, Register und Dokumente kopiert werden. Werden Register oder Ordner kopiert, so kann mit der Option COPYCASCADING bestimmt werden, ob alle enthaltenen Objekte kaskadierend mit kopiert werden sollen.

Wird ein Dokument kopiert, so kann es als neues Dokument kopiert werden oder am neuen Standort kann ein Verweis des ursprünglichen Dokumentes entstehen. Das Dokument besitzt dann zwei Standorte, es existiert dann jedoch lediglich ein Indexdatensatz. Um das Dokument so zu verlinken, ist die Joboption LINKDOCUMENT anzugeben. Für eine solche Verweiskopie müssen sich der Quellund der Zielstandort unterscheiden. Diese Option gilt auch für alle Dokumente, die durch die Angabe der Option COPYCASCADING kopiert werden.

Die Eltern-Attribute (Registerid, Registertyp und Ordnerid) sind die Attribute, die den neuen Standort bezeichnen. Dabei sollte die Ordnerid auch in dem Fall angegeben werden, dass der neue Standort des Objektes ein Register ist. Der Registertyp kann vom Executor ermittelt werden, aus Performancegründen sollte dieses jedoch immer angegeben werden.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

allgemeine Optionen für den Job (siehe Flags)

Options

STRING

Ja

Semikolon-separierte Job-Optionen (z. B. LINKDOCUMENT=1;CHECKACCESS=0) (siehe Parameter Options)

XML

BASE64

Ja

enthält Objektbeschreibung im XML-Format (siehe DMSData XML-Format und Der Parameter XML)

JobUserGUID

STRING

Ja

bestimmt den Benutzerkontext (siehe Der Parameter JobUserGUID)

2. Eingabedateien

Name Beschreibung

File_N

(STRING) N-ter Dateipfad als Alternative zur Dateiliste

3. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode
Vollständige Fehlerliste

Keine jobspezifischen Rückgabewerte.

Die folgenden XML-Beispiele enthalten immer alle Tags und Tag-Attribute, die für die jeweilige Aktion verwendet werden können. Nicht benötigte Tags bzw. Attribute können natürlich weggelassen werden.
XML für das Erstellen eines neuen Standortes für ein Dokument
<?xml version="1.0" encoding="UTF-8"?>
<DMSData>
  <Archive id="-1" internal_name="press_archive">
    <ObjectType type="DOCUMENT" internal_name="word_documents" id="-1">
      <Object object_id="28" folder_id="58" register_id="-1" register_type="-1"/>
    </ObjectType>
  </Archive>
</DMSData>