Scripts de requête dans Studio - Automate_Studio - Latest

Guide Automate Studio avec Evolve et Studio Manager - Module complémentaire Google Sheets
Product type
Logiciels
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio
Version
Latest
ft:locale
fr-FR
Product name
Automate Studio
ft:title
Guide Automate Studio avec Evolve et Studio Manager - Module complémentaire Google Sheets
Copyright
2026
First publish date
2025
ft:lastEdition
2026-06-19
ft:lastPublication
2026-06-19T08:27:35.044000
L1_Product_Gateway
Integrate
L2_Product_Segment
Data Integration
L3_Product_Brand
Precisely Automate
L4_Investment_Segment
SAP Automation
L5_Product_Group
Winshuttle Enterprise
L6_Product_Name
Automate Studio

Créer un script de requête à l'aide du type de données Google Sheets

Vous pouvez créer une requête à l'aide de tables, d'InfoSets ou de tables de bases de données logiques, ou à partir d'un enregistrement de transaction.

Créer une requête à l'aide de tables

  1. Cliquez sur l'onglet Fichier, puis sur Nouveau.
  2. Cliquez sur Requête.
  3. Sous Choisir une méthode de création, cliquez sur Créer depuis des tables.
  4. Dans l'écran de connexion Studio, procédez de l'une des manières suivantes :
    • Sélectionnez le système SAP, saisissez votre nom d'utilisateur et mot de passe, puis cliquez sur Connexion à SAP. OU
    • Cliquez sur Connexion SAP avancée. Dans la zone Connexion à SAP, choisissez votre système SAP, puis saisissez votre nom d'utilisateur et mot de passe. Le client est prérempli.

    Pour enregistrer vos informations d'identification pour les prochaines sessions, cochez la case Enregistrer comme informations d'identification de connexion automatique et cliquez sur la zone Enregistrer la connexion auto. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique apparaîtra dans l'option Connexion automatique et vos autres informations d'identification. Vous devez sélectionner le nom de connexion.

  5. Cliquez sur OK.
  6. Sur la page Instructions de création d'une requête depuis des tables, sélectionnez Feuille de calcul Google comme type de données, puis cliquez sur Créer un script.
  7. Dans l’onglet Studio Query Espace de travail, vous pouvez ajouter des tables de différentes manières :
    • dans la zone Ajout rapide, tapez le nom de la table et cliquez sur Ajouter à l’espace de travail ou appuyez sur Entrée.

      Pour ajouter plusieurs tables, entrez les noms séparés par une virgule ou un espace. Par exemple, MARA MAKT MARC or MARA,MAKT,MARC.

    • Dans la zone Rechercher des tables, saisissez une partie du nom de la table ou de la description et un caractère générique, par exemple, doc*l. Utilisez les options dans la liste déroulante pour limiter la recherche.

      Cliquez sur Rechercher et sur le bouton Ajouter une table à l’espace de travail dans le volet Résultats de la recherche.

      Remarque : Pour identifier les champs qui se trouvent dans la table avant de l'ajouter, cliquez sur le bouton Inspecter la table à côté du bouton Ajouter une table à l'espace de travail.
    • Cliquez sur la liste déroulante dans la partie supérieure du volet, puis sur Dictionnaire de données, accédez à la table et faites-la glisser vers l’espace de travail.

    Les tables dans l’espace de travail sont connectées par des jointures internes.

    Si vous utilisez une seule table, vous pouvez la rajouter et la joindre à elle-même. Si vous disposez de tables non connectées par des jointures, vous pouvez ajouter manuellement des jointures ou rechercher une table intermédiaire pour connecter les autres tables.

  8. Cochez la case Sortie pour chaque champ pour lequel vous voulez télécharger des données à partir de SAP.
    Remarque : Si un exit de conversion est appliqué à un champ d’entrée, aucune donnée n’est renvoyée. (L’exit de conversion est pris en charge au niveau du champ. Ainsi, vous pouvez utiliser des opérations de formatage, telles que le remplissage avec des zéros.)
  9. Cochez la case Critères de chaque champ à utiliser pour définir l’ensemble de données que vous téléchargez.

    Par exemple, si vous souhaitez demander à Query de renvoyer les données d’article en fonction d’une plage de numéros d’article, cochez la case Critères du champ MARA.MATNR.

    L'étape suivante consiste à définir des critères.

Créer une requête à l'aide d'InfoSets

  1. Cliquez sur l'onglet Fichier, puis sur Nouveau.
  2. Cliquez sur Requête.
  3. Sous Choisir une méthode de création, cliquez sur Créer depuis InfoSet.
  4. Dans l'écran de connexion Studio, procédez de l'une des manières suivantes :
    • Sélectionnez le système SAP, saisissez votre nom d'utilisateur et mot de passe, puis cliquez sur Connexion à SAP. OU
    • Cliquez sur Connexion SAP avancée. Dans la zone Connexion à SAP, choisissez votre système SAP, puis saisissez votre nom d'utilisateur et mot de passe. Le client est prérempli.

    Pour enregistrer vos informations d'identification pour les prochaines sessions, cochez la case Enregistrer comme informations d'identification de connexion automatique et cliquez sur la zone Enregistrer la connexion auto. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique apparaîtra dans l'option Connexion automatique et vos autres informations d'identification. Vous devez sélectionner le nom de connexion.

  5. Cliquez sur OK.
  6. Sur la page Instructions de création d'une requête depuis un InfoSet ou SAP Query, sélectionnez Feuille de calcul Google comme type de données, puis cliquez sur Créer un script.
  7. Cliquez sur Domaine global (tous les clients sur le système SAP) ou Domaine standard (uniquement le client que vous utilisez).
  8. Cliquez sur InfoSets SAP ou Requêtes SAP
  9. Recherchez l’InfoSet ou la requête SAP ou cliquez sur Rechercher un InfoSet/une requête et sur Dictionnaire des données et double-cliquez sur l’InfoSet approprié.
  10. Cochez la case Sortie de chaque champ pour lequel vous voulez télécharger des données depuis SAP.
  11. Cochez la case Critères de chaque champ supplémentaire à utiliser pour limiter la requête.
    Remarque : vous pouvez sélectionner des champs de critères supplémentaires dans les InfoSets. Les requêtes SAP peuvent utiliser uniquement les champs de critères prédéfinis.

L'étape suivante consiste à définir des critères.

Créer une requête à l'aide de bases de données logiques

  1. Cliquez sur l'onglet Fichier, puis sur Nouveau.
  2. Cliquez sur Requête.
  3. Sous Choisir une méthode de création, cliquez sur Créer depuis une base de données logique.
  4. Dans l'écran de connexion Studio, procédez de l'une des manières suivantes :
    • Sélectionnez le système SAP, saisissez votre nom d'utilisateur et mot de passe, puis cliquez sur Connexion à SAP. OU
    • Cliquez sur Connexion SAP avancée. Dans la zone Connexion à SAP, choisissez votre système SAP, puis saisissez votre nom d'utilisateur et mot de passe. Le client est prérempli.

    Pour enregistrer vos informations d'identification pour les prochaines sessions, cochez la case Enregistrer comme informations d'identification de connexion automatique et cliquez sur la zone Enregistrer la connexion auto. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique apparaîtra dans l'option Connexion automatique et vos autres informations d'identification. Vous devez sélectionner le nom de connexion.

  5. Cliquez sur OK. Vous êtes connecté à SAP.
  6. Sur la page Instructions de création d'une requête depuis une base de données logique, sélectionnez Feuille de calcul Google comme type de données, puis cliquez sur Créer un script.
  7. Recherchez la BDL ou cliquez sur Rechercher la BDL et sur Dictionnaire de données, puis développez le dictionnaire de données.

    Studio affiche la hiérarchie des bases de données.

  8. Double-cliquez sur un nœud de base de données pour ajouter la base de données à l’espace de travail.
    Remarque : vous ne pouvez pas ajouter plusieurs noeuds au même niveau dans la hiérarchie.

    Pour afficher les champs dans une base de données, cliquez sur la base de données dans l’espace de travail, puis sur Inspecter le nœud de base de données logique.

  9. Cochez les cases Sortie des champs à inclure dans la requête.

L'étape suivante consiste à définir des critères.

Créer une requête à l'aide de l'enregistrement
  1. Cliquez sur l'onglet Fichier, puis sur Nouveau.
  2. Cliquez sur Requête.
  3. Sous Choisir une méthode de création, cliquez sur Créer depuis un enregistrement.
  4. Dans l'écran de connexion Studio, procédez de l'une des manières suivantes :
    • Sélectionnez le système SAP, saisissez votre nom d'utilisateur et mot de passe, puis cliquez sur Connexion à SAP. OU
    • Cliquez sur Connexion SAP avancée. Dans la zone Connexion à SAP, choisissez votre système SAP, puis saisissez votre nom d'utilisateur et mot de passe. Le client est prérempli.

    Pour enregistrer vos informations d'identification pour les prochaines sessions, cochez la case Enregistrer comme informations d'identification de connexion automatique et cliquez sur la zone Enregistrer la connexion auto. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique apparaîtra dans l'option Connexion automatique et vos autres informations d'identification. Vous devez sélectionner le nom de connexion.

  5. Cliquez sur OK.
  6. Dans la zone Code de transaction, tapez le code de transaction à enregistrer.
  7. Dans la zone Description de l’enregistrement, tapez la description de l’enregistrement. Elle doit être unique.
  8. Sur la page Instructions de création d'une requête depuis un enregistrement, sélectionnez Feuille de calcul Google comme type de données, puis cliquez sur Créer un script. SAP GUI s’affiche.
  9. Enregistrement de la transaction Veillez à entrer des données pour tous les champs à inclure dans la requête.

    Si vous ne souhaitez pas valider les données dans SAP, quittez SAP GUI au lieu de cliquer sur Enregistrer.

    A la fin de l’enregistrement, Query s’ouvre dans l’onglet Espace de travail.

  10. Sous Dictionnaire de données, cliquez sur la flèche à côté de Codes de transaction enregistrés (RC), puis sur la flèche à côté de l’enregistrement.
  11. Faites glisser une table vers l’espace de travail ou double-cliquez dessus.

    Les champs que vous avez changés pendant l’enregistrement sont déjà sélectionnés.

    Remarque : certains tables peuvent contenir uniquement des champs, tels que des cases à cocher. Cliquez sur la table et sur Inspecter la table et vérifiez que la table contient les champs appropriés. Si ce n’est pas le cas, cliquez sur la croix (x) rouge dans l’angle supérieur droit de la table pour la supprimer de la requête.
  12. Cochez la case Sortie pour chaque champ supplémentaire pour lequel vous voulez télécharger des données depuis SAP.
  13. Cochez la case Critères de chaque champ à utiliser pour définir l’ensemble de données que vous téléchargez.

    Par exemple, si vous souhaitez demander à Query de renvoyer les données d’article en fonction d’une plage de numéros d’article, cochez la case Critères du champ MARA.MATNR.

L'étape suivante consiste à définir des critères.

Définition de filtres
  1. Cliquez sur l’onglet Critères et sélectionnez le premier champ listé. Si nécessaire, changez l’option de remplissage et la source des valeurs de recherche.
    Remarque : Si vous ne voyez pas ces options, placez le pointeur de la souris sur le champ.

    En appliquant des critères à des champs, vous limitez la requête pour qu'elle retourne uniquement les informations désirées.

    Vous pouvez sélectionner l'une des trois options :
    • Défini par l'utilisateur : l'utilisateur précisera cette valeur lors de l'exécution
    • Cellule : la source de cette valeur est une cellule d'un fichier de Google Sheet
    • Valeur fixe : l'utilisateur ne peut pas changer cette donnée lors de l'exécution
  2. Choisissez l'opérateur du champ. Par exemple, pour envoyer des données pour un ensemble de numéros de matériaux qui commencent 100, cliquez sur Like.
    Remarque : Si vous utilisez un InfoSet, les champs de type P peuvent utiliser uniquement l'opérateur =. Les champs S peuvent utiliser n’importe quel opérateur.

  3. Entrez la valeur. Dans l’exemple, la valeur est 100-*, où * est un caractère générique.

    Si vous voulez que la valeur ne change pas chaque fois que la requête est exécutée, cliquez sur la flèche, puis sur Valeur fixe.

    Autrement, la valeur est définie par l’utilisateur, ce qui implique pouvoir être définie par la personne qui exécute le script.

    Pour qu’une valeur soit toujours entrée dans les critères définis par l’utilisateur, cliquez sur l’icône Requis.

  4. Pour ajouter plusieurs critères à un champ, sélectionnez le champ et cliquez sur Ajouter une condition dans le ruban.

  5. Pour ajouter un champ, cliquez sur le signe Plus à côté de Rechercher tous les éléments, puis cliquez sur le nom du champ.
    Remarque : Dans un InfoSet, vous pouvez ajouter une condition Or à un champ de type S. Vous ne pouvez pas ajouter des conditions aux champs de type P. Dans une base de données logique, vous pouvez ajouter une condition Or à un champ.

    Une instruction de requête ne peut pas dépasser 65 536 caractères.

Association des champs
  1. Cliquez sur l'onglet Mappeur ou Associer dans le ruban. Vous pouvez utiliser les raccourcis clavier CTRL Z (annuler une commande) et CTRL F (rechercher un ou des mots).
  2. Effectuez l'une des opérations suivantes :
    • Sélectionnez une ligne de champ dans le mappeur et faites-la glisser vers une colonne dans le panneau Ensemble de données. Répétez l’opération pour chaque ligne dans le mappeur.
    • Sélectionnez plusieurs lignes de champ dans le mappeur et faites-les glisser vers une colonne dans le panneau Ensemble de données. Studio associe toutes les lignes sélectionnées.
    • Dans le ruban, cliquez sur Association automatique. Tous les champs seront mappés.
  3. Pour enregistrer le fichier de données, cliquez sur Enregistrer.
  4. Dans la boîte de dialogue Sélectionner un Google Drive cible, sélectionnez le dossier de votre choix, puis cliquez sur Sélectionner.
  5. Saisissez le même nom pour la nouvelle feuille de calcul et cliquez sur OK. Le nom du fichier s'affiche.
  6. Cliquez sur Enregistrer en haut à gauche pour sauvegarder à la fois le fichier de données et le fichier de script.

Ajouter une règle de transformation

  1. Dans le mappeur, cliquez sur le champ qui contient les valeurs à transformer.

  2. Dans le ruban, cliquez sur Ajouter une transformation.

  3. Dans la boîte de dialogue Règle de transformation :

    • Commencez par définir la formule de transformation dans Google Sheets.
    • Copiez la même formule et collez-la dans la zone de texte Règle de transformation.

    La formule est validée à l'aide du composant SpreadsheetGear et de l'API Google Sheet. La formule est marquée comme valide si les deux formules renvoyées sont valides et stockées dans le script pour l'exécution. Par exemple, si vous souhaitez transformer les valeurs de Poids net :

    • Supposons que les valeurs sources commencent dans la cellule H2.
    • Saisissez la formule Google Sheets=H2*1.1 dans la règle de transformation.
    • Les valeurs transformées sont écrites dans la colonne de destination (par exemple, colonne J qui commence à J2).
    • Lors de l'exécution, la règle de transformation est appliquée ligne par ligne, de la même manière que les transformations Excel.

Décalage de lignes

Si la formule doit être évaluée sur une ligne différente de la ligne mappée, indiquez la ligne où la formule doit commencer. Par exemple, saisissez 3 pour commencer l'évaluation à partir de la ligne 3.

Dates dans Google Sheets

Lorsque vous utilisez des dates dans une formule de transformation, utilisez des fonctions de date compatibles avec Google Sheets et encadrez la formule avec TEXT() pour garantir une mise en forme correcte. Par exemple : =TEXT(TODAY()+1,"mm/dd/yyyy").

Transformations d'en-tête et de poste

Les transformations de champ d'en-tête s'appliquent uniquement aux lignes d'en-tête, tandis que les transformations de champ de poste s'appliquent uniquement aux lignes de poste. Si vous devez mapper les deux types à la même colonne, vous devez ajouter la règle de transformation deux fois, une fois pour chaque type de mappage.

Valider la formule de transformation

Cliquez sur Valider pour vérifier la formule. Si la formule contient des erreurs, un message d'avertissement apparaît. Si la validation est correctement effectuée, vous pouvez continuer.

Remplacer et conserver les données d'origine

  • Pour remplacer les données d'origine, remplacez la lettre de colonne de destination par la colonne mappée d'origine, puis cliquez sur OK.

  • Pour garder les données d'origine, conservez une colonne de destination différente et cliquez sur OK.

    La feuille de calcul Google inclut la formule dans la ligne d'en-tête, comme les transformations Excel.

