Resultado de la ejecución
FlowForce Server le permite declarar el tipo de valor devuelto de un trabajo. A la hora de declarar el tipo devuelto, tenga en cuenta estos aspectos:
•La declaración del tipo devuelto es obligatoria si desea procesar el valor devuelto de un trabajo en otro trabajo (ver ejemplo siguiente).
•Solo tiene sentido declarar el tipo devuelto en los trabajos que devuelven resultados.
•Declarar el tipo devuelto también es obligatorio 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 correspondencia de tipos de datos, utilice funciones de expresión para cambiar el tipo de datos en el último paso del trabajo por el 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.
Sobre el tipo result
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 datos de MapForce o un paso que ejecuta un comando shell). Puede acceder y manipular el contenido del resultado, 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 en el directorio de destino.
Trabajo 1: Ejecutar asignación de datos de MapForce implementada
Para poder crear un trabajo FlowForce que ejecute una asignación de datos de MapForce, primero necesitamos implementar dicha asignación en FlowForce Server. Consulte también el tutorial Asignación de datos de MapForce como trabajo programado para más detalles. Para este ejemplo, hemos elegido la siguiente asignación de datos, que se suministra junto con MapForce: MapForceExamples\SplitFiles.mfd (imagen siguiente). Esta asignación produce varios archivos de salida, cuyos nombres se crean dinámicamente, en función de los parámetros suministrados a la asignación.
Después de implementar esta asignación en FlowForce Server, hemos configurado el siguiente trabajo:
El trabajo tiene un bloque de control de errores que ejecuta la asignación y copia los archivos de salida en la ruta indicada en el campo Directorio de trabajo. Si la ejecución de la asignación da error, 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, y tampoco podrá guardar este otro trabajo.
Para ejecutar el trabajo, facilite sus credenciales.
Para más detalles 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 y seleccionar solo una salida
El objetivo del segundo trabajo es llamar al trabajo con la asignación implementada, seleccionar solo un archivo de salida y enviar este archivo al directorio de destino. La siguiente imagen 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 de sistema copy, que copia el archivo de origen en 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 de datos 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 llamado Company03.txt se guardará en la ruta especificada en el campo Destino. Si el archivo de destino ya existe, se sobrescribirá.
Observe que la expresión está entre llaves. Esto se debe a que el campo Origen espera una cadena. Para más detalles sobre las expresiones y su sintaxis, consulte Expresiones.
Declarar el tipo devuelto del segundo trabajo no es necesario, porque no tenemos intención de utilizar el valor devuelto de este trabajo en ningún otro trabajo.
Para probar el trabajo, facilite sus credenciales y configure un desencadenador que inicie el trabajo.
Resultado de Trabajo 2
Después de que se inicie el trabajo, Company03.txt se ha guardado correctamente en la carpeta de destino. El archivo contiene los siguientes datos:
"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