Comando IMPORT SAP

Cria uma tabela do Analytics importando dados de um sistema SAP usando o Direct Link.

Nota

O comando IMPORT SAP somente será permitido se o Direct Link estiver instalado e configurado no computador local e no sistema SAP da organização.

Sintaxe

IMPORT SAP PASSWORD num TO nome_tabela SAP SOURCE "SAP AGENT" detalhes_importação

Parâmetros

Nome Descrição
PASSWORD num

A definição de senha a ser usada.

PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD.

num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de um script de análise, PASSWORD 2 especifica o uso da senha nº 2.

Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte:

Nota

A senha é usada para acessar o sistema SAP.

TO nome_tabela

O nome da tabela do Analytics na qual os dados serão importados.

Nota

Os nomes de tabela são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

SAP SOURCE "SAP AGENT"

Obrigatório para importar dados do SAP. "SAP AGENT" é a única opção disponível.

detalhes_importação

Os detalhes da consulta. Deve estar entre as tags <q></q> e usar as tags listadas na Tags de consulta do Direct Link para definir a consulta.

O tamanho físico desse valor pode ser até 16 KB.

Exemplos

Execução de consulta de várias tabelas

Este exemplo executa uma consulta em várias tabelas usando o comando IMPORT SAP.

A ordem e o aninhamento corretos das tags são necessários para criar uma cadeia de consulta válida. As tags no exemplo são ordenadas e aninhadas corretamente. Use esse exemplo para determinar a ordem e o aninhamento necessários das tags de consulta do IMPORT SAP.

Nota

Para facilitar a leitura, esse exemplo está formatado em diversas linhas. No script, o comando e a cadeia de consulta devem ser inseridos sem quebras de linha.

Dica

Normalmente, a sintaxe de uma cadeia de comando IMPORT SAP é complexa. A melhor maneira de adicionar comandos IMPORT SAP com cadeias de consulta a seus scripts é copiar um comando IMPORT SAP existente da guia Log no Analytics e depois editar as tags de consulta conforme a necessidade.

IMPORT SAP PASSWORD 1 TO Doc_compra SAP SOURCE "SAP AGENT"
<q version="6.0">
  <s>0</s>
  <d>IDES</d>
  <u>mzunini</u>
  <c>800</c>
  <lg>en</lg>
  <cf>C:\ACL Data\Doc_compra.fil</cf>
  <sf>E:\Data\DL_JSMITH111107.DAT</sf>
  <jcount>11110701</jcount>
  <jname>DL_JSMITH111107.DAT</jname>
  <dl>75</dl>
  <m>2</m>
  <dt>20140321</dt>
  <tm>033000</tm>
  <r>500</r>
  <ar>0</ar>
  <e>500</e>
  <ts>
    <t>
      <n>EKKO</n>
      <a>T00001</a>
      <td>Cabeçalho do documento de compra</td>
      <fs>
        <f>EBELN</f>
        <f>BUKRS</f>
        <f>BSTYP</f>
        <f>BSART</f>
        <f>STATU</f>
        <f>WKURS</f>
      </fs>
      <wc>
        <w>
           <f>BUKRS</f>
           <o>0</o>
           <l>1000</l>
           <h></h>
        </w>
      </wc>
    </t>
    <t>
      <n>EKPO</n>
      <a>T00002</a>
      <td>Item do documento de compra</td>
      <fs>
        <f>EBELP</f>
        <f>WERKS</f>
        <f>MENGE</f>
        <f>BRTWR</f>
      </fs>
      <wc></wc>
    </t>
  </ts>
  <js>
    <jc>
      <pt>
        <pa>T00001</pa>
        <pf>EBELN</pf>
      </pt>
      <ct>
        <ca>T00002</ca>
        <cf>EBELN</cf>
      </ct>
    </jc>
  </js>
</q>

Observações

A tabela em Tags de consulta do Direct Link lista as tags que podem ser incluídas no parâmetro detalhes_importação. A coluna Obrigatório usa os seguintes valores para indicar quando as tags devem estar presentes:

  • Y Obrigatório
  • N Opcional
  • M Obrigatório somente para consultas em várias tabelas
  • B Obrigatório, mas nenhum valor deve ser passado
  • W Opcional quando os filtros são usados
  • S Obrigatório quando o modo agendado é especificado

Tags de consulta do Direct Link

Nome

Tag

Obrigatório

Descrição

Nome alternativo da tabela:

<a>

M

O nome alternativo que identifica a tabela dentro da consulta. Isso permite que a mesma tabela seja usada mais de uma vez.

O comprimento máximo é 6 caracteres.

Todas as linhas

<ar>

Y

Indica que todas as linhas correspondentes devem ser retornadas como parte do conjunto de resultados da pesquisa.

Os valores válidos são:

1 Substitui o número de registros especificado na tag <r> (Máximo de linhas)

0 Retorna o número de registros especificado na tag <r> (Máximo de linhas)

Esta tag sempre aparece após a tag <r></r>.

Cliente

<c>

N

O cliente no sistema SAP.

Nome alternativo da tabela filha

