Essa função permite definir que uma variável irá ser um dado de negócio "principal" para a tarefa.
Nota
Para adicionar os dados de negócio que não sejam dados principais, mas sim detalhamento, é necessário utilizar a função <task>.getInput().
Sintaxe: <performer>.setDataRelevant(variableName : String)
Parâmetros:
| Nome | Tipo | Descrição |
| variableName | String |
É o nome da variável que deve ser definida como dado de negócio relevante para a tarefa:
Quando não existir a variável informada, é registrado o erro original no log do servidor e a execução continua normalmente. |
Exemplo de utilização:
Essa função é utilizada quando deseja-se manipular as ações e/ou dados de negócio relevantes atrelados a tarefa.
Em um cenário em que exista a necessidade de definir uma tarefa de Aprovações de Férias em que o usuário final seja obrigado a tomar uma decisão baseada em algumas informações. Nesse caso é possível definir as ações que estarão disponíveis na tarefa, assim como os dados de negócio que serão exibidos ao usuário para consulta quando ele for realiza a tarefa.
Baseado nesse cenário existem as seguintes ações e dados de negócios para serem configuradas na tarefa de Aprovação de férias:
Ações
| Ação | Identificador único | Sequência | Necessita justificativa? |
| Aprovar | 1 | 1 | Não |
| Reprovar | 2 | 2 | Sim |
| Solicitar alterações | 3 | 3 | Sim |
Dados de negócio relevantes
| Variável | Tipo |
| DataAdmissao | Date |
| Colaborador.Nome | String |
| Colaborador.Ferias.AdiantamentoFerias | Double |
| QuantidadeDiasFerias | Int |
| ValorAdiantamentoFerias | Long |
| Abono | String |
| ValorAbono | String |
Baseado nas informações acima é possível configurar para que essas ações e variáveis sejam definidas na tarefa para que o usuário consiga tomar as ações e consultar essas informações no momento da tomada de decisão.
Além disso, também é necessário alterar essas configurações após essas serem adicionadas à tarefas, como por exemplo: obter as ações já adicionadas, remover alguma ação, entre outras.
Script definido no BeforeExecute da tarefa de Aprovação de Férias:
// Obtém o objeto que contém as funções específicas do performer que está associado à tarefa
var performer = context.getTask().getPerformer();
// Obtém a lista de ações.
// Nenhuma ação foi definida previamente via propriedades, então essa lista estará vazia
var actions = performer.getActions();
// Adiciona as ações que lstadas acima, mais uma ação que servirá apenas para testes
performer.addAction("Aprovar", 1, 1, "false");
performer.addAction("Reprovar", 2, 2, "true");
performer.addAction("Solicitar alterações", 3, 3, "true");
performer.addAction("Teste", 4, 4, "true");
// Agora essa mesma função irá retornar as 4 ações adicionadas acima.
var actions = performer.getActions();
// Remove a ação com identificador único chamado "4", que nesse caso é a ação chamada de "Testes"
performer.removeAction(4);
// Obtém a ação que está adicionada na posição "1" da lista de ações - lembrando que as posições começam em 0.
// Nesse caso será retornada a ação "Reprovar"
var actionReprovar = performer.getActions().get(1);
// A partir da ação é possível ler a sua informações, sendo elas: nome, identificador, sequência e se necessita de jusitificativa ou não.
// Nesse caso as informações que irão retornar são:
actionReprovar.getName(); // Reprovar
actionReprovar.getId(); // 2
actionReprovar.getSequence(); // 2
actionReprovar.isReasonRequired(); // true
// Agora será adicionada as variáveis do processo como sendo dados relevantes para essa tarefa.
// Agora iremos adicionar dados de negócio a tarefa. Esses dados não são os dados mais relevantes, mas são dados que serão exibidos como dados de detalhamento.
// Para isso, primeiramente obtemos o objeto que contém os dados de entrada da tarefa.
var input = context.getTask().getInput();
// Agora com esse objeto iremos adicionar variável a variável que queremos que a tarefa possua como detalhamento.
input.setLong("ValorAdiantamentoFerias");
input.setString("Abono");
input.setLong("ValorAbono");
// Serão adicionadas todas as variáveis listadas acima.
performer.setDataRelevant("DataAdmissao");
performer.setDataRelevant("Colaborador.Nome");
performer.setDataRelevant("Colaborador.Ferias.AdiantamentoFerias");
performer.setDataRelevant("QuantidadeDiasFerias");
// Caso seja necessário remover alguma das variáveis dos dados relevantes da tarefa basta realizar o seguinte passo.
// Remove a variável "DataAdmissao" das variáveis relevantes
performer.removeRelevantData("DataAdmissao");
English
Español
