Gestion de l'intégration des données

Transfert de données avec le dispositif de chargement de données express

Objective

After completing this lesson, you will be able to expliquez comment transférer des données avec le dispositif de chargement de données express.

Transfert de données du dispositif de chargement de données express

Le chargeur de données express (XDL) est une autre méthode de chargement et d'extraction de données vers et depuis SAP Territory and Quota. XDL est un outil basé sur le cloud qui vous permet d'importer et d'exporter en toute sécurité des données en masse vers et depuis le système sans avoir besoin de codage.

XDL peut être utilisé pour importer des données à partir de systèmes source et pour extraire des quotas dans SAP Incentive Management. Ici, les quotas peuvent être utilisés pour calculer les commissions et autres stimulations à l'efficience à partir des opérations de vente.

Téléchargement du modèle de fichier d’importation

Les données XDL sont chargées à l'aide de fichiers d'importation avec des exigences d'attribution de noms et de formatage très spécifiques. Par conséquent, la façon la plus simple de formater les fichiers d'importation est de télécharger la collection de modèles. La collection complète de modèles de fichiers d'importation est téléchargée sous forme de fichier .ZIP unique à partir de la page d'aide en ligne XDL. Cette page contient également une table avec le nom du modèle, le code du type de fichier et la description de chaque modèle. L'image ci-dessous montre le lien de téléchargement dans l'aide en ligne.

La page d'aide en ligne affiche le lien permettant de télécharger le modèle d'importation.

Une fois que vous avez téléchargé le fichier .ZIP dans votre système local, vous pouvez extraire les fichiers dans un dossier.

À mesure que nous abordons ce sujet, nous étudierons un scénario dans lequel Bikes In Motion souhaiterait utiliser XDL pour importer de nouveaux comptes clients chaque mois.

La table de la page Modèles de chargeur de données express indique que les comptes sont importés à l'aide du fichier TQAC_Template, dont le code de type de fichier est TQAC.

Exigences relatives au format et à l'appellation des fichiers XDL

Les exigences de désignation des fichiers pour XDL sont très précises. Chaque modèle comporte un onglet décrivant les exigences spécifiques pour ce type de fichier, mais en règle générale, le nom du fichier doit être au format suivant :

Code Snippet
1
[Tenant ID]_[File Type Code]_<DEV or TST or PRD>_<yyyymmdd>_<hhmiss>_<Content Tag>.<file-suffix>

  • L' ID locataire correspond aux quatre chiffres au début de l'URL. Il s'agit d'un code désigné par SAP pour identifier de manière unique le propriétaire du locataire. Par exemple, l'ID locataire pour Bikes In Motion peut être 1104.
  • Le code du type de fichier identifie le type de données importées. La liste des modèles de fichier d'importation contient le code de type de fichier. Par exemple, le code de type de fichier pour les comptes est TQAC.
  • DEV, TST ou PRD identifie le type de locataire : développement, test ou production.
  • AAAAMMJJ est la date, par exemple 20220101.
  • HHMMSS correspond à l'heure exacte ; par exemple, 1:00 PM correspond à 130000.
  • La balise de contenu est une chaîne de texte synthétique qui peut contenir n'importe quelle valeur pour identifier de manière unique le lot. Dans ce cas, nous utiliserons la balise de contenu JanAccounts.

Si nous regroupons tous ces éléments, le nom du fichier peut être le suivant :

BIKE_TQAC_PRD_20220101_130000_JanAccounts.xlsx

En plus du nom, le fichier a également les exigences de mise en forme suivantes :

  • Sauvegardez le fichier en tant que fichier texte délimité avec le suffixe .txt.
  • Le séparateur doit correspondre à celui sélectionné dans les options du type de fichier d'entrée dans XDL. Dans ce cas, nous allons utiliser un séparateur de tabulation.
  • De même, le codage doit correspondre à celui sélectionné dans les Options du type de fichier entrant dans XDL. Dans ce cas, le fichier utilisera le codage UTF-8.
  • Le fichier peut avoir une ligne d'en-tête facultative, mais veillez à indiquer si une ligne d'en-tête est utilisée dans les Options du type de fichier entrant.

Configuration du dispositif de chargement de données express

L'étape suivante consiste à configurer les exigences en matière de fichiers. Cela comprend trois étapes : les options globales, les options de type de fichier entrant et les options de type de fichier sortant.

Les options globales sont des options par défaut qui s'appliquent aux transferts de fichiers entrants et sortants. Les options globales incluent notamment le fuseau horaire par défaut, le codage de caractères, le type de compression et le destinataire de l'e-mail pour les notifications de réussite et d'échec.

