Visualização Design

A visualização Design é um designer de processos comerciais onde você pode criar um diagrama do seu processo comercial. Na visualização Design, você adiciona, edita e exclui elementos do diagrama. O diagrama construído na visualização Design é gerado automaticamente no código-fonte BPEL compatível com a especificação WS-BPEL 2.0 com a exceção listada na seção Construções da linguagem BPEL 2.0 do Guia do usuário do mecanismo de serviço BPEL.

A visualização Design se abre por padrão quando você clica duas vezes em um arquivo de código-fonte BPEL em um projeto do módulo BPEL na janela Projetos. Para alternar para o local correspondente na visualização Código-fonte, clique com o botão direito do mouse na visualização Design e selecione Ir para código-fonte (Alt-O).

Visualização Código-fonte

A visualização Código-fonte mostra o código subjacente de um diagrama de processo comercial. A visualização Código-fonte é baseada na visualização Código-fonte XML do IDE e fornece acesso a conveniências como dobramento de código, realce de sintaxe XML e auto-completar de código.

Você pode realizar a edição no nível do código-fonte, assim como no design visual. O BPEL Designer realizará a engenharia bidirecional de ida e volta para garantir que a visualização Design e a visualização Código-fonte permaneçam sincronizadas entre si. O IDE analisará de novo o arquivo de código-fonte BPEL automaticamente e reconstruirá o diagrama toda vez que você realizar edições manuais no arquivo de código-fonte.

Para alternar para o local correspondente na visualização Design, coloque um cursor na linha na visualização Código-fonte, clique com o botão direito do mouse e escolha Ir para Design (Alt-I).

Visualização XML

A visualização XML é idêntica à visualização Navegador, que está disponível para todos os documentos XML abertos no IDE. A visualização XML é um complemento da visualização Código-fonte do BPEL. Clique duas vezes em qualquer nó Navegador e a visualização Código-fonte ajustará a linha de código atual para mostrar o elemento selecionado.

Visualização lógica

O navegador também fornece a visualização Lógica BPEL dos processos BPEL. Quando você seleciona construções BPEL na visualização Design, a visualização Lógica BPEL mostra o mesmo elemento selecionado. Como alternativa, quando você seleciona um nó na árvore da visualização Lógica BPEL, o elemento correspondente é selecionado no diagrama.

Clicar com o botão direito do mouse nos nós da visualização Lógica BPEL chama os menus pop-up com ações relevantes para o nó específico. Por exemplo, para o elemento Atribuir, as ações Ir para código-fonte, Ir para design, Empacotar com, Mover para cima e Mover para baixo, Alternar ponto de interrupção, Excluir, Mostrar mapeador BPEL e Propriedades. As ações Ir para código-fonte e Ir para design, disponíveis para a maioria dos nós, possuem atalhos de teclado associados: Alt-O para Ir para código-fonte e Alt-D para Ir para Design.

Em geral, os nós da janela Navegador correspondem aos elementos do diagrama. Além disso, há nós, tais como Variáveis e Conjuntos de correlações, que estão relacionados a funcionalidades não diretamente acessíveis no diagrama. Para visualizar as variáveis usadas no processo comercial, expanda o nó Variáveis na visualização Lógica BPEL da janela Navegador. Para variáveis, os comandos seguintes estão disponíveis no menu pop-up:

• Ir para código-fonte. Abre o código-fonte do arquivo BPEL e coloca o cursor no lugar em que a variável é mencionada pela primeira vez.
• Ir para código-fonte do tipo. Abre o arquivo de código-fonte que contém uma definição do tipo de variável. Ele pode ser, por exemplo, um arquivo WSDL.
• Localizar usos. Mostra usos de variáveis no arquivo BPEL. Esse comando também está disponível no menu pop-up dos conjuntos de correlações e nos elementos Link de parceiro.

De relevância específica é o nó Importações, que lista os arquivos XSD e WSDL referenciados com a ajuda do elemento Importação do arquivo BPEL. Usando o menu pop-up do nó Importações, você pode adicionar referência a um arquivo XSD ou WSDL. Observe que somente arquivos localizados na pasta do projeto podem ser referenciados.

