Passo-a-Passo configuração do .bos

1º Passo

Fazer o download dos arquivos Progressão Vertical-1.1.bos e ine.xml que estão na pasta _EAP -> Backup Processos do Drive

2º Passo

Abrir o programa BonitaBPM e importar o arquivo Progressão Vertical-1.1.bos para o workspace, segue a figura 1:

Figura 1

3º Passo

Após a seleção do arquivo Progressão Vertical-1.1.bos, aparecerá outra tela parecida com a seguinte:

Figura 2

Selecione 1º a opção Overwrite All caso haja algum conflito, e logo após selecione a opção Import. A importação do projeto está concluída.

4º Passo

Na aba Organizations da barra de ferramentas (ou menu) superior do Bonita Studio selecione a aba Manage… e confira se a organização ine está instalada como:

Figura 3

Caso a organização ine já esteja instalada mas não esteja no estado (active) pule ao 6º Passo, caso ine já esteja instalada e no estado (active) como mostrado na Figura 3 pule para o 7º Passo, caso contrário siga para o 5º Passo normalmente.

5º Passo

Faça o download do arquivo ine.xml, que está na pasta _EAP -> Backup Processos, entre no programa Bonita Studio, na barra de ferramentas superior, selecione a aba Organization -> Import…, selecione o arquivo ine.xml, caso ocorra tudo bem, deverá aparecer uma tela avisando que a organização foi importada com sucesso (essa organização não possui erros, caso ocorra algum erro verificar se o procedimento foi realizado como descrito acima).

6º Passo

No Bonita Studio, selecione a aba Organization -> Publish..., aparecerá uma tela como a seguir:

Figura 4

Como na Figura 4 selecione a organização ine e após selecione Next >, e aparecerá uma tela para selecionar um usuário pertencente a organização a fim de conectar no Bonita Portal:

Figura 5

Na caixa de inserção do usuário enquanto for escrevendo Username aparecerá uma sugestão de preenchimento, o usuário acima está na organização portanto não há problemas de colocar o mesmo. Após preenchido o campo do usuário selecione a opção Publish, e depois deverá aparecer uma mensagem de conclusão da publicação da organização (essa organização não possui erros, caso ocorra algum erro verificar se o procedimento foi realizado como descrito acima). Após esse processo ao verificar a organização na aba Organizations > Manage… a situação da organização ine deve estar igual a da Figura 3.

7º Passo

Abra o projeto Progressão Vertical(1.1) no Bonita Studio, vá na aba Server -> Configure:

7-1

Na aba Actors Mapping verifique se todos os atores estão mapeados, caso não estejam seleciona cada Actor, por exemplo, Secretaria do Departamento e atribua essa função a àqueles usuários que deverão executar a tarefa deste Actor, através dos Groups, Roles, Memberships e Users.

7-2

Na aba Parameters verifique se os parâmetros estão corretos:

wsurl = http://ws-dev.processos.ufsc.br
wsuser = eap
wspasswd = eappw
smtphost = mail-dev.processos.ufsc.br

Caso estejam de acordo, mantenha-os assim, caso estejam em branco preencha-os com os valores acima, caso não estejam definidos vá para o 9º Passo.

7-3

Na aba Authentication verifique se o Username definido está de acordo com o utilizado no 6º Passo, a senha de todos os usuários da organização é bpm. Repita esta senha no campo Password para garantir que não haverá problemas de login do sistema no portal local (mesmo assim poderá ocorrer falha no login, pois o arquivo interno de configuração do Bonita Studio não será alterado, isto não é um problema, caso aconteça efetue o login com usuário e senha bpm normalmente na tela de login do Bonita Portal).

7-4

Selecione a opção Finish para concluir e confirmar as alterações realizadas.

8º Passo

Selecione a Pool do processo vá na aba Data e verifique se as seguintes variáveis de processo (Process Variables) estão definidas:

cargo: Text
email: Text
idpessoa: Long
lotacao: Text
nome: Text
siape: Integer
telefonePreferencial: Long

Estas variáveis já devem estar definidas, caso não estejam basta criá-las ao selecionar a opção Add… na aba Process Variables.

9º Passo

Na aba Data -> Parameters certifique-se de que os parâmetros comentados no 7º Passo estejam definidos de acordo:

wsurl: Text
wsuser: Text
wspasswd: Text
smtphost: Text

Caso eles não estejam definidos será necessário defini-los e verificar todos os conectores que os utilizam, o conector REST e os conectores de Email.

10º Passo

Caso todas as variáveis e parâmetros tenham sido definidos(as) passe para o 12º Passo. Caso alguma das variáveis e/ou parâmetros citados nos passo 8 e 9 não tenha sido definidos(as) segue:

Variáveis de Processo

10-1.1

cargo (Text), lotacao (Text), siape (Integer), telefonePreferencial (Long): Os procedimentos são iguais, o que mudam entre essas variáveis são o tipo, como especificado no 8º Passo, seguem as Figura 6 e Figura 7 para auxílio:

Figura 6

Figura 7

O Default value dessas variáveis é deixado em branco

10-1.2

nome, email, idpessoa: Novamente procedimentos parecidos primeiro criar a variável de acordo com a Figura 6, e seguir pelas Figuras 8 e 9:

Figura 8

Figura 9

Apenas o número 5 se difere para os 3 (colocar apenas o código no script não o nome da variável):

nome (Text)

BonitaUsers.getProcessInstanceInitiator(apiAccessor,processInstanceId).getFirstName() + " " + BonitaUsers.getProcessInstanceInitiator(apiAccessor,processInstanceId).getLastName()

email (Text)

BonitaUsers.getProcessInstanceInitiatorProfessionalContactInfo(apiAccessor,processInstanceId).getEmail()

idpessoa (Long)

for (Object obj : apiAccessor.getIdentityAPI().getCustomUserInfo(BonitaUsers.getProcessInstanceInitiator(apiAccessor,processInstanceId).id, 0, 0)) {
    if (obj.definition.name == "idpessoa") {
   	 return Long.parseLong(obj.value);
    }
}
return 0;

Feito isso, todas as variáveis de processos estarão definidas corretamente.

Parâmetros (Parameters)

wsurl (Text), wsuser (Text), wspasswd (Text), smtphost (Text): Os procedimentos para definição dos parâmetros são idênticos, seguem abaixo duas figura para auxílio:

Figura 10

Figura 11

Com isto todos os parâmetros estão corretamente definidos.

11º Passo

Este passo só será necessário se alguma das variáveis e ou parâmetros não tenha sido inicializado com a importação do programa, ou seja, caso tenha realizado o 10º Passo. Arrumando os conectores REST e de Email.

Email

O conector de email sofrerá erros caso o parâmetro smtphost não tenha sido definido na importação do projeto. Os conectores de email estão localizados, 1 na lane do Servidor antes da tarefa Decidir Ajuste do Processo, 1 na lane da Secretaria do Departamento depois da tarefa Arquivar Processo, e 1 na lane da Comissão de Avaliação depois do Gateway 9, todos os conectores de email estão em tarefas de serviço, e são conectores de saída, selecionar as tarefas que possuem engrenagens no canto superior esquerdo (indica serviço), na aba Execution -> Connectors out selecionar o conector que se deseja arrumar. Todos os conectores de email deverão ser arrumados da seguinte maneira:

Figura 12

Figura 13

Figura 14

Figura 15

REST

O único conector REST do processo está localizado na tarefa Formalizar Processo e é um conector de entrada. Selecione a tarefa Formalizar Processo na aba Execution -> Connectors in como segue nas figuras:

Figura 16

Figura 17

Figura 18

Figura 19

Na Figura 19 idpessoa e wsurl são consertadas. No 7º passo colocar a seguinte composição de string:

return wsurl + "/CadastroPessoaService/getVinculosPessoaAtivosById?idPessoa=" + idpessoa + "&codigoVinculo=4"

Figura 20

Figura 21

Figura 22

Figura 23

Basta seguir os passos conforme sequenciados nas figuras para arrumar os parâmetros wsuser e wspasswd.

Figura 24

Figura 25

Figura 26

No 22º passo é necessário selecionar as variáveis de processo que foram criadas, quando terminar de arrumar uma variável selecionar o Add para adicionar outra variável, caso não possua nenhuma variável nesta tela, ou que todas as variáveis estejam em branco.

Figura 27

O 25º passo depende cada variável (colocar somente a parte de código, não está em negrito):

cargo

bodyAsObject[0].nomeCargo

lotacao

bodyAsObject[0].siglaLocalizacao

siape

bodyAsObject[0].siape

telefonePreferencial

bodyAsObject[0].telefones[0].numero

Fazendo isso todos os conectores estarão funcionando corretamente.

• OBS: O Test dos conectores não funciona com parâmetros e expressões, mas os mesmo estarão funcionando quando rodar o processo

12º Passo

Acesse o Bonita Portal, indo no Bonita Studio e selecionando a caixa do portal. No portal entre com Administrator, segue as imagens do tutorial:

Figura 28

Figura 29

Figura 30

Na Figura 30 1º passo selecionar o arquivo ine.xml.

Pronto, agora todo o processo está funcionando corretamente!
OBS* Final
Relembrando a senha de todos os usuários é:
bpm
para facilitar o acesso.