corner imagecorner image
FeaturesPluginsDocs & SupportCommunityPartners

Guia do desenvolvedor para BPEL Designer: Usando os elementos da paleta


Conteúdo

Guia do desenvolvedor para BPEL Designer

As seções seguintes descrevem em sua ordem de aparição:

  • As circunstâncias nas quais se usa um elemento Paleta específico.
  • O uso desses elementos Paleta no contexto do Designer de orquestração.

Usando o elemento Chamar



Quando usar

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 WSDL do parceiro.

Uso

Para usar o elemento Chamar:

  1. Arraste e solte o elemento Chamar da Paleta no diagrama
  2. Adote um dos seguintes procedimentos
    • Arraste diretamente o fluxo de mensagens, ou (mais complicado)
    • 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.

      A guia principal do editor de propriedades do elemento Chamar

Como em outros editores de propriedades do elemento, você pode alterar as variáveis do elemento Chamar através de uma caixa de diálogo Nova variável ou através do Seletor de variáveis. Se nenhuma variável for usada por um elemento (por exemplo, nenhuma variável de saída), a caixa de diálogo Nova variável e o Seletor de variáveis dessa variável não estarão presentes.

Além disso, observe que quando você ativa o botão Explorar no editor de propriedades da atividade do serviço da Web, as caixas de diálogo Seletor de variável de entrada e Seletor de variável de saída restringirão a lista de variáveis disponíveis àquelas que são do tipo apropriado para a operação do serviço da Web que está sendo configurado. Dessa forma, a exibição Design ajuda você a desenvolver uma BPEL válida.

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 compátiveis com os dados contidos nas instâncias especificadas do conjunto de correlações.

Uma guia no editor de propriedades do elemento Chamar permite que você examine ou especifique um conjunto de correlações.

Guia Correlações

A guia mostra:

  • O nome de um conjunto 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 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:

  1. Na exibição Design, clique com o botão direito do mouse no elemento Processo e escolha Adicionar > Adicionar conjunto de correlações. A caixa de diálogo Adicionar conjunto de correlações se abre.
  2. Altere o nome do conjunto de correlações e clique em Adicionar para adicionar propriedades.
  3. Na caixa de diálogo Seletor de propriedades, selecione uma propriedade para adicionar ao conjunto e clique em OK.

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 onMessage de uma atividade Selecionar e ao elemento onEvent em um recipiente Manipuladores de eventos.

A seguir é mostrado um conjunto de correlações, conforme visto no navegador.

Conjunto de correlações no navegador

Para adicionar um conjunto de correlações a um elemento:

  1. Na exibição Design, clique duas vezes em um elemento (Chamar, Receber, Responder ou na ramificação onMessage de Selecionar ou no elemento onEvent em um recipiente Manipuladores de evento).
  2. No Editor de propriedades, selecione a guia Correlações e clique em Adicionar.
  3. Na caixa de diálogo Escolher um conjunto de correlações, selecione o conjunto de correlações e clique em OK.
  4. (Opcional) Adicione mais conjuntos de correlações, conforme necessário, e clique em OK.

superior


Usando o elemento Receber



Quando usar

O elemento Receber permite que o processo comercial espere que uma mensagem específica chegue.

