Repositorys: Index

Erstellt einen Repository-Index, der eine Liste der Package-Repositorys und deren Zweige enthält

Bezeichnung

Name

vcs.Index

Konfiguration

Beschreibung

Der Repository-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 konfiguriert werden. Sollten in einer Umgebung sehr viele b4A Packages existieren, die in Git-Repositorys vorgehalten werden, kann es notwendig sein diese Grenze zu erhöhen. Bis zu einer Anzahl von zirka 1000 Git-Repositorys 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 Git-Repository-Indexes 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