ESPECIFICAÇÃO FUNCIONAL

IDENTIFICAÇÃO DO PROJETO
Nome do Projeto Código
Projeto Conecta BR-2021-0930
Cliente Módulo / Processo
MRS PM
Gerente de Projetos Gerente de Serviços
Christiane Caula Mario Falcheti

IDENTIFICAÇÃO DO DOCUMENTO
Autor
Rodrigo Diniz
Id (Identificação) do GAP Descrição
MAN_ITF0079_001 ET - Campos Novos - Notas de manutenção - MAN_0079

Tipo de GAP (WRICEF) Complexidade Criticidade Negócio (MOSCOW)

Interface Alta Não Informada

Versão Status Data Criação

1.0 Em Elaboração 30-09-2021

HISTÓRICO DE REVISÕES – ESPECIFICAÇÃO FUNCIONAL

Versão Data Revisor Descrição

HISTÓRICO DE REVISÕES – ESPECIFICAÇÃO TÉCNICA

Versão Data Revisor Descrição

 ESPECIFICAÇÃO FUNCIONAL

Índice

1. INTRODUÇÃO................................................................................................................................................ 3
1.1. PROPÓSITO DO DESENVOLVIMENTO...................................................................................................... 3
1.2. BENEFÍCIOS E CONSEQUÊNCIAS DA SOLUÇÃO.....................................................................................3
1.3. FUNCIONALIDADES A SEREM DESENVOLVIDAS...................................................................................3
2. DEFINIÇÕES FUNCIONAIS E REGRAS DE NEGÓCIO..............................................................................3
2.1. FLUXO DA SOLUÇÃO PROPOSTA.............................................................................................................. 3
2.2. DESCRIÇÃO FUNCIONAL............................................................................................................................ 3
3. DOCUMENTAÇÃO TÉCNICA....................................................................................................................... 4
3.1. DEFINIÇÕES TÉCNICAS............................................................................................................................... 4
3.2. RELAÇÃO DE OBJETOS CRIADOS............................................................................................................. 4
4. PLANO DE TESTES........................................................................................................................................ 5
4.1. LISTA DE TESTES UNITÁRIOS A SEREM REALIZADOS.........................................................................5
4.2. TESTES DE ACEITAÇÃO DO USUÁRIO...................................................................................................... 5

Página 2
 ESPECIFICAÇÃO FUNCIONAL

1. Introdução

Ao criar ou alterar uma Nota PM: deve-se acionar uma UserExit que valida a tabela de parâmetro onde
obedece a lógica/regra desenhada nessas tabelas de parâmetros, para saber se deve efetuar a interface de
informações aos legados.

1.1. Propósito do Desenvolvimento

Efetuar um processo lógico de critérios para interface de informações entre S4H e legados, onde o usuário
seleciona em uma tabela de parâmetros e direciona as informações que serão enviadas via interface a cada
legado.
Foram criados campos adicionais para Notas de PM que terão tratativas diferenciadas, existindo a
necessidade de desenvolvimento de uma ampliação de tela, tabela e criação de algumas tabelas de
parâmetros para o controle de interface de dados entre S4H -> Legados.
 Abertura de Notas no CCM que irá refletir no S4H que irá enviar as informações ao Sislog
posteriormente;
 Abertura de Notas no SAP que irá enviar as informações para o CCM;
 Campos considerados como “Não Comuns” serão tratados como características das Notas; alguns
campos possuem lista de valores, onde existe uma tabela por trás dele que me possibilite uma escolha
para preenchimento;
 Esses serão tratados em ampliação de tela e tabela standard;
 Iremos detalhar como os campos comuns serão tratados via tabela de parâmetros para a interface de
dados entre SAP e legados.
 Os outros 43 campos restantes são comuns e serão tratados com tela e tabelas de ampliação:

1.2. Benefícios e consequências da solução

a) Uso de tabela de parâmetros afim de proporcionar interface de informações do SAP com diversos
legados criando lógicas para selecionar Notas e campos para cada legado: CCM, Track Star e
Sislog.
b) Notas espelhadas entre SAP e Legados.

1.3. Funcionalidades a serem desenvolvidas

a) Ao executar algum tipo de atualização nas Notas PM, esta tem que obedecer a lógica e critérios
das tabelas de parâmetros e interfacear os dados.
b) Este desenvolvimento visa criar uma interface para ler o SAP e atualizar /espelhar as informações
de Notas PM nos legados.

2. Definições Funcionais e Regras de Negócio

Página 3
 ESPECIFICAÇÃO FUNCIONAL

Processo de Criação de Notificação de Manutenção

 Teremos chamadas via legados: CCM, Track Star, Ultrasom, esses sistemas passam pela camada do