Para adicionar um arquivo de recursos (.wsdl ou .xsd) como uma importação:

1. Na visualização Lógica BPEL da janela Navegador, clique com o botão direito do mouse no nó Importações e escolha uma das opções seguintes, dependendo do formato do arquivo importado: Adicionar importação WSDL ou Adicionar importação do esquema.
2. Na caixa de diálogo Criar nova importação, selecione o arquivo na estrutura do projeto para adicioná-lo como importação.
   Observação: observe que os arquivos armazenados no diretório do projeto precisam primeiro ser adicionados à estrutura do projeto. Podem ser adicionados como importações. Os arquivos que já estão referenciados são exibidos no estilo tachado.
3. Exiba os valores nos campos de somente leitura Espaço de nome e Tipo, e clique em OK.
   O arquivo de recursos que você acabou de adicionar aparece no nó Importações na janela Navegador.

Você pode adicionar propriedades e alias de propriedade aos arquivos WSDL referenciados no documento BPEL.

Para adicionar uma propriedade a um arquivo WSDL:

1. Na visualização Lógica BPEL da janela Navegador, clique com um botão direito do mouse em um arquivo WSDL no nó Importações e selecione Adicionar de propriedade no menu pop-up.
2. Na caixa de diálogo Criar nova propriedade de correlação, especifique o nome da propriedade.
3. Selecione o tipo de propriedade e clique em OK.

Para adicionar um alias de propriedade a um arquivo WSDL:

1. Na visualização Lógica BPEL da janela Navegador, clique com um botão direito do mouse em um arquivo WSDL no nó Importações e selecione Adicionar alias de propriedade no menu pop-up.
2. Na caixa de diálogo Criar novo alias de propriedade, clique em Explorar ao lado do campo Propriedade para especificar a propriedade.
3. Na caixa de diálogo Seletor de propriedades, selecione a propriedade para a qual um alias está sendo criado e clique em OK. O campo Tipo de propriedade da caixa de diálogo Criar novo alias de propriedade é preenchido com o tipo.
4. Na árvore Mapear propriedade para, expanda o nó do arquivo WSDL e selecione a mensagem ou parte da mensagem.
5. Para adicionar uma consulta, insira a string de consulta no campo de texto Consulta.
   Se a caixa de verificação Síncrono com a árvore estiver selecionada, o campo Consulta será atualizado cada vez que você alterar a seleção na árvore Mapear propriedade para.
6. Clique em OK.

Para obter mais informações sobre a definição de propriedades e os alias de propriedade com o editor WSDL, consulte o Gua do desenvolvedor para editor WSDL.

Recursos de navegação da visualização Design

Ao trabalhar com diagramas de larga escala, use os recursos de navegação fornecidos na visualização Design.

• Usando o modo Navegação para rolar pelo diagrama. Use o Modo navegação para rolar seu diagrama em qualquer direção. Esse recurso permite que você navegue em diagramas grandes. Clicar no ícone Modo de navegação na barra de ferramentas do editor ativa o Modo de navegação. Para retornar à edição do diagrama, clique no ícone Modo de edição .
  Quando você está no modo de edição, é possível pressionar e manter pressionada a barra de espaços em seu teclado para ativar o modo de navegação.
• Colocar mais e menos zoom no diagrama. O recurso zoom permite aumentar ou reduzir o tamanho do diagrama para obter uma visão mais próxima ou ver mais partes do diagrama em um tamanho reduzido. Você pode alterar o valor do zoom usando a lista suspensa Valor do zoom na barra de ferramentas do editor. Para escalonar o diagrama para que ele caiba na janela, clique em Ajustar diagrama. Para escalonar a largura do diagrama para que ele caiba na largura da janela, clique no botão Ajustar largura.
  Observe que o tamanho de escala mínimo é 33% e alguns diagramas grandes talvez não caibam inteiramente na janela.