<ca>

M

O nome alternativo da tabela filha.

Campo da tabela filha

<cf>

M

O campo na tabela filha no qual a condição de associação está baseada.

Nome do arquivo do cliente

<cf>

Y

Identifica o arquivo alvo no sistema do cliente onde os resultados da consulta serão armazenados.

Tabela filha

<ct>

M

A tabela filha na condição de associação.

Destino

<d>

N

Identifica um destino no arquivo de biblioteca do SAP RFC (sapnwrfc.ini), usado para localizar um sistema SAP.

Comprimento dos dados

<dl>

B

O número de caracteres em cada linha, incluindo os caracteres de retorno de carro e quebra de linha indicando o final do registro (CR+LF ou os caracteres hexadecimais 0D+0A).

Data <dt> S

Obrigatório quando o modo agendado é usado. Especifica o momento para a execução da tarefa do SAP.

Deve ser formatado como AAAAMMDD. Por exemplo, 31 de dezembro de 2014 deve ser especificado como 20141231.

Linhas esperadas

<e>

B

O número esperado de linhas que a consulta retornará.

Nome do campo

<f>

Y

O nome do campo nativo.

Campo do filtro

<f>

W

O nome do campo nativo em que o filtro é aplicado.

Campos

<fs>

Y

A lista de campos na tabela que será retornada como parte dos resultados de consulta.

Valor alto

<h>

W

Contém o valor alto ao usar o operador BETWEEN. Ignorado ao usar qualquer outro operador.

Condição de associação

<jc>

M

A condição de associação.

Contagem de tarefas

<jcount>

B

Usada internamente pelo SAP para identificar uma consulta em modo de segundo plano.

Nome da tarefa

<jname>

B

Usada internamente pelo SAP para identificar uma consulta em modo de segundo plano.

Relações de associação

<js>

Y

A lista de condições de associação que liga tabelas com a consulta.

Indicador de associação <jw> N

Equivalente numérico do tipo enumerado indicador de associação.

Os valores válidos são:

0 Associação interna

1 Associação externa esquerda

Valor baixo

<l>

W

Contém o valor mais baixo ao usar o operador BETWEEN ou o valor ao usar qualquer outro operador.

Idioma

<lg>

Y

Identificador de idioma usado para determinar o local dos campos no banco de dados SAP.

Modo

<m>

Y

Equivalente numérico do tipo enumerado do modo de envio.

Os valores válidos são:

0 Extrair agora

1 Segundo plano

2 Agendado

Nome da tabela

<n>

Y

O nome da tabela nativa.

Operador

<o>

W

Equivalente numérico do tipo enumerado do operador.

Os valores válidos são:

0 Igual a (=)

1 Não igual a (<>)

2 Menor que (<)

3 Menor ou igual a (<=)

4 Maior que (>)

5 Maior ou igual a (>=)

6 Entre

7 Contém

Nome alternativo da tabela pai

<pa>

M

O nome alternativo da tabela pai.

Campo da tabela pai

<pf>

M

O campo na tabela pai no qual a condição de associação está baseada.

Tabela pai

<pt>

M

A tabela pai na condição de associação.

Consulta

<q>

Y

Delimita uma consulta.

Máximo de linhas

<r>

Y

O número máximo de linhas que a consulta deve retornar.

Selecionado

<s>

Y

Se a tag <s> aparecer abaixo da tag <f>, isso indicará se o campo será retornado como parte do conjunto de resultados da consulta.

Sistema

<s>

Y

Se a tag <s> aparecer abaixo da tag <q>, ela identificará o tipo de sistema em relação ao qual essa consulta é usada (no momento, apenas SAP é suportado).

Nome do arquivo do servidor

<sf>

B

Identifica o arquivo no servidor que guarda os resultados da consulta em modo de segundo plano.

Nome do grupo de servidores <sg> N O nome do grupo de servidores. Máximo de 20 caracteres.
Nome do Servidor <sn> N O nome do servidor. Máximo de 20 caracteres.

Tabela

<t>

Y

A tabela.

Descrição da tabela

<td>

Y

A descrição da tabela do dicionário de dados SAP. Ela deve sempre aparecer abaixo da tag <a>.

Tempo <tm> S

Obrigatório quando o modo agendado é usado. Especifica o momento para a execução da tarefa do SAP.

Deve ser formatado como hhmmss. Por exemplo, 14h30 deve ser especificado como 143000.

Tabelas

<ts>

Y

A lista de tabelas das quais a consulta extrairá os dados.

Tipo de tabela <tt> Y

O tipo da tabela do SAP.

Os valores válidos são:

0 em cluster

1 transparente

2 em pool

3 exibição

Nome de usuário

<u>

N

O nome de logon do usuário.

Filtro

<w>

W

O filtro aplicado aos dados da tabela.

Filtros

<wc>

W

A lista de filtros que serão aplicados aos dados contidos na tabela.

Indicador de filtro <ws> N

Equivalente numérico do tipo enumerado indicador de filtro.

Os valores válidos são:

0 (Or) And (Or)

1 (And) Or (And)