Soumettre un script de requête à Evolve

  1. Cliquez sur l’icône Enregistrer en haut à gauche. Si vous modifiez les noms de fichier par défaut (les noms du script et du fichier de données par défaut), ne dépassez pas 128 caractères. Les fichiers dont le nom est supérieur à 128 caractères ne peuvent pas être envoyés à partir de Studio.
  2. Effectuez toutes les modifications aux noms de fichier que vous désirez, puis cliquez sur Enregistrer les deux fichiers.
    Conseil : Si vous attribuez le même nom à une nouvelle solution que celui d'une solution existante déjà en production, la nouvelle solution devient la version de soumission.
  3. Dans l’onglet Evolve, cliquez sur Envoyer.
  4. Sur l’onglet Informations du script, ajoutez le nom et la description de la solution, la feuille de niveaux d’utilisation du système et la feuille et les données de la feuille de verrouillage. Cliquez sur Suivant. Si vous envoyez plusieurs scripts, cliquez sur Plusieurs scripts avant de cliquer sur Suivant.
  5. La feuille verouiillée n'est pas prise en charge. Cliquez sur Suivant.
  6. Sur l'onglet Modèle de données, les champs Chemin d'accès du modèle et Nom de la solution sont en lecture seule. Cliquez sur Suivant.
  7. Sur l'onglet Workflow de fichier de solution, sélectionnez la bibliothèque de destination. Choisissez dans la liste des bibliothèques disponibles. Si aucune bibliothèque personnalisée n'est répertoriée, une bibliothèque par défaut est indiquée (et grisée). Sélectionnez ensuite le Vérificateur et cliquez sur Suivant.
  8. Dans Documents justificatifs, joignez tous les documents justificatifs (un fichier individuel). Vous pouvez compresser ces fichiers dans un dossier en cliquant sur Zipper (le nom du dossier compressé sera identique au nom de la solution). Pour décompresser les fichiers du dossier, cliquez sur Dézipper. Cliquez sur Suivant. Les documents justificatifs incluent les scripts supplémentaires, les feuilles de données et les autres fichiers qui expliquent les éléments que vous envoyez pour approbation.
  9. Sur l’onglet Récapitulatif, cliquez sur le bouton Modifier pour modifier les informations. Studio affiche l’écran suivant de l’assistant. Effectuez les modifications appropriées, puis cliquez sur Suivant jusqu’à ce que l’écran Récapitulatif s’affiche.
  10. Cliquez sur Envoyer.
  11. Une fois que Studio a envoyé le script, cliquez sur OK.
  12. Approuvez le script en suivant les étapes indiquées dans Approuver, rejeter ou réaffecter des solutions dans Studio.
  13. Vous pouvez exécuter le script à l'aide du module complémentaire Google Sheets.

Approuver, rejeter ou réaffecter des solutions dans Studio

Vous pouvez approuver ou rejeter rapidement la solution dans l’écran Mes tâches Workflow ou ouvrir le fichier script et le vérifier.

  1. Dans l’onglet Fichier de Studio, cliquez sur Mes tâches Workflow.
  2. Sous Visionneuse de tâche, cliquez sur la tâche Révision requise du fichier solution. Sous Détails, vous pouvez voir le processus de workflow sélectionné. Les informations d'« origine » du workflow inclut le nom du créateur et la date de création du workflow.
  3. Sous Workflow, cliquez sur Approuver, Rejeter ou Réaffecter.
  4. Si vous cliquez sur Réaffecter, choisissez un vérificateur dans la liste Vérificateur. Vous pouvez également ajouter un commentaire pour donner la raison de l’approbation, du rejet ou de la réaffectation du fichier.
  5. Effectuez la tâche en cliquant sur Approuver, Rejeter ou Réaffecter. Si vous approuvez une solution Query et que vous pensez que la requête va nécessiter un plus grand nombre de ressources, changez le niveau d'utilisation du système.

Valeurs de recherche F4

La commande F4 Rechercher la valeur est disponible sous les onglets Critères et Exécuter.

Valeurs de Recherche F4 à l'aide de l'onglet Critères :

  1. Ouvrez le script Query enregistré.
  2. Accédez à l'onglet Critères.
  3. Sélectionnez le champ pour lequel vous souhaitez extraire des valeurs de SAP.
  4. Cliquez sur le symbole représentant trois points.
  5. Sur l'écran Générateur de liste, sélectionnez la liste des valeurs statiques, puis sélectionnez Depuis la consultation SAP F4 dans la liste déroulante Importer.
  6. Le système extrait toutes les valeurs disponibles pour le champ sélectionné, dans SAP.
  7. Sélectionnez les valeurs nécessaires dans la liste et cliquez sur OK.
Valeurs de Recherche F4 à l'aide de l'onglet Exécuter
  1. Accédez à l'onglet Exécuter du script Query.
  2. Cliquez sur Exécuter.
  3. Sur l'Assistant Variable d'exécution, recherchez le champ configuré avec la recherche SAP.
  4. Sélectionnez le symbole en regard du champ appelé SAP en option.
  5. La boîte de dialogue Valeurs SAP s'ouvre et extrait des valeurs de clé valides de SAP.
  6. Sélectionnez une ou plusieurs valeurs dans la liste des valeurs SAP.
  7. Les valeurs sélectionnées apparaissent automatiquement dans la boîte de dialogue d'exécution.
  8. Cliquez sur OK.
  9. Continuez et achevez l'exécution du script.