Exibição Design

A exibição Design é o designer visual dos processos comerciais. Nessa exibição, o autor do processo comercial pode modelá-lo visualmente. O BPEL Designer gera automaticamente o código BPEL que corresponde ao design visual. A notação usada no designer visual é parcialmente baseada na BPMN (Business Process Modeling Notation).

Exibição Fonte

A exibição Fonte é o editor do arquivo de origem BPEL. Na exibição Fonte, o autor do processo comercial pode editar textualmente o código-fonte do processo comercial. Você pode realizar a edição no nível do código-fonte, assim como no design visual. O projeto BPEL realizará a engenharia bidirecional de ida e volta para garantir que a exibição Design e a exibição Fonte permaneçam sincronizadas entre si.

O IDE analisará de novo o arquivo de origem BPEL automaticamente e reconstruirá o diagrama toda vez que você realizar edições manuais no arquivo de origem.

Exibição XML

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

Exibição Lógica

O navegador também oferece uma exibição Lógica do processo BPEL. A exibição Lógica do navegador é um complemento da exibição Design do BPEL. Quando você seleciona elementos visuais na exibição Design, a exibição Lógica do navegador mostra o mesmo elemento selecionado. Como alternativa, quando você seleciona um nó na árvore da exibição Lógica, o elemento correspondente é selecionado no diagrama.

Clicar com o botão direito do mouse nos nós da exibição Lógica chama os menus pop-up com ações relevantes para o nó específico. Por exemplo, para o elemento Atribuir, as ações são Ir para origem, Alternar ponto de interrupção, Excluir e Propriedades. As ações Ir para origem e Excluir, disponíveis para a maioria dos nós, possuem atalhos de teclado associados: Alt+O para Ir para origem e Del para Excluir.

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.

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. Para adicionar outra referência a um arquivo XSD ou WSDL, clique com o botão direito do mouse no nó e escolha Adicionar importação no menu pop-up. Somente arquivos localizados na pasta do projeto podem ser referenciados. Depois da operação, uma nova linha <import> é adicionada ao arquivo BPEL.

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

Para adicionar uma propriedade a um arquivo WSDL:

• Clique com o botão direito do mouse no arquivo WSDL no nó Importações e escolha Adicionar propriedade no menu pop-up.
• Na caixa de diálogo Criar nova propriedade de correlação, especifique o nome da propriedade.
• Selecione o tipo de propriedade e clique em OK.

Para adicionar um alias de propriedade a um arquivo WSDL:

• Clique com o botão direito do mouse no arquivo WSDL no nó Importações e selecione Adicionar alias de propriedade no menu pop-up.
• Na caixa de diálogo Criar novo alias de propriedade, clique em Explorar ao lado do campo Propriedade para especificar a propriedade.
• 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.
• Na árvore Mapear propriedade para, expanda o nó do arquivo WSDL e selecione a mensagem ou parte da mensagem.
• Para adicionar uma consulta, insira a seqüência de consulta no campo de texto Consulta.
• Clique em OK.

Para obter mais informações sobre a definição de propriedades e alias de propriedade com o editor WSDL, consulte Definindo propriedades e alias de propriedade.

Visual Designer

Na exibição Design, você pode realizar muitas tarefas que compõem o que chamamos Engenharia avançada:

• Criar elementos, conexões e estruturas de atividade em um diagrama. Arraste os elementos da Paleta para o diagrama. O Visual Designer aceita a noção de "pontos de soltura", o que significa que você deve alinhar os elementos com esses pontos de soltura ao arrastá-los. 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. O elemento é selecionado com único clique. A seleção é uma etapa necessária na realização de várias outras operações, tais como excluir, mover ou editar um elemento.
• Exibir e modificar as propriedades do elemento do diagrama. Todos os elementos possuem propriedades. Quando você selecionar um elemento, a janela Propriedades padrão do NetBeans mostrará as propriedades específicas desse elemento. Alguns elementos BPEL possuem editores de propriedades mais complexos, que são mostrados em uma caixa de diálogo pop-up modal. O editor de propriedades modal pode ser chamado de várias formas para aqueles elementos que aceitam tal editor. Você pode clicar duas vezes no elemento visual e o editor de propriedades modal será exibido. Como alternativa, você pode clicar com o botão direito do mouse no elemento e escolher Editar no menu pop-up e o editor de propriedades modal será exibido. Nem todos os elementos BPEL possuem editores de propriedades pop-up modais. Para aqueles elementos que não possuem editores de propriedades pop-up modais, você deve apenas usar a janela Propriedades padrão do NetBeans para ajustar as propriedades do elemento. A janela Propriedades também pode ser chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades no menu pop-up.
• Realizar ações de menu pop-up nos 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.
• Salvar alterações do diagrama. Ao fazer alterações no digrama que criou e/ou modificou, você pode salvá-las.
• Reabrir diagramas salvos. Você pode reabrir quaisquer diagramas que salvou ao clicar duas vezes no arquivo de origem BPEL correspondente na janela Projetos.
• 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 recipiente, todos os seus filhos serão movidos junto com o recipiente.
  • Nesta versão, você não pode selecionar vários elementos e movê-los ao mesmo tempo. A exceção é a declaração acima, em que você pode mover um único elemento de recipiente e todos os seus filhos.
• Imprimir fonte ou diagramas. Você pode imprimir a fonte BPEL e o diagrama BPEL. Para imprimir o diagrama BPEL, a exibição Design do BPEL deve estar aberta. Para imprimir a fonte, a exibição Fonte do BPEL deve estar aberta. Para imprimir, chame os comandos Arquivo > Imprimir ou Arquivo > Visualizar impressão no menu principal.
• Aumentar e diminuir o zoom do diagrama. Você pode mover o controle deslizante do zoom na barra de ferramentas do editor para reduzir ou aumentar o tamanho do diagrama. Para exibir o diagrama inteiro, clique no botão Ajustar diagrama. Para exibir a largura total do diagrama, clique no botão Ajustar largura.
• Editar nomes de elemento diretamente no diagrama do Visual Designer. 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 exibição Design. Para obter mais informações, consulte a seção Validação.
• Aplicar filtros nos elementos do diagrama. A barra de ferramentas do editor da exibição Design contém os botões de alternância Mostrar links de parceiro e Mostrar seqüências. Ambos os elementos PartnerLink e Seqüência são mostrados por padrão. Clicar no botão Mostrar links de parceiro oculta os elementos PartnerLink 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 PartnerLink, 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 tiver optado por não mostrá-los.

Usando o Visual Designer

Quando você usar o Visual Designer, tenha o seguinte em mente:

• Há atalhos de teclado disponíveis no Visual Designer. Os atalhos de teclado incluem:
  • A tecla Del é equivalente a chamar o comando Excluir no menu pop-up e remove o elemento selecionado no momento.
  • A tecla Esc cancela uma operação arrastar e soltar atual.
  • A combinação de teclas Alt+O abre a fonte do arquivo BPEL e coloca o cursor na primeira linha de código correspondente ao elemento do diagrama selecionado.
• Uma operação pode ser usada por muitas atividades.
• Quando um diagrama é grande e não cabe nos limites da porta de exibição atual, você pode arrastar os elementos para um espaço reservado que esteja fora dos limites da porta de exibição. O diagrama rola quando você arrasta um elemento.
• Você pode usar a roda do mouse ou as teclas de seta para rolar um diagrama.
• Você pode usar o Gerenciador de paleta para ativar, desativar e reorganizar os elementos da Paleta. O Gerenciador de paleta é chamado quando você clica com o botão direito do mouse em Paleta e escolhe Gerenciador de paleta.

Integridade referencial

Observe que o Visual Designer aceita automaticamente a integridade referencial no Visual Designer mas não no Editor de fontes.

Definindo propriedades de elemento e de atividade

As propriedades podem ser definidas para todos os elementos por meio dos editores de propriedades ou da janela Propriedades.

Para abrir o editor de propriedades de um elemento,

• Clique com o botão direito do mouse no elemento e escolha Editar, ou
• 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.

A janela Propriedades padrão do NetBeans corresponde ao elemento selecionado. Se a janela Propriedades padrão do NetBeans não estiver aberta, escolha Janela > Propriedades no menu principal (Ctrl-Shift-7).

Salvando suas alterações

O BPEL Designer sincroniza as exibições Design e 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 exibição Design.

Engenharia reversa

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

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 o editor de fontes.
2. Se você precisar adicionar uma construção BPEL para a qual a exibiçã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 cobertas pelos editores de propriedades atuais.
3. Se, ao usar o editor de fontes, você modificar e salvar uma fonte BPEL mal formada, a exibição Design não poderá processar um diagrama para esse BPEL "quebrado". A exibição Design exibirá uma página que diz "Impossível mostrar o diagrama". Retorne para o editor de fontes para corrigir o erro, após a correção, execute o validador de XML no editor de fontes para validar as suas alterações. Quando você tiver restaurado a fonte BPEL para um estado válido, a exibiçã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 da 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 da 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 da 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 da 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 em apenas uma direção: de uma atividade de serviço da Web no 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 Visual Designer

A tabela seguinte lista os elementos básicos exibidos na Paleta de orquestração. 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.

Os elementos são dos seguintes tipos:

• Serviço da Web: Elementos usados para trocar mensagens em forma de conversação com um serviço da 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 da 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.
	PartnerLink	Identifica os serviços da Web que trocarão mensagens com nosso processo comercial. Cada link de parceiro poderá conter elementos filhos que correspondem às atividades do serviço da Web disponíveis aceitas pela interface do link desse parceiro. Observação: Você não pode adicionar elementos diretamente a um recipiente de link de parceiro. A exibição Design observará o WSDL do parceiro e preencherá automaticamente o recipiente 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 exibiçã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.
	RepeatUntil	Repete uma atividade até que uma condição seja verdadeira. É diferente de While porque a condição é verificada após a execução.
	ForEach	Repete uma atividade exatamente N+1 vezes, onde N é igual ao Valor final do contador menos o Valor inicial do contador.