Eventos

...

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 predeterminados, como por exemplo a criação da solicitação do processo ou a entrada em uma nova atividade.

...

Para criar um novo evento do processo, clicar com o botão direito do mouse no projeto, acessar a opção New e, em seguida, a opção Other. No assistente aberto, selecionar a opção "Script evento workflow", presente na pasta fluig, e clicar no botão Next. Na nova tela, selecionar qual o evento que será criado e relacionar ele a um processo já existente. Para finalizar, clicar no botão Finish:

Image Modified 

afterReleaseProcessVersion

Evento disparado após a criação ou modificação nas configurações de um determinado processo.

• Abaixo segue um exemplo de como implementar esse evento:

...

function afterReleaseProcessVersion(processXML){
    var pdv = getValue("ProcessDefinitionVersionDto");
    var processInfo = "\n### Nova versão de processo liberada: ###";
    processInfo += "\n User: " + getValue("WKUser");   
    processInfo += "\n processDescription: " + pdv.getProcessDescription();
    processInfo += "\n processId: " + pdv.getProcessId();
    processInfo += "\n version: " + pdv.getVersion();
    log.info(processInfo + "\n");
}

...

São disponibilizadas algumas propriedades referentes ao processo que esta sendo liberado, porém somente para consulta através do método getValue.

ProcessDefinitionVersion

ProcessDefinitionVersionDto

afterReleaseVersion

Ocorre após a liberação de uma versão do processo.

Parâmetro:

...

beforeStateEntry

Ocorre antes da entrada em uma nova atividade.

Parâmetro:

...

beforeTaskCreate

Ocorre antes que o usuário receba uma tarefa. 

function beforeTaskCreate(colleagueId){
    
    // Impede que um determinado usuário assuma a tarefa
        if(colleagueId == "Administrador2" && getValue("takeTask") == true)  { 
            throw "Você não pode assumir esta tarefa"; 
        }
} 

Parâmetro:

afterTaskCreate

Ocorre após o usuário receber uma tarefa. 

Parâmetro:

afterStateEntry

Ocorre após a entrada em uma nova atividade.

Parâmetro:

Exemplo (chamada do Dataset com varredura por colunas):

var datasetReturned = DatasetFactory.getDataset("Formuláriodelocal6", null, null, null);

log.info("===============COLUNAS=======================");

log.info("===============NOME COLUNAS=======================");

for (var j = 0; j < datasetReturned.rowsCount; j++) {

try {

log.info("******** COLUMN ---->" + datasetReturned.getColumnName(j));
    } catch (e) {
log.info("EEEEEEEEEEEEEEEEEE ->" + e);
    }

}

beforeSendData

É o último evento a ser executado. Possui integração com Analytics, podendo enviar dados específicos de processos Workflow. 

Para maiores detalhes sobre a utilização desse evento, acesse Guia de Implementação Fluig Analytics. 

validateAvailableStates

Ocorre após montada a lista de tarefas disponíveis para o usuário a partir da tarefa atual.

...

function validateAvailableStates(iCurrentState, stateList) {
    // Código: 1 - Descrição: Atividade inicial
    // Código: 2 - Descrição: Atividade ordem 3
    // Código: 3 - Descrição: Atividade ordem 2
    // Código: 4 - Descrição: Atividade ordem 1
     
    // stateList atual: [2,3,4]
 
    var stateArray = new Array();
     
    if (iCurrentState == 1) {
        stateList.clear();
        stateArray.push(4,3,2);
    }
     
    stateArray.forEach(function(code) {
        stateList.add(new java.lang.Integer(code));
    });
     
    // stateList reordenado: [4,3,2]
    return stateList;
}

Parâmetro:

beforeTaskSave

Ocorre antes de salvar as informações selecionadas pelo usuário. 

Parâmetros:

...

afterProcessCreate

Ocorre logo após a criação de um novo processo.

Parâmetro:

...

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.

Parâmetros:

...

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. 

Parâmetros:

beforeStateLeave

Ocorre antes da saída de uma atividade. 

Parâmetro:

afterStateLeave

Ocorre após a saída de uma atividade.

Parâmetro:

setProcess

Ocorre quando um processo é "setado" na API.

...

...

A propriedade WKCompletTask não deve ser utilizada neste evento, pois quando ele é executado o produto ainda não tem a informação se atividade foi ou não completada.

Parâmetro:

onNotify

Se refere a um evento global que ocorre após a movimentação da solicitação e antes de enviar as notificações.

