Extrações Ad Hoc do SAP ECC / S/4HANA

Extraia dados do SAP ECC ou do S/4HANA por si, partindo do que já conhece: o nome de uma tabela, um código de transação ou uma SAP Query guardada. Escolhe o objeto numa pesquisa, vê os respetivos campos ou o ecrã de seleção, pré-visualiza linhas reais, verifica o plano e guarda um passo de fluxo de trabalho que carrega o resultado numa tabela.

Cada extração é executada através do seu agente PlaidLink e do pacote SAP do PlaidCloud, como o utilizador RFC da ligação, sob as verificações de autorização do próprio SAP.

Pré-requisitos

• Um agente PlaidLink com acesso de rede ao sistema SAP. Consulte Instalar o PlaidLink.
• Uma ligação Instância SAP ECC / S/4HANA. Consulte Conector SAP ECC e S/4HANA. O utilizador SAP dessa ligação é o utilizador RFC com o qual cada extração é executada.
• O pacote SAP do PlaidCloud instalado no SAP. A sua equipa SAP Basis instala-o uma vez por sistema SAP.
• Autorizações SAP para o utilizador RFC sobre os objetos que extrai. Consulte Autorizações SAP.

Escolher um Passo

Os três passos encontram-se no menu de passos do fluxo de trabalho, em SAP.

Passo	Utilize-o para
SAP: Extração ad hoc	Ler uma tabela SAP, na totalidade 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 carregar o respetivo resultado.
SAP: Executar consulta (SQ01)	Executar uma SAP Query guardada e carregar o respetivo resultado.

Todos os passos começam com os mesmos três campos — Agente, Ligação SAP e uma Tabela de destino para o resultado.

Encontrar um Objeto SAP

Com um agente e uma ligação selecionados, a pesquisa do passo lista os objetos SAP correspondentes — Tabelas, Transações ou Consultas, consoante o passo. Escreva um nome, um código de transação ou palavras da descrição. Os carateres universais * do SAP funcionam. Um objeto que o SAP não disponibiliza continua a aparecer, a cinzento, com o motivo.

Ao escolher uma tabela, são listados os respetivos campos com as descrições e são preenchidos os campos-chave. Ao escolher uma transação, um relatório ou uma consulta, é mostrado o respetivo ecrã de seleção no separador Filtros, construído a partir dos campos que o próprio SAP definiu para esse objeto — sem necessidade de conhecer os detalhes internos da tabela ou do programa.

Extrair uma Tabela

Utilize SAP: Extração ad hoc.

1. No separador Extração SAP, pesquise a tabela e escolha-a.

2. Introduza a Função de leitura RFC — a função de leitura de tabelas do pacote SAP do PlaidCloud, tal como a sua equipa Basis a instalou.

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

4. No separador Filtro delimitador, adicione filtros. Clique numa coluna conhecida para adicionar uma linha, escolha Incluir ou Excluir, escolha um Operador — igual, diferente, maior que, maior ou igual a, menor que, menor ou igual a, entre, não entre, contém padrão ou não contém padrão — e utilize 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 SAP grande requer 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 do que uma condição na mesma coluna enviam ao SAP um predicado de filtro mais rico, que requer o pacote SAP do PlaidCloud atual no sistema SAP do agente. Um pacote mais antigo continua a executar filtros simples de igualdade, desigualdade e intervalo numa linha Incluir ou Excluir; peça à sua equipa Basis que atualize o pacote se um filtro mais rico não surtir efeito.

5. Para ler apenas linhas novas e alteradas em cada execução, configure o separador Incremental. Consulte Extrações Incrementais de Tabelas.

6. No separador Visibilidade e definição, defina a Coluna regida. Consulte Coluna Regida.

Uma coluna de montantes CURR cuja chave de moeda esteja na mesma tabela é carregada com o seu valor real. O PlaidCloud desloca cada montante segundo as casas decimais da respetiva moeda, pelo que um montante em ienes japoneses é carregado em ienes inteiros. Uma coluna de montantes sem a respetiva chave de moeda é carregada tal como o SAP a armazena, e a execução comunica um aviso que nomeia a coluna.

Mandante SAP (mandt) e Tamanho da fatia são opcionais. Deixe o mandante em branco para utilizar o mandante predefinido da ligação.

Executar uma Transação ou um Relatório

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

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

2. No separador Filtros, preencha o ecrã de seleção. O formulário constrói-o a partir do ecrã de seleção SAP da própria transação ou do próprio relatório. Um campo em branco executa sem filtro nesse campo.

   Para partir de uma variante SAP guardada, escolha-a em Começar a partir de uma variante SAP. O PlaidCloud preenche o formulário de filtros com os valores guardados da variante e lista, ao lado do formulário, os valores da própria variante que não conseguiu transpor — nesses casos, o SAP utiliza o valor predefinido do próprio relatório. Escolher uma variante diferente substitui os valores do formulário; editar um campo depois não altera a variante apresentada como selecionada.

3. Defina Máx. de linhas — 10 000 por predefinição, até 50 000. O SAP executa sempre a transação ou o relatório completos, 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, indique um Nome da tarefa (apenas assíncrono).

5. No separador Visibilidade e definição, defina a Coluna regida.

Um relatório que requer introdução interativa, uma janela de diálogo ou um ecrã não pode ser executado sem supervisão. O SAP recusa-o, nada é carregado e o passo comunica o motivo do SAP. Execute esse relatório no SAP GUI.

Executar uma SAP Query

