Exécuter des scripts à l'aide de macros - Automate_Studio - Latest

Exemple de code pour exécuter le script Transaction

function RunNormalTXRfile() {

  // ---------------------------------------------------------
  // NOTE:
  // 'MacroLib' is the Apps Script LIBRARY IDENTIFIER
  // added to this Google Sheet project.
  //
  // If your library identifier is 'MacroLib', this function can be run AS-IS.
  // Otherwise, replace 'MacroLib' with your actual library name.
  // ---------------------------------------------------------

  const ws = MacroLib.onScript;

  // For local File, set ShuttleFile to local file path to Run
  ws.ShuttleFile = "<<Path of script file>>";

  ws.StartRow = 2;
  ws.EndRow = 6;

  // Set column used to log execution status
  ws.LogColumn = "A";
  
  // Set in case of Studio Administrator
  ws.AlfName = "w6r-800";

  // Set in case of Evolve
  ws.ConnectionName = "w6r";

  // Set RunReason to provide reason for run.
  ws.RunReason = "Run Reason";

   // ---------------------------------------------------------
  // RunType options
  //
  // 0  = Run
  // 1  = RunAndStopOnErrors
  // 2  = RunFirstFiveRows
  // 3  = RunOnlyErrorRows
  // 4  = RunOnlyUnProcessedRows
  // 7  = ValidateSpecifiedRange
  // 8  = ValidateFirstFiveRows
  // 9  = ValidateOnlyErrorRows
  // 10 = ValidateOnlyUnProcessedRows
  // 15 = RunUnProcessedAndErrorRows
  // 16 = ValidateUnProcessedAndErrorRows
  //
  // ---------------------------------------------------------
  
  ws.RunType = 0;
  
  //Set true to auto close the MacroDialog box after run. 
  ws.AutoClose = false

  // Execute the published TXR script
  ws.RunScript();

}    

Exemple de code pour exécuter un script Query

function RunNormalQsqFile() {

  // ---------------------------------------------------------
  // NOTE:
  // 'MacroLib' is the Apps Script LIBRARY IDENTIFIER
  // added to this Google Sheet project.
  //
  // If your library identifier is 'MacroLib', this function
  // can be run AS-IS.
  // Otherwise, replace 'MacroLib' with your actual library name.
  // ---------------------------------------------------------

  const ws = MacroLib.onScript;

  // For local File, set ShuttleFile to local file path to Run
  ws.ShuttleFile = "<<Path of script file>>";

  ws.StartRow = 2;

  // Number of records to fetch. if not set, then records will be fetched as per script settings.
  // Only respected when ExtractAllRecords = false
  ws.RecordsToFetch = 10;

  // True to fetch all records. If set false then RecordsToFetch property will be respected
  ws.ExtractAllRecords = false;

  // Set column used to log execution status
  ws.LogColumn = "A";
  
  // Set in case of Studio Administrator
  ws.AlfName = "w6r-800";

  // Set in case of Evolve
  ws.ConnectionName = "S25";

  // Set RunReason to provide reason for run.
  ws.RunReason = "Run Reason";

  // ---------------------------------------------------------
  // RunType options
  //
  // 0  = Run
  // 1  = RunOnlyFiftyRecords
  //
  // ---------------------------------------------------------

  ws.RunType = 0;
  
  //Set true to auto close the MacroDialog box after run. 
  ws.AutoClose = false

  // Execute the published QSQ script
  ws.RunScript();
}

1. Ouvrez le modèle de Google Sheet depuis Google Drive.
2. Cliquez sur Dessin sous l'onglet Insérer.
3. Dans la boîte de dialogue Dessin, insérez n'importe quelle forme et cliquez sur Enregistrer et fermer. La forme insérée sera ajoutée à la feuille de calcul Google.
4. Sélectionnez la forme insérée et cliquez sur les trois points.
5. Cliquez sur Affecter un script.
6. Saisissez le nom du script dans la boîte de dialogue Affecter un script et cliquez sur OK.
7. Sous l'onglet Extensions, cliquez sur Apps Script.
8. Sur la page Apps Script, vous pouvez créer votre propre code macro dans l'éditeur et configurer les paramètres d'exécution.
9. Cliquez sur le signe + en regard de Bibliothèques.
10. Sur l'écran Ajouter une bibliothèque, collez l'ID de script de la bibliothèque de macros déployée.
    Remarque : L'ID de script est généré lors du déploiement.
11. Cliquez sur Rechercher, sélectionnez la dernière version de la bibliothèque sous l'option Version et cliquez sur Ajouter.
12. Cliquez sur Enregistrer pour enregistrer la feuille de calcul Google avec un nom. Maintenant, la macro est intégrée au modèle.
13. Cliquez sur le dessin que vous avez créé dans Google Sheet. Le script s'exécute et vous pouvez fermer la fenêtre une fois que vous avez reçu le message Exécution de la macro terminée et enregistrements téléchargés.

Vous pouvez également exécuter les scripts suivants à l'aide de la macro :

1. Chaîner les scripts : vous pouvez chaîner simultanément des scripts de transaction ou de requête, simplifiant ainsi le processus d'exécution des transactions interconnectées.
2. Scripts inter-chaînes : vous pouvez exécuter conjointement des scripts de transaction et de requête sur différentes chaînes dans un seul modèle.
3. Scripts aller-retour : vous pouvez exécuter des scripts de transaction et de requête via un seul modèle, ce qui vous permet d'exécuter un cycle d'opérations complet en une seule fois.

Lorsque vous exécutez une macro Transaction ou Query non publiée à partir de Google Sheets, vous devez saisir le chemin d'accès du fichier de script à l'aide de barres obliques doubles (\). Par exemple, vous pouvez utiliser ce format lors de la spécification du chemin d'accès du script : C:\\Users\\username\\Documents\\Winshuttle\\Studio\\Script\\SampleMacro.qsq