BeforeChangeCheck & AfterChangeCheck

Skriptapplikationen, die von diesen Schnittstellen aufgerufen werden, dienen dazu, Daten vor oder nach einer Änderungsprüfung zu modifizieren.

Der Befehl, der die Änderungsprüfung nötig machte, wird erst ausgeführt, wenn die Skriptapplikation ScriptBeforeChangeCheck beendet wurde (abgeschlossen, abgebrochen oder Time-out).

AfterChangeCheck wird nur ausgelöst, wenn BeforeChangeCheck zuvor gestartet wurde. AfterChangeCheck wird aufgerufen, wenn die Skriptapplikation BeforeChangeCheck mit einem Fehler beendet wurde.

Ablauf

  1. Das System wird geprüft.
  2. Die Schnittstelle BeforeChangeCheck wird aufgerufen und die zugehörige Skriptapplikation gestartet.
  3. Dateien und Projekte werden übertragen und Operationen ausgeführt.
  4. Eine neue Version wird angelegt.
  5. Es wird überprüft, ob seit Beginn der Prüfung Änderungen am Arbeitsverzeichnis vorgenommen wurden.
  6. Ein Archiv wird angelegt.
  7. Die Prüfsumme des Archivs wird berechnet.
  8. Ein Update der Datenbank wird durchgeführt.
  9. Die Schnittstelle AfterChangeCheck wird ausgelöst und die zugehörige Skriptapplikation ausgeführt.

Beispiel: Vereinfachen der Ordnerstruktur eines Verzeichnisses, indem alle Dateien in denselben temporären Ordner kopiert werden und Wiederherstellung der Ordnerstruktur, nachdem diese für die Prüfung vereinfacht wurde. Dadurch können Projekte verglichen werden, die im Arbeitsverzeichnis und in ihrer archivierten Form unterschiedlich aufgebaut sind.

 

Befehlszeile für die Skriptapplikation ScriptBeforeChangeCheck

ScriptBeforeChangeCheck.exe /ConfigFileW:[absoluter Pfad der Schnittstellendatei] /rd:[Pfad des Clientarchivs] /at:c

 

Befehlszeile für die Skriptapplikation ScriptAfterChangeCheck

ScriptAfterChangeCheck.exe /ConfigFileW:[absoluter Pfad der Schnittstellendatei] /rd:[Pfad des Clientarchivs] /at:c

 

Beschreibung der Schnittstellendatei für BeforeChangeCheck

Die Sektionen [Common], [User], [Component], [Version], [QuickSave], [ExclusiveUse] und [UnderDevelopment] sind im Abschnitt Allgemeine Sektionen der Schnittstellendatei beschrieben.

Die Sektionen [ExclusiveUse] und [UnderDevelopment] werden bei der Hintergrundprüfung nicht angegeben.

[Specific]

INI-Schlüssel I/O Erklärung
WorkingDir I Vollständiger Pfad des Arbeitsverzeichnisses der Komponente
HversionNext I

Versionsnummer, die der nächsten Version zugeordnet wird
BaseVersionPresent I Zeigt, ob eine Basisversion für diese Komponente existiert.
Mögliche Werte sind Y und N. Der Standardwert ist Y.
BackgroundChangeCheck I

Zeigt, ob der Prozess Teil einer Hintergrundüberprüfung ist

Die Hintergrundprüfung prüft nur auf Unterschiede und nicht auf Konsistenz oder Versionierung.

Mögliche Werte sind Y und N. Der Standardwert ist N.

[Result]

Die allgemeinen Schlüssel dieser Sektion sind im Abschnitt Allgemeine Sektionen der Schnittstellendatei beschrieben.

INI-Schlüssel I/O Erklärung
ChangeReason O

Änderungsgrund

Der Wert wird vom Script vorgegeben.
ChangeReason_Forced O

Zeigt, ob der Benutzer den Wert für ChangeReason noch verändern kann

Mögliche Werte sind Y und N. Der Standardwert ist Y.

Der Schlüssel ist nur relevant, wenn ChangeReason nicht leer ist.

Comment O

Änderungskommentar

Der Wert wird vom Script vorgegeben.
Comment_Forced O

Zeigt, ob der Benutzer den Wert des Schlüssels Comment noch verändern kann

Mögliche Werte sind Y und N. Der Standardwert ist Y.

Der Schlüssel ist nur relevant, wenn Comment nicht leer ist.

HversionUserDefined O

Benutzerdefinierter Versionsbezeichner

Der Wert wird vom Script vorgegeben.
HversionUserDefined_
Forced		 O

Zeigt, ob der Benutzer den Wert des Schlüssels HversionUserDefined noch verändern kann.

Mögliche Werte sind Y und N

Der Standardwert ist N

Der Schlüssel ist nur relevant, wenn HversionUserDefined nicht leer ist.

 

Beschreibung der Schnittstellendatei für AfterChangeCheck

Die Sektionen [Common], [User], [Component], [Version], [QuickSave], [ExclusiveUse] und [UnderDevelopment] sind im Abschnitt Allgemeine Sektionen der Schnittstellendatei beschrieben.

Die Sektionen [ExclusiveUse] und [UnderDevelopment] werden bei der Hintergrundprüfung nicht angegeben.

[Version]

Die Schlüssel dieser Sektion sind im Abschnitt Allgemeine Sektionen der Schnittstellendatei beschrieben.

Wird der Schlüssel Hversion nicht angegeben oder ist dieser leer, wurde keine Version erstellt.

[Specific]

INI-Schlüssel I/O Erklärung
WorkingDir I Vollständiger Pfad des Arbeitsverzeichnisses der Komponente
BaseVersionPresent I

Zeigt, ob eine Basisversion für diese Komponente existiert
Mögliche Werte sind Y und N. Der Standardwert ist Y.
BackgroundChangeCheck I

Zeigt, ob der Prozess Teil einer Hintergrundüberprüfung ist

Die Hintergrundprüfung prüft nur auf Unterschiede und nicht auf Konsistenz oder Versionierung.

Mögliche Werte sind Y und N. Der Standardwert ist N.
Failed I

Zeigt, ob die Änderungsprüfung (und, falls nötig, der Versionierungsprozess) fehlgeschlagen ist
Mögliche Werte sind Y und N. Der Standardwert ist N.

 

Verwandte Themen
Allgemeine Sektionen der Schnittstellendatei