Chamando serviços e APIs padrão programaticamente

É possível revisar o código de amostra para chamar serviços e APIs padrão programaticamente e revisar os protocolos.

O aplicativo fornece código de amostra que demonstra como as APIs e serviços padrão do aplicativo podem ser chamados programaticamente. Consulte os arquivos de amostra no diretório <runtime_sandbox>/xapidocs/code_examples/

Observação: use o método executeFlow( ) da interface YIFApi para executar um serviço definido na Estrutura de definição de serviço.

As transações de API e de serviço que são de saída do aplicativo podem ser configuradas por meio do Service Builder, conforme descrito em Conceitos de modelagem de organização e participante.

As transações da API e de serviço que são de entrada para o aplicativo podem ser chamadas através dos seguintes protocolos:
  • EJB
  • HTTP e HTTPS
  • LOCAL
  • Serviços da web
  • COM+

EJB

Use EJB para execução do lado do servidor do código. chamada Java™ . Todos os métodos no aplicativo usam um YFSEnvironment e um documento, e retornam um documento. Como os EJBs são projetados para serem chamados remotamente, cada um desses documentos é serializado em uma extremidade e desserializado na outra. No entanto, o aplicativo usa um EJB, em que cada API assume dois parâmetros de sequência e retorna uma sequência. Dessa forma, forçando qualquer implementação do documento a serializar e desserializar usando uma interface bem-definida padrão.

Por exemplo, um novo EJB é criado com assinaturas de método como:
String createOrder(String env, String inputXML) throws YFSException, RemoteException;

em que env é um XML que deve ser uma entrada válida para a variável createEnvironment. O valor de retorno é o XML de saída.

Ao chamar uma API usando YIFClientFactory.getInstance().getApi("EJB"), a chamada é feita usando esse EJB baseado em Sequência. Com este tipo de chamada, é possível transmitir um YFSEnvironment e um documento e obter um documento em troca. O código do aplicativo executa a conversão de modo transparente.

Nota: O EJB baseado em DOM foi descontinuado.. Portanto, avançando é necessário usar o EJB baseado em Sequência para execução do lado do servidor.

HTTP

Use HTTP para execução do lado do servidor do código. Chamada de Java

LOCAL

Use Local para execução do lado do cliente do código. Chamada COM ou Java.

Serviços da web

Use Serviços da web para execução do lado do cliente do código. Chamada COM ou Java.

COM+

Use COM para execução do lado do cliente do código VB ou C++. Chamada COM ou Java.

O uso de COM requer a configuração de seu servidor e de seus clientes de tempo de execução.

Nota: Exceções encontradas ao fazer chamadas de API síncronas através de protocolos de transporte EJB, COM ou HTTP não são enfileiradas para reprocessamento.