EnglishEspañolPortuguês
EN (English)ES (Español)Solicitar demo
Maquete arquitetônica do mundo de uma empresa na hora azul. Um fio de luz verde-limão traça a rota de um pedido pelos bairros da maquete.

Documentação de processos e código customizado para SAP

Como seu negócio roda no SAP, documentado com provas.

Uma única exportação somente leitura do seu sistema SAP se transforma em documentação de como seus processos rodam: o que os inicia, quais tabelas eles leem e alteram, quais interfaces alcançam e qual código customizado os sustenta. Cada linha factual traz sua citação. Seus especialistas confirmam a finalidade de negócio.

Solicitar demoVer um exemplo real

Uma página do catálogo gerada sem IA a partir do nosso sistema de demonstração sintético.

  • Exportação somente leitura
  • Grafo de evidências
  • Catálogo com citações
  • Acesso ao aplicativo web
Siga uma ordem de venda

Em resumo

  1. Somente leitura

    Um único programa de exportação, instalado sem ordem de transporte. Sem dados transacionais, sem nomes de usuário.

  2. Citado

    Cada linha factual traz uma citação da evidência que a sustenta.

  3. Verificado

    No piloto: 13.480 relações com evidência verificada e 0 falhas ao reverificar cada relação.123

  4. Confirmado

    Os documentos de processo só são publicados com a aprovação formal do seu especialista no assunto.

Notas sobre os números do piloto

  1. 1

    Piloto: um sistema SAP S/4HANA produtivo. Análise automatizada, reverificada sem falhas.

  2. 2

    Cada relação armazena arquivo, linha e nível de confiança.

  3. 3

    “0 falhas” significa que cada relação foi conferida de novo com a linha de código ou a linha exportada que ela cita. Isso não prova que uma interpretação de negócio esteja correta; é para isso que serve a aprovação formal do especialista.

A mesma maquete à noite, com as luzes apagadas: só algumas janelas estão acesas, e nenhuma rota aparece.

01O problema

Sem documentação, toda decisão sobre um processo é um palpite.

Seus processos rodam no SAP standard e no que a sua empresa construiu em torno dele: código customizado, configuração, jobs e interfaces. É nessa segunda parte que estão as perguntas.

  1. O conhecimento está em poucas cabeças.

    Consultores saem, usuários-chave mudam de área e a documentação nunca existiu ou está desatualizada.

  2. Toda mudança é um risco.

    Responder a “Quem mais grava nesta tabela?” ou a “O que acontece quando este IDoc chega?” custa dias de análise de um especialista sênior.

  3. Grandes projetos começam às cegas.

    SAP S/4HANA, clean core, uma troca de AMS ou uma auditoria: tudo começa com um inventário manual.

A seguir: uma ordem de venda, fase por fase, com a evidência por trás de cada etapa.

02Descoberta de processos

Siga uma ordem de venda pelo sistema.

A descoberta de processos parte do que o seu sistema SAP já contém: o código, a configuração, as transações e os jobs por trás de cada processo. A seguir, seis fases de uma ordem de venda no nosso sistema de demonstração sintético, cada uma com a evidência que a sustenta. As tags com link abrem a linha de código ou a linha exportada exata nas nossas páginas públicas de exemplo.

Ilustração: uma maquete do mundo de uma empresa; o fio verde-limão representa a rota da ordem de venda.

Uma ordem de venda, do IDoc de entrada à atualização de status

