Configuración de plantillas de pasos para ejecutar pasos externos que utilizan la línea de mandatos o archivos de control

Se trata del mandato real y de los parámetros de línea de mandatos que emite RICOH ProcessDirector para ejecutar el programa externo. La serie de caracteres del mandato puede incluir la notación de símbolos RICOH ProcessDirector:

• En este ejemplo, el mandato cp de Linux solo copia el archivo NúmeroTrabajo.print.pdf desde el directorio de spool para el trabajo cuando el archivo de origen es más reciente que el archivo de destino:
  cp -u ${getAbsoluteFileName(print, pdf, read)} /tmp/jobarchives
  Nota:
  • ${getAbsoluteFileName(print, pdf, read)} es la fórmula de símbolos de RICOH ProcessDirector que devuelve el nombre del archivo de impresión PDF del directorio de spool. Si el archivo de impresión PDF no existe en el directorio de spool cuando se ejecuta el programa externo, se produce un error.
• En este ejemplo, el programa externo myprogram lee el archivo NúmeroTrabajo.print.pdf desde el directorio de spool y graba una versión actualizada del archivo en el directorio de spool utilizando la redirección:
  myprogram -i ${getFileName(print, pdf, read)} > ${getFileName(print, pdf, write)}
  Nota:
  • ${getFileName(print, pdf, read)} es la fórmula de símbolos de RICOH ProcessDirector que devuelve el nombre del archivo de impresión PDF del directorio de spool. Si el archivo de impresión PDF no existe en el directorio de spool cuando el programa externo se ejecuta, RICOH ProcessDirector devuelve el nombre del archivo de entrada para el trabajo, que es NúmeroTrabajo.print.unknown. Si dicho archivo no existe en el directorio de spool, se produce un error.
• En este ejemplo, el programa externo auditstatistics lee el archivo NúmeroTrabajo.overrides.text desde el directorio de spool y graba un nuevo archivo de estadísticas NúmeroTrabajo.statistics.text en el directorio de spool:
  auditstatistics inputfile=${getFileName(overrides, text, read)} outputfile=${getFileName(statistics, text, write)}
• En este ejemplo, el programa externo line2afp utiliza un archivo de parámetros independiente para el que existe un archivo de control de RICOH ProcessDirector correspondiente si la función Compatibilidad con AFP está instalada. El archivo de control especifica un método de RICOH ProcessDirector que insta al programa externo a escribir su salida en el directorio de spool:
  line2afp parmdd=${getControlFileName()}
  Nota:
  • ${getControlFileName()} es la fórmula de símbolos RICOH ProcessDirector que devuelve el nombre del archivo de control resuelto. RICOH ProcessDirector genera el archivo de control a partir de la plantilla de archivo de control que especifique.
  • El archivo de control puede utilizar el método getChildFileName para devolver el nombre de un archivo hijo, de modo que el programa externo pueda grabar un archivo en el subdirectorio children del directorio de spool. El programa externo debe grabar los nombres de archivo de los archivos hijo del trabajo con este formato:
    JobNumber.UsageType.DataType.n,Job.JobType=WorkflowName
    WorkflowName es el nombre del flujo de trabajo que requiere el trabajo hijo. El flujo de trabajo debe existir y debe estar habilitado.
  • Cuando añada un paso basado en la plantilla de pasos RunExternalProgram a un flujo de trabajo, las propiedades que muestran [Recepción] en los valores por omisión del trabajo cambian para reflejar la fase real a la que añade el paso.
• En este ejemplo, el paso externo utiliza el mandato copy de Windows para grabar una copia del archivo NúmeroTrabajo.print.pdf desde el directorio de spool a un directorio de archivado del sistema Windows:
  copy ${getAbsoluteFileName(print,pdf,read)} d:\archive\pdf
  Nota:
  • El sistema Windows debe tener instalado bien el producto base o bien un servidor de aplicaciones. El servidor de aplicaciones debe estar conectado al servidor primario.
  • Especifique el directorio de Windows utilizando el formato nativo de Windows para el nombre de directorio.
  • Utilice mandatos nativos de Windows en lugar de mandatos SFU cuando sea adecuado; por ejemplo, utilice el mandato copy en lugar del mandato cp. No todos los mandatos SFU están disponibles en los sistemas Windows.
  • Dependiendo del mandato, es posible que no sea necesario que exista un sistema Windows. El mandato puede crear el directorio en el sistema Windows.
  • Asegúrese de ajustar la plantilla de pasos para ejecutar solo un servidor de aplicaciones de Windows. Debido a los formatos diferentes de los nombres de directorio de Linux y AIX, un paso basado en esta plantilla de pasos fallará si RICOH ProcessDirector intenta ejecutar el paso en un sistema que no es Windows.

En este contexto, un código de retorno válido es cualquier código de retorno del programa externo que no requiere ninguna acción por parte del usuario. Separe los números de código de retorno múltiples con comas. Para cualquier código de retorno del programa externo que no esté incluido en el valor de esta propiedad, RICOH ProcessDirector mueve el trabajo al estado de error. También emite un mensaje en el registro del trabajo para que le alerte acerca de un problema que ha notificado el programa externo.

Por ejemplo, si el valor de la propiedad de códigos de retorno válidos es 0,4 y el programa externo finaliza con un código de retorno de 16, RICOH ProcessDirector emite un mensaje similar al siguiente:

AIWI6073E El paso externo cp /aiw/aiw1/spool/default/10000016/10000016.print.unknown /archive/directory ha finalizado con el código de retorno 16, que se define como un error.