1. Identificação da Rotina
Nome da Rotina | Importação Glass |
|---|
| Programa | OFIA538 |
|---|
| Módulo ERP | Oficina (SIGAOFI) |
|---|
| Acesso à Rotina | Atualizações/Cadastros Peças/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.
Esses parâmetros definem o comportamento da rotina e influenciam diretamente como os dados serão importados e tratados durante a execução.
Após as validações dos parâmetros, 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 na tela de parâmetros, que podem incluir, manter, mover ou apagar o arquivo, e gerar 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 com melhor desempenho e parametrizável, garantindo que o cadastro de peças no Protheus se mantenha atualizado com as informações oficiais disponibilizadas pela Scania.
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: Aproximadamente 224 MB*.
- Quantidade de peças contidos no arquivo: Aproximadamente 1 270 588 peças*.
- Tempo de processamento do arquivo pela rotina: Aproximadamente 30 minutos*.
*Essas informações podem variar de acordo com o arquivo e a quantidade de filiais. |
Criação de Campo no arquivo VE9 – Campos:
| Campo | VE9_SEGMEN | VE9_STAGLA | VE9_APLICA | VE9_STATUS |
|---|
| Tipo | Caractere | Caractere | Caractere | Caractere |
|---|
| Grupo de Campos |
|
|
|
|
|---|
| Ordem | 16 | 17 | 18 | 19 |
|---|
| Tamanho | 2 | 30 | 35 | 2 |
|---|
| Decimal | 0 | 0 | 0 | 0 |
|---|
| Formato | @! | @! | @! | @! |
|---|
| Contexto | 1-Real | 1-Real | 1-Real | 1-Real |
|---|
| Propriedade | 1-Alterar | 1-Alterar | 1-Alterar | 1-Alterar |
|---|
| Segmento Reg | Status Glass | Aplica Item | Status |
|---|
| Descrição | Segmento do registro | Descrição Status Glass | Aplicação do Item | Status |
|---|
| Val. Sistema | Pertence("01/02/03/04/05/06") |
|
|
|
|---|
| Opções |
|
|
|
|
|---|
| Inic. Padrão |
|
|
|
|
|---|
| Inic. Browse |
|
|
|
|
|---|
| Cons. Padrão |
| |
|
|
|---|
| Nível |
|
|
|
|
|---|
| Usado | Sim | Sim | Sim | Sim |
|---|
| Obrigatório | Não | Não | Não | Não |
|---|
| Browse |
|
|
|
|
|---|
| When |
|
|
|
|
|---|
| Pasta |
|
|
|
|
|---|
| Help | Campo utilizado para indicar o tipo de informação vinculada ao item, permitindo ao sistema classificar e tratar corretamente o registro. Opções: 01 Informação Básica do Item 02 Informação Utilização do Item 03 Observação do Item 04 Informação Substituição do Item 05 Observacao da Substituilção do Item 06 Informação Composição do Kit | Indica a descrição do status do item importado do arquivo Glass, exclusivo da montadora Scania. | Informa os dados de utilização do item, exclusivos da montadora Scania. | Indica o status do item importado do arquivo Glass, exclusivo da montadora Scania. |
|---|
- 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 Peças |
|---|
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 | OFIA538 | OFIA538 | OFIA538 | OFIA538 |
|---|
Grupo de Campo | 162 | 003 | 004 | 024 |
|---|
Ordem | 01 | 02 | 03 | 04 |
|---|
Pergunta | Grupo Padrão Da Peça | Conta Contábil Padrão Peça | Centro De Custo Padrão Peça | Armazém Padrão da Peça |
|---|
Tipo | C | C | N | C |
|---|
| Tamanho | 2 | 20 | 2 | 2 |
|---|
| Decimal | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
|---|
| Formato |
|
|
|
|
|---|
| Validação | OA538016J() | OA538017J() | OA538018J() | OA538019J() |
|---|
| Objeto | Get | Get | Get | Get |
|---|
| Consulta Padrão | SBM | CT1 | CTT | NNR |
|---|
| Pré-Seleção (Combo) | 0 | 0 | 0 | 0 |
|---|
| Item 1 |
|
| |
|
|---|
| Item 2 |
|
|
|
|
|---|
| Item 3 |
|
|
|
|
|---|
| Item 4 |
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|---|
| Help | .OFIIA47001. | .OFIIA47002. | .OFIIA47003. | .OFIIA47004. |
|---|
Grupo | OFIA538 | OFIA538 | OFIA538 |
|---|
Grupo de Campo |
|
|
|
|---|
Ordem | 05 | 06 | 07 |
|---|
Pergunta | Arquivo .DAT | Ação Após o Processamento | Mover Para |
|---|
Tipo | C | C | |
|---|
| Tamanho | 99 | 1 | 50 |
|---|
| Decimal | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR05 | MV_PAR06 | MV_PAR07 |
|---|
| Formato |
|
|
|
|---|
| Validação |
|
| OA538022J_ValidPerg() |
|---|
| Objeto | File | Combo | Get |
|---|
| Consulta Padrão |
|
|
|
|---|
| Pré-Seleção (Combo) | 0 | 0 | 0 |
|---|
| Item 1 |
| Nenhuma Ação |
|
|---|
| Item 2 |
| Mover Arquivo |
|
|---|
| Item 3 |
| Apagar Arquivo |
|
|---|
| Item 4 |
|
|
|
|---|
| Item 5 |
|
|
|
|---|
| Help | .OFIIA47005. | .OFIIA47006. | .OFIIA47007. |
|---|
|
|
4. Fluxo de Utilização
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o 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 Após o Processamento:
- Selecione a opção Nenhuma Ação. Com isso, o arquivo .DAT permanecerá no diretório original sem ser movido ou apagado após o 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 das peças serão executadas ações personalizadas definidas através do ponto de entrada. Ao final do processamento, serão executadas ações personalizadas definidas através dos pontos de entrada de conclusão da rotina.
|
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o 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 Após o Processamento:
- Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório destino no 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, 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 Peças → Importação Glass (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o 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 Apagar Arquivo. Com isso, ao término do processamento, o arquivo será apagado do diretório onde foi 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, 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 os registros de logs gerados pelo processamento, conforme o exemplo na imagem abaixo. - Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
- Na coluna VQL_TIPO (Tipo), será registrado o status da ação após o processamento, se houve sucesso, erro e também o início da ação.
- 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ções
Ao final da execução, as peças importadas pela rotina Importação Glass (OFIA538) estarão disponíveis nas rotinas de Cadastro de Peças, Peças Substituídas e KITS.
6. Assuntos Relacionados
<style>
.link_container {
display: flex;
flex-direction: column;
align-items: flex-start; /* Alinhado à esquerda */
width: 100%;
gap: 8px; /* Espaçamento entre os itens */
}
.btn-doc,
.btn-doc:link,
.btn-doc:visited {
display: inline-block;
padding: 12px 24px;
font-size: 16px;
font-weight: 600;
color: #FFFFFF !important; /* Força o texto branco */
background-color: #08244C; /* Fundo azul escuro */
border: none;
border-radius: 8px;
text-decoration: none;
text-align: left;
transition: background-color 0.3s ease, transform 0.2s ease, color 0.3s ease;
}
.btn-doc:hover {
background-color: #FFFFFF; /* Azul mais claro no hover */
color: #08244C !important; /* Mantém texto branco */
transform: scale(1.03);
}
.btn-doc:active {
background-color: #061B3B; /* Azul ainda mais escuro no clique */
color: #FFFFFF !important; /* Mantém texto branco */
transform: scale(0.98);
}
</style>
<div class="link_container">
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014654380" target="_blank" class="btn-doc">
📄 Ponto de Entrada OF538PRO - Importação Glass (OFIA538)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014655032" target="_blank" class="btn-doc">
📄 Ponto de Entrada OF538FIM - Importação Glass (OFIA538)
</a>
</div> |