1. Identificação da Rotina
Nome da Rotina | Importação Glass |
|---|
| Programa | OFIA538 |
|---|
| Módulo ERP | Oficina (SIGAOFI) |
|---|
| Acesso à Rotina | Atualizações/Cadastros Oficina/Importação Glass (OFIA538) |
|---|
| Data da Documentação (Ultima Atualização) | |
|---|
2. Descrição Funcional
A rotina Importação GLASS (OFIA538) tem como finalidade facilitar a importação e atualização das peças enviadas pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo GLASS (Global Assortment), disponibilizado pela própria montadora no formato .DAT.
Esse arquivo contém informações sobre peças, peças substituídas e kits de peças.
Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios e opcionais na tela inicial de configuração, para garantir a consistência dos dados antes de prosseguir com o processamento do arquivo.
Após as validações, o sistema interpreta o conteúdo do arquivo GLASS e executa o processamento de inclusão ou atualização das peças, de acordo com as informações oficiais enviadas pela Scania.
Concluída a importação, o sistema executa as ações de pós processamento configuradas, que podem incluir, manter, mover ou apagar o arquivo, e gera logs detalhados com o resultado da operação.
Dessa forma, a rotina OFIA538 auxilia na organização e manutenção do cadastro de peças da Scania dentro do Protheus DMS, tornando o processo mais eficiente e parametrizável, garantindo que o cadastro de peças no Protheus se mantenha atualizado com as informações oficiais
disponibilizadas pela Scania. e substituindo a rotina OFIIA440, que possuía parâmetros fixos e menor desempenho em arquivos de grande volume.
3. Pré-requisitos e Configurações
Para o correto funcionamento da rotina Importação Glass (OFIA538), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo .DAT: - É necessário incluir manualmente a rotina Importação Glass (OFIA538) ao menu do Protheus, permitindo assim o acesso à funcionalidade.
- Deve-se possuir um arquivo com a extensão .DAT contendo as peças enviadas pela montadora Scania, que será utilizado como base para o processo de importação.
- Tamanho do arquivo .DAT:
- Quantidade de peças contidos no arquivo:
- Tempo de processamento do arquivo pela rotina:
|
Para que a importação de serviços ocorra corretamente durante o processamento do arquivo XML, é necessário que na rotina Grupos de Serviço (OFIOA020), existam registros cadastrados com o campo “Cod. Grp Mont” devidamente preenchido, conforme os códigos pré-definidos pela montadora Scania. Essa configuração garante o correto mapeamento entre os grupos de serviço da Scania e os grupos cadastrados no Protheus, permitindo que o sistema identifique e vincule corretamente os serviços durante o processo de importação.
|
|
Criação de Campo no arquivo SX3 – Campos:
- Tabela VOS - Grupos de Serviços
| Campo | VOS_GRPSER |
|---|
| Tipo | Caractere |
|---|
| Grupo de Campos |
|
|---|
| Ordem | 09 |
|---|
| Tamanho | 2 |
|---|
| Decimal | 0 |
|---|
| Formato | @! |
|---|
| Contexto | 1-Real |
|---|
| Propriedade | 1-Alterar |
|---|
| Título | Cod Grp Mont |
|---|
| Descrição | Cod Grp Servico Montadora |
|---|
| Val. Sistema | OA0200018_VldGrp() |
|---|
| Opções |
|
|---|
| Inic. Padrão |
|
|---|
| Inic. Browse |
|
|---|
| Cons. Padrão |
|
|---|
| Nível | 1 |
|---|
| Usado | Sim |
|---|
| Obrigatório | Não |
|---|
| Browse | Não |
|---|
| When |
|
|---|
| Pasta |
|
|---|
| Help | Grupo de servico da Montadora |
|---|
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu do módulo de Oficina (SIGAOFI) conforme instruções a seguir:
Menu | Atualizações |
|---|
Submenu | Cadastros Oficina |
|---|
Nome da Rotina | Importação Glass |
|---|
Programa | OFIA538 |
|---|
Módulo | Oficina (SIGAOFI) |
|---|
Tipo | Função Protheus |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | OFIA533 | OFIA533 | OFIA533 | OFIA533 | OFIA533 |
|---|
Ordem | 01 | 02 | 03 | 04 | 05 |
|---|
Pergunta | Marca ? | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para ? |
|---|
Tipo | C | C | N | C | C |
|---|
| Tamanho | 3 | 99 | 1 | 1 | 99 |
|---|
| Decimal | 0 | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 |
|---|
| Formato |
|
| @E 9 |
|
|
|---|
| Validação | ExistCpo("VE1",MV_PAR01) | OA533002K_ValidPerg() | !Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9) | NaoVazio() | OA533002K_ValidPerg() |
|---|
| Objeto | Get | Get | Get | Combo | Get |
|---|
| Consulta Padrão | VE1 |
|
|
|
|
|---|
| Pré-Seleção (Combo) |
|
|
| 1 |
|
|---|
| Item 1 |
|
|
| Nenhuma Ação |
|
|---|
| Item 2 |
|
|
| Mover Arquivo |
|
|---|
| Item 3 |
|
|
| Apagar Arquivo |
|
|---|
| Item 4 |
|
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|
|---|
| Help |
|
|
|
|
|
|---|
|
|
4. Fluxo de Utilização
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação Glass (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão
- Seleção de arquivo .DAT
- Ação pós Processamento
- No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
- No parâmetro Ação pós Processamento:
- Selecione a opção Nenhuma Ação. Com isso, o arquivo .DAT permanecerá no diretório original e sem ser movido ou apagado após seu processamento.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”. A rotina processará o arquivo .DAT e após a inclusão ou atualização de cada serviço serão executadas ações personalizadas definidas através do ponto de entrada. Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina.
|
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação Scania (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão
- Seleção do arquivo .DAT
- Ação pós Processamento
- No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
- No parâmetro Ação pós Processamento:
- Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório de destino dentro do servidor. Ao final do processamento, o arquivo será movido do diretório de origem para o diretório selecionado.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”. A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada. Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será movido do diretório original para o diretório destino indicado no parâmetro Mover Para.
|
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
- Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos
- Ação pós Processamento
- No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
- No parâmetro Ação pós Processamento:
- Selecione a opção Apagar Arquivo. Com isso, ao término do processamento do arquivo, ele será apagado do diretório de onde foi selecionado.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”. A rotina processará o arquivo XML e após a inclusão ou atualização de cada serviço serão executadas ações personalizadas definidas através do ponto de entrada. Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será apagado do diretório original onde foi selecionado.
|
Após a execução da rotina, será possível visualizar na tabela VQL (Informacoes genericas) os registros de log do processamento, conforme o exemplo apresentado na imagem abaixo. - Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
- Na coluna VQL_TIPO (Tipo), será registrado o local de execução da rotina, podendo ser via Menu ou Schedule;
- Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log referente ao status de execução da rotina (Início, Processamento, Finalização ou Erro).
|
|
5. Integrações e Dependências
Integração
Para o correto funcionamento da rotina, durante a execução da Importação de Serviços Scania (OFIA533) ocorre a integração com a rotina Tabela de Serviços (OFIOA030).
Após o processamento bem-sucedido do arquivo XML, os serviços contidos no arquivo são cadastrados na Tabela de Serviços caso ainda não existam, ou terão o campo "Tmpo Fábrica" (VO6_TEMFAB) atualizado, caso já estejam registrados.
Essa integração garante que os dados enviados pela montadora Scania sejam incorporados ao Protheus, mantendo o cadastro de serviços sempre atualizado e alinhado às informações da montadora.
6. Assuntos Relacionados