Implementação da rotina JDQuote2 MF Pro
Características do Requisito
Linha de Produto: | Microsiga Protheus | ||||||||
Segmento: | Varejo | ||||||||
Módulo: | Veículos (SIGAVEI) | ||||||||
Rotina: |
| ||||||||
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:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em TOTVS Smart Client, digite o U_UPDVEIGK no campo Programa Inicial.
- 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.
- 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.
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 |
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 |
Criação de Campos no arquivo SX3 – Campos:
- Tabela VVC - Cores de Veiculos:
Campo | VVC_COREDI |
Tipo | Caracter |
Tamanho | 5 |
Decimal | 0 |
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
- No Veículos (SIGAVEI), acesse Atualizações\Cad Gerais\Marcas (OFIPA950).
- Posicione em um registro e selecione a opção Alterar.
- 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.
- Confirme.
- Este procedimento deve se repetir para todas as marcas de equipamentos que deseja enviar para o JDQuote2.
- No Veículos (SIGAVEI), acesse Atualizações\Cad Veículos\Modelos (VEIVA020).
- Posicione em um registro e selecione a opção Alterar.
- 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.
- Confirme.
- No Veículos (SIGAVEI), acesse Atualizações\Máquinas JD\JDQuote2 – MF Pro (OFINJD21).
- 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)] )
- 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.
- Confirme o preenchimento dos parâmetros.
- Clique em OK para iniciar a geração.
- Ao término da geração, será gerado um arquivo com a extensão .JDQuote.
- 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.