As seções seguintes descrevem em sua ordem de aparição:
As circunstâncias em que você deve usar um manipulador específico.
O uso desses elementos no contexto do BPEL Designer.
Nesta versão do BPEL Designer, você pode adicionar manipuladores de falhas e manipuladores de eventos ao seu processo BPEL. Manipuladores de compensação e de término não são aceitos.
Usando um manipulador de falhas
Quando usar
A linguagem BPEL oferece a habilidade de interceptar e gerenciar exceções usando manipuladores de falhas. Por exemplo, as exceções ocorrem quando os serviços da Web retornam dados diferentes do que era esperado. Se as falhas não forem manipuladas, todo o processo BPEL pode passar para um estado de falha. Portanto, para evitar que todo o processo falhe, você pode adicionar manipuladores de falhas para interceptar e gerenciar exceções em escopos específicos.
Cada manipulador de falhas contém uma atividade que é executada quando há um erro. Por exemplo, um serviço de parceiro será notificado se tiver ocorrido um erro. Os manipuladores de falhas podem ser adicionados ao processo inteiro ou a elementos Escopo individuais.
Você pode anexar um recipiente Manipulador de falhas ao elemento Processo ou Escopo. Dentro do recipiente Manipuladores de falhas, você pode criar várias atividades Interceptar configuradas para interceptar tipos de falhas específicos, ou um elemento-manipulador Interceptar todos para interceptar todas as exceções não detectadas por manipuladores específicos.
Uso
Clique com o botão direito do mouse no elemento Processo ou em qualquer elemento Escopo e chame a ação Adicionar manipuladores de falhas. Isso não adiciona um manipulador de falhas em particular, apenas adiciona um elemento de recipiente ao qual você pode adicionar manipulares de falhas específicos.
Depois de adicionar um recipiente Manipuladores de falhas, clique com o botão direito do mouse no elemento Manipuladores de falhas para adicionar um elemento Interceptar ou Interceptar todos. Você pode adicionar ao grupo Manipuladores de falhas quantos elementos Interceptar específicos desejar. Você pode adicionar somente um elemento Interceptar todos por recipiente Manipuladores de falhas.
Elemento Interceptar
Use esse elemento para interceptar e lidar com um tipo específico de falha.
Este elemento é usado em um elemento de recipiente Manipuladores de falhas apropriado.
Propriedades do elemento Interceptar
As propriedades do elemento Interceptar são definidas na janela Propriedades. Você também pode clicar com o botão direito do mouse no elemento do diagrama e escolher Propriedades. As propriedades disponíveis são:
Nome da falha. Selecione o qname da falha na lista de falhas, que inclui as falhas do sistema e as falhas definidas nos arquivos WSDL.
Propriedade Nome da variável da falha. Especifique o nome da variável BPEL que conterá a mensagem de falha. Deve ser o nome de uma variável BPEL já definida e deve ser apropriado para conter a mensagem da falha.
Tipo de variável da falha. Especifique o tipo da variável; ele deve corresponder ao tipo dos dados da falha. Você pode selecionar os seguintes tipos: esquema ou mensagem.
Elemento Interceptar todos
Use o elemento Interceptar todos para interceptar e lidar com todas as falhas que não são interceptadas por um elemento de interceptação associado.
O elemento Interceptar todos é usado em uma janela do manipulador de falhas junto com um ou mais elementos de interceptação. É definido em um elemento de recipiente Manipuladores de falhas junto com um ou mais elementos de interceptação.
Não há propriedades para o elemento Interceptar todos. Seu comportamento é predefinido e não requer configuração de propriedade.
Editor de propriedades do manipulador de falhas
Não há propriedades específicas para o elemento de recipiente Manipuladores de falhas. É um elemento que fornece restrições para uma coleção ou grupo de elementos Interceptar e Interceptar todos.
O processo inteiro, bem como cada escopo individual, pode ser associado a um conjunto de manipuladores de falhas que serão chamados simultaneamente, se o evento correspondente ocorrer. As ações feitas em um manipulador de eventos podem ser de qualquer tipo de atividade, tal como Seqüência ou Fluxo. O único filho imediato de um manipulador de eventos é Escopo, sendo assim, quando você arrasta um elemento da paleta para o manipulador de eventos, ele é empacotado automaticamente em Escopo.
Existem dois tipos de eventos. Primeiro, os eventos podem ser mensagens de entrada que correspondem a uma solicitação/resposta ou operação uniderecional em WSDL. Por exemplo, uma consulta de status é provavelmente uma operação solicitação/resposta, onde um cancelamento pode ser uma operação unidirecional. Segundo, os eventos podem ser alarmes que se desativam após as horas definidas pelo usuário.
Uso
Clique com o botão direito do mouse no elemento Processo ou em qualquer elemento Escopo e chame a ação Adicionar manipuladores de eventos. Isso não adiciona um manipulador de eventos em particular, apenas adiciona um elemento de recipiente ao qual você pode adicionar manipuladores de eventos específicos.
Depois de adicionar um recipiente Manipuladores de eventos, você pode clicar com o botão direito do mouse no elemento Manipuladores de eventos para adicionar uma ramificação OnEvent ou OnAlarm. Você pode adicionar ao grupo Manipuladores de eventos quantos elementos OnEvent ou OnAlarm específicos desejar.
Elemento OnEvent
O elemento OnEvent indica que o evento especificado aguarda que uma mensagem chegue. A interpretação dessa marca e seus atributos é muito semelhante a uma atividade Receber.
Uso
Clique com o botão direito do mouse no recipiente Manipuladores de eventos e escolha Adicionar > On Event.
Ao clicar duas vezes no elemento OnEvent se abre um editor de propriedades, onde você pode especificar/alterar o seguinte:
O link de parceiro
A operação associada ao elemento OnEvent
A variável do evento
Ao clicar com o botão direito do mouse no elemento OnEvent e escolher Propriedades se abre uma janela Propriedades, onde você pode consultar e modificar as propriedades do elemento. Além das propriedades existentes no editor de propriedades, a janela Propriedades contém o campo PortType, que é preenchido quando você especifica o link de parceiro e a operação.
Uma guia Correlações no editor de propriedades do elemento OnEvent permite que você examine ou especifique um conjunto de correlações.
O elemento OnAlarm especifica o prazo ou a duração do escopo aninhado.
Propriedades do elemento OnAlarm
As propriedades do elemento OnAlarm são definidas na janela Propriedades, chamada quando você clica com o botão direito do mouse no elemento do diagrama e escolhe Propriedades. As propriedades disponíveis são:
Tipo de alarme, que é a propriedade usada para escolher o tipo de alarme. As opções disponíveis são:
Por – especifica a duração da espera do processo.
Até – especifica o prazo do processo.
Repetir a cada – especifica a freqüência de iniciação do processo. O processo determinado será iniciado cada vez que o período de duração especificado expirar. O relógio da primeira duração começa no momento em que o escopo associado é iniciado.
Por + Repetir a cada – especifica a freqüência de iniciação do processo após a duração do tempo de espera especificado. O processo será iniciado cada vez que o período de duração especificado no campo Repetir a cada expirar. O primeiro alarme é disparado quando o período de tempo especificado no campo Por expira.
Até + Repetir a cada – especifica a freqüência de iniciação do processo com base no prazo especificado. O processo será iniciado cada vez que o período de duração especificado no campo Repetir a cada expirar. O primeiro alarme é disparado quando o prazo especificado no campo Até é alcançado.
A segunda propriedade (e terceira, se disponível) é usada para especificar a duração ou o prazo do tipo de alarme selecionado.
Editor de propriedades do manipulador de eventos
Não há propriedades específicas para o elemento de recipiente Manipuladores de eventos. É um elemento que fornece restrições para uma coleção ou grupo de elementos OnEvent e OnAlarm.
