Integração Cotação Índices Bolsa de Referencia com API Externa.
Características do Requisito
Linha de Produto: | Microsiga Protheus. | ||||||||
Segmento: | Gestão Agroindústria. | ||||||||
Módulo: | SIGAAGR | ||||||||
Rotina: |
| ||||||||
Cadastros Iniciais: | Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito. | ||||||||
Parâmetro(s): | MV_AGRO200, MV_AGRO201, MV_AGRO202, MV_AGRO203, MV_AGRO204 | ||||||||
Requisito/Story/Issue (informe o requisito relacionado): | DAGROGAP-4838 | ||||||||
País(es): | Todos. | ||||||||
Banco(s) de Dados: | Todos. | ||||||||
Tabelas Utilizadas: | N8C, N8U, NK0, NK1, SM2, NJ7 | ||||||||
Sistema(s) Operacional(is): | Todos | ||||||||
Pacote: | Informe o [linkdopacote] |
Descrição
Este documento técnico tem por objetivo contemplar as melhorias implementadas para a integração de cotação de índices de mercado com a API externa utilizando o cadastro de índices de commodity da rotina de bolsa de referencia.
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente! A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Procedimento para Utilização
Para a correta integração com a API externa é necessário realizar a configuração dos parâmetros no configurador.
1. No Configurado (SIGACFG), acesse Ambiente/ Cadastros/ Parâmetros
1.1. Configure os seguintes parâmetros: MV_AGRO200, MV_AGRO201, MV_AGRO202
OBS: os dados para preenchimento destes parâmetros deverão ser solicitados para o Parceiro de integração.
2. No Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Básicos/ Precificação/ Bolsa de Referência
2.1 Para incluir uma bolsa de referência, basta clicar em "Incluir".
2.2. Informe os dados conforme orientação do help de campo e observe o preenchimento dos campos:
- No campo "URL Integra" informar a URL valida de integração com a API externa.
- Na grid "Índices de Commodity", necessário informar no campo "Cod Futuro" o código de índice valido para integração com a API externa(Verificar com o Parceiro de integração)
3. Para realizar a atualização dos índices de Commodity da bolsa, selecione um registro de bolsa de referência e clique em Outras Ações/Atualizar Índices Bolsa
O sistema irá realizar a integração com a API Externa, irá buscar as cotações dos Índices da bolsa de referencia selecionada.
Os Índices retornados pela API Externa serão cadastrados automaticamente no sistema caso não existam na tabela NK0(Índices de Mercado), referenciando a bolsa de referencia e conforme os dados cadastrados no Índice de commoditie da bolsa de referencia. Para consultar os índices no Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Básicos/ Precificação/ Índices de Mercado
Os Índices retornados pela API Externa e já cadastrados na tabela NK0(Índices de Mercado), também serão cadastrados ou atualizados na tabela NK1(Cotação de Índice). Para consultar os cotações dos índices no Gestão Agroindústria (SIGAAGR), acesse Atualizações / Originação / Cadastros Básicos/ Precificação/ Cotação de Índice
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|