Mon premier flux de données (Service)

Dans cette rubrique, vous allez créer un simple flux de données qui accepte les données d'un appel à une API ou un service Web, les traite, puis renvoie une réponse via l'API ou le service Web. Sachant que ce flux de données doit être exposé sous forme de service sur le serveur Spectrum™ Technology Platform, il s'agit d'un flux de données de type « service ». (L'autre principal type de flux de données, dit « job », exécute un traitement par lots en lisant les données d'un fichier ou d'une base de données, en les traitant, puis en en écrivant la sortie dans un fichier ou une base de données.)

  1. Sélectionnez Démarrer > Tous les programmes > Pitney Bowes > Spectrum™ Technology Platform > Outils clients > Enterprise Designer.
  2. Sélectionnez Fichier > Nouveau > Flux de données > Service.
  3. Vous pouvez maintenant commencer à créer votre flux de données. La première étape consiste à définir l'entrée du flux de données. Votre flux de données accepte deux champs en entrée : FirstName et LastName.
    1. Faites glisser un stage Input de la palette jusqu'au canevas.



    2. Double-cliquez sur le stage Input du canevas.
    3. Cliquez sur Ajouter, puis de nouveau sur Ajouter.
    4. Dans le champ Field Name, saisissez FirstName.
    5. Cliquez sur OK, puis de nouveau sur OK.
    6. Cliquez sur Ajouter, puis de nouveau sur Ajouter.
    7. Dans le champ Field Name, saisissez LastName.
    8. Cliquez sur OK, puis de nouveau sur OK.
    9. La définition de l'entrée du flux de données est terminée. Cliquez sur OK.
  4. Ensuite, ajoutez un stage modifiant la casse des données des champs FirstName et LastName en majuscules.
    1. Glissez un stage Transformer de la palette jusqu'au canevas.
    2. Cliquez sur le triangle noir plein à droite du stage Input (port de sortie) et glissez-le à gauche du stage Transformer du canevas pour créer un canal connectant Input et Transformer.

      Votre flux de données prend la forme suivante :

    3. Double-cliquez sur le stage Transformer.
    4. Cliquez sur Ajouter.
    5. Dans l'arborescence à gauche, sous Formatage, cliquez sur Casse.
    6. Dans le champ Field, sélectionnez FirstName. Laissez Majuscule sélectionné.
    7. Cliquez sur Ajouter.
    8. Dans le champ Field, sélectionnez LastName. Laissez Majuscule sélectionné.
    9. Cliquez sur Ajouter.
    10. Cliquez sur Fermer.
    11. La configuration de Transformer, qui transforme la valeur des champs FirstName et LastName en majuscules, est terminée. Cliquez sur OK.
  5. Pour finir, définissez la sortie du flux de données. Votre flux de données renverra les champs FirstName et LastName en sortie.
    1. Glissez un stage Output sur le canevas.
    2. Cliquez sur le triangle noir plein à droite du stage Transformer et glissez-le à gauche du stage Output du canevas.

      Votre flux de données prend la forme suivante :

    3. Double-cliquez sur l'icône Output du canevas.
    4. Cochez la case Exposer. Les cases à cocher en regard de FirstName et LastName doivent être cochées.
    5. Cliquez sur OK.
  6. Dans Enterprise Designer, sélectionnez Fichier > Enregistrer.
  7. Nommez votre flux de données MyFirstDataflow-Service, puis cliquez sur OK.
  8. Sélectionnez Fichier > Exposer/Ne plus exposer et Enregistrer. Cette opération expose votre flux de données, le rendant disponible sous forme de service sur le serveur.
  9. Pour tester votre flux de données, procédez comme suit :
    1. Ouvrez Management Console en accédant à cette URL dans un navigateur web :

      http://server:port/managementconsole

      Où : server est l'adresse IP ou le nom de serveur de votre serveur Spectrum™ Technology Platform et port le port HTTP utilisé par Spectrum™ Technology Platform. Par défaut, le port HTTP est 8080.

    2. Accédez à Services > Other Services.
    3. Dans la liste des services, cochez la case en regard de MyFirstDataflow-Service, puis cliquez sur le bouton Modifier .
    4. Saisissez un nom tout en minuscules dans le champ FirstName.
    5. Saisissez un nom tout en minuscules dans le champ LastName.
    6. Cliquez sur Exécuter l'aperçu.

      Vous constatez que le service a transformé les noms de champs tout en majuscules, comme indiqué dans le stage Transformer de votre flux de données.

Félicitations ! Vous avez conçu et exécuté votre premier flux de données de type service. Le service est maintenant disponible sur le serveur et accessible via un appel vers une API ou des services Web. L'URL de la ressource de la destination SOAP de ce service est la suivante :

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

L'URL de la ressource de la destination REST de ce service est la suivante :

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