Para mais detalhes consulte a página Desenvolvimento de eventos - On Notify.

checkComplementsPermission

Através dele é possível determinar se o usuário corrente do processo poderá ou não adicionar complementos mesmo com permissionamento ligado na modelagem do processo. Este evento possui acesso a todas as propriedades dos processos workflow (quando disponíveis) bem como acesso a hAPI, FLUIG e seus métodos.

...

...

subProcessCreated

Ocorre quando um sub-processo é criado. 

Parâmetro:

afterProcessFinish

Ocorre após finalizada a solicitação.

Parâmetro:

beforeCancelProcess

Ocorre antes do cancelamento da solicitação. 

Parâmetros:

...

afterCancelProcess

Ocorre após o cancelamento da solicitação. É recomendado não disparar exceções neste método, pois o cancelamento já foi realizado.

Parâmetros:

...

Eventos de Formulário Pai Filho

...

getChildrenFromTable
Esse evento retorna um mapa com todos os campos filhos de um Pai Filho a partir do seu tablename.

getChildrenIndexes
Esse evento retorna os índices dos registros (linhas) contidos em um Pai Filho a partir do seu tablename.

Quando utilizado em processos será necessário acessar a hAPI.

Exemplo:

var indexes = hAPI.getChildrenIndexes("itens");
 var total = 0;
 for (var i = 0; i < indexes.length; i++) {
 var fieldValue = parseInt(hAPI.getCardValue("descricao___" + indexes[i]));
 if (isNaN(fieldValue)){
 fieldValue = 0;
 }
 total = total + fieldValue;
 }

Eventos nas etapas dos processos

...

Liberar nova versão do processo

Quando liberar uma nova versão do processo configurado, o evento executado será:

• afterReleaseVersion

Salvar nova solicitação

Quando iniciar uma solicitação pelo menu Processos, é evento executado será:

...

• beforeStateEntry
• beforeTaskCreate
• afterTaskCreate
• afterStateEntry
• beforeSendData
• validateAvailableStates
• beforeTaskSave
• afterTaskSave
• afterProcessCreate

Criar nova solicitação

Quando iniciar uma solicitação pelo menu Processos, é evento executado será:

...

• beforeStateEntry
• beforeTaskCreate
• afterTaskCreate
• afterStateEntry
• beforeSendData
• validateAvailableStates
• beforeTaskSave
• afterTaskSave
• beforeTaskComplete
• afterTaskComplete
• beforeStateLeave
• afterStateLeave
• afterProcessCreate
• setProcess
• onNotify

Visualizar solicitação

Quando acessar a Central de Tarefas, abrir uma solicitação já iniciada, os eventos executados serão:

• validateAvailableStatessetProcess
• checkComplementsPermission

Salvar solicitação

Quando acionar o botão Salvar a solicitação, os eventos executados serão:

...

• validateAvailableStates
• beforeTaskSave
• afterTaskSave

Movimentar solicitação

Quando movimentar a solicitação acionando o botão Enviar, os eventos executados serão:

...

• validateAvailableStates
• beforeTaskSave
• afterTaskSave
• beforeTaskComplete
• afterTaskComplete
• beforeStateLeave
• afterStateLeave
• beforeStateEntry
• beforeTaskCreate
• afterTaskCreate
• afterStateEntry
• beforeSendData
• onNotify

Movimentar para subprocesso

Quando movimentar a solicitação para subprocesso acionando o botão Enviar, os eventos executados serão:

• setProcess
• validateAvailableStates
• beforeTaskSave
• afterTaskSave
• beforeTaskComplete
• afterTaskComplete
• beforeStateLeave
• afterStateLeave
• beforeStateEntry
• subProcessCreated
• afterStateEntry
• BeforeSendData
• onNotify

Finalizar solicitação

Quando finalizar a solicitação acionando o botão Enviar, os eventos executados serão:

• setProcess
• validateAvailableStates
• beforeTaskSave
• afterTaskSave
• beforeTaskComplete
• afterTaskComplete
• beforeStateLeave
• afterStateLeave
• beforeStateEntry
• afterStateEntry
• afterProcessFinish
• beforeSendData

Cancelar solicitação

Quando usuário acessar solicitação já iniciada na Central de Tarefas para Cancelamento, os eventos executados serãoo evento executado será:

• setProcess
• checkComplementsPermissions.

Quando acionar o botão Cancelar Solicitação, os eventos executados serão:

• setProcess
• beforeCancelProcess
• afterCancelProcess
• beforeSendDatasetProcess
• onNotify