O Editor WSDL permite editar os arquivos WSDL (linguagem de descrição de serviços da Web). WSDL é uma linguagem baseada em XML para descrever serviços da Web. Um arquivo WSDL contém informações sobre a funcionalidade do serviço da Web, assim como informações sobre como acessar o serviço da Web. O editor suporta a versão 1.1 da especificação WSDL.
Em um projeto do módulo BPEL, use os arquivos WSDL para definir as interfaces de processos comerciais e seus respectivos serviços de parceiro.
Você pode criar um arquivo WSDL a partir do zero ou baseado em um arquivo WSDL existente.
Você pode adicionar os seguintes elementos de extensibilidade BPEL a um arquivo WSDL: tipos de link de parceiro, propriedades e alias da propriedade.
O Editor WSDL inclui uma ferramenta de validação. A ferramenta de validação verifica se existem problemas de sintaxe e semântica no arquivo WSDL. A janela Saída exibe os erros ou os avisos.
Ao criar um arquivo WSDL, você deve escolher uma das seguintes abordagens:
Criar um arquivo WSDL a partir do zero. Um assistente o orientará através do processo.
Criar um arquivo WSDL com base em um arquivo WSDL existente.
A saída do assistente é um arquivo WSDL válido e bem formado, que contém um conjunto de elementos correlacionados, incluindo as mensagens necessárias, um tipo de porta (com seu tipo de link de parceiro correspondente), uma vinculação e um serviço. Você pode modificar o arquivo depois usando o editor WSDL.
Para criar um arquivo WSDL a partir do zero:
Na janela Projetos, clique com o botão direito do mouse na pasta Processar arquivos e escolha Novo > Documento WSDL.
Na página do assistente para Nome e local, adote o seguinte procedimento:
Forneça um nome para o tipo de arquivo. Você não pode inserir um nome que já exista no projeto.
(Opcional) Altere a pasta padrão clicando em Explorar e selecionando a nova pasta.
Insira o espaço de nome de destino do arquivo WSDL. O espaço de nome de destino aparecerá no elemento raiz.
Especifique os arquivos do esquema XML que desejar importar.
Clique em Próximo.
Na página do assistente Configuração abstrata, adote o seguinte procedimento:
Forneça um nome para o tipo de porta.
Forneça um nome para a operação.
Selecione a categoria da operação.
Dependendo da categoria da operação, forneça informações de mensagem para a entrada, a saída ou para ambas. Cada mensagem contém uma ou mais partes lógicas. Os botões Adicionar e Remover permitem adicionar e remover partes de mensagem.
(Opcional) Se a categoria da operação for Solicitação-Resposta ou Requisição-Resposta, então você poderá fornecer informações da mensagem de uma falha.
Clique em Próximo.
Na página do assistente Configuração concreta, adote o seguinte procedimento:
Forneça um nome para a vinculação.
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 da mensagem e do subtipo de vinculação não estiverem em conformidade com o perfil básico WS-I, aparecerá uma mensagem de erro na parte inferior da página do assistente.
Forneça um nome para o serviço.
Forneça um nome para a porta.
Clique em Finalizar.
O arquivo WSDL é criado. O Editor WSDL aparece na exibição WSDL.
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. A propriedade de localização deve ser exclusiva; ou seja, o valor não deve estar em conflito com quaisquer outros arquivos WSDL que estejam implantados no mesmo servidor de aplicativos.
Para criar um arquivo WSDL com base em um arquivo WSDL existente:
Na janela Projetos, clique com o botão direito do mouse na pasta Processar arquivos e escolha Novo > Arquivo/Pasta.
Na página do assistente Escolher tipo de arquivo, adote o seguinte procedimento:
Na lista Categorias, selecione o nó XML.
Na lista Tipos de arquivos, selecione o nó Documento(s) WSDL externo(s).
Clique em Próximo.
Na página do assistente Especificar local do recurso, adote um dos seguintes procedimentos:
Para criar um arquivo WSDL com base em um serviço em execução:
Selecione o botão Do URL.
Insira o URL do arquivo WSDL do serviço.
Clique em Finalizar.
Para criar um arquivo WSDL usando um arquivo WSDL existente localizado no sistema de arquivos local:
Selecione o botão Do sistema de arquivos local.
Especifique a pasta onde o arquivo WSDL está localizado.
Clique em Finalizar.
O arquivo WSDL é criado. O Editor WSDL aparece na exibição WSDL.
O Editor WSDL fornece uma exibição Fonte e uma exibição WSDL. A barra de ferramentas do Editor WSDL possui dois botões que podem ser usados para acessar as diferentes exibições:
Exibição Fonte
Na exibição Fonte, o código-fonte XML subjacente aparece. Você pode editar diretamente o XML.
Na parte superior do Editor de fontes há uma guia para cada documento aberto. Cada guia mostra o nome do documento. Se o documento foi modificado e não foi salvo, aparecerá um asterisco (*) depois do nome. Você pode acessar vários comandos clicando com o botão direito do mouse em uma guia.
Há uma barra de ferramentas na parte superior da janela Editor de fontes.
O código-fonte exibido no Editor de fontes é colorido sintaticamente.
A linha de status do Editor de fontes fica embaixo da barra de rolagem horizontal. Para alternar entre o modo de inserção e o modo de substituição, use a tecla Insert.
Exibição WSDL
Na exibição WSDL, use os componentes de GUI para configurar os elementos e atributos do arquivo WSDL.
A exibição WSDL possui duas subexibições: exibição em árvore e exibição em coluna. Para alternar entre as subexibições, use os botões da barra de ferramentas do Editor WSDL.
Alguns nós do componente permitem adicionar atributos de extensão. Na caixa de diálogo Adicionar atributo de extensão, você pode especificar o nome e o espaço de nome. Depois de adicionar o atributo, você pode especificar o valor na janela Propriedades. Esses nós de componente também permitem remover os atributos de extensão.
Se clicar com o botão direito do mouse em um nó de componente e escolher Ir para origem, a exibição Fonte aparecerá com o cursor posicionado no começo do bloco do componente.
Você pode realizar uma refatoração:
Se clicar com o botão direito do mouse em um nó de componente e escolher Localizar usos, o IDE mostrará quais componentes usam o componente selecionado.
Se clicar com o botão direito do mouse em um nó de componente e escolher Refatorar > Renomear, poderá renomear todas as ocorrências nos arquivos XSD, WSDL e BPEL associados.
Se clicar com o botão direito do mouse em um nó de componente e escolher Refatorar > Excluir seguramente, poderá verificar as referências ao componente antes de realizar a exclusão.
Você também pode renomear um componente alterando o valor da propriedade Nome. O Editor WSDL renomeia todas as ocorrências no mesmo arquivo, mas não em outros arquivos.
Esta seção descreve como configurar o elemento raiz do arquivo WSDL, adicionar documentação a qualquer elemento e importar arquivos WSDL e de esquemas XML.
Se adicionar as instruções de importação usando a exibição Fonte, ou se copiar arquivos com referências ao URL no projeto, o arquivo WSDL referenciado talvez só possa ser acessado através de um URL.
Neste caso, o projeto pode não conter o encerramento real de todos os documentos.
Visto que os arquivos WSDL são referenciados, o IDE seguirá a mesma lógica usada na recuperação de recursos WSDL por meio do assistente Documento(s) WSDL externo(s) e recuperará com precisão os documentos e os armazenará em uma área sem controle de versão.
Isso pode causar um atraso na primeira vez que estes documentos forem acessados na sua máquina porque os documentos referenciados não são locais. Os acessos subseqüentes serão mais rápidos.
O elemento raiz contém propriedades do nome do arquivo WSDL, o espaço de nome de destino, o espaço de nome padrão e prefixos de espaço de nome.
Para configurar o elemento raiz:
Na exibição WSDL, selecione o nó raiz.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Edite o nome, o espaço de nome de destino e o espaço de nome padrão conforme necessário.
Edite os valores dos prefixos de espaço de nome conforme necessário.
Adicionando documentação
Você pode adicionar documentação a qualquer elemento no arquivo WSDL.
Para adicionar documentação:
Na exibição WSDL, clique com o botão direito do mouse em um elemento e escolha Adicionar > Documentação. Um nó de documentação é exibido.
Selecione o nó de documentação.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Insira o texto da documentação.
Importando esquemas XML e arquivos WSDL
Você pode usar o Editor WSDL para importar um arquivo do esquema XML ou outro arquivo WSDL que faça parte do projeto.
Para importar um esquema XML:
Na exibição WSDL, clique com o botão direito do mouse no nó raiz e escolha Adicionar > Importar esquema. A caixa de diálogo Importar personalizador é aberta.
Na lista Local, expanda os nós Por arquivo ou Por espaço de nome para navegar até o arquivo do esquema XML e selecioná-lo. O campo Espaço de nome abaixo da lista Local é preenchido pelo IDE.
(Opcional) No campo Novo prefixo, digite o prefixo que deseja usar.
Clique em OK.
Para importar outro arquivo WSDL:
Na exibição WSDL, clique com o botão direito do mouse no nó raiz e escolha Adicionar > Importar WSDL. A caixa de diálogo Importar personalizador é aberta.
Na lista Local, expanda os nós Por arquivo ou Por espaço de nome para navegar até o arquivo WSDL e selecioná-lo. O campo Espaço de nome abaixo da lista Local é preenchido pelo IDE.
(Opcional) No campo Novo prefixo, digite o prefixo que deseja usar.
O Editor WSDL fornece suporte para os tipos simples internos no Esquema XML W3C. Os tipos simples internos incluem tipos como seqüência, data e inteiro.
Você pode definir seus próprios tipos de dados adicionando um esquema in-line. O Editor WSDL permite configurar uma ou mais propriedades globais e definir a estrutura.
Para adicionar um esquema in-line:
Na exibição WSDL, clique com o botão direito do mouse no nó Tipos e escolha Adicionar > Esquema in-line. O nó do esquema in-line aparece.
Para configurar as propriedades globais do esquema in-line:
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó do esquema in-line.
Você pode realizar uma ou mais das seguintes tarefas opcionais:
Especificar uma ID exclusiva.
Especificar se os atributos declarados localmente devem ser qualificados com o prefixo de espaço de nome.
Especificar se os elementos declarados localmente devem ser qualificados com o prefixo de espaço de nome.
Especificar o valor padrão do atributo block, que controla o uso da substituição.
Especificar o valor padrão do atributo final, que controla o uso da derivação de tipo.
Especificar a versão do esquema.
Especificar o espaço de nome de destino do esquema.
Para definir a estrutura do esquema in-line:
Adicione um ou mais dos seguintes componentes do esquema XML conforme necessário. A interface é a mesma da exibição Esquema que aparece ao editar um esquema XML.
Você pode usar o Editor WSDL para criar mensagens.
Em um arquivo WSDL, um tipo de porta contém uma ou mais operações relacionadas que o serviço da Web pode realizar. Uma operação recebe uma mensagem, envia uma mensagem ou ambos.
Cada mensagem deve conter uma ou mais partes lógicas. Para cada parte, você deve especificar o nome e o tipo de conteúdo.
Se alterar o nome de uma mensagem ou parte, 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ó de componente e escolha Refatorar > Renomear.
Para criar uma mensagem:
Na exibição WSDL, clique com o botão direito do mouse no nó Mensagens e escolha Adicionar mensagem. Um nó de mensagem aparece. A mensagem contém uma parte padrão.
Para alterar o nome de uma mensagem:
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó da mensagem.
Defina a propriedade Nome como o novo nome.
Para alterar as propriedades de uma parte:
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó da parte.
Defina a propriedade Nome como o novo nome. Certifique-se de inserir um nome descritivo, tal como Entradadepesquisa ou Saídaderesultado.
A propriedade Elemento ou Tipo especifica o tipo de conteúdo. Para definir o valor, clique no botão de reticências (...). A caixa de diálogo Elemento ou Tipo permite selecionar qualquer um dos tipos internos no Esquema XML W3C. Se você adicionou um esquema in-line ou importou um esquema, então poderá selecionar um tipo no esquema.
Para adicionar uma parte a uma mensagem existente:
Clique com o botão direito do mouse no nó da mensagem e escolha Adicionar > Parte. Um nó de parte é exibido.
Para remover uma mensagem ou parte:
Clique com o botão direito do mouse no nó da mensagem ou da parte e escolha Excluir.
Você pode usar o Editor WSDL para criar tipos de porta. Além disso, você pode usar o Editor WSDL para adicionar operações a um tipo de porta existente.
Em um arquivo WSDL, um tipo de porta contém uma ou mais operações relacionadas que o serviço da Web pode realizar. Um exemplo de uma operação é GetQuote.
A especificação WSDL 1.1 define as seguintes categorias de operações:
Unidirecional. A operação recebe uma mensagem como entrada.
Solicitação-resposta. A operação recebe uma mensagem como entrada e envia uma mensagem como saída.
Requisição-resposta. A operação envia uma mensagem como saída e recebe uma mensagem como entrada.
Notificação. A operação envia uma mensagem como saída.
Cada mensagem contém uma ou mais partes lógicas. Para cada parte, você deve especificar o nome e o tipo de conteúdo.
Se alterar o nome de um tipo de porta ou operação, 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ó de componente e escolha Refatorar > Renomear.
Para criar um tipo de porta:
Na exibição WSDL, clique com o botão direito do mouse no nó Tipos de porta e escolha Adicionar tipo de porta. A caixa de diálogo Criar nova porta é exibida.
Forneça um nome para o tipo de porta.
Forneça um nome para a operação.
Selecione a categoria da operação.
Dependendo da categoria da operação, forneça informações de mensagem para a entrada, a saída ou para ambas. Você pode criar uma mensagem do zero inserindo um novo nome de mensagem ou pode selecionar uma mensagem existente. Para uma nova mensagem, os botões Adicionar e Remover permitem adicionar e remover partes de mensagem.
(Opcional) Se a categoria da operação for Solicitação-Resposta ou Requisição-Resposta, então você poderá fornecer informações da mensagem de uma falha.
Clique em OK. Um nó de tipo de porta é exibido. O nó de tipo de porta contém um nó de operação. Se tiver criado uma ou mais mensagens, o nó de mensagem aparecerá. Além disso, um tipo de link de parceiro é gerado automaticamente.
Para adicionar uma operação a um tipo de porta existente:
Na exibição WSDL, clique com o botão direito do mouse no nó do tipo de porta e escolha Adicionar operação. A caixa de diálogo Criar nova operação aparece.
Forneça um nome para a operação.
Selecione a categoria da operação.
Dependendo da categoria da operação, forneça informações de mensagem para a entrada, a saída ou para ambas. Você pode criar uma mensagem do zero inserindo um novo nome de mensagem ou pode selecionar uma mensagem existente. Para uma nova mensagem, os botões Adicionar e Remover permitem adicionar e remover partes de mensagem.
(Opcional) Se a categoria da operação for Solicitação-Resposta ou Requisição-Resposta, então você poderá fornecer informações da mensagem de uma falha.
Clique em OK. Um nó de operação é exibido. Se tiver criado uma ou mais mensagens, o nó de mensagem aparecerá.
Para alterar o nome de um tipo de porta:
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó de tipo de porta.
Defina a propriedade Nome como o novo nome.
Para alterar as propriedades de uma operação:
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó de operação.
Defina a propriedade Nome como o novo nome.
Se quiser especificar a ordem de parâmetros de uma operação, defina a propriedade Ordem de parâmetros apropriadamente.
Para remover um tipo de porta ou operação:
Clique com o botão direito do mouse no nó do tipo de porta ou da operação e escolha Excluir.
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 documento 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:
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 é exibida.
Forneça um nome para a vinculação.
O único tipo de vinculação permitido nesta versão é o protocolo SOAP.
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.
Forneça um nome para o serviço.
Forneça um nome para a porta.
Clique em OK. Um nó de vinculação e um nó de serviço são exibidos. 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:
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.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó da vinculação.
(Opcional) Defina a propriedade Nome do novo nome.
Defina a propriedade Tipo do tipo de porta ao qual a vinculação fará referência.
Clique com o botão direito do mouse no nó da vinculação e escolha Adicionar > Operação de vinculação.
Se o tipo de porta da vinculação tiver mais de uma operação, a caixa de diálogo Selecionar operação será exibida. 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:
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 é exibido.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó da vinculação de SOAP.
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:
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.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó de operação de SOAP.
A propriedade soapAction especifica o valor do cabeçalho SOAPAction da operação.
A propriedade de estilo indica como traduzir a vinculação em uma mensagem de SOAP. Defina o valor como documento ou RPC.
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.
Para adicionar um elemento soap:headerfault, clique com o botão direito do mouse no nó soap:header e escolha Adicionar headerfault.
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.
Se você 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.
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.
Se você 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
Você pode remover uma vinculação do arquivo WSDL.
Para remover uma vinculação:
Na exibição WSDL, clique com o botão direito do mouse no nó de vinculação e escolha Excluir.
Você pode usar o Editor WSDL para criar serviços. Além disso, você pode modificar os serviços que foram gerados pelo assistente para Novo documento WSDL.
Em um arquivo WSDL, um serviço indica qual vinculação usar e onde os clientes podem acessar o serviço da Web.
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 o serviço depois, consulte as etapas apropriadas em Criando um serviço.
Para criar uma vinculação e um serviço a partir de um tipo de porta:
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 é exibida.
Forneça um nome para a vinculação.
O único tipo de vinculação permitido nesta versão é o protocolo SOAP.
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.
Forneça um nome para o serviço.
Forneça um nome para a porta.
Clique em OK. Um nó de vinculação e um nó de serviço são exibidos. 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 um serviç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 o serviço e como configurar as informações de SOAP.
Antes de configurar a porta do serviço, você deve criar a vinculação.
Para criar um serviço:
Na exibição WSDL, clique com o botão direito do mouse no nó Serviços e escolha Adicionar serviço. Um nó de serviço aparece.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó do serviço.
(Opcional) Defina a propriedade Nome do novo nome.
Clique com o botão direito do mouse no nó do serviço e escolha Adicionar > Porta do serviço. Um nó de porta é exibido.
Selecione o nó da porta.
(Opcional) Defina a propriedade Nome do novo nome.
Defina a propriedade Vinculação como a vinculação desejada.
Para adicionar um nó de endereço de SOAP:
Clique com o botão direito do mouse no nó da porta e escolha Adicionar > Endereço de SOAP. Um nó de endereço de SOAP é exibido.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó do endereço de SOAP.
Defina a propriedade Local como a URI base da porta.
Removendo serviços e portas
Você pode remover um serviço ou porta do arquivo WSDL.
Para remover um serviço ou porta:
Na exibição WSDL, clique com o botão direito do mouse no nó do serviço ou da porta e escolha Excluir.
Antes de adicionar um link de parceiro a um processo BPEL, você deve adicionar um tipo de link de parceiro ao arquivo WSDL.
Em um processo BPEL, um link de parceiro representa a interação entre o processo BPEL e um serviço de parceiro. Cada link de parceiro está associado a um tipo de link de parceiro.
Um tipo de link de parceiro caracteriza a relação interativa entre dois serviços. Um tipo de link de parceiro pode ter uma ou duas funções. Uma função descreve o papel de um serviço no relacionamento. Exemplos de funções são loanRequestor e loanProcessor. Cada função deve especificar o tipo de porta que o serviço usará para receber mensagens.
Para adicionar um tipo de link de parceiro automaticamente
Ao realizar uma das tarefas abaixo, um tipo de link de parceiro é automaticamente gerado. O tipo de link de parceiro possui uma função padrão.
Criar um arquivo WSDL a partir do zero.
Criar um tipo de porta.
(Opcional) Para adicionar uma segunda função, adote o seguinte procedimento:
Clique com o botão direito do mouse no nó do tipo de link de parceiro e escolha Adicionar > Função.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione a função.
(Opcional) Altere o nome padrão.
Especifique o tipo de porta.
Para adicionar um tipo de link de parceiro manualmente:
Na exibição WSDL, clique com o botão direito do mouse no nó raiz e escolha Adicionar > PartnerLinkType. Um nó de tipo de link de parceiro aparece no nó Elementos de extensibilidade. O tipo de link de parceiro possui uma função padrão.
(Opcional) Para adicionar uma segunda função, clique com o botão direito do mouse no nó do tipo de link de parceiro e escolha Adicionar > Função.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Para cada função, execute os seguintes procedimentos:
Selecione a função.
(Opcional) Altere o nome padrão.
Especifique o tipo de porta.
Definindo propriedades e alias de propriedade
O tempo de execução do mecanismo de serviço BPEL usa um mecanismo chamado correlação para controlar as várias trocas de mensagens de longa duração que geralmente acontecem entre um processo BPEL e os serviços de parceiros.
O procedimento de ativação da correlação em um processo BPEL inclui as seguintes etapas iniciais, que devem ser realizadas no arquivo WSDL:
Defina uma ou mais propriedades no arquivo WSDL. Uma propriedade cria uma associação entre dados empresariais e um nome que pode desempenhar um papel importante no contexto global do processo BPEL. Cada propriedade consiste em um nome globalmente exclusivo (por exemplo, claimNumberProperty) e um tipo (por exemplo, xsd:string).
Defina o alias de propriedade no arquivo WSDL. Um alias de propriedade mapeia uma propriedade específica para um atributo ou elemento específico em uma parte da mensagem. Ao criar um alias de propriedade, você deve especificar a propriedade e a mensagem.
Depois de realizar essas etapas no arquivo WSDL, você pode definir um conjunto de correlações no processo BPEL. O conjunto de correlações faz referência a uma ou mais propriedades. O conjunto de correlações pode então ser usado por atividades de mensagem (Chamar, Responder e Receber) e pelas ramificações onMessage dos elementos Selecionar.
Para definir uma propriedade:
Na exibição WSDL, clique com o botão direito do mouse no nó raiz e escolha Adicionar > Propriedade. Um nó de propriedade aparece no nó Elementos de extensibilidade.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó de propriedade.
(Opcional) Altere o nome padrão.
Você pode definir a propriedade Elemento ou Tipo como um tipo simples interno, como seqüência ou data.
Para definir um alias de propriedade:
Na exibição WSDL, clique com o botão direito do mouse no nó raiz e escolha Adicionar > Alias de propriedade. Um alias de propriedade aparece no nó Elementos de extensibilidade.
Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
Selecione o nó de alias de propriedade.
Especifique valores para as propriedades Nome da propriedade e Tipo de mensagem. Essas propriedades permitem mapear dados de uma mensagem em um valor de propriedade.
Você pode especificar um valor para a seguinte propriedade opcional: Parte.
Para adicionar uma consulta, clique com o botão direito do mouse no nó do alias de propriedade e escolha Adicionar consulta. Um nó de consulta aparece. O nó de consulta permite definir o seguinte atributo opcional: queryLanguage.
Você pode determinar rapidamente onde um componente WSDL é usado no arquivo WSDL.
Para localizar os usos de um componente WSDL:
Na exibição WSDL, clique com o botão direito do mouse no componente e escolha Localizar usos. A janela Usos de XML se abre na parte inferior do IDE. A janela possui três partes:
Barra de ferramentas. Os botões da barra de ferramentas permitem atualizar as informações na janela, expandir e recolher nós no painel da árvore e percorrer os usos encontrados.
Painel da árvore. O painel da árvore contém nós dos resultados da consulta.
Painel gráfico. O painel gráfico mostra uma representação gráfica dos resultados.
Para diminuir o zoom, clique com o botão direito do mouse no gráfico e arraste para cima. Para aumentar o zoom, clique com o botão direito do mouse no gráfico e arraste para baixo.
Para obter um efeito panorâmico, clique e arraste em qualquer direção.
