Resultado de la ejecución
El resultado de la ejecución de un trabajo es un registro detallado del resultado del trabajo. Un resultado de ejecución típico incluye los siguientes componentes: el estado del trabajo (por ejemplo, éxito), la hora de inicio y finalización, el código de salida, los registros de ejecución, los datos de salida, la información de reintentos y la información sobre los desencadenadores. El resultado de la ejecución se puede utilizar para supervisar, solucionar problemas y analizar el rendimiento de las tareas.
FlowForce Server le permite declarar el tipo devuelto de un trabajo. A la hora de declarar el tipo devuelto, tenga en cuenta estos aspectos:
•Es obligatorio declarar el tipo devuelto si desea procesar el valor devuelto por un trabajo en otro trabajo (ejemplo siguiente).
•Solo tiene sentido declarar el tipo devuelto en los trabajos que devuelven resultados.
•También es obligatorio declarar el tipo devuelto si desea almacenar en caché el resultado de un trabajo.
•El tipo devuelto de un trabajo debe coincidir con el tipo de datos del último paso del trabajo. De lo contrario, FlowForce Server devuelve un error. Para evitar errores de coincidencia de tipos de datos, utilice funciones de expresión para cambiar el tipo de datos del último paso del trabajo al tipo de datos declarado como tipo devuelto del trabajo.
Cómo definir el tipo devuelto
Para definir el tipo devuelto de un trabajo siga estos pasos:
1.Cree un trabajo nuevo o abra un trabajo actual para editarlo.
2.Seleccione el tipo devuelto en la sección Resultado de la ejecución de la página de configuración.
Tipos devueltos
Estos son los tipos devueltos que puede elegir en el cuadro combinado:
•ignorar/desechar
•cadena de texto
•secuencia
•número
•booleano
•credencial
•certificado
•resultado
•Socio AS2 (Advanced Edition)
•AS2 MDN (Advanced Edition)
•Conexión SFTP (Advanced Edition)
La opción predeterminada es ignorar/desechar. Ordena a FlowForce Server que ignore o descarte el resultado de un trabajo. Seleccione esta opción si el trabajo no devuelve ningún resultado o si no tiene pensado utilizar el restado devuelto.
Información sobre el tipo devuelto
Un valor devuelto de tipo result representa el resultado de una función de paso (por ejemplo, un paso que ejecuta una asignación de MapForce o un paso que ejecuta un comando de shell). Puede acceder al contenido del resultado y manipularlo utilizando las siguientes funciones de expresión:
•stdout: Toma un resultado de tipo result como argumento y produce una secuencia.
•stderr: Obtiene el error estándar del resultado.
•results: Devuelve una lista de todas las secuencias de resultados.
•exitcode: Devuelve el código numérico de salida del resultado (si está disponible).
•error-message: Devuelve un mensaje de error textual (si está disponible).
Ejemplo
Este ejemplo explica cómo acceder al valor devuelto de un trabajo en otro trabajo. Los procedimientos de configuración constan de dos etapas:
1.En primer lugar, configuramos un trabajo que ejecuta una asignación de MapForce. Esta asignación produce varios archivos de salida.
2.En segundo lugar, configuramos otro trabajo que llama a la asignación en uno de sus pasos, selecciona solo un archivo de salida y copia este archivo al directorio de destino.
Trabajo 1: Ejecutar la asignación de MapForce implementada
Para poder crear un trabajode FlowForce que ejecute una asignación MapForce, primero es necesario implementar esta asignación en FlowForce Server. Para obtener más información, consulte el tutorial Asignación de MapForce como un trabajo programado). Para este ejemplo, hemos elegido la siguiente asignación que se incluye con MapForce: MapForceExamples\SplitFiles.mfd (imagen siguiente). Esta asignación produce múltiples archivos de salida, cuyos nombres se crean de forma dinámica, a partir de los parámetros proporcionados a la asignación.
Después de implementar esta asignación en FlowForce Server, hemos configurado el siguiente trabajo:
El trabajo tiene un bloque Control de errores que ejecuta la asignación y copia los archivos de salida a la ruta indicada en el campo Directorio de trabajo. Si la ejecución de la asignación, se ejecutará el paso Cuando haya errores, es decir, se enviará un correo electrónico con un mensaje de error al destinatario especificado. Tenga en cuenta que para poder enviar correos electrónicos, primero debe configurar los ajustes SMTP.
Dado que este trabajo produce un resultado que pretendemos utilizar en otro trabajo, debemos declarar el valor devuelto del trabajo. Para ello, hemos seleccionado result en la lista desplegable de la sección Resultado de la ejecución (imagen anterior). Tenga en cuenta que si no declara el tipo devuelto del trabajo, no podrá acceder al resultado del trabajo en otro trabajo. Además, no será posible guardar ese otro trabajo.
Para ejecutar el trabajo, introduzca sus credenciales.
Para obtener más información sobre la integración de FlowForce Server con MapForce y otros productos de Altova, consulte Integración con productos de Altova.
Trabajo 2: Llamar a la asignación de datos y seleccionar una sola salida
El objetivo del segundo trabajo es llamar al trabajo con la asignación implementada, seleccionar un solo archivo de salida y enviar este archivo al directorio de destino. La imagen siguiente ilustra la configuración de este trabajo.
El primer paso ejecuta el Trabajo 1 que acabamos de configurar. Hemos asignado el resultado del paso al valor MapOutput de tipo result. Esto nos permitirá utilizar el valor devuelto de este paso en el segundo paso.
En el segundo paso, llamamos a la función del sistema copy que copia el archivo de origen a la carpeta de destino. El campo Origen contiene la siguiente expresión:
{as-file(nth(results(MapOutput), 2))}
La función results convierte el resultado del paso de asignación en una lista de secuencias de resultados. La función nth toma la lista de secuencias como primer argumento y selecciona el tercer elemento (la función nth tiene base cero). La función as-file crea un archivo a partir de la secuencia. El archivo de salida denominado Company03.txt se guardará en la ruta especificada en el campo Destino. Si el archivo de destino ya existe, se sobrescribirá.
Tenga en cuenta que la expresión está entre llaves. Esto se debe a que el campo Origen espera una cadena. Para obtener más información sobre las expresiones y su sintaxis, consulte Expresiones.
No es necesario declarar el tipo devuelto del segundo trabajo, ya que no se pretende utilizar el valor devuelto de este trabajo en ningún otro trabajo.
Para probar el trabajo, introduzca sus credenciales y configure un desencadenador que inicie el trabajo.
Salida de Trabajo 2
Una vez finalizado el trabajo, el archivo Company03.txt se ha guardado correctamente en la carpeta de destino. El archivo contiene los siguientes detalles:
"Nanonull Europe, AG",Research & Development,Valentin,Rutger,R&D Manager,v.rutger@nanonull.com,1500,28,21,7
"Nanonull Europe, AG",Research & Development,Gaia,Winkler,Research Scientist,g.winkler@nanonull.com,500,22,5,17
"Nanonull Europe, AG",Research & Development,Felipe,Gomez,Research Scientist,f.gomez@nanonull.com,500,20,6,14
"Nanonull Europe, AG",Research & Development,Mirko,Filipcic,Research Scientist,m.filipcic@nanonull.com,500,21,8,13
"Nanonull Europe, AG",Research & Development,Norbert,Riedler,Research Scientist,n.riedler@nanonull.com,1500,18,2,16
"Nanonull Europe, AG",Research & Development,Sabine,Kraus,Research Scientist,s.kraus@nanonull.com,0,18,7,11
"Nanonull Europe, AG",Research & Development,Robert,Manko,Research Scientist,r.manko@nanonull.com,500,20,10,10
"Nanonull Europe, AG",Research & Development,Mandy,Mitchell,Research Scientist,m.mitchell@nanonull.com,500,19,6,13
"Nanonull Europe, AG",Research & Development,Lempel,Wenzl,Research Scientist,l.wenzl@nanonull.com,0,28,3,25
"Nanonull Europe, AG",Research & Development,Max,Matzik,Research Scientist,m.matzik@nanonull.com,0,19,5,14