Scripts de requête dans Studio - Automate_Studio - Latest

Guide Automate Studio avec Studio Administrator - 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 Studio Administrator - Module complémentaire Google Sheets
Copyright
2026
First publish date
2025
ft:lastEdition
2026-06-19
ft:lastPublication
2026-06-19T08:27:57.862000
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 Sheet dans Studio

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. Pour vous connecter au système SAP, effectuez l'une des opérations suivantes :
    1. Sélectionnez le système SAP, saisissez le nom d'utilisateur et le mot de passe, puis cliquez sur Connexion à SAP. OU
    2. Cliquez sur Connexion SAP avancée.
      1. Sur l'écran Connexion à SAP Shuttle, sous Informations d'identification, sélectionnez votre système SAP, puis saisissez votre nom d'utilisateur et votre mot de passe. Le client ne peut pas être modifié.
      2. Pour enregistrer vos données d’identification pour les prochaines sessions, cliquez sur la zone Enregistrer comme informations de connexion automatique et tapez un nom pour vos données d’identification dans la zone Nom de la connexion automatique. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique s'affichera sous l'écran de connexion automatique et vos autres informations d'identification. Vous n'avez qu'à sélectionner le nom de connexion automatique.
  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. Pour vous connecter au système SAP, effectuez l'une des opérations suivantes :
    1. Sélectionnez le système SAP, saisissez le nom d'utilisateur et le mot de passe, puis cliquez sur Connexion à SAP. OU
    2. Cliquez sur Connexion SAP avancée.
      1. Sur l'écran Connexion à SAP Shuttle, sous Informations d'identification, sélectionnez votre système SAP, puis saisissez votre nom d'utilisateur et votre mot de passe. Le client ne peut pas être modifié.
      2. Pour enregistrer vos données d’identification pour les prochaines sessions, cliquez sur la zone Enregistrer comme informations de connexion automatique et tapez un nom pour vos données d’identification dans la zone Nom de la connexion automatique. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique s'affichera sous l'écran de connexion automatique et vos autres informations d'identification. Vous n'avez qu'à sélectionner le nom de connexion automatique.
  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. Pour vous connecter au système SAP, effectuez l'une des opérations suivantes :
    1. Sélectionnez le système SAP, saisissez le nom d'utilisateur et le mot de passe, puis cliquez sur Connexion à SAP. OU
    2. Cliquez sur Connexion SAP avancée.
      1. Sur l'écran Connexion à SAP Shuttle, sous Informations d'identification, sélectionnez votre système SAP, puis saisissez votre nom d'utilisateur et votre mot de passe. Le client ne peut pas être modifié.
      2. Pour enregistrer vos données d’identification pour les prochaines sessions, cliquez sur la zone Enregistrer comme informations de connexion automatique et tapez un nom pour vos données d’identification dans la zone Nom de la connexion automatique. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique s'affichera sous l'écran de connexion automatique et vos autres informations d'identification. Vous n'avez qu'à sélectionner le nom de connexion automatique.
  5. Cliquez sur OK.
  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. Pour vous connecter au système SAP, effectuez l'une des opérations suivantes :
    1. Sélectionnez le système SAP, saisissez le nom d'utilisateur et le mot de passe, puis cliquez sur Connexion à SAP. OU
    2. Cliquez sur Connexion SAP avancée.
      1. Sur l'écran Connexion à SAP Shuttle, sous Informations d'identification, sélectionnez votre système SAP, puis saisissez votre nom d'utilisateur et votre mot de passe. Le client ne peut pas être modifié.
      2. Pour enregistrer vos données d’identification pour les prochaines sessions, cliquez sur la zone Enregistrer comme informations de connexion automatique et tapez un nom pour vos données d’identification dans la zone Nom de la connexion automatique. Lors de la prochaine connexion à SAP depuis Studio, votre nom de connexion automatique s'affichera sous l'écran de connexion automatique et vos autres informations d'identification. Vous n'avez qu'à sélectionner le nom de connexion automatique.
  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 critères
  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.
    Si le champ n’était pas initialement sélectionné comme critère dans l’espace de travail, Studio le sélectionne automatiquement.
    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 de fichier de données 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.
