O elemento Chamar permite que o processo comercial chame uma operação unidirecional ou de solicitação-resposta em um portType oferecido por um parceiro. Ele permite que o processo comercial envie mensagens para parceiros. A operação é definida no arquivo WSDL do parceiro.
Uso
Na visualização Design, arraste o elemento Chamar da Paleta para o diagrama.
Realize um dos seguintes procedimentos para associar o elemento Chamar a um elemento Link de parceiro:
Desenhe diretamente um fluxo de mensagem a partir do elemento Chamar para o Link de parceiro de destino.
clique duas vezes no elemento Chamar. É aberta uma caixa de diálogo onde você pode examinar ou alterar o seguinte:
O nome do elemento Chamar.
O link de parceiro que é chamado.
A operação associada ao elemento Chamar.
A variável de entrada associada ao elemento Chamar.
A variável de saída.
As variáveis de entrada e de saída podem ser criadas ou navegadas nesta caixa de diálogo.
Na caixa de diálogo Editor de propriedades, você pode criar uma variável existente para conter dados de entrada e de saída. Clique no botão Criar para criar uma variável para o elemento Chamar, e clique em Explorar para escolher uma variável existente.
Observe que quando você clica no botão Explorar, a caixa de diálogo Seletor de variáveis de entrada ou Seletor de variáveis de saída se abre. Nessas caixas de diálogo, uma marca de seleção com a opção para mostrar variáveis com os tipos apropriados aparece. Essa caixa de verificação restringe a lista de variáveis disponíveis que são do tipo apropriado para a atividade que você está configurando. Dessa forma, a visualização Design ajuda você a desenvolver um código BPEL válido.
Correlações
Os conjuntos de correlações nas atividades de chamada, que lidam com operações externas, são usados para validar as mensagens de saída que contêm dados compatíveis com os dados contidos nas instâncias especificadas do conjunto de correlações.
A aba Correlações na caixa de diálogo Chamar editor de propriedades permite que você examine ou especifique um conjunto de correlações.
A aba mostra:
Nomes dos conjuntos de correlações
A iniciação de um correlator
O padrão associado à correlação
Você pode adicionar um conjunto de correlações clicando no botão Adicionar.
Definindo um conjunto de correlações e Adicionando um conjunto de correlações a um elemento
Correlação é o meio pelo qual o tempo de execução BPEL controla as conversações entre uma instância de processo específica e as instâncias correspondentes dos respectivos serviços de parceiro. Você pode considerar a correlação como uma chave principal usada pelo tempo de execução BPEL para correlacionar mensagens de entrada e de saída, e roteá-las corretamente.
Um conjunto de correlações é uma coleção de propriedades usadas pelo tempo de execução BPEL para identificar o processo correto a receber a mensagem. Cada propriedade no conjunto de correlações pode ser mapeada para um elemento em um ou mais tipos de mensagem através de alias de propriedade.
Para definir um conjunto de correlações, as mensagens dos serviços de parceiro devem ter propriedades e alias de propriedades definidos no arquivo WSDL do parceiro. Você pode adicionar propriedades e alias de propriedades a um arquivo WSDL usando o editor WSDL ou o navegador.
Depois que as propriedades e os alias de propriedades forem adicionados ao arquivo WSDL associado ao projeto, você pode definir conjuntos de correlações do elemento Processo.
Para definir um conjunto de correlações:
Na visualização Design, clique com o botão direito do mouse no elemento Processo e escolha Adicionar > Conjunto de correlações. A caixa de diálogo Adicionar conjunto de correlações se abre.
Altere o nome do conjunto de correlações e clique em Adicionar para adicionar propriedades.
Na caixa de diálogo Seletor de propriedades, expanda o nó do arquivo WSDL, selecione uma propriedade para adicionar ao conjunto, e clique em OK.
Observe que por padrão, a caixa de diálogo Seletor de propriedades mostra apenas os arquivos que já foram referenciados no processo. Entretanto, o projeto pode conter outros arquivos .wsdl e .xsd que ainda não foram importados para o processo. Se você selecionar uma propriedade que seja definido em um arquivo não-importado, o IDE adicionará automaticamente a importação necessária ao processo BPEL.
Depois de definir um conjunto de correlações, como destacado acima, adicione o mesmo aos elementos Chamar, Receber ou Responder. Você também pode associar um conjunto de correlações à ramificação On Message de uma atividade Selecionar e ao elemento On Event de um contêiner Manipuladores de eventos.
A seguir é mostrado um conjunto de correlações, conforme visto no navegador.
Para adicionar um conjunto de correlações a um elemento:
Na visualização Design, clique duas vezes em um elemento (Chamar, Receber, Responder, na ramificação On Message de Selecionar ou no elemento On Event de um contêiner Manipuladores de eventos).
Na caixa de diálogo Editor de propriedades, selecione a aba Correlações e clique em Adicionar.
Na caixa de diálogo Escolher um conjunto de correlações, selecione o conjunto de correlações e clique em OK.
Escolha o atributo iniciar deste conjunto de correlações na lista suspensa Iniciar. Você pode selecionar uma das seguintes opções:
Sim. A atividade deve tentar iniciar o conjunto de correlações.
Unir. A atividade deve tentar iniciar o conjunto de correlações caso o mesmo ainda não tenha sido iniciado.
No. A atividade não deve tentar iniciar o conjunto de correlações. Esta é a opção padrão.
Especifique o padrão de mensagem, que podem ser operações solicitação, resposta ou solicitação-resposta.
O elemento Receber permite que o processo comercial espere que uma mensagem específica chegue.
Uso
Na visualização Design, arraste o elemento Receber da Paleta para o diagrama.
Clique duas vezes no elemento Receber (ou clique com o botão direito do mouse e escolha Editar) para configurar suas propriedades. Eis aqui o exemplo fornecido para a amostra Serviço de reserva de viagens:
O nome do elemento Receber (ReceiveItinerary).
O link de parceiro (Travel).
A operação associada ao elemento Receber (buildItinerary).
A variável de entrada do elemento Receber (ItineraryIn).
Selecione Explorar para que a variável de entrada abra o seletor de variável de entrada, onde você pode escolher outras variáveis associadas a este processo. Selecione Criar para criar uma nova variável.
Criar instância. Se selecionada, uma instância do processo BPEL será iniciada quando uma mensagem associada chegar. Observe que a atividade Receber é a primeira atividade em seu processo comercial, a caixa de verificação Criar instância deve ser selecionada.
Clicar com o botão direito do mouse no elemento Receber e escolher Propriedades abre uma janela Propriedades, que, além dos itens listados no editor de propriedades de Receber, inclui o seguinte:
Tipo de porta. O valor do campo Tipo de porta é preenchido quando você especifica o link de parceiro e a operação.
Correlações
A aba Correlações na caixa de diálogo Editor de propriedades de Receber permite que você examine ou especifique um conjunto de correlações.
Use esta atividade para retornar uma mensagem do processo para o mesmo parceiro que iniciou a operação. A combinação de atividades Receber e Responder cria uma operação de solicitação-resposta.
Esta atividade é usada em uma operação síncrona (solicitação/resposta), e especifica o mesmo parceiro, tipo de porta e operação da atividade Receber que chamou o processo.
Uso
Na visualização Design, arraste o elemento Responder da Paleta para o diagrama.
Clique duas vezes no elemento Responder (ou clique com o botão direito do mouse e escolha Editar) para abrir uma caixa de diálogo Editor de propriedades do elemento Responder. Nessa caixa de diálogo, é possível fazer o seguinte:
O nome do elemento.
O link de parceiro.
A operação.
Tipo de resposta: Resposta normal ou Resposta de falha.
Selecione Reposta normal se o elemento Responder for usado para o tipo de mensagem de resposta normal. Opcionalmente, especifique a variável de saída: crie uma nova variável de saída ou procure por uma variável existente.
Selecione Resposta de falha, se o elemento Responder for usado para enviar uma mensagem de falha. Escolha um nome de falha, opcionalmente, especifique a variável da falha: crie uma nova variável da falha ou procure por uma variável existente.
Clicar com o botão direito do mouse no elemento Responder e escolher Propriedades abre uma janela Propriedades, que, além dos itens listados na caixa de diálogo Editor de propriedades, inclui o seguinte:
Tipo de porta. O valor do campo Tipo de porta é preenchido quando você especifica o link de parceiro e a operação.
Correlações
A aba Correlações no Editor de propriedades de Responder permite que você examine ou especifique um conjunto de correlações.
Os elementos Link de parceiro identificam as partes que interagem com o seu processo comercial. Cada link é definido por um tipo de link de parceiro e um nome de função.
Tipos de link de parceiro e funções
O tipo determina a relação entre um processo e seus parceiros, definindo as funções executadas por cada serviço em uma conversação. A relação é determinada pela especificação do tipo de porta fornecido por cada serviço para receber mensagens. Cada função especifica um tipo de porta no arquivo WSDL.
As funções determinam o aspecto de conversação deste processo ou seu parceiro. Você usa uma única função para uma operação síncrona, já que os resultados são retornados por meio da mesma operação. Você usa duas funções em uma operação assíncrona, já que a função de parceiro se altera durante um retorno de chamada.
Entretanto, é fácil confundir os links de parceiro e os tipos de link de parceiro:
Os tipos de link de parceiro e as funções são extensões WSDL especiais definidas pela especificação BPEL. Sendo assim, eles são definidos em arquivos WSDL, não no arquivo do processo BPEL.
Link de parceiro é um elemento BPEL 2.0. Ele é definido no arquivo do processo BPEL.
Os tipos de link de parceiro são pré-requisitos para a definição do elemento Link de parceiro. Um elemento Link de parceiro pode ser definido somente com referência a um determinado tipo de link de parceiro e função que, como mencionado, devem ser definidos no arquivo WSDL.
Uso
Para adicionar o elemento Link de parceiro ao processo BPEL, adote um dos seguintes procedimentos:
Arraste o elemento Link de parceiro da Paleta para o diagrama.
Arraste um nó de arquivo WSDL do mesmo projeto na janela Projetos para o diagrama.
Arraste um nó de arquivo WSDL de um projeto diferente na janela Projetos para o diagrama.
Arraste um nó de serviço Web de um projeto EJB ou projeto de aplicação Web na janela Projetos para o diagrama.
Observação: quando você arrasta o nó de serviço Web, o BPEL Designer recupera o arquivo WSDL do servidor da aplicação. Para que a recuperação do arquivo WSDL seja bem-sucedida, o servidor da aplicação tem que estar em execução e o projeto de serviço Web deve estar implantado.
Quando você arrasta o elemento Link de parceiro, um nó de arquivo WSDL ou um nó de serviço Web para o diagrama, o editor de propriedades do link de parceiro é exibido.
O Editor de propriedades do link de parceiro
A caixa de diálogo Editor de propriedades do link de parceiro permite que você estabeleça links de parceiro para seus processos BPEL.
O editor de propriedades do link de parceiro é chamado quando você clica duas vezes em um elemento Link de parceiro no diagrama, ou quando clica com o botão direito do mouse no elemento Link de parceiro e escolhe Editar. O editor de propriedades do link de parceiro também é exibido quando você arrasta o elemento Link de parceiro, um nó de arquivo WSDL ou um nó de serviço Web para o diagrama.
Com o editor de propriedades do link de parceiro, você pode especificar:
O nome do link de parceiro
O arquivo WSDL associado ao link de parceiro
Mais tarde, você poderá optar entre usar o tipo de link de parceiro existente ou criar um novo tipo de link de parceiro.
Se o arquivo WSDL que você selecionou contiver tipos de link de parceiros, a opção Usar tipo de link de parceiro existente será selecionada e a lista suspensa Tipo de link de parceiro será preenchida com os tipos de link encontrados no arquivo WSDL. Você pode usar um dos tipos de link de parceiro existentes ou selecionar a opção Usar um tipo de link de parceiro recém-criado para criar um novo tipo de link de parceiro.
Se o arquivo WSDL não contiver os tipos de link de parceiro, a opção Usar um tipo de link de parceiro recém-criado será selecionada.
Usar tipo de link de parceiro existente
Escolha o tipo de link de parceiro na lista suspensa. Os campos Minha função e/ou Função do parceiro são preenchidos automaticamente.
Para trocar as funções do próprio processo comercial (Minha função) e do parceiro (Função do parceiro), clique no botão Trocar funções.
Usar um tipo de link de parceiro recém-criado
Especifique o arquivo WSDL ao qual adicionar um tipo de link de parceiro. Você pode adotar um dos seguintes procedimentos:
Adicione o tipo de link de parceiro ao arquivo WSDL do empacotador, conforme sugerido pelo IDE no campo Criar no arquivo por padrão. Se você escolher essa opção, o IDE criará automaticamente o arquivo WSDL do empacotador na estrutura do projeto. Você pode usar os arquivos WSDL do empacotador quando o arquivo WSDL original for somente leitura ou quando não quiser modificar o arquivo WSDL original. O arquivo WSDL original será importado para o arquivo WSDL recém-criado do empacotador.
Adicione o tipo de link de parceiro a um arquivo WSDL em seu projeto. Clique em Procurar e localize o arquivo WSDL ao qual adicionar o tipo de link de parceiro.
Especifique o nome do tipo de link de parceiro.
Especifique a função do próprio processo comercial (Minha função) e/ou a função do parceiro (Função do parceiro) da seguinte forma:
Marque a caixa de verificação apropriada.
Especifique o nome da função.
Escolha o tipo de porta na lista suspensa.
Também é possível consultar e modificar as propriedades de link de parceiro na janela Propriedades chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades.
O elemento Vazio não tem operação associada a ele. É usado geralmente como um espaço reservado em um processo, para interceptar e eliminar falhas, ou para ajudar a sincronizar as ações em uma atividade de fluxo que estão sendo executadas no momento.
O elemento Vazio pode ser usado quando outra pessoa estiver implementando um processo comercial, ou quando as atividades em uma atividade de fluxo precisam ser sincronizadas.
Uso
Arraste o elemento Vazio da Paleta para o diagrama.
Use um elemento Aguardar para especificar uma condição de espera com base em uma unidade de tempo ou em uma duração.
Uso
Arraste o elemento Aguardar da Paleta para o diagrama. Como outros elementos, ele deve ser colocado na posição correta no fluxo do processo; caso contrário, você não verá o elemento no diagrama.
Clique com o botão direito do mouse no elemento do diagrama e escolha Propriedades para chamar uma janela Propriedades. Usando a janela Propriedades, você pode especificar:
O nome do elemento.
O tipo de alarme. As opções disponíveis são:
Por – especifica a duração da espera do processo
Até – especifica a hora até a qual o processo é atrasado.
Para/Até. Clicar no botão de reticências (...) chama uma caixa de diálogo em que você pode especificar o tempo de acordo com o tipo de expiração selecionada.
Use esta atividade para sinalizar uma falha interna.
Uso
Ao definir as propriedades deste elemento, você pode especificar um nome de falha e uma variável de falha. Esses detalhes podem ser passados para um manipulador de falhas que esteja configurado para lidar com esse tipo de exceção.
Propriedades do elemento Lançar
As propriedades do elemento Lançar podem ser configuradas por meio da janela Propriedades, chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades. As opções são:
Nome
Nome da falha. Clicar no botão de reticências (...) chama a caixa de diálogo Nome da falha, na qual você pode escolher a falha na lista que inclui falhas definidas nos arquivos WSDL.
Você pode usar o editor WSDL para adicionar definições padrão ao arquivo WSDL. Para obter mais informações, consulte a seção
Configurando tipos de porta usando a visualização WSDL do Guia do desenvolvedor para editor WSDL.
Variável de falha. Clique no botão de reticências (...) para especificar o nome da variável, já declarada no arquivo BPEL, que conterá a mensagem de falha.
A atividade Atribuir atribui valores a variáveis. Use o elemento Atribuir para copiar dados de uma variável para outra, construir e calcular os valores das expressões, e armazenar novos dados em variáveis. Expressões são necessárias para realizar cálculos simples ou operar seleções de mensagens, propriedades e constantes literais para produzir um novo valor para as variáveis. A atividade Atribuir pode conter uma ou mais atribuições elementares.
Uso
Use o mapeador BPEL para definir as regras de cópia da atividade Atribuir ou para adicionar expressões. Para obter mais informações, consulte a seção Cenário da atividade Atribuir do guia.
A janela Mapeador BPEL se abre quando você seleciona a atividade Atribuir no diagrama. Se essa janela não estiver visível, você pode chamá-la manualmente, escolhendo Janela > Outro > Mapeador BPEL no menu principal.
Propriedades do elemento Atribuir
A janela Propriedades do elemento Atribuir, chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades, contém duas propriedades:
Nome. Este é o nome do elemento
Contagem de atribuições. Este é o número de regras de atribuição especificadas para o elemento.
Use o elemento Fluxo para definir um conjunto de atividades que serão executadas simultaneamente (em paralelo).
A atividade Fluxo é uma atividade estruturada, que contém outras atividades separadas em caminhos de controle ou ramificações individuais. Você pode incorporar quantos caminhos desejar na atividade, e eles serão todos executados simultaneamente.
Durante a execução, cada caminho é executado simultaneamente, e as atividades em cada um deles são executadas na ordem em que aparecem, a menos que elas sejam a origem de um link. Quando as atividades são a origem de um link, a condição do link e a condição de junção da atividade devem ser avaliadas. Se as condições do link que levam a uma atividade entrarem em conflito com as de sua respectiva condição de junção, será lançada uma falha nessa atividade.
Uso
Na visualização Design, arraste o elemento Fluxo da Paleta para o diagrama.
Arraste um elemento para o espaço reservado dentro do elemento Fluxo. Se você adicionar outro elemento à mesma ramificação do elemento Fluxo, os elementos em uma ramificação serão automaticamente empacotados no elemento Seqüência.
Adicionando ramificações ao elemento Fluxo
Você pode adicionar uma ou mais ramificações ao elemento Fluxo. O elemento Fluxo possui um estilo de interação de usuário especial. Ele sempre mostra um espaço reservado para a próxima ramificação que talvez você queira adicionar. Para adicionar uma nova ramificação, arraste um elemento da Paleta para o espaço reservado da "próxima ramificação" imediatamente disponível.
Alterando a ordem dos elementos dentro do fluxo
Para alterar o ordem das atividades dentro do elemento Fluxo:
Na visualização Design, clique com o botão direito do mouse no elemento Fluxo e selecione Alterar ordem.
Selecione um elemento e use os botões Mover para cima ou Mover para baixo a fim de alterar a posição do elemento dentro do contêiner.
Use o elemento Seqüência para aninhar uma série de atividades em seu processo. As atividades em uma seqüência serão executadas em uma ordem seqüencial restrita. A execução do processo retorna ao processo comercial quando a última atividade no ninho tiver sido concluída.
Uso
Arraste o elemento Seqüência da Paleta para o diagrama.
Adicionando atividades filho à Seqüência
Você pode adicionar uma ou mais atividades filhas à Seqüência. O elemento Seqüência possui um estilo de interação de usuário especial. Ele sempre mostra um ou mais espaços reservados válidos para a próxima atividade que você talvez queira adicionar. Para adicionar uma nova atividade filha, arraste e solte um elemento da Paleta para o próximo espaço reservado de atividade, ou para o anterior, imediatamente disponível.
Alterando a ordem dos elementos dentro da seqüência
Para alterar a ordem das atividades dentro do elemento Seqüência:
Na visualização Design, clique com o botão direito do mouse no elemento Seqüência e selecione Alterar ordem.
Selecione um elemento e use os botões Mover para cima ou Mover para baixo a fim de alterar a posição do elemento dentro do contêiner.
A atividade If aceita o comportamento condicional de uma instância do processo comercial. A atividade If consiste em ramificações condicionais definidas pelos elementos If e Else If, seguidos por uma ramificação Else opcional. As condições em ramificações If e Else If são avaliadas na ordem em que aparecem. Durante a execução, a primeira ramificação cuja condição é verdadeira é obtida e oferece a atividade especificada para a atividade If. Em outras palavras, se houver algumas ramificações Else If cujas condições são verdadeiras, somente a primeira delas será executada.
Se nenhuma das ramificações for verdadeira, o caminho Else será escolhido. Se a ramificação Else não for especificada explicitamente, essa ramificação será considerada como uma atividade Vazio. A atividade If estará concluída quando a atividade da ramificação selecionada estiver concluída.
Uso
Na visualização Design, arraste o elemento If da Paleta para o diagrama.
Selecione o elemento If no diagrama. A janela Mapeador BPEL é exibida na parte inferior do IDE. Se a janela Mapeador BPEL não aparecer, clique com o botão direito do mouse no elemento If e selecione Mostrar mapeador BPEL.
Especifique a condição do elemento If usando o mapeador BPEL. Para obter mais informações, consulte a seção Cenário da atividade If do guia. Você também pode especificar a condição manualmente na janela Propriedades, chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades.
(Opcional) Na janela Propriedades, insira o nome do elemento If.
Adicione o elemento que será executado se a condição for verdadeira no elemento If. Configure o elemento aninhado. Se você adicionar outro elemento no elemento If, os elementos aninhados serão automaticamente empacotados no elemento Seqüência.
Adicione outras ramificações (Else If e Else), conforme descrito abaixo.
Adicionando uma ramificação Else If ao elemento If
Clique com o botão direito do mouse no elemento If e escolha Adicionar Else If.
Adicione uma atividade ao Else If que será executada se a condição definida para esse elemento Else If for verdadeira. Use o mapeador BPEL para definir uma condição.
(Opcional) Adicione mais atividades Else If, escolhendo Adicionar Else If e adicione atividades nelas.
Adicionando uma ramificação Else ao elemento If
Arraste a atividade que você deseja executar na ramificação Else para o caminho do conector marcado com uma barra. Configure a atividade aninhada.
Reordenando as ramificações Else If
Na visualização Design, arraste a ramificação Else If que você deseja reordenar e solte-a no espaço reservado que aparece ao lado da outra ramificação Else If.
O elemento Selecionar bloqueia o processo e aguarda até que um dos eventos especificados ocorra. Depois que o evento específico ocorre, a atividade associada a esse evento é realizada. Os possíveis eventos são a chegada de uma mensagem ou um alarme baseado em temporizador. A ocorrência dos eventos é mutuamente exclusiva. Se mais de um evento ocorrer, então, a seleção da atividade a ser realizada dependerá de qual evento ocorreu primeiro.
A atividade Selecionar fornece duas ramificações, On Message e On Alarm. A ramificação cuja condição é satisfeita primeiro (ou seja, uma mensagem é recebida ou o temporizador especificado expira) é executada. Quando você adiciona um elemento Selecionar ao diagrama, ele automaticamente inclui uma instrução On Message na qual você pode especificar as propriedades da mensagem que o processo aguarda do serviço de parceiro. Cada elemento Selecionar deve incluir pelo menos uma instrução On Message. A ramificação On Alarm contém um temporizador que você pode usar para especificar quanto tempo o processo deve aguardar.
Uso
Na visualização Design, arraste o elemento Selecionar da Paleta para o diagrama.
Para a ramificação On Message, configure as propriedades da mensagem pela qual o processo está aguardando. A configuração é semelhante àquela do elemento Receber.
Na Paleta, arraste a atividade que será executada e coloque-a dentro da ramificação On Message. Configure as propriedades da atividade.
(Opcional) Adicione mais ramificações On Message, escolhendo Adicionar > On Message no menu pop-up e configure-as, conforme descrito acima.
(Opcional) Adicione uma ou mais ramificações On Alarm seguindo o procedimento abaixo.
Adicionando uma ramificação On Alarm
Clique com o botão direito do mouse no elemento Selecionar e escolha Adicionar > On Alarm no menu pop-up.
Configure o temporizador através da janela Propriedades, chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades. As opções disponíveis são:
Tipo de alarme – usado para escolher o tipo de alarme. O tipo pode ser um dos seguintes:
Por – especifica a duração da espera do processo.
Até – especifica o prazo do processo.
Por/Até – usado para configurar o prazo ou a duração do tipo de alarme escolhido. Clique no botão de reticências (...) para especificar a hora. Você também pode usar o mapeador BPEL.
Localize a atividade que você deseja executar depois que o tempo expirar e arraste-a da Paleta para o espaço reservado dentro do elemento on Alarm.
(Opcional) Adicione uma ou mais ramificações On Alarm, conforme descrito acima.
Propriedades do elemento Selecionar
A janela Propriedades do elemento Selecionar, chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades, inclui os seguintes campos:
Criar instância. Se definido como sim, uma nova instância do processo será criada quando o evento especificado ocorrer. Se você não planeja iniciar uma nova instância do processo, mantenha o valor padrão N/D.
Nome. É usado para especificar o nome do elemento.
A atividade Escopo é essencialmente um conjunto de atividades filhas que possuem suas próprias variáveis, manipuladores de falhas, manipuladores de eventos e conjuntos de correlações. A atividade Escopo fornece o contexto do comportamento dos elementos filhos. Os atributos definidos para um Escopo pai possuem visibilidade local dentro desse Escopo. Por exemplo, as variáveis declaradas para um Escopo ficam visíveis somente dentro desse Escopo e em todos os Escopos aninhados. Essas variáveis podem ser usadas para as atividades filhas desse Escopo.
Uso
Na visualização Design, arraste o elemento Escopo da Paleta para o diagrama.
Clique com o botão direito do mouse no elemento e escolha Adicionar no menu pop-up para adicionar o seguinte:
Na visualização Design, arraste elementos da Paleta e coloque-as dentro do elemento Escopo.
Configure os elementos.
(Opcional) Especifique o nome do elemento Escopo na janela Propriedades, chamada quando você clica com o botão direito do mouse e escolhe Propriedades.
Variáveis
As variáveis na programação BPEL funcionam da mesma forma que em outras linguagens de programação: elas mantêm valores temporários, formam partes de expressões ou são passadas para parceiros externos. Normalmente, você precisa de uma variável para cada mensagem enviada ou recebida de um serviço de parceiro. O BPEL Designer aceita os seguintes tipos de variáveis:
Tipo de mensagem WSDL. Essas variáveis correspondem aos tipos de mensagem do serviço Web definidos em arquivos WSDL importados pelo processo. Em um arquivo BPEL (.bpel), essas variáveis devem especificar um valor para o atributo messageType. As variáveis do tipo de mensagem são usadas para manter os dados em interações entre o processo e seus serviços de parceiro.
Tipo de esquema XML. Essas variáveis correspondem aos tipos de dados simples ou complexos do esquema XML. Os próprios tipos de esquema XML são definidos nos arquivos do esquema XML (.xsd) ou nos arquivos WSDL que são importados para o processo. Em um arquivo BPEL, as variáveis deste tipo devem especificar um valor para o atributo type.
Elemento do esquema XML. Essas variáveis correspondem aos elementos do esquema XML. Os próprios elementos do esquema XML são definidos nos arquivos do esquema XML (.xsd) ou nos arquivos WSDL que são importados no processo. Em um arquivo BPEL, as variáveis deste tipo devem especificar um valor para o atributo element.
Tipos incorporados. As variáveis desse tipo são tipos simples padrão definidos na especificação do esquema XML.
Variáveis globais e locais
As variáveis definidas na raiz Processo são variáveis globais, que possuem uma visibilidade global em todo o processo. As variáveis definidas em um escopo específico são visíveis somente dentro desse escopo e em todos os escopos aninhados. Essas variáveis são chamadas de variáveis locais. Uma variável definida para um elemento escopo interno pode ocultar uma variável superior definida do mesmo nome.
O nome de uma variável deve ser exclusivo entre os nomes de todas as variáveis definidas nesse mesmo escopo.
Para definir uma variável:
Clique com o botão direito do mouse no elemento Processo ou Escopo e selecione Adicionar > Variável.
Na caixa de diálogo Criar nova variável, nomeie a variável. O nome deve ser exclusivo dentro do elemento Escopo.
Expanda nó correspondente ao tipo da nova variável e selecione seu tipo. Você tem as seguintes opções:
Tipos incorporados. Expanda o nó Tipos incorporados, selecione o nome do tipo e clique em OK.
Tipo de mensagem. Expanda o nó de um arquivo .wsdl, selecione um tipo de mensagem e clique em OK.
Esquema XML. Expanda o nó de um arquivo .xsd ou um arquivo .wsdl que contenha um esquema incorporado. Expanda os nós Tipo complexo global, Tipo simples global ou Elementos simples globais, selecione o tipo apropriado e clique em OK.
Para a sua conveniência, os tipos globais de variáveis são exibidos em negrito.
(Opcional) Desmarque a caixa de verificação Mostrar apenas arquivos importados para exibir o conteúdo dos arquivos WSDL não importados e os arquivos do esquema XML.
Clique em OK.
Por padrão, a caixa de diálogo Criar nova variável mostra apenas os arquivos que já foram referenciados no processo. Entretanto, o projeto pode conter outros arquivos WSDL e XSD que ainda não foram importados para o processo. Se você selecionar um tipo para a nova variável que esteja definido em um arquivo não-importado, o IDE adicionará automaticamente a importação necessária para o processo BPEL.
Você também pode adicionar variáveis na janela Navegador. Para adicionar uma variável, selecione a visualização Lógica BPEL no navegador, expanda o nó do projeto do módulo BPEL, clique com o botão direito do mouse no nó Variáveis e escolha Adicionar variável.
Para editar uma variável:
Na janela Navegador, selecione a visualização Lógica BPEL.
Expanda o nó do projeto do módulo BPEL > Variáveis e clique duas vezes na variável que você deseja editar.
Na caixa de diálogo Editor de propriedades da variável, altere o tipo e o nome da variável.
Use o elemento While para executar repetidamente uma ou mais ações enquanto as condições específicas existirem no início de cada iteração. Este elemento contém outros elementos que são repetidos enquanto os critérios de sucesso especificados forem atendidos. Se a condição que você especificar for falsa, nenhuma das atividades listadas será executada.
Observação: o elemento While primeiro verifica a validade da condição e, em seguida, executa a atividade interativa. Inversamente, o elemento Repetir até primeiro executa a atividade e, em seguida, verifica a validade da condição.
Uso
Na visualização Design, arraste o elemento While da Paleta para o diagrama.
Arraste uma atividade que será executada repetidamente e coloque-a dentro do elemento While. Se necessário, configure as propriedades da atividade.
Use a janela Propriedades para especificar o nome e a condição do elemento While. Você pode inserir a condição manualmente ou usar o mapeador BPEL para gerar a condição para você. Para abrir a janela Mapeador BPEL, escolha Janela > Mapeador BPEL ou clique com o botão direito do mouse no elemento While no diagrama e escolha Mostrar mapeador BPEL.
O elemento Processo já existe em seu diagrama. O assistente para Novo projeto sempre cria um arquivo BPEL de esqueleto que contém pelo menos um elemento Processo. Portanto, o elemento Processo não faz parte da Paleta. A existência do elemento Processo é presumida, já que é o requisito mínimo de um arquivo BPEL.
Especifique o nome e o espaço de nome de destino do elemento Processo na janela Propriedades, chamada quando você clica com o botão direito do mouse e escolhe Propriedades.
Processos
Um processo BPEL pode ser síncrono ou assíncrono. Um processo BPEL síncrono bloqueia o cliente (aquele que está usando o processo) até que o processo termine e retorne um resultado para o cliente. Um processo assíncrono não bloqueia o cliente. Em vez disso, ele usa um retorno de chamada para retornar o resultado (se houver). Geralmente, usamos os processos assíncronos para processos de maior duração e os síncronos para processos que retornam um resultado dentro de um tempo relativamente curto. Se um processo BPEL usa serviços Web assíncronos, o próprio processo geralmente também é assíncrono.
Use o elemento Repetir até para executar repetidamente uma ou mais atividades, enquanto condições específicas existirem após a execução de cada iteração. Este elemento contém outros elementos que são repetidos até que os critérios de sucesso especificados sejam atendidos. Se a condição que você especificar for verdadeira, as atividades listadas serão executadas uma vez.
Observação: o elemento Repetir até primeiro executa a atividade iterativa e, em seguida, verifica a validade da condição. Inversamente, o elemento While primeiro verifica a validade da condição e, em seguida, executa a atividade.
Uso
Na visualização Design, arraste o elemento Repetir até da Paleta para o diagrama.
Arraste as atividades que serão executadas repetidamente e coloque-as dentro do elemento Repetir até. Se necessário, configure as propriedades da atividade.
Use a janela Propriedades para especificar o nome e a condição do elemento Repetir até. Você pode inserir a condição manualmente ou usar o mapeador BPEL para gerar a condição para você. Para abrir a janela Mapeador BPEL, escolha Janela > Outro > Mapeador BPEL ou clique com o botão direito do mouse no elemento Repetir até no diagrama e escolha Mostrar mapeador BPEL.
Use o elemento Para cada a fim de executar repetidamente sua atividade Escopo exatamente N+1 vezes, onde N é igual ao Valor final do contador menos o Valor inicial do contador.
Uso
Na visualização Design, arraste o elemento Para cada da Paleta para o diagrama.
Adicione elementos que serão executados repetidamente da Paleta para o elemento Para cada. Os elementos que você adiciona são empacotados automaticamente no elemento Escopo.
Clique com o botão direito do mouse no elemento Para cada e escolha Propriedades para abrir a janela Propriedades.
A janela Propriedades do elemento Para cada inclui as propriedades listadas abaixo.
Nome. Especifique o nome do elemento Para cada.
Nome da variável do contador. Declara o nome da variável do contador.
Valor inicial do contador. Define o valor inicial do contador. Use o mapeador BPEL para gerar uma expressão de valor inteiro.
Valor final do contador. Define o valor final do contador. Use o mapeador BPEL para gerar uma expressão de valor inteiro.
Quando a atividade Para cada se inicia, as expressões no Valor inicial do contador e no Valor final do contador são avaliadas pela primeira e única vez. Ou seja, quando os dois valores são retornados, eles permanecem constantes durante o ciclo de vida da atividade. Se o Valor inicial do contador for maior que o Valor final do contador, nenhuma iteração será realizada.
Condição de conclusão (Opcional). Especifica uma expressão de valor inteiro. Depois da execução de cada atividade diretamente incluída, o número de atividades concluídas é comparado com esse valor. Quando o número de atividades concluídas é igual ao valor da expressão especificada, nenhuma outra atividade é iniciada. Quando o valor da expressão é maior que o número de iterações disponíveis, nenhuma iteração é iniciada.
Contar somente ramificações completas (Opcional). Se essa caixa de verificação estiver marcada, o tempo de execução contará somente as ramificações que foram concluídas com êxito. Se essa caixa de verificação for limpa, todas as ramificações, concluídas com êxito ou não, serão contadas.
Use essa atividade a fim de parar a execução de uma atividade ou de um processo: dentro do processo, de uma atividade estruturada ou de um manipulador.
Uso
Na visualização Design, arraste o elemento Sair da Paleta para o diagrama.
Observação: o tempo de execução BPEL não suporta Sair dentro de elementos Fluxo e On Alarm, ou dentro do On Event filho do elemento Manipulador de eventos.
