Esta seção explora os recursos do BPEL Designer, que permite que você crie visualmente um diagrama de processo que será gerado automaticamente no código-fonte BPEL compatível com a especificação WS-BPEL 2.0.
A visualizações do editor BPEL
No editor BPEL você pode alternar entre as visualizações Código-fonte, Design, Mapeador e Registro. Todas as visualizações são sempre mantidas em sincronia.
Exibiçã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 as exceções listadas 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-D).
Visualização Mapeador
O mapeador BPEL fornece uma estrutura para processar e direcionar dados do processo BPEL. O mapeador BPEL pode ser usado para atribuir valores ou para definir condições. Para alternar para a visualização Mapeador, pressione Ctrl-Shift-F9 ou clique na aba Mapeador na barra de ferramentas do editor. Para obter mais informações, consulte a seção O mapeador BPEL.
Visualização Registro
A visualização Registro fornece o recurso de definir as regras de registro ou de alerta do processo. Para alternar para a visualização Registro, pressione Alt-L ou clique na aba Registro na barra de ferramentas do editor. Para obter mais informações, consulte a seção Registro e alerta.
O recurso Clonar documento é uma opção de personalização que permite que você clone as visualizações de documentos. Por exemplo, se você quiser ver a visualização código-fonte e a visualização design de um processo BPEL ao mesmo tempo (ou a visualização Design e Mapeador), siga as instruções abaixo.
Várias visualizações de um documento são sempre mantidas em sincronia.
Para clonar a visualização do documento:
Abra o arquivo BPEL
Clique com o botão direito do mouse na aba com o nome do arquivo e escolha Clonar documento. Outra aba com o mesmo documento será criada.
Arraste e solte uma das abas para a localização desejada: esquerda, direita ou parte inferior da tela. Um quadro laranja mostrará onde a janela que você está arrastando será colocada.
A janela Navegador é um complemento do BPEL Designer. Se a janela Navegador não estiver visível, você poderá chamá-la manualmente, selecionando Janela > Navegação > Navegador no menu principal ou usando a combinação de teclas Ctrl-7.
A janela Navegador fornece duas visualizações distintas do processo BPEL: visualização Lógica BPEL e visualização XML. Você pode alternar entre a visualização XML e a visualização Lógica BPEL usando o menu suspenso na parte superior da janela Navegador.
Visualização XML da janela Navegador
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 da janela Navegador
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:
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.
Na caixa de diálogo Criar nova importação, selecione o arquivo na estrutura do projeto para adicioná-lo como importação.
Observação - 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.
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.
Para adicionar uma propriedade a um arquivo WSDL:
Na janela Navegador, você pode adicionar propriedades e alias de propriedade aos arquivos WSDL referenciados no documento BPEL.
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.
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:
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.
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 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.
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 Guia do desenvolvedor para editor WSDL.
A janela Propriedades
A janela Propriedades contém as informações de propriedade do elemento selecionado no momento do processo. Use a janela Propriedades do IDE para configurar todas as propriedades do elemento BPEL. O conteúdo da janela Propriedades difere dependendo do elemento ativo do processo. Existem apenas dois campos permanentes da janela Propriedades disponível para cada elemento:
Nome. Mostra o nome do elemento.
Documentação. Contém comentários associados ao elemento. Para obter mais informações, consulte a seção Documentação.
Para abrir a janela Propriedades, escolha Janela > Propriedades ou pressione Ctrl-Shift-7.
Rolagem
Quando você abre um arquivo BPEL na janela Projetos, o diagrama abre na visualização de edição da visualização Design por padrão. Nessa visualização, você pode editar o diagrama e rolá-lo. O modo de edição é ativado quando o modo Navegação é selecionado na barra de ferramentas do editor.
Na visualização de edição, você pode rolar o diagrama usando os seguintes métodos:
Girar a roda do mouse
Usar as barras de rolagem horizontais e verticais
Pressionar a tecla Tab para mover os elementos
Mais zoom e menos zoom
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.
Para alterar a escala, faça o seguinte:
Clique em Mais zoom ou Menos zoon na barra de ferramentas.
Clique no botão Ajustar diagrama na barra de ferramentas para escalonar o diagrama para se ajustar à janela.
Clique no botão Ajustar largura na barra de ferramentas para escalonar o diagrama para se ajustar à janela.
Ative o modo Navegação na barra de ferramentas, em segudia, você pode colocar zoom ou retirar o zoom usando a roda do mouse.
Imprimindo diagramas e arquivos de origem BPEL
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 ou arquivo de código-fonte:
Abra um arquivo BPEL na visualização Design.
Escolha Arquivo no menu principal e selecione um dos seguintes comandos:
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:
No IDE, selecione um objeto que deseja imprimir.
Na janela Visualizar impressão, clique em Opções de impressão. A caixa de diálogo Opções de impressão se abre.
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.
Imprimir cabeçalho e Imprimir rodapé. Especifica texto, alinhamento, cor e fonte do cabeçalho e do rodapé. Para ocultar o cabeçalho ou rodapé, desmarque as caixas de seleçã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 inferior esquerdo, selecione a caixa de verificação Imprimir rodapé, clique no campo Esquerdo e clique no ícone "Número da 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. Wraps the lines to fit them on the page.
Imprimir como no editor. A página impressa se parecerá com o que você vê no editor.
Fonte e cor do texto. Especifica a cor e a fonte do texto quando você está imprimindo, por exemplo, arquivos de código-fonte.
Cor de segundo plano. Especifica a cor do segundo plano.
Espaçamento de linha. Especifica o valor do espaçamento de linha.
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.
Clique em OK.
Para personalizar as configurações de página:
No IDE, selecione um objeto que deseja imprimir.
Escolha Arquivo > Visualizar impressão.
Na janela Visualizar impressão, clique em Configuração de página. A caixa de diálogo Configuração de página se abre.
Você também pode chamar a caixa de diálogo Configurar página, escolhendo Arquivo > Configurar página.
Na página Configuração de página, especifique os seguintes parâmetros:
Tamanho do papel
Origem do papel
Orientação do papel
Tamanhos de margem
Clique no botão Impressora e especifique a impressora.
