CREATE_OBJECT

Objekte bearbeiten

IMPORT

---

EXPORT

Scriptfunktion: Exportiert Objekte in eine XML-Datei.

Syntax

EXPORT(Folder, File [,Include_External_Objects])

EXPORT(Object, File [, ,Include_Referenced_Objects])

Anmerkungen

Mit der Scriptfunktion können Objekte in eine angegebene XML-Datei exportiert werden. Der Rückgabewert der Scriptfunktion ist null, wenn der Export erfolgreich war.

Beim Export von Ordnerstrukturen wird die XML-Datei Informationen über die Ordnerstruktur am Anfang der Datei enthalten.
Während des Exports werden sämtliche Ordner, Nicht-Ordner-Objekte, Unterordner und verknüpfte Objekte in den Export eingeschlossen.

Während des Imports wird ein neuer Ordner namens ##INCLUDED_EXTERNALS## auf der gleichen Ebene als vorgesehener Zielsystemordner erstellt.
Verknüpfte Objekte werden im Ordner ##INCLUDED_EXTERNALS## gespeichert.
Einzelheiten über das Importieren, siehe Informationen über das Script-Sprachmittel IMPORT.

Die Import-Export-Funktionalität ist nicht für Massentransporte geeignet! Verwenden Sie in solchen Fällen den Transportkoffer.

Mit der Script-Anweisung :ON_ERROR legen Sie die Reaktion auf einen fehlerhaften Export fest. Sie können ihn mit den Scriptfunktionen zur Fehlerbehandlung analysieren. Das Script wird weiter prozessiert. Es besteht aber auch die Möglichkeit, die Prozessierung des Scripts abzubrechen.

Vor dem Exportvorgang wird geprüft, ob die Datei bereits existiert. Trifft dies zu, wird sie überschrieben. Ist die Datei schreibgeschützt, kann der Export nicht durchgeführt werden.

 Der Export schlägt außerdem fehl, wenn der Benutzer das Recht "Lesen" (R) auf das Objekt nicht besitzt.

Nähere Informationen über den Exportvorgang werden in den Aktivierungsreport des Objektes geschrieben, das den Export aufruft.

In einer verteilten AE-Umgebung (Workprozesse laufen auf verschiedenen Rechnern) kann nicht beeinflusst werden, auf welchem Rechner der Export durchgeführt wird! Geben Sie daher unter Windows den UNC-Pfad an. Beachten Sie, dass der Server unter einem entsprechenden Domain-User laufen muss, um auf UNC-Namen zugreifen zu können. Bei Verwendung eines UNIX-Servers muss der absolute Pfad in UNIX-Notation angegeben werden. Zusätzlich muss das Dateisystem zugreifbar sein (NFS; mount-Befehl), wobei es keine Rolle spielt, auf welchem Rechner sich dieses befindet. Nur so kann sichergestellt werden, dass auch die gewünschte XML-Datei verwendet wird. 

Das Script-Sprachmittel bewirkt, dass die offenen Transaktionen des Scripts in die Datenbank geschrieben werden.

Beispiele

Im folgenden Beispiel für Windows und UNIX werden alle Objekte, deren Namen mit "MAWI.TAG" beginnt, exportiert Sowohl die Objektbezeichnung als auch der Dateiname werden der Funktion als Script-Variable übergeben.

Für Windows:

:SET &OBJECT# = "MM.DAY*"
:SET &FILE#  = "\\PC\ ae \EXPORT\ ae _export.xml"
:SET &RET#   = EXPORT(&OBJECT#,&FILE#)

Für UNIX:

:SET &OBJECT# = "MM.DAY*"
:SET &FILE#  = "/opt/ ae /import/ ae _export.xml"
:SET &RET#    = EXPORT(&OBJECT#,&FILE#)

Das folgende Beispiel exportiert eine Ordnerstruktur:

:SET &RET# = EXPORT ("\TESTFOLDER\EXPORT_STRUCTURE", "\\PC\ae\EXPORT\ae_export.xml", "Y")

This example exports a workflow with references:

:SET &RET# = EXPORT ("EXAMPLE_WORKFLOW", "\\PC\ae\EXPORT\ae_export.xml", ,"Y")

Siehe auch:

Script-Sprachmittel - Objekte bearbeiten

Import und Export von Objekten

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung