Pré-requisito

Este tutorial presume que você tenha algum conhecimento básico ou experiência de programação com as tecnologias SOA e o NetBeans IDE.

Requisitos do sistema

Este tutorial presume que o seu sistema atende aos requisitos especificados no tópico Requisitos do sistema das Notas de versão do NetBeans Enterprise Pack 5.5.

Software necessário para o tutorial

Antes de começar, você deve instalar o seguinte software em seu computador:

• NetBeans IDE 5.5 com NetBeans Enterprise Pack 5.5 (download)

Conteúdo

• Configurando o ambiente do tutorial
• Criando o projeto SynchronousSample
• Explorando a janela Mapeador BPEL
• Editando o projeto BPEL síncrono usando o mapeador BPEL
  • Adicionando uma variável
  • Modificando o esquema XML
  • Editando o processo BPEL
  • Adicionando condições ao elemento If
  • Adicionando expressões ao elemento Atribuir
• Implantando o projeto no servidor de aplicativos
• Criando casos de teste
• Implantando e testando o aplicativo
• Resumo

Adicionando uma variável

Neste procedimento, você adiciona a variável todayIs do tipo de seqüência ao processo comercial. Esta variável é usada para armazenar o valor retornado da função current-date.

1. Se o arquivo SynchronousSample.bpel não estiver aberto no IDE, abra-o agora.
2. Na exibição Design, clique com o botão direito do mouse no elemento de processo SynchronousSample e selecione Adicionar > Variável.
3. No campo Nome, digite todayIs.
4. Expanda o nó Tipos incorporados e selecione o tipo seqüência.
5. Clique em OK.
   Selecione o elemento Atribuir1 no diagrama. A variável todayIs é exibida agora em ambos painéis de árvore da janela Mapeador BPEL.

Modificando esquema XML

Neste procedimento, você modifica as propriedades de um elemento existente do esquema XML e adiciona um novo elemento nTest. O elemento nTest é usado para definir que ramificação If será executada. Depois, você usará o elemento nTest em casos de teste.

1. Na janela Projetos, expanda o nó do projeto SynchronousSample e o nó Arquivos do processo.
2. Clique duas vezes no nó SynchronousSample.xsd.
   O IDE abre a exibição Esquema do arquivo do esquema XML.
3. Nas colunas da exibição Esquema, selecione o nó Tipos complexos > simpleProcess > seqüência > paramA.
   Você pode clicar no botão da coluna para certificar-se de que esteja no modo de coluna da exibição.
4. Na janela Propriedades, defina o parâmetro Max Occurs como não vinculado para permitir o uso dos valores que sejam maiores ou iguais a 1.
   Se a janela Propriedades não estiver aberta, selecione Janela > Propriedades ou pressione Ctrl-Shift-7.

   
   Clique para aumentar

5. Na terceira coluna da exibição Esquema, clique com o botão direito do mouse no elemento Seqüência e selecione Adicionar > Elemento no menu pop-up.
6. Na caixa de diálogo Elemento, insira nTest no campo Nome e selecione a opção Usar tipo existente.
7. Expanda o nó Tipos incorporados e selecione o tipo int.
8. Clique em OK.

   
   Clique para aumentar

9. Escolha Arquivo > Salvar todos.

Editando o processo BPEL

Neste procedimento, você adicionará as atividades If e Atribuir ao processo comercial.

1. Se o arquivo SynchronousSample.bpel não estiver aberto no IDE, abra-o agora.
2. Na exibição Design, selecione o ícone de If na Paleta, arraste a seleção para a área de design e solte-a no diagrama, entre o elemento inicial e o elemento Atribuir1.
3. Mova o elemento Atribuir1 para dentro do elemento If1 e solte-o na ramificação principal (sem mover).
4. Na Paleta, selecione o ícone de Atribuir e solte-o no diagrama depois do elemento Atribuir1 dentro do elemento If .
   Este elemento recebe o rótulo de Atribuir2.
5. Clique com o botão direito do mouse no elemento If e escolha Adicionar Else If no menu pop-up.
6. Na Paleta, selecione o ícone de Atribuir e solte-o no diagrama dentro da ramificação ElseIf .
   Este elemento recebe o rótulo de Atribuir3.
   Veja a ilustração abaixo e verifique se o diagrama do seu processo comercial é semelhante à ela.

Clique para aumentar

Adicionando condições ao elemento If

