Concept : éléments d’assemblage personnalisés
Vous pouvez créer cinq (5) types d’éléments d’assemblage personnalisés dans Workday Studio :
Élément personnalisé | Procédure |
|---|---|
Composante de médiation | Ajoutez une composante custom-mediation partir de la catégorie Components de la Palette . |
Étape de médiation | Ajoutez une étape custom à partir de la catégorie Other dans la Palette . |
Transport sortant | Ajoutez un transport custom-out à partir de la catégorie Out Transports dans la Palette . |
Gestionnaire d’erreurs | Ajoutez une composante custom-error-handler à partir 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’une composante Route . |
Dans chaque cas, l’élément personnalisé se compose de trois (3) parties :
- La mise en œuvre Java sous-jacente, qui définit les classes et les méthodes utilisées par l’élément.
- La configuration du Spring bean, qui indique à Workday comment créer des instances des classes Java.
- La configuration de la composante d’assemblage, qui place votre élément personnalisé dans la vue graphique d’assemblage.Les éléments d’assemblages personnalisés peuvent accéder aux parties de message de la manière habituelle lors du traitement des données entrantes. Vous pouvez également préciser la partie du message vers laquelle Workday doit diriger la sortie de l’élément personnalisé.
Pour partager un élément personnalisé, exportez le paquet Java au format JAR binaire. Les autres développeurs peuvent ensuite ajouter le fichier JAR au chemin d’accès aux classes de leur projet.
Étapes personnalisées
Lorsque vous écrivez une mise en œuvre Java pour une étape
personnalisée
, tenez compte des éléments suivants :- La méthode doit être déclaréepublicelle peut donc être appelée depuis l'extérieur 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 lever tout type d’exception.
- Si vous ne fournissez aucun nom de méthode, Workday sélectionne n’importe quelle méthode publique (sans tenir compte des méthodes de type get et set) dont la liste de paramètres correspond aux signatures de méthodes prises en charge. En cas d’ambiguïté, Workday signale une erreur pendant le déploiement, que vous pouvez résoudre en spécifiant 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
personnalisée
prend en charge les types de paramètres d’entrée, de retour et de sortie suivants :
Types de données entrantes | Types de retours | Types de paramètres de sortie |
|---|---|---|
|
|
|
Si une étape
personnalisée
renvoie un void
De type ou une valeur nulle, cela ne modifie pas le message de médiatisation.