Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


...

ÍNDICE

  1. Visión general
  2. Implantación
  3. Wizard de configuración
  4. Schedule
  5. Log da integración
  6. Otras configuraciones
    1. Entes contables
    2. Monedas
    3. Campos personalizados - FlexFields

01.

...

VISIÓN GENERAL

Este documento presenta los pasos necesarios para activar la integración Protheus vs. de datos del Protheus con el Gesplan, a través por medio de la plataforma Carol.

Al adquirir la oferta, internamente se iniciara iniciará el flujo de aprovisionamiento.

Después de finalizar Se finalizó el flujo de aprovisionamiento, el cliente recibe por e-mail las credenciales del RAC (client_id y e client_secret) necesarias para ejecutar el Wizard de configuración en el Protheus.

Image Removed

Image Added

Será necesaria la actualización del Es necesario actualizar el entorno siguiendo la el orden descrita descrito en los siguientes tópicos.


02. IMPLANTACIÓN

Para iniciar la implementación de la integración, es será necesario:

1) Verificar los requisitos mínimos:

Todos los  artefactos  (DbAccess a partir de la versión 21.1.1.4, APPServer y Lib ) deben estar actualizados con la última versión disponible en el portal.

Release Protheus a partir de la 12.1.

...

10


2)

...

Aplicar la última expedición continua del Protheus,

...

junto con el diferencial de diccionario

...

por medio del UPDDISTR, de acuerdo con su versión de la Release.

 

3) Active Activar parámetros en la configuraciónel configurador:

MV_FINTGES - Informe Informar el contenido true = .T. 

MV_PRJOVER - Informe Informar el contenido true = .T. 

Aviso

Solamente active el parámetro MV_FINTGES en la implantación de la integración. El uso del parámetro activado sin la ejecución del Wizard de configuración, puede podrá causar falla fallas en los procesos del sistema.


4)  Verifique Verificar el contenido del parámetro MV_FINFIX. Para que la integración esté preparada y apta para ejecutarsesu ejecución, el contenido debe ser 21tener como mínimo 25

https://tdn.totvs.com.br/pages/releaseview.action?pageId=562490773

IMPORTANTE: Si el contenido del parámetro

...

mencionado anteriormente fuera inferior a

...

25, este NO debe modificarse manualmente. En este caso

...

, se recomienda abrir un ticket en Atención, adjuntando los archivos

...

error.log y

...

console.log para análisis.

 

5

...

) Para visualizar mejor los motivos por los cuales no se hicieron efectivos los asientos contables, utilice el parámetro MV_CT105MS con contenido igual a "S" .

 

6) Ejecutar el wizard de acuerdo con los pasos listados en el

...

próximo tópico.

 

7) Tener liberación del servidor donde el schedule del Protheus se ejecuta para los siguientes end-points:

https://endpoint-registry.totvs.app/api/v1/services
https://admin.rac.totvs.app/totvs.rac/connect/token
https://provisioning.totvs.app/api/carol-definitions/v1/entities
https://ingestion-smartlink.totvs.app
https://app.carol.ai
https://provisioning.totvs.app/api/carol-definitions/v1/carolcredentials
https://link.totvs.app
https://api-smartlink.totvs.app


03. WIZARD DE CONFIGURACIÓN

Deck of Cards
historyfalse
idpruebateste
Card
labelPaso 1

Para iniciar el Wizard de configuración, el usuario debe informar el programa inicial: WIZARDTF1

Card
labelPaso 2

Haga clic en avanzar

Card
labelPaso 3

Informe un usuario con poder de administrador y marque las empresas que se configurarán. Haga clic en avanzarAvanzar.

Card
labelPaso 4

Seleccione el producto Gesplan

Card
labelPaso 5

Confirme el usuario y contraseña para ejecutar el ejecución del UPDDISTR. 

Se crearán los campos EV_MSUID y EZ_MSUID del tipo uniqueidentifier.

Card
labelPaso 6

Informe las credenciales del RAC recibidos recibidas por e-mail

Card
labelPaso 7

En este último paso se crearán los campos de control de modificación (S_T_A_M_P_) en todas las tablas de integración.


...

04. SCHEDULE

Después de ejecutar el la ejecución del Wizard, el job FWTECHFINJOB de integración con Carol se registrará automáticamente en el Protheus.

