Editando Guia Automação com BPMS Bonita (seção)

===Etapa 8 - Implementar regras de negócio utilizadas no processo===
Nesta etapa do Guia, o objetivo é definir regras de negócio no BPMS que permitam funcionamento do sistema automatizado. Essas regras refletem as políticas adotadas no processo, e existem para satisfazer os objetivos do negócio, satisfazer clientes, fazer o bom uso de recursos, além de obedecer às leis ou regras do próprio negócio. Um bom exemplo, é a utilização de atributos booleanos, que são utilizados no decorrer do processo de automação. Estes atributos podem definir qual caminho o processo irá percorrer, através de seus valores (verdadeiro ou falso). Além disso, as regras de negócio abrangem o disparo automático de mensagens, gatilhos de eventos, como efetuar um pagamento, ou emitir notas fiscais, por exemplo. As regras de negócio são aplicadas dependendo do recurso a ser implementado, como se vê à frente.

====Atividade 8.1====
Associar o BDM às tarefas a serem executadas: nesta atividade serão selecionados os objetos de dados e seus atributos, definidos na etapa 7, para serem associados com as tarefas diagramadas na etapa 6 através de variáveis de negócio. No Bonita Studio existem 4 tipos de variáveis de negócio: ''Business variables, Process variables, Documents, e Parameters'', que podem ser criadas na ''Pool'' do processo.
<br><br>
As ''Business variables'' e as ''Process variables'' estão localizadas na aba ''Data/Pool variables'' (Figura 13).
<br><br>
As ''Business variables'' são as instâncias dos Objetos de dados do BDM que serão utilizadas no processo. No exemplo do processo de Requisição de Informações de Controle, este possui um objeto no BDM chamado P01RequisicaoInformacoes. Para implementar-se as regras de negócios será necessário haver uma respectiva ''Business variable'', podendo-se criar como '''requisicaoInformacoes'''. Essa variável será persistida para o banco de dados.
<br><br>
Já as ''Process variables'' são variáveis para utilização apenas enquanto o processo estiver aberto, como auxiliares, não sendo necessárias agora, e geralmente são utilizadas para:
#Mostrar aos usuários informações pertinentes apenas durante o processo;
#Definir regras de negócio.
Estas variáveis não serão persistidas quando o processo for encerrado.
<br><br>
Os ''Documents'' (Figura 15) são variáveis utilizadas na manipulação de arquivos/documentos que serão inseridos durante o processo. Estas variáveis serão persistidas e devem ser criadas nesta etapa, pois não são gerenciadas pelo BDM.
<br><br>
Os ''Parameters'' (Figura 16) são variáveis que podem ser utilizadas em algum script do processo e são atribuídos valores que são fixos para todos os processos, mas podem vir a mudar com o tempo. Por exemplo, para urls de acesso, para não precisar mudar o script é criado um parâmetro que facilita a alteração do valor. Seria o equivalente a um parâmetro constante em código.
<br><br>
O nome das variáveis deve possuir o primeiro caractere em letra minúscula e não possuir nenhum caractere especial, apenas letras e números (a-z, A-Z, 0-9), sem acentos ou espaços. 

=====Atividade 8.1.1=====
Criar variáveis: criar as variáveis que serão utilizadas no processo.
<br><br>
'''Procedimentos:'''
#Verificar o processo e decidir quais objetos do BDM serão utilizados no processo.
#Selecionar a ''Pool'' do processo e criar uma ''Business variable'' para cada objeto.
#Identificar os possíveis documentos ou arquivos que serão utilizados no processo.
#Criar as variáveis dos documentos.
Convém ressaltar que não necessariamente o processo terá ''Process variables'' ou ''Parameters''. Caso seja verificada a necessidade dos mesmos durante um estágio mais avançado de desenvolvimento, basta selecionar a Pool do processo e criar tais variáveis.
[[Arquivo:B14.png|commoldura|centro|Figura 14 - ''Pool variables''.]]
[[Arquivo:B15.png|commoldura|centro|Figura 15 - ''Documents''.]]
[[Arquivo:B16.png|commoldura|centro|Figura 16 - ''Parameters''.]]

=====Atividade 8.1.2=====
Criar os Contratos de cada tarefa: selecionar as variáveis que serão utilizadas em cada tarefa.
<br><br>
Nesta atividade serão definidos os Contratos das tarefas. Como comentado na etapa 6, o processo começa a ser executado pelo Contrato colocado na aba Execution da Pool. Posteriormente serão definidos/criados os contratos de cada tarefa separadamente.
<br><br>
'''Procedimentos:'''
<br>
#Tarefa da Pool
##Selecionar a Pool, no menu inferior do programa selecionar a aba '''Execution -> Contract''' (Figura 17).
##Selecionar a opção '''Add from data…'''
##Selecionar a ''Business variable'' ou ''Document'', pois são as variáveis que serão persistidas, que se deseja incluir na tarefa.
###''Business variable'':
####Selecionar a variável desejada.
####Selecionar a opção Next.
####Selecionar os atributos que se deseja incluir na tarefa.
####Selecionar a opção Finish.
###''Documents'':
####Selecionar o documento desejado.
####Selecionar a opção Finnish.
#Demais Tarefas:
##Selecionar a tarefa desejada, no menu inferior do programa selecionar a aba '''Execution -> Contract''' (Figura 18).
##Selecionar a opção ''Add from data…''
##Selecionar a Business variable ou documento que se deseja incluir na tarefa.
###Business variable:
####Selecionar a variável desejada.
####Selecionar a opção '''Next'''.
####Selecionar os atributos que se deseja incluir na tarefa.
####Selecionar a opção '''Finish'''.
###''Documents'':
####Selecionar o documento desejado.
####Selecionar a opção Finish.
Caso haja mais do que uma variável e/ou documento, executar novamente o passo 1.3.
<br>
Caso haja mais do que uma variável e/ou documento, executar novamente o passo 2.3.
[[Arquivo:B17.png|commoldura|centro|Figura 17 - Contrato da ''Pool''.]]
[[Arquivo:B18.png|commoldura|centro|Figura 18 - Contrato das outras tarefas.
]]
====Atividade 8.2====
Definir as regras dos fluxos: nesta atividade serão definidas as regras de negócio com o fluxo do processo. Para definir o fluxo serão utilizadas variáveis, de qualquer tipo nesta etapa, porém é mais apropriado utilizar ''Business variables'' ou ''Process variables'', pois o valor dessas variáveis pode vir a ser alterado durante a execução do processo, ao contrário dos ''Parameters''.
<br><br>
Esta atividade será focada em ''Gateways'' que tenham que tomar algum tipo de decisão (''Exclusive'' ou ''Inclusive''). Elementos de decisão fazem parte da notação de processos de negócio (BPMN 2.0), e o Bonita Studio possui as três, sendo eles o ''gateway'' Paralelo (AND), Exclusivo (XOR) e Inclusivo.
<br><br>
O ''gateway'' Paralelo, quando possui apenas uma entrada, e esta entrada é satisfeita, libera todas as saídas simultaneamente; caso possua duas ou mais entradas, necessita que todas as entradas sejam satisfeitas para disparo das saídas e seguimento do fluxo. 
<br><br>
O ''gateway'' Exclusivo, quando possui apenas uma entrada e várias saídas, verifica as saídas e aquela saída que possui uma condição verdadeira é disparada. Neste caso, quando possui mais de uma saída, é necessário configurar uma das saídas como ''default''; quando possui mais do que uma entrada, assim que uma das entradas é satisfeita, uma das saídas é disparada para seguimento do fluxo, sendo que neste gateway apenas uma saída é disparada. Se ele possuir apenas uma saída, nenhuma condição é necessária para ele seguir o fluxo.
<br><br>
O ''gateway'' Inclusivo é uma junção das funções do gateway Paralelo com o Exclusivo. Quando utilizado para fazer a convergência de fluxos, com uma ou mais entradas, ele espera que ambos os fluxos ativos sejam concluídos para liberar suas saídas, atuando como um sincronizador de fluxo. As saídas ativadas dependem das condições estabelecidas, disparando todas as que possuem condições verdadeiras, dessa forma, uma ou mais saídas do gateway poderão dar seguimento ao fluxo. 
<br><br>
Os três elementos mencionados abordam genericamente fluxos de processos em que é necessário criar caminhos alternativos gerando fluxos paralelos ou unificando a sequência de atividades. Os gateways atuam no controle direcionando o fluxo conforme decisões tomadas anteriormente, por exemplo, a alteração de uma variável ao longo do processo anterior ao elemento de decisão. 

=====Atividade 8.2.1=====
Definir caminho através de Gateways: declarar regras de negócio para seguimento do fluxo dos processos que passam por elementos de decisão.
<br><br>
'''Procedimentos:'''
<br>
#Selecionar a linha de saída do elemento de decisão do fluxo (variável com  valor “Sim” no exemplo da Figura 19).
#Selecionar a aba '''General''' (Figura 20).
#Selecionar a opção '''Use expression'''.
#Selecionar o '''Lápis''' de edição ao lado da caixa de seleção. Abrirá uma tela.
#Selecionar a aba '''Script''' (Figura 21).
#Utilize o “Assistente de programação” pressionando '''“Ctrl’ + “Barra de Espaço”''': procure por variáveis e métodos que permitam testar o valor do fluxo. O resultado deste script será um ''boolean'', e passará se validado “true” (este código no script estará gerado em ''groovy'').
##Selecionar a opção '''Ok'''.
#Selecionar a linha de saída do elemento de decisão, do fluxo caso a variável possua o valor “Não”.
##Selecionar a aba '''General'''.
##Selecionar a opção '''Default flow'''.
[[Arquivo:B19.png|commoldura|centro|Figura 19 - Fluxo com elemento de decisão.]]
<br>
A Figura 19 exemplifica uma utilização do gateway XOR.
<br>
[[Arquivo:B20.png|commoldura|centro|Figura 20 - Definição do caminho "Sim".]]
[[Arquivo:B21.png|commoldura|centro|Figura 21 - Regra de negócio do caminho "Sim".]]

====Atividade 8.3====
Mapear atores: mapear os atores definidos na Etapa 6, segundo a regra de negócio que define quais usuários podem executar tarefas de cada raia.
<br><br>
'''Procedimentos:'''
#Selecionar a ''Pool'' do processo;
#No menu superior, selecionar a aba '''Server -> Configure''';
#Na caixa de diálogo '''Local configuration for <nome do processo>''' selecionar a aba '''Actor mapping''' (Figura 22);
#Selecionar o ator, e um dos 4 botões no lado direito da caixa de diálogo ('''Groups…, Roles…, Memberships…, Users…'''). Ao selecionar o botão, abrirá outra caixa de diálogo;
#'''Caso selecionado Groups, Roles ou Users:'''
##Selecionar as ''checkboxes'' que correspondem ao ator em questão (Figura 23);
#'''Caso selecionado Memberships:'''
##Selecionar o botão '''Add memberships…''', selecionar um grupo e um papel para cada '''Membership''' adicionado (Figura 24);
##Selecionar o botão '''Finish''', para aplicar esta configuração ao ator; 
#Realizar o passo 4 para cada ator do processo;
#Selecionar o botão '''Finish''' para aplicar as configurações de mapeamento dos atores no processo.
[[Arquivo:B22.png|commoldura|centro|Figura 22 - Tela de diálogo ''Local configuration''.]]
[[Arquivo:B23.png|commoldura|centro|Figura 23 - Mapeamento de atores por papéis.]]
[[Arquivo:B24.png|commoldura|centro|Figura 24 - Mapeamento de atores por memberships.]]
'''Observações, dicas e boas práticas:'''
<br>
A linguagem ''groovy'' é baseada na linguagem ''java'', mas possui características de ''small talk'', o que torna a programação mais simples do que ''java''. A linguagem ''groovy'' possui tipagem dinâmica.
<br><br>
Utilizar boas práticas de programação, uso de indentação e comentários, torna mais fácil o trabalho em equipes com várias pessoas.