Scripts utilizados na criação de fluxos

A seguir, apresentamos uma compilação dos scripts que estão a ser usados atualmente nos projetos da Waidok:

• Substituir caracteres de uma variável. No exemplo, substitui todas as ocorrências de «gato» por «cão» usando uma expressão regular com o sinalizador g (global). Pode ver uma explicação e exemplos de expressões regulares aqui: https://4geeks.com/es/lesson/regex-tutorial-regular-expression-ejemplo.

let novoTexto = texto.replace(/gato/g, "cão");
var cadeia = getVariable('strNumeroCertificadoOCR')
cadeia.replace(/[./\\s]/g, "");

• Atribuir valores de uma propriedade (tipo lista) a uma variável. No exemplo, atribui-se o valor da propriedade «nomePropriedade» à variável em curso. O valor da propriedade é extraído dos metadados do documento que foram previamente guardados na variável do tipo objeto «objMetadadosColeção».

var msg = getVariable('objMetadatosColección')
var metadata = msg['Metadata']
metadata['nombrePropiedad'].slice(2, -2);

• Atribuir valores de uma propriedade (não do tipo lista) a uma variável. No exemplo, atribui-se o valor da propriedade «nomePropriedade» à variável em curso. O valor da propriedade é extraído dos metadados do documento que foram previamente guardados na variável do tipo objeto "objMetadatosColección". No final, os dois primeiros caracteres e os dois últimos do valor da lista são eliminados, uma vez que os valores do tipo lista são guardados como uma matriz que insere colchetes e aspas em cada valor e é necessário eliminá-los para os inserir na variável.

var msg = getVariable('objMetadatosColección')
var metadata = msg['Metadata']
metadata['nombrePropiedad']

• Recuperar o valor de uma variável numa atividade.

getVariable('nomeVariável')

• Recuperar um elemento de uma coluna da tabela mestre. Previamente, devemos atribuir o valor de uma linha da tabela mestre a uma variável do tipo Objeto com uma atividade de workflow do tipo Pesquisar tabela mestre. Noexemplo, o valor da propriedade "nomePropriedade" é atribuído à variável em curso. O valor da propriedade é extraído dos metadados do documento que foram previamente guardados na variável «variableMetadatosColección». Na segunda linha do código, coloca-se entre colchetes o número da coluna da qual se deve extrair o dado. A primeira coluna é 0, a segunda é 1, a terceira é 2, etc.

var msg = getVariable('objFilaTablaMaestra')
msg[0]

• Atribuir um valor de NIF proveniente do Invofox a uma variável. Os números NIF processados pelo Invofox têm formato com codificação internacional, ou seja, inserem o código do país no início do número com dois caracteres. Assim, se quisermos poder compará-los com uma tabela mestre e permitir a sua inserção manual, temos de inserir sempre na variável o valor sem o código do país. Previamente, devemos atribuir os metadados do documento na saída de uma atividade a uma variável do tipo objeto. No exemplo, objMetadata

var msg = getVariable('objMetadata')
var metadata = msg['Metadata']
if (metadata['NombrePropiedadNIF'].toString().length > 9)
 metadata['NombrePropiedadNIF'].toString().substring(2)
else
 metadata['NombrePropiedadNIF'].toString();

• Exemplos de condições para a atividade de Decisão.
  • Valor de uma variável diferente de 0.

getVariable('nomeVariável') != 0

• • Valor de uma variável igual a um valor.

getVariable('nomeVariável') == "valor a comparar"

• • Valor de uma variável maior ou igual a um número. No exemplo, maior ou igual a 2000.

getVariable('nomeVariável') >= 2000

• Recuperar valores de metadados internos do Waidok. Previamente, devemos atribuir os metadados do documento na Saída de uma atividade a uma variável do tipo objeto. No exemplo, objMetadata.
  • Recuperar o nome do ficheiro.

var msg = getVariable('objMetadata')
msg['fileName']

• • Recuperar o utilizador que registou o ficheiro no Waidok (proprietário).

var msg = getVariable('objMetadata')
msg['Owner']

• Recuperar um utilizador registado no Waidok a partir de uma propriedade com o seu nome. Tenha em atenção que a propriedade da qual os dados são recuperados é uma propriedade do tipo Lista com os mesmos nomes dos utilizadores registados na ferramenta.Previamente, devemos atribuir os metadados do documento na Saída de uma atividade a uma variável do tipo objeto. No exemplo, objMetadata.

var msg = getVariable('objMetadata')
var metadata = msg['Metadata']
var revisor = metadata['NombreInternoPropiedad'].toString().substring(2)
revisor.substring(0, revisor.length - 2)

• Atribuir a uma tabela as informações de retorno da IA numa etiqueta.

const ai = JSON.parse(getVariable("AiResponse"))[0];
 const transformed = ai.items.map(it => ({
  1: it.description,
  2: it.heat_number
}));
 return transformed;

• Atribuir o primeiro valor ordenado de um resultado de várias linhas de uma tabela mestre a uma variável. No exemplo, várias linhas de uma tabela mestre foram previamente recuperadas numa variável do tipo objeto chamada objMetadataTabelaMaestra.

const data =  getVariable('objMetadataTablaMaestra')
 
// Ordenar pelo primeiro elemento
data.sort((a, b) => Number(a[0]) - Number(b[0]));

return data[0];

• Quando uma tarefa é concluída e queremos colocar a data em que foi realizada. Recolherá, por exemplo, quando alguém aprovou um documento e deixá-lo refletido numa propriedade.

new Date();

• Personalização do corpo de um e-mail de notificação. Previamente, os valores das propriedades do documento devem ser atribuídos a uma variável do tipo objeto. No exemplo, objMetadata.

var msg = getVariable('objMetadata')
var metadata = msg['Metadata']
'Este é um exemplo de corpo de e-mail que recolhe dados de uma fatura, como o seu número: ' + metadata['NomePropriedadeNúmeroDaFatura'] + ', do fornecedor ' + metadata['NomePropriedadeFornecedor'] + ', com data ' + metadata['NomePropriedadeData'] + '.'