Concetto: Elementi di assembly personalizzati
È possibile creare cinque tipi di elementi di assembly personalizzati in Workday Studio:
Elemento personalizzato | Procedura |
|---|---|
Componente di mediazione | Aggiungere un componente custom-mediation dalla categoria Components nella Palette . |
Step di mediazione | Aggiungere uno step custom dalla categoria Other nella Palette . |
Trasporto in uscita | Aggiungere un trasporto custom-out dalla categoria Out Transports nella Palette . |
Gestore degli errori | Aggiungere un componente custom-error-handler dalla categoria Error Handlers nella Palette . |
Strategia di routing | Selezionare Create custom-strategy dalla barra degli strumenti contestuale di un componente Route . |
In ciascun caso, l'elemento personalizzato è composto da tre parti:
- L'implementazione Java sottostante, che definisce le classi e i metodi utilizzati dall'elemento.
- La configurazione del bean di Spring, che indica al sistema come creare istanze delle classi Java.
- La configurazione del componente di assembly, che inserisce l'elemento personalizzato nella visualizzazione grafica dell'assembly.Gli elementi di assembly personalizzati possono accedere alle parti dei messaggi normalmente durante l'elaborazione dei dati in entrata. È anche possibile specificare la parte del messaggio a cui il sistema deve indirizzare l'output dell'elemento personalizzato.
Per condividere un elemento personalizzato, esportare il pacchetto Java come file JAR binario. Gli altri sviluppatori possono quindi aggiungere il file JAR al percorso classe del progetto.
Step Custom
Quando si scrive un'implementazione Java per uno step
personalizzato
, considerare i seguenti punti:- Il metodo deve essere dichiaratopublicin modo che possa essere chiamato dall'esterno della classe.
- Il metodo deve essere non statico.
- Ogni metodo deve avere un nome univoco.
- Gli elenchi di parametri devono corrispondere alle combinazioni supportate.
- Il metodo può generare qualsiasi tipo di eccezione.
- Se non si specifica un nome per il metodo, il sistema seleziona qualsiasi metodo pubblico (ignorando getter e setter) con un elenco di parametri corrispondente alle firme del metodo supportato. In caso di ambiguità, il sistema segnala un errore durante la distribuzione, che è possibile risolvere specificando un nome metodo.
Uno step
custom
deve fornire un metodo che rispetti una delle seguenti firme:
Firma | Utilizzo | Esempio |
|---|---|---|
public
return type method(input parameter type input) [throws
any Exception ] | Definisce il tipo restituito del metodo e un parametro di input. | public String addTimestamp(byte[] messageContent) throws
IOException {
|
public void method(
input parameter type input,
output parameter type output) [throws any
Exception ] | Definisce i parametri di input e output supportati. | public void addTimestamp(byte[] messageContent,
OutputStream out) throws IOException {
|
Lo step
personalizzato
supporta i seguenti tipi di parametri di input, restituiti e di output:
Tipi di input | Tipi restituiti | Tipi di parametro di output |
|---|---|---|
|
|
|
Se uno step
personalizzato
restituisce un void
tipo o un valore null, non modifica il messaggio di mediazione.