Você pode especificar as condições para a execução da atividade If seguindo os procedimentos abaixo. O parâmetro nTest define que ramificação If contém true (verdadeiro). Para a ramificação If, nTest é igual a 1 e para a ramificação ElseIf, nTest é igual a 2.

Para especificar as condições do elemento If1:

1. Selecione o elemento If1 no diagrama.
2. Na janela Mapeador BPEL, na barra de menus, selecione Número > Literal numérico e operadores > IGUAL.
   São exibidas duas caixas de função no painel de mapeamento. Para a sua comodidade, arraste as caixas de função para que a caixa Literal numérico fique à esquerda e a caixa de função IGUAL à direita.
3. No painel de árvore esquerdo da janela Mapeador BPEL, expanda os nós inputVar e inputType.
4. Selecione o nó nTest no painel de árvore esquerdo e arraste o ponteiro até o parâmetro qualquer1 da caixa de função IGUAL.
5. Na caixa de função Literal numérico, clique duas vezes no campo de entrada e insira 1.
6. Selecione a caixa de função Literal numérico e arraste o ponteiro até o parâmetro qualquer2 da caixa de função IGUAL.
7. Na caixa de função IGUAL, selecione o parâmetro booleano de retorno e arraste o ponteiro até o nó Resultado no painel de árvore direito da janela Mapeador BPEL.
8. Selecione Arquivo > Salvar.

Clique em ampliar

Para especificar as condições do elemento ElseIf:

1. Selecione o elemento ElseIf no diagrama.
2. Siga as etapas de acordo com o procedimento anterior para If, porém insira 2 como o valor de Literal numérico.

Clique em ampliar

Adicionando expressões ao elemento Atribuir

Neste procedimento, você adicionará expressões aos elementos Atribuir1, Atribuir2 e Atribuir3 usando o Editor de fontes e o Mapeador BPEL.

Para adicionar expressões ao elemento Atribuir1:

1. Selecione o elemento Atribuir1 no diagrama.
2. Na janela Mapeador BPEL, na barra de menus, selecione Data-hora > Data atual.
   A caixa de função Data atual é exibida no painel de mapeamento.
3. Na caixa de função Data atual, selecione o parâmetro seqüência de retorno e arraste o ponteiro até o nó todayIs no painel de árvore direito da janela Mapeador BPEL.
4. Selecione Arquivo > Salvar.

   
   Clique para aumentar

5. Clique com o botão direito do mouse no elemento Atribuir1 no diagrama e selecione Ir para o código-fonte no menu pop-up.

   Na exibição Fonte, o operador copiar do elemento Atribuir1 copia o valor do parâmetro seqüência de retorno na variável todayIs como mostrado abaixo:

  <assign name="Assign1"></assign>
   <copy>
      <from>current-date()</from>
      <to variable="todayIs"/>         
    </copy>     
  </assign>  

Para adicionar expressões ao elemento Atribuir2:

O elemento Atribuir2 formará a seguinte seqüência de saída: Olá! Hoje é 2006-11-17. O fuso horário é de 03:00.

Você trabalhará com a variável todayIs que contém a data atual no seguinte formato: AAAA-MM-DD FF:FF, na qual AAAA é o ano atual, MM é o mês, DD é a data e FF:FF é o fuso horário.

1. Selecione o elemento Atribuir2 no diagrama.
2. Na janela Mapeador BPEL, na barra de menus, selecione Seqüência > Concat e selecione duas vezes Seqüência > Subseqüência.
   São exibidas três caixas de função no painel de mapeamento. Para sua comodidade, arraste as duas caixas Subseqüência à esquerda e a caixa Concatenar à direita.
3. Para formar uma seqüência da variável todayIs que conterá somente uma data sem um fuso horário, realize as seguintes etapas:
   
   1. Selecione o nó todayIs no painel de árvore esquerdo e arraste o ponteiro até o parâmetro seqüência da primeira caixa de função Subseqüência.
   2. Clique duas vezes em número dentro da caixa de função e digite 1.
      Esta é a posição inicial da seqüência todayIs que será copiada.
   3. Clique duas vezes em número? dentro da caixa de função e digite 10.
      Este é o número de símbolos que serão copiados.
4. Para formar uma seqüência da variável todayIs que conterá somente um fuso horário sem uma data, realize as seguintes etapas:
   
   1. Selecione o nó todayIs no painel de árvore esquerdo e arraste o ponteiro até o parâmetro seqüência da segunda caixa de função Subseqüência.
   2. Clique duas vezes em número dentro da caixa de função e digite 11.
      Esta é a posição inicial da seqüência todayIs que será copiada.

   Observação: Aqui, número? não é um parâmetro obrigatório para a função Subseqüência: sem nenhum parâmetro especificado, a função Subseqüência copia a seqüência da posição inicial ao final.

5. Para formar uma seqüência de saída Concatenar, citada no início desta seção, realize as seguintes etapas:
   
   1. No painel de árvore esquerdo da janela Mapeador BPEL, expanda os nós inputVar e inputType.
   2. Selecione o nó paramA no painel de árvore esquerdo e arraste o ponteiro até o parâmetro seqüência1 da caixa de função Concatenar.
      Esta ação copia a seqüência que está contida no parâmetro de entrada.
   3. Clique duas vezes em seqüência2 dentro da caixa de função Concatenar e digite Hoje é.
      Este procedimento forma uma seqüência para uma saída, que será adicionada na seqüência de saída.
   4. Na primeira caixa de função Subseqüência, selecione o parâmetro seqüência de retorno e arraste o ponteiro até seqüência3 da caixa de função Concatenar.
      Esta ação copia uma data atual sem um fuso horário.
   5. Clique duas vezes em seqüência4 dentro da caixa de função Concatenar e digite : O fuso horário é de.
      Esta seqüência vem depois da data atual.
   6. Na segunda caixa de função Subseqüência, selecione o parâmetro seqüência de retorno e arraste o ponteiro até seqüência5 da caixa de função Concatenar.
      Esta ação copia um fuso horário sem uma data atual.
   7. Clique duas vezes em seqüência6 dentro da caixa de função Concatenar e digite : .
      Esta seqüência é adicionada depois de um fuso horário.
   8. No painel de árvore direito da janela Mapeador BPEL, expanda os nós outputVar e resultType.
   9. Na caixa de função Concatenar, selecione o parâmetro seqüência de retorno e arraste o ponteiro até o nó paramA no painel de árvore direito da janela Mapeador BPEL.
      Esta ação copia o resultado da função Concatenar na saída.
6. Selecione Arquivo > Salvar.

   
   Clique para aumentar

7. Clique com o botão direito do mouse no elemento Atribuir2 no diagrama e selecione Ir para o código-fonte no menu pop-up.
   

   Na exibição Fonte, o operador copiar do elemento Atribuir2 forma uma seqüência que contém uma data atual e um fuso horário da seguinte forma:

   <assign name="Assign2">    
     <copy>
       <from>concat($inputVar.inputType/ns0:paramA, ' Hoje é ', substring($todayIs, 1, 10), '. O fuso horário é de ', substring($todayIs, 11), '.')</from>
       <to>$outputVar.resultType/ns0:paramA</to>
     </copy>
   </assign>

Para adicionar expressões ao elemento Atribuir3:

Você usará o Editor de fontes para adicionar expressões ao elemento Atribuir3.

Observação: Você pode editar o elemento no mapeador BPEL, se necessário, depois de adicionar uma expressão usando o Editor de fontes.

1. Clique com o botão direito do mouse no elemento Atribuir3 no diagrama BPEL e selecione Ir para o código-fonte no menu pop-up.
2. Substitua a seqüência <assign name="Assign3"/> pela seguinte:

   <assign name="Assign3">    
     <copy>
       <from>concat('Existe(m) ', count($inputVar.inputType/ns0:paramA), ' elemento(s) no conjunto de nós.', 'A soma de elemento(s) é ', sum($inputVar.inputType/ns0:paramA), '. O último elemento é ', $inputVar.inputType/ns0:paramA[last()], '.')</from>
       <to>$outputVar.resultType/ns0:paramA</to>
     </copy>
   </assign>

3. Selecione Arquivo > Salvar.
4. Clique no botão Design na barra de ferramentas do Editor para ir para a exibição Design e ver os resultados na janela Mapeador BPEL.
5. Selecione o elemento Atribuir3 no diagrama BPEL.

   
   Clique para aumentar

   As expressões para o elemento Atribuir3 mostra o número de nós copiados em paramA, calcula a soma de todos os nós e proporciona o valor do último nó. A saída é a seguinte seqüência de amostra: Existe(m) 3 elemento(s) no conjunto de nós. A soma de elemento(s) é 6. O último elemento é 3.

superior