Package: Index

Erstellt einen Package-Index, der eine Liste der installierten Packages und deren Metadaten enthält

Bezeichnung

Name

pm.Index

Konfiguration

Gruppe: Optionen

inkludiere den Index für Basisordner (include-base-folders)

ist die Option gesetzt, wird ebenfalls ein Index für die konfigurierten Basisordner erstellt

Beschreibung

Der Package-Index wird in einer XML-Variable gespeichert. In der Automation Engine gibt es für die Größe von Einträgen einer Variablen eine Beschränkung. Diese ist per Vorgabewert auf 1 MB gesetzt. Dieser kann über die Einstellung MAX_VARIABLE_SIZE in der UC_SYSTEM_SETTINGS. Sollten in einer Umgebung sehr viele b4A Packages existieren, kann es notwendig sein diese Grenze zu erhöhen. Bis zu einer Anzahl von zirka 1000 b4A Packages sollte der Vorgabewert ausreichen. Bevor die Einstellung geändert wird, sollten in der Dokumentation der Automic Automation die Auswirkungen geprüft werden.

Weitere Details zum Aufbau des Package-Index sind im Abschnitt Index zu finden.

Ausgabeformat XML-Variable

Der Index der installierten b4A Packages sieht als XML-Dokument wie im folgenden Beispiel aus.

<?xml version="1.0" encoding="UTF-8"?>
<best4Automic version="4.4.0">
    <pm>
        <index>
            <packages>
                <package name="BBC.AE_UTILS" version="1.0.0">
                    <description>Actions for using the Automic Automation Engine Utilities</description>
                    <folder>PACKAGES/BEST-BLU</folder>
                    <dependencies>
                        <dependency name="BBC.SHARED" operator="~=" version="1.0.0"/>
                    </dependencies>
                    <metadata>
                        <entry key="Categories" value="BEST-BLU/AUTOMIC"/>
                    </metadata>
                </package>
                <package name="BBC.FILEOPS" version="1.0.0">
                    <description>A set of actions for file operations (Windows only)</description>
                    <folder>PACKAGES/BEST-BLU</folder>
                    <dependencies>
                        <dependency name="BBC.SHARED" operator="~=" version="1.0.0"/>
                    </dependencies>
                    <metadata>
                        <entry key="Categories" value="BEST-BLU/FILESYSTEM, FILESYSTEM"/>
                    </metadata>
                </package>
            </packages>
        </index>
    </pm>
</best4Automic>

Beispiel um vom b4A Package BBC.FILEOPS Die Versionsnummer auszulesen.

/best4Automic/pm/index/packages/package[@name="BBC.FILEOPS"]/@version

Beispiel zum Auslesen von Informationen aus der XML Variablen mit Mitteln der Automation Engine scripting language

:SET &hnd# = PREP_PROCESS_VAR_XML(B4A.PM.INDEX, "Packages", '/best4Automic/pm/index/packages/package/@name')
:PROCESS &hnd#
:  SET &package# = GET_PROCESS_LINE(&hnd#, 1)
:  SET &version# = GET_VAR(B4A.PM.INDEX, "Packages", '/best4Automic/pm/index/packages/package[@name="&package#"]/@version')
:  PRINT &package# -- &version#
:ENDPROCESS