Mein erster Datenfluss (Dienst)

In diesem Abschnitt erstellen Sie einen einfachen Datenfluss, der Daten aus einem API- oder Webservice-Aufruf akzeptiert, die Daten verarbeitet und eine Antwort über die API oder den Webservice zurückgibt. Da dieser Datenfluss als Dienst auf dem Spectrum™ Technology Platform-Server bereitgestellt werden soll, handelt es sich um einen Datenfluss vom Typ „Dienst“. (Der andere primäre Datenflusstyp, ein „Auftrag“, führt eine Batch-Verarbeitung aus, liest Daten aus einer Datei oder Datenbank, verarbeitet die Daten und schreibt dann die Ausgabe in eine Datei oder Datenbank.)

  1. Wählen Sie Start > Programme > Pitney Bowes > Spectrum™ Technology Platform > Client-Tools > Enterprise Designer aus.
  2. Wählen Sie Datei > Neu > Datenfluss > Dienst aus.
  3. Sie können nun mit der Erstellung Ihres Datenflusses beginnen. Der erste Schritt besteht darin, die Eingabe des Datenflusses zu definieren. Ihr Datenfluss nutzt zwei Felder als Eingabe: Vorname und Nachname.
    1. Ziehen Sie einen Input-Schritt aus der Palette auf die Arbeitsfläche.


    2. Doppelklicken Sie auf den Input-Schritt auf der Arbeitsfläche.
    3. Klicken Sie auf Hinzufügen und anschließend erneut auf Hinzufügen.
    4. Geben Sie in das Feld Feldname den Eintrag Vorname ein.
    5. Klicken Sie auf OK und anschließend erneut auf OK.
    6. Klicken Sie auf Hinzufügen und anschließend erneut auf Hinzufügen.
    7. Geben Sie in das Feld Feldname den Eintrag Nachnahme ein.
    8. Klicken Sie auf OK und anschließend erneut auf OK.
    9. Sie haben die Definition der Datenflusseingabe abgeschlossen. Klicken Sie auf OK.
  4. Fügen Sie als nächstes einen Schritt hinzu, um die Schreibweise der Daten in den Feldern „Vorname“ und „Nachname“ auf Großbuchstaben zu ändern.
    1. Ziehen Sie einen Transformer-Schritt aus der Palette auf die Arbeitsfläche.
    2. Klicken Sie auf das schwarze Dreieck auf der rechten Seite des Input-Schrittes (der Ausgabeport) und ziehen Sie es auf die linke Seite des Transformer-Schrittes auf der Arbeitsfläche, um einen Kanal zu erstellen, der Input und Transformator verbindet.
      Ihr Datenfluss sollte wie folgt aussehen:

    3. Doppelklicken Sie auf den „Transformer“-Schritt.
    4. Klicken Sie auf Hinzufügen.
    5. Klicken Sie im Baum auf der linken Seite unter Formatierung auf Groß-/Kleinbuchstaben.
    6. Wählen Sie im Feld Feld den Eintrag Vorname aus. Lassen Sie Großbuchstaben ausgewählt.
    7. Klicken Sie auf Hinzufügen.
    8. Wählen Sie im Feld Feld den Eintrag Nachname aus. Lassen Sie Großbuchstaben ausgewählt.
    9. Klicken Sie auf Hinzufügen.
    10. Klicken Sie auf Schließen.
    11. Sie haben die Konfiguration von Transformer abgeschlossen, um den Wert in den Feldern „Vorname“ und „Nachname“ in Großbuchstaben zu ändern. Klicken Sie auf OK.
  5. Letztlich definieren Sie die Ausgabe für den Datenfluss. Ihr Datenfluss gibt die Felder „Vorname“ und „Nachname“ als Ausgabe zurück.
    1. Ziehen Sie einen Output-Schritt auf die Arbeitsfläche.
    2. Klicken Sie auf das schwarze Dreieck auf der rechten Seite des Transformer-Schrittes und ziehen Sie es auf die linke Seite des Output-Schrittes auf der Arbeitsfläche.
      Ihr Datenfluss sollte wie folgt aussehen:

    3. Doppelklicken Sie auf den Output-Schritt auf der Arbeitsfläche.
    4. Aktivieren Sie das Kästchen Verfügbar machen. Die Kästchen neben „Vorname“ und „Nachname“ sollten nun aktiviert sein.
    5. Klicken Sie auf OK.
  6. Wählen Sie im Enterprise Designer die Optionen Datei > Speichern aus.
  7. Geben Sie Ihrem Datenfluss den Namen MyFirstDataflow-Service, und klicken Sie auf OK.
  8. Wählen Sie Datei > Verfügbar machen/Verfügbarkeit aufheben und Speichern aus. Dadurch wird Ihr Datenfluss verfügbar gemacht und als Dienst auf dem Server bereitgestellt.
  9. So testen Sie Ihren Dienst:
    1. Öffnen Sie die Management Console, indem Sie die folgende URL in einem Webbrowser laden:

      http://server:port/managementconsole

      Dabei steht Server für den Servernamen oder die IP-Adresse Ihres Spectrum™ Technology Platform-Servers, und Port ist der HTTP-Port, der von Spectrum™ Technology Platform verwendet wird. Der HTTP-Port ist standardmäßig auf 8080 eingestellt.

    2. Öffnen Sie Dienste > Weitere Dienste.
    3. Aktivieren Sie in der Liste der Dienste das Kästchen neben MyFirstDataflow-Service, und klicken Sie dann auf die Schaltfläche „Bearbeiten“ .
    4. Geben Sie in das Feld „Vorname“ einen Namen in Kleinbuchstaben ein.
    5. Geben Sie in das Feld „Nachname“ einen Namen in Kleinbuchstaben ein.
    6. Klicken Sie auf Vorschau ausführen.
      Sie können sehen, dass der Dienst die Namensfelder als Großbuchstaben schreibt, wie Sie es im Transformer-Schritt Ihres Datenflusses angegeben haben.

Herzlichen Glückwunsch! Sie haben Ihren ersten Dienst-Datenfluss entworfen und ausgeführt. Der Dienst ist nun auf dem Server verfügbar und kann über einen API- oder Webservice-Aufruf zugänglich gemacht werden. Die Ressourcen-URL für den SOAP-Endpunkt dieses Dienstes lautet:

http://<ServerName>:<Port>/soap/MyFirstDataflow-Service

Die Ressourcen-URL für den REST-Endpunkt dieses Dienstes lautet:

http://<ServerName>:<Port>/rest/MyFirstDataflow-Service