Uso

  1. Arraste e solte o elemento Receber no diagrama.
  2. Clicar duas vezes no elemento Receber (ou clicar com o botão direito do mouse e escolher Editar) abre um editor de propriedades modal, onde você pode alterar os itens seguintes, aqui fornecidos com um exemplo do serviço de reserva de viagens:
    • O nome do elemento (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á criada quando uma mensagem associada chegar.

      A guia principal do editor de propriedades do elemento Receber

  3. 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, 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.

      Janela Propriedades de Receber

Correlações

Uma guia Correlações no editor de propriedades do elemento Receber permite que você examine ou especifique um conjunto de correlações.

Guia Correlações

A guia mostra:

  • O nome de um conjunto de correlações
  • A iniciação de um correlator

Você pode adicionar um conjunto de correlações clicando no botão Adicionar. Para obter mais informações, consulte Definindo um conjunto de correlações e Adicionando um conjunto de correlações a um elemento.

superior


Usando o elemento Responder



Quando usar

Use esta atividade para retornar uma mensagem do processo para o mesmo parceiro que iniciou a operação.

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

  1. Arraste o elemento Responder da Paleta para o local apropriado no diagrama.
  2. Clique duas vezes no elemento Responder (ou clique com o botão direito do mouse e escolha Editar) para abrir um editor de propriedades do elemento Responder. O editor de propriedades especifica:
    • 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. Outra opção é especificar a variável de saída: crie uma nova variável de saída ou procure uma existente.
      • Selecione Resposta de falha, se o elemento Responder for usado para enviar uma mensagem de falha. Escolha um nome para a falha e, como opção, especifique a variável de falha: crie uma nova variável de falha ou procure uma existente.

      Editor de propriedades de Responder

  3. Clicar com o botão direito do mouse no elemento Responder e escolher Propriedades abre uma janela Propriedades, que, além dos itens listados no 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.

      Janela Propriedades de Responder

Correlações

Uma guia Correlações no editor de propriedades do elemento Responder permite que você examine ou especifique um conjunto de correlações.

Guia Correlações

A guia mostra:

  • O nome de um conjunto de correlações
  • A iniciação de um correlator

Você pode adicionar um conjunto de correlações clicando no botão Adicionar. Para obter mais informações, consulte Definindo um conjunto de correlações e Adicionando um conjunto de correlações a um elemento.

superior


Usando o elemento PartnerLink



Quando usar

Os links 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.
  • PartnerLink é 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 PartnerLink. Um elemento PartnerLink só pode ser definido pela referência a um tipo de link de parceiro específico e a função que, como mencionado, deve ser definida no WSDL.

Uso

Para adicionar o elemento PartnerLink ao projeto BPEL, adote um dos seguintes procedimentos:

  • Arrastar o elemento PartnerLink da Paleta para o diagrama.
  • Arrastar um nó de arquivo WSDL do mesmo projeto na janela Projetos para o diagrama.
  • Arrastar um nó de arquivo WSDL de outro projeto na janela Projetos para o diagrama.
  • Arrastar um nó de serviço da Web de um projeto EJB na janela Projetos para o diagrama

Observação: Ao arrastar o nó de serviço da Web, o BPEL Designer recupera o arquivo WSDL do servidor de aplicativos. Para que a recuperação do arquivo WSDL seja bem-sucedida, o servidor de aplicativos tem que estar em execução e o projeto de serviço da Web deve estar implantado.

Quando você arrasta o elemento PartnerLink, um nó de arquivo WSDL ou um nó de serviço da Web para o diagrama, o editor de propriedades de PartnerLink é exibido.

O editor de propriedades de PartnerLink

O editor de propriedades de PartnerLink permite que você estabeleça os links de parceiro para os seus processos BPEL.

O editor de propriedades de PartnerLink é chamado quando você clica duas vezes em um elemento PartnerLink no diagrama, ou quando você clica com o botão direito do mouse no elemento PartnerLink e escolhe Editar. O editor de propriedades de PartnerLink também é exibido quando você arrasta o elemento PartnerLink, um nó de arquivo WSDL ou um nó de serviço da Web para o diagrama.

Com o editor de propriedades de PartnerLink, 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 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 nome do tipo de link de parceiro.
    • Especifique a função do processo comercial (Minha função) e/ou a função do parceiro (Função do parceiro). Para fazê-lo:
      • Marque a caixa de seleção apropriada.
      • Especifique o nome da função.
      • Escolha o tipo de porta na lista suspensa.

Editor de propriedades de PartnerLink

Também é possível consultar e modificar as propriedades de PartnerLink na janela Propriedades chamada quando você clica com o botão direito do mouse no elemento e escolhe Propriedades.

superior


Usando o elemento Vazio



Quando usar

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 caminho correto do diagrama.

superior


Usando o elemento Aguardar



Quando usar

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 para o local apropriado no 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 do elemento. As opções disponíveis são:
    • Por – especifica a duração da espera do processo
    • Até – especifica um determinado período de tempo para o processo aguardar
  • Data/duração. Ao clicar no botão de reticências (...) é chamada uma caixa de diálogo na qual você pode especificar uma data ou uma duração para o elemento.

    Janela Propriedades de Aguardar

superior


Usando o elemento Lançar



Quando usar

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. Ao clicar no botão de reticências (...) é chamada a caixa de diálogo Nome da falha, na qual você pode escolher a falha na lista que inclui falhas do sistema e as falhas definidas nos arquivos WSDL e BPEL.
  • 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.

    Janela Propriedades de Lançar

superior


Usando o elemento Atribuir



Quando usar

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.

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.

    Janela Propriedades de Atribuir

superior


Usando o elemento Fluxo



Quando usar

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

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 você talvez queira adicionar. Para adicionar uma nova ramificação, arraste um elemento da Paleta para o espaço reservado "próxima ramificação" imediatamente disponível.

superior


Usando o elemento Seqüência



Quando usar

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 e solte o elemento Seqüência no 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.

superior


Usando o elemento If



Quando usar

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 ElseIf, seguidos por uma ramificação Else opcional. As condições em ramificações If e ElseIf 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 ElseIf 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

  1. Na exibição Design, arraste o elemento If da Paleta para o diagrama.
  2. Selecione o elemento If no diagrama. A janela Mapeador BPEL é exibida na parte inferior do IDE. Se a janela Mapeador BPEL não for exibida, escolha Janela > Mapeador BPEL no menu principal.
  3. Especifique a condição do elemento 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.
  4. (Opcional) Na janela Propriedades, insira o nome do elemento If.

    Janela Propriedades de If

  5. 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.
  6. Adicione outras ramificações (ElseIf e Else), conforme descrito abaixo.

Adicionando uma ramificação ElseIf ao elemento If

  1. Clique com o botão direito do mouse no elemento If e escolha Adicionar ElseIf.
  2. Adicione uma atividade ao ElseIf que será executada se a condição definida para esse ElseIf for verdadeira. Use o mapeador BPEL para definir uma condição.
  3. (Opcional) Adicione mais atividades ElseIf escolhendo Adicionar ElseIf 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 ramificações ElseIf

Na exibição Design, arraste a ramificação ElseIf que você deseja reordenar e solte-a no espaço reservado que aparece ao lado da outra ramificação ElseIf.

superior


Usando o elemento Selecionar



Quando usar

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 oferece duas ramificações, onMessage e onAlarm. 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 onMessage 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 onMessage. A ramificação onAlarm contém um temporizador que você pode usar para especificar quanto tempo o processo deve aguardar.

Uso

  1. Na exibição Design, arraste o elemento Selecionar da Paleta para o diagrama.
  2. Para a ramificação onMessage, configure as propriedades da mensagem pela qual o processo está aguardando. A configuração é semelhante àquela do elemento Receber.
  3. Na Paleta, localize a atividade que você deseja executar. Arraste-a da Paleta e coloque-a dentro da ramificação onMessage. Configure as propriedades dessa atividade.
  4. (Opcional) Adicione mais ramificações onMessage escolhendo Adicionar > On Message no menu pop-up e configure-as, conforme descrito acima.
  5. (Opcional) Adicione uma ou mais ramificações onAlarm seguindo o procedimento abaixo.

Adicionando uma ramificação onAlarm

  1. Clique com o botão direito do mouse no elemento Selecionar e escolha Adicionar > On Alarm no menu pop-up.
  2. 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 – 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.
    • Data/Duração – 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.
  3. 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 onAlarm.
  4. (Opcional) Adicione uma ou mais ramificações onAlarm, 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.

Janela Propriedades de Selecionar

superior


Usando o elemento Escopo



Quando usar

A atividade Escopo é essencialmente um conjunto de atividades filhas que possuem trocas de mensagens, variáveis, manipuladores de falhas e de eventos próprios. Uma 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

  1. Na exibição Design, arraste o elemento Escopo da Paleta para o diagrama.
  2. Clique com o botão direito do mouse no elemento e escolha Adicionar no menu pop-up para adicionar o seguinte:
  3. No diagrama, arraste os elementos para o Escopo.
  4. Configure os elementos.
  5. (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 são usadas na programação BPEL como em outras linguagens de software: mantêm valores temporários, fazem parte de expressões ou são passadas como um parâmetro 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. As variáveis desse tipo correspondem aos tipos de mensagem do serviço da Web definidos em arquivos WSDL importados pelo processo. Em um arquivo 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. As variáveis desse tipo 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 desse tipo devem especificar um valor para o atributo de tipo.
  • Elemento do esquema XML. As variáveis desse tipo 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 desse tipo devem especificar um valor para o atributo do elemento.
  • 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:

  1. Clique com o botão direito do mouse no elemento Processo ou Escopo e selecione Adicionar > Adicionar variável.
  2. Na caixa de diálogo Criar nova variável, nomeie a variável. O nome deve ser exclusivo dentro do elemento Escopo.
  3. Selecione um dos seguintes tipos:
    • Tipo de mensagem. Expanda o nó de um arquivo .wsdl, selecione um tipo de mensagem e clique em OK.
    • Tipo simples de esquema XML. Expanda o nó de um arquivo .xsd ou um arquivo .wsdl que contenha um esquema incorporado. Expanda a pasta Tipos simples, selecione um tipo simples e clique em OK.
    • Tipo complexo de esquema XML. Expanda o nó de um arquivo .xsd ou um arquivo .wsdl que contenha um esquema incorporado. Expanda a pasta Tipos complexos, selecione um tipo complexo e clique em OK.
    • Tipo de elemento do esquema XML. Expanda o nó de um arquivo .xsd ou um arquivo .wsdl que contenha um esquema incorporado. Expanda a pasta Elementos, selecione um elemento e clique em OK.
    • Tipos incorporados. Expanda a pasta Tipos incorporados, selecione o nome da variável e clique em OK.
  4. (Opcional) Desmarque a caixa de seleção Mostrar apenas arquivos importados para exibir o conteúdo dos arquivos WSDL não importados e os arquivos do esquema XML.
  5. Clique em OK.

Por padrão, a caixa de diálogo Criar nova variável mostra apenas os arquivos que já foram importados no processo. Entretanto, o projeto pode conter outros arquivos .wsdl e .xsd que ainda não foram importados no processo. Se você definir uma nova variável baseada em um tipo definido em um dos arquivos não importados, 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 exibiçã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:

  1. Na janela Navegador, selecione a exibição Lógica BPEL.
  2. Expanda o nó do projeto do módulo BPEL > Variáveis.
  3. Clique com o botão direito do mouse na variável que deseja editar e escolha Editar.
  4. No editor de propriedades da variável, altere o tipo de variável.
  5. Clique em OK.

Observação: Nesta versão, o mapeador BPEL não aceita trabalhar com variáveis definidas para o elemento Escopo.

superior


Usando o elemento While



Quando usar

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

  1. Adicione o elemento While da Paleta.
  2. Arraste as atividades que precisam ser executadas repetidamente para o elemento While.
  3. 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.

superior


Usando o elemento Processo

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.

A captura de tela seguinte mostra a representação de um processo na amostra Serviço de reserva de viagens.

Processo

Uso

  1. Clique com o botão direito do mouse no elemento e escolha Adicionar no menu pop-up para adicionar o seguinte:
  2. 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 da Web assíncronos, o próprio processo geralmente também é assíncrono.

superior


Usando o elemento Repetir até



Quando usar

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

  1. Adicione um elemento Repetir até a partir da Paleta.
  2. Arraste as atividades que precisam ser executadas repetidamente para o elemento Repetir até.
  3. 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 > Mapeador BPEL.

superior


Usando o elemento Para cada



Quando usar

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

  1. Adicione o elemento Para cada a partir da Paleta.
  2. 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.
  3. 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 - que é usada para especificar o nome do elemento Para cada.
  • Nome da variável do contador – que é usada para declarar o nome da variável do contador.
  • Valor inicial do contador – que é usada para definir o valor inicial do contador. Use o mapeador BPEL para gerar uma expressão de valor inteiro.
  • Valor final do contador – que é usada para definir 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. Trata-se de 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 definida como sim, o tempo de execução contará somente as ramificações que foram concluídas com êxito. Se definido como não, todas as ramificações, concluídas ou não com êxito, serão contadas.

superior


Usando o elemento Sair



Quando usar

Use essa atividade para interromper a execução de uma atividade ou processo: tanto dentro do processo quanto dentro de uma atividade estruturada ou de um manipulador.

Uso

Arraste o elemento Sair da Paleta para o diagrama.

Observação: O tempo de execução BPEL não aceita Sair nos elementos Fluxo e OnAlarm, ou no OnEvent filho do elemento EventHandler.



superior

Bookmark this page

del.icio.us furl simpy slashdot technorati digg
Companion
Projects:
MySQL Database Server   GlassFish Community: an Open Source Application Server   Open Solaris  Open JDK: an Open SourceJDK   Mobile & Embedded Community     Sponsored by 
Sponsored by Sun Microsystems