Skip to main content

Veritran Docs

Workspace Promotion

Dentro de la plataforma Workspace, el módulo Workspace Promotion le permite administrar y ejecutar la promoción de tus proyectos con todos sus elementos desde un entorno de origen hasta un entorno de destino. Dichos elementos incluyen la configuración del proyecto de promoción, los parámetros comerciales, las transacciones de la institución, los códigos de respuesta de transacción y las asignaciones de respuesta del host.

En Workspace Promotion, también puedes acceder a la lista de promociones y reversiones que ya se ejecutaron.

Prerrequisitos

Debes cumplir ciertos requisitos para trabajar en Workspace Promotion. Para promover un proyecto, debe tener:

  • al menos dos ambientes: un ambiente de desarrollo y un ambiente de control de calidad o un ambiente de producción;

  • acceso a Middleware desde cada ambiente;

  • los mismos productos y tipos de configuración en todos los ambientes;

  • permisos para promocionar proyectos y revertir promociones de proyectos en cada ambiente otorgado en Workspace Accounts & Environments.

Acceder a Workspace Promotion

Para acceder a Workspace Promotion, debes registrarte en Workspace y tener los permisos necesarios para acceder a promoción para un cliente y un ambiente específicos.

Sugerencia

Los permisos para acceder a Workspace Promotion se otorgan desde Workspace Accounts & Environments.

Además, debes tener permisos para usar el Middleware del cliente y para acceder a los ambientes en los que trabajarás.

Para acceder a Workspace Promotion, ingrese la URL del cliente en el navegador. A continuación, introduce tus credenciales (nombre de usuario o correo electrónico y contraseña) y haz clic en Sign in. La página principal se abre en la página Applications. Consulta la imagen comentada a continuación para obtener más información.

Importante

Si se te redirige a Workspace Promotion desde la plataforma de Workspace, no es necesario que vuelvas a introducir tus credenciales.

PROMOTION_HOME.png
  1. Componentes de la plataforma. Haz clic en el icono de cuadrícula para expandir un menú donde puedes ver los productos disponibles para tu cliente dentro de la plataforma Veritran. Para cambiar el cliente, haz clic en la flecha y selecciona un cliente de la lista desplegable Choose client situada en la parte superior del menú. Para cambiar el producto Veritran, haga clic en un producto y luego haga clic en el entorno deseado. Serás redirigido al sitio de ese producto sin necesidad de iniciar sesión nuevamente. Haz clic de nuevo en el icono de cuadrícula para contraer el menú. También puedes hacer clic en la flecha situada en la parte inferior de este menú para expandirla o contraerla.

    Nota

    Solo los usuarios partner y superadmin tienen la opción de cambiar el cliente en la lista desplegable.

  2. Obtener ayuda. Obtener ayuda. Haz clic aquí para abrir Veritran Docs y obtener más información sobre Workspace y todos los demás productos disponibles en la plataforma de Veritran.

  3. Configuración del usuario. Haz clic para acceder a la configuración de usuario, donde puedes elegir cualquiera de las siguientes opciones: Manage sessions, Change password o Logout. Obtenga más información sobre las opciones en la siguiente tabla.

    Manage sessions

    Haga clic para ver las sesiones activas de su usuario. La página incluye una lista de dispositivos que han iniciado sesión en su cuenta de usuario, con su nombre de usuario y contraseña. Puede revocar cualquier sesión que no reconozca.

    Para revocar una sesión, haga clic en Revocar. Aparece un modal que le informa que revocar la sesión deshabilita el acceso del usuario a todos los productos asociados. Hacer clic Revocar de nuevo para confirmar. Para revocar todas las sesiones, haga clic en revocar todas las demás sesiones. Aparece un modal que le informa que revocar las sesiones deshabilita el acceso del usuario a todos los productos asociados. Hacer clic Revocar de nuevo para confirmar.

    Si no hay sesiones activas, aparece el mensaje No Active Sessions en la pantalla.

    Change password

    Haga clic para cambiar su contraseña. Debe ingresar su contraseña actual y una nueva. Las contraseñas deben tener al menos 9 caracteres y e incluir, como mínimo, un dígito, un carácter en minúsculas y un carácter en mayúsculas.

    Logout

    Haz clic aquí para cerrar sesión. Se te redirige a la página de inicio de sesión.

  4. Menú principal. Haz clic en cualquiera de las secciones para ir a la página correspondiente. De forma predeterminada, la promoción del espacio de trabajo se abre en el Promociones página.

