Extrações ad hoc do SAP ECC / S/4HANA

Extraia você mesmo dados do SAP ECC ou do S/4HANA, partindo do que você já conhece: um nome de tabela, um código de transação ou uma SAP Query salva. Você escolhe o objeto em uma pesquisa, vê os campos ou a tela de seleção, pré-visualiza linhas reais, confere o plano e salva uma etapa de fluxo de trabalho que grava o resultado em uma tabela.

Toda extração passa pelo seu agente PlaidLink e pelo pacote SAP do PlaidCloud, como o usuário RFC da conexão, sob as próprias verificações de autorização do SAP.

Pré-requisitos

• Um agente PlaidLink com acesso de rede ao sistema SAP. Consulte Instalar o PlaidLink.
• Uma conexão de Instância SAP ECC / S/4HANA. Consulte Conector SAP ECC e S/4HANA. O usuário SAP dessa conexão é o usuário RFC com o qual toda extração é executada.
• O pacote SAP do PlaidCloud instalado no SAP. Sua equipe de Basis do SAP o instala uma vez por sistema SAP.
• Autorizações do SAP para o usuário RFC nos objetos que você extrai. Consulte Autorizações do SAP.

Escolher uma etapa

As três etapas ficam no menu de etapas do fluxo de trabalho, em SAP.

Etapa	Use para
SAP: Extração ad hoc	Ler uma tabela do SAP, por completo ou de forma incremental.
SAP: Executar transação / relatório	Executar um código de transação ou um programa de relatório ABAP e gravar o resultado.
SAP: Executar consulta (SQ01)	Executar uma SAP Query salva e gravar o resultado.

Toda etapa começa com os mesmos três campos: Agente, Conexão SAP e uma Tabela de destino para o resultado.

Encontrar um objeto SAP

Com um agente e uma conexão selecionados, a pesquisa da etapa lista os objetos SAP correspondentes: Tabelas, Transações ou Consultas, dependendo da etapa. Digite um nome, um código de transação ou palavras da descrição. Os curingas * do SAP funcionam. Um objeto que o SAP não atende ainda aparece, esmaecido, com o motivo.

Ao escolher uma tabela, são listados seus campos com as descrições e seus campos-chave são preenchidos. Ao escolher uma transação, um relatório ou uma consulta, sua tela de seleção aparece na guia Filtros, montada a partir dos campos que o próprio SAP definiu para esse objeto, sem exigir detalhes internos de tabelas ou programas.

Extrair uma tabela

Use SAP: Extração ad hoc.

1. Na guia Extração SAP, pesquise a tabela e escolha-a.

2. Informe a Função de leitura RFC: a função de leitura de tabela do pacote SAP do PlaidCloud, conforme instalada pela sua equipe de Basis.

3. Verifique as Colunas-chave. O PlaidCloud as preenche com a chave primária da tabela a partir do dicionário de dados do SAP, excluindo o campo de cliente. Marque a caixa que afirma que elas são exatamente a chave primária. O SAP recusa qualquer outro conjunto de colunas.

4. Na guia Filtro delimitador, adicione filtros. Clique em uma coluna conhecida para adicionar uma linha, escolha Incluir ou Excluir, selecione um Operador (igual, diferente, maior que, maior ou igual, menor que, menor ou igual, entre, não entre, contém padrão ou não contém padrão) e use a ajuda de valores para escolher valores válidos diretamente do SAP. Adicione várias linhas para a mesma coluna para corresponder a qualquer um de um conjunto de valores e adicione um intervalo para Entre ou Não entre. Uma tabela grande do SAP exige pelo menos um filtro, como um intervalo de datas ou um código de empresa.

   Nota

   Excluir um intervalo, um filtro Não entre, a correspondência de padrões e mais de uma condição na mesma coluna enviam ao SAP um predicado de filtro mais elaborado, que exige o pacote SAP atual do PlaidCloud no sistema SAP do agente. Um pacote mais antigo ainda executa filtros simples de igualdade, desigualdade e intervalo, tanto em uma linha Incluir quanto em uma linha Excluir; peça à sua equipe de Basis que atualize o pacote se um filtro mais elaborado não surtir efeito.

5. Para ler apenas as linhas novas e alteradas em cada execução, configure a guia Incremental. Consulte Extrações incrementais de tabelas.

6. Na guia Visibilidade e definição, defina a Coluna governada. Consulte Coluna governada.

