Árvore de páginas

Versões comparadas

Chave

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

...

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 de Serviços Scania (OFIA533), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo XML, o mapeamento dos grupos de serviço e o correto tratamento dos dados entre a Scania e o Protheus DMS. São elas:

  1. O campo “Cod. Grp Mont” deve estar adicionado na rotina Grupos de Serviço (OFIOA020), garantindo o vínculo correto entre os grupos de serviço da montadora Scania e os grupos cadastrados no Protheus.
  2. É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  3. Deve-se possuir um arquivo XML válido contendo os serviços enviados pela montadora Scania, que será utilizado como base para o processo de importação.


Bloco de código
languagexml
themeRDark
titleEstrutura do arquivo XML
<dataroot xmlns:od="urn:schemas-microsoft-com:officedata" xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance" xsi:noNamespaceSchemaLocation="standardtimes_pt-BR.xsd">
<STDTID>
<STDCODE>00000000-0</STDCODE>
<LANGUAGE_CODE>pt</LANGUAGE_CODE>
<WORKOBJECT>Teste objeto exemplo</WORKOBJECT>
<WORKTYPE>fazer</WORKTYPE>
<DESCR>Classificação, com seus itens.</DESCR>
<VARIANT>A,L,Z</VARIANT>
<TIMETYPE>N</TIMETYPE>
<ECC_KATEGORY>B</ECC_KATEGORY>
<TIME>0.1</TIME>
<TU>13</TU>
<PU>20</PU>
<INVOICE_TEXT>Teste objeto exemplo fazer</INVOICE_TEXT>
<COMPONENT_CODE/>
<P3TRUCK> </P3TRUCK>
<P3BUS> </P3BUS>
<P4TRUCK> </P4TRUCK>
<P4BUS>Y</P4BUS>
<P5TRUCK> </P5TRUCK>
<P5BUS> </P5BUS>
<P6TRUCK> </P6TRUCK>
<P6BUS> </P6BUS>
<P4IM> </P4IM>
<P5IM> </P5IM>
</STDTID>
</dataroot>
Nota
titleInformativo
  • Tamanho do arquivo XML: Aproximadamente 11 MB.
  • Quantidade de serviços contidos no arquivo: Cerca de 16 mil serviços.
  • Tempo de processamento do arquivo pela rotina: Aproximadamente 20 minutos.
Totvs custom tabs box items
defaultno
referenciaaba2


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.


Dica
titleExemplos de códigos de Grupos de Serviço montadora Scania


00    Generalidades
01    Motor
02    Sistema de arrefecimento
03    Sistemas de escape/combustível
04    Embreagem
05    Caixa de mudanças
06    Árvore de transmissão
07    Eixo dianteiro
08    Eixo traseiro
09    Cubo e rodas
10    Freios
11    Chassi
12    Suspensão
13    Direção
14    Controle do motor
16    Sistema elétrico
17    Instrumentos
18    Cabina
19    Equipamento complementar
20    Carroceria de carga
21    Reboque
43    Carroceria de ônibus Irizar

Informações
titleAviso

Essas informações são de responsabilidade dos concessionários e deverão ser obtidas junto à 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:


Totvs custom tabs box items
defaultno
referenciaaba3


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

  • Tabela VOS - Grupos de Serviços
CampoVOS_GRPSER
TipoCaractere
Grupo de Campos
Ordem09
Tamanho2
Decimal0
Formato@!
Contexto1-Real
Propriedade1-Alterar
TítuloCod Grp Mont
DescriçãoCod Grp Servico Montadora
Val. SistemaOA0200018_VldGrp()
OpçõesInic. PadrãoInic. BrowseCons. Padrão
Nível1
UsadoSim
ObrigatórioNão
BrowseNão
WhenPasta
Help

Grupo de servico da Montadora

Menu

Atualizações

Submenu

Cadastros Oficina?

Nome da Rotina

Importação de Serviços ScaniaAtualização da Lista de Preços

Programa

OFIA533OFIA539

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus



Criação de Pergunte no arquivo SX1 – Pergunta


Grupo

OFIA533
OFIA539
OFIA533
OFIA539
OFIA533OFIA533
OFIA539
OFIA533
OFIA539

Grupo de campo

VE1




Ordem

01020304
05

Pergunta

Marca ?Arquivo XML ?Quantidade Mecânicos ?Ação pós Processamento ?Mover Para
Diretório do ArquivoGrupos de ProdutoDestino PúblicoDestino Público 30d
?

Tipo

CC
N
CC
Tamanho
3
99
1
80
1
40
99
40
Decimal
0
0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
MV_PAR05
Formato
@E 9ValidaçãoExistCpo("VE1",MV_PAR01)OA533002K_ValidPerg()!




ValidaçãoOA539005M_PreValid(1)!Vazio() .And. OA539005M_PreValid(2)Vazio() .Or. OA539005M_PreValid(3)Vazio() .
AND
Or.
(MV_PAR03 >= 1 .And. MV_PAR03 <= 9)
OA539005M_PreValid(3)
ObjetoGetGetGetGet
Consulta Padrão

VX5PRVVX5PRV
Pré-Seleção (Combo)



Item 1



Item 2



Item 3



Item 4



Item 5



Help





Grupo

OFIA539OFIA539OFIA539OFIA539

Grupo de campo





Ordem

05060708

Pergunta

Destino BalcãoAtu. Quant. por EmbalagemAção após ProcessamentoMover Para

Tipo

CCCC
Tamanho401199
Decimal0000
Var01MV_PAR05MV_PAR06MV_PAR07MV_PAR08
Formato



ValidaçãoVazio() .Or. OA539005M_PreValid(3)

If( MV_PAR07==2, OA539005M_PreValid(4) ,Vazio()
NaoVazio()OA533002K_ValidPerg(
)
ObjetoGet
Get
Combo
Get
ComboGet
Consulta Padrão
VE1
VX5PRV


Pré-Seleção (Combo)
21
Item 1
SimNenhuma Ação
Item 2
NãoMover 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 → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios:
    • Marca
    • Arquivo XML
    • Quantidade Mecânicos 
    • Ação pós Processamento
  4. 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.
  5. No parâmetro Ação pós Processamento:
    • Selecione a opção Nenhuma Ação. Com isso, o arquivo XML permanecerá no diretório original e sem ser movido ou apagado após seu processamento.
  6. 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.


Multimedia
nameImportação XML Nenhuma Ação.mp4
width1400
autostarttrue
height700

Totvs custom tabs box items
defaultno
referenciapasso2


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios:
    • Marca
    • Arquivo XML
    • Quantidade Mecânicos 
    • Ação pós Processamento
  4. 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.
  5. 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.
  6. 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á movido do diretório original para o diretório destino indicado no parâmetro Mover Para.



Totvs custom tabs box items
defaultno
referenciapasso3


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios:
    • Marca
    • Arquivo XML
    • Quantidade Mecânicos 
    • Ação pós Processamento
  4. 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.
  5. 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.
  6. 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.



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


...