SFTP Envío - “Parameters” -> ”Processing”

En esta sección se especifican los parámetros de procesado del fichero para el canal. Además se puede configurar la ejecución de comandos de sistema operativo dentro del SAP NW PI a ejecutar antes o después del procesado de cada uno de los ficheros.

“Processing Parameters”

Es la lista de parámetros, a informar en el canal, para configurar el procesamiento del fichero. Desde aquí se puede especificar:

• La Quality of Service que puede ser Best Effort(BE) – síncrono, Exactly One (EO) – asíncrono o Exactly One in Order (EOIO) – asíncrono con llegada ordenada de los mensajes.
• El Trigger mode especifica el modo de activación de la recogida de mensajes. El “trigger by polling” significa que cada cierto tiempo los canales del adaptador miran si hay ficheros a procesar el los sitemas de ficheros correspondientes. Cuando se habla de “trigger by file” significa que debe estar presente un determinado fichero para procesar los ficheros especificados. Los distintos modos de trigger son:
  • Trigger by polling: Se realiza el procesamiento de los ficheros cada cierto tiempo, parametrizado previamente.
  • Trigger by polling and by file (one trigger file per file): Se realiza el procesamiento de los ficheros cada cierto tiempo, parametrizado previamente, y si y solo si para cada fichero está presente el fichero de trigger especificado. Si ese fichero de trigger no está presente, ese fichero no se procesará, siendo ignorado.
  • Trigger by polling and by file (one trigger file per all): Se realiza el procesamiento de los ficheros cada cierto tiempo, parametrizado previamente, y si y solo está presente el fichero de trigger especificado. En este caso solo debe estar presente ese fichero para procesar todos los ficheros que cumplan con el criterio de selección de ficheros a procesar en los canales. Si ese fichero de trigger no está presente, los ficheros no serán procesados, siendo ignorados.
  • El Intervalo de polling para la recogida de ficheros.
  • El modo de procesamiento del fichero. Existen 3 modos preestablecidos para el procesamiento de los ficheros recogidos por el adaptador que son:
    • Test – Recoge los ficheros del directorio y crea los respectivos mensajes para ser procesados en el SAP NW PI pero el fichero no es borrado del directorio con lo que en el siguiente poll volverá a ser procesado.  Notar que si se ha confiruado el procesado de mensajes con fichero de trigger y/o con fichero de firma y/o con fichero de checksum, estos ficheros tampoco serán borrados.
    • Archive - Recoge los ficheros del directorio y crea los respectivos mensajes para ser procesados en el SAP NW PI, el fichero es borrado del directorio origen pero es archivado nuevamente en el directorio del sistema de ficheros del SAP NW PI configurado o en el directorio del  sistema de ficheros del servidor SFTP configurado. Al ser borrado del directorio de lectura del canal en el siguiente poll no se encontrará el fichero. Este modo hace un control del nombre del fichero por lo que el “message system “del AAE no dejará procesar un fichero con el mismo nombre.  Notar que si se ha confiruado el procesado de mensajes con fichero de trigger y/o con fichero de firma y/o con fichero de checksum, estos ficheros también serán archivados. Existe una excepción con el  fichero de trigger que podrá ser borrado si el check “Delete Trigger File” es activado.
    • Delete - Recoge los ficheros del directorio y crea los respectivos mensajes para ser procesados en el SAP NW PI, el fichero es borrado del directorio origen. Al ser borrado del directorio de lectura del canal en el siguiente poll no se encontrará el fichero. Este modo hace un control del nombre del fichero por lo que el “message system “del AAE no dejará procesar un fichero con el mismo nombre. Notar que si se ha confiruado el procesado de mensajes con fichero de trigger y/o con fichero de firma y/o con fichero de checksum, estos ficheros también serán borrados.
    • El tratamiento de ficheros vacíos, pudiendo decidir si:
      • Se recoge el fichero pero no se crea mensaje en SAP NW PI (Do Not Create Message).
      • Se recoge el fichero y se crea un mensaje vacío en SAP NW PI (Process Empty files).
      • O se ignora el fichero y ni se recoge ni se genera mensaje en SAP NW PI (Skip Empty Files).
      • El archivado de mensajes erróneos, pudiendo especificar el directorio del sistema de ficheros del SAP NW PI donde alojar los ficheros recogidos por el adaptador y cuyo procesado en el “module processor” produjo un error.
      • La definición del tipo de fichero pudiendo especificar si es binario o de texto

Los parámetros para especificar todos estos aspectos funcionales son:

Quality of Service (QoS): Calidad del servicio con 3 posibles valores:

• Best Effort (BE): Llamada síncrona
• Exactly Once (EO): Llamada asíncrona
• Exactly Once in Order (EOIO): Llamada asíncrona especificando la cola para obligar a que los mensajes se procesen en orden.

Queue Name (Solo para QoS EOIO): Nombre de la cola a utilizar en el  procesamiento.

Trigger Mode: Especifica el modo de recogida de ficheros. Los posibles valores son:

• Trigger by polling: Se lanza el procesado de ficheros cada intervalo de tiempo marcado por “Poll interval”.
• Trigger by polling and by file (one trigger file per file): Se lanza el procesado de ficheros cada intervalo de tiempo marcado por “Poll interval” y si y solo si para cada fichero a procesar está presente el fichero de trigger cuyo nombre cumple con el esquema de nombres especificado en el parámetro “Trigger file name schema”.
• Trigger by polling and by file (one trigger file per all): Se lanza el procesado de ficheros cada intervalo de tiempo marcado por “Poll interval” y si y solo si existe el fichero de trigger cuyo nombre cumple con el esquema de nombres especificado en el parámetro “Trigger file name schema”.

Trigger file name schema: Este parámetro se debe informar solo si el “Trigger Mode” es “Trigger by polling and by file (one trigger file per file)” o “Trigger by polling and by file (one trigger file per all)”. Se trata del esquema del nombre del fichero de trigger. Si el modo de trigger es “Trigger by polling and by file (one trigger file per file)” en el valor de este parámetro se permiten los siguientes caracteres especiales.

• %f: Nombre del fichero a procesar
•  %fwoe: Nombre del fichero a procesar sin extensión

Por el contrario, si el modo de trigger es “Trigger by polling and by file (one trigger file per all)” no se permiten carácteres especiales.

Poll Interval (secs): Intervalo de tiempo en segundos entre cada intento de lectura de nuevos ficheros a procesar por el adaptador.

Poll Interval (msecs): Tiempo adicional de espera en milisegundos para el intervalo de recogida de ficheros.

Si “Poll Interval (secs)” es “null” el intervalo de polling será “Poll Interval (msecs)”.

Si  “Poll Interval (secs)” y “Poll Interval (msecs)” son “null” solo se hará polling una sola vez.

Retry Interval (secs): Tiempo en segundos que el adaptador espera a procesar otra vez un fichero erróneo.

Si el valor introducido es mayor que 0 y menor que “Poll Interval ” hace un reproceso pasados “Retry Interval(secs)” segundos.

Si está vacío o el valor indicado es superior a “Poll Interval” el reproceso lo hará en el siguiente poll.

Processing Mode: Forma de procesar el fichero después de la lectura:

• Archive: Archivar ficheros con los siguientes parámetros que aparecen si seleccionamos esta opción:
  • Delete Trigger File: Indicador para borrar el fichero de trigger en el procesado del mensaje.
  • Add Time Stamp: Indicador para archivar el fichero con el nombre original precedido del time stamp del momento del procesado (en formato “yyyyMMdd-HHmmss-SSS”).
  • Archive Directory: Directorio donde archivar el fichero.
  • Archive Files on SFTP Server: Indicador para archivar ficheros procesados en el servidor SFTP. Si no está marcado, se guardan en un directorio del propio PI.
  • Test: No realitzar ninguna acción después de la lectura
  • Delete: Borrar fichero

Empty File Handling: Forma de tratamiento de los ficheros vacíos:

• Do Not Create Message: El fichero se procesa (se archiva o se borra según se haya especificado), pero no se genera ningún mensaje en PI.
• Process Empty Files: El fichero se procesa de forma normal.
• Skip Empty Files: Se ignora el fichero.

Archive Faulty Source Files: Flag que indica si se quieren guardar los ficheros procesados de forma incorrecta. Estos se ficheros se guardarán en carpetas visibles por el SAP NW PI por NFS. Se puede configurar si el nombre del fichero que se guarda se le añade un timestamp o no.

File Type: Forma de transmisión de los ficheros:

• Binary
• Text

File Encoding (solo para file type text): Especificar el encoding de la lectura del fichero de texto.

“Run Operating System Command Before Message Processing”

Ejecuta un comando de sistema operativo (En SAP NW PI) antes de procesar el mensaje

Command Line: Comando a ejecutar.

Para especificar rutas de ficheros en el comando, se ha de utilizar el separador de directorios nativo del SAP NW PI. Es decir cuando es una máquina Windows i se quiere poner un comando que indique una ruta del sistema de ficheros, las carpetas  se separan por "\", en cambio si  es un Linux, las carpetas se separan por “/”.

Timeout (secs): Timeout para la ejecución. Se puede forzar un timeout para la ejecución del  comando, si no se especifica este timeout el sistema siempre tiene un timeout por defecto de 5 segundos.

Terminate Program After Timeout: Finalizar la ejecución después del timeout si se marca este indicador. Si no se marca, la ejecución del comando seguirá en fondo hasta que acabe o se alcance el timeout del adaptador (los 5 segundos).

“Run Operating System Command After Message Processing”

Ejecuta un comando de sistema operativo (En SAP NW PI) después de procesar el mensaje

Command Line: Comando a ejecutar.

Para especificar rutas de ficheros en el comando, se ha de utilizar el separador de directorios nativo del SAP NW PI. Es decir cuando es una máquina Windows i se quiere poner un comando que indique una ruta del sistema de ficheros, las carpetas  se separan por "\", en cambio si  es un Linux, las carpetas se separan por “/”.

Timeout (secs): Timeout para la ejecución. Se puede forzar un timeout para la ejecución del  comando, si no se especifica este timeout el sistema siempre tiene un timeout por defecto de 5 segundos.

Terminate Program After Timeout: Finalizar la ejecución después del timeout si se marca este indicador. Si no se marca, la ejecución del comando seguirá en fondo hasta que acabe o se alcance el timeout del adaptador (los 5 segundos).