wiki:WF/implantacaoexemplo

Implantação de um Processo Exemplo

Estão disponíveis para instalação alguns exemplos de processos de workflow. O primeiro deles é o processo "Music CD Loans", que significa "Empréstimo de CDs". É um exemplo didático apenas, sem pretenção de utilização profissional. Foi mantido o nome original porque este é o processo que acompanha o motor  Galaxia, que o módulo workflow incorpora.

Procedimentos para implantação

  • Baixe o arquivo xml do processo;

Explicação: um dos recursos que o Galaxia disponibiliza é a representação de um processo em formato xml. Com o arquivo xml pode-se restaurar toda a estrutura do processo (atividades, transições, perfis, scripts php, templates, imagens, etc). Só não é representada a associação de perfis à usuários, porque pode variar de um ambiente Expresso para outro.

  • Salve-o em uma pasta qualquer do seu computador local;
  • Clique no menu lateral esquerdo (aquele que é uma aba na lateral com uma seta);
  • Clique no link "Administrar Processos";
  • Na caixa "Importar um Processo", informe o arquivo xml baixado anteriormente;
  • Clique no botão "Upload";

Com isso o arquivo xml será carregado e o Workflow irá criar o processo. Será exibida uma mensagem de sucesso e o processo estará disponível na lista de processos, ao final da página. Agora é necessário configurá-lo:

  • Na lista de processos, clique sobre o nome dele: "Music CD Loans". Na parte de cima da página aparecerão os dados básicos do processo;
  • Os parâmetros básicos já virão configurados. Alguns são herdados da configuração geral do módulo. São aqueles que estão com a opção "Usar Padrão" assinalada. Não há necessidade de alterar qualquer um deles, exceto as configurações de banco de dados;
  • Na seção "Opções de Banco de Dados", preencha com:
     Nome do Banco de Dados: workflow
     Usuário: admin_cds
     Senha: admin_cds
    
     Desmarque os checkboxes "Usar Padrão" que estão à direita destes campos.
    

Um esclarecimento: quando da instalação do módulo, foi criado o banco de dados 'workflow' no mesmo servidor onde já reside o banco 'expresso'. Dentro deste banco já foram carregados os dados para o processo "Music CD Loans'. Eles estão dentro do schema 'cds'. Também foi criado o usuários admin_cds com permissão total apenas no schema 'cds', que será usado neste exemplo. Não possui permissão em outros schemas.

  • Clique no botão "Atualizar" (para salvar os dados do processo);

O próximo passo será associar os Perfis do processo aos usuários responsáveis. Só relembrando, perfis são como o controle de acesso do processo. Quem estiver no perfil poderá executar as atividades que determinado perfil representa.

  • Na lista de processos, clique no link "Perfis" do processo "Music CD Loans". Será aberta uma nova página;
  • Na seção "Mapear usuários/grupos a perfis" há duas caixas de listagem. A da esquerda lista os perfis do processo;
  • Para cada um deles (perfis admin e user) faça:
    • Clique sobre o perfil na esquerda, e depois no botão "Adicionar" (à direita);
    • Será aberta uma página pop-up para serem selecionados usuários e grupos;
    • Procure o grupo administradores do seu Expresso (provavelmente Admins) e clique no botão de adição;
    • Procure o seu usuário pessoal e clique no botão de adição novamente;
    • Feche a janela pop-up;
    • Na caixa de listagem da direita deverão estar presentes os usuários e grupo que foram selecionados anteriormente;
    • Agora clique no botão "Mapear" que está entre as duas caixas de listagem;
  • Os mapeamentos serão registrados, e estarão visíveis no final da página, na seção "Lista de mapeamentos". Confira se estão corretos;
  • Agora só falta ativar o processo. Para isso, clique no link "Ativar" também localizando no topo da página.

O processo está pronto para uso.

Vá para a interface de usuário (página inicial do Workflow - clique sobre o ícone do módulo);

  • Clique na aba "Processos". Deverá estar visível o ícone do processo;
  • Passe o mouse sobre o ícone do processo para aparecer o menu de atividades;
  • Clique na atividade "Solicitar". Será aberto o formulário da atividade;
  • Selecione um CD na lista e clique no botão "Solicitar";
  • Será exibida uma página de conclusão da atividade;
  • Clique sobre o ícone "Tarefas Pendentes";
  • Será exibida a página inicial do Workflow (interface do usuário). Só que desta vez estará posicionada na aba de "Tarefas Pendentes";
  • Nesta aba deverá existir uma instância do processo "Music CD Loans", situada na atividade "Aprovar";
  • Clique na ação "Executar" (ícone da seta verde) para dar prosseguimento ao fluxo do processo.

Dicas:

  • Se quiser ver o gráfico do processo, ele está acessível no menu de atividades do processo;
  • Se quiser ver o histório da instância, clique na ação "Visualizar" (ícone da lupa)