• Usando a visualização Miniatura. A visualização Miniatura ajuda você a navegar rapidamente para outra parte do seu diagrama comercial. Essa visualização fornece uma representação em miniatura do seu diagrama completo. Para ativar a visualização Miniatura, clique no ícone da visualização Miniatura no canto direito inferior da visualização Design. A área de visualização atual é mostrada em um retângulo sombreado. Arraste o retângulo sombreado para o local necessário no diagrama.
• Rolando pelo diagrama durante a edição. Você pode rolar pelo diagrama ou passar pelos elementos usando o seguinte:
  • Girar a roda do mouse
  • Usar as barras de rolagem horizontais e verticais
  • Pressionar a tecla Tab ou Shift-seta para mover os elementos
• Usando faixas de erro. Você também pode clicar na faixa de erros próxima à barra de rolagem direita para saltar rapidamente para os locais específicos em seu diagrama. Essas faixas de erro indicam avisos, erros de validação, pontos de interrupção, status de validade e a seleção atual.

Operações com elementos na visualização Design

Na visualização Design, você pode realizar as operações seguintes nos elementos:

• Criar elementos arrastando-os da Paleta para o diagrama. A visualização Design suporta a noção de "pontos de soltura", o que significa que você deve alinhar os elementos com esses pontos de soltura quando os arrasta. Nem todos os elementos são criados via arrastar e soltar a partir da Paleta. Esses outros elementos são criados através de ações de menu de contexto, que são chamadas quando você clica com o botão direito do mouse em um elemento de diagrama existente.
• Selecionar elementos em um diagrama. Um único clique no elemento seleciona-o. A seleção é uma etapa necessária na realização de várias outras operações, tais como excluir, mover ou editar um elemento.
• Chamar ações de menu pop-up para elementos do diagrama. Cada elemento BPEL possui um menu pop-up. Esse menu pop-up pode ser chamado quando você clica com o botão direito do mouse no elemento. O menu pop-up oferecerá um conjunto de ações que são relevantes para o elemento selecionado.
• Mover elementos do diagrama. Você pode mover elementos do diagrama, selecionando-os e arrastando-os para um novo local. Se você mover um elemento de contêiner, todos os seus filhos serão movidos junto com o contêiner.
• Editar nomes de elemento diretamente na visualização Design. Clique duas vezes no nome do elemento no diagrama para editá-lo.
• Chamar validação de XML. Você pode chamar a validação de XML clicando no botão Validar XML na barra de ferramentas do editor da visualização Design. Para obter mais informações, consulte a seção Validando BPEL.
• Aplicar filtros a elementos do diagrama. A barra de ferramentas do editor contém os botões de alternância Mostrar links de parceiro e Mostrar seqüências. Os elementos Link de parceiro e Seqüência são mostrados por padrão. Clicar no botão Mostrar links de parceiro oculta os elementos Link de parceiro no diagrama. Clicar no botão Mostrar seqüências oculta os recipientes Seqüência no diagrama. Clicar em um dos botões uma segunda vez revelará os elementos Link de parceiro, ou os elementos Seqüência, no diagrama, respectivamente.
  Observação: não é possível adicionar novos elementos Link de parceiro ou Seqüência ao diagrama se você tiver optado por não mostrá-los.
