Saltar al contenido

Cómo construir un paquete de lanzamiento en Jitterbit App Builder

Introducción

Esta página te muestra cómo construir un paquete de lanzamiento, que es una colección seleccionada de aplicaciones, fuentes de datos y otros componentes, empaquetados juntos para su implementación. Este proceso se utiliza al mover una aplicación de un entorno a otro, por ejemplo, al mover una aplicación de entornos de desarrollo a QA, y de ahí a entornos de producción.

El siguiente diagrama muestra lo que contiene un lanzamiento.

Leyenda

  • Los colores muestran en qué capa reside cada tipo de objeto:

    Color Capa
    Azul   Datos
    Rojo   Negocio
    Verde   UI
    Naranja   Otro

  • Las formas indican el tipo de objeto:

    graph SOLN_OBJ(Solution object) NON_SOLN_OBJ((Non-solution
    object)) classDef default fill:white,stroke:black,stroke-width:1px,rx:15px,ry:15px
--- config: themeVariables: fontFamily: 'Roboto' flowchart: nodeSpacing: 45 rankSpacing: 20 padding: 20 --- graph LR subgraph BOUNDARY[**Release contents**] subgraph OTHER[ ] USER_DEFINED_FUNCTIONS(User-defined function) LOGICAL_DATA_TYPE(Logical Data Type) subgraph BUNDLES[**Bundle**] LANGUAGE_TRANSLATIONS((Language
translation)) end subgraph ASSEMBLIES[**Assembly**] PLUGINS((Plugin)) end end subgraph UI[ ] subgraph APPLICATIONS[**Application**] direction LR MENUS((Menu)) PAGES(Page) SCHEDULES((Schedule)) end subgraph COLLECTIONS[**Collections**] direction LR THEMES((Theme)) IMAGES((Image)) TEMPLATES((Template)) FORMATS((Format)) WIDGETS(Widget) end end subgraph DATA_SOURCES[**Data Source**] direction LR DATA(Data) RULES(Rule) LOGICAL_PHYSICAL_DATA_MODEL(Logical/physical
data model) ROLES(Role) SQL_OBJECTS(SQL object) end end %% General styling classDef defaultSg fill:white,stroke-width:5px,rx:15px,ry:15px class DATA_SOURCES,APPLICATIONS,COLLECTIONS,OTHER,ASSEMBLIES,BUNDLES defaultSg classDef clearSg fill:transparent,stroke-width:0px class UI,OTHER clearSg classDef boundary fill:white,stroke-width:0px,rx:15px,ry:15px class BOUNDARY boundary %% Identifying styling: Subgraphs classDef dataSg stroke:#3b6fc9 class DATA_SOURCES dataSg classDef uiSg stroke:#098565 class APPLICATIONS,COLLECTIONS uiSg classDef otSg stroke:orange class ASSEMBLIES,BUNDLES otSg %% Identifying styling: Nodes classDef dataNode fill:#3b6fc9, color:white class DATA,LOGICAL_PHYSICAL_DATA_MODEL,SQL_OBJECTS dataNode classDef businessNode fill:#db2b48, color:white class RULES,ROLES businessNode classDef uiNode fill:#098565, color:white class THEMES,IMAGES,TEMPLATES,FORMATS,WIDGETS,MENUS,PAGES uiNode classDef otherNode fill:orange class SCHEDULES,PLUGINS,LANGUAGE_TRANSLATIONS,USER_DEFINED_FUNCTIONS,LOGICAL_DATA_TYPE otherNode

Construir un lanzamiento

