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

====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.