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

===Etapa 10 - Integrar o processo com sistemas externos ao Bonita===
Nesta Etapa do Guia, o objetivo é conectar sistemas externos ao Bonita Studio, identificados na Etapa 5, que serão utilizados para tratamento de e-mails, obtenção de informações que estão fora do escopo do Bonita, através de sistemas legados, entre outros. 
<br><br>
Nos processos implementados até o momento foram utilizados apenas dois sistemas externos, que são chamados de conectores dentro do ambiente do Bonita Studio, o de e-mail, e o REST (Transferência de Estado Representacional) para obter informações através de API’s (Interface de Programação de Aplicativos) de web services (sistemas legados) da infraestrutura de informática da Universidade Federal de Santa Catarina (UFSC).
<br><br>
Os conectores no Bonita são definidos como conectores de entrada, quando acontecem antes do início de uma tarefa, ou conectores de saída quando ocorrem depois que uma tarefa termina. E são implementados dentro das tarefas que se deseja que possuam tais conectores.
<br><br>
====Atividade 10.1====
Integrar o processo com sistema de e-mail: nesta atividade será implementado o uso de conectores de e-mail.
<br><br>
Utilizar das regras de negócio e da estrutura do processo para implementar os conectores de e-mail, pois nesta etapa já temos uma ideia de quem receberá as mensagens de aviso de andamento do processo.

'''Procedimentos:'''
<br> 
#Identificar os usuários que receberão mensagens de andamento do processo
#Para cada tarefa que necessitar de um conector de e-mail (Figura 28), implementar o mesmo com os seguintes dados:  
#*''smtp host'' servidor host para envio de e-mail; 
#*número da porta de envio do servidor; 
#*definição do endereço de e-mail do usuário que receberá a mensagem;
#*conteúdo da mensagem. Variáveis podem ser inseridas na mensagem utilizando a tag ‘${nomeVariável}’, tais como: parâmetros, variáveis de processos, negócios ou APIs. Pressionando as teclas ‘Ctrl + Espaço'  é possível visualizar a listagem de todas as variáveis disponíveis e selecionar as de interesse.
<br>
Todas as configurações do conector de email são apresentadas nas Figuras 29, 30, 31 e 32, como segue
[[Arquivo:B28.png|commoldura|centro|Figura 28 - Elemento de tarefa de serviço com conector.]]
[[Arquivo:B29.png|commoldura|centro|Figura 29 - Tarefa com conector de saída.]]
[[Arquivo:B30.png|commoldura|centro|Figura 30 - Definição do host e da porta de envio.]]
[[Arquivo:B31.png|commoldura|centro|Figura 31 - Definição do usuário que receberá a mensagem.]]
[[Arquivo:B32.png|commoldura|centro|Figura 32 - Definição do Assunto da mensagem e do seu conteúdo.]]
<br>
'''Instrumentação:'''
<br>
Bonita Studio conector de mensagem SMTP 1.0.0.

====Atividade 10.2====
Integrar o processo com sistema REST: nos processos implementados até o momento, por motivos didáticos, optou-se por apenas realizar acesso de busca a dados de um sistema legado. Portanto, utilizou-se apenas o conector REST, o que se faz com o método GET.
<br><br>
'''Procedimentos:'''
<br>
#Selecionar a tarefa que irá utilizar o conector REST.
#Na aba '''Execution -> Connectors in''', selecionar a opção '''Add'''.
#Na tela '''Connector definitions''' (Figura 33), selecionar na aba '''Categories''' a opção '''REST''', e na aba '''Connectors definitions''' a opção '''GET''', e selecionar a opção Next.
#Na tela General (Figura 34), criar um nome para o conector. Pode também ser adicionado uma descrição, mas é opcional, e selecionar a opção '''Next'''.
#Na tela '''REST request configuration''' (Figura 35), informar a url de acesso do conector e selecionar a opção '''Next'''. Neste passo, nos processos implementados até o momento, utilizamos um ''script'' que concatena um ''Parameter'' contendo uma parte da url com uma ''Process variable'' que contém o “idpessoa” do usuário (estudo de caso da UFSC) que necessitamos a informação.
#Na tela '''Optional advanced settings''' (Figura 36) apenas selecionar a opção '''Next'''.
#Na tela '''Authentication settings''' (Figura 37), selecionar '''Authentication BASIC''', selecionar o '''Username''' e '''Password''' de acesso da API REST utilizada, e selecionar a opção '''Next'''. Neste passo utilizamos ''Parameters'' para o '''Username''' e '''Password'''.  O método de autenticação pode mudar de um processo para outro.
#Na tela '''SSL configuration''' (Figura 38) apenas selecionar a opção '''Next'''.
#Na tela '''Proxy settings''' (Figura 39) apenas selecionar a opção '''Next'''.
#Na tela '''Output operations''' (Figura 40) são definidos quais atributos serão selecionados do resultado retornado pela API REST utilizada. Após selecionar os dados, selecionar a opção '''Finish''', finalizando assim a configuração do conector REST.

[[Arquivo:B33.png|commoldura|centro|Figura 33 - ''Connector definition''.]]
[[Arquivo:B34.png|commoldura|centro|Figura 34 - ''General''.]]
[[Arquivo:B35.png|commoldura|centro|Figura 35 - ''Rest request configuration''.]]
[[Arquivo:B36.png|commoldura|centro|Figura 36 - ''Optional advanced settings''.]]
[[Arquivo:B37.png|commoldura|centro|Figura 37 - ''Authentication settings''.]]
[[Arquivo:B38.png|commoldura|centro|Figura 38 - ''SSL configuration''.]]
[[Arquivo:B39.png|commoldura|centro|Figura 39 - ''Proxy settings''.]]
[[Arquivo:B40.png|commoldura|centro|Figura 40 - ''Output operations''.]]

<br>

'''Observações, dIcas e boas práticas:'''
<br>
Quando os parâmetros dos conectores são implementados através de variáveis ou expressões, não é possível realizar testes de funcionamento do conector no ambiente do Bonita Studio. Portanto, esse conector não pode ser testado no Studio, sendo necessário executar o processo para verificar o funcionamento.
<br><br>
Testar o conector REST para verificação da configuração dos dados que o mesmo retorna. Para realizar esse teste, basta inserir valores fixos nos campos ao invés de usar parâmetros e variáveis. 
A configuração dos conectores podem ser salvas para possível reutilização do mesmo através do botão ''Save''. E para importar a configuração em outro conector do mesmo tipo, basta clicar no botão ''Load''.
<br><br>
Como e-mail é utilizado para realizar uma tarefa de envio de mensagens, a utilização de conectores de e-mail foi realizada através de conectores de saída como padrão. E os conectores REST que foram utilizados para acessar informações foram definidos como conectores de entrada por padrão.
<br><br>
Os passos de configuração podem variar devido à utilização de variáveis e parâmetros. Neste Guia a configuração dos conectores foi baseada nos processos já implementados pelos desenvolvedores.