Sistema de demonstração sintético

  1. Fase 1 de 6

    A ordem chega

    O IDoc de entrada do tipo de mensagem ORDERS é processado por ZSD_ORDER_IDOC_IN, que chama ZSD_ORDER_CREATE.

  2. Fase 2 de 6

    Verificação de crédito

    ZSD_ORDER_CREATE chama ZSD_ORDER_CHECK_CREDIT, que lê ZSD_CREDIT_LIM (Customer credit limits).

  3. Fase 3 de 6

    Ordem criada

    ZSD_ORDER_CREATE chama BAPI_SALESORDER_CREATEFROMDAT2. O índice da lista de utilização do SAP registra a mesma chamada.

  4. Fase 4 de 6

    Canal e status registrados

    ZSD_ORDER_CREATE insere registros em ZSD_ORDER_LOG (Sales order channel and status log).

  5. Fase 5 de 6

    Etiqueta de picking impressa

    A transação ZWM_LABEL (Print picking labels) inicia ZWM_PICK_LABEL, que lê ZSD_ORDER_LOG.

  6. Fase 6 de 6

    Status atualizado

    ZSD_ORDER_STATUS_UPDATE atualiza ZSD_ORDER_LOG. Ele é chamado na tarefa de atualização a partir de três pontos: o include de user exit MV45AFZZ, a tela da transação ZSD_STATUS e ZWM_PICK_LABEL.

Ponto não resolvido

CALL FUNCTION gv_fm em ZWM_PICK_LABEL: o nome da função é calculado em tempo de execução. Fica listado na página Coverage; nunca é adivinhado.

Ilustração do nosso sistema de demonstração sintético. Cada afirmação reformula linhas do catálogo gerado sem IA para esse sistema, com as respectivas tags de citação. Os nomes das fases e a ordem delas foram acrescentados para esta página. As tags com link abrem a linha de código ou a linha exportada exata nas páginas de exemplo. As tags GRAPH nomeiam uma relação registrada e não têm página própria.

03Fluxo do processo

Um fluxo para cada processo.

No aplicativo web, cada processo tem o seu fluxo: como ele é iniciado, cada etapa na ordem do código, o que ele chama fora do processo, as tabelas que usa e as interfaces que alcança. O fluxo é construído a partir do grafo de evidências, sem IA, com uma citação em cada etapa. Uma camada mostra os processos vizinhos: aqueles de onde ele vem e aqueles em que ele continua.

IlustraçãoA fase 5 da rota, aberta como fluxo do processo

O fluxo do processo por trás da fase 5: etiquetas de picking

Objetos deste processo Programa ZWM_PICK_LABEL

Vem deGrupo de funções ZSD_ORDERZSD_ORDER_CREATE grava ZSD_ORDER_LOG, que este processo lê.

  1. A transação ZWM_LABEL inicia o programa ZWM_PICK_LABEL.

    • EXPORT:cg_transactions.tsv:15

    Iniciado porZWM_LABELTransação · Print picking labels

  2. ZWM_PICK_LABEL lê ZSD_ORDER_LOG.

    DadosZSD_ORDER_LOGTabela

  3. Ele chama um módulo de função cujo nome é decidido em tempo de execução (CALL FUNCTION gv_fm): um ponto não resolvido, nunca adivinhado.

    Chamado fora do processogv_fmMódulo de função decidido em tempo de execução

  4. Ele chama ZSD_ORDER_STATUS_UPDATE na tarefa de atualização.

    Chamado fora do processoZSD_ORDER_STATUS_UPDATEMódulo de função de outro processo · tarefa de atualização

Continua emGrupo de funções ZSD_ORDEREste processo chama ZSD_ORDER_STATUS_UPDATE, que atualiza ZSD_ORDER_LOG.
Ilustração desenhada para esta página a partir da rota verificada do nosso sistema de demonstração sintético; não é uma captura do aplicativo web. Ela mostra etapas selecionadas do fluxo que a transação ZWM_LABEL inicia; o agrupamento em processos foi acrescentado para esta página. O fluxo no aplicativo web tem mais etapas; esta ilustração mostra quatro.

Limite declarado. As etapas seguem a ordem das linhas do código-fonte; condições e loops não são avaliados. As chamadas decididas em tempo de execução são listadas como pontos não resolvidos, nunca adivinhadas. O que os módulos de função e as BAPIs do SAP fazem internamente não é mostrado.

O fluxo do processo, em detalhe

04Processo e código

Um fato, duas leituras.

Um dono de processo lê uma fase da ordem de venda. Um desenvolvedor lê a linha de código por trás dela. Os dois leem a mesma evidência, com a mesma citação.

