IMPORT

Mit der Script-Funktion IMPORT können Sie Objekte oder Ordnerstrukturen aus einer XML-Datei importieren.

Diese Seite beinhaltet Folgendes:

Übersicht

Wenn Sie den Inhalt importieren, wird ein neuer Ordner ##INCLUDED_EXTERNALS## auf der gleichen Ebene wie der zugehörige Ordner auf dem Zielsystem erstellt. Verlinkte Objekte werden im Ordner ##INCLUDED_EXTERNALS## gespeichert.

Die Standardgröße der XML-Datei beträgt 30720 KB. Administratoren können ein anderes MAX_IMPORT_SIZE-Limit angeben. Weitere Informationen finden Sie unter UC_SYSTEM_SETTINGS: systemweite Einstellungen.

Hinweise:

  • Verwenden Sie IMPORT nicht für den Massentransport. Verwenden Sie den Transportkoffer, wenn Sie große Mengen an Inhalten verschieben müssen. Weitere Informationen finden Sie unter Transportieren von Daten.
  • Objekte werden im angegebenen Ordner angelegt. Existiert der Ordner nicht oder fehlt dieser Parameter, werden die Objekte in <No folder> gespeichert.
  • Nicht-Ordnerobjekte werden beim Import nicht als Objekte behandelt. Die Importeinstellungen gelten nur für Ordnerobjekte.
  • Sie müssen Schreibrechte auf das Objekt oder den Zielordner haben. Wenn Sie nicht über ausreichende Berechtigungen verfügen, schlägt der Import fehl. Weitere Informationen finden Sie unter Gewähren von Automation Engine-Berechtigungen.
  • Diese Script-Funktion schreibt alle offenen Transaktionen des Scripts in die AE-Datenbank. Weitere Informationen finden Sie unter Script-Verarbeitung.
  • Informationen über den Import werden im Aktivierungsreport des Objekts gespeichert, das den Import aufruft.

Wichtig!

  • Importe in den Ordner "Versionsmanagement" sind nicht erlaubt.
  • In verteilten AE-Umgebungen laufen Arbeitsprozesse auf verschiedenen Computern. Sie müssen definieren, auf welchem Computer der Export erfolgt.
    • (Windows) Geben Sie unter Windows den UNC-Pfad an. Der Server muss unter einem entsprechenden Domain-User laufen, um auf UNC-Namen zugreifen zu können.
    • (UNIX) Geben Sie den absoluten Pfad in UNIX-Notation an.
  • Das Dateisystem muss zugänglich sein (NFS; mount-Befehl), aber es ist nicht wichtig, auf welchem Computer es sich befindet. Nur so kann sichergestellt werden, dass auch die gewünschte XML-Datei verwendet wird.

Syntax

IMPORT (Datei [,[Ordner], [Objekteinstellung] [,Verknüpfungseinstellung]] )

Parameter

  • Datei
    Name der zu importierenden Datei (mit vollständiger Pfadangabe)
    Format: Script-Literal oder Script-Variable

  • Ordner
    Name des Ordners zum Speichern des importierten Inhalts
    Format: Script-Literal oder Script-Variable

  • Objekteinstellung
    Überspringt oder überschreibt vorhandenen Inhalt
    Format: Script-Literal, Script-Variable oder Zahl
    Zulässige Werte:

    • 0
      Überspringt vorhandene Objekte
    • 1 (Standard)
      Überschreibt bestehende Objekte oder Ordner

  • Verknüpfungseinstellung
    Ignoriert oder behält vorhandene Ordner-Verknüpfungen oder externe Objekte bei
    Format: Script-Literal, Script-Variable oder Zahl 
    Hinweis: Der Parameter ist nur relevant, wenn Sie die Objekteinstellung auf 1 setzen.
    Zulässige Werte:

    • 0
      Ignoriert bestehende Ordnerverknüpfungen und externe Objekte
    • 1 (default)
      Behält bestehende Ordnerverknüpfungen bei und importiert externe Objekte


Rückgabewerte

  • 0
    Erfolgreicher Import
  • 20657
    Zielordner existiert nicht
  • 20692
    Datei existiert nicht
  • 21724
    Ein Dateizugriff ist aufgrund fehlender Berechtigung nicht möglich
  • 21729
    Import nicht möglich: XML-Datei zum Importieren hat nicht das erforderliche AE-Format
  • 21730
    Die importierte XML-Datei entspricht nicht der erforderlichen Kodierung
  • 21732
    Fehler beim Import aufgetreten - für weitere Details siehe Aktivierungsreport

Tipp: Verwenden Sie die Script-Anweisung :ON_ERROR, um Maßnahmen für den Fall zu definieren, dass der Import fehlschlägt. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Beispiele

Dadurch werden jedoch alle existierenden Verknüpfungen der importierten Objekte gelöscht. Das Script verwendet eine Script-Variable, um den Datei- und Ordnernamen an die IMPORT-Funktion zu übergeben.

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

(UNIX) Das folgende Beispiel importiert eine Ordnerstruktur:

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

IMPORT-Script-Funktion in AAKE

In AAKE funktioniert der Befehl :IMPORT innerhalb des WP-Containers. Um die Datei außerhalb des Containers verfügbar zu machen, sollte ein Persistent Volume (PV) für den Container bereitgestellt werden. Wenn ein vorhandenes PV für Protokolle oder Traces konfiguriert ist, kann es zum Importieren der Dateien verwendet werden.

Sie können die Datei in den Ordner "log/trace" des POD importieren, der sich unter /usr/server/temp/log/ bzw. /usr/server/temp/trace/ befindet. Beispiel:

:SET &RET# = IMPORT("/usr/server/temp/log/<file>.xml", "/<folder>", 1)

Aufgrund der PV-Konfiguration wird die Datei aus dem PV-Ordner auf dem Server abgerufen, auf dem die Pods ausgeführt werden.

Siehe auch: