Package: Abhängigkeiten prüfen

Das Modul kann in einem Zielmandanten prüfen, ob die Abhängigkeiten eines Package dort erfüllt sind. Dabei kann entweder ein Package-Archiv oder ein Package-Name und die Abhängigkeitsdefinitionen angegeben werden. Die Ergebnisse der Prüfung werden im Report aufgezeigt und optional in einem Variable-Objekt gespeichert.

Bezeichnung

Name

pm.DependencyCheck

Aliase

DependencyCheck, pm.PackageDependencyCheck

Konfiguration

Gruppe: Ausgabe

Variable-Objekt (variable)

Name des Variable-Objekts, das für die Speicherung der Daten genutzt wird

Quellverbindung für die Variable (variable-source)

Ist die Option gesetzt, dann definiert diese eine alternative b4A Verbindung unter der die Variable gefunden werden kann.

Mögliche Werte: <definierte b4A Verbindungen>

XML-Variable (xml-variable)

Name des XML-Variable-Objekts, das zur Speicherung der Informationen genutzt wird

Key (xml-variable-key)

Key in dem XML-Variable-Objekt, der verwendet werden soll

Quellverbindung für die Variable (xml-variable-source)

Ist die Option gesetzt, dann definiert diese eine alternative b4A Verbindung unter der die Variable gefunden werden kann.

Mögliche Werte: <definierte b4A Verbindungen>

Gruppe: Optionen

Modus (mode)

Definiert, ob die Package- und Abhängigkeitsinformationen von einem Package-Archiv gelesen oder per Option übergeben werden

Mögliche Werte: Package-Archiv (file), Optionen (option)

Package (package)

Name des Package

Abhängigkeitsdefinitionen (dependencies)

Die Abhängigkeitsdefinitionen des zu prüfenden Package

Package-Release-Datei (zip-file)

Absoluter Pfad zur Package-Release-Datei

../../_images/pm-dependencycheck-option.png ../../_images/pm-dependencycheck-file.png

Beschreibung

Werden die Daten in einem Variable-Objekt gespeichert, dann werden die Spalten wie folgt belegt

  • Key: Eine laufende Nummer, die ausschließlichaus eindeutige Kennung dient

    1. Wert: Package-Name

    1. Wert: Operator

    1. Wert: Versionsnummer

    1. Wert: Status (OK: die Abhängigkeit ist erfüllt, FAILED: die Abhängigkeit ist fehlerhaft, MISSING: Das Package ist nicht installiert)

    1. Wert: Ist der Status FAILED steht in diesem Wert die installierte Version des Package

Ausgabe

Die Ausgabe kann in eine statische oder eine XML-Variable geschehen. Theoretisch auch parallel in beide gleichzeitig.

Statische Variable

Die statische Variable, die das Ergebnis der Analyse enthält, speichert die folgenden Werte in den einzelnen Spalten:

  • Key: Zähler

  • Wert 1: Name des Packages

  • Wert 2: Operator der Abhängigkeitsdefinition

  • Wert 3: Version der Abhängigkeitsdefinition

  • Wert 4: Status

    • OK: Die Abhängigkeitsdefinition passt im Zielmandanten

    • MISSING: Das Package ist im Zielmandanten nicht installiert

    • FAILED: Das Package ist installiert, passt aber nicht mit dem Versionsvergleich überein

  • Wert 5: Installierte Version (bei Status FAILED)

../../_images/pm-dependencycheck-variable.png

XML-Variable

Wird das Ergebnis in eine XML-Variable geschrieben, dann werden die Daten in dem folgenden Format gespeichert.

<best4Automic version="5.3.0">
    <pm>
        <package name="B4A.PM">
            <dependencies>
                <dependency operator="~=" package="B4A.WEB" version="2.0.0">
                    <status>FAILED</status>
                    <installed version="1.0.0"/>
                </dependency>
                <dependency operator="&gt;=" package="B4A.TEST" version="1.3.4">
                    <status>MISSING</status>
                    <installed version=""/>
                </dependency>
                <dependency operator="~=" package="B4A.BASE" version="1.0.0">
                    <status>OK</status>
                    <installed version="1.0.0"/>
                </dependency>
            </dependencies>
        </package>
    </pm>
</best4Automic>