Utilize SAP: Executar consulta (SQ01).

1. No separador Execução SAP, pesquise a consulta e escolha-a. Ao escolher uma consulta, são preenchidos Área de trabalho, Grupo de utilizadores e Nome da consulta. Também pode escolher a Área de trabalho e escrever diretamente o Grupo de utilizadores e o Nome da consulta.

2. No separador Filtros, preencha o ecrã de seleção da própria consulta — os mesmos parâmetros e select-options que o respetivo autor configurou no SQ01. Um campo em branco executa sem filtro nesse campo.

3. Defina Máx. de linhas — 10 000 por predefinição, até 50 000.

4. No separador Visibilidade e definição, defina a Coluna regida.

Alterar a Área de trabalho, o Grupo de utilizadores ou o Nome da consulta limpa um formulário de filtros construído para outra consulta — consulte novamente o ecrã de seleção depois de mudar.

Coluna Regida

Cada passo de extração SAP requer uma Coluna regida: uma das colunas que o passo carrega, como BUKRS para o código de empresa. O passo não é guardado sem uma e uma execução não carrega linhas a menos que essa coluna esteja entre as colunas carregadas.

Pré-visualização, Plano e Autorizações

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

Botão	O que mostra
Pré-visualização	Linhas de amostra. A pré-visualização de uma tabela lê diretamente as primeiras linhas. Para uma transação, um relatório ou uma consulta, a pré-visualização executa-a no SAP como uma amostra separada limitada a 100 linhas, pelo que o formulário pede primeiro a sua confirmação. Nada é carregado.
Plano	Como a extração é executada — as respetivas colunas-chave, a estimativa de linhas e a seleção enviada ao SAP — e tudo o que a impediria. Uma recusa do plano desativa Criar e executar e Guardar e executar até alterar a configuração ou até um novo plano voltar sem problemas. Pode continuar a guardar o passo.
Autorizações SAP necessárias	As autorizações SAP de que o objeto necessita, para partilhar com a sua equipa Basis. Esta lista é meramente informativa.

Cuidado

A pré-visualização de uma transação, de um relatório ou de uma consulta custa ao SAP aproximadamente o mesmo que uma execução real, porque o SAP executa tudo antes de devolver quaisquer linhas.

Autorizações SAP

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

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

Uma autorização em falta faz a execução falhar com o erro de não autorizado do SAP e uma indicação de correção que lista as concessões anteriores. O PlaidCloud não acrescenta verificações de permissões próprias e nunca bloqueia um passo com base na lista Autorizações SAP necessárias.

Extrações Incrementais de Tabelas

No separador Incremental de SAP: Extração ad hoc, marque Run incrementally e introduza uma Coluna de marca-d’água. Tem de ser uma das seguintes:

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

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

A primeira execução lê a tabela completa. Cada execução seguinte lê apenas as linhas na última marca-d’água ou depois dela, menos o Retrocesso, e funde-as pelas colunas-chave. A marca-d’água só avança depois de a execução completa ser carregada. A data em aberto do SAP 99991231 nunca se torna a marca-d’água. Uma data mais de um dia posterior à data da execução mantém a marca-d’água na data da execução, e uma data/hora nunca a move para além do início da execução.

Como as Colunas São Carregadas

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

Tipo SAP	Carregado como
Data (DATS)	Data. Datas em branco, iniciais e inválidas são carregadas como vazias (NULL). Uma data inválida conclui o passo com um aviso.
Montante, quantidade, decimal (CURR / QUAN / DEC)	Decimal exato. Quando a coluna da chave de moeda do montante está na mesma tabela e na extração, o PlaidCloud desloca o montante segundo as casas decimais reais da moeda. Caso contrário, é carregado tal como o SAP o armazena. Um decimal com mais de 10 casas decimais, mais de 28 dígitos inteiros ou sem casas decimais declaradas é carregado como texto, e o passo conclui com um aviso que nomeia a coluna.
Inteiro	Inteiro.
Vírgula flutuante (FLTP)	Double.
Vírgula flutuante decimal (DF16_* / DF34_*)	Texto exato.
Data/hora UTC curta (TZNTSTMPS)	Data/hora, ao segundo.
Data/hora UTC longa (TZNTSTMPL, UTCL)	Texto ISO UTC, como 2026-01-03T10:15:00.123456Z — mantém a fração que uma coluna de data/hora perderia.
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 completa pelo novo tipo da coluna e o passo conclui com um aviso que nomeia a coluna. Uma extração incremental faz isto na mesma execução. Se essa leitura não terminar, as execuções seguintes continuam a ler a tabela completa, com o mesmo aviso, até uma ter êxito — depois, as execuções incrementais são retomadas.

SAP: Executar transação / relatório carrega as colunas de montantes como números. Todas as outras colunas são carregadas como texto. SAP: Executar consulta (SQ01) carrega as colunas de montante, inteiro e data com esses tipos. Todas as outras colunas são carregadas como texto. Converta os tipos num passo a jusante quando necessitar deles.

Limites de Execução

Uma única execução de SAP: Extração ad hoc é pausada depois de ler 5 000 000 de linhas ou de ser executada durante 240 minutos, após concluir a fatia em curso. O passo termina com um aviso, não com uma falha, e a execução seguinte continua onde ficou, sem perda de linhas.

Relacionado

• Conector SAP ECC e S/4HANA — os campos da ligação.
• Passos SAP — todos os passos de fluxo de trabalho SAP.
• PlaidLink — instalação e atualização de agentes.