Pfade in Ausführungsumgebungen
Wenn Sie Code anhand von Mappings generieren, Mappings zu MapForce Server-Ausführungsdateien (.mfx) kompilieren oder auf FlowForce Server bereitstellen, werden die generierten Dateien von der gewählten Zielumgebung, z.B. RaptorXML Server, MapForce Server oder einer C#-Applikation ausgeführt. Damit das Mapping erfolgreich ausgeführt werden kann, müssen alle relativen Pfade auch in der Umgebung, in der das Mapping ausgeführt wird, funktionieren. Im Folgenden sehen Sie die Basispfade für die einzelnen Zielsprachen.
Zielsprache | Basispfad |
|---|---|
XSLT, XSLT2, XSLT3 | Pfad der XSLT-Datei |
XQuery* | Pfad der XQuery-Datei |
C++, C#, Java* | Arbeitsverzeichnis der generierten Applikation |
Built-In* (bei Anzeige einer Mapping-Vorschau in MapForce) | Pfad der Mapping-Datei (.mfd). |
Build-In* (bei Ausführung des Mappings mit MapForce Server) | Das aktuelle Arbeitsverzeichnis |
Built-In* (bei Ausführung des Mappings mit MapForce Server durch FlowForce Server) | Das Arbeitsverzeichnis für den Auftrag oder das Arbeitsverzeichnis von FlowForce Server. |
* In der MapForce Professional und Enterprise Edition verfügbare Sprachen
Konvertierung relativer Pfade in absolute
Wenn Sie Programmcode generieren oder MapForce Server-Ausführungsdateien (.mfx) kompilieren oder wenn Sie das Mapping auf FlowForce Server bereitstellen, wird ein relativer Pfad in einen absoluten Pfad konvertiert, wenn in den Mapping-Einstellungen das Kontrollkästchen Pfade im generierten Code absolut machen aktiviert ist.
Wenn Sie Code generieren und das Kontrollkästchen aktiviert ist, löst MapForce alle relativen Pfade anhand des Verzeichnisses der .mfd-Datei auf und macht sie im generierten Code zu absoluten Pfaden. Diese Einstellung wirkt sich auf die Pfade der folgenden Dateien aus:
•Input- und Output-Instanzdateien für alle dateibasierten Komponenten
•Access- und SQLite-Datenbankdateien, die als Mapping-Komponenten verwendet werden (Professional und Enterprise Edition).
Bibliothekspfade im generierten Code
Mapping-Dateien können optional Pfadreferenzen zu verschiedenen Bibliotheken enthalten. So können etwa benutzerdefinierte Funktionen aus anderen Mapping-Dateien oder Funktionen aus benutzerdefinierten XSLT-, XQuery-*, C#-* oder Java-Bibliotheken* aus .mff*-Dateien (MapForce Funktionsdateien) importiert werden. Nähere Informationen dazu finden Sie unter Verwalten von Funktionsbibliotheken..
* In der MapForce Professional und Enterprise Edition verfügbare Funktionalitäten
Die Option Pfade im generierten Code absolut machen gilt nur für Mapping-Komponenten und wirkt sich nicht auf die Pfade zu externen Bibliotheken aus. Pfade zu allen anderen Bibliotheken als XSLT und XQuery werden im generierten Code in absolute Pfade konvertiert. Wenn Ihre Mapping-Datei z.B. Bibliotheksreferenzen wie .NET-, .dll- oder Java-Klassendateien enthält und der generierte Code in einer anderen Umgebung ausgeführt werden soll, so müssen die referenzierten Bibliotheken in der Zielumgebung unter demselben Pfad vorhanden sein.
Wenn Sie beabsichtigen, eine XSLT- oder XQuery-Datei anhand eines Mappings zu generieren, können Sie den Bibliothekspfad folgendermaßen relativ zur generierten XSLT- oder XQuery-Datei machen:
1.Öffnen Sie die Mapping-Einstellungen.
2.Aktivieren Sie das Kontrollkästchen Bibliotheken relativ zu den generierten XSLT / XQuery-Dateien referenzieren. Stellen Sie sicher, dass die XSLT- oder XQuery-Bibliotheksdatei unter diesem Pfad auch tatsächlich vorhanden ist.