Árvore de páginas

Implementação da rotina JDQuote2 MF Pro 

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Varejo

Módulo:

Veículos (SIGAVEI)

Rotina:

Rotina

Nome Técnico

OFIPA950

Marcas
VEIVA020Modelos 
OFINJD21JDQuote2 – MF Pro

País(es):

Todos

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

VV1 – Cadastro de Veículos

VV2 – Modelos de Veículos

VE1 – Marcas

Sistema(s) Operacional(is):

Windows®/Linux®.

Descrição

Esta rotina foi criada para atender a integração disponibilizada pela John Deere denominada JDQuote2 / MF Pro Equipment Upload para o envio das informações de seus equipamentos do Protheus para a John Deere, visando facilitar o processo de cotação destas máquinas e atualizar o Machine Finder Pro (MF Pro), facilitando assim a venda do equipamento. O arquivo conterá as informações de máquinas John Deere novas e usadas, bem como máquinas usadas de outras marcas. O concessionário deverá enviar as informações diariamente (preferencialmente) e apenas enviar as informações dos equipamentos que ainda não foram transmitidas


Importante

Antes de executar o compatibilizador UPDVEIGK é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
  • 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:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.


Contate o Help Desk Framework EM CASO DE DÚVIDAS!


  1. Em TOTVS Smart Client, digite o U_UPDVEIGK no campo Programa Inicial
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado.
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. 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.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.


Atualizações do Compatibilizador

Criação de Campos no arquivo SX3 – Campos:

  • Tabela VV2 - Modelos de Veiculos:

Campo

VV2_MODEDI

Tipo

Caracter

Tamanho

30

Decimal

0

Formato

@!

Título

Modelo (EDI)

Descrição

Modelo (EDI)             

Nível

1

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Informe o codigo EDI do modelo.


Criação de Campos no arquivo SX3 – Campos:

  • Tabela VV1 - Cadastro de Veiculos:

Campo

VV1_TRANSM

Tipo

Caracter

Tamanho

1

Decimal

0

Formato

@!

Título

Transmitido?

Descrição

Transmitido?             

Nível

1

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

1=Sim;0=Nao      

When


Relação


Val. Sistema

PERTENCE("10")       

Help

Equipamento foi transmitido para
o JDQuote2?


Criação  de Campos no arquivo SX3 – Campos:

  • Tabela VE1 - Marcas:

Campo

VE1_MAREDI

Tipo

Caracter

Tamanho

3

Decimal

0

Formato

@!

Título

Marca (EDI) 

Descrição

Marca utilizada nos EDI  

Nível

1

Usado

Sim

Obrigatório

Não

Browse

Não

Opções


When


Relação


Val. Sistema


Help

Informe o codigo da marca a ser
utilizada nos arquivos EDI's.


Criação  de Campos no arquivo SX3 – Campos:

  • Tabela VVC - Cores de Veiculos:

Campo

VVC_COREDI

Tipo

 Caracter

Tamanho

Decimal

Formato

@! 

Título

Cor (EDI)    

Descrição

 Cor utilizada nos EDI    

Nível

 1

Usado

Sim 

Obrigatório

Não 

Browse

Não 

Opções


When


Relação


Val. Sistema


Help

 Informe a cor a ser utilizada nos

arquivos EDI's.


Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.


Procedimento para Configuração

CONFIGURAÇÃO DE MENUS

No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do Veículos (SIGAVEI), conforme instruções a seguir:

Menu

Atualizações

Submenu

Máquinas JD

Nome da Rotina

JDQuote2 - MF Pro

Programa

OFINJD21

Módulo

Veículos

Tipo

Função Protheus


CONFIGURAÇÃO DE PARÂMETROS

 No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

Itens/Pastas

Descrição

Nome:

 MV_MIL0005

Tipo:

Caracter

Cont. Por.:

201171

Descrição:

 Código do Concessionário no portal de Garantia    

Procedimento para Utilização

  1. No Veículos (SIGAVEI), acesse Atualizações\Cad Gerais\Marcas (OFIPA950).
  2. Posicione em um registro e selecione a opção Alterar.
  3. Verifique que o campo Marca (EDI) (VE1_MAREDI) foi criado. Este campo deve ser preenchido de acordo com o código do cadastro de marcas de equipamentos da John Deere.
  4. Confirme.
  5. Este procedimento deve se repetir para todas as marcas de equipamentos que deseja enviar para o JDQuote2.
  6. No Veículos (SIGAVEI), acesse Atualizações\Cad Veículos\Modelos (VEIVA020).
  7. Posicione em um registro e selecione a opção Alterar.
  8. Atente-se ao preenchimento do campo Categ Veic (VV2_CATVEI). A informação contida neste campo será utilizada para realizar filtros no momento da geração do arquivo a ser enviado para a John Deere.
  9. Confirme.
  10. No Veículos (SIGAVEI), acesse Atualizações\Máquinas JD\JDQuote2 – MF Pro (OFINJD21).
  11. A janela principal será exibida. Clique sobre o botão Param. (Para criação do pergunte abaixo (ONJD21), utilize a documentação do link a seguir [12750238 MMIL-7504 DT - Correção de Error.log ao acessar a rotina JDQuote2 - MF Pro (OFINJD21) - Linha Microsiga Protheus - TDN (totvs.com)] )
  12. A janela de parâmetros será exibida: 

    a. Diretório: pressione ENTER e escolha onde o arquivo será gerado.

    b. Nro Conta Principal: informe o código do concessionário (Dealer Number) principal junto a John Deere.

    c. Categoria/Tipo Maquinas: informe, entre barras, quais categorias ou tipo de máquinas deseja considerar para geração do arquivo. As categorias aqui serão consideradas a partir da rotina Modelos (VEIVA020), existente no campo Categ Veic (VV2_CATVEI). Os tipos aqui serão considerados a partir da rotina Modelos (VEIVA020), existente no campo Tipo Veículo (VV2_TIPVEI). Para determinar se será utilizado categoria ou tipo neste parâmetro, preencha o parâmetro Utiliza Categoria ou Tipo? desta mesma rotina.

    d. Categoria/Tipo Implementos: informe, entre barras, quais categorias ou tipo de implementos deseja considerar para geração do arquivo. As categorias aqui serão consideradas a partir da rotina Modelos (VEIVA020), existente no campo Categ Veic (VV2_CATVEI). Os tipos aqui serão considerados a partir da rotina Modelos (VEIVA020), existente no campo Tipo Veículo (VV2_TIPVEI). Para determinar se será utilizado categoria ou tipo neste parâmetro, preencha o parâmetro Utiliza Categoria ou Tipo? desta mesma rotina.

    e. Utiliza Categoria ou Tipo: Selecione se utiliza Categoria ou Tipo.

  13. Confirme o preenchimento dos parâmetros.
  14. Clique em OK para iniciar a geração.
  15. Ao término da geração, será gerado um arquivo com a extensão .JDQuote.
  16. Os equipamentos que foram considerados neste arquivo terão seu campo Transmitido? (VV1_TRANSM) atualizados para 1=Sim.

Os registros de cadastro de máquinas e implementos que serão considerados para compor o arquivo durante sua geração são aqueles que estão com o campo Transmitido? (VV1_TRANSM) preenchido com 0=Não ou em branco.