Manuais
PHC GO BPM - Tipos de workflow
 
O ecrã de Tipos de workflow serve para que possamos introduzir e configurar os tipos de workflow que pretendemos utilizar na nossa instalação.Para aceder a este ecrã deve de aceder a menu(Menu)>settings(Definições)>BPM>Tipos de workflow

manage_searchTópicos Relacionados



Para além das ações genéricas disponíveis à entrada do ecrã existe também a ação genérica Importe registo que permite a importação de um registo exportado de outra aplicação.

infoInformações

Isto é um conteúdo do add-on BPM disponível a partir do plano Enterprise.

Este add-on é da responsabilidade do Developer PHC.




Este ecrã é composto por um cabeçalho e três secções, Detalhes, Previsão de diagrama e Variáveis

Para introduzir um novo tipo de workflow basta clicar no botão
Introduza tipo de workflow


Passamos agora a explicar cada campo que compõe este ecrã.

O cabeçalho deste ecrã é constituído pelos seguintes campos:

  • Nome - Campo que serve para identificar o workflow.

  • Serie - Campo incrementado pelo PHC GO, contudo, pode ser alterado pelo utilizador. Não é possível gravar tipos de workflow com o mesmo numero de serie.

  • Versão - Valor incrementado pelo PHC GO cada vez que o desenho do workflow passa de rascunho a finalizado.

Esta secção é composta apenas pelos campos Grupo e Descrição. O campo Grupo é uma tabela dinâmica em que o utilizador poderá selecionar um dos grupos disponíveis ou introduzir um novo grupo diretamente no campo.
O campo Descrição serve para dar uma descrição mais detalhada do tipo de workflow.
Esta secção serve para desenhar o workflow com os seus elementos e as ligações entre si.

Para dar inicio ao desenho do workflow grave o tipo de workflow e nas ações de registo selecione a ação Desenhe diagrama

Esta secção apenas está visível no ecrã em modo consulta, em modo de edição esta secção fica oculta.
A secção variáveis é onde irão ficar visíveis todas as variáveis que foram configuradas no workflow.Para introduzir uma nova variável no tipo de workflow, selecione a ação de registo Desenhe diagrama e clique no botão
Configuração
.



Ações de registo especificas do ecrã tipos de workflow


  • Desenhe diagrama - Esta ação serve para que possa entrar no modo desenho do diagrama para construir um diagrama novo ou alterar um diagrama já criado.

  • Disponibilize tipo de workflow - Serve para tornar o workflow operacional após ter efetivado o desenho do mesmo.

  • Exporte registo - Esta ação serve para exportar o diagrama para um ficheiro de forma a pode-lo importar noutra instalação.

  • Veja o código do BPM - Serve para descarregar um ficheiro com extensão .vb com o código do workflow.

  • Verifique se o código tem erros - Serve para a fazer um diagnostico ao workflow e validar se o mesmo contem erros ou não.



Configuração do tipo de workflow


Para aceder ás configurações do workflow selecione a ação de registo Desenhe diagrama e clique no botão
Configuração


A configuração do tipo de workflow é constituído por um cabeçalho e por várias secções que passamos a explicar.

Os campos do cabeçalho são incrementados pela informação introduzida nos campos do cabeçalho do tipo de workflow.

Quanto ás secções da configuração disponibilizamos a seguintes:
Esta secção é composta pelos seguintes campos:

  • Detalhes - Serve para detalhar o tipo de workflow

  • Apenas um ativo - Ao ativar este campo significa que apenas é permitido um workflow ativo do mesmo tipo em execução.

  • Usa anexos - Ao ativar este campo significa que o tipo de workflow fica habilitado a utilizar anexos.

  • Usa ligações - Ao ativar este campo significa que o tipo de workflow fica habilitado a utilizar ligações quer internas ou externas.
A secção dos acessos serve para indicar quem irá ter acesso à supervisão do workflow.

Esta secção é composta pelos seguintes campos:

  • Tipo de acesso de supervisão - Este campo serve para definir um dos três tipos de acesso de supervisão.

  • Perfil de acesso de supervisão - Campo apenas disponível quando no campo Tipo de acesso de supervisão é selecionada a opção Acesso por perfil

  • Utilizador com acesso de supervisão - Campo apenas disponível quando no campo Tipo de acesso de supervisão é selecionada a opção Acesso privado para um utilizador
É o primeiro código a correr de todo o workflow, mesmo antes de correr o ´Código ao iniciar´ do evento que iniciou o workflow, é a altura ideal para definir valores para as variáveis, ou alterar outras configurações do workflow ou da atividade que está a ser processada, pode usar ´SDKBPM´ para facilmente aceder ao SDK do BPM e assim efetuar as operações desejadas.

Retorno
Atenção, se for retornada alguma mensagem de erro ´MsgError´ ou ocorrer erro na execução do código, o workflow é cancelado, todas as mensagens retornadas são registradas no log do workflow e se o evento que iniciou o workflow tiver momento de confirmação pelo utilizador, essas mensagens também são mostradas ao utilizador.

