Mit der TstDiff-Aufgabe COMPARE können die Aufgaben BSAR, BSARIO und SGUT auf mehrere Bausteinaufrufe angewendet werden. In der Protokolldatei stehen die Resultate der einzelnen Vergleiche.
tstDiff [tstdiff-Optionen] COMPARE <Vergleichsart> [<Anwendung> [<Typ> [<Modul> [<Operation>]]]] [<Argumente>]
<Vergleichsart>: BSAR, BSARIO oder SGUT
<Anwendung>: Anwendungssystem
<Typ>: Bausteintyp
<Modul> : Name des Moduls
<Operation>; Ausgelöste Operation
Aufz: Mit Aufz=<Name> geben Sie den Namen der Aufzeichnung an, aus der die Bausteinaufrufe verglichen werden sollen.
Occ: Mit Occ=<Vorkommen>;{<Vorkommen>;} schränken Sie die zu vergleichenden Vorkommen ein.
Opts: Unter Opts=<Optionen> können Sie aufgabenbezogene Optionen angeben, sowie bestimmte allgemeine Optionen übersteuern.
Die Aufgabe kennt folgende Optionen:
Die Optionen haben folgende Bedeutung:
| -save <Dateiname> | Über die Option -save bewirken Sie, dass neben der Compare-Protokolldatei, die einzelnen Vergleichsprotokolle auch gespeichert werden. NB: Diese Option hat bei SGUT zur Folge, dass zusätzlich auch noch die Worddateien gespeichert werden. |
| -cc[0|1] | Über die Option -cc (CompareCalls) steuern Sie, welche Bausteinaufrufe verglichen werden. -cc0 : Vergleicht die spezifizierten Bausteine (Default). -cc1 : Vergleicht die gerufenen Bausteine der spezifizierten Bausteine. |
| -c[0|1|2] | Über die Option -c steuern Sie, was genau ausgegeben wird. -c0 : Nur die Unterschiede werden ausgegeben. -c1 : Der ObjektItem, in dem ein Unterschied festgestellt wurde, wird mit ausgegeben. -c2 : Alles wird ausgegeben, auch wenn es keine Unterschiede gibt. NB: Diese Option hat nur bei BSAR und BSARIO Auswirkung. |
| -dm[<Schwellenwert>] | Mit der Option -dm kann der Parametervergleich angewiesen werden, die Items der Datenobjekte auf Basis von Gemeinsamkeiten anstatt Reihenfolge zu vergleichen. Es werden die Items verglichen, welche die gleiche Anzahl (Anzahl = Schwellenwert) an Unterschieden aufweisen. Die (optionale) Angabe des Schwellenwertes bestimmt die Genauigkeit (und damit auch die notwendige Laufzeit) des Vergleichs. Je höher der Schwellenwert, desto ungenauer der Vergleich. Wird kein Schwellenwert angegeben, wird mit maximaler Genauigkeit verglichen. NB: Diese Option hat nur bei BSAR und BSARIO Auswirkung. |
| -dr[0|1] | Über die Option -dr steuern Sie, ob die Unterschiede auch bewertet werden. -dr0 : Die Unterschiede werden nicht bewertet. -dr1 : Die Unterschiede werden bewertet. NB: Diese Option hat nur bei BSAR und BSARIO Auswirkung. |
| -dv <Datei> | Mit der Option -dv können Sie die Regeln angeben, die beim Vergleich zu berücksichtigen sind. |
| -o <Protokoll-Datei> | Mit der Option -o (für „Output“) können Sie bestimmen, ob das Compare-Protokoll in die allgemeine Outputdatei oder in eine für ein bestimmtes Kommando eigene Outputdatei geschrieben werden soll. |
| -v <XSL> | Mit der Option -v (für „Vorschau“) können Sie veranlassen, dass das erstellte Compare-Protokoll unter Verwendung des angegebenen XSL-Stylesheets direkt angezeigt wird. |
Im Protokoll wird angegeben was gestartet wurde und wie die Ausführung verlaufen ist. Das Protokoll beinhaltet folgende Informationen:
<CompareReport Kind="BSAR" Options=""> <Specification> <Compare>... Compare ...</Compare> <Context>... Context ...</Context> </Specification> <Result> <Comparison DiffName="NotCompared">... Comparison ...</Comparison> <Comparison DiffName="NotRated">... Comparison ...</Comparison> <Comparison DiffName="CompareNotOK">... Comparison ...</Comparison> <Comparison DiffName="CompareOK">... Comparison ...</Comparison> </Result> <CompareCount>4</CompareCount> </CompareReport>
Das Element <Result> hat einen der folgenden DiffNamen:
DiffName: Beschreibung
NotCompared: Es wurden keine Bausteinaufrufe gefunden die verglichen werden konnten.
Compared: Es wurden Bausteinaufrufe gefunden die verglichen werden konnten.
Unter <Compare> stehen die Selektionskriterien für die Bausteinaufrufe. Abhängig von den Angaben für die Compare-Aufgabe, sind eine oder mehrere Informationen nicht vorhanden.
<Compare> <Appl>test</Appl> <Type>efun</Type> <Name>af-avl-test-c</Name> <Evnt>initiieren</Evnt> </Compare>
Unter <Context> stehen Angaben, in welchem Kontext die Vergleiche durchgeführt wurden. Abhängig von der Vergleichsart, sind eine oder zwei Aufzeichnungen vorhanden.
<Context> <Aufzeichnung Position="Left"> <Guid>{18D8DC77-A686-4081-84A4-7AA3D71B4842}</Guid> <Appl>TEST</Appl> <Name>AVL20020130001</Name> </Aufzeichnung> <Aufzeichnung Position="Right"> <Guid>{912C36A6-85D6-4892-BE5B-71079283E431}</Guid> <Appl>TEST</Appl> <Name>avl20020305001</Name> </Aufzeichnung> </Context>
Bei <Comparison> stehen Informationen, wie der Vergleich war. Der „DiffName“ gibt eine erste Aussage über den Vergleich und ermöglicht zudem ein Rating des Protokolls.
| DiffName | Beschreibung |
|---|---|
| NotCompared | Der Vergleich hat nicht stattgefunden. |
| NotRated | Der Vergleich wurde nicht bewertet. |
| CompareNotOK | Der Vergleich wurde mit NotOK bewertet. |
| CompareOK | Der Vergleich wurde mit OK bewertet. |
Das Vorhandensein der folgenden Angaben hängt vom vergebenen DiffNamen ab und wie der Vergleich verlaufen ist. Abhängig von der Vergleichsart kommt BausteinAufruf ein- oder zweimal vor.
| <Aufz> | Aufzeichnung zu der der Bausteinaufruf gehört |
| <Guid> | Guid des Bausteinaufrufs |
| <Appl> | Anwendung des Moduls |
| <Type> | Typ des Moduls |
| <Name> | Name des Moduls |
| <Evnt> | Operation des Moduls |
| <Occ> | Vorkommen des Moduls in der Aufzeichnung |
| <DiffCount> | Anzahl Differenzen. Ist der Protokollstatus „OK“, dann ist dieser Wert 0 |
| <ProtocolStatus> | Protokollstatus des Vergleichs. |
| <ProtocolFile> | Name der Datei in die das Vergleichsprotokoll gespeichert wurde. |
<Comparison DiffName="CompareNotOK"> <BausteinAufruf Position="Left"> <Aufz>AVL20020130001</Aufz> <Guid>{DA0BA907-A559-4CB5-86BA-CB1CD8B63CDE}</Guid> <Appl>TEST</Appl> <Type>EFUN</Type> <Name>AF-AVL-TEST-C</Name> <Evnt>INITIIEREN</Evnt> <Occ>1</Occ> </BausteinAufruf> <BausteinAufruf Position="Right"> <Aufz>avl20020305001</Aufz> <Guid>{5E23031B-4492-454C-925A-D9E647CDD2C8}</Guid> <Appl>TEST</Appl> <Type>EFUN</Type> <Name>AF-AVL-TEST-C</Name> <Evnt>INITIIEREN</Evnt> <Occ>1</Occ> </BausteinAufruf> <DiffCount>33</DiffCount> <ProtocolStatus>NotOK</ProtocolStatus> <ProtocolFile>e:\tstdiff\bsar-1.xml</ProtocolFile> </Comparison>
Kommandozeile
tstDiff.exe -ex e:\tstdiff\tstdiff.txt -lo e:\tstdiff\tstdiff.log -o e:\tstdiff\tstdiff.xml
Scriptdatei
compare bsar test efun af-avl-test-c initiieren aufz=AVL20020130001 aufz=avl20020305001 "opts=/save e:\tstdiff\bsar.xml"
Auszug aus der Logdatei
<DiffReports> <CompareReport Kind="BSAR" Options="" ProtocolStatus="OK"> <Specification> <Compare> <Appl>test</Appl> <Type>efun</Type> <Name>af-avl-test-c</Name> <Evnt>initiieren</Evnt> </Compare> <Context> <Aufzeichnung Position="Left"> <Guid>{18D8DC77-A686-4081-84A4-7AA3D71B4842}</Guid> <Appl>TEST</Appl> <Name>AVL20020130001</Name> </Aufzeichnung> <Aufzeichnung Position="Right"> <Guid>{912C36A6-85D6-4892-BE5B-71079283E431}</Guid> <Appl>TEST</Appl> <Name>avl20020305001</Name> </Aufzeichnung> </Context> </Specification> <Result DiffName="Compared"> <Comparison DiffName="CompareNotOK"> <BausteinAufruf Position="Left"> <Aufz>AVL20020130001</Aufz> <Guid>{DA0BA907-A559-4CB5-86BA-CB1CD8B63CDE}</Guid> <Appl>TEST</Appl> <Type>EFUN</Type> <Name>AF-AVL-TEST-C</Name> <Evnt>INITIIEREN</Evnt> <Occ>1</Occ> </BausteinAufruf> <BausteinAufruf Position="Right"> <Aufz>avl20020305001</Aufz> <Guid>{5E23031B-4492-454C-925A-D9E647CDD2C8}</Guid> <Appl>TEST</Appl> <Type>EFUN</Type> <Name>AF-AVL-TEST-C</Name> <Evnt>INITIIEREN</Evnt> <Occ>1</Occ> </BausteinAufruf> <DiffCount>33</DiffCount> <ProtocolStatus>NotOK</ProtocolStatus> <ProtocolFile>e:\tstdiff\bsar-1.xml</ProtocolFile> </Comparison> </Result> <CompareCount>1</CompareCount> </CompareReport> </DiffReports>