Ant-Task für Konvertierung von API-Verwendungsmigrationsberichten

Zweck

Diese Task konvertiert den durch die Ant-Task apitooling.apimigration erstellten XML-Bericht in HTML-Dateien.

Verwendung

Beschreibung

Der Name der Ant-Task ist apitooling.apimigration_reportconversion. Für ihre Verwendung muss sich die JAR-Datei apitooling-ant.jar im Ant-Klassenpfad befinden.

<apitooling.apimigration_reportconversion
	xmlfiles="..."
	htmlfiles="..."
	xsltfile="..."
	filterpatterns="..."
	tofilterpatterns="..."
	debug="..."
 />

Parameter

Attribut Beschreibung Erforderlich
xmlfiles Dieses Attribut gibt die Position der XML-Dateien an, die konvertiert werden sollen.

Die Position wird mit einem absoluten Pfad angegeben.
Ja
htmlfiles Dieses Attribut gibt die Position der HTML-Dateien an, die generiert werden sollen.

Die Position wird mit einem absoluten Pfad angegeben.
Ja
xsltfile Dieses Attribut gibt die Position einer XSLT-Datei an, die zum Generieren der Seiten mit den Verweisdetails in der gewünschten Reihenfolge verwendet werden soll.

Eine Standard-XSLT-Datei ist in der JAR-Datei apitooling-ant.jar verfügbar.

Die Position wird mit einem absoluten Pfad angegeben.
Nein
filterpatterns Dieses Attribut gibt eine durch Kommas getrennte Liste von Mustern regulärer Ausdrücke an, die verwendet werden, um Verweise aus übereinstimmenden Namensmustern aus dem Endbericht zu bereinigen.

Bei diesen Mustern muss es sich jeweils um einen ordnungsgemäß formatierten regulären Ausdruck handeln, der der Definition entspricht, die Sie hier finden.
Nein
tofilterpatterns Dieses Attribut gibt eine durch Kommas getrennte Liste von Mustern regulärer Ausdrücke an, die verwendet werden, um Verweise auf übereinstimmende Namensmuster aus dem Endbericht zu bereinigen.

Bei diesem Muster muss es sich um einen ordnungsgemäß formatierten regulären Ausdruck handeln, der der Definition entspricht, die Sie hier finden.
Nein
debug Gibt den Wert für die Debugfunktion an.

Folgende Werte sind möglich: true, false
Der Standardwert ist false.
Nein

Beispiele

 <apitooling.apimigration_reportconversion
  xmlfiles="/eclipse/apimigration-both/XML"
  htmlfiles="/eclipse/apimigration-both/HTML"
  xsltfile="/eclipse/references.xsl"
  debug="true"

 />

Hierdurch wird die Task ausgeführt, durch die *.html-Dateien im Ordner /eclipse/apimigration-both/HTML entsprechend der Ordnerstruktur der XML-Dateiposition erstellt werden.

Wenn die Debugfunktion aktiviert ist, wird in der Ant-Konsole die Tracefunktion für die Fehlerbehebung angezeigt.

Zugehörige Referenzinformationen

Ant-Task für Analyse
Ant-Task für Dateigenerierung
Ant-Task für API-Verwendung
Ant-Task für API-Verwendungsberichtskonvertierung
Ant-Task für API-Verwendungsmigration
Ant-Task für API-Freeze
Ant-Task für eingestellte API-Unterstützung
Ant-Task für Konvertierung von Berichten zu eingestellter API-Unterstützung
Ant-Task für Analyseberichtskonvertierung