...
| Índice |
|---|
| minLevel | 0 |
|---|
| include | [Identificação da Rotina] |
|---|
| indent | 10px |
|---|
|
...
1. Identificação da Rotina
Nome da Rotina | Importação de Serviços Scania |
|---|
| Programa | OFIA533 |
|---|
| Módulo ERP | Oficina (SIGAOFI) |
|---|
| Acesso à Rotina | Atualizações/Cadastros Oficina/Importação de Serviços Scania (OFIA533) |
|---|
| Data da Documentação (Ultima Última Atualização) | |
|---|
...
2. Descrição Funcional
A rotina Importação de Serviços Scania (OFIA533) tem como finalidade importar e atualizar automaticamente os facilitar a importação e atualização dos serviços enviados pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo XML fornecido pela própria montadora.
...
Após a importação, o sistema executa as ações de pós-processamento configuradas, que podem incluir mover, apagar ou manter o arquivo, e registra logs com o resultado da operação.
Dessa forma, a rotina garante a integração automática e segura auxilia na organização e manutenção do cadastro dos serviços Scania com o dentro do Protheus, mantendo o cadastro sempre atualizado tornando o processo mais simples e reduzindo a necessidade de intervenções manuais.
...
3. Pré-requisitos e Configurações
...
| Totvs custom tabs box |
|---|
| tabs | Pré-requisitos, Configurações, Atualização de Dicionário/Menu |
|---|
| ids | aba1,aba2,aba3 |
|---|
|
| Totvs custom tabs box items |
|---|
|
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 a integração completa entre os dados da o correto tratamento dos dados entre a Scania e o Protheus DMS. São elas: - 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.
- É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
- 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 |
|---|
| language | xml |
|---|
| theme | RDark |
|---|
| title | Estrutura 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 |
|---|
| - 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 |
|---|
|
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 |
|---|
| title | Exemplo Exemplos de códigos de Grupos de Serviços Montadora 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 |
| Painelinfo |
|---|
| borderColortitle | #08244C |
|---|
| bgColor | #E8E8E6 |
|---|
| titleColor | #041E42 |
|---|
| borderWidth | 2 |
|---|
| borderStyle | solid |
|---|
| title | Exemplo Grupos de Serviços 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 | | Essas informações são de responsabilidade dos concessionários e deverão ser obtidas junto à Montadora Scania. |
|
| Totvs custom tabs box items |
|---|
|
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 de Serviços Scania |
|---|
Programa | OFIA533 |
|---|
Módulo | Oficina (SIGAOFI) |
|---|
Tipo | Função Protheus |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | OFIA533 | OFIA533 | OFIA533 | OFIA533 | OFIA533 |
|---|
Grupo de campo | VE1 |
|
|
|
|
|---|
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 |
|
|
|
|
|
|---|
|
|
...
| Totvs custom tabs box |
|---|
| tabs | Passo 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 |
|---|
| ids | passo1,passo2,passo3,passo4 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
|
- Acesse o Modulo Módulo 14 (Oficina).
- Acesse o menu Atualizações→ Cadastros 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 Nenhuma Ação. Com isso, o arquivo XML 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 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 |
|---|
| name | Importação XML Nenhuma Ação.mp4 |
|---|
| width | 16001400 |
|---|
| autostart | true |
|---|
| height | 800700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
|
- Acesse o Modulo Módulo 14 (Oficina).
- Acesse o menu Atualizações→ Cadastros 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 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 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.
| Multimedia |
|---|
| name | Importação Arquivo XML Mover Arquivo.mp4 |
|---|
| width | 16001400 |
|---|
| autostart | true |
|---|
| height | 800700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
|
- Acesse o Modulo Módulo 14 (Oficina).
- Acesse o menu Atualizações→ Cadastros 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.
| Multimedia |
|---|
| name | Importação Arquivo XML Apagar Arquivo.mp4 |
|---|
| width | 16001400 |
|---|
| autostart | true |
|---|
| height | 800 | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
|
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).
Image Added
|
|
...
5. Integrações e Dependências
...
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 automaticamente na Tabela de Serviços , caso ainda não existam, ou terão o campo Tempo de "Tmpo Fábrica" (Tmpo FabricaVO6_TEMFAB) atualizado, caso já estejam registrados.
Essa integração garante que os dados enviados pela montadora Scania sejam incorporados ao Protheus de forma automática e confiável, mantendo o cadastro de serviços sempre atualizado e alinhado às informações da montadora.
...