Guide de création de scripts ACL 14.1

Commande IMPORT SAP

Crée une table Analytics en important des données à partir d'un système SAP à l'aide de Direct Link.

IMPORT SAP PASSWORD num TO nom_table SAP SOURCE "SAP AGENT" détails_importation
Nom Description
PASSWORD num

Définition de mot de passe à utiliser.

Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD.

num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un outil d'analyse, PASSWORD 2 indique que le mot de passe n° 2 est utilisé.

Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques :

Remarque

Le mot de passe est utilisé pour accéder au système SAP.

TO nom_table

Nom de la table Analytics dans laquelle les données doivent être importées.

Remarque

La longueur des noms des tables est limitée à 64 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

SAP SOURCE "SAP AGENT"

Requis pour importer des données SAP. "SAP AGENT" est la seule option disponible.

détails_importation

Les détails de la requête. Doit être placée entre des balises <q></q>. Elle utilise les balises répertoriées dans Balises de requête Direct Link pour définir la requête.

La taille physique de cette valeur peut atteindre 16 Ko.

Effectuer une requête sur plusieurs tables

Dans l'exemple suivant, une requête sur plusieurs tables est effectuée en utilisant la commande IMPORT SAP.

La création d'une chaîne de requête valide nécessite une imbrication et une séquence de balises correctes. Les balises de l'exemple sont ordonnées et imbriquées correctement. Reportez-vous à cet exemple pour déterminer l'ordre et l'imbrication appropriés des balises de requête IMPORT SAP.

Remarque

Pour augmenter sa lisibilité, cet exemple est mis en forme sur plusieurs lignes. Dans votre script, la commande et la chaîne de requête doivent être saisies sans saut de ligne.

Astuce

La syntaxe d'une chaîne de requête IMPORT SAP est généralement complexe. Pour ajouter des commandes IMPORT SAP avec des chaînes de requête à vos scripts, la meilleure méthode consiste à copier une commande IMPORT SAP existante depuis l'onglet Trace vers Analytics, puis de modifier les balises de requête selon vos besoins.

IMPORT SAP PASSWORD 1 TO Doc_achat 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_achat.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>En-tête document achat</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>Élément document achat</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>

La commande IMPORT SAP est prise en charge uniquement si Direct Link est installé et configuré.

Le tableau dans Balises de requête Direct Link répertorie les balises pouvant être incluses dans le paramètre détails_importation. La colonne Obligatoire utilise les valeurs suivantes pour indiquer lorsque les balises doivent être présentes :

  • Y Obligatoire
  • N Facultatif
  • M Obligatoire uniquement pour les requêtes sur plusieurs tables
  • B Obligatoire, mais aucune valeur ne doit être transmise
  • W Facultative lorsque des filtres sont utilisés
  • S Obligatoire lorsque le mode planifié est spécifié

Balises de requête Direct Link

Nom

Balise

Obligatoire

Description

Alias de table

<a>

M

L'alias qui identifie la table de façon unique dans la requête. Une même table peut ainsi être utilisée plusieurs fois.

La longueur maximale est de 6 caractères.

Toutes les lignes

<ar>

Y

Indique que toutes les lignes correspondantes doivent être renvoyées avec le jeu de résultats de la requête.

Les valeurs correctes sont :

1 Remplace le nombre d'enregistrements spécifié dans la balise <r> (Nombre maximal de lignes)

0 Renvoie le nombre d'enregistrements spécifié dans la balise <r> (Nombre maximal de lignes)

Cette balise est toujours placée après les balises <r></r>.

Client

<c>

N

Le client au sein du système SAP.

Alias de table enfant

<ca>

M

L'alias de la table enfant.

Champ de table enfant

<cf>

M

Le champ de la table enfant sur lequel est basée la condition de jonction.

Nom de fichier client

<cf>

Y

Identifie le fichier cible sur le système client dans lequel les résultats de la requête sont stockés.

Table enfant

<ct>

M

La table enfant dans la condition de jonction.

Destination

<d>

N

Identifie une destination dans le fichier bibliothèque SAP RFC (sapnwrfc.ini) qui est utilisé pour localiser un système SAP.

Longueur de données

<dl>

B

Le nombre de caractères sur chaque ligne, y compris les caractères retour chariot et saut de ligne marquant la fin de l'enregistrement (CR+LF ou les caractères hexadécimaux 0D+0A).

Date <dt> S