Les options de type de fichier entrant incluent les options standard et les métadonnées de chaque fichier importé. Un type de fichier doit être configuré pour chaque fichier modèle, ce qui signifie que chaque modèle doit avoir un type de fichier associé. Les options incluent le type de fichier, les options d'importation et la table temporaire cible. Vous pouvez également remplacer le jeu de caractères et le séparateur par défaut en les définissant dans les paramètres du type de fichier.

Les options de type de fichier sortant incluent les options standard et les métadonnées de chaque fichier exporté, comme les comptes ou les quotas. Les paramètres incluent le type de fichier de sortie, la procédure stockée source et le mode de compression. Comme pour les options de type de fichier d'entrée, vous pouvez remplacer le jeu de caractères et le séparateur par défaut en les définissant dans les options du type de fichier.

Voyons comment configurer les options globales et entrantes pour qu'elles correspondent au fichier d'importation que nous avons créé dans la rubrique précédente.

Configuration des options globales

Étapes

  1. Dans le sélecteur d'application, sélectionnez Chargeur de données express.

  2. Sélectionnez ConfigurationOptions globales.

  3. Définissez le mode de compression. La valeur par défaut est Gzip, mais dans notre exemple, nous n'utiliserons pas de mode de compression.

  4. Définissez le fuseau horaire.

    Il est utilisé pour l'horodatage du job.

  5. Sélectionnez un attribut de codage de caractères (Jeu de caractères). La valeur par défaut est UTF-8.

  6. Sélectionnez un séparateur. La valeur par défaut est délimitée par destabulations.

  7. Sélectionnez une période de rétention pour les journaux d'erreurs et les jobs. Les valeurs par défaut sont respectivement de 30 jours et 90 jours.

  8. Saisissez un e-mail pour les e-mails de notification de réussite et d'échec.

  9. Activez le commutateur Autorun. Indiquez si l'importation doit être exécutée automatiquement une fois le chargement de fichier exécuté.

  10. Sélectionnez un séparateur d'échappement.

    Ce paramètre indique si les fichiers séparés par des virgules, qui comportent un séparateur dans leurs données, peuvent être chargés. Lorsque cette option est activée, vous pouvez utiliser des guillemets doubles pour importer des valeurs qui ont un séparateur dans le champ ("").

  11. Sélectionnez Sauvegarder.

Résultat

La page Paramètres globaux pour configurer XDL s'affiche.

Configurer les options du type de fichier d'entrée

Étapes

  1. Sélectionnez ConfigurationConfiguration du type de fichier.

  2. Faites défiler ou recherchez le type de fichier. L'exemple ci-dessous illustre la configuration de SAP Territory and Quota Accounts : TQAC.

  3. Sélectionnez le type de fichier à configurer. Dans ce cas, nous sélectionnerons TQAC.

  4. Sélectionnez l'icône représentant un crayon pour modifier la configuration du type de fichier.

  5. Les deux types de fichiers pour les comptes territoriaux et les comptes de quotas sont affichés.

  6. Laissez le jeu de caractères (attribut de codage de caractères) défini sur Par défaut. Par défaut, le paramètre UTF-8 est sélectionné dans la configuration globale.

  7. Laissez le délimiteur sur la valeur par défaut.

    Par défaut, il s'agit du séparateur de tabulation que nous avons sélectionné dans la configuration globale.

  8. Définissez le type d'importation sur Valider et transférer. Cela transfère automatiquement les enregistrements de la table temporaire à la production une fois l'importation terminée.

  9. Sélectionnez le commutateur pour poursuivre une importation si des erreurs sont détectées dans la validation.

  10. Sélectionnez le commutateur En-tête.

  11. Sélectionnez Sauvegarder.

Résultat

Les champs standard permettant de modifier un type de fichier sont affichés.

Exécution du transfert de fichier entrant

Nous sommes maintenant prêts à utiliser Express Data Loader pour charger les nouveaux comptes dans SAP Territory and Quota.

Importer un fichier dans le dispositif de chargement de données express

Étapes

  1. Sélectionnez le menu Jobs dans le navigateur de gauche.

  2. Cliquez sur l'icône Charger () dans la barre d'outils.

  3. Accédez à l'emplacement du fichier texte séparé par des tabulations et sélectionnez Ouvrir.

  4. Attendez la fin du job.

Résultat

Téléchargez le fichier texte Tâches à l'aide du bouton Télécharger sur le serveur sur la page Tâches.

Une fois la tâche terminée, vous pouvez revenir au territoire et au quota pour vérifier que les enregistrements ont été chargés dans l'espace de travail.

Importer les données de compte à l'aide du dispositif de chargement de données express

