Ir para o conteúdo principal
Administrator Guide
Última atualização: 2023-06-23
Conceito: elementos de assembly personalizados

Conceito: elementos de assembly personalizados

Você pode criar cinco tipos de elementos de assembly personalizados no Workday Studio:
Elemento personalizado
Procedimento
Componente de mediação
Adicione um componente
custom-mediation
da categoria
Componentes
em
Palette
.
Etapa de mediação
Adicione uma etapa
custom
da categoria
Outro
em
Palette
.
Transporte de saída
Adicione um transporte
custom-out
da categoria
Out Transports
em
Palette
.
Manipulador de erros
Adicione um componente
custom-error-handler
da categoria
Error Handlers
em
Palette
.
Estratégia de roteamento
Selecione
Create custom-strategy
na barra de ferramentas de contexto de um componente de
Route
.
Em cada caso, o elemento personalizado consiste em três partes:
  • A implementação Java subjacente, que define as classes e os métodos usados pelo elemento.
  • A configuração do bean do Spring, que informa ao Workday como criar instâncias das classes Java.
  • A configuração do componente de assembly, que coloca seu elemento personalizado na visualização gráfica do assembly.
    Os elementos de assembly personalizados podem acessar partes da mensagem da maneira normal ao processar dados de entrada. Você também pode especificar a parte da mensagem para a qual o Workday deve direcionar a saída do elemento personalizado.
Para compartilhar um elemento personalizado, exporte o pacote Java como um JAR binário. Outros desenvolvedores podem então adicionar o JAR ao caminho de classe dos seus projetos.

Etapas personalizadas

Quando escrever uma implementação Java para uma etapa
personalizada
, considere estes pontos:
  • O método deve ser declarado
    public
    para que possa ser chamada fora da classe.
  • O método deve ser não estático.
  • Cada método deve ter um nome exclusivo.
  • As listas de parâmetros devem corresponder às combinações permitidas.
  • O método pode gerar qualquer tipo de exceção.
  • Se você não fornece um nome de método, o Workday seleciona qualquer método público (ignorando getters e setters) com uma lista de parâmetros que corresponde às assinaturas de método com suporte. Se há alguma ambiguidade, o Workday relata um erro durante a implantação, que você pode resolver especificando um nome de método.
Uma etapa
custom
deve fornecer um método que atende a uma destas assinaturas:
Assinatura
Uso
Exemplo
public
return type
method(
input parameter type
input) [throws
any Exception
]
Define o tipo de retorno do método e um parâmetro de entrada.
public String addTimestamp(byte[] messageContent) throws IOException {
public void method(
input parameter type
input,
output parameter type
output) [throws
any Exception
]
Define parâmetros de entrada e saída com suporte.
public void addTimestamp(byte[] messageContent, OutputStream out) throws IOException {
A etapa
personalizada
oferece suporte a estes tipos de parâmetro de entrada, retorno e saída:
Tipos de entrada
Tipos de retorno
Tipos de parâmetro de saída
  • 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
    (somente etapa
    personalizada
    )
  • 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
Se uma etapa
personalizada
retorna um
void
tipo ou um valor nulo, ele não altera a mensagem de conciliação.