Referencia de reglas

Un enrutamiento tiene dos partes: General, con las opciones de barrido y de log, y FileMatching, con la lista de reglas. En el modo base de datos, el enrutamiento se mantiene en el Riversoft® Console Portal y puede exportarse con -export. En el modo archivo local, es un archivo JSON creado a partir del modelo example-config_rules.json.

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

Los campos de texto aceptan expresiones regulares en la sintaxis RE2. Los campos numéricos marcados como opciones son sumas de valores: para combinar opciones, sume los valores, por ejemplo 1 + 4 + 8 = 13.

General del enrutamiento

Selección del archivo

Cada ítem de FileMatching es una regla. Las reglas se evalúan en el orden de Index, y vale la primera que corresponda al archivo.

Un campo vacío acepta cualquier valor.

General de la regla

Cuando el archivo está fuera del horario, del día, de la antigüedad o del tamaño permitidos, el procesamiento termina con un aviso.

Nuevo nombre (Filename)

El nuevo nombre se arma en este orden:

1. Parte de RenameFileTo. Vacío: el nuevo nombre empieza vacío y, si no se agrega nada, se mantiene el nombre original.
2. Aplica ReplacesFromFile, cuando está habilitado en ReplaceFromFileOption.
3. Aplica Replaces, en orden.
4. Agrega la fecha y hora, según InsertTimestamp.
5. Aplica ReplacesByRegEx, en orden.

Replaces

Cada ítem copia un fragmento de un origen al nuevo nombre. Las posiciones empiezan en 1.

• ...PosFrom: posición inicial del fragmento en el origen. 0: inicio.
• ...PosTo: posición en el nuevo nombre donde se escribe el fragmento, sobrescribiendo lo que haya. 0 o -1: agrega al final.
• ...Len: número de caracteres. 0 deshabilita el ítem.

El último número secuencial usado se guarda en el directorio applLockDir. InsertSeqNumberSeq se mantiene por compatibilidad.

Ejemplo: para el archivo NF20261110.TXT, el ítem siguiente genera 20261110, copiando 8 caracteres a partir de la posición 3:

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

ReplacesFromFile

Copia al nuevo nombre un fragmento de la primera línea del archivo que corresponde a la expresión.

ReplacesByRegEx

Sustituye en el nuevo nombre cada ocurrencia de RegExReplaceFrom por RegExReplaceTo. Use ${1}, ${2} para los grupos y ${0} para el fragmento encontrado. Ejemplo: "RegExReplaceFrom": "(?i)\\.txt$", "RegExReplaceTo": ".csv". RegExReplaceOcorr se mantiene por compatibilidad.

Copia (Copy)

Backup (Backup)

Archivos de control

Los archivos de control señalan a otros procesos que un archivo está en procesamiento o listo. Los nombres aceptan variables, por ejemplo $PATHOLDNAME/$OLDNAME.lck.

Comandos externos

ExecProgBefore, ExecProg y ExecProgError reciben un comando con argumentos, por ejemplo:

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

• Las variables se sustituyen antes de la ejecución. Vea Referencia de variables.
• El comando se ejecuta directamente, sin un shell: use la ruta completa y, para redirecciones o pipes, llame a un script.
• Los argumentos entre comillas dobles o simples se pasan sin las comillas.
• Riversoft STCP Gemini Rename espera el fin del comando. Un código de salida distinto de 0 se trata como falla.