Link de parceiro

Na linguagem BPEL, os links de parceiro são referências a serviços da Web externos com os quais um processo BPEL interage. A atividade Link de parceiro define que função cada parceiro desempenha na troca de mensagens interativas. Indiretamente, em virtude das referências a um tipo de link de parceiro, uma atividade Link de parceiro indica que tipos de porta são implementados por cada parceiro.

Elementos link de parceiro e definições de tipos de link de parceiro

O tipo de link de parceiro é uma extensão BPEL do WSDL. Como tal, é definida em um arquivo WSDL, não em um arquivo BPEL. O tipo de link de parceiro cria um associação entre uma ou duas funções arbitrárias e indica que cada função deve implementar um único tipo de porta. Ao associar um tipo de porta a uma função, o tipo de link de parceiro define as regras de interação entre os parceiros.

Não confunda elementos Link de parceiro e definições de tipo de link de parceiro:

Os tipos de link de parceiros e as funções são extensões BPEL, definidas no arquivo WSDL.
Os elementos Link de parceiro são elementos BPEL 2.0. São definidos no arquivo do processo BPEL. Os elementos Link de parceiro fazem referência aos atributos Tipo de link de parceiro.

As definições de tipo de link de parceiro são pré-requisitas para o elemento Link de parceiro. Um elemento Link de parceiro pode ser definido somente com referência a um determinado tipo de link de parceiro e função que devem ser definidos no arquivo WSDL.

Formas de adicionar um link de parceiro

Você pode adicionar um link de parceiro a um processo comercial de uma das seguintes formas:

Arrastar o elemento Link de parceiro da Paleta para o diagrama
Arrastar um arquivo WSDL do mesmo projeto na janela Projetos para o diagrama
Arrastar um arquivo WSDL de outro projeto na janela Projetos para o diagrama. O IDE recupera automaticamente o arquivo WSDL de outro projeto e copia os arquivos relacionados no diretório Parceiro da estrutura do projeto.
Arrastar um nó de serviço da Web de um projeto EJB na janela Projetos para o diagrama

Ao arrastar um nó de serviço da Web, o BPEL Designer recupera o arquivo WSDL do servidor de aplicativos. Para que a recuperação do arquivo WSDL seja bem-sucedida, o servidor de aplicativos e o projeto de serviço da Web devem estar implantados.

Usando um elemento Link de parceiro

Para usar o elemento Link de parceiro:

Na exibição Design, adicione um elemento Link de parceiro ao diagrama usando um dos métodos abaixo.
É exibida a caixa de diálogo Editor de propriedades do link de parceiro.
Na caixa de diálogo Editor de propriedades, especifique o seguinte:

Nome. Aceite o nome padrão ou insira um nome arbitrário. O nome deve ser exclusivo desse processo.
Arquivo WSDL. Selecione o arquivo WSDL do serviço externo associado ao Link de parceiro.
O arquivo WSDL pode ser pré-selecionado se tiver adicionado o elemento Link de parceiro arrastando um arquivo WSDL para o diagrama.

Selecione uma das opções seguintes para especificar o tipo de link de parceiro:

Usar tipo de link de parceiro existente. Se desejar usar as definições de tipo de link de parceiro existentes no arquivo WSDL especificado, selecione este botão de opção e siga o procedimento para tipos de link de parceiro existentes abaixo.
Usar um tipo de link de parceiro recém-criado. Se desejar criar uma nova definição de tipo de link de parceiro no arquivo WSDL e usá-la dentro do elemento Link de parceiro, selecione este botão de opção e siga o procedimento para novos tipos de link de parceiro conforme descrito abaixo.

Para usar o tipo de link de parceiro existente:

Selecione o botão de opção Usar tipo de link de parceiro existente e selecione o tipo de link de parceiro na lista suspensa. Os campos Minha função e/ou Função do parceiro são preenchidos automaticamente.
Clique em OK.
O IDE modifica o arquivo BPEL com os valores fornecidos por você.

Para trocar as funções do processo comercial (Minha função) e do parceiro (Função do parceiro), clique no botão Trocar funções.

Para adicionar um novo tipo de link de parceiro e configurar o elemento Link de parceiro a fim de que o utilize:

Selecione o botão de opção Usar um tipo de link de parceiro recém-criado e especifique o nome do tipo de link de parceiro.
Especifique a função do processo comercial (Minha função) e/ou do parceiro (Função do parceiro) conforme descrito a seguir:

Marque a caixa de seleção que corresponda à função que deseja definir.
Especifique o nome da função no campo Nome da função.
Selecione o tipo de porta na lista suspensa.

Clique em OK.
O IDE adiciona uma nova definição de tipo de link de parceiro ao arquivo WSDL e modifica o arquivo BPEL com os valores fornecidos por você.

Observe que pelo menos uma das funções deve ser definida; caso contrário, o Link de parceiro não será configurado corretamente.

Consulte também: Receber; Responder; Chamar; Adicionando importações de WSDL e de esquema XML; Sobre o editor WSDL; Paleta do BPEL Designer: Serviço da Web; Sobre a exibição Design do BPEL Designer

Notificações legais