Payload
Se o workflow foi iniciado a partir do ecrã de clientes quando se consultava o cliente João, esses dados estão dentro do workflow através de uma variável especial e em qualquer altura da execução do workflow pode-se obter esses dados da seguinte maneira:
  • Dim cliente as ClVO = SDKBPM.GetPayload(Of ClVO)()

Contexto
  • SDKBPM.GetProcess() = Tipo de workflow iniciado BPMProcessVO
  • SDKBPM.GetWorkflow() = Workflow iniciado BPMInstanceVO
  • SDKBPM.GetActivity() = Atividade que está a ser processada BPMActivityVO
  • SDKBPM.GetElement() = Elemento que deu origem á atividade BPMElement
  • SDKBPM.GetElement(Of BPMEventVO)()
  • SDKBPM.GetElement(Of BPMFlowVO)()
  • SDKBPM.GetElement(Of BPMGatewayVO)()
  • SDKBPM.GetElement(Of BPMActionVO)()

Definir valores de variáveis
  • SDKBPM.SetVar(´Cod02´, ´Meu resumo inicial´)

Obter valores de variáveis
  • SDKBPM.GetVar(´Cod02´), retorna Object
  • SDKBPM.GetVar(Of String)(´Cod02´), retorna String
Quando uma atividade altera o valor do estado do workflow este código é executado automaticamente, permitindo assim reagir a essa alteração e poder enviar mensagens ou notificações sobre o que acabou de ocorrer ou então executar outro tipo de procedimento no workflow relacionado com a alteração do estado, pode usar ´SDKBPM´ para facilmente aceder ao SDK do BPM e assim efetuar as operações desejadas.

Retorno
Se for retornada alguma mensagem de erro ´MsgError´ ou ocorrer erro na execução do código a alteração do valor do estado é cancelada mas o workflow continua em execução, todas as mensagens retornadas são registradas no log do workflow.

Payload
Se o workflow foi iniciado a partir do ecrã de clientes quando se consultava o cliente João, esses dados estão dentro do workflow através de uma variável especial e em qualquer altura da execução do workflow pode-se obter esses dados da seguinte maneira:
  • Dim cliente as ClVO = SDKBPM.GetPayload(Of ClVO)()

Contexto
  • SDKBPM.GetProcess() = Tipo de workflow iniciado BPMProcessVO
  • SDKBPM.GetWorkflow() = Workflow iniciado BPMInstanceVO
  • SDKBPM.GetActivity() = Atividade que está a ser processada BPMActivityVO
  • SDKBPM.GetElement() = Elemento que deu origem á atividade BPMElement
  • SDKBPM.GetElement(Of BPMEventVO)()
  • SDKBPM.GetElement(Of BPMFlowVO)()
  • SDKBPM.GetElement(Of BPMGatewayVO)()
  • SDKBPM.GetElement(Of BPMActionVO)()

Definir valores de variáveis
  • SDKBPM.SetVar(´Cod02´, ´Meu resumo inicial´)

Obter valores de variáveis
  • SDKBPM.GetVar(´Cod02´), retorna Object
  • SDKBPM.GetVar(Of String)(´Cod02´), retorna String
É o último código a correr de todo o workflow, corre depois do elemento evento de fim ter sido executado, pode usar ´SDKBPM´ para facilmente aceder ao SDK do BPM e assim efetuar as operações desejadas.

Retorno
Este código não tem qualquer influencia sobre o fecho e a passagem a histórico do workflow, qualquer tipo de retorno de mensagens ou erro na execução do código é ignorado, pois não é possivel cancelar o fim de um workflow, no entanto as mensagens retornadas são registradas no log do workflow.

Payload
Se o workflow foi iniciado a partir do ecrã de clientes quando se consultava o cliente João, esses dados estão dentro do workflow através de uma variável especial e em qualquer altura da execução do workflow pode-se obter esses dados da seguinte maneira:
  • Dim cliente as ClVO = SDKBPM.GetPayload(Of ClVO)()

Contexto
  • SDKBPM.GetProcess() = Tipo de workflow iniciado BPMProcessVO
  • SDKBPM.GetWorkflow() = Workflow iniciado BPMInstanceVO
  • SDKBPM.GetActivity() = Atividade que está a ser processada BPMActivityVO
  • SDKBPM.GetElement() = Elemento que deu origem á atividade BPMElement
  • SDKBPM.GetElement(Of BPMEventVO)()
  • SDKBPM.GetElement(Of BPMFlowVO)()
  • SDKBPM.GetElement(Of BPMGatewayVO)()
  • SDKBPM.GetElement(Of BPMActionVO)()

Definir valores de variáveis
  • SDKBPM.SetVar(´Cod02´, ´Meu resumo inicial´)

Obter valores de variáveis
  • SDKBPM.GetVar(´Cod02´), retorna Object
  • SDKBPM.GetVar(Of String)(´Cod02´), retorna String
Esta secção serve para que possa introduzir e configurar as variáveis desejadas no tipo de workflow.
Para introduzir uma nova variável basta clicar no botão +
sticky_note_2Notas

Para obter informação do estado dos vários workflows consulte o tópico de manualBPM - Ecrã de consulta de workflow