Scénario de gestion

Dans cet exercice, vous allez exécuter les étapes d'importation des données de compte dans l'application SAP Territory and Quota à l'aide du chargeur de données express.

Exécution du transfert de fichiers sortants

Lors de l'extraction de données à partir de SAP Territory and Quota, un autre type de modèle est utilisé. Le modèle sortant est un fichier texte encodé en UTF-8 qui contient une instruction SQL SELECT. Un ensemble de fichiers échantillons peut être téléchargé à l'aide de ce lien (notez qu'il s'agit d'un téléchargement direct). Cela crée un fichier .zip qui contient un ensemble de fichiers texte (.txt).

Extrayez le fichier .zip dans un dossier. Le tableau suivant contient une liste des fichiers d'extraction disponibles.

Type de donnéesNom du fichier d'extraction
TerritoryAccountTERRITORYACCEXT
TerritoryGeographyTERRITORYGEOEXT
Produit territorialTERRITORYPRODEXT
TerritoryQuotaTERRITORYQUOTAEXT
CompteACCOUNTEXT
GéographieGEOGRAPHYEXT
ProduitsPRODUCTEXT

Exigences en matière de format et d'appellation des fichiers sortants

L'instruction SELECT répertorie chaque colonne à extraire séparée par un signe @, suivie d'une clause WHERE désignée par une virgule.

Examinons deux exemples de fichiers d'extraction et la syntaxe utilisée pour sélectionner des colonnes et des filtres :

Pour extraire des comptes, nous utiliserons le fichier ACCOUNTEXT. Les contenus suivants extraient l'ID compte, le chiffre d'affaires, l'adresse, la ville, l'État, le code postal et la date de début de validité de tous les comptes dans lesquels l'État est égal à Californie (CA) :

Code Snippet
1
accountId@Revenue@ADDRESS1@CITY@STATE@POSTALCODE@EFFECTIVESTARTDATE,@STATE = "CA"

Il est également possible d'inclure des zones personnalisées si nécessaire.

Pour extraire des quotas dans un programme territorial, nous utiliserons le fichier TERRITORYQUOTAEXT. Le contenu suivant extrairait les quotas d'un territoire, y compris le nom du programme territorial, le territoire, la valeur de l'objectif et la valeur finale de l'objectif, si la date de début effective est égale ou postérieure au 1er janvier 2010, si le programme territorial est « NPR TP » et si le type de cible est « Chiffre d'affaires » :

Code Snippet
1
Territory Program@Territory@QuotaValue@finalQuotaValue,@EFFECTIVESTARTDATE >= "20100101" and @TERRITORY PROGRAM = "NPR TP" and @Target Type = "revenue"

Le fichier d'extraction sera sauvegardé avec la convention d'appellation.

Code Snippet
1
<tenantid>_<outboundname>_<optionalstring>.txt.

  • L' ID locataire correspond aux quatre chiffres au début de l'URL. Il s'agit d'un code désigné par SAP pour identifier de manière unique le propriétaire du locataire. Il s'agit de l'ID locataire utilisé pour les fichiers entrants.
  • Le nom sortant est le nom du type de fichier. Dans les deux exemples que nous avons utilisés ci-dessus, il s'agit de ACCOUNTEXT ou TERRITORYQUOTAEXT.
  • La chaîne facultative est une chaîne de texte synthétique qui peut contenir n'importe quelle valeur permettant d'identifier de manière unique le lot.

À l'aide de nos deux exemples, notre fichier d'extraction de comptes s'appellerait BIKE_ACCOUNTEXT_2022Accounts.txt et le fichier d'extrait de quota serait BIKE_TERRITORYQUOTAEXT_2022Quotas.txt.

Remarque

La dernière partie de ces noms de fichier peut être n'importe quelle chaîne.

Charger le fichier d'extraction dans le chargeur de données express

Étapes

  1. Connectez-vous à Express Data Loader (XDL).

  2. Sélectionnez le menu Tâches dans le navigateur du panneau de gauche.

  3. Cliquez sur l'icône Charger () dans la barre d'outils.

Résultat

Chargez le fichier d'extraction XDL à l'aide du bouton de téléchargement sur la page Tâches.

Synthèse

  • Les fonctionnalités du chargeur de données express fournissent des importations et des exportations en masse sécurisées et sans code entre les systèmes source et l'application.
  • Les exigences du modèle fournissent des fichiers formatés correctement nommés téléchargés sous forme de zip contenant des modèles de texte.
  • Les configurations globales et de type de fichier établissent des séparateurs, des modes de validation, des options d'en-tête, des périodes de conservation et des paramètres de notification.