====== API Legacy: Application Legacy PB ======
En las aplicaciones Powerbuilder se ha implementado parte de la lógica de integración en el core ya que la version 12.5 de PB que es la que se utiliza carece de soporte API Rest.

===== Consideraciones Previas =====
Para poder utilizar el api-legacy y consumir los microfrontend se deben ejecutar los siguientes scripts en todos los clientes:

<code sql>
ALTER TABLE CONTABIL01.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE PRESUP01.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE TESORE01.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE COMPRAS01.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE TALENTO.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE NOMINA.PARAMETROS_SISTEMA
ADD (CONNECT_DB VARCHAR2(64 Byte));

ALTER TABLE PRESUP01.MODULOS ADD (MICROFRONTEND_URL VARCHAR2(1024 Byte));

COMMENT ON COLUMN 
PRESUP01.MODULOS.MICROFRONTEND_URL IS 
'URL de lanzamiento de la GUI Microfrontend';

ALTER TABLE PRESUP01.MODULOS ADD (ID_OPTION VARCHAR2(16 Byte));

COMMENT ON COLUMN PRESUP01.MODULOS.ID_OPTION IS 'Identificador de ruta de opción del frontend';
</code>
//Los script están definidos en el repositorio.//

==== Configurar Cliente ====

=== Crear ContextClient ===
En las tablas **PARAMETROS_SISTEMA** se ha definido una nueva propiedad llamada **CONNECT_DB** la cual representa el ContextClient de conexion del api-legacy.

Para llenar esa propiedad se deben serguir los siguiente pasos: El **ContextClient** se divide en 3 fragmentos los cuales son **context**, **client** y **separador**:

  * **Client**: Es el identificador del cliente. Ejemplo: ada, bello, viva, valor+, unillanos, etc.
  * **Context**: Es el ambiente del origen de datos del cliente en el cual se ejecutará el api legacy, los microfrontend y lso servicios de las soluciones migradas. Ejemplo: dev-> desarrollo, qa->calidad, prod->producción
  * **Separador**: Es un caracter de separación para identificar el context y el client por defecto se define el separador -

Ejemplos de ContextClient:

  * bello-dev
  * viva-dev
  * ada-dev
  * bello-qa
  * bello-prod
  * unillanos-qa

Nota: El **contextClient** siempre debe expresarse en minusculas.

==== Configurar Funcionalidad Migrada ====
Una vez ha sido migrada la funcionalidad se deben hacer la siguientes configuraciónes.

==== Configurar URL del microfrontend ====
En la tabla PRESUP01.MODULOS se ha definido una nueva columna llamada MICROFRONTEND_URL la cual debe contener la url del despliegue del microfrontend.

Ejemplo Url Microfronted: http://10.1.140.21:8092

NOTA: Esta información la debe suministrar el rol que realiza el despliegue.

==== Configurar IdOption del microfrontend ====
En la tabla PRESUP01.MODULOS se ha definido una nueva columna llamada ID_OPTION la cual debe contener el path del microfrontend.

Ejemplo IdOption Microfronted: maestros/terceros

NOTA: Esta información la debe proveer el frontend.


===== Consideraciones =====

  * Los nuevos cmapos son requeridos para el consumo correcto del microfrontend.
  * Para el desarrollador powerbuilder es indiferente la funcionalidad y no impacta en sus procesos de desarrollo.
  * El url del microfrontend se desplegará en el navegador por defecto sin embargo tendrá prioridad el navegador Edge si está activo. Está situación es generada por window y no se puede modificar a menos que se inactive ese navegador.

[[ada:howto:sicoferp:factory:new-migracion-sicoferp:apilegacy|←Regresar]]