Skripte mithilfe von Makros ausführen - Automate_Studio - Latest

Beispielcode für die Ausführung des Transaction-Skripts

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();

}    

Beispielcode für die Ausführung eines Query-Skripts

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. Öffnen Sie die Google Sheet-Vorlage über Google Drive.
2. Klicken Sie auf der Registerkarte Einfügen auf Zeichnungen.
3. Fügen Sie im Dialogfeld Zeichnungen eine beliebige Form ein, und klicken Sie auf Speichern. Die eingefügte Form wird dem Google-Sheet hinzugefügt.
4. Wählen Sie die eingefügte Form aus, und klicken Sie auf die drei Punkte.
5. Klicken Sie auf Skript zuweisen.
6. Geben Sie im Dialogfeld Skript zuweisen den Skriptnamen ein, und klicken Sie auf OK.
7. Klicken Sie auf der Registerkarte Erweiterungen auf Apps Script.
8. Auf der Seite Apps Script können Sie Ihren eigenen Makrocode im Editor erstellen und Ausführungsparameter konfigurieren.
9. Klicken Sie neben Bibliotheken auf das Pluszeichen +.
10. Fügen Sie im Bildschirm Bibliothek hinzufügen die Skript-ID der bereitgestellten Makrobibliothek ein.
    Anmerkung: Die Skript-ID wird während der Bereitstellung generiert.
11. Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion unter der Option Version aus, und klicken Sie auf Hinzufügen.
12. Klicken Sie auf Speichern, um das Google-Sheet unter einem Namen zu speichern. Jetzt ist das Makro in die Vorlage eingebettet.
13. Klicken Sie auf die im Google Sheet erstellte Zeichnung. Das Skript wird ausgeführt, und Sie können das Fenster schließen, sobald Sie die Meldung Makro-Ausführung abgeschlossen und Datensätze heruntergeladen erhalten.

Sie können auch die folgenden Skripte mit einem Makro ausführen:

1. Chain-Skripte: Sie können Transaction- oder Query-Chain-Skripte auf einmal ausführen und dadurch den Prozess der Ausführung von miteinander verbundenen Transaktionen optimieren.
2. Cross-Chain-Skripte: Sie können Transaction- und Query-Skripte über verschiedene Ketten in einer einzigen Vorlage zusammen ausführen.
3. Roundtrip-Skripte: Sie können Transaction- und Query-Skripte mithilfe einer einzigen Vorlage ausführen. Dadurch können Sie einen vollständigen Zyklus von Vorgängen auf einmal abschließen.

Wenn Sie ein nicht veröffentlichtes Transaction- oder Query-Makro aus Google Sheets ausführen, müssen Sie den Skriptdateipfad mit einem doppelten umgekehrten Schrägstrich (\) eingeben. Sie können beispielsweise dieses Format verwenden, wenn Sie den Skriptpfad angeben: C:\\Users\\username\\Documents\\Winshuttle\\Studio\\Script\\SampleMacro.qsq