• Localizando elementos no diagrama. Você pode localizar elementos BPEL na visualização Design por seus nomes ou tipos. Você pode usar a barra Localizar (Editar > Localizar ou Ctrl-F) ou o recurso Pesquisa avançada (Editar > Pesquisa avançada ou Alt-Shift-F). Na barra Localizar, selecione o tipo de pesquisa que você deseja realizar, digite a consulta de pesquisa e clique em Localizar. Na caixa de diálogo Pesquisa avançada, você pode refinar sua consulta de pesquisa e pesquisar elementos BPEL por nome e/ou tipo.
• Recolhendo ou expandindo elementos no diagrama. Quando um diagrama grande é aberto na visualização Design, você pode recolher ou expandir elementos de contêiner, tais como Seqüência ou Escopo, usando os botões de ação rápida que aparecem ao lado dos elementos selecionados. Por padrão, ao abrir um diagrama na visualização Design, você pode ver todos os elementos de contêiner expandidos. Para expandir todos os elementos no diagrama, clique no ícone Expandir tudo na barra de ferramentas do editor. Você pode usar as seguintes combinações de teclas: Enter para expandir o elemento selecionado, Shift-Enter para recolher o elemento selecionado e Alt-Enter para expandir todos os elementos no diagrama.
• Empacotando atividades com elementos contêiner. Você pode empacotar elementos com atividades contêiner em um único clique. O recurso de empacotamento pode ser útil, por exemplo, quando você coloca rapidamente uma atividade dentro de outra atividade. Na visualização Design, clique com o botão direito do mouse em uma atividade que deseja empacotar, aponte para a opção Empacotar com e selecione a atividade BPEL do empacotador.

Configurando as propriedades do elemento na visualização Design

Depois que você adiciona atividades BPEL a um diagrama, é preciso configurá-las. Você pode fazer isso usando as caixas de diálogo do editor de propriedades ou a janela Propriedades do IDE. Observe que as caixas de diálogo editor de propriedades estão disponíveis apenas para alguns elementos.

Para abrir o editor de propriedades de um elemento, adote um dos seguintes procedimentos:

• Clique com o botão direito do mouse no elemento e escolha Editar.
• Clique duas vezes no elemento.

Para abrir a janela Propriedades de um elemento, clique com o botão direito do mouse no elemento e escolha Propriedades. As propriedades desse elemento são exibidas na janela Propriedades padrão do IDE. Se a janela Propriedades do IDE não estiver aberta, escolha Janela > Propriedades no menu principal (Ctrl-Shift-7).

Salvando suas alterações

O BPEL Designer sincroniza as visualizações Design e Código-fonte da seguinte maneira:

• As alterações que você faz em um diagrama são refletidas imediatamente no código-fonte correspondente.
• As alterações que você faz no código-fonte são refletidas no diagrama quando você alterna para a visualização Design.

Para salvar alterações na visualização Design ou Código-fonte, escolha Arquivo > Salvar ou pressione Ctrl-S.

Imprimindo o código-fonte ou os diagramas

Você pode imprimir diagramas e arquivos de código-fonte BPEL e personalizar as configurações de impressão, incluindo bordas, cabeçalhos, rodapés, cores, números de linha e zoom, para que se adéqüem às suas preferências.

Para visualizar e imprimir um diagrama BPEL:

1. Abra um arquivo BPEL na visualização Design.
2. Escolha Arquivo no menu principal e selecione um dos seguintes comandos:
   • Imprimir. Imprime o diagrama BPEL.
   • Visualizar impressão. Visualiza o layout de impressão ou personaliza as opções de impressão.

Para imprimir um arquivo de código-fonte BPEL:

1. Abra um arquivo BPEL na visualização Código-fonte.
2. Escolha Arquivo no menu principal e selecione um dos seguintes comandos:
   • Imprimir. Imprime o arquivo.
   • Visualizar impressão. Visualiza o layout de impressão ou configura as definições de impressão.
   • Imprimir como HTML. Imprime o arquivo .bpel como um arquivo HTML.

Para personalizar opções de impressão:

1. No IDE, selecione um objeto que deseja imprimir.
2. Escolha Arquivo > Visualizar impressão.
3. Na janela Visualizar impressão, clique em Opções.
   A caixa de diálogo Opções de impressão se abre.
