ARCHIVE

Dieser Tag beinhaltet mindestens ein PACKAGE-Tag.

Erforderliches Attribut ist name.

Optionale Attribute sind description, uimode und error_action.

uimode: Modus der Interaktion mit dem Benutzer. Mögliche Werte:

full – Der Benutzer sieht den Fortgang des Installationsvorgangs und erhält Informationen zur aktuell durchgeführten Aktion und alle Fehlermeldungen. (Standard)

simple – Der Benutzer sieht nur Fehlermeldungen.

none – Der Benutzer erhält keinerlei Meldungen.

error_action: Verhalten im Fehlerfall. Mögliche Werte:

abort – Die Installation wird abgebrochen. Der Administrator sieht, dass die Installation fehlgeschlagen ist.

ignore – Der Fehler wird ignoriert. Es wird kein Fehler gemeldet.

retry – Der fehlgeschlagene Schritt wird erneut durchgeführt (maximal dreimal).

ask – Der Benutzer wird gefragt, ob die Installation abgebrochen, der Fehler ignoriert oder der fehlgeschlagene Schritt wiederholt werden soll. (Standard)

PACKAGE

Dieser Tag beinhaltet optional ein PREREQ-Tag und mindestens ein TASK-Tag.

Erforderliches Attribut ist name.

Optionales Attribut ist description. 

PREREQ

Dieser Tag beinhaltet einen oder mehrere Tags vom Typ APPLICATION. Wenn die Prüfung bei einem der APPLICATION-Tags negativ ausfällt, wird die Ausführung abgebrochen.

APPLICATION

Mit den hier angegebenen Informationen wird geprüft, ob das Paket installiert werden kann.

Die erforderlichen Attribute name und version entsprechen denen im Mobile Component Descriptor.

Die optionalen Attribute prefixmatch und comparator werden verwendet, um Name und Version mit der installierten Version zu vergleichen. 

Mögliche Werte für comparator: less, less_equal, equal, greater_equal, greater, not_equal, dont_care.

Optionales Attribut prefixmatch: true, false

TASK

Dieser Tag beinhaltet mindestens ein Befehls-Tag. Mögliche Befehle sind:

REMOVE_FROM_ARCHIVE

ADD_TO_ARCHIVE

REMOVE_FROM_CLASSPATH

ADD_TO_CLASSPATH

SET_PROPERTIES

DELETE

COPY

EXECUTE

Optionale Attribute sind description und name.

REMOVE_FROM_ARCHIVE

Entfernt Dateien oder Verzeichnisse aus einen ZIP- oder JAR-Archiv.

Das Attribut targetArchive definiert den Speicherort der Client-Datei. Die zulässigen Platzhalter können verwendet werden. Weitere Informationen finden Sie in der Tabelle unten.

Das Attribut target bezeichnet eine Datei oder ein Verzeichnis relativ zum Archiv-Wurzelverzeichnis. Wenn das Attribut pattern verwendet wird, muss target ein Verzeichnis sein. Der Wert von pattern wird dann relativ zu target interpretiert.

Während dieses Befehls darf die SAP MI nicht laufen.

ADD_TO_ARCHIVE

Fügt einem ZIP- oder JAR-Archiv Dateien oder Verzeichnisse hinzu. Bereits vorhandene Dateien oder Verzeichnisse werden überschrieben.

Das Attribut source bezeichnet das Quellverzeichnis der Datei. Wenn dieses lokal ist, können die zulässigen Platzhalter verwendet werden, siehe unten. Wenn das Attribut pattern verwendet wird, muss source ein Verzeichnis bezeichnen.

Das Attribut targetArchive definiert das zu aktualisierende Verzeichnis. Das Attribut target bezeichnet eine Datei oder ein Verzeichnis relativ zum Archiv-Wurzelverzeichnis.

Wenn source eine Datei ist, muss target ebenfalls eine Datei sein.

Während dieses Befehls darf die SAP MI nicht laufen.

REMOVE_FROM_CLASSPATH

Entfernt einen Eintrag aus der Datei listOfJars.txt.

Das Attribut classpathentry definiert den absoluten Pfad zu einem Archiv. Es kann die zulässigen Platzhalter enthalten, weitere Informationen finden Sie in der Tabelle unten.

Es ist nicht relevant, ob die SAP MI zu diesem Zeitpunkt läuft.

