Die hier beschriebenen Möglichkeiten zur Erstellung einer Transformationsdatei (XSLT), welche eine XML-Quelldatei in ein Ergebnisdokument (XML,HTML,PDF) transformiert, sind allgemein gültig für alle cardo-Module, welche Transformationen unterstützen:
Auf modulspezifische Funktionen wird nachfolgend explizit hingewiesen.
Ab dieser Version werden die Angaben in der XSLT zur Erstellung von Kartenbildern gegenüber dem http://webs.idu.de/xsdschemas/Iwan/iXRH.xsd - Schema validiert! Invalide Angaben führen zum Abbruch.
Ein typisches Problem, das damit zutage tritt, ist das Fehlen der BBox im RenderMap - Knoten. Fügen Sie in diesem Fall eine beliebige Dummy-BBox ein (bspw. <iXRH:BBox epsgCode="25833" xmin="409330" ymin="5648957" xmax="483007" ymax="5714401"/>), auch wenn die BBox anschließend mithilfe der Erweiterungsfunktionen noch überschrieben wird.
Im Erweiterungsobjekt iduCore, das in den XSLTs üblicherweise als 'cardoExtension' eingebettet ist, gibt es neue Funktionen zur Ermittlung von Geometrieparametern: GetGeomLength, GetGeomPerimeter und GetGeomArea
Das Erstellen einer XSLT-Datei erfordert Kenntnisse in XSLT, welches ein allgemeiner Standard ist. Entsprechend sind im Internet jede Menge Einführungen, Tutorials und Hilfeseiten zu finden. Nachfolgend werden hauptsächlich cardo-spezifische Erweiterungen und Besonderheiten beschrieben.
Eine Transformationsdatei transformiert ein XML-Ausgangsdokument in ein Ergebnisdokument. Wie das Ausgangsdokument aussieht, ist modulspezifisch:
Eine Transformationsdatei sollte in einem passenden Editor erstellt werden, der entsprechende Validierung und Vorschlagslisten unterstützt.
Die Transformationsdatei muss an einer modulspezifischen Stelle abgelegt werden, damit cardo die Datei nutzen kann:
Und auch die Ausführung der Transformation geschieht modulspezifisch und an verschiedenen Stellen:
In Transformationsdateien können cardo-spezifische Erweiterungsfunktionen eingebunden und verwendet werden.