Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Índice
minLevel0
include[Identificação da Rotina]
indent10px


...

1. Identificação da Rotina


Nome da Rotina

Importação Glass
ProgramaOFIA538
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Cadastros Peças/Importação Glass (OFIA538)
Data da Documentação (
Ultima
Última Atualização)
13

11

 


...

2. Descrição Funcional

A rotina Importação GLASS (OFIA538) tem como finalidade facilitar objetivo simplificar a importação e atualização das peças enviadas pela montadora Scania para o sistema Protheus DMS, a partir de um do arquivo GLASS (Global Assortment) (.DAT) disponibilizado fornecido pela própria montadora no formato .DAT.
Esse arquivo contém reúne informações sobre de peças, peças substituídas substituições e kits de peças.Durante

Ao iniciar a execução da rotina, é necessário o usuário deve preencher os parâmetros obrigatórios e opcionais na tela inicial de configuração para garantir , que orientam o comportamento do processo e garantem a consistência dos dados antes de prosseguir com o processamento da leitura 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 Após a validação dos parâmetros, o sistema interpreta o conteúdo do arquivo GLASS e executa o processamento de realiza a inclusão ou atualização das peças de acordo com conforme as informações oficiais enviadas pela da Scania.Concluída a importação

Finalizado o processamento, o sistema executa as ações de pós-processamento configuradas  definidas na tela de parâmetros, que podem incluir, configuração, como manter, mover ou apagar excluir o arquivo, e além de gerar logs detalhados com o resultado detalhamento da operação.Dessa forma

Assim, a rotina OFIA538 auxilia na Importação GLASS (OFIA538) contribui para a organização e manutenção do cadastro de peças da Scania dentro do no 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, parametrizável e alinhado às informações oficiais da montadora.


...

3. Pré-requisitos e Configurações


Totvs custom tabs box
tabsPré-requisitos, Atualização de Dicionário/Menu
idsaba1,aba3aba2
Totvs custom tabs box items
defaultyes
referenciaaba1

Para o correto funcionamento da rotina Importação Glass (OFIA538), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo .DAT:

  1. É necessário incluir manualmente a rotina Importação Glass (OFIA538)
ao note

Criação de Campo no arquivo VE9 – Campos:

  • Tabela VE9 - Substituição de Itens

  • 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:

Criação de Pergunte no arquivo SX1 – Pergunta

  1. no menu do Protheus, permitindo assim o acesso à funcionalidade.
  2. 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.


Bloco de código
Tamanho do
themeRDark
title
Informativo
Exemplo 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.

    Totvs custom tabs box items
    defaultyes
    referenciaaba1
    Totvs custom tabs box items
    defaultno
    referenciaaba3
    CampoVE9_SEGMENVE9_STAGLAVE9_APLICAVE9_STATUS
    TipoCaractereCaractereCaractereGrupo de Campos
    Ordem16171819
    Tamanho230352
    Decimal0000
    Formato@!@!@!@!
    Contexto1-Real  1-Real  1-Real  1-Real  
    Propriedade1-Alterar1-Alterar1-Alterar1-Alterar
    Segmento RegStatus GlassAplica ItemStatus
    DescriçãoSegmento do registroDescrição Status GlassAplicação do ItemStatus
    Val. SistemaPertence("01/02/03/04/05/06")OpçõesInic. PadrãoInic. BrowseCons. PadrãoNível
    UsadoSimSimSimSim
    ObrigatórioNãoNãoNãoNão
    BrowseWhenPasta
    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.

    Menu

    Atualizações

    Submenu

    Cadastros Peças

    Nome da Rotina

    Importação Glass

    Programa

    OFIA538

    Módulo

    Oficina (SIGAOFI)

    Tipo

    Função Protheus

    Grupo

    OFIA538OFIA538OFIA538OFIA538

    Grupo de Campo

    162003004024

    Ordem

    01020304

    Pergunta

    Grupo Padrão Da PeçaConta Contábil Padrão PeçaCentro De Custo Padrão PeçaArmazém Padrão da Peça

    Tipo

    CCNC
    Tamanho22022
    Decimal0000
    Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
    Formato
    ValidaçãoOA538016J()OA538017J()OA538018J()OA538019J()
    ObjetoGetGetGetGet
    Consulta PadrãoSBMCT1CTTNNR
    Pré-Seleção (Combo)000
    Item 1Item 2Item 3Item 4Item 5
    Help

    .OFIIA47001.

    .OFIIA47002..OFIIA47003..OFIIA47004.

    Grupo

    OFIA538OFIA538OFIA538

    Grupo de Campo

    Ordem

    050607

    Pergunta

    Arquivo .DATAção Após o ProcessamentoMover Para

    Tipo

    CC

    C

    Tamanho99150
    Decimal000
    Var01MV_PAR05MV_PAR06MV_PAR07
    FormatoValidaçãoOA538022J_ValidPerg()
    ObjetoFileComboGet
    Consulta Padrão
    Pré-Seleção (Combo)000
    Item 1Nenhuma AçãoItem 2Mover ArquivoItem 3Apagar ArquivoItem 4Item 5
    Help

    .OFIIA47005.

    .OFIIA47006..OFIIA47007.

    4. Fluxo de Utilização

    ...

    tabsPasso a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivo, Gravação de Logs
    idspasso1,passo2,passo3,passo4

    ...

    defaultyes
    referenciapasso1

    ...

    • Grupo Padrão da Peça
    • Armazém Padrão da Peça
    • Arquivo .DAT 
    • Ação 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.Image Removed

         

    ...

    defaultno
    referenciapasso2
    1. Acesse o Módulo 14 (Oficina).
    2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
    3. 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
    4. 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.
    5. 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.
    6. 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.

    Image Removed

    ...

    defaultno
    referenciapasso3
    1. Acesse o Módulo 14 (Oficina).
    2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
    3. 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
    4. 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.
    5. 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.
    6. 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.

    Image Removed

    ...

    defaultno
    referenciapasso4

    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).

    Image Removed

    010000001PECA TESTE                    TESTE          ITEM SUBSTITUIDO              ARTICULO REEMPLAZADO          REPLACED ITEM                   000010000001N0000560PECA TESTE                         99
    0400000013170991   0000001                                                                                                                        99
    010001200TESTE - TESTE TESTE           TESTE          ITEM DESATIVADO               ARTICULO DESATIVADO           DEACTIVED ITEM                  109400000001I0001530TESTE - TESTE TESTE                99
    0400012000811288   0000001                                                                                                                        99
    010001400TESTE-TESTE TESTE             TESTE          ITEM SUBSTITUIDO              ARTICULO REEMPLAZADO          REPLACED ITEM                   109400000001I0000500TESTE TESTE - TESTE                99
    020001400TESTE                                                                                                                                    99
    020001400LK140                                                                                                                                    99
    0400014000811285   0000001                                                                                                                        99
    010001683PECA TESTE                    TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    199100000001I0004030TESTE                              99
    020001683TESTE.T                                                                                                                                  99
    010001719TESTE                         TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUEDD                   019990000001I0000000TESTE                              99
    020001719TESTE.T                                                                                                                                  99
    010001721TESTE(TESTE)                  TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    019660000001I0000000TESTE(TESTE)                       99
    020001721TESTE.T                                                                                                                                  99
    010001722TESTE                         TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    199010000001N0000000TESTE TESTE                        99
    Nota
    titleInformativo
    • Tamanho do arquivo .DAT: Aproximadamente 224 MB*.
    • Quantidade de peças contidas 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.

    Totvs custom tabs box items
    defaultno
    referenciaaba2

    Criação de Campo no arquivo VE9 – Campos:

    • Tabela VE9 - Substituição de Itens


    CampoVE9_SEGMENVE9_STAGLAVE9_APLICAVE9_STATUS
    TipoCaractereCaractereCaractereCaractere
    Grupo de Campos



    Ordem16171819
    Tamanho230352
    Decimal0000
    Formato@!@!@!@!
    Contexto1-Real  1-Real  1-Real  1-Real  
    Propriedade1-Alterar1-Alterar1-Alterar1-Alterar
    TítuloSegmento RegStatus GlassAplica ItemStatus
    DescriçãoSegmento do registroDescrição Status GlassAplicação do ItemStatus
    Val. SistemaPertence("01/02/03/04/05/06")


    Opções



    Inic. Padrão



    Inic. Browse



    Cons. Padrão




    Nível



    UsadoSimSimSimSim
    ObrigatórioNãoNãoNãoNã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 Observação da Substituiçã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

    OFIA538OFIA538OFIA538OFIA538

    Grupo de Campo

    162003004024

    Ordem

    01020304

    Pergunta

    Grupo Padrão Da PeçaConta Contábil Padrão PeçaCentro De Custo Padrão PeçaArmazém Padrão da Peça

    Tipo

    CCNC
    Tamanho22022
    Decimal0000
    Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
    Formato



    ValidaçãoOA538016J()OA538017J()OA538018J()OA538019J()
    ObjetoGetGetGetGet
    Consulta PadrãoSBMCT1CTTNNR
    Pré-Seleção (Combo)000
    Item 1



    Item 2



    Item 3



    Item 4



    Item 5



    Help



    Grupo

    OFIA538OFIA538OFIA538

    Grupo de Campo




    Ordem

    050607

    Pergunta

    Arquivo .DATAção Após o ProcessamentoMover Para

    Tipo

    CC

    C

    Tamanho99150
    Decimal000
    Var01MV_PAR05MV_PAR06MV_PAR07
    Formato


    Validação

    OA538022J_ValidPerg()
    ObjetoFileComboGet
    Consulta Padrão


    Pré-Seleção (Combo)000
    Item 1
    Nenhuma Ação
    Item 2
    Mover Arquivo
    Item 3
    Apagar Arquivo
    Item 4


    Item 5


    Help





    ...

    4. Fluxo de Utilização


    Totvs custom tabs box
    tabsPasso a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivo, Gravação de Logs
    idspasso1,passo2,passo3,passo4
    Totvs custom tabs box items
    defaultyes
    referenciapasso1
    1. Acesse o Módulo 14 (Oficina).
    2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
    3. 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
    4. 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.
    5. 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 originalsem ser movido ou apagado após o processamento.
    6. 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.

    Image Added


    Totvs custom tabs box items
    defaultno
    referenciapasso2
    1. Acesse o Módulo 14 (Oficina).
    2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
    3. 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
    4. 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.
    5. 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.
    6. 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.


    Image Added


    Totvs custom tabs box items
    defaultno
    referenciapasso3
    1. Acesse o Módulo 14 (Oficina).
    2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
    3. 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
    4. 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.
    5. 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.
    6. 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.


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciapasso4

    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).


    Image Added


    ...

    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 (MATA010), Peças Substituídas (OFIPA910) e Kits (OFIPA920).


    Principais campos importados após o processamento do arquivo DAT
    Cadastro de PeçasSubstituição de ItensCadastro de Kits
    Tabela SB1(Segmento 01)Tabela SB5Tabela SBZTabela VE9Tabela VEH(Cabeçalho)Tabela VE8(Itens do Kit)
    B1_DATCADB5_CODBZ_CODTodos SegmentosSegmento 01Segmento 02Segmento 04Segmento 06Segmento 06
    B1_CODB5_CEMEBZ_LOCPADVE9_FILIALVE9_STAGLAVE9_APLICAVE9_ITENOVVE9_ITENOVVEH_FILIALVE8_FILIAL
    B1_GRUPOB5_UMIND
    VE9_SEGMENVE9_ITENOVVE9_ITENOVVE9_QTDADEVE9_QTDADEVEH_TIPO  VE8_TIPO  
    B1_CODITE

    VE9_NROSEQ

    VE9_DATSUB
    VEH_GRUKITVE8_GRUKIT
    B1_FABRIC

    VE9_NROSUB

    VE9_QTDSUB
    VEH_CODKITVE8_CODKIT
    B1_DESC

    VE9_GRUITE

    VE9_STATUS
    VEH_DESKITVE8_GRUITE
    B1_UM

    VE9_GRUNOV



    VEH_VALKITVE8_CODITE
    B1_SEGUM

    VE9_ITEANT




    VE8_QTDADE
    B1_TIPO








    B1_LOCPAD








    B1_CONTA








    B1_CC









    ...

    6. Assuntos Relacionados

    HTML
    <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>

    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

    html