Fotografia macro: um fio verde-limão liga uma linha destacada de um relatório impresso a um alfinete em um diagrama de processo.
Três fases da ordem de venda, cada uma lida como etapa do processo e como a linha de código por trás dela
Leitura do processoLeitura do código
A ordem chegaO IDoc de entrada do tipo de mensagem ORDERS é processado por ZSD_ORDER_IDOC_IN, que chama ZSD_ORDER_CREATE.
Módulo de função ZSD_ORDER_IDOC_INLinha 34 do include LZSD_ORDERU03CALL FUNCTION 'ZSD_ORDER_CREATE'
Canal e status registradosZSD_ORDER_CREATE insere registros em ZSD_ORDER_LOG (Sales order channel and status log).
Módulo de função ZSD_ORDER_CREATELinha 55 do include LZSD_ORDERU01INSERT zsd_order_log FROM ls_log.
Status atualizadoZSD_ORDER_STATUS_UPDATE atualiza ZSD_ORDER_LOG.
Módulo de função ZSD_ORDER_STATUS_UPDATELinha 8 do include LZSD_ORDERU04UPDATE zsd_order_log SET status = iv_status

Do nosso sistema de demonstração sintético. As linhas de código são citadas exatamente como foram exportadas, com a numeração do editor ABAP (SE80). Os nomes das fases foram acrescentados para esta página.

Cinco tags e um marcador, cada qual com um só sentido

CODE
A linha exata do seu código-fonte ABAP ou CDS, com a numeração do editor ABAP (SE80).
GRAPH
Uma relação registrada, como “este programa lê aquela tabela”, sempre acompanhada da linha de código ou da linha exportada de onde veio.
SCHEMA
A definição no Dicionário ABAP: uma tabela, um campo, um elemento de dados, um domínio ou uma mensagem.
EXPORT
Uma linha de um arquivo exportado: configuração, o índice da lista de utilização do SAP, a lista de transações ou de jobs, ou o inventário de objetos e pacotes.
INFERRED
Uma dedução ou um limite declarado, claramente marcado como não sendo evidência.
SME-REVIEW-REQUIRED
Uma pergunta para o seu especialista no assunto quando a evidência não basta. Nunca é preenchida por suposição.

Um script determinístico, e não uma IA, confirma que cada tag aponta para uma evidência real que corresponde a ela.

Limite declarado. Uma verificação bem-sucedida prova que cada citação corresponde à sua evidência, não que uma interpretação de negócio esteja certa. É para isso que serve a aprovação formal do seu especialista.

Abrir a linha 55 no exemplo

05O que é documentado

Dois caminhos, as mesmas evidências.

Donos de processo e analistas partem dos processos de negócio. Desenvolvedores e arquitetos partem dos objetos. Ambos leem a documentação construída a partir do mesmo grafo de evidências, com as mesmas citações.

Documentação de processos de negócio

Como cada processo roda, do que o inicia ao que ele altera.

Seu código customizado agrupado por área de negócio e em processos de negócio, cada um ancorado no que o inicia. Depois, os documentos de processo descrevem um processo de ponta a ponta, para que seus especialistas o confirmem e deem a aprovação formal.

  • Áreas de negócio: o que inicia cada uma, quais outras áreas ela chama e quais tabelas ela lê e altera.
  • Um mapa de processos proposto a partir das evidências: código customizado agrupado em processos de negócio sem IA, com nomes tirados de textos registrados no SAP.
  • O que inicia cada processo: transações, jobs em background, configurações como IDoc e formatos de meio de pagamento, e o código SAP que chama o seu.
  • Um fluxo para cada processo: cada etapa na ordem do código, as tabelas que ele usa e as interfaces que alcança, com uma citação em cada etapa.
  • Documentos de processo em oito seções fixas, desde os fluxos do processo e as regras de negócio até as histórias de usuário e um checklist de validação.
  • A aprovação formal do seu especialista no assunto, com a qual o documento é publicado.
