Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 11

changes.mady.by.user Usuário desconhecido (carla.vicente)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Usuário desconhecido (carla.vicente)

Gravado em

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

) (.DAT) fornecido pela montadora. Esse arquivo reúne informações de peças, substituições e kits.

Ao iniciar a rotina, o usuário deve Durante a execução da rotina, é necessário 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.

Após as validaçõesa 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çãoFinalizado o processamento, o sistema executa as ações de pós-processamento configuradas, que podem incluir,  definidas na configuração, como manter, mover ou apagar excluir o arquivo, e gera além de gerar logs detalhados com o resultado detalhamento da operação.

Dessa formaAssim, 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 e parametrizável, garantindo que o cadastro de peças no Protheus se mantenha atualizado com as informações oficiaisdisponibilizadas pela Scania. e substituindo a rotina OFIIA440, que possuía parâmetros fixos e menor desempenho em arquivos de grande volume, parametrizável e alinhado às informações oficiais da montadora.


...

3. Pré-requisitos e Configurações


Totvs custom tabs box
tabsPré-requisitos, Configurações, Atualização de Dicionário/Menu
idsaba1,aba2,aba3
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
  1. no menu do Protheus, permitindo assim o acesso à funcionalidade.
  2. Deve-se possuir um arquivo com a extensão .DAT
 aba1
  1. contendo as peças enviadas pela montadora Scania, que será utilizado como base para o processo de importação.
Totvs custom tabs box items


Bloco de código
themeRDark
titleExemplo arquivo DAT
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
defaultyes
referencia
 Nota
titleInformativo
  • Tamanho do arquivo .DAT: Aproximadamente 224 MB*.000 KB
  • Quantidade de peças contidos contidas no arquivo: Verificar Aproximadamente 1 270 588 peças*.
  • Tempo de processamento do arquivo pela rotina: Aproximadamente 15 min30 minutos*.

*Essas informações podem variar de acordo com o arquivo e a quantidade de filiais.
totvs-custom-tabs-box-items
 Totvs custom tabs box items
defaultno
referenciaaba2
defaultno
referenciaaba3
Criação de Campo no arquivo SX3 VE9 – Campos:
  • Tabela 
     VOS 
    VE9 - 
     Grupos 
    Substituição de 
     Serviços
    Itens

Campo
VOS_GRPSER
VE9_SEGMENVE9_STAGLAVE9_APLICAVE9_STATUS
TipoCaractere
Tipo
CaractereCaractereCaractere
Grupo de Campos



Ordem
09
16171819
Tamanho230352
Decimal0000
Formato@!@!@!@!
Contexto1-Real  1-Real  1-
Real
Real  1-Real  
Propriedade1-Alterar1-Alterar1-Alterar
TítuloCod Grp Mont
Descrição
1-Alterar
TítuloSegmento RegStatus GlassAplica ItemStatus
DescriçãoSegmento do registroDescrição Status GlassAplicação do ItemStatus
Cod Grp Servico Montadora
Val. Sistema
OA0200018_VldGrp(
Pertence("01/02/03/04/05/06")


Opções



Inic. Padrão



Inic. Browse



Cons. Padrão



Nível
1




UsadoSimSimSim
Usado
Sim
ObrigatórioNãoNão
Browse
NãoNão
Browse



When



Pasta



Help
Grupo de servico da Montadora
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 OficinaPeç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
OFIA533OFIA533OFIA533OFIA533
OFIA538OFIA538OFIA538OFIA538
Grupo de Campo
162003004024
OFIA533
Ordem
01020304
05
Pergunta
Marca ?Arquivo XML ?Quantidade Mecânicos ?Ação pós Processamento ?
Grupo Padrão Da PeçaConta Contábil Padrão PeçaCentro De Custo Padrão PeçaArmazém Padrão da Peça
Mover Para ?
Tipo
CCN
C
C
Tamanho
3
2
99
20
1
2
1
2
99
Decimal0000
0
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
MV_PAR05
Formato
Formato@E 9ValidaçãoExistCpo("VE1",MV_PAR01)OA533002K_ValidPerg()!Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)NaoVazio()




ValidaçãoOA538016J()OA538017J()OA538018J()OA538019J()
ObjetoGetGetGetGet
Consulta PadrãoSBMCT1CTTNNR
Pré-Seleção (Combo)0000 
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
OA533002KGet
_ValidPerg()
Objeto
Get
File
Get
ComboGet
Consulta Padrão
VE1



Pré-Seleção (Combo)00
1
0
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 Oficina → Cadastros Peças → Importação  Glass 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.
      
 Multimedia
nameImportação XML Nenhuma Ação.mp4
width1400
autostarttrue
height700
Image Added

 Totvs custom tabs box items
defaultno
referenciapasso2
  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Cadastros Peças → Importação  ScaniaGlass (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  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.
 Multimedia
nameImportação Arquivo XML Mover Arquivo.mp4
width1400
autostarttrue
height700

Image Added

 Totvs custom tabs box items
defaultno
referenciapasso3
  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Cadastros Peças → Importação  de Serviços ScaniaGlass (OFIA533OFIA538).
  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.
 Multimedia
nameImportação Arquivo XML Apagar Arquivo.mp4
width1400
autostarttrue
height700

Image Added
 Totvs custom tabs box items
defaultno
referenciapasso4
Após a execução da rotina, será possível visualizar na tabela VQL (Informacoes genericas) os registros de log do logs gerados pelo 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;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 RemovedImage Added

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

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