ADD_TO_CLASSPATH

Fügt der Datei listOfJars.txt einen Eintrag hinzu.

Das Attribut classpathentry definiert den absoluten Pfad zu einem Archiv. Es kann die zulässigen Platzhalter enthalten, siehe unten.

Es ist nicht relevant, ob die SAP MI zu diesem Zeitpunkt läuft.

SET_PROPERTIES

Aktualisiert PROPERTIES-Dateien.

Das Attribut source definiert die Quelldatei. Wenn dieses lokal ist, können die zulässigen Platzhalter verwendet werden, siehe unten. Die Datei muss java.util.properties-konform sein.

Das Attribut target definiert die zu aktualisierende Datei. Einträge in der Quelldatei überschreiben entsprechende Einträge in der zu aktualisierenden Datei.

In der Quelldatei mit R_E_M_O_V_E. gekennzeichnete Einträge werden aus der zu aktualisierenden Datei gelöscht.

Es ist nicht relevant, ob die SAP MI zu diesem Zeitpunkt läuft.

DELETE

Kopiert lokale Dateien oder Verzeichnisse.

Das Attribut targetFolder definiert zusammen mit pattern die Dateien, die gelöscht werden sollen. Es können zulässige Platzhalter verwendet werden, weitere Informationen finden Sie in der Tabelle unten.

Während dieses Befehls darf die SAP MI nicht laufen.

COPY

Kopiert lokale Dateien oder Verzeichnisse. Bereits vorhandene Dateien oder Verzeichnisse werden überschrieben.

Für target und source können zulässige Platzhalter verwendet werden, weitere Informationen finden Sie in der Tabelle unten.

EXECUTE

Führt ausführbare Dateien in einem eigenen Prozess aus.

Das Attribut executable muss gesetzt werden und definiert die ausführbare Datei. Es können zulässige Platzhalter verwendet werden, weitere Informationen finden Sie in der Tabelle unten.

Das Attribut commandline ist optional, auch hier können Platzhalter verwendet werden.

Das Attribut blocking definiert, ob der Installationsprozess blockiert wird, bis die Ausführung der Datei beendet ist (Wert true), oder ob beide Prozesse parallel laufen (Wert false).

Attribut

Bedeutung

description

Definiert den Text, der dem Benutzer angezeigt wird, während der Befehl ausgeführt wird oder wenn ein Fehler auftritt.

mi_running

Gibt an, ob die SAP MI Client Component während der Ausführung des Befehls laufen darf oder nicht. Mögliche Werte:

true – SAP MI muss laufen

false – SAP MI darf nicht laufen (Standard)

pattern

Definiert über Dateimuster, welche Dateien und Verzeichnisse vom Befehl betroffen sind.

Folgende Muster sind möglich:

relative Dateinamen mit Ordnern. Ordnertrennzeichen ist /.

* für Zeichen in Dateinamen (einmal pro Muster)

** für alle Unterverzeichnisse

Beispiel:

/test/xyz.properties – für genau eine Datei

**/ xyz.properties – alle Dateien namens xyz.properties in allen Unterverzeichnissen

**/*.properties – alle Dateien mit der Endung .properties in allen Unterverzeichnissen

sourcelocation

Definiert, wie die Quellangabe definiert ist.

local – lokaler Pfad auf dem mobilen Endgerät

archive – relativer Pfad im Installationsarchiv

Platzhalter

Einsatzmöglichkeiten

MI_HOME

Installationsverzeichnis der SAP MI Client Component

JAVA_HOME

Java-Installationsverzeichnis

JAVA_LIB

Verzeichnis der Java-Bibliotheken (%MI_HOME%\lib)

NATIVE_LIB

Verzeichnis der nativen Bibliotheken (%MI_HOME%\bin)

CI_HOME

Installationsverzeichnis des Client-Installer

WINDOWS

Windows-Verzeichnis (C:\WINNT, C:\WINDOWS)

WINDOWS_STARTUP

Windows-Startup-Verzeichnis

PROGRAM_FILES

Windows-Programmverzeichnis

MI_PERSONAL

Dateisystemverzeichnis, das für die gemeinsame Ablage von Dokumenten verwendet wird

OS

Betriebssystem. Kann verwendet werden, wenn ein Archiv für mehrere Plattformen verwendet wird.