O lado dos processos, visão por visão
Código customizado por área de negócio: o mapa da visão Landscape com seu título, o diagrama de dependências entre as áreas de negócio e a lista de áreas.
Telas de um sistema de demonstração sintético.

Documentação de código customizado

Seu código customizado, objeto por objeto, até a linha citada.

Uma página com citações por objeto, gerada sem IA: como ele é iniciado, o que ele chama, quem o chama e quais tabelas ele lê e altera.

  • Um catálogo com uma página por módulo, módulo de função, transação, job e tabela, gerado sem IA.
  • Lista de utilização nos dois sentidos: quem chama o seu código a partir do SAP e o que o seu código referencia.
  • Pontos de entrada: todas as formas de iniciar o código customizado, de transações e jobs ao processamento de IDocs, BAdIs e user exits.
  • Impacto de uma alteração: tabela, programa, job e transação, com a linha de código de cada etapa.
  • Um visualizador de código-fonte que destaca a linha citada, com a numeração do editor ABAP (SE80); um painel lateral abre cada linha exportada citada.
  • Chamadas dinâmicas, SQL dinâmico e destinos fora da exportação são listados como pontos não resolvidos, nunca forçados no grafo.
O lado do código, visão por visão
Código-fonte do include LZSD_ORDERU01, numerado como na SE80, com as linhas citadas marcadas e a linha 55, INSERT zsd_order_log FROM ls_log., destacada.
Telas de um sistema de demonstração sintético.

06No aplicativo web

O que mais cada processo mostra.

Além do fluxo: quem usa cada tabela, quais interfaces existem e como um documento de processo é confirmado.

  • Matriz de uso de dados: objetos customizados nas linhas, tabelas nas colunas e C, R, U ou D em uma célula quando o objeto insere, lê, atualiza ou exclui dados nessa tabela.
    Data usage. C, R, U ou D em uma célula quando um objeto insere, lê, atualiza ou exclui dados nessa tabela. Telas de um sistema de demonstração sintético.

    Uso de dados, tabela a tabela

    Uma matriz mostra qual código customizado insere, lê, atualiza ou exclui dados em cada tabela e, com um clique, leva às linhas exatas do código. No nosso sistema de demonstração sintético, a página da tabela ZSD_ORDER_LOG lista sete comandos de banco de dados: duas inserções, quatro leituras e uma atualização.

  • Passarelas de vidro entre torres de escritórios à noite, iluminadas por dentro.

    Interfaces e canais

    Canais agrupados pelo que fazem: o que sai do sistema SAP, o que roda mais tarde, o que grava no SAP standard e onde há acoplamento oculto. Classificados como IDoc, RFC, BAPI, batch input, tarefa de atualização, HTTP, arquivo, memória compartilhada, pagamento e BAdI, cada um com o número de objetos customizados que o usam.

  • Um dono de processo assinando um documento de validação encadernado.

    Validação e aprovação formal

    Um documento de processo (Pacote de validação) descreve um processo de ponta a ponta em oito seções fixas. Três controles automáticos rodam antes que o seu especialista o veja, e nenhum pode ser pulado nem dispensado. O seu especialista no assunto confirma os pontos marcados como SME-REVIEW-REQUIRED e dá a aprovação formal, com a qual o documento é publicado.

07Como funciona

De um programa somente leitura à documentação que suas equipes conferem.

Quatro etapas. Cada uma produz algo que você pode abrir e inspecionar.

  1. ExportarUm programa ABAP somente leitura, instalado como objeto local em cerca de 5 minutos, sem ordem de transporte. Ele lê código, definições do dicionário e configuração, e nenhum dado transacional nem nome de usuário.
  2. Grafo de evidênciasCada relação armazena arquivo, linha e nível de confiança, e é rotulada com a forma como foi estabelecida. O que não pode ser resolvido é listado, não forçado no grafo.
  3. VerificarUm verificador do grafo confronta cada relação com sua linha de código-fonte ou linha exportada. Um auditor de citações determinístico reconfere cada tag. Sem IA nesta etapa.
  4. Documentar e confirmarO catálogo e o mapa de processos são gerados sem IA e disponibilizados em um aplicativo web em inglês, espanhol e português. Em seguida vêm os documentos de processo, redigidos com IA somente mediante a sua autorização registrada e publicados quando o seu especialista dá a aprovação formal.