Si la integración tiene tuviera envío de datos por parte de la Gesplan al Protheus, esto ocurrirá a través por medio de la configuración del job FWTOTVSLINKJOB, que se debe incluir incluirse manualmente en el schedule. Crear con los mismos detalles del FwTechFinJob creado automáticamente.

Será Es necesario finalizar las configuraciones del schedule de ambos jobs e iniciar el servicio.

Informações
titleRecurrencia de ejecución

Para que no haya delay en el envío de los datos para a Carol, la Recerrencia Recurrencia del job se puede registrar podrá registrarse como 'Siempre activo'; sin embargo, no hay una un regla referente cuanto al registro de la recurrencia de la ejecución, la decisión con relación cuando a esto depende de la necesidad de disponibilidad de estos datos, a partir del momento en que estos se generande la generación de estos
Cuanto mayor
es la recurrencia dee y empresas/sucursales listadas para ejecución, mayor es la necesidad de recursos para procesamiento de los jobs.

Aviso

Incluya Incluir la configuración solamente únicamente en el entorno que esté en producción.

Bases de pruebas que estén configuradas con el Smartlink interceptarán mensajes enviados enviadas por la Gesplan , de la misma manera forma que la base de producción, esto hará haciendo que los datos se graben en la base de pruebas , y actualizará actualizando el estatus para de la Gesplan como integrado. 

Integración Gesplan - Movimiento bancario enviado del Gesplan al Protheus

Schedule - Como agendar la ejecución a execução de rutinasrotinas

05. LOG DE LA INTEGRACIÓN

Con el schedule en ejecución, el job FWTECHFINJOB pasa a enviar envía los registros a las staging tables de Carol. Todo cambio efectuado Cualquier modificación realizada en cualquier registro en el ERP automáticamente actualiza el timestamp, en el campo S_T_A_M_P_, de esta manera, el job vuelve a enviar reenvía el registro completo para actualizar la staging table.

Se pueden Es posible activar los logs del job, para evaluar lo que se está ejecutando e y enviando, para esto ello, basta seguir los procedimientos descritos en el siguiente enlace.

https://tdn.totvs.com/display/public/framework/TechFin+Debug

Aviso

Se recomienda activar el Log solamente log únicamente cuando sea necesario hacer necesaria alguna evaluación, porque mantener el Log accedido puede perjudicar log conectado podrá afectar el desempeño, además de crear muchos archivos en el rootpath del entorno.


06. OTRAS CONFIGURACIONES

a) Entes contables 

Se utilizan utilizarán los entes indicados en el registro del origen de la Modalidad del título por Pagar/Cobrar, en los siguientes campos:

  • ED_DEBITO - Cuenta contable para cartera por pagarPagar
  • ED_CREDITO - Cuenta contable para cartera por cobrarCobrar
  • ED_CCD - Centro de costo para cartera por pagarPagar
  • ED_CCC - Centro de costo para cartera por cobrarCobrar

Acceder al Configurador Acceda a la Configuración / Base de datos y marque los marcar campos como Usado Utilizado:

Image RemovedImage Added

b) Monedas

La descripción de la moneda del título , utilizará el Reagistro de monedas (CTBA140) del módulo Contabilidad de Gestión, en Actualizaciones→Registros→Monedas Contables y de los movimientos tiene como origen el contenido del SX6, registro de Parámetros del configurador. 

¿Utilizará el contenido del parámetro MV_MOEDA?

Donde "?" (interrogación) representa el código de la moneda.

Ejemplo:

Título de la moneda 1 = contenido informado en el parámetro MV_MOEDA1

Título de la moneda 5 = contenido informado en el parámetro MV_MOEDA5


c) Campos personalizados - Flex Fields

Documentación sobre campos personalizados:  Integración Gesplan - Datos enviados y Pipelines 


d) Parámetros opcionales

Después de configurar como True, define que los títulos del Protheus que estén en situación de cartera descontada tendrán los valores previstos con el saldo en cero en el entorno Gesplan y se considerarán como realizados.

Si se configura como False, el valor previsto de los títulos se mantendrá con el saldo restante de este en el Protheus, campo Saldo del título (E1_SALDO).

Cuando el parámetro no esté configurado, el estándar será False.

 

En el entorno Carol, el parámetro se accede por medio de la rutina 'Settings'

El parámetro puede modificarse por medio de la opción en la columna Value, alternando el valor entre True y False, y para grabar, basta hacer clic en 'Save'.

Image Added

Referencias