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 Atualização) | |
|---|
2. Descrição Funcional
Observação:
Neste tópico, é necessário descrever de forma clara e objetiva a funcionalidade da rotina, explicando qual é seu propósito, por que ela foi criada e qual a sua importância dentro do sistema.
A rotina Importação de Serviços Scania (OFIA533) tem como finalidade importar e atualizar automaticamente os serviços enviados pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo XML fornecido pela própria montadora.
Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios. Com base nessas informações e no mapeamento dos Grupos de Serviço previamente cadastrados, o sistema realiza as validações necessárias para identificar e incluir ou atualizar os serviços por meio do processamento do arquivo.
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 dos serviços Scania com o Protheus, mantendo o cadastro sempre atualizado e reduzindo a necessidade de intervenções manuais.
3. Pré-requisitos e Configurações
Observação:
Neste tópico, devem ser informados todos os pré-requisitos e configurações necessárias para o correto funcionamento da rotina, como parametrizações, permissões, cadastros obrigatórios, tabelas envolvidas ou qualquer dependência técnica ou funcional.
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 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.
|
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. |
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 |
|---|
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 |
|
|
|
|
|
|---|
|
|
4. Fluxo de Utilização
Observação:
Neste tópico, deve ser descrito o passo a passo do fluxo de utilização da rotina, apresentando de forma sequencial e didática como o usuário deve operar a funcionalidade, desde a etapa inicial até a final, incluindo interações com outras rotinas, validações e resultados esperados.
Observação:
Prints e vídeos utilizados na documentação devem seguir o tema padrão do Protheus (Azul). O nome do usuário exibido deve ser apropriado e nunca deve ser utilizado o usuário "Admin".
Além disso, o passo a passo deve ser descrito de forma clara e objetiva, orientando o usuário pelo fluxo padrão da rotina, indicando visualmente onde clicar na tela e como utilizar as funcionalidades envolvidas.
- Acesse o Modulo 14 (Oficina).
- Acesse o menu 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, exibindo mensagens relacionadas à execução do ponto de entrada para cada serviço incluído ou atualizado. Ao final do processamento, quando o arquivo for processado com sucesso, será exibida a mensagem referente à execução do ponto de entrada de conclusão da rotina.
|
- Acesse o Modulo 14 (Oficina).
- Acesse o menu 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, exibindo mensagens relacionadas à execução do ponto de entrada para cada serviço incluído ou atualizado. Ao final do processamento, quando o arquivo for processado com sucesso, será exibida a mensagem referente à execução 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 Modulo 14 (Oficina).
- Acesse o menu 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, exibindo mensagens relacionadas à execução do ponto de entrada para cada serviço incluído ou atualizado. Ao final do processamento, quando o arquivo for processado com sucesso, será exibida a mensagem referente à execução do ponto de entrada de conclusão da rotina, e o arquivo será apagado do diretório original onde foi selecionado.
|
|
5. Integrações e Dependências
Observação:
Neste tópico, devem ser detalhadas todas as integrações com outros sistemas ou rotinas, bem como as dependências existentes para o correto funcionamento da rotina. Especifique, de forma clara e objetiva, os sistemas integrados, os protocolos de comunicação, as interfaces utilizadas e quaisquer requisitos técnicos que influenciem a operação e a manutenção da funcionalidade, caso não houver integrações relevantes favor colocar "Não se aplica" neste tópico.
Integração: Atualizações > Cadastros Oficina > Tabela de Serviços (OFIOA030)
6. Assuntos Relacionados
DT DMS SCANIA - Implementado campo Cod Grp Servico Montadora na rotina Grupo de Servicos (OFIOA020)
PE OF533SER para que seja possível executar ações personalizadas após a inclusão ou atualização de serviços durante o processo de importação na rotina Importação de Serviços Scania (OFIA533)
PE OF533FIM para que seja possível executar ações personalizadas após a conclusão do processamento completo do arquivo XML na rotina Importação de Serviços Scania (OFIA533)
<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=973046863" target="_blank" class="btn-doc">
📄 Novo campo Cod Grp Servico Montadora - Grupos de Serviço (OFIOA020)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008697602" target="_blank" class="btn-doc">
📄 Ponto de Entrada OF533SER - Importação de Serviços Scania (OFIA533)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008699858" target="_blank" class="btn-doc">
📄 Ponto de Entrada OF533FIM - Importação de Serviços Scania (OFIA533)
</a>
</div>
|
Observação:
Neste tópico, devem ser listados links ou referências para rotinas, documentos, parametrizações, tabelas ou funcionalidades que possuam relação direta com a rotina documentada. O objetivo é facilitar o entendimento do contexto e oferecer ao leitor acesso a conteúdos complementares que possam auxiliar no uso ou na configuração da funcionalidade, caso não houver assuntos relacionados relevantes favor colocar "Não se aplica" neste tópico.