Piloto

1 dia da exportação à documentação4

  1. 4

    “1 dia” vai da exportação à documentação; os documentos de processo levam mais tempo. Inclui o grafo de evidências, o catálogo e o aplicativo web. Os Pacotes de validação exigem execuções de IA e a aprovação formal do especialista.

Como funciona, etapa por etapa

08Para quem é

O que cada equipe recebe.

Negócio

  • Dono do processo

    Seu processo descrito de ponta a ponta em um documento de processo, com as perguntas em aberto marcadas para você. Sua aprovação formal o publica.

  • Analista funcional

    O que inicia cada processo, quais tabelas ele lê e altera e quais interfaces alcança, cada item com sua evidência. O Ask AI responde a perguntas em linguagem simples, com evidências numeradas.

  • Auditoria e compliance

    Qual código grava em tabelas de pagamentos e de finanças, quais objetos de autorização ele verifica e quais interfaces existem, cada item com sua citação.

  • Líder de transformação SAP S/4HANA

    Um inventário por área de negócio e por processo: o que existe, como roda e do que depende, para que o escopo de remediação se apoie em dados.

TI

  • Líder de CoE SAP e TI

    Cada objeto customizado inventariado, um registro de cobertura que contabiliza o que foi documentado em relação ao que foi exportado e uma reconstrução reverificada após cada nova exportação.

  • Desenvolvedor ABAP e equipe AMS

    Lista de utilização nos dois sentidos, árvores de chamadas, pontos de entrada e o impacto de uma alteração, cada um até a linha citada. Documentação de transição que pode ser verificada.

Uma sala de planejamento de migração, com as paredes cobertas de cartões agrupados por área de negócio.

Três momentos em que todos precisam dos mesmos fatos.

  1. SAP S/4HANA e clean core

    O que existe, como roda e do que depende: um escopo de remediação menor e decisões baseadas em dados.

  2. Transição de AMS

    A documentação de transição já existe e pode ser verificada, para que o novo fornecedor confira o que está assumindo.

  3. Auditoria e compliance

    Qual código grava em tabelas de pagamentos e de finanças, quais autorizações ele verifica, quais interfaces existem. Para leitores de fora da sua empresa, como auditores externos, o visualizador de código-fonte pode mascarar nomes e IDs de usuário.

Esses benefícios são qualitativos. Não os medimos em percentuais, horas ou retorno sobre o investimento.

Ver os cinco casos de uso

09Segurança e dados

Somente leitura por design. IA só com a sua autorização.

Para as suas equipes de segurança e de proteção de dados, sem rodeios. Nenhum selo que não tenhamos.

Segurança e dados, por completo

  • Exportação somente leitura

    Um único programa ABAP, instalado como objeto local, sem ordem de transporte. Ele não contém nenhum INSERT, UPDATE, MODIFY, DELETE ou COMMIT de banco de dados e precisa de autorizações de exibição, além da permissão para gravar seus arquivos de exportação.

  • Sem dados transacionais nem nomes de usuário

    Ele lê código, definições do dicionário e configuração, nunca pedidos, faturas ou lançamentos. As colunas de autor e de “modificado por”, assim como todas as demais colunas com nomes de usuário, são removidas.

  • IA só com a sua autorização registrada

    O grafo, o catálogo e o mapa de processos são construídos sem IA. Os documentos de processo e o Ask AI só rodam com a sua autorização explícita e registrada; o Ask AI vem desativado por padrão. Antes de qualquer etapa de IA, os dados pessoais em comentários e strings são mascarados.

  • Login obrigatório

    Todas as páginas e APIs do aplicativo web exigem login. As contas são criadas por um administrador; não há autocadastro.

