Editando 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:
[[Arquivo:Config bos.png|commoldura|centro|Figura 1]]

==3º Passo==
Após a seleção do arquivo '''Progressão Vertical-1.1.bos''', aparecerá outra tela parecida com a seguinte:
[[Arquivo:Config bos2.png|commoldura|centro|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:
[[Arquivo:Config bos3.png|commoldura|centro|Figura 3]]
Caso a organização '''ine''' já esteja instalada mas não esteja no estado ('''active''') pule ao [[Passo-a-Passo_configuração_do_.bos#6.C2.BA_Passo|6º Passo]], caso '''ine''' já esteja instalada e no estado ('''active''') como mostrado na Figura 3 pule para o [[Passo-a-Passo_configuração_do_.bos#7.C2.BA_Passo|7º Passo]], caso contrário siga para o [[Passo-a-Passo_configuração_do_.bos#5.C2.BA_Passo|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:
[[Arquivo:Config bos4.png|commoldura|centro|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''':
[[Arquivo:Config bos5.png|commoldura|centro|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:
<br><br>
'''wsurl = http://ws-dev.processos.ufsc.br'''
<br>
'''wsuser = eap'''
<br>
'''wspasswd = eappw'''
<br>
'''smtphost = mail-dev.processos.ufsc.br'''
<br><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 [[Passo-a-Passo_configuração_do_.bos#9.C2.BA_Passo|9º Passo]].

===7-3===
Na aba '''Authentication''' verifique se o '''Username''' definido está de acordo com o utilizado no [[Passo-a-Passo_configuração_do_.bos#6.C2.BA_Passo|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:
<br><br>
'''cargo: Text'''
<br>
'''email: Text'''
<br>
'''idpessoa: Long'''
<br>
'''lotacao: Text'''
<br>
'''nome: Text'''
<br>
'''siape: Integer'''
<br>
'''telefonePreferencial: Long'''
<br><br>
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 [[Passo-a-Passo_configuração_do_.bos#7.C2.BA_Passo|7º Passo]] estejam definidos de acordo:
<br><br>
'''wsurl: Text'''
<br>
'''wsuser: Text'''
<br>
'''wspasswd: Text'''
<br>
'''smtphost: Text'''
<br><br>
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 [[Passo-a-Passo_configuração_do_.bos#12.C2.BA_Passo|12º Passo]]. Caso alguma das variáveis e/ou parâmetros citados nos passo [[Passo-a-Passo_configuração_do_.bos#8.C2.BA_Passo|8]] e [[Passo-a-Passo_configuração_do_.bos#9.C2.BA_Passo|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 [[Passo-a-Passo_configuração_do_.bos#8.C2.BA_Passo|8º Passo]], seguem as Figura 6 e Figura 7 para auxílio:
[[Arquivo:Config bos6.png|commoldura|centro|Figura 6]]
[[Arquivo:Config bos7.png|commoldura|centro|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:
[[Arquivo:Config bos8.png|commoldura|centro|Figura 8]]
[[Arquivo:Config bos9.png|commoldura|centro|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):
<br><br>
'''nome (Text)'''
<pre>
BonitaUsers.getProcessInstanceInitiator(apiAccessor,processInstanceId).getFirstName() + " " + BonitaUsers.getProcessInstanceInitiator(apiAccessor,processInstanceId).getLastName()
</pre>

'''email (Text)'''
<pre>
BonitaUsers.getProcessInstanceInitiatorProfessionalContactInfo(apiAccessor,processInstanceId).getEmail()
</pre>

'''idpessoa (Long)'''
<pre>
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;
</pre>
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:
[[Arquivo:Config bos10.png|commoldura|centro|Figura 10]]
[[Arquivo:Config bos11.png|commoldura|centro|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 [[Passo-a-Passo_configuração_do_.bos#10.C2.BA_Passo|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 ou'''t selecionar o conector que se deseja arrumar. Todos os conectores de email deverão ser arrumados da seguinte maneira:
[[Arquivo:Config bos12.png|commoldura|centro|Figura 12]]
[[Arquivo:Config bos13.png|commoldura|centro|Figura 13]]
[[Arquivo:Config bos14.png|commoldura|centro|Figura 14]]
[[Arquivo:Config bos15.png|commoldura|centro|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:
[[Arquivo:Config bos16.png|commoldura|centro|Figura 16]]
[[Arquivo:Config bos17.png|commoldura|centro|Figura 17]]
[[Arquivo:Config bos18.png|commoldura|centro|Figura 18]]
[[Arquivo:Config bos19.png|commoldura|centro|Figura 19]]
Na Figura 19 '''idpessoa''' e '''wsurl''' são consertadas. No [[Passo-a-Passo_configuração_do_.bos#7.C2.BA_Passo|7º passo]] colocar a seguinte composição de string:
<pre>
return wsurl + "/CadastroPessoaService/getVinculosPessoaAtivosById?idPessoa=" + idpessoa + "&codigoVinculo=4"
</pre>
[[Arquivo:Config bos20.png|commoldura|centro|Figura 20]]
[[Arquivo:Config bos21.png|commoldura|centro|Figura 21]]
[[Arquivo:Config bos22.png|commoldura|centro|Figura 22]]
[[Arquivo:Config bos23.png|commoldura|centro|Figura 23]]
Basta seguir os passos conforme sequenciados nas figuras para arrumar os parâmetros '''wsuser''' e '''wspasswd'''.
[[Arquivo:Config bos24.png|commoldura|centro|Figura 24]]
[[Arquivo:Config bos25.png|commoldura|centro|Figura 25]]
[[Arquivo:Config bos26.png|commoldura|centro|Figura 26]]
No [[Passo-a-Passo_configuração_do_.bos#22.C2.BA_Passo|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.
[[Arquivo:Config bos27.png|commoldura|centro|Figura 27]]
O [[Passo-a-Passo_configuração_do_.bos#25.C2.BA_Passo|25º passo]] depende cada variável (colocar somente a parte de código, não está em negrito):
<br><br>
'''cargo'''
<br>
<pre>bodyAsObject[0].nomeCargo</pre>
<br><br>
'''lotacao'''
<br>
<pre>bodyAsObject[0].siglaLocalizacao</pre>
<br><br>
'''siape'''
<br>
<pre>bodyAsObject[0].siape</pre>
<br><br>
'''telefonePreferencial'''
<pre>bodyAsObject[0].telefones[0].numero</pre>
<br><br>
Fazendo isso todos os conectores estarão funcionando corretamente.
<br><br>
*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:
[[Arquivo:Config bos28.png|commoldura|centro|Figura 28]]
[[Arquivo:Config bos29.png|commoldura|centro|Figura 29]]
[[Arquivo:Config bos30.png|commoldura|centro|Figura 30]]
Na Figura 30 '''1º passo''' selecionar o arquivo '''ine.xml'''.
<br><br>
Pronto, agora todo o processo está funcionando corretamente!
<br>
OBS* Final
<br>
Relembrando a senha de todos os usuários é:
<br>
'''bpm'''
<br>
para facilitar o acesso.