En la página de Promociones, puede ver la lista de promociones de proyectos con su estado. También puede solicitar nuevas promociones y ver el detalle de las ejecutadas anteriormente. Consulta la imagen comentada a continuación para obtener más información.

PROMOTIONS_PAGE.png
  1. Barras de búsqueda y filtro de estado. Para encontrar una promoción, haga clic en cualquiera de las barras de búsqueda y escriba la fuente ambiente name, el nombre del entorno de destino o el usuario que solicita la promoción, según corresponda. Para reducir la lista de promociones por estado, haga clic en la flecha del filtro Estado y seleccione una opción del menú desplegable. Los estados disponibles son: Éxito, En curso, Fallido, Muerto. Para borrar sus filtros y ver la lista completa de promociones, haga clic en Limpiar todo.

  2. Promote project Haga clic para iniciar una nueva promoción.

  3. Lista de promociones. Consulta la tabla a continuación para obtener más información.

    Source environment

    Ambiente desde el cual se obtienen la configuración del proyecto promocionado, los parámetros o los códigos de transacción.

    Target environment

    Ambiente al cual se promocionan la configuración del proyecto seleccionado, los parámetros o los códigos de transacción.

    Product

    Producto promocionado.

    Type

    Tipo de configuración promocionada.

    Created at

    Fecha y hora en que se solicitó la promoción.

    Requested by

    Usuario que lanzó la promoción.

    Status

    Estado actual de la promoción. Consulte la siguiente tabla para obtener más información sobre cada estado disponible.

    Success

    Indica que la promoción se ejecutó correctamente en segundo plano (etiqueta verde).

    On going

    Indica que la promoción se está ejecutando. Indica que la promoción está en ejecución. Este estado solo aparece desde el momento en que se solicita la promoción hasta que se obtienen los resultados finales (etiqueta azul).

    Failed

    Indica que la promoción no se pudo ejecutar con éxito debido a un error inesperado (etiqueta de color rojo). Una promoción puede fallar, por ejemplo, si el producto o la configuración no existe en el entorno de destino.

    Dead

    Indica que, después de un tiempo determinado, el proceso de promoción finalizó abruptamente (etiqueta roja).

    Nota

    El tiempo máximo para que el estado de una promoción pase de En curso a Éxito o Fallido son dos horas. Después de ese período, el estado será Muerto.

    Rollbackable

    Estado que indica si la promoción se puede revertir o no. Si la promoción se puede revertir, este campo contiene un ícono de verificación de color verde y si no se puede revertir, este campo está vacío.

    Sugerencia

    La acción Revertir solo está disponible si el estado de la promoción es Éxito. Para cualquier otro estado, la única acción disponible es Ver detalles.

    Más opciones

    Haga clic en el icono de tres puntos verticales y luego haga clic en cualquiera de las opciones disponibles. Consulta la tabla a continuación para obtener más información.

    View details

    Haz click para ver los detalles de la promoción. Se le redirige a la página de detalles de la promoción, donde puede ver la información básica sobre la promoción y los detalles de la promoción con respecto a la configuración de lanzamiento, los parámetros comerciales, las transacciones de la institución, los códigos de respuesta de la transacción y las asignaciones de respuesta del host. Referirse a Ver detalles de la promoción para obtener más información sobre la información que se muestra en esta página.

    Rollback

    Haga clic para revertir la promoción. Aparece un modal que le informa que continuar con el Retroceder La acción revierte el proyecto a su versión publicada anterior. Para continuar, haga clic en Confirmar.

Ver detalles de la promoción

Para ver los detalles de la promoción, navega por la lista de promociones para buscar la que desees y haz clic en los tres puntos verticales situados a la derecha y luego haz clic en View details.

Se abre la página de detalles de la promoción, donde puede ver la información básica sobre la promoción y los detalles de cada elemento del proyecto promovido, incluida su configuración de lanzamiento, parámetros comerciales, transacciones de la institución y códigos de respuesta de la transacción. Cada uno de estos elementos también muestra una etiqueta de estado y, si la promoción no tuvo éxito, un detalle del error que provocó la detención del proceso.

