Objekt: Versionen lesen

Das Modul liest die Details des Version Management von Objekten und speichert diese in einer strukturierten Dokumentation

Bezeichnung

Name

info.VersionManagement

Aliase

info.Versions

Konfiguration

Gruppe: Ausgabe

Speichere b4A-Objektliste (save-objects)

Speichert die verarbeiteten Objekte in einer b4A-Objektdatei

Speichere b4A-Objektvariable (save-objects-vara)

Speichert die verarbeiteten Objekte in einer b4A-Objektvariable

Speichere nur erfolgreich verarbeitete Objekte (save-success-only)

Ein Objekt wird nur dann in die Datei geschrieben wenn die Verarbeitung erfolgreich war

Hänge verarbeitete Objekte an existierende Datei/Variable an (save-append)

Wenn die Datei/Variable bereits existiert werden neue Einträge angehängt.

Objekt für strukturierte Dokumentation (structured-docu)

Wenn angegeben, dann werden die Informationen in der strukturierten Dokumentation des Objektes gespeichert

Verbindung (structured-docu-connection)

Wenn angegeben, dann wird das Objekt für die strukturierte Dokumentation in der Verbindung genutzt.

Mögliche Werte: <definierte b4A Verbindungen>

Name der strukturierten Dokumentation (structured-docu-name)

Definiert den Namen des Reiters der strukturierten Dokumentation, die verwendet werden soll. Ist der Wert leer, dann wird die Erste genutzt.

strukturierte Dokumentation zuvor leeren (structured-docu-reset)

Wenn gesetzt, dann wird die strukturierte Dokumentation des Objektes zuvor geleert

XML-Variable (xml-variable)

Name des XML-Variable-Objekt, dass zur Speicherung der Informationen genutzt wird

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>

Beschreibung

Die strukturierten Dokumentation ist so gegliedert, dass zu mehreren Objekten Versionsinformationengespeichert werden können. Auf der ersten Ebene wird ein Knoten Object angelegt. In den Attributen werden die folgenden Details gespeichert:

  • HighestVersion: Die höchste Versionsnummer in der Liste. Dies stellt die letzte Version vor der aktuellen dar.

  • NumberOfVersions: Anzahl der Versionen, die in der Liste zu finden sind.

  • Name: Name des Objektes zu dem die Versionen gehören.

../../_images/info-versionmanagement-object.png

Unter jedem Knoten Object werden für jede gefundene Version weitere Knoten mit dem Namen Version angelegt. Die Details sind wieder in den Attributen zu finden.

  • Version: Nummer der Version

  • Title: Titel des Objektes zu dem Zeitpunkt als die Versionerzeugt wurde

  • ModifiedBy: Name des Benutzers, der diese Version erstellt hat

  • ModifiedDate: Datum zu dem diese Version erzeugt wurde

  • Name: Jetziger Name des Objektes in dem diese Version gespeichert ist

../../_images/info-versionmanagement-version.png

Ausgabeformat XML-Vatriable

Der Bericht über das Versionsmanagament eines Objekte sieht als XML-Dokument wie im folgenden Beispiel aus.

<?xml version="1.0" encoding="UTF-8"?>
<best4Automic version="4.4.0">
    <info>
        <version-management numberOfVersions="4">
            <current version="5">
                <modification date="2020-12-22 09:45:50" user="USER/DEPARTMENT"/>
                <title>Pulls a version of a package from a GIT repository</title>
            </current>
            <archive>
                <version version="4">
                    <modification date="2020-11-15 12:48:15" user="USER/DEPARTMENT"/>
                    <saved-name>PCK.BEST4AUTOMIC_VCS.JOBP.PULL.OLD.20201222.094550</saved-name>
                    <title>Pulls a version of a package from a GIT repository</title>
                </version>
                <version version="3">
                    <modification date="2020-11-09 12:52:09" user="USER/DEPARTMENT"/>
                    <saved-name>PCK.BEST4AUTOMIC_VCS.JOBP.PULL.OLD.20201115.124815</saved-name>
                    <title>Pulls a version of a package from a GIT repository</title>
                </version>
                <version version="2">
                    <modification date="2020-11-09 12:50:51" user="USER/DEPARTMENT"/>
                    <saved-name>PCK.BEST4AUTOMIC_VCS.JOBP.PULL.OLD.20201109.125209</saved-name>
                    <title>Pulls a version of a package from a GIT repository</title>
                </version>
                <version version="1">
                    <modification date="2019-10-18 10:38:55" user="WRITER/WRITER"/>
                    <saved-name>PCK.BEST4AUTOMIC_VCS.JOBP.PULL.OLD.20201109.125051</saved-name>
                    <title>Pulls a version of a package from a GIT repository</title>
                </version>
            </archive>
        </version-management>
    </info>
</best4Automic>

Innerhalb der verwendeten XML Variablen wird für jedes dem Filter entsprechende Objekt ein eigener key erzeugt. Die gezeigte XML Struktur wird innerhalb des entsprechenden key für jedes Package mit Modifikationen erstellt.

Beispiel um die Anzahl der Versionen im Versionsmanagement zu ermitteln.

/best4Automic/info/version-management/@numberOfVersions