4. Altere as configurações de impressão para que se adéqüem às suas preferências:
   • Imprimir borda. Adiciona uma borda à página impressa. Clique no ícone Cor para alterar a cor da borda.
   • Configuração de página Especifica a orientação do papel, os tamanhos de margem e a impressora. Você também pode chamar a caixa de diálogo Configurar página, escolhendo Arquivo > Configurar página.
   • Imprimir cabeçalho e Imprimir rodapé. Especifica o texto, alinhamento, cor e fonte do cabeçalho e rodapé. Para ocultar o cabeçalho ou rodapé, desmarque as caixas de verificação Imprimir cabeçalho ou Imprimir rodapé, respectivamente. Para especificar o texto padrão do cabeçalho ou rodapé, clique no campo correspondente ao alinhamento (Esquerdo, Centro ou Direito) e selecione um dos botões abaixo.
     Por exemplo, para adicionar um número de página no canto esquerdo inferior, marque a caixa de verificação Imprimir rodapé, clique no campo Esquerdo e clique no ícone do "número de página". Clique nos ícones Escolher cor do rodapé e Escolher fonte do rodapé para modificar a cor e a fonte do cabeçalho ou rodapé da página.
   • Números de linha. Especifica se devem ser impressos os números de linha dos arquivos de código-fonte.
   • Quebrar linhas Quebra as linhas para que ajustem à página.
   • Cor do texto e Segundo plano do texto. Especifica a cor e o segundo plano do texto quando você está imprimindo, por exemplo, arquivos de código-fonte.
   • Zoom. Especifica a escala do texto ou diagrama impresso na página. Você pode selecionar para ajustar a largura ou a altura ou escolher uma escala de zoom específica.
5. Clique em OK.

Engenharia reversa

Você pode usar o BPEL Designer para editar o código-fonte diretamente e ter essas alterações refletidas na visualização Design.

Talvez você precise editar a fonte nos seguintes casos:

1. Se você desejar usar uma extensão BPEL específica de um fornecedor, que não faça parte do conjunto de elementos BPEL padrão, use a visualização Código-fonte.
2. Se você precisar adicionar uma construção BPEL para a qual a visualização Design não fornece uma oportunidade de geração de código. Existem algumas construções BPEL de caso crítico, como a atribuição de XML estático a uma variável, que não são exibidas nas caixas de diálogo dos editores de propriedades atuais.
3. Se, ao usar a visualização Código-fonte, você modificar e salvar uma fonte BPEL mal formada, a visualização Design não poderá renderizar um diagrama para esse BPEL "quebrado". A visualização Design exibirá uma página que diz "Impossível mostrar o diagrama". Retorne para a visualização Código-fonte para corrigir o erro, após a correção, execute o validador de XML na visualização Código-fonte para validar as suas alterações. Quando você tiver restaurado a fonte BPEL para um estado válido, a visualização Design poderá novamente processar o diagrama.

Configurando fluxos de mensagens

As atividades são elementos do diagrama que representam as atividades BPEL envolvidas no fluxo de mensagens.

Um fluxo de mensagem é a linha pontilhada que conecta uma atividade do serviço Web (Chamar, Receber, Responder) às suas atividades correspondentes em um link de parceiro. Essa relação é chamada de fluxo de mensagens, já que ela designa o fluxo de informações para e do processo.

Se você configurar completamente a atividade do serviço Web por sua respectiva janela Propriedades, o IDE processará um conector do fluxo de mensagens entre uma atividade e uma atividade de parceiro.

Entretanto, você também pode desenhar diretamente um fluxo de mensagens. Para fazê-lo:

1. Selecione uma atividade de serviço Web. Um pequeno envelope é exibido no lado esquerdo do ícone da atividade.
2. Comece a arrastar o envelope. O IDE exibe uma linha pontilhada que vincula a atividade de origem ao envelope que você está arrastando.
3. Mova o seu mouse para a atividade de destino. Se a atividade de destino corresponder à de origem, o cursor indicará, e você poderá soltar o mouse. A conexão se encaixa entre as atividades.

Observe que você não pode excluir diretamente um fluxo de mensagens. Você pode excluir indiretamente um fluxo de mensagens, cancelando a definição de algumas propriedades na atividade de serviço Web. Geralmente, entretanto, você irá alterar um fluxo de mensagens para criar uma relação diferente.

