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) |