Histórico da Página

...

...

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.

...

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 default yes referencia aba1 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. Totvs custom tabs box items default no referencia aba2 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. Totvs custom tabs box items default no referencia aba3 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

...

...

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 ids passo1,passo2,passo3
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. Totvs custom tabs box items default yes referencia passo1 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. Multimedia name Importação XML Nenhuma Ação.mp4 width 1800 autostart true height 900 Totvs custom tabs box items default no referencia passo2 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. Multimedia name Importação Arquivo XML Mover Arquivo.mp4 width 1800 autostart true height 900 Totvs custom tabs box items default no referencia passo3 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. Multimedia name Importação Arquivo XML Apagar Arquivo.mp4 width 1800 autostart true height 900

...