Uma coluna de valor CURR cuja chave de moeda esteja na mesma tabela é gravada com o valor verdadeiro. O PlaidCloud desloca cada valor pelas casas decimais da moeda correspondente, de modo que um valor em iene japonês é gravado em ienes inteiros. Uma coluna de valor sem a chave de moeda é gravada como o SAP a armazena, e a execução informa um aviso nomeando a coluna.

Cliente SAP (mandt) e Tamanho da fatia são opcionais. Deixe o cliente em branco para usar o cliente padrão da conexão.

Executar uma transação ou um relatório

Use SAP: Executar transação / relatório.

1. Na guia Execução SAP, pesquise uma transação e escolha-a, ou digite o nome de um programa de relatório em Report/Program e clique em Consultar tela de seleção. Escolha uma opção ou a outra.

2. Na guia Filtros, preencha a tela de seleção. O formulário a monta a partir da própria tela de seleção do SAP da transação ou do relatório. Um campo em branco é executado sem filtro nesse campo.

   Para partir de uma variante salva do SAP, escolha-a em Iniciar a partir de uma variante SAP. O PlaidCloud preenche o formulário de filtros com os valores armazenados da variante e lista, ao lado do formulário, os valores da própria variante que não pôde transferir; para esses, o SAP usa o padrão do próprio relatório. Escolher outra variante substitui os valores do formulário; editar um campo depois disso não altera qual variante aparece como selecionada.

3. Defina Máximo de linhas: 10.000 por padrão, até 50.000. O SAP executa a transação ou o relatório inteiro de qualquer forma, e o limite restringe as linhas que o PlaidCloud lê de volta.

4. Para um relatório de longa duração, marque Run as a background job e, opcionalmente, informe um Nome do job (somente assíncrono).

5. Na guia Visibilidade e definição, defina a Coluna governada.

Um relatório que exige entrada interativa, um pop-up ou uma tela não pode ser executado sem supervisão. O SAP o recusa, nada é gravado e a etapa informa o motivo do SAP. Execute esse relatório no SAP GUI.

Executar uma SAP Query

Use SAP: Executar consulta (SQ01).

1. Na guia Execução SAP, pesquise a consulta e escolha-a. Ao escolher uma consulta, são preenchidos Espaço de trabalho, Grupo de usuários e Nome da consulta. Você também pode escolher o Espaço de trabalho e digitar diretamente o Grupo de usuários e o Nome da consulta.

2. Na guia Filtros, preencha a tela de seleção da própria consulta: os mesmos parâmetros e select-options que o autor definiu no SQ01. Um campo em branco é executado sem filtro nesse campo.

3. Defina Máximo de linhas: 10.000 por padrão, até 50.000.

4. Na guia Visibilidade e definição, defina a Coluna governada.

Alterar o Espaço de trabalho, o Grupo de usuários ou o Nome da consulta limpa um formulário de filtros criado para outra consulta; consulte a tela de seleção novamente depois de trocar.

Coluna governada

Toda etapa de extração do SAP exige uma Coluna governada: uma das colunas que a etapa grava, como BUKRS para o código da empresa. A etapa não é salva sem ela, e uma execução não grava nenhuma linha a menos que essa coluna esteja entre as colunas gravadas.

Pré-visualização, plano e autorizações

O grupo Verificação prévia de cada etapa tem três botões. Nenhum deles impede salvar a etapa.

Botão	O que mostra
Pré-visualização	Linhas de exemplo. A pré-visualização de uma tabela lê as primeiras linhas diretamente. Para uma transação, um relatório ou uma consulta, a pré-visualização o executa no SAP como uma amostra separada limitada a 100 linhas; por isso, o formulário pede que você confirme antes. Nada é gravado.
Plano	Como a extração é executada: suas colunas-chave, a estimativa de linhas e a seleção enviada ao SAP, além de qualquer coisa que a impediria. Uma recusa do plano desabilita Criar e executar e Salvar e executar até que você altere a configuração ou que um novo plano volte sem problemas. Você ainda pode salvar a etapa.
Autorizações do SAP necessárias	As autorizações do SAP de que o objeto precisa, para compartilhar com sua equipe de Basis. Esta lista é apenas informativa.

Cuidado

Pré-visualizar uma transação, um relatório ou uma consulta custa ao SAP praticamente o mesmo que uma execução real, porque o SAP executa tudo antes de retornar qualquer linha.

