Generación de código
El generador de código es una función integrada en MapForce que le permite generar código a partir de archivos de asignación. Puede utilizar el código generado para ejecutar sus asignaciones de datos fuera de MapFprce, lo que le permitirá automatizar sus operaciones de asignación. Estos son los lenguajes de transformación de datos en los que puede generar código:
•XSLT 1.0/XSLT 2.0/XSLT 3.0 (todas las ediciones)
•XQuery (ediciones Professional y Enterprise)
•Java (ediciones Professional y Enterprise)
•C# (ediciones Professional y Enterprise)
•C++ (ediciones Professional y Enterprise)
Puede generar código a partir de un solo diseño de asignación (.mfd) o a partir de un proyecto de asignación (.mfp). Sin embargo, sólo puede generar código a partir de un proyecto en las ediciones Enterprise y Professional. Para más detalles siga leyendo.
Puntos importantes
A la hora de generar código debe tener en cuenta los siguientes aspectos:
•Algunas funciones de MapForce no son compatibles con el código de programa generado. Para más detalles consulte el apartado Funciones compatibles en el código generado.
•Para obtener más información sobre la gestión de rutas de acceso en el código generado consulte el apartado Rutas de acceso según el entorno de ejecución.
•Las ediciones Enterprise y Professional: En la sección Generación del cuadro de diálogo Opciones puede configurar las opciones generales de generación de código. Para más detalles consulte el apartado Generación.
•Las ediciones Enterprise y Professional: La compatibilidad con las conexiones a bases de datos varía según la plataforma, y hay tipos de conexión que no son compatibles con todas las plataformas. Si su asignación se conecta a una base de datos, elija una conexión de base de datos que sea compatible con el entorno de destino para el que genera el código. Para obtener más información, consulte Asignaciones de bases de datos en distintos entornos de ejecución.
Información de compatibilidad
En la siguiente tabla puede ver un resumen de la información de compatibilidad con los lenguajes de programación C++, C# y Java.
Lenguaje de destino | C++ | C# | Java |
|---|---|---|---|
Entornos de desarrollo | Microsoft Visual Studio 2013, 2015, 2017, 2019, 2022 | Microsoft Visual Studio 2013, 2015, 2017, 2019, 2022
Marcos de destino:
•.NET Framework •.NET Core 3.1 •NET 5.0 •NET 6.0 •NET 8.0 | Java SE JDK 8, 11, 17, 21 (incluido OpenJDK) Eclipse 4.4 o superior Apache Ant |
Implementaciones XML DOM | MSXML 6,0 Apache Xerces 3 | System.Xml | JAXP |
API de la base de datos | ADO | ADO.NET | JDBC |
Generar código a partir de una asignación de datos
Para generar código a partir de un diseño de asignación (.mfd), siga estos pasos:
1.En el cuadro de diálogo Opciones (para C# y C++) o en las opciones de la asignación, vaya a la sección Generación y seleccione las opciones de generación de código relevantes. Para más detalles sobre la configuración de la generación de código en el cuadro de diálogo Opciones, véase el apartado Generación.
2.Haga clic en Archivo | Generar código en y seleccione el lenguaje de transformación correspondiente. Otra opción es seleccionar Archivo | Generar código en el idioma seleccionado. En este caso, el código se generará en el idioma que haya seleccionado en la barra de herramientas.
3.Seleccione el directorio de destino para los archivos que se deben generar y haga clic en Aceptar para confirmar. MapForce genera el código y muestra el resultado de la operación en la ventana Mensajes.
Generar código a partir de un proyecto (ediciones Professional y Enterprise)
Puede generar código C# a partir de proyectos de asignación (.mfp) que consistan en varios archivos de diseño de asignación (.mfd). Tenga en cuenta que para ello todos los archivos del proyecto deben ser compatibles con C#, es decir, todos sus componentes deben serlo también, como se explica en Funciones compatibles en el código generado.
Para generar código a partir de un proyecto de asignación, siga las instrucciones a continuación.
1.Abra el proyecto de asignación correspondiente a partir del cual quiere generar el código.
2.Haciendo clic con el botón derecho en el nombre del proyecto en la ventana Proyecto y entonces eligiendo el comando de menú Propiedades del menú contextual. Otra opción es hacer clic en el nombre del proyecto y seleccionar el comando Propiedades del menú Proyecto.
3.Revise y modifique la configuración del proyecto según proceda. Sobre todo debe comprobar que el lenguaje de destino y el directorio de salida están configurados correctamente. Después haga clic en Aceptar.
4.En el menú Proyecto haga clic en Generar código para todo el proyecto.
Independientemente del idioma seleccionado en el cuadro de diálogo Propiedades del proyecto, siempre puede optar por generar el código del proyecto en un idioma diferente, seleccionando el comando de menú Proyecto | Generar código en | <idioma>.
Los progresos y resultados de la generación de código aparecen en la ventana Mensajes. Por defecto, el nombre de la aplicación que se ha generado es igual al nombre de proyecto. Si el nombre del proyecto contiene espacios, éstos se convertirán en guiones bajos en el código generado. El código se genera por defecto en el directorio donde está ubicado el proyecto de MapForce, en el subdirectorio output.
Puede modificar el directorio de salida y/o el nombre del proyecto en el cuadro de diálogo Propiedades del proyecto. Si su proyecto de MapForce tiene carpetas, podrá cambiar las opciones de generación de código para cada una de las carpetas por separado: Haga clic con el botón derecho en una carpeta de interés y seleccione Propiedades del menú contextual. Sino todas las carpetas del proyecto heredan por defecto las opciones de generación de código del nivel superior. Para obtener más información sobre los proyectos, su configuración y los procedimientos relacionados con ellos, consulte el apartado Proyectos.
Siguientes pasos
Los siguientes pasos varían en función del lenguaje de transformación que haya seleccionado para la generación de código. Si ha generado código en XSLT 1-3 o XQuery, el siguiente paso será ejecutar la transformación desde la línea de comandos (ver detalles más abajo).
Si ha generado código Java, C# o C++, los siguientes pasos consistirán en compilar y ejecutar el código generado. Para más información sobre estos procedimientos, consulte Generador de código. También puede modificar el código Java, C# y C++ generado e integrarlo en su código personalizado. Para más detalles consulte Integrar código generado.
Código XSLT y XQuery
Una vez generado el código XSLT 1-3, la carpeta de destino incluirá los siguientes archivos:
1.Un archivo de transformación XSLT que tiene este formato: <Mapping>MapTo<TargetFileName>.xslt. <Mapping> es el valor del campo ApplicationName en la configuración de la asignación. <TargetFileName> es el nombre del componente de destino de la asignación. Para cambiar este valor abra la configuración del componente y edite el valor del campo Nombre del componente. Para más información consulte Cambiar configuración de los componentes y Rutas de acceso según el entorno de ejecución.
2.Un archivo DoTransform.bat, que permite ejecutar la transformación XSLT con Altova RaptorXML Server desde la línea de comandos. Para ejecutar este comando necesita tener instalado RaptorXML.
Si se trata de una asignación encadenada, se generará un archivo de transformación diferente para cada componente de destino.
La generación de código XQuery es similar a la generación de código XSLT, con la diferencia de que los archivos de transformación tienen una extensión .xq y el siguiente formato: <Mapping>MapTo<TargetFileName>.xq.