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. 

...

VISÃO GERAL

Este documento presenta los pasos necesarios para activar la integración Protheus vs. Gesplan, a través de la Esse documento apresenta os passos necessários para ativação da integração de dados do Protheus para o Gesplan, através da plataforma Carol.

Al Ao adquirir la a oferta internamente se iniciara el flujo de aprovisionamiento., internamente será iniciado o fluxo de provisionamento.

Finalizado o fluxo de provisionamento, o cliente recebe Después de finalizar el flujo de aprovisionamiento, el cliente recibe por e-mail las credenciales del as credenciais do RAC (client_id y e client_secret) necesarias necessárias para ejecutar el executar o Wizard de configuración en el configuração no Protheus.

Image Removed

Image Added

Será necessária a atualização do ambiente seguindo a ordem descrita nos tópicos abaixoEs necesario actualizar el entorno siguiendo la orden descrita en los siguientes tópicos.


02.

...

IMPLANTAÇÃO

Para iniciar la implementación de la integración, es necesarioa implementação da integração será necessário:

1) Verificar os requisitos mínimos:

Todos os artefatos (DbAccess, APPServer e Lib ) deverão estar atualizados com a última versão disponível no 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

...

da 12.1.

...

2310


2)

...

Aplicar a última

...

expedição continua

...

do Protheus, juntamente

...

com o diferencial de

...

dicionário através do UPDDISTR, de

...

acordo com a sua versão da Release.


3) Active parámetros en la configuraciónAtivar parâmetros no configurador:

MV_FINTGES - Informe el contenido Informar conteúdo true = .T. 

MV_PRJOVER - Informe el contenido Informar conteúdo true = .T. 

Aviso

Solamente active el parámetro Somente ative o 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 causar falla en los procesos del na implantação da integração. O uso do parâmetro ativado sem a execução do Wizard de configuração, poderá causar falhar nos processos do sistema.


4) Verifique el contenido del parámetro Verificar o conteúdo do parâmetro MV_FINFIX. Para que la integración esté preparada y a integração esteja preparada e apta para ejecutarse, el contenido debe ser, como mínimo, 21ser executada, o conteúdo deve ser no mínimo 25

IMPORTANTE:

...

Caso o conteúdo do parâmetro citado acima seja inferior a 25 o mesmo NÃO deve ser alterado manualmente. Neste caso a orientação é abertura de um ticket no atendimento, anexando os arquivos error.log e console.log para análise.


5) Para melhor visualizar

...

os motivos de não efetivação de lançamentos contábeis, utilizar o parâmetro MV_CT105MS com conteúdo igual a "S" .


6)

...

Executar o wizard de

...

acordo com os passos listados no próximo tópico.


7) Ter liberação do servidor onde o schedule do Protheus é executado para os seguintes 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 CONFIGURAÇÃO

...

Deck of Cards
historyfalse
idpruebateste
Card
labelPaso Passo 1

Para iniciar el o Wizard de configuración, el usuario debe informar el configuração, o usuário deverá informar o programa inicial: WIZARDTF1

Card
labelPaso Passo 2

Haga clic en avanzarClicar em Avançar

Card
labelPaso Passo 3

Informe un usuario con Informar um usuário com poder de administrador y marque las e marcar as empresas que se configurarán. Haga clic en avanzarserão configuradas. Clicar em Avançar.

Card
labelPaso Passo 4

Seleccione el producto Selecionar o produto Gesplan

Card
labelPaso Passo 5

Confirme el usuario y contraseña para ejecutar el Confirmar usuário e senha para execução do UPDDISTR. 

Se crearán los Serão criados os campos EV_MSUID y e EZ_MSUID del do tipo uniqueidentifier.

Card
labelPaso Passo 6

Informe las credenciales del RAC recibidos Informar credenciais do RAC recebidos por e-mail

Card
labelPaso Passo 7

En este último paso se crearán los Nesse último passo serão criados os campos de control controle de modificación alteração (S_T_A_M_P_) en em todas las tablas as tabelas de integraciónintegração.


...

04. SCHEDULE

Después de ejecutar el Após execução do Wizard, el o job FWTECHFINJOB de integración con Carol se registrará automáticamente en el Protheus.

Si la integración tiene envío de datos por parte de la Gesplan, esto ocurrirá a través del job FWTOTVSLINKJOB, que se debe incluir manualmente en el schedule.

integração com a Carol será cadastrado automaticamente no Protheus.

Se a integração possuir envio de dados por parte da Gesplan para o Protheus, o mesmo ocorrerá através da configuração do job FWTOTVSLINKJOB, que deverá ser incluído manualmente no schedule. Criar com os mesmos detalhes do FwTechFinJob criado automaticamente.

Será necessário finalizar as configurações do schedule de ambos os jobs e iniciar o serviçoEs necesario finalizar las configuraciones del schedule de ambos jobs e iniciar el servicio.

Informações
titleRecurrencia Recorrência de ejecuciónexecução