Obligatoire lors de l'utilisation du mode planifié. Indique l'heure d'exécution de la tâche SAP.

Doit être au format AAAAMMJJ. Par exemple, le 31 décembre 2014 doit être indiqué sous la forme 20141231.

Lignes attendues

<e>

B

Le nombre attendu de lignes renvoyées par la requête.

Nom de champ

<f>

Y

Le nom du champ d’origine.

Champ de filtre

<f>

W

Le nom du champ d'origine auquel s'applique le filtre.

Champs

<fs>

Y

La liste des champs de la table qui sont renvoyés avec les résultats de requête.

Valeur élevée

<h>

W

Contient la valeur élevée lors de l'utilisation de l'opérateur Entre. Ignoré lors de l'utilisation d'un autre opérateur.

Condition de jonction

<jc>

M

La condition de jonction.

Nombre de tâches

<jcount>

B

Utilisé en interne par SAP pour identifier une requête en mode Fond.

Nom de tâche

<jname>

B

Utilisé en interne par SAP pour identifier une requête en mode Fond.

Relations de jonctions

<js>

Y

La liste des conditions de jonction qui lient les tables dans la requête.

Commutateur de jointure <jw> N

L'équivalent numérique du type de commutateur de jointure énuméré.

Les valeurs correctes sont :

0 Jointure fermée

1 Jointure gauche extérieure

Valeur faible

<l>

W

Contient la valeur la plus faible lors de l'utilisation de l'opérateur Entre ou la valeur d'utilisation d'un autre opérateur.

Langue

<lg>

Y

L'identificateur de langue utilisé pour déterminer le paramètre régional des champs de base de données SAP.

Mode

<m>

Y

L'équivalent numérique du type énuméré en mode de soumission.

Les valeurs correctes sont :

0 Extraire maintenant

1 Fond

2 Planifié

Nom de table

<n>

Y

Le nom de table d'origine.

Opérateur

<o>

W

L'équivalent numérique du type d'opérateur énuméré.

Les valeurs correctes sont :

0 Égal à (=)

1 Différent de (<>)

2 Inférieur à (<)

3 Inférieur ou égal à (<=)

4 Supérieur à (>)

5 Supérieur ou égal à (>=)

6 Entre

7 Contient

Alias de table parent

<pa>

M

L'alias de la table parent.

Champ de table parent

<pf>

M

Le champ de la table parent sur lequel est basée la condition de jonction.

Table parent

<pt>

M

La table parent dans la condition de jonction.

Requête

<q>

Y

Entoure une requête.

Nombre maximal de lignes

<r>

Y

Le nombre maximal de lignes que la requête doit renvoyer.

Sélectionné

<s>

Y

Si la balise <s> figure sous la balise <f>, elle indique si le champ est renvoyé ou non avec le jeu de résultats de la requête.

Système

<s>

Y

Si la balise <s> figure sous la balise <q>, elle identifie le type de système auquel cette requête se rapporte (actuellement, seul SAP est pris en charge).

Nom de fichier de serveur

<sf>

B

Identifie le fichier sur le serveur qui héberge les résultats d'une requête en mode Fond.

Nom du groupe de serveurs <sg> N Nom du groupe de serveurs. 20 caractères maximum.
Nom du serveur <sn> N Nom du serveur. 20 caractères maximum.

Table

<t>

Y

La table.

Description de table

<td>

Y

La description de table du dictionnaire de données SAP. Elle doit toujours figurer sous la balise <a>.

Durée <tm> S

Obligatoire lors de l'utilisation du mode planifié. Indique l'heure d'exécution de la tâche SAP.

Doit être au format hhmmss. Par exemple, pour indiquer 2 h 30 de l'après-midi, il faut utiliser 143000.

Tables

<ts>

Y

La liste des tables à partir desquelles la requête extrait des données.

Type de table <tt> Y

Le type de table SAP.

Les valeurs correctes sont :

0 en cluster

1 transparent

2 en pool

3 vue

Nom d'utilisateur

<u>

N

Le nom de connexion de l'utilisateur.

Filtrer

<w>

W

Le filtre appliqué aux données de la table.

Filtres

<wc>

W

La liste des filtres qui s'appliquent aux données incluses dans la table.

Commutateur de filtres <ws> N

L'équivalent numérique du type de commutateur de filtres énuméré.

Les valeurs correctes sont :

0 (Ou) Et (Ou)

1 (Et) Ou (Et)