Construir un lanzamiento en un paquete y luego instalar un paquete en un nuevo entorno se lleva a cabo en el área de Implementación, a la que se accede desde el IDE de App Builder. Durante este proceso, te moverás desde el lado izquierdo de la pantalla del Constructor de Plantillas de Lanzamiento hacia el lado derecho, mientras sigues todos los pasos descritos aquí:

  1. Selecciona Cajón de Acción > IDE.

  2. Selecciona Implementar > Crear Lanzamiento.

  3. Para comenzar una construcción, puedes seleccionar una plantilla existente (si estás actualizando una actualización de aplicación existente) o hacer clic en + Lanzamiento para crear una nueva plantilla.

  4. Si estás utilizando una plantilla existente, haz clic en el botón Template para el registro de plantilla existente.

  5. Actualiza los campos Name, Version y Developer en la pantalla de Release Details para reflejar la versión que estás creando:

    Build release 1

  6. Haz clic en el botón Next.

  7. En la pantalla de Solution Objects, eliges qué incluir en el paquete de lanzamiento. Las opciones son las siguientes:

    • Application
    • Assembly
    • Bundle
    • Collection
    • Data Source
    • Function
    • Logical Data Type
    • Page
    • Role
    • Rule
    • SQL Object
    • Widget

    Para agregar cualquiera de estos, haz clic en el botón + Object, selecciona el tipo del menú y luego haz clic en el botón Save:

    Build release 2

    Notas

    Los siguientes puntos se aplican a los paquetes de lanzamiento:

    • Cuando agregas un objeto de aplicación, el paquete y la fuente de datos de la aplicación se agregan automáticamente al paquete de lanzamiento.

    • El paquete de lanzamiento no incluye grupos de instancia, proveedores de seguridad de instancia ni credenciales de servidor.

    • Los objetos recién soportados (como funciones y tipos de datos lógicos) no se agregan automáticamente a las plantillas preexistentes. Debes agregarlos tú mismo.

  8. Haz clic en el botón Next.

  9. La pantalla de Configure Data Sources enumera todas las fuentes de datos relevantes para la versión de lanzamiento. (Si no hay fuentes de datos, este paso se omite). Para cada fuente de datos enumerada, marca la columna Include y asegúrate de que esté configurada como deseas para la versión. Dependiendo del tipo de fuente de datos, cualquiera de las siguientes opciones está disponible:

    • Logical Model Only: Utiliza cuando deseas empaquetar solo los datos que se crearon y existen en App Builder. Ejemplos: datos y objetos de negocio, subconsultas, CRUDs, flujo de trabajo, puentes. Esta opción se utiliza generalmente para fuentes de datos que no posees y/o no se mantienen a través de App Builder (fuentes de datos externas, fuentes de datos de API, etc.).

    • Modelo Físico Únicamente: Utiliza cuando deseas empaquetar solo las estructuras de tablas y columnas de la fuente de datos, sin los datos.

    • Modelo Lógico y Tablas Físicas: Utiliza cuando deseas incluir todos los datos existentes en App Builder así como las estructuras de tablas y columnas de la fuente de datos subyacente. Aquí, físico se refiere a que App Builder mantiene o realiza actualizaciones en la capa de base de datos real. Si mueves un modelo físico, eso significa que cualquier cambio realizado en desarrollo en la base de datos también se realizará en la base de datos de QA/Prod al mover el LP. Esta opción se utiliza generalmente para fuentes de datos que gestionas.

    • No Incluir: Utiliza si no deseas incluir esta fuente de datos en esta versión.

    Importante

    Si tienes cambios en la base de datos que necesitan ser comprometidos, deberías mover Lógico y Físico para esa base de datos. El proceso de Gestión de Lanzamientos admite la importación de Tablas. Si importas Tablas en una fuente de datos, esas Tablas importadas se crearán en el sistema de destino si son parte del primer conjunto de cambios físicos.

  10. Haz clic en el botón Siguiente.

  11. Si tienes traducciones en tu aplicación, aparecerá la pantalla de Paquetes de Solución. Si no, aparecerá la pantalla de Notas de Lanzamiento con información general sobre el paquete de lanzamiento:

    Build release 3

    • Nombre: El nombre de tu aplicación.

    • Versión: El número de versión del paquete que se está creando.

    • Fecha de Lanzamiento: La fecha en la que deseas que el lanzamiento aparezca (esta es una fecha aproximada y puede ser diferente de la fecha real de lanzamiento).

    • Fecha de Construcción: La fecha en la que comprometiste el paquete.

    • Fecha de Publicación: La fecha en la que liberaste el paquete.

    • Descripción de la Plantilla: Una descripción textual de lo que hace tu aplicación o suite.

  12. Haz clic en el botón Siguiente.

  13. Revisa la información en la pantalla de Publicar, luego haz clic en el botón Finalizar.

    Ahora deberías estar de vuelta en la pantalla de Constructor de Plantillas de Lanzamiento con la columna Listo conteniendo una marca de verificación verde.

  14. Haz clic en el botón Database Changes (Cambios en la Base de Datos), y sabrás que tienes cambios no confirmados para revisar y aprobar si ves que aparece una marca de verificación roja en la columna DB en la pantalla del Release Template Builder (Constructor de Plantillas de Lanzamiento). La pantalla de Change Management Requests (Solicitudes de Gestión de Cambios) enumera todos los cambios relacionados con la fuente de datos que formarán parte del paquete. Si ves algún cambio listado con una marca de verificación roja en la columna Status (Estado), necesitarás hacer clic manualmente en él para revisarlo y aprobarlo.

    Hacer clic para revisar te lleva a la pantalla de Change Management Request (Solicitud de Gestión de Cambios). Aquí, el campo Patch Number (Número de Parche) se completa automáticamente con un valor e indica qué iteración refleja esta actualización del paquete. Asegúrate de revisar todas las entradas listadas en el panel de Changes (Cambios) para garantizar que esta información es lo que esperas que se mueva con el paquete. En esta pantalla necesitas ingresar:

    • Reference Number: (Número de Referencia) Este puede reflejar el valor del Número de Parche, ser una referencia de ticket de JIRA o AHA, o usar un valor de numeración del cliente.

    • Short Description: (Descripción Corta) Proporciona una descripción textual sobre el paquete. Si lo deseas, ingresa información adicional en el campo de Comments (Comentarios).

  15. Haz clic en el botón Save (Guardar), y si estás listo para continuar, haz clic en el botón Close this Request (Cerrar esta Solicitud).

  16. Cierra las pantallas restantes para que estés viendo la pantalla del Release Template Builder (Constructor de Plantillas de Lanzamiento). Ahora verás que aparece una marca de verificación verde en la columna DB.

  17. La Data Config (Configuración de Datos) es opcional y solo se utiliza si estás moviendo Logical (Lógicos) y Physical Data (Datos Físicos) con el paquete. Desde la pantalla de Data Configuration (Configuración de Datos) verás los elementos de todas las fuentes de datos, tablas para la fuente de datos, junto con el tipo de Owner Type (Tipo de Propietario) que se ha asignado junto con la acción correspondiente que ocurre cuando la tabla se mueve a ese entorno. Los diferentes Owner Types son los siguientes:

    • User Data: (Datos de Usuario) No transferirá ninguno de los datos. Los usuarios en cada entorno son responsables de completar esa tabla. Por ejemplo: Customers (Clientes) o Orders (Órdenes), que son tablas transaccionales.

    • Share Data: (Datos Compartidos) Inserta los nuevos registros solo en el siguiente entorno. Por ejemplo: Email Templates (Plantillas de Correo Electrónico), que es una tabla que deseas que el usuario personalice los cambios.

  18. Datos del Desarrollador: Trunca la tabla en QA e inserta todos los registros del paquete. Esto se utiliza típicamente cada vez que se tienen tablas de búsqueda o tablas que son parte de una configuración. Por ejemplo: CustomerType, EmployeeType.

  19. La información se puede sobrescribir manualmente para Tipos de Propietario, y establecer para el paquete específico, o simplemente puedes hacer clic en Confirmar Config. Esto marca este proceso como completo y regresa a la pantalla del Constructor de Plantillas de Lanzamiento. Ten en cuenta que la mejor práctica de la metodología de Jitterbit es siempre establecer el valor de Opción de Instalación a nivel de tabla, que se mapea a Tipo de Propietario en la pantalla del Constructor de Plantillas de Lanzamiento. Las Opciones de Instalación son Datos de Usuario, Datos Compartidos y Datos del Desarrollador. Si los valores se establecen a nivel de tabla, estas configuraciones se transferirán al paquete de lanzamiento. Establecer esta información a nivel de tabla es útil para proyectos con múltiples miembros del equipo.

  20. El área de Configuración SQL te permite elegir la base de datos y ver si hay objetos (vistas o procedimientos almacenados) almacenados en la base de datos en la capa SQL nativa. Esto te permitirá mover vistas o procedimientos almacenados. Esta información no se llenará automáticamente en la pantalla de Código resultante, y necesitarás hacer clic manualmente en el botón Crear y agregarlos. Este paso se utiliza típicamente solo en situaciones avanzadas y no es un paso requerido.

  21. El paso de Construcción mostrará la versión para este lanzamiento, te permitirá agregar notas específicas para este lanzamiento y te dejará seleccionar una opción para tomar una instantánea antes de construir. Cuando estructures tus notas de lanzamiento, deberías usar un formato como el siguiente screenshot. Seguir un proceso consistente para nombrar tus notas de lanzamiento a lo largo del tiempo es importante, especialmente si tu proyecto es uno en el que hay múltiples personas trabajando en él. Esto se convierte en un registro continuo de las notas de lanzamiento de la aplicación.

  22. Haz clic en el botón Construir Paquete, que inicia un trabajo en segundo plano que construye el paquete. No hay notificación que te avise cuando el paquete está terminado y/o falla. Para verificar el estado del proceso, necesitas ir a App Builder IDE, Administrar Servidores y Programaciones y revisar el panel de Trabajos en Ejecución de Instancia.

  23. El botón Restablecer borrará toda la información asociada con la plantilla del paquete y te permitirá comenzar desde cero para la construcción de tu paquete.

  24. Haz clic en el ícono de Paquetes Packages, que te llevará a la pantalla de Lanzamientos de Soluciones, donde se encuentra el archivo LP descargable creado para el siguiente entorno. Este es el archivo que llevarás para instalar en el siguiente entorno. Desde esta pantalla, descarga el archivo del Paquete y guárdalo localmente en tu computadora.

  25. Con el archivo LP disponible, ve a tu siguiente entorno donde lo instalarás (QA o Prod). Desde allí, ve a Desplegar tu Aplicación desde el IDE de App Builder y haz clic en el botón Instalar Lanzamiento.

    Consejo

    Para ver el contenido del paquete antes de instalarlo, haz clic en el botón Manifiesto.

  26. Haz clic en el botón Crear y Examinar para localizar el archivo del Paquete y haz clic en Guardar. Al guardar, verás que el panel de Solución a la derecha muestra la información del paquete sobre Nombre, Versión, Desarrollador, Fecha de Lanzamiento, Descripción y Notas de Lanzamiento.

  27. Haz clic en el botón Instalar después de confirmar que este es el paquete que deseas instalar. Este proceso se ejecuta en primer plano. Si tiene éxito, recibirás un mensaje de éxito. Si falla, ve a Registros > Registros Rápidos del Servidor de Aplicaciones y verás información de error específica sobre por qué falló la instalación.

Programaciones y paquetes de lanzamiento

Las programaciones se incluirán en un Paquete de Lanzamiento (o LP) a menos que se eliminen manualmente al construir el Paquete. Por diseño, las programaciones que se han desplegado en un entorno de Producción están "selladas" o se les impide hacer ciertas ediciones a la información de la Programación. Esto evita que alguien haga cambios de desarrollo accidentalmente en un entorno posterior, lo que podría llevar a varios problemas al intentar desplegar la aplicación en el futuro. Las programaciones son parte de una aplicación, por lo que están "selladas" en estos entornos posteriores. Puedes activar o desactivar las programaciones o ajustar el tiempo, pero no puedes cambiar el tipo de ejecución de una Programación.

Hay algunos escenarios en los que podrías configurar un Horario en Desarrollo, pero una vez en Producción, el Horario de Desarrollo se desactiva. Por ejemplo, al interactuar con una API. Puede que solo desees interactuar con una API desde el entorno de Producción, así que una vez que el Desarrollo esté completo, puedes desactivar el Horario en el entorno de Desarrollo.

Una vez que se ha añadido un Horario a un LP, ten en cuenta que no todos los cambios en el Horario se enviarán en futuras Construcciones de un paquete. Si añades o eliminas Eventos asociados con un Horario, estos cambios se reflejarán en una nueva Construcción. Otros cambios en la definición de un Horario no se enviarán a futuras Construcciones.

Para realizar cambios en un Horario de Producción que está sellado, puedes crear un nuevo Horario que se incluirá en el próximo LP. Este proceso asegurará que el Horario se cree correctamente con cualquier nueva configuración reflejada en los entornos posteriores.