XSL-Transformations-Plugin (veraltet) für private Jitterbit-Agentengruppen

Einführung

Das XSL-Transform Plugin wendet ein XSL-Transform-Stylesheet (XSLT) auf eine Eingabedatei an, während diese von der Quelle zum Ziel übertragen 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.

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.

Auf Anweisung des Supports kann dieses Plugin unter dem unten angegebenen Link heruntergeladen und der Organisation hinzugefügt werden.

• XSLT 2.0 (.ZIP)

Verknüpfen Sie das Plugin mit einer Agentengruppe

Das XSL-Transformations 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:

• Plugins (Integration Studio)
• Plugins (Design Studio)

Das XSL-Transform Plugin verwendet diese Variablen:

Beispiel

Ein typisches Beispiel ist der Abruf von Daten von einem Webdienst und die Weiterleitung 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 anschließend den Ziel-Webdienst aufrufen. Die Schritte verwenden Design Studio als Beispiel; Sie können dieses Plugin in Integration Studio verwenden mit ähnlichen Schritten.

1. Greifen Sie über die Management Console Plugins auf die Manifestdatei des XSL Transform-Plugins zu Seite.

2. Lesen Sie das Manifest, um den Speicherort zu finden, an dem das Plugin Java erwartet. Stellen Sie sicher, dass Java dort installiert ist. Wenn sich Java auf dem privaten Agenten an einem anderen Speicherort befindet, müssen Sie diese Schritte für jeden Agenten in der Gruppe ausführen:

   1. Stoppen Sie den privaten Agenten.
   2. Navigieren Sie zum Plugin-Ordner auf dem privaten Agenten.
   3. Bearbeiten Sie die Manifestdatei, um auf den richtigen Speicherort von Java zu verweisen.
   4. Starten Sie den privaten Agenten neu.

3. 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.

4. 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“.

   

5. 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ü:

   

   1. Das Plugin wurde in den vorherigen Schritten dem privaten Agenten zugewiesen, sodass Design Studio es im Bereich Verfügbare Plugin in der unteren Hälfte des Dialogfelds sehen und anzeigen kann. Falls das Plugin nicht sofort angezeigt wird, klicken Sie im Dialogfeld auf die Schaltfläche Aktualisieren.
   2. Sie müssen die Pipeline-Position auswählen. In diesem Beispiel wird das Plugin aufgerufen, wenn die Eingabe gesendet wird, was bei der Anforderung an den Webdienst geschieht. Die Option WebServiceCall - OnRequest ist ausgewählt.
   3. Klicken Sie auf die Schaltfläche Zuweisen.

6. Das XSL-Transformations Plugin wird nun 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:

   

7. Speichern und einsetzen den Operation. Der Operation ist abgeschlossen und kann getestet werden.