Passer au contenu principal
Administrator Guide
Dernière mise à jour : 2023-06-23
Concept : éléments d'assemblage personnalisés

Concept : éléments d'assemblage personnalisés

Vous pouvez créer 5 types d'élément d'assemblage personnalisé dans Workday Studio :
Élément personnalisé
Procédure
Composant de médiation
Ajoutez un composant
custom-mediation
de la catégorie
Composants
de la
Palette
.
Étape de médiation
Ajoutez une étape
custom
de la catégorie
Autre
de la
Palette
.
Transport sortant
Ajoutez un transport
custom-out
de la catégorie
Out Transports
de la
Palette
.
Gestionnaire d'erreurs
Ajoutez un composant
custom-error-handler
de la catégorie
Error Handlers
de la
Palette
.
Stratégie de routage
Sélectionnez
Create custom-strategy
dans la barre d'outils contextuelle d'un composant
Route
.
Dans chaque cas, l'élément personnalisé se compose de 3 parties :
  • L'implémentation Java sous-jacente, qui définit les classes et les méthodes utilisées par l'élément.
  • La configuration du bean Spring, qui indique à Workday comment créer des instances des classes Java.
  • La configuration du composant d'assemblage, qui place votre élément personnalisé dans la vue graphique de l'assemblage.
    Les éléments d'assemblage personnalisés peuvent accéder normalement aux parties de message lors du traitement des données entrantes. Vous pouvez également spécifier la partie du message vers laquelle Workday doit diriger la sortie de l'élément personnalisé.
Pour partager un élément personnalisé, exportez le package Java au format JAR binaire. Les autres développeurs peuvent ensuite ajouter le JAR au chemin de classe de leur projet.

Étapes personnalisées

Lorsque vous écrivez une implémentation Java pour une étape
custom
, tenez compte des éléments suivants :
  • La méthode doit être déclarée
    public
    afin qu'il puisse être appelé en dehors de la classe.
  • La méthode doit être non statique.
  • Chaque méthode doit avoir un nom unique.
  • Les listes de paramètres doivent correspondre aux combinaisons prises en charge.
  • La méthode peut émettre n'importe quel type d'exception.
  • Si vous ne fournissez pas de nom de méthode, Workday sélectionne n'importe quelle méthode publique (en ignorant les méthodes getter et les setter) avec une liste de paramètres correspondant aux signatures de méthode prises en charge. En cas d'ambiguïté, Workday signale une erreur lors du déploiement, que vous pouvez résoudre en indiquant un nom de méthode.
Une étape
custom
doit fournir une méthode conforme à l'une des signatures suivantes :
Signature
Utilisation
Exemple
public
return type
method(
input parameter type
input) [throws
any Exception
]
Définit le type de retour de la méthode et un paramètre d'entrée.
public String addTimestamp(byte[] messageContent) throws IOException {
public void method(
input parameter type
input,
output parameter type
output) [throws
any Exception
]
Définit les paramètres d'entrée et de sortie pris en charge.
public void addTimestamp(byte[] messageContent, OutputStream out) throws IOException {
L'étape
custom
prend en charge les types de paramètre d'entrée, de retour et de sortie suivants :
Types d'entrée
Types de retour
Types de paramètre de sortie
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • javax.xml.transform.stream.StreamSource
  • javax.xml.transform.dom.DOMSource
  • void
  • boolean
    (étape
    personnalisée
    uniquement)
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • java.io.OutputStream
  • javax.xml.transform.Result
Si une étape
personnalisée
renvoie une
void
Un type ou une valeur nulle, cela ne modifie pas le message de médiation.