Observe também que a ferramenta de desenho funciona somente em uma direção: de uma atividade de serviço Web dentro do processo BPEL para sua atividade correspondente em um link de parceiro.

Alterando o fluxo de mensagem

Se você quiser alterar uma conexão de fluxo de mensagens existente e estabelecer uma nova conexão com uma atividade de destino diferente, proceda como se você estivesse fazendo uma conexão pela primeira vez com o par preferido. Quando você cria o novo par, o IDE remove automaticamente a conexão antiga.

Elementos da Paleta do

A tabela seguinte lista os elementos básicos exibidos na Paleta. Nem todos os elementos BPEL estão na Paleta; alguns são criados quando você clica com o botão direito do mouse no diagrama e escolhe as ações apropriadas nos menus pop-up.

Você pode usar o Gerenciador de paleta para ativar, desativar e reorganizar os elementos da Paleta. Para abrir o Gerenciador da Paleta, clique com o botão direito do mouse dentro da Paleta e escolha Gerenciador da Paleta.

Os elementos são dos seguintes tipos:

• Serviço Web. Elementos usados para trocar mensagens em forma de conversação com um serviço Web de parceiro.
• Atividades básicas. Atividades que realizam uma determinada tarefa.
• Atividades estruturadas. Elementos usados para ordenar precisamente os conjuntos de atividades. As atividades estruturadas podem conter outras atividades.

Ícone	Elemento	Definição
Serviço Web
	Chamar	Permite que o processo comercial chame uma operação unidirecional ou de solicitação-resposta em um portType oferecido por um parceiro; permite que esse processo envie mensagens aos parceiros. A operação é definida no WSDL do parceiro.
	Receber	Permite que o processo comercial realize uma espera de bloqueio da chegada de uma mensagem específica.
	Link de parceiro	Identifica os serviços Web que trocarão mensagens com nosso processo comercial. Cada link de parceiro poderá conter elementos filhos que correspondem às atividades do serviço Web disponíveis aceitas pela interface do link desse parceiro. Observação: você não pode adicionar elementos diretamente a um contêiner de link de parceiro. A visualização Design observará o WSDL do parceiro e preencherá automaticamente o contêiner do link de parceiro com os elementos filhos apropriados. Se você precisar modificar um link de parceiro, edite os arquivos WSDL do parceiro, que permitirão que a visualização Design processe novamente o link de parceiro e, portanto, reflita a interface modificada.
	Responder	Permite que o processo comercial envie uma mensagem em resposta a uma mensagem recebida através de Receber.
Atividades básicas
	Vazio	Uma atividade que não faz nada. É útil quando você precisa interceptar e eliminar uma falha.
	Aguardar	Aguarda até um determinado ponto no tempo ou uma duração especificada.
	Lançar	Gera uma falha dentro do processo comercial.
	Atribuir	Atualiza os valores de variáveis com novos dados.
	Sair	Termina imediatamente a execução da instância do processo comercial.
Atividades estruturadas
	Fluxo	Especifica uma ou mais atividades a serem realizadas simultaneamente.
	Seqüência	Define uma coleção de atividades a serem realizadas seqüencialmente, em ordem lexical.
	If	Seleciona uma ramificação de atividade em um conjunto de opções.
	Selecionar	Bloqueia e aguarda que uma mensagem adequada chegue, ou que um tempo de espera expire. Quando um evento especificado no corpo de Selecionar ocorrer, a atividade Selecionar será concluída. Apenas uma das atividades no corpo de Selecionar ocorre realmente.
	Escopo	Define uma atividade aninhada com suas próprias variáveis locais associadas, manipuladores de falhas e de eventos e troca de mensagens.
	While	Repete uma atividade enquanto uma condição for verdadeira. A condição é verificada antes da execução da atividade.
	Repetir até	Repete uma atividade até que uma condição seja verdadeira. É diferente de While porque a condição é verificada após a execução.
	Para cada	Repete uma atividade exatamente N+1 vezes, onde N é igual ao Valor final do contador menos o Valor inicial do contador.