Remarque : Vous pouvez mettre à jour le fichier de données existant et créer une nouvelle feuille de calcul en fonction de celle existante. Vous pouvez également ajouter, supprimer et renommer des feuilles de calcul lors de l'enregistrement de la nouvelle feuille de calcul dans un dossier de Google Drive.

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.

Planification locale de l'exécution de Query

  1. Ouvrez le script Query qui est associé à une source de données Google Sheets dans Automate Studio.
  2. Dans l'onglet Exécuter, cliquez sur Planifier. Si vous n'êtes pas connecté à SAP, la boîte Connexion à SAP s'affiche pour vous permettre de vous connecter au système SAP.
  3. Vérifiez les critères, le cas échéant, affichés dans l'Assistant Temps d'exécution variable en cliquant sur OK.
  4. Dans la boîte de dialogue Automate Scheduler, dans la zone Titre, saisissez le titre que Studio doit afficher dans la liste des tâches planifiées.
  5. Si vous souhaitez recevoir des notifications de planification, saisissez votre adresse e-mail dans la zone Envoyer des notifications par e-mail à. Utilisez des virgules pour séparer les adresses e-mail.
  6. Dans la zone Raison de l'exécution, vous pouvez changer la raison de l'exécution.
  7. Cliquez sur Suivant.
  8. Cliquez sur Une fois, Tous les jours, Hebdomadaire ou Mensuel et saisissez la date et l'heure de début.
  9. Choisissez les options de répétition appropriées. Ces options changent en fonction de l'élément sur lequel vous avez cliqué à l'étape 8. Sous Paramètres avancés, vous pouvez choisir d'exécuter le script plusieurs fois. Par exemple, si vous voulez exécuter le script tous les mois le cinquième jour et au début et à la fin de la journée, cochez la case Occurrence de la tâche toutes les et cliquez sur 12 heures et sur 1 jour.
  10. Si le script sera exécuté plusieurs fois, choisissez une valeur dans la liste Nom de fichier généré par le système pour éviter de remplacer les données dans le fichier de données à chaque exécution du script. Selon le paramètre que vous choisissez, Studio ajoutera la date, la date et l'heure ou le nom d'utilisateur connecté au nom de fichier. cette option est disponible uniquement pour les fichiers de données Excel. Vous pouvez ajouter un horodatage au nom de fichier de résultat Query.
  11. Cliquez sur Terminer. La confirmation de la planification correcte du script apparaît à l'écran.
Changement de la planification ou arrêt de la planification d’une exécution
  1. Cliquez sur l’onglet Fichier.
  2. Cliquez sur Tâches planifiées, puis sur la tâche à arrêter ou à modifier.
  3. Cliquez sur Supprimer ou sur Modifier pour effectuer des modifications dans la zone Automate Scheduler.

Publier un script de requête

Lorsque vous publiez un script dans Studio, vous l'incorporez dans le fichier de données Google Sheet. Les exécuteurs peuvent alors exécuter le script à partir de la feuille de calcul Google à l'aide du module complémentaire Google Sheets.

  1. Cliquez sur l'onglet Exécuter, puis sur Publier.

    Si un message vous y invite, enregistrez le fichier, puis cliquez de nouveau sur Publier.

  2. Dans la zone Nom du script, saisissez un nom descriptif afin de permettre aux exécuteurs d'identifier le script.

  3. Si vous voulez incorporer le script dans un fichier de données différent, cliquez sur Parcourir et recherchez cette feuille de calcul Google.

    Par défaut, Studio utilise le fichier de données déjà ouvert, mais vous pouvez incorporer plusieurs scripts dans un même fichier de données. Vous pouvez également incorporer des scripts Transaction et Query dans un même fichier de données.

  4. Choisissez la feuille que vous voulez que les exécuteurs utilisent. Pour empêcher les exécuteurs d'utiliser une feuille de calcul différente, cliquez sur l'icône de verrou.
  5. Pour remplacer les en-têtes existants chaque fois que le fichier est ouvert, cochez la case Remplacer les en-têtes de fichier de données.
  6. Cliquez sur Publier.

Le fichier de données et le script sont publiés, et les exécuteurs qui ouvrent le fichier de données peuvent exécuter le script.

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.