Referência de regras

Um roteamento tem duas partes: General, com as opções de varredura e de log, e FileMatching, com a lista de regras. No modo banco de dados, o roteamento é mantido no Riversoft® Console Portal e pode ser exportado com -export. No modo arquivo local, é um arquivo JSON criado a partir do modelo example-config_rules.json.

{
  "General": { "Name": "ENTRADA", "ScanDir": "/caixa/IN", "LogLevelOnSuccess": 6, "LogLevelOnError": 1 },
  "FileMatching": [
    {
      "Index": 0,
      "Name": "NOTAS",
      "FileRegEx": "^NOTAS.*\\.TXT$",
      "General": { "SourceUser": "PARCEIRO", "WeekDayInterval": 127, "EndDateHour": 23, "EndDateMinute": 59, "EndDateSecond": 59 },
      "Filename": { "RenameFileTo": "" },
      "Copy": { "CopyToDir": "/caixa/OUT", "CopyFileOption": 13 },
      "Backup": { "BkpToDir": "/backup/notas", "BkpFileOption": 4 }
    }
  ]
}

Os campos de texto aceitam expressões regulares no padrão RE2. Os campos numéricos marcados como opções são somas de valores: para combinar opções, some os valores, por exemplo 1 + 4 + 8 = 13.

General do roteamento

Seleção do arquivo

Cada item de FileMatching é uma regra. As regras são avaliadas em ordem de Index, e vale a primeira que corresponder ao arquivo.

Um campo vazio aceita qualquer valor.

General da regra

Quando o arquivo está fora do horário, do dia, da idade ou do tamanho permitidos, o processamento termina com um aviso.

Novo nome (Filename)

O novo nome é montado nesta ordem:

1. Parte de RenameFileTo. Vazio: o novo nome começa vazio e, se nada for acrescentado, o nome original é mantido.
2. Aplica ReplacesFromFile, quando habilitado em ReplaceFromFileOption.
3. Aplica Replaces, em ordem.
4. Acrescenta a data e hora, conforme InsertTimestamp.
5. Aplica ReplacesByRegEx, em ordem.

Replaces

Cada item copia um trecho de uma origem para o novo nome. As posições começam em 1.

• ...PosFrom: posição inicial do trecho na origem. 0: início.
• ...PosTo: posição no novo nome onde o trecho é escrito, sobrepondo o que houver. 0 ou -1: acrescenta no fim.
• ...Len: número de caracteres. 0 desabilita o item.

O último número sequencial usado é guardado no diretório applLockDir. InsertSeqNumberSeq é mantido para compatibilidade.

Exemplo: para o arquivo NF20261110.TXT, o item abaixo gera 20261110, copiando 8 caracteres a partir da posição 3:

{ "ReplaceFileNamePosFrom": 3, "ReplaceFileNamePosTo": -1, "ReplaceFileNameLen": 8 }

ReplacesFromFile

Copia para o novo nome um trecho da primeira linha do arquivo que corresponde à expressão.

ReplacesByRegEx

Substitui no novo nome cada ocorrência de RegExReplaceFrom por RegExReplaceTo. Use ${1}, ${2} para os grupos e ${0} para o trecho encontrado. Exemplo: "RegExReplaceFrom": "(?i)\\.txt$", "RegExReplaceTo": ".csv". RegExReplaceOcorr é mantido para compatibilidade.

Cópia (Copy)

Backup (Backup)

Arquivos de controle

Os arquivos de controle sinalizam a outros processos que um arquivo está em processamento ou pronto. Os nomes aceitam variáveis, por exemplo $PATHOLDNAME/$OLDNAME.lck.

Comandos externos

ExecProgBefore, ExecProg e ExecProgError recebem um comando com argumentos, por exemplo:

/usr/local/bin/notificar.sh "$FILENEWNAME" $SRCUSER $DSTUSER

• As variáveis são substituídas antes da execução. Veja Referência de variáveis.
• O comando é executado diretamente, sem um shell: use o caminho completo e, para redirecionamentos ou pipes, chame um script.
• Argumentos entre aspas duplas ou simples são passados sem as aspas.
• O Riversoft STCP Gemini Rename espera o fim do comando. Um código de saída diferente de 0 é tratado como falha.