Autorizações do SAP

As verificações de autorização padrão do SAP se aplicam ao usuário RFC, exatamente como dentro do SAP.

Extração	Autorização
Tabela	S_TABU_NAM ou S_TABU_DIS exibição, atividade 03
Transação	S_TCODE
Relatório	S_PROGRAM SUBMIT para o grupo de autorização do relatório

Uma autorização ausente faz a execução falhar com o erro de não autorizado do SAP e uma correção que lista as concessões anteriores. O PlaidCloud não adiciona nenhuma verificação de permissão própria e nunca bloqueia uma etapa com base na lista Autorizações do SAP necessárias.

Extrações incrementais de tabelas

Na guia Incremental de SAP: Extração ad hoc, marque Run incrementally e informe uma Coluna de marca-d’água. Ela deve ser uma destas:

• Uma coluna de data, tipo SAP DATS
• Uma coluna de carimbo de data/hora UTC, tipo SAP TZNTSTMPS ou TZNTSTMPL

Colunas de carimbo de data/hora do tipo SAP UTCL não são suportadas, e a coluna de marca-d’água também não pode ser uma coluna de filtro delimitador.

A primeira execução lê a tabela inteira. Cada execução seguinte lê apenas as linhas na marca-d’água mais recente ou após ela, menos o Retrocesso, e as mescla pelas colunas-chave. A marca-d’água só avança depois que toda a execução é gravada. A data em aberto 99991231 do SAP nunca se torna a marca-d’água. Uma data com mais de um dia após a data da execução mantém a marca-d’água na data da execução, e um carimbo de data/hora nunca a move além do início da execução.

Como as colunas são gravadas

SAP: Extração ad hoc grava cada coluna com seu tipo real do dicionário de dados do SAP.

Tipo SAP	Gravado como
Data (DATS)	Data. Datas em branco, iniciais e inválidas são gravadas vazias (NULL). Uma data inválida conclui a etapa com um aviso.
Valor, quantidade, decimal (CURR / QUAN / DEC)	Decimal exato. Quando a coluna da chave de moeda do valor está na mesma tabela e na extração, o PlaidCloud desloca o valor para as casas decimais verdadeiras da moeda. Caso contrário, ele é gravado como o SAP o armazena. Um decimal com mais de 10 casas decimais, mais de 28 dígitos inteiros ou sem casas decimais declaradas é gravado como texto, e a etapa é concluída com um aviso nomeando a coluna.
Inteiro	Inteiro.
Ponto flutuante (FLTP)	Double.
Float decimal (DF16_* / DF34_*)	Texto exato.
Carimbo de data/hora UTC curto (TZNTSTMPS)	Carimbo de data/hora, em segundos.
Carimbo de data/hora UTC longo (TZNTSTMPL, UTCL)	Texto ISO em UTC, como 2026-01-03T10:15:00.123456Z: isso preserva a fração que uma coluna de carimbo de data/hora descartaria.
Hora (TIMS), código (NUMC), texto (CHAR)	Texto exatamente como o SAP o armazena, com os zeros à esquerda mantidos.

Se o tipo SAP de uma coluna mudar, a extração substitui a tabela inteira com o novo tipo da coluna, e a etapa é concluída com um aviso nomeando a coluna. Uma extração incremental faz isso na mesma execução. Se essa leitura não for concluída, as execuções seguintes continuam lendo a tabela inteira, com o mesmo aviso, até que uma seja bem-sucedida; então as execuções incrementais são retomadas.

SAP: Executar transação / relatório grava as colunas de valor como números. Todas as outras colunas são gravadas como texto. SAP: Executar consulta (SQ01) grava as colunas de valor, de inteiro e de data com esses tipos. Todas as outras colunas são gravadas como texto. Converta os tipos em uma etapa posterior onde precisar deles.

Limites de execução

Uma única execução de SAP: Extração ad hoc é pausada ao ler 5.000.000 de linhas ou ao atingir 240 minutos, depois de concluir a fatia em andamento. A etapa termina com um aviso, não com uma falha, e a próxima execução continua de onde parou, sem perda de linhas.

Relacionados

• Conector SAP ECC e S/4HANA: os campos da conexão.
• Etapas SAP: todas as etapas de fluxo de trabalho do SAP.
• PlaidLink: instalação e atualização de agentes.