Asignación de datos de MapForce como trabajo programado
Este tutorial muestra cómo se implementa una asignación de datos de Altova MapForce en FlowForce Server y cómo se ejecuta la asignación como un trabajo programado. A grandes rasgos:
1.Primero vamos a implementar una asignación de datos de MapForce en FlowForce Server. Tras definir todas las opciones de configuración pertinentes, el explorador mostrará la página de configuración del trabajo, que ya incluirá la asignación de datos como paso de ejecución.
2.Después, añadiremos un paso de ejecución que comprobará si existe la ruta de acceso del resultado de la asignación de datos.
3.En el siguiente paso, agregaremos un paso condicional que creará un directorio para el resultado de la asignación de datos si este directorio no existe.
4.A continuación, configuraremos un temporizador que desencadenará el trabajo de acuerdo con un horario específico.
5.También seleccionaremos una credencial de contraseña existente, con la que se ejecutará el trabajo.
6.Una vez ejecutado el trabajo, comprobaremos el directorio de salida en busca del archivo generado por la asignación de datos.
Licencias necesarias
Tenga en cuenta que debe disponer de las siguientes licencias para esta configuración de trabajo: MapForce Enterprise Edition, MapForce Server Advanced Edition y FlowForce Server.
Implementación
Este apartado ofrece instrucciones paso a paso para crear el trabajo que acabamos de describir. La implementación de esta situación también se muestra en el archivo GIF al final de este tema.
Paso 1: Implementar la asignación de datos de MapForce en FlowForce Server
Para este tutorial, utilizaremos un ejemplo que se suministra junto con Altova MapForce:
<Documentos>\Altova\MapForce2025\MapForceExamples\BookCatalogPDFToXML.mfd
Abra este archivo en MapForce y proceda como se indica a continuación:
1.Abra el menú Archivo y seleccione Implementar en FlowForce Server.
2.Aparece el cuadro de diálogo Implementar asignación, donde debe introducir los detalles de conexión pertinentes.
3.Deje la ruta predeterminada de la asignación implementada y las demás opciones tal y como están.
4.Haga clic en Aceptar.
5.La asignación implementada se abrirá en la página de configuración de trabajos de la interfaz de administración de FlowForce Server, como un paso de ejecución. Haga clic en el icono + situado junto al parámetro Directorio de trabajo e introduzca esta ruta de acceso: C:\Test\FlowForceServer\MapOutput. Es la ruta en la que se guardará el archivo que produce la asignación de datos.
Paso 2: Agregar un paso de ejecución que compruebe si existe una ruta de acceso
En el siguiente paso, queremos comprobar si existe el directorio de salida que almacenará el archivo que produce la asignación de datos. Para hacerlo siga estos pasos:
1.Haga clic en el icono + situado encima del paso que tiene la asignación implementada y seleccione Nuevo paso de ejecución. Ahora aparecerá el bloque del paso de ejecución.
2.Busque la función /system/shell/commandline en el campo Ejecutar función. Esta función del sistema puede ejecutar comandos shell y archivos por lotes.
3.Introduzca el siguiente comando en el parámetro Comando:
IF EXIST C:\Test\FlowForceServer\MapOutput (ECHO true) ELSE (ECHO false)
Este comando comprueba si el directorio de salida existe. Si el directorio existe, el comando devolverá true. De lo contrario, devolverá false.
4.Escriba output en el campo Asignar el resultado del paso a. Al hacerlo, asignamos el resultado del paso al valor output del tipo result. Es necesario Asignar el resultado del paso porque así podremos utilizar el resultado de este paso en el paso siguiente.
Paso 3: Agregar un paso Opción
A continuación, tenemos que añadir un paso condicional que creará el directorio de salida si no existe. Para ello siga estos pasos:
1.Añada un paso Opción como se indica a continuación: Haga clic en el icono + situado tras el primer paso de ejecución y seleccione nuevo paso Opción. Aparecerá el bloque Opción.
2.En el campo si, escriba esta expresión:
trim(content(stdout(output))) == 'false'
La función stdout toma el resultado producido por el paso de ejecución anterior y da como resultado una secuencia. La función content convierte la secuencia de datos en una cadena de texto. Después, la función trim elimina todos los espacios iniciales y finales de la cadena.
El motivo por el que convertimos el resultado en una cadena es porque queremos comprobar si el resultado es igual a la cadena false. Para poder comparar las dos partes de la expresión, debemos asegurarnos de que ambas partes son del mismo tipo de datos.
El motivo por el que recortamos la cadena es que el resultado estándar puede contener espacios iniciales y finales que se conservan cuando convertimos la secuencia en cadena. Sin la función trim, el resultado de la parte izquierda de la expresión puede no ser igual a la cadena false.
3.Añada un paso de ejecución en la parte Si del paso Opción: Haga clic en el icono + y seleccione Nuevo paso de ejecución.
4.Busque la función /system/filesystem/mkdir en el campo Ejecutar función.
5.Añada la siguiente ruta al parámetro Ruta: C:\Test\FlowForceServer\MapOutput.
6.Deje la parte De lo contrario del bloque Opción tal como está.
Si el directorio de salida no existe, el paso Opción lo creará. Si el directorio de salida existe, el paso Opción no se ejecutará y la ejecución del trabajo proseguirá con la asignación de datos.
Paso 4: Configurar un temporizador que desencadenará el trabajo
Como queremos ejecutar el trabajo a un horario determinado, necesitamos configurar un temporizador que desencadene el trabajo. Para agregar un temporizador siga estos pasos:
1.Navegue hasta la sección Desencadenadores de la página de configuración del trabajo y seleccione Temporizador nuevo.
2.Defina la opción Ejecutar como Días de la semana.
3.Establezca el día o los días en los que se ejecutará el trabajo. En nuestro ejemplo, el trabajo se ejecutará todos los jueves.
4.Defina la fecha y hora de inicio en el parámetro Inicio.
5.Asegúrese de que la casilla Habilitado está seleccionada.
Paso 5: Agregar una credencial
Cuando cree un trabajo en FlowForce Server, tiene que suministrar las credenciales de la cuenta de usuario con la que debe ejecutarse el trabajo.
En la sección Credenciales, seleccionaremos una credencial de contraseña que hemos creado antes de comenzar este tutorial. Se trata de un objeto de credencial independiente que puede utilizar en cualquier trabajo. Las credenciales independientes son prácticas porque se pueden cambiar en un solo lugar y este cambio afectará a todos los trabajos que utilicen esa referencia de credencial.
La otra opción es especificar una credencial local, introduciendo su nombre de usuario y contraseña.
Para más información sobre los tipos de credenciales y aprender a crearlas, consulte Credenciales.
Paso 6: Guardar la configuración del trabajo y comprobar el resultado
Para guardar la configuración del trabajo, haga clic en Guardar en la parte inferior de la página de configuración. En cuanto se inicie el desencadenador, el trabajo se ejecutará. Para ver el resultado, navegue hasta C:\Test\FlowForceServer\MapOutput y compruebe si contiene BookList.xml. También puede consultar el registro para obtener detalles sobre la ejecución del trabajo. A continuación puede ver un extracto del archivo BookList.xml:
<BookList xsi:noNamespaceSchemaLocation="BookList.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Book ISBN13="1501143107" Title="Misery" Year="2016" Price="11.99">
<Author>Stephen King</Author>
</Book>
<Book ISBN13="9781910633113" Title="Nightblind" Year="2016" Price="9.99">
<Author>Ragnar Jonasson</Author>
</Book>
<Book ISBN13="1910633461" Title="Blackout" Year="2016" Price="8.49">
<Author>Ragnar Jonasson</Author>
</Book>
<Book ISBN13="1501180983" Title="Outsider" Year="2018" Price="12.79">
<Author>Stephen King</Author>
</Book>
<Book ISBN13="9781435142817" Title="Dracula" Year="2013" Price="13.69">
<Author>Bram Stoker</Author>
</Book>
<Book ISBN13="9781400043286" Title="The Mystery of Edwin
Drood" Year="2004" Price="19.79">
<Author>Charles Dickens</Author>
</Book>
<...>
</BookList>
GIF de demostración
Para ver una demostración rápida de los pasos descritos en este tutorial, haga clic en el archivo GIF que aparece a continuación. Tenga en cuenta que el GIF solo ilustra los pasos 1-4 y 6. Para ver una ilustración del paso 5, consulte el tutorial Hello World.
