tstDiff: Schriftgut

Die TstDiff-Aufgabe SGUT vergleicht aufgezeichnetes Schriftgut mittels des Dokumentenvergleiches aus MS-Word. Das Ergebnis kann angezeigt, gespeichert und ausgedruckt werden. In der Protokolldatei steht, wieviele Unterschiede der Vergleich ergab. Hiermit kann man:

1. Zwei Schriftstücke miteinander vergleichen, aus unterschiedlichen oder gleichen Aufzeichnungen bzw. Bausteinaufrufen.
2. Alle Schriftstücke aus zwei Bausteinaufrufen miteinander vergleichen.
3. Alle Schriftstücke aus zwei Aufzeichnungen miteinander vergleichen.

tstDiff [tstdiff-Optionen] SGUT 
Aufz=<Name1> [Aufz=<Name2>] 
Bsar=<BstnName1>.<Event1>.<Occ1> [Bsar=<BstnName2>.<Event2>.<Occ2>]
[Sgut=<SgutName>.<SgutOcc>] 
[" Opts=<Optionen>"]

Argumente
Aufz: Mit Aufz=<Name> geben Sie den Namen der Aufzeichnung an, die für den Vergleich herangezogen werden soll. Wenn das Schriftgut in der gleichen Aufzeichnung enthalten ist, brauchen Sie das Argument nur einmal zu übergeben. Sie können dieses Argument ein oder zweimal übergeben. Wenn es nur einmal angegeben wird, müssen Sie jedoch mittels Bsar oder Sgut näher spezifizieren.
Bsar: Mit Bsar=<Name>.<Evnt>.<Occ> benennen Sie einen Bausteinaufruf, der für den Vergleich herangezogen wird.

• <BstnName> ist der Namen des Bausteins,
• <Event> der Namen des Ereignisses, das in dem Baustein ausgelöst wurde, und
• <Occ> gibt an, der wievielte Aufruf (Occurence) dieses Bausteins (ggf. mit dem angegebenen Event) verglichen werden soll. Sie können dieses Argument ein oder zweimal übergeben. Wenn nur ein Bausteinaufruf angegeben wird, müssen Sie zwei Aufzeichnungen spezifizieren.

Wenn beide Aufrufe aus einer Aufzeichnung stammen, können Sie so z.B. den 1. und 3. Aufruf des Bausteins mit einem bestimmten Ereignis vergleichen. Wenn Sie <Occ> nicht angeben, wird der erste Aufruf angenommen. Wenn Sie Name, Evnt und oder Occ weglassen, wird TstDiff versuchen einen Baustein zu finden, der den restlichen Angaben entspricht.

Sgut: Mit Sgut=<Name>.<Occ> können Sie angeben, welches Schriftgut genommen werden soll. Die Angaben Name und Occ sind optional. Lassen Sie die Angabe Sgut weg, werden alle Schriftgüter verglichen.
opts: Die Optionen für die Aufgabe SGUT müssen in dem Format „Opts=<Optionen>“ (in Hochkommata!) angegeben werden, um sie von den allgemeinen tstdiff-Optionen unterscheiden zu können. Hier können Sie aufgabenbezogene Optionen angeben, sowie bestimmte allgemeine Optionen übersteuern.

Die Optionen haben folgende Bedeutung:
/Show: bewirkt, dass die Unterschiede in MS-Word angezeigt werden.
/print: bewirkt, dass die Unterschiede von MS-Word ausgedruckt werden.
/save:<Dateiname> bewirkt, dass die Unterschiede in der angegebenen Datei gespeichert werden.
-o<Protokoll-Datei> gibt an, ob das Ergebnis dieses Vergleichs in der allgemeinen Outputdatei, oder in eine für dieses Kommando eigene Outputdatei geschrieben werden soll.
-v<XSL> bewirkt, dass das erstellte Dokument direkt angezeigt wird.

Im Protokoll wird zunächst angegeben, aus welcher Aufzeichnung (<Aufz>) und ggf. welchem Bausteinaufruf (<Bsar>) das zu vergleichende Schriftgut (<Sgut>) stammt. Pro Schriftgutvergleich gibt es ein <DiffSgut> Element. Danach folgt das eigentliche Differenzprotokoll, eingeleitet durch <DiffSgut>. Der <Count> bei <DiffSgut> gibt an, wieviele Unterschiede MS-Word gefunden hat. Der <Count> bei <DiffSgutReport> ist die Summe der einzelnen <Count>'s bei den <DiffSgut>'s

 <?xml version="1.0" standalone="yes" ?> 
+ <DiffSgutReport version="1.0">

Der <Count> bei <DiffSgut> gibt an, wieviele Unterschiede MS-Word gefunden hat. Der <Count> bei <DiffSgutReport> ist die Summe der einzelnen <Count>'s bei den <DiffSgut>'s

Kommandozeile:

TstDiff.exe -lo c:\t\tstdiff.log -o c:\t\tstdiff.xml aufz=AVL2001011003 aufz=AVL2001011006 "opts=/save:c:\t\sgutdiff.doc /show /print"
oder
TstDiff.exe -lo c:\t\tstdiff.log -o c:\t\tstdiff.xml -ex d:\work\tstdiff.txt

Scriptdatei zu 2. Kommandozeile:

sgut aufz=AVL2001011003 aufz=AVL2001011006 "opts=/save:c:\t\sgutdiff.doc /show /print"

Auszug aus der Logdatei:

<?xml version="1.0" standalone="yes" ?> 
+ <DiffSgutReport version="1.0">