Essa função escreve o texto passado nos detalhes de uma entrada do histórico da tarefa.
- Se utilizado em BeforeExecute, escreve na entrada de “Tarefa criada”;
- Se utilizado em AfterExecute, escreve na entrada de “Tarefa tratada”.
Além disso, diferentemente do writeHistory(text: String), esta função suporta a definição de formatação para o texto que for passado para o histórico. Esse texto é sempre formatado utilizando o String.format(text, args) do Java.
São suportados textos com até 2000 caracteres, textos maiores que isso serão truncados.
Nota
- Esta função está disponível nos scripts BeforeExecute e AfterExecute da atividade.
- Para conhecer mais detalhes sobre essa formatação consulte a documentação do Java.
- Esta função está disponível nos scripts BeforeExecute e AfterExecute da atividade.
- Não é possível utilizar a máscara %d para formatar valores decimais. Essa restrição se dá devido à fato do JavaScript considerar todos os números como double então, não há como tratá-los como decimal. Um contorno para essa situação é fazer uso de uma máscara para formatar valores decimais onde a parte decimal é retirada. Essa máscara é: %.0f
Sintaxe: <task>.writeHistoryFmt(text: String, args)
Parâmetros:
| Nome | Tipo | Descrição |
| text | String | Texto que será passado nos detalhes da entrada do histórico da tarefa em questão. |
| args | qualquer | Variável com o valor que será utilizado no texto do histórico |
Tipo de retorno: Sem retorno.
Exemplo de utilização:
Essa função pode ser utilizada para adicionar qualquer informação ao histórico de execução do processo, possibilitando a exposição de dados que eram apenas privados do processo, como por exemplos variáveis do processo ou locais.
Dada a tarefa abaixo, deseja-se adicionar informações ao evento de Criação da tarefa e de Tratamento da tarefa. Essa informação será adicionada utilizando do recurso de formatação disponível para formatar o conteúdo.
O conteúdo de ambos os scripts é igual, isso está correto, pois o que definirá onde a informação será escrita, é o script em que a função for executada.
Script definido no BeforeExecute e AfterExecute:
// Busca a tarefa
var task = context.getTask();
// Pega o conteúdo das variáveis de usuário antigo e usuário novo
var usuarioAntigo = context.getVars().getString(“usuarioAntigo”)
var usuarioNovo = context.getVars().getString(“usuarioNovo”)
// Adiciona o conteúdo da variável usuarioNovo e usuarioAntigo no histórico.
// A mensagem adicionada utiliza o formatador para adicionar um texto com partes de conteúdo dinâmico.
task.writeHistoryFmt(“Tarefa inicialmente atribuída para: %s mas depois passou para: %s”, usuarioAntigo, usuarioNovo);
English
Español