PI/PO, onde serão estabelecidas interfaces via RFC, serão carregadas e processadas pelo SAP para
criação de Notas PM;
Obs.: Serão tratadas em demandas MAN_077: Identificação de Duplicidade e MAN_077/14: Tabela
de Condições para determinação de Criticidade;
 Depois que passa pela camada de comunicação podemos criar as Notas PM via Fiori, IW21 ou Asset
Manager;

O fluxo de processo será feito conforme mapeamento abaixo:

 A solução será uniforme afim de atender todas as entradas, onde a MRS irá ter um controle unificado
de todos os métodos de criação /alteração de Notas;
 Depois de criada ou alterada a Nota iremos acionar o processo de validação nas tabelas de parâmetros
através das UserExits conforme abaixo:

Utilizar as UserExits:
 IWOC0001 (Criação);
 IWOC0002 (Modificações).
Foi montada a planilha de campos adicionais (em anexo) onde: sairemos com 14 campos
essenciais para os legados, e também campos específicos para cada um deles.
Pensando na estrutura de negócios onde deve-se criar os campos “Z” ampliados na tabela
“QMEL” que armazena todos os dados e atributos de Notas PM, para esses campos “Z” teremos
um conjunto de parâmetros para controle deles, onde:
 O primeiro deles é criar uma tabela (Z_PM_SISTEMAS), campos (Z_SISTEMA), contendo os
sistemas legados que entregam ou consultam informações em uma Nota. Deve-se criar uma
transação Z para acesso e registro dos itens conforme layout abaixo:

Página 4
 ESPECIFICAÇÃO FUNCIONAL

 Criar uma segunda tabela (Z_NOTAS), para as definições dos campos: (Z_TIPONOTA),
(Z_SISTEMA), (Z_CAMPO). onde esses 14 campos “Z” que iremos incluir na tabela “QMEL”
serão consistidos conforme regras definidas pelo usuário MRS. Também só irá aparecer na tela de
ampliação e ou informados aos legados se esses campos forem determinados na tabela de
parâmetros abaixo:

Obs.: Será criada transação Z específica para preenchimento de cada tabela de parâmetros mencionada
neste documento.
 Depois disso teremos uma terceira tabela de condição que iremos determinar pelo tipo de
Nota quais os campos iremos permitir: “Z_Visualização”, “Z_Alteração” e “Z_Inativação”.

Regra geral: Determina-se primeiro os “Sistemas legados” que estarão envolvidos neste processo ->
depois o filtro por “Tipo de Nota”, “Campo” e “Sistema” -> por fim teremos pelo “Tipo de Nota” a
determinação de: “Visualização”, “Alteração” ou “Inativação” dos campos.

Segue abaixo o fluxo detalhado do processo:

Página 5
 ESPECIFICAÇÃO FUNCIONAL

Deve-se efetuar essa combinação de parametrizações para definição do que será visualizado, alterado
ou se estará ativo na tela ou interfaceado para determinado legado.
Uma vez que a Nota estiver criada iremos ativar as duas UserExits conforme abaixo:
 EXIT_SAPMIWO0_008
 EXIT_SAPMIWO0_009
Essas irão abrir uma aba a mais na tela de Nota, passando pela validação das regras determinadas nas
tabelas de parâmetro acima, afim de: “Visualizar”, “Alterar” ou “Inativar” o mesmo. Mencionar
ampliação de tela
Segue abaixo exemplo da ampliação de tela:

Após essa Nota ser Criada /Alterada iremos chamar as outras 7 interfaces que estão atreladas a esses
desenvolvimentos.

Página 6
 ESPECIFICAÇÃO FUNCIONAL

Segue abaixo um exemplo de determinação de campos a serem interfaceados com os legados: CCM e
SISLOG:

Obs.: Esses serão os 14 campos que serão ampliados na tela de Notas via Exits e na tabela Standard
“QMEL”. Mencionar os campos na EF ou anexar o arquivo

Processo de campos específico para interface aos legados

Página 7
 ESPECIFICAÇÃO FUNCIONAL

Será usado o sistema de classificação do SAP, que me permite criar características, tabular valores
dessas características, colocar isso em tabelas para usarmos em lógicas, relatórios, etc... Portanto
usaremos o sistema de classificação 015, que nos permite criar uma Classe com um conjunto de
características específicas para cada sistema legado. Caso essas características determinadas tiverem
atributos, serão atribuídas na mesma manualmente.
Exemplo de definição deste item:

Iremos determinar a regra que iremos chamar essa classificação, onde:

 Iremos utilizar novas regras e tabelas de parâmetros (Z_CLASSES), com os
campos(Z_TIPONOTA), Z_CLASSE) e (Z_SISTEMA), onde teremos a tabela 1 da solução
anterior que estará ligada a uma segunda que irá determinar a “Classe” para cada legado.

 Quando tivermos a Criação ou Alteração da Nota, ou chamada destas funções através dos legados:
