Histórico da Página
Nas páginas abaixo dessa estrutura, é possível verificar as documentações para Desenvolvimento Workflow:
- Tradução de Processos: Nesta página você pode verificar o sistema de tradução de processos do fluig. Acesse a documentação e confira mais informações.
- Gestão de Lista de Tarefas: Configure listas a fim de organizar atividades diárias, permitindo informar qual atividade será desempenhada, quem desempenhará e o prazo de conclusão. Verifique o link da documentação e saiba mais detalhes.
- Visão de utilização de workflows: Verifique as orientações e padrões a serem seguidos para a criação de workflows. Acesse o link da documentação e saiba mais detalhes.
- Integração assíncrona via processos workflow: Verifique os modos de processamentos assíncronos por meio de solicitações workflow. Acesse a documentação e confira mais informações.
Caso necessite utilizar integrações no seu workflow, acesse as páginas abaixo e verifique nossas documentações para obter mais informações:
...
- Desenvolvimento sobre a plataforma: Permite visualizar os tópicos referentes ao desenvolvimento sobre a plataforma.
- hAPI: Permite verificar os métodos disponíveis. Acesse o link para conferir.
- docAPI: Variável que permite acesso a funções relacionadas a documentos, podendo ser utilizada nos eventos. Acesse o link da documentação para visualizar os métodos disponíveis.
- Mecanismo de atribuição: Permite que o usuário os utilize para criar uma lista de possíveis usuários para uma atividade. Acesse o link para ter acesso a todos os detalhes.
- Mensagens de log para processos: Guia que permite auxiliar na ativação e compreensão do conjunto de mensagens de log que podem trazer informações sobre solicitações de processo. Acesse o link para conferir a documentação.
- Parâmetros: Permite conferir os tipos de parâmetros utilizados no desenvolvimento do processo sob a plataforma. Acesse o link para conferir mas informações.
- Tratamento de exceções: Permite acessar os modelos de tratamentos de exceções para cada um dos eventos citados. Acesse o link e confira os modelos para utilização.
- Eventos de processos: Permite visualizar todos os eventos e exemplos de implementação de cada um deles. Acesse o link da documentação e confira as informações de todos os eventos.
- Eventos finais de processo: Permite visualizar a descrição dos tipos de eventos finais de um processo. Acesse o link da documentação e veja as informações referente a cada um deles.
- Eventos de notificação: Guia que permite visualizar a configuração do widget específico e um evento de notificação. Acesse a documentação e confira os detalhes passo a passo.
- Acompanhamento de eventos: Permite acompanhar a execução de eventos pelo componente loading. Acesse a documentação através do link e confira os exemplos de utilização deste componente.
Índice
Índice | ||||||
---|---|---|---|---|---|---|
|
Customização de Workflow
Propriedades Avançadas
As propriedades avançadas contêm informações especiais que podem alterar o comportamento padrão do processo em algum ponto. Elas devem ser utilizadas principalmente durante a fase de customização ou conter "flags" especiais que alterem alguma lógica interna (apenas em casos especiais).
Para cadastrar uma propriedade avançada em um processo
Eventos do Processo
Os eventos de um processo são um conjunto de scripts carregados pela API de workflow. Tais scripts são desenvolvidos com o uso da linguagem JavaScript e chamados ao longo da execução do processo em momentos pré-determinados, como por exemplo a criação de um processo ou a entrada em uma nova atividade.
AQUI VAI CONTEÚDO FANTANTE
Em todos os eventos do processo é possível obter informações da API de Workflow. Cada evento possui acesso ao handle da API de workflow através da variável global hAPI. Os seguintes métodos estão disponíveis através da hAPI:
Método | Especificação | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
getCardValue("nomeCampo") | Permite acessar o valor de um campo do formulário do processo, onde:
| |||||||||||||
setCardValue("nomeCampo", "valor") | Permite definir o valor de um campo do formulário do processo, onde:
| |||||||||||||
setAutomaticDecision(numAtiv, listaColab, "obs") | Permite definir o fluxo de saída de uma atividade de forma automática, onde:
| |||||||||||||
getActiveStates() | Retorna uma lista das atividades ativas do processo. | |||||||||||||
getActualThread(numEmpresa, numProcesso, numAtiv) | Retorna a thread da atividade que está ativa, lembrando que em caso de atividades paralelas, retorna 0, 1, 2 e assim sucessivamente.
| |||||||||||||
setDueDate(numProcesso, numThread, "userId", dataConclusao, tempoSeg) | Permite alterar o prazo de conclusão para uma determinada atividade do processo, onde:
| |||||||||||||
transferTask(transferUsers, "obs", int numThread) | Transfere uma tarefa de um usuário para outro(s) usuário(s).
| |||||||||||||
transferTask(transferUsers, "obs") | Transfere uma tarefa de um usuário para outro(s) usuário(s). Este método não pode ser usado em processos com atividades paralelas:
| |||||||||||||
startProcess(processId, ativDest, listaColab, "obs", completarTarefa, valoresForm, modoGestor) | Inicia uma solicitação workflow, onde:
Retorna um mapa com informações da solicitação criada. Entre elas, o iProcess que é o número da solicitação criada. | |||||||||||||
setColleagueReplacement(userId) | Seta um usuário substituto, onde:
| |||||||||||||
setTaskComments("userId", numProcesso, numThread, "obs") | Define uma observação para uma determinada tarefa do processo, onde:
| |||||||||||||
getCardData(numProcesso) | Retorna um Mapa com todos os campos e valores do formulário da solicitação.
| |||||||||||||
getAdvancedProperty("propriedade") | Retorna o valor da propriedade avançada de um processo.
| |||||||||||||
calculateDeadLineHours(data, segundos, prazo, periodId) | Calcula um prazo a partir de uma data com base no expediente e feriados cadastrados no produto passando o prazo em horas:
Retorno: Array de Objeto, onde a primeira posição do array é a data e a segunda a hora. Exemplo:
| |||||||||||||
calculateDeadLineTime(data, segundos, prazo, periodId) | Calcula um prazo a partir de uma data com base no expediente e feriados cadastrados no produto passando o prazo em minutos:
Retorno: Array de Objeto, onde a primeira posição do array é a data e a segunda a hora. Exemplo:
|
Nos eventos existe a possibilidade de integração com serviços de dados. Tais serviços podem ser WebServices, AppServer Progress® e Dataset.
O acesso a WebServices ou AppServer Progress® deve ser previamente configurado no cadastro de Serviços. Para mais detalhes consulte em Integração Com Aplicativos Externos, no capítulo "Acessando WebServices a partir do Fluig".
Abaixo um exemplo de como executar o WebService de Colleague para criar um usuário no Fluig após executar uma tarefa:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
function afterTaskComplete(colleagueId, nextSequenceId, userList) {
if (nextSequenceId == 2) {
//Busca o webservices de Colaborador
var colleagueServiceProvider = ServiceManager.getServiceInstance("Colleague");
var colleagueServiceLocator = colleagueServiceProvider.instantiate("com.totvs.technology.ecm.foundation.ws.ECMColleagueServiceService");
var colleagueService = colleagueServiceLocator.getColleagueServicePort();
//Cria o ColleagueDto – Verificar a lista de métodos na visualização do serviço
var colleagueDto = colleagueServiceProvider.instantiate("com.totvs.technology.ecm.foundation.ws.ColleagueDto");
colleagueDto.setCompanyId(1);
colleagueDto.setColleagueId("teste");
colleagueDto.setColleagueName("Usuario Teste");
colleagueDto.setActive(true);
colleagueDto.setVolumeId("Default");
colleagueDto.setLogin("teste");
colleagueDto.setMail("[email protected]");
colleagueDto.setPasswd("teste");
colleagueDto.setAdminUser(false);
colleagueDto.setEmailHtml(true);
colleagueDto.setDialectId("pt_BR");
//Cria o colleagueDtoArray e adiciona
var colleagueDtoArray = colleagueServiceProvider.instantiate("com.totvs.technology.ecm.foundation.ws.ColleagueDtoArray");
colleagueDtoArray.getItem().add(colleagueDto);
var result = colleagueService.createColleague("adm", "adm", 1, colleagueDtoArray);
log.info("Result: " + result);
}
} |
Os seguintes eventos são disparados pela API de Workflow:
Evento | Descrição | Parâmetros | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
afterCancelProcess | Ocorre após o cancelamento da solicitação. |
| |||||||||||
afterProcessCreate | Ocorre logo após a criação de um novo processo.
|
| |||||||||||
afterProcessFinish | Ocorre após finalizada a solicitação. |
| |||||||||||
afterReleaseVersion | Ocorre após a liberação de uma versão do processo. |
| |||||||||||
afterStateEntry | Ocorre após a entrada em uma nova atividade. |
| |||||||||||
afterStateLeave | Ocorre após a saída de uma atividade. |
| |||||||||||
afterTaskComplete | Ocorre após o usuário completar uma tarefa, porém as informações de próxima tarefa e usuários destino já foram salvas. |
| |||||||||||
afterTaskCreate | Ocorre após o usuário receber uma tarefa. |
| |||||||||||
afterTaskSave | Ocorre após salvar as informações selecionadas pelo usuário. |
| |||||||||||
beforeCancelProcess | Ocorre antes do cancelamento da solicitação. |
| |||||||||||
beforeSendData | ------ | ---- | |||||||||||
beforeStateEntry | Ocorre antes da entrada em uma nova atividade. |
| |||||||||||
beforeStateLeave | Ocorre antes da saída de uma atividade. |
| |||||||||||
beforeTaskComplete | Ocorre antes que o usuário complete uma tarefa, porém as informações de próxima tarefa e usuários destino já foram salvas. |
| |||||||||||
beforeTaskCreate | Ocorre antes que o usuário receba uma tarefa. |
| |||||||||||
beforeTaskSave | Ocorre antes de salvar as informações selecionadas pelo usuário. |
| |||||||||||
calculateAgreement | Ocorre após o cálculo do consenso (somente para atividades conjuntas) e permite alterar os dados do consenso de uma atividade. Exemplo:
|
| |||||||||||
onNotify | |||||||||||||
setProcess | |||||||||||||
subProcessCreated | |||||||||||||
validateAvailableStates |
Customização do Processo
Tratamento de Exceções
Mecanismo de Atribuição
Como criar um Mecanismo de Atribuição
Parâmetros Workflow para Customização de Formulários
Customização de E-mail
...