XSL Transform-Plugin (veraltet) für private Jitterbit-Agentengruppen
Einführung
Das XSL Transform-Plugin wendet ein XSL Transform (XSLT)-Stylesheet auf eine Eingabedatei an, während diese von der Quelle zum Ziel weitergeleitet wird. Das Plugin verwendet den Saxon XSLT-Prozessor, der XSLT 2.0 unterstützt.
Dieses Plugin kann nur mit privaten Agentengruppen verknüpft werden und ist in den Jitterbit-Cloud-Agent-Gruppen nicht verfügbar.
Wichtig
Von Jitterbit bereitgestellte Plugins sind veraltet.
Laden Sie das Plugin herunter und fügen Sie es hinzu
Das XSL Transform Plugin ist ein Standard-Jitterbit Plugin, das bereits in der Management Console Plugins verfügbar ist-Seite und muss nicht heruntergeladen oder zur Organisation hinzugefügt werden.
Unter Anweisung des Supports kann dieses Plugin unter dem unten angegebenen Link heruntergeladen und der Organisation hinzugefügt werden.
Verknüpfen Sie das Plugin mit einer Agentengruppe
Das XSL-Transform Plugin muss einer privaten Agentengruppe zugeordnet werden, um das Plugin für alle Agenten in der Gruppe verfügbar zu machen.
Das Plugin ist in der Management Console Plugins aufgeführt Seite mit dem Anzeigenamen Jitterbit XSL Transform.
Festlegen von Variablen und Verwenden des Plugin in einem Projekt
Informationen zur Verwendung von Plugins in einem Projekt finden Sie in diesen Themen:
Das XSL Transform-Plugin verwendet diese Variablen:
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
XSLT.stylesheet | Zeichenfolge | Optional | XSLT-Stylesheet im Klartext. |
XSLT.stylesheet_filename | Zeichenfolge | Optional | Name einer Datei, die das anzuwendende XSLT-Stylesheet enthält. Der Wert kann ein absoluter Pfad oder ein relativer Pfad zum Installationsverzeichnis des Plugin sein. |
Beispiel
Ein typisches Beispiel ist das Abrufen von Daten von einem Webdienst und das Weiterleiten der Daten an einen zweiten Webdienst. In diesem Beispiel haben die vom Quell-Webdienst abgerufenen Daten Namespaces (ns1
). Der Ziel-Webdienst benötigt die Namespaces jedoch nicht. Mithilfe des XSL Transform-Plugin werden die Namespaces vor dem Aufruf des Ziel-Webdienstes aus den Daten des Quell-Webdienstes entfernt.
Diese Schritte beschreiben, wie Sie mit dem XSL Transform Plugin die Namespaces aus den Quell-Webdienstdaten entfernen und dann den Ziel-Webdienst aufrufen. Die Schritte verwenden Design Studio als Beispiel; Sie können dieses Plugin in verwenden Integration Studio mit ähnlichen Schritten.
-
Greifen Sie über die Management Console Plugins auf die Manifestdatei des XSL Transform-Plugins zu. Seite.
-
Lesen Sie das Manifest, um den Speicherort zu finden, an dem das Plugin Java erwartet. Überprüfen Sie, ob Java an diesem Speicherort installiert ist. Wenn sich Java an einem anderen Speicherort auf dem privaten Agenten befindet, müssen Sie diese Schritte auf jedem Agenten in der Gruppe ausführen:
- Stoppen Sie den privaten Agenten.
- Navigieren Sie zum Plugin Ordner auf dem privaten Agenten.
- Bearbeiten Sie die Manifestdatei, um auf den richtigen Speicherort von Java zu verweisen.
- Starten Sie den privaten Agenten neu.
-
Erstellen Sie in Design Studio ein neues Script, um die Namespaces zu entfernen, wie in diesem Script gezeigt:
<trans> $XSLT.stylesheet = '<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0" xmlns:ns1="urn:microsoft-dynamics-nav/xmlports/x50001" exclude-result-prefixes="ns1"> <xsl:output method="xml" encoding="utf-8" indent="yes"/> <xsl:strip-space elements="*"/ <xsl:template match="ns1:*"> <xsl:element name="{local-name()}" namespace="urn:microsoft-dynamics-nav/xmlports/x50001"> <xsl:apply-templates select="node() | @*"/> </xsl:element> </xsl:template> <xsl:template match="node() | @*"> <xsl:copy> <xsl:apply-templates select="node() | @*"/> </xsl:copy> </xsl:template> </xsl:stylesheet> '; </trans>
Notiz
Der Variablenname im obigen Script ist wichtig. Sie müssen denselben Variablennamen verwenden, nach dem das Plugin sucht. Das Plugin sucht speziell nach
XSLT.stylesheet
und verwendet den ihm im Script zugewiesenen Wert. -
Erstellen Sie eine Operation und verwenden Sie das Script an beliebiger Stelle im Operation. In der unten gezeigten Operation heißt das Script XSLT-Code.
-
Wenden Sie das Plugin an der Stelle an, an der der Webdienst aufgerufen wird. Im obigen Operation heißt der Webdienst createInvoice. Um das Dialogfeld Pipeline-Plugins zu öffnen, klicken Sie mit der rechten Maustaste auf den Webdienst und wählen Sie Plugin aus dem Menü:
- Das Plugin wurde in den vorherigen Schritten dem privaten Agenten zugewiesen, sodass das Design Studio das Plugin im Abschnitt Verfügbare Plugins in der unteren Hälfte des Dialogfelds sehen und anzeigen kann. Wenn das Plugin nicht sofort angezeigt wird, klicken Sie im Dialogfeld auf die Schaltfläche Aktualisieren.
- Sie müssen die Pipeline-Position auswählen. In diesem Beispiel wird das Plugin aufgerufen, wenn die Eingabe gesendet wird, was beim Senden der Anfrage an den Webdienst geschieht. Die Option WebServiceCall - OnRequest ist ausgewählt.
- Klicken Sie auf die Schaltfläche Zuweisen.
-
Das XSL Transform-Plugin wird jetzt im Abschnitt Derzeit zugewiesen des Dialogfelds angezeigt. Klicken Sie auf die Schaltfläche Übernehmen, um das Plugin zuzuweisen, und klicken Sie auf OK, um das Dialogfeld zu schließen:
-
Speichern und einsetzen den Operation. Der Operation ist abgeschlossen und kann getestet werden.