Será acionada as UserExits:
 IWOC0001 (Criação);
 IWOC0002 (Modificações).
 Acionaremos as regras da tabela de parâmetros e deve-se popular o Item com a Classe determinada
nesta, a fim de interfacear essas informações com o legado específico.

Exemplo do processo mencionado acima:

Página 8
 ESPECIFICAÇÃO FUNCIONAL

Exemplo da solução na tela de Notas PM:

Página 9
 ESPECIFICAÇÃO FUNCIONAL

Para a ampliação de tela na nota deve-se seguir o detalhamento abaixo:

- Criar um grupo de função Z*;
- Criar uma tela do tipo subtela;
- Adicionar nessa tela os campos do cliente que não possuem no standard QMEL – sugiro inclusão
em novo APPEND na estrutura EXIT_SAPMIWO0_008 e EXIT_SAPMIWO0_009;
- Criar grupo de tela e implementações BADI;
- Preparar ampliação livre de modificações;
- Incluir um novo grupo de telas;
- Criar uma subtela própria do cliente Z*;
- Criar uma implementação para a instância de Dados Adicionais;
- Codificar o método para que o grupo de tela criado seja chamado o programa que foi criado no
primeiro passo juntamente com a tela.

Página 10
 ESPECIFICAÇÃO FUNCIONAL

- Codificar o método para gravar o campo de tela do programa Z no programa standard.

- No método criado deve-se pegar o dado do standard e jogar a tela do grupo de funções Z;
- Parametrizar na SM30 para adicionar o parâmetro do grupo de tela criado em terminada visão;
- Adicionar uma sequência ordinal, um código de função qualquer, a descrição e o conteúdo;
- Acessar a I23 para testar uma aba de Dados adicionais para a tela criada na Nota, pode ser com o
nome: “Dados adicionais”.
Segue abaixo a estrutura de campos para adicionar na tabela QMEL conforme detalhado nessa
especificação.

Campo SAP Nome Campo Standard ou Z Tipo Tamanho Descrição

Situação (CBTC) Situação (CBTC) Z_ID_SITC_CBTC Z NUMBER 10 Validação
via lista de
valores 47;
Atribuir Controle Atribuir Controle Z_ID_ATRB_CTRL Z NUMBER 10 Validação
via lista de
valores 48;
Segmento Segmento Responsável Z_ID_SGMT_RESP Z NUMBER 10 Validação
Responsável via lista de
valores 49;
Responsável pelo Responsável pelo Problema Z_ID_AR_RESP_PRBL Z NUMBER 10 Validação
Problema via lista de
valores 50;
Solicitação Malha Solicitação Malha Ferroviária Z_ID_SLCT_MALHA Z NUMBER 12  
Ferroviária
Prefixo do Trem Prefixo Trem Z_CD_PRFX_TREM Z VARCHAR2 8  
Peso do Trem Peso do trem Z_PS_TREM Z NUMBER 9,4  
Formação de Formação de Locomotivas no Z_DC_FRMC_LOCO_TRE Z VARCHAR2 4000  
Locomotivas no Trem M
Trem
Posição no Trem Posição do veículo no Trem Z_NU_POSC_VEIC_TREM Z NUMBER 5  

Gravidade do Gravidade Z_ID_GRVD Z NUMBER 10 Validação

Problema via lista de
valores 3;
Código do Local Local (Pátio) Z_CD_LOCAL Z VARCHAR2 255  

Modo de Operação Modo de operação Z_ID_MODO_OPER Z NUMBER 10 Validação

via lista de
valores 5;
Ponto de Ponto de aceleração Z_ID_PONTO_ACEL Z NUMBER 10 Validação
Aceleração via lista de
valores 2;
Esforço Trator DE Esforço Trator Inicial Z_VL_ESFO_TRAC_INIL Z NUMBER 9,4  

Esforço Trator ATÉ Esforço Trator Final Z_VL_ESFO_TRAC_FINAL Z NUMBER 9,4  

Unidade Esforço Esforço Trator Unidade Z_ID_UN_ESFO_TRAC Z NUMBER 10 Validação

Trator via lista de
valores 6;
Velocidade Velocidade da locomotiva Z_VE_LOCO Z NUMBER 9,4  
Locomotiva
Desviado? Desviado Z_IC_DSVI Z VARCHAR2 1 Valores
possíveis:
1 - SIM / 2-
NÃO

Página 11
 ESPECIFICAÇÃO FUNCIONAL

Local do Desvio Local desvio (Pátio) Z_CD_LOCAL_DSVI Z VARCHAR2 255 Validação:

Pátio válido
(local de
instalação).
Descrição Local Descrição Local desvio (Pátio) Z_DC_LOCAL_DSVI Z VARCHAR2 4000 Validação:
Desvio Pátio válido
(local de
instalação).
Isolado? Isolado Z_IC_ISLD Z VARCHAR2 1 Valores
possíveis:
1 - SIM / 2-
NÃO
Código da Linhas Linhas Z_CD_LINHA Z VARCHAR2 30  
Restrição da Restrição da Velocidade Z_VE_RTRC Z NUMBER 10  
Velocidade
Pátio/Entrepátio Pátio/Entrepátio CÓD.LOC.INSTALAÇÃO Cálculo a partir de um campo de Local de      
Instalação da Nota

Tipo de restrição Tipo de restrição Z_TP_RESTRICAO Z      

Tipo de Solicitação Tipo de Solicitação de Serviço Z_ID_SLCT_SERV Z NUMBER 10 Validação

de Serviço via lista de
valores 51;
Condição do Condição do Veículo Z_ID_CNDC_VEIC Z NUMBER 10 Validação
Veículo via lista de
valores 8;
Código da Tipo Ocorrência Tráfego Z_ID_TIPO_OCOR_TRFG Z NUMBER 10 Validação
Ocorrência de via lista de
Tráfego valores 7;
Código do Acidente Código Acidente SGS Z_CD_ACDT Z VARCHAR2 6  

Definição Final Definição Final Z_ID_DFNC_FINAL Z NUMBER 10 Validação

via lista de
valores 9;
Gerador THP Gerador THP Z_IC_GRDR_THP Z VARCHAR2 1 Valores
possíveis:
1 - SIM / 2-
NÃO
Justificativa THP Justificativa THP Z_ID_JTFC Z Campo interno, apenas visível para o VARCHAR2 3  
SISLOG
Código da Origem Código da Origem da Atividade Z_CD_ORIG_ATVD Z Código Interno, não aparente para o usuário VARCHAR2 30  
da Atividade
Descrição da Descrição da Origem da Atividade Z_DC_ORIG_ATVD Z VARCHAR2 80  
Origem da
Atividade

TRACK STAR E ULTRASSOM

Campo SAP Nome Campo Standard ou Z Tipo Tamanho Casas decimais Descrição
Classe da Classe da Inspeção   Z NUM 2 0  
Inspeção
Tamanho do Tamanho do Defeito   Z NUM 4 0  
Defeito
Categ. Categ. Defeito   Z CHAR 40    
Defeito
Parametro Parametro   Z NUM 4 0  
Medição Medição   Z NUM 4 2  
Bitola Bitola   Z NUM 4 2  
Evento Evento anterior   Z CHAR 40    
anterior

Página 12
 ESPECIFICAÇÃO FUNCIONAL

Distância do Distância do último   Z NUM 4 2  

último evento
evento
Localização Localização   Z CHAR 40    
Geometria Geometria   Z CHAR 40    
Posição Posição   Z CHAR 40    
Tipo de Tipo de Defeito   Z CHAR 40    
Defeito
Component Componente   Z CHAR 40    
e
Condição de Condição de Via   Z CHAR 40    
Via
Prazo em Prazo em dias   Z NUM 4 0  
dias
Observação Observação   Z CHAR 100    
Latitude Latitude   Z NUM 2 8  
Longitude Longitude   Z NUM 2 8  
Ação Ação   Z CHAR 100    
Altura do Altura do trilho   Z NUM 6 0  
trilho
Tamanho Tamanho Área   Z NUM 6 0  
Área

2.1. Fluxo da Solução Proposta

Criação ou alteração de Notas PM -> Tabela de parâmetros S4H -> Leitura de lógica e configurações ->
Funções BAPI -> Interface com Legados.

3. Documentação Técnica

Tecnologia SAP
Outras utros:      
Tipo de Desenvolvimento Migração de Dados
Interface
Formulário
Reports
Enhancement
Temporário/outros: campos novos

Complexidade Muito Baixa Baixa Média Alta Muito Alta

Página 13
 ESPECIFICAÇÃO FUNCIONAL

3.1. Especificações Técnicas

c) <Descrever definições técnicas>

3.2. Relação de Objetos Criados

a) <Listar os objetos criados>

Página 14
 ESPECIFICAÇÃO FUNCIONAL

4. Plano de Testes

4.1. Lista de testes unitários a serem realizados

Id Teste a realizar Resultado Esperado

Caso seja utilizado um plano de teste a parte, informar o nome do arquivo onde está descrito o plano de
testes.

4.2. Testes de Aceitação do Usuário

Listar os testes que serão realizados pelo usuário para aceitação do desenvolvimento, ou informar o nome
do arquivo com o plano de testes a ser executado.

Id Teste a realizar Resultado Esperado

Página 15