Configurando vinculações WSDL

Consulte também

Você pode usar o Editor WSDL para criar vinculações. Além disso, você pode modificar as vinculações que foram geradas pelo assistente para novo WSDL.

Em um arquivo WSDL, uma vinculação define o formato da mensagem e os detalhes do protocolo de um tipo de porta.

Você pode unir a vinculação ao protocolo SOAP 1.1. A vinculação contém um nó de vinculação de SOAP e uma ou mais operações. Cada operação pode conter os seguintes elementos:

• O elemento soap:body fornece informações para o elemento Corpo de SOAP.
• Os elementos soap:header e soap:headerfault fornecem informações para o elemento Cabeçalho de SOAP.
• O elemento soap:fault fornece informações para o elemento Detalhes da falha de SOAP.

Se o nome de uma vinculação for alterado, o Editor WSDL renomeará todas as ocorrências no mesmo arquivo. Para renomear todas as ocorrências em arquivos XSD, WSDL e BPEL associados, clique com o botão direito do mouse no nó da vinculação e escolha Refatorar > Renomear.

Criando uma vinculação e um serviço a partir de um tipo de porta

Você pode criar rapidamente uma vinculação e um serviço a partir de um tipo de porta existente. Se quiser modificar a vinculação depois, consulte as etapas apropriadas em Criando uma vinculação.

Para criar uma vinculação e um serviço a partir de um tipo de porta:

1. Na exibição WSDL, clique com o botão direito do mouse no nó do tipo de porta e escolha Adicionar > Vinculação e porta de serviço.
   A caixa de diálogo Gerar vinculação e porta de serviço aparece.
2. Forneça um nome para a vinculação.
3. O único tipo de vinculação permitido nesta versão é o protocolo SOAP.
4. As opções de subtipo de vinculação indicam como traduzir a vinculação em uma mensagem de SOAP. Se as configurações das partes de mensagem e do subtipo de vinculação não estiverem em conformidade com o perfil básico WS-I, aparecerá uma mensagem de erro.
5. Forneça um nome para o serviço.
6. Forneça um nome para a porta.
7. Clique em OK.
   Um nó de vinculação e um nó de serviço aparecem. O nó de vinculação contém um nó de vinculação de SOAP e uma ou mais operações. O nó de serviço contém um nó de porta.

• O nó do endereço de SOAP da porta inclui uma propriedade de local, que especifica o endereço da porta. O assistente gera um valor fictício para a propriedade de localização. Certifique-se de substituir o valor fictício por um valor válido.

Criando uma vinculação

Em vez de rapidamente criar uma vinculação e um serviço a partir de um tipo de porta existente, crie a vinculação, o serviço e os seus respectivos subnós individualmente. Esta seção descreve como criar a vinculação e como configurar as informações de SOAP.

• As opções de subtipo de vinculação na caixa de diálogo Gerar vinculação e porta de serviço são uma combinação das propriedades de estilo e de uso descritas nesta seção.

Para criar uma vinculação:

1. Na exibição WSDL, clique com o botão direito do mouse no nó Vinculações e escolha Adicionar vinculação.
   Um nó de vinculação é exibido.
2. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
3. Selecione o nó da vinculação.
4. (Opcional) Defina a propriedade Nome do novo nome.
5. Defina a propriedade Tipo do tipo de porta ao qual a vinculação fará referência.
6. Clique com o botão direito do mouse no nó da vinculação e escolha Adicionar > Operação de vinculação.
   
7. Se o tipo de porta da vinculação tiver mais de uma operação, a caixa de diálogo Selecionar operação aparecerá. Escolha uma ou mais operações e clique em OK.
   Um ou mais nós de operação são exibidos.

Para adicionar um nó de vinculação de SOAP:

1. Na exibição WSDL, clique com o botão direito do mouse no nó da vinculação e escolha Adicionar > Vinculação de SOAP.
   Um nó de vinculação de SOAP aparece.
2. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
3. Selecione o nó da vinculação de SOAP.
4. A propriedade de estilo indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como documento ou RPC.

Para configurar os elementos SOAP de uma operação:

1. Na exibição WSDL, clique com o botão direito do mouse no nó da operação e escolha Adicionar > Operação de SOAP.
   Um nó de operação de SOAP aparece. Esse nó contém todas as informações da operação.
2. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
3. Selecione o nó de operação de SOAP.
4. A propriedade soapAction especifica o valor do cabeçalho SOAPAction da operação.
5. A propriedade de estilo indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como documento ou RPC.
6. Dependendo do cenário, adicione elementos aos nós Entrada, Saída e Falha.
• O nó Entrada permite adicionar os seguintes elementos: soap:body e soap:header.
• O nó Saída permite adicionar os seguintes elementos: soap:body e soap:header.
• O nó Falha permite adicionar o seguinte elemento: soap:fault.
7. Para adicionar um elemento soap:headerfault, clique com o botão direito do mouse no nó soap:header e escolha Adicionar headerfault.
8. Se tiver adicionado um elemento soap:body, você poderá definir as seguintes propriedades.
• A propriedade Partes indica que partes da mensagem aparecem em algum local do elemento Corpo de SOAP.
• A propriedade encodingStyle pode ser definida como uma lista de URIs que representam as codificações usadas na mensagem.
• A propriedade de uso indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como literal ou codificado.
• A propriedade de espaço de nome fornece informações sobre os usos codificados.
9. Se tiver adicionado um elemento soap:header, poderá definir as seguintes propriedades. As propriedades Mensagem e Parte são obrigatórias.
• As propriedades Mensagem e Parte fazem referência à parte da mensagem que define o tipo de cabeçalho.
• A propriedade de uso indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como literal ou codificado.
• A propriedade encodingStyle pode ser definida como uma lista de URIs que representam as codificações usadas na mensagem.
• A propriedade de espaço de nome fornece informações sobre os usos codificados.
10. Se tiver adicionado um elemento soap:headerfault, poderá definir as seguintes propriedades. As propriedades Mensagem e Parte são obrigatórias.
• As propriedades Mensagem e Parte fazem referência à parte da mensagem que define o tipo de cabeçalho.
• A propriedade de uso indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como literal ou codificado.
• A propriedade encodingStyle pode ser definida como uma lista de URIs que representam as codificações usadas na mensagem.
• A propriedade de espaço de nome fornece informações sobre os usos codificados.
11. Se tiver adicionado um elemento soap:fault, poderá definir as seguintes propriedades.
• A propriedade encodingStyle pode ser definida como uma lista de URIs que representam as codificações usadas na mensagem.
• A propriedade de uso indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como literal ou codificado.
• A propriedade de espaço de nome fornece informações sobre os usos codificados.

Removendo vinculações

Para remover uma vinculação:

• Na exibição WSDL, clique com o botão direito do mouse no nó da vinculação e escolha Excluir.

Consulte também

Configurando componentes de arquivo WSDL