Para que no haya delay en el envío de los datos para Carol la Recurrencia del job se puede registrar como 'Siempre activo'; sin embargo, no hay una regla referente al registro de la recurrencia de la ejecución, la decisión con relación a esto depende de la necesidad de disponibilidad de estos datos, a partir del momento en que estos se generan. 
Cuanto mayor es la recurrencia dee empresas/sucursales listadas para ejecución, mayor es la necesidad de recursos para procesamiento de los jobs.não haja delay no envio dos dados para a Carol  a Recorrência do job poderá ser cadastrada como 'Sempre ativo'; entretanto, não há uma regra quanto ao cadastro da recorrência da execução, a decisão quanto a isso depende da necessidade de disponibilidade desses dados, a partir do momento de geração deles. 
Quanto maior a recorrência e empresas/filiais listadas para execução, maior a necessidade de recursos para processamento dos jobs.

Aviso

Inserir a configuração somente no ambiente que estiver em produção.

Bases de testes que estejam configuradas com o Smartlink interceptarão mensagens enviadas pela Gesplan da mesma forma que a base de produção, fazendo com que os dados sejam gravados na base de testes atualizando o status para a

Aviso

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

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

Integración Integração Gesplan - Movimiento bancarioMovimento Bancário enviado do Gesplan para o Protheus

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

05. LOG

...

DA INTEGRAÇÃO

Com o schedule em execução, o job FWTECHFINJOB passa a enviar os registros para as staging tables da Carol. Toda alteração efetuada em qualquer registro no ERP automaticamente atualiza o timestamp, no

...

Con el schedule en ejecución, el job FWTECHFINJOB pasa a enviar los registros a las staging tables de Carol. Todo cambio efectuado 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 el dessa forma o job reenvia o registro completo para actualizar la atualizar a staging table.

Se pueden activar los logs del É possível ativar os logs do job, para evaluar lo que se está ejecutando e enviando, para esto basta seguir los procedimientos descritos en el siguiente enlaceavaliação do que esta sendo executado e enviado, para isso basta seguir os procedimentos descritos no link abaixo.

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

Aviso

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

06. OTRAS CONFIGURACIONES

a) Entes contables 

É recomendado ativar o log somente quando for necessária alguma avaliação, pois manter o log ligado poderá onerar a performance, além de criar muitos arquivos no rootpath do ambiente.


06. DEMAIS CONFIGURAÇÕES

a) Entidades contábeis 

Serão utilizadas as entidades indicadas no cadastro da Natureza do título a Pagar/Receber, nos campos a seguirSe utilizan los entes indicados en el registro del origen del título por Pagar/Cobrar, en los siguientes campos:

  • ED_DEBITO - Cuenta contable para cartera por pagarConta contábil para careira Pagar
  • ED_CREDITO - Cuenta contable para cartera por cobrarConta contábil para careira Receber
  • ED_CCD - Centro de costo para cartera por pagarcusto para carteira Pagar
  • ED_CCC - Centro de costo para cartera por cobrarcusto para carteira Receber

Acessar Configurador Acceda a la Configuración / Base de datos y marque los Dados e marcar campos como Usado:

Image RemovedImage Added

b)

...

Moedas

A descrição da moeda do título e dos movimentos tem como origem o conteúdo do SX6, cadastro de Parâmetros do Configurador. 

Irá utilizar o conteúdo do parâmetro

La descripción de la moneda del título y de los movimientos tiene como origen el contenido del SX6, registro de Parámetros del Configurador. 

¿Se utilizará el contenido del parámetro MV_MOEDA?.

Dónde Onde "?" (interrogacióninterrogação) representa el código de la monedao código da moeda.

EjEx.:

Título de la moneda da moeda 1 = contenido informado en el parámetro conteúdo informado no parâmetro MV_MOEDA1

Título de la moneda da moeda 5 = contenido informado en el parámetro conteúdo informado no parâmetro MV_MOEDA5


c)

...

 Campos customizados - Flex Fields

Documentación Documentação sobre campos personalizadoscustomizados: Integración Integração Gesplan - Datos Dados enviados y e Pipelines 


d)

...

Parâmetros opcionais

Parámetro Parâmetro : Zera_Descontada 

Después de configurar Uma vez configurado como True, se define que los os títulos del do 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 estejam em situação de carteira descontada terão os valores previstos com o saldo zerado no ambiente Gesplan e serão considerados como realizados.

Si se configura Se configurado como False, el o valor previsto de los títulos se mantendrá con el saldo restante de este en el dos títulos será mantido com o saldo restante do mesmo no Protheus, campo Saldo del do Título (E1_SALDO).

Cuando el parámetro no esté configurado, el estándar es Quando o parâmetro não estiver configurado, o padrão é False.

En el entorno Carol, el parámetro se accede por 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'.

...


No ambiente Carol, o parâmetro é acessado pela rotina 'Settings'

O parâmetro pode ser alterado pelo botão na coluna Value, alternando o valor entre True e False e para salvar, basta clicar em 'Save'.

Image Added

Referências