Zum Hauptinhalt springen
Version: 7.0

Objekt: Versionen lesen

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

Bezeichnung​

Name
info.VersionManagement
Aliase
info.Versions

Konfiguration​

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: <TabItem 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-Objekts, das 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: <TabItem b4A Verbindungen>

Beschreibung​

Die strukturierte Dokumentation ist so gegliedert, dass zu mehreren Objekten Versionsinformationen gespeichert 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.

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

Ausgabeformat XML-Variable​

Der Bericht über das Versionsmanagament eines Objektes 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