Uma caixa de arquivo lacrada e um disco externo, amarrados por um fio verde-limão.

10Idiomas

Documentação em inglês, espanhol e português.

O aplicativo web e o catálogo estão disponíveis em inglês, espanhol e português, assim como as demonstrações e o suporte.

  • Nomes de objetos SAP, código, nomes de tabelas e de campos, tags de citação e textos exportados do SAP nunca são traduzidos.
  • Os documentos de processo são redigidos e passam pelos controles em inglês. A versão em espanhol é uma tradução automática, marcada como verificada somente depois que cada citação, trecho de código, número e tabela é confirmado sem alterações e que um modelo revisor confere o sentido.
Uma equipe multilíngue em uma sala de reunião em São Paulo, na hora dourada.

11FAQ

Perguntas para fazer antes de começar.

Isso é process mining?

Não. O CodeGraphAI for SAP nunca lê pedidos, faturas ou lançamentos; por isso, não mostra quantos pedidos passam por um processo nem quanto tempo levam. Ele documenta como o seu sistema foi construído para executar cada processo: o que o inicia, o que o seu código faz e com quais tabelas e interfaces ele interage. Cada linha factual traz sua citação.

Documenta o SAP standard ou só o que construímos?

O que a sua empresa construiu em torno do SAP standard: o seu código customizado e a configuração, as transações, as telas e os jobs que o iniciam ou o conectam. Ele também registra as definições das tabelas SAP que o seu código usa e, a partir do índice da lista de utilização do SAP, o código SAP que chama o seu. As chamadas a módulos de função e BAPIs do SAP são mostradas; o que eles fazem internamente, não. Ele nunca lê o código-fonte do SAP standard, exceto os includes de user exit que você listar na tela de seleção.

Quem decide o sentido de um processo?

Seus especialistas. O catálogo afirma o que o código e a configuração fazem e onde, nunca a finalidade de negócio, e o mapa de processos vem identificado como proposta. Um documento de processo só é publicado depois que o seu especialista no assunto confirma os pontos marcados como SME-REVIEW-REQUIRED e dá a aprovação formal.

O que a exportação lê e o que sai do nosso sistema?

O seu código-fonte customizado, as definições do Dicionário ABAP (a estrutura, não o conteúdo das tabelas), o índice da lista de utilização do SAP, transações, telas, jobs em background e configuração de processos, como IDoc, pagamento e DMEE, BAdI e CMOD. Nenhum dado transacional e nenhum nome de usuário. Você entrega o arquivo compactado da exportação para análise. As etapas de IA enviam fatos do código e trechos mascarados do código-fonte a provedores externos de IA (OpenAI ou Anthropic), e somente com a sua autorização registrada. Sobre hospedagem e retenção, fale conosco.

Quanto tempo leva?

A instalação do programa de exportação leva cerca de 5 minutos. No piloto, em um sistema SAP S/4HANA produtivo, levou 1 dia da exportação à documentação: o grafo de evidências, o catálogo e o aplicativo web. Os documentos de processo levam mais tempo, porque exigem execuções de IA e a aprovação formal do seu especialista.

Como a documentação se mantém atualizada?

Não existe conexão permanente com o SAP. Após cada release, você executa a exportação novamente. A nova documentação é construída e verificada à parte, em cada idioma, antes de entrar em produção; a versão anterior é arquivada e pode ser restaurada. Contas de usuário, aprovações e documentos de processo são mantidos; um documento de processo gerado novamente precisa passar pelos controles outra vez.

Panorama ao entardecer de uma cidade latino-americana e seu porto, com os bairros ligados por linhas de luz.

Traga suas perguntas sobre como seus processos rodam.

Uma demonstração guiada com nossa equipe: o aplicativo web, o grafo de evidências e uma página do catálogo com citações no nosso sistema de demonstração sintético, e depois suas perguntas. Cerca de 30 a 45 minutos, em inglês, espanhol ou português. Respondemos por e-mail para agendá-la.

Solicitar demoVer um exemplo real

ou escreva para hello@codegraphai.com