Consulta las subsecciones a continuación para conocer más sobre la información que aparece en esta página.

Nota

La información que aparece en la página de detalles de la promoción se obtiene deMiddleware, en función del ambiente y del producto seleccionado en la sección Basic Info.

En esta sección se pueden ver los principales detalles de la promoción del proyecto. Incluye información sobre la descripción de la promoción, el usuario que la solicita, los entornos de origen y destino, el tipo de configuración y el producto de que se trata. También puede ver el detalle del estado de la promoción, las horas de inicio y finalización, y el tiempo transcurrido desde que se solicitó la promoción hasta que se obtuvo el resultado final, si la ejecución de la promoción aún está en proceso o fue exitosa. o falló.

En esta sección puede ver el identificador y los parámetros de configuración inteligente. Consulta la tabla a continuación para obtener más información.

Identifier

Identificador asignado a la versión de la configuración en Middleware.

Previous smart release

Valor de la última configuración del despliegue inteligente antes de que se ejecute la promoción.

Smart configuration target

Valor actual de la configuración del despliegue inteligente después de que se ejecutó la promoción.

Si no hay información sobre la configuración de un despliegue, en esta sección encontrarás el mensaje No release configuration has been promoted.

Los parámetros de negocio son conjuntos de configuraciones que se pueden usar en los endpoints de servicios en el proceso de construcción de una app en Studio o en el flujo de una transacción.

En esta sección, puedes ver el estado de la promoción de los parámetros de negocio y su información básica. Consulta la tabla a continuación para obtener más información. Consulta la tabla a continuación para obtener más información.

Code

Código del parámetro.

Description

Descripción usada para identificar el parámetro.

Value

Valor del parámetro.

Updated at

Fecha y hora en que se actualizó el parámetro por última vez.

Updated by

Usuario que actualizó por última vez el parámetro de negocio.

Si no hay información sobre los parámetros de negocio, en esta sección encontrarás el mensaje No business parameters have been promoted.

Lee Parámetros de negocio para obtener más información sobre este tema.

Las transacciones de la institución se asocian a una institución financiera específica, lo que significa que esta cuenta con autorización para llevar a cabo la transacción.

En esta sección se puede ver el estado de la promoción de transacciones de la institución y su información básica. Consulta la tabla a continuación para obtener más información.

Institution

Institución autorizada para ejecutar la transacción.

Transaction

Nombre de la transacción y descripción.

Status

Estado de la transacción.

Updated at

Fecha y hora en que se actualizó la transacción de la institución por última vez antes de la promoción.

Updated by

Usuario que actualizó la transacción de la institución por última vez.

Si no hay información sobre las transacciones de la institución, en esta sección encontrarás el mensaje institution transactions have been promoted.

Los códigos de respuesta se configuran para identificar la respuesta del flujo de la transacción y establecer un mensaje que el usuario de la app verá después de dicha respuesta.

En esta sección, puede ver el estado de la promoción de códigos de respuesta de transacciones y su información básica. Consulta la tabla a continuación para obtener más información.

Code

Código de respuesta de una transacción.

Technical description

Breve descripción para identificar el código de respuesta.

Updated at

Fecha y hora en que se actualizó el código de respuesta de la transacción por última vez antes de la promoción.

Updated by

Usuario que actualizó el código de respuesta de la transacción por última vez.

Si no hay información sobre los códigos de respuesta de la transacción, en esta sección encontrarás el mensaje No transaction response codes have been promoted.

Lee Códigos de respuesta de transacción para obtener más información sobre este tema.

Los mapeos de respuesta del host son los códigos de respuesta que se han identificado.

En esta sección, puede ver el estado de la promoción de asignaciones de respuesta del host y su información básica. Consulta la tabla a continuación para obtener más información.

Process

Tipo de proceso de Middleware.

Trx. code

Código y paso de la transacción.

Trx. description

Descripción con la que se identifica la transacción.

Host res. code

Identificador de la respuesta del host.

Response

Código de respuesta de la transacción y descripción.

Updated at

Fecha y hora en que se actualizó el mapeo del código de respuesta por última vez antes de la promoción.

Updated by

Usuario que actualizó el mapeo del código de respuesta por última vez.

Si no hay información sobre los mapeos de la respuesta del host, en esta sección encontrarás el mensaje No host response mappings have been promoted.

Lee Response Code Mappings para obtener más información sobre este tema.

Promocionar un proyecto

Para promocionar un proyecto, dirígete a la página Promotions y haz clic en + Promote Project.

Para promocionar un proyecto de Workspace Accounts & Environments, dirígete a la página Environments, navega por la lista de ambientes para encontrar aquel con el que deseas trabajar y haz clic en Promote project.

En ambos casos, se te redirige a la página Promote project, donde puedes definir la información básica y la configuración de la promoción. Consulta las secciones a continuación para obtener más información. Consulta las secciones a continuación para obtener más información.

Importante

Si comienzas la promoción de un proyecto desde la página Environments, el campo Source environment en la sección Basic Info aparece completado con el ambiente desde el que comenzaste la promoción.

Basic Info

En esta sección, completa la configuración básica de la promoción del proyecto. Todos los campos son obligatorios excepto el campo Descripción. Consulta la tabla a continuación para obtener más información.

Source environment

Haz clic en la flecha y selecciona un ambiente del menú desplegable. Solo después de completar este campo, podrá configurar los campos Producto, Tipo de configuración y Entorno de destino.

Product

Haz clic en la flecha y selecciona un producto del menú desplegable.

Configuration type

Haz clic en la flecha y selecciona un tipo de configuración del menú desplegable.

Target environment

Haz clic en la flecha y selecciona un ambiente del menú desplegable.

Promotion description

Introduzca una breve descripción de la promoción. Este campo es opcional.

Una vez que completes todos los campos obligatorios, haz clic en Save. Luego, debe completar el Configuración sección.

Setup

En la sección Configuración, determina si desea promover la configuración del proyecto, los parámetros comerciales, las transacciones y las respuestas. Consulta la imagen comentada a continuación para obtener más información.

PROMOTE_PROJECT.png
  1. Liberación inteligente de configuración. Configuración a promocionar e ID asignado a la configuración en Veritran Studio. Para poder promocionar una configuración, el parámetro de liberación inteligente debe actualizarse previamente en Studio. Esto significa que solo se pueden promocionar las versiones más recientes de la configuración y no es posible promocionar la misma versión de la última configuración publicada o una anterior.

    Si no se actualiza el valor de un parámetro, aparece un mensaje que dice Smart release parameter should be updated to promote configuration debajo de la casilla Configuration Smart Release.

    Para actualizar el parámetro de liberación inteligente, vaya a Estudio Veritran. Luego ve a Parámetros (Global > Parámetros), busque el parámetro SMART_CONFIGURATION_RELEASE y aumente su valor. Por último, vaya a la lista de aplicaciones (Global > Mis aplicaciones) y publique una aplicación con la misma combinación de configuración: producto y tipo de configuración. Volver a Promoción, e iniciar el proceso de promoción. Ahora podrá promocionar la configuración, dado que el valor de configuración de la versión inteligente es mayor que el valor de la última configuración publicada.

    Si no necesita promocionar la configuración, anule la selección de la casilla de verificación Promover. En tal caso, solo se promoverán los parámetros comerciales, las transacciones, los códigos de respuesta y las asignaciones.

    Nota

    El botón Start promotion solo estará habilitado (en azul) si se actualiza la configuración o si no se selecciona su casilla Promote.

  2. Business Parameters Business Parameters. Parámetros de negocio configurados para el producto y el ambiente seleccionados en la sección Basic Info.

  3. Transacciones y respuestas. Transactions and responses. Transacciones de la institución, códigos de respuesta y mapeos de respuesta del host que se configuraron para el producto y el ambiente seleccionados en la sección Basic Info.

  4. Promover. Checkbox para determinar si la promoción incluye la Configuración, los Parámetros de Negocio y las Transacciones y Respuestas, respectivamente. De forma predeterminada, se hace clic en las tres casillas de verificación. Si no desea promocionar uno de estos elementos, desmarque la casilla de verificación correspondiente. Aparece un modal que le informa que no promocionar el elemento seleccionado puede hacer que la promoción falle si hay dependencias que lo requieran. Para continuar, haga clic en Confirmar.

  5. Ver y editar parámetros comerciales. Haga clic para ver los detalles de los parámetros comerciales de ese producto. Se abre un modal que contiene la lista de parámetros y su información básica. Para eliminar un parámetro de los parámetros que se promocionarán, desmarque la casilla de verificación a la izquierda del código del parámetro. Si quitas cualquiera de las transacciones o respuestas de la promoción, la casilla Promote tendrá un guión en lugar de una marca de verificación.

    Para encontrar un parámetro, haga clic en la barra de búsqueda y escriba su código, descripción o valor. Para guardar los cambios y regresar a la sección Setup, haz clic en Done.

    Para realizar cambios en la configuración de los parámetros de negocio en Middleware, haz clic en Edit Business Parameters.

  6. Ver y editar transacciones y respuestas. Haga clic para ver los detalles de las transacciones de la institución, los códigos de respuesta y las asignaciones de respuesta del host de ese producto. Se abre un modal que contiene las transacciones de la institución y las pestañas Códigos de respuesta y asignaciones. La pestaña Transacciones de la institución se abre por defecto y contiene la lista de transacciones de la institución con su información básica. Para eliminar una transacción de las transacciones que se promocionarán, desmarque la casilla de verificación a la izquierda del nombre de la institución de la transacción. Para encontrar una transacción, haga clic en la barra de búsqueda y escriba el nombre o la descripción de su institución. Para realizar cambios en la configuración de las transacciones en Middleware, haga clic en Editar transacciones institucionales.

    Haga clic en Códigos de respuesta y asignaciones para cambiar de pestaña. La pestaña Códigos de respuesta y asignaciones contiene la lista de códigos de respuesta y asignaciones, con su información básica. Para eliminar un código de respuesta o un mapeo de los elementos a promocionar, desmarque la casilla de verificación ubicada a la izquierda del código de respuesta o el código del mapeo.

    Si quitas cualquiera de las transacciones o respuestas de la promoción, la casilla Promote tendrá un guión en lugar de una marca de verificación.

    Para encontrar un código de respuesta o una asignación, haga clic en la barra de búsqueda y escriba su código o descripción. Para realizar cambios en la configuración de las transacciones en Middleware, haga clic en Editar códigos de respuesta o Editar asignaciones, respectivamente.

    Para guardar los cambios y regresar a la sección Setup, haz clic en Done.

Importante

Para ejecutar una promoción completa, todas las casillas de promoción deben estar marcadas. Una promoción completa del proyecto incluye la promoción de la configuración del proyecto, los parámetros comerciales, las transacciones de la institución, los códigos de respuesta de las transacciones y las asignaciones de respuesta del host.

Para realizar más cambios en el Información básica sección, haga clic en Anterior. Si no necesita realizar ningún cambio adicional, haga clic en Iniciar promoción para solicitar la ejecución de la promoción. Se abre un modal que le informa el cliente para el que se solicita la promoción del proyecto y los entornos de origen y destino involucrados. Para continuar, haga clic en Promover. A continuación, se le redirigirá a la página Promociones. Se abre un modal que le informa que la promoción se solicitó con éxito.

La nueva promoción aparecerá listada, y su estado inicial será En curso. Después de un breve período de tiempo, el estado cambiará a Éxito, Fallido o Muerto. Para ver los detalles de la promoción ejecutada, haga clic en el icono de tres puntos verticales a la derecha y luego haga clic en Ver detalles. Leer Promociones aprender más.

Revertir una promoción

Para revertir una promoción, vaya a la Promociones página. Para ver los detalles de la promoción, navega por la lista de promociones para buscar la que desees y haz clic en los tres puntos verticales situados a la derecha y luego haz clic en View details. Se abre una ventana modal que le informa que continuar con la reversión revierte el proyecto a su versión publicada anterior. Para continuar, haga clic en Confirmar.

Nota

La acción Rollback solo está disponible si la promoción seleccionada se llevó a cabo correctamente, lo que significa que puede revertirse.

A continuación, se le redirigirá a la Reversiones Se abre una página y se abre un modal que le informa que la reversión se solicitó con éxito. La reversión aparecerá en la lista y su estado inicial será En curso.

Después de un cierto período de tiempo (máx. dos horas), el estado cambiará a Éxito, Fallido o Muerto. Para ver los detalles de la promoción, haga clic en el icono de tres puntos verticales a la derecha y luego haga clic en Ver detalles. Leer Promociones aprender más.