EXPORT

Objekte bearbeiten

MODIFY_OBJECT

---

IMPORT

Script-Funktion: Importiert Objekte aus einer XML-Datei.

Syntax

IMPORT(File [,[Folder], [Object Setting], [Link Setting]])

Anmerkungen

Mit der Script-Funktion können Objekte aus einer entsprechend formatierten XML-Datei importiert werden.

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

Beim Import von Ordnerstrukturen wird die XML-Datei Informationen über die Ordnerstruktur am Anfang der Datei enthalten. Während des Imports werden alle Ordner, Nicht-Ordner-Objekte, verknüpfte Objekte und Unterordner eingeschlossen und es wird ein neuer Ordner namens ##INCLUDED_EXTERNALS## auf der gleichen Ebene als vorgesehener Zielsystemordner erstellt. Verknüpfte Ordner und Nicht-Ordner-Objekte werden im Ordner ##INCLUDED_EXTERNALS## gespeichert.

Nicht-Ordner-Objekte werden beim Import nicht als Objekte behandelt. Daher gelten Importeinstellungen nur für Ordner-Objekte.

Objekte werden im angegebenen Ordner angelegt. Existiert der Ordner nicht oder fehlt dieser Parameter, werden die Objekte in <Kein Ordner> gespeichert.

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

Standardgröße der XML-Datei ist 1024 KB, die maximale Dateigröße ist 30720 KB. In der Variable UC_SYSTEM_SETTINGS kann der Administrator eine andere Größe mit dem Key "MAX_IMPORT_SIZE" definieren.

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

 Der Import schlägt fehl, wenn Sie für das Objekt oder den Zielordner keine Schreibberechtigung besitzen.

Beachten Sie, dass ein Import in den Ordner "Versionsmanagement" nicht möglich ist!

In einer verteilten AE-Umgebung (Workprozesse laufen auf verschiedenen Rechnern) kann nicht beeinflusst werden, auf welchem Rechner der Import 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.

Beispiel

Im folgenden Beispiel werden eventuell vorhandene Objekte beim Importieren übersprungen. Sowohl die Datei als auch der Ordnername werden der Funktion als Script-Variablen übergeben. 

:SET &FILE#  = "\\PCUC4\UC4global\IMPORT\uc4_import.xml"
:SET &FOLDER# = "IMPORT/JOBS"
:SET &RET#    = IMPORT(&FILE#,&FOLDER#,"0")

Beispiel für das Importieren einer Ordnerstruktur:

Beispiel für UNIX:

:SET &FILE#  = "/opt/UC4/import/uc4_import.xml"
:SET &FOLDER# = "IMPORT/JOBS"
:SET &RET#    = IMPORT(&FILE#,&FOLDER#,"0")

Siehe auch:

Script-Sprachmittel - Objekte bearbeiten

Import und Export von Objekten

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