Skripte mithilfe von Makros ausführen - Automate_Studio - Latest

Automate Studio mit Evolve und Studio Manager Google Sheets-Add-on: Handbuch

Product type
Software
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio
Version
Latest
ft:locale
de-DE
Product name
Automate Studio
ft:title
Automate Studio mit Evolve und Studio Manager Google Sheets-Add-on: Handbuch
Copyright
2026
First publish date
2025
ft:lastEdition
2026-06-19
ft:lastPublication
2026-06-19T08:28:17.341000
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

In diesem Thema erfahren Sie, wie Sie das Makro verwenden, um das Transaction- und Query-Skript auszuführen.
Anmerkung: Der Parameter ConnectionName wird für die SAP-Verbindung verwendet, wenn das Makro im Evolve/SM-Modus ausgeführt wird.

Ein Transaction-Skript mit Makros ausführen

  1. Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie im Google Sheets-Add-on die Option Vorlage öffnen auswählen.
  2. Klicken Sie in Google Sheets unter Erweiterungen auf Apps Script.
  3. Kopieren Sie auf der Seite Apps Script den bereitgestellten Makrocode, und fügen Sie ihn in den Editor ein.
  4. Klicken Sie auf das Pluszeichen + neben Bibliotheken.
  5. Fügen Sie im Dialogfeld Bibliothek hinzufügen die Skript-ID Ihrer bereitgestellten Makrobibliothek ein.
    Anmerkung: Die Skript-ID wird generiert, wenn Sie die Bibliothek bereitstellen.
  6. Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion aus der Dropdown-Liste Version aus, und klicken Sie auf Hinzufügen.
  7. Konfigurieren Sie die Skriptparameter entsprechend Ihren Anforderungen:
    1. Startzeile
    2. Endzeile
    3. Protokollspalte
    4. Ausführungstyp
    5. Verbindungsname und weitere verfügbare Eigenschaften
  8. Klicken Sie auf Speichern, um das Google-Sheet unter einem Namen zu speichern. Das Makro ist nun in die Vorlage eingebettet.
    Anmerkung: Sie können die Bibliotheksmethode registerDeveloperMetadata mindestens einmal manuell im Apps Script-Projekt ausführen: AutomateMacroLibraryQA.registerDeveloperMetadata()

    AutomateMacroLibraryQA ist der Standard-Namespace für die Makrobibliothek. Bei Bedarf kann ein anderer Name angegeben werden.

  9. Öffnen Sie ein beliebiges Transaction-Skript im Studio Client.
  10. Navigieren Sie zu Google Drive, und wählen Sie die im Makro eingebettete Vorlage aus.
  11. Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
  12. Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Prüfung einreichen.
  13. Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
  14. Nachdem das Skript genehmigt wurde, klicken Sie auf der Seite App Script auf Ausführen.

Eigenschaften für ein Transaction-Add-on-Objekt

Ausführungseinstellungen oder erweiterte Ausführungsoptionen, die im Skript eingestellt sind, werden während der Ausführung des Makros nicht berücksichtigt. Diese müssen über die verschiedene Eigenschaften eingestellt werden, die für das Add-on-Objekt eingeblendet wurden.

Eigenschaft/Funktion Wert(e)/Parameter Beschreibung

PublishedFile

Beschreibung des veröffentlichten Skripts

Wählt die auszuführende, veröffentlichte Datei aus

StartRow

Zeilenanzahl

Zeile im Google-Sheet, ab der Daten hochgeladen werden sollen

EndRow

Zeilenanzahl

Letzte Zeile im Google-Sheet, aus der Daten hochgeladen werden sollen

WriteHeader

NV

Schreibt während der Ausführung Kopfzeilen

LogColumn

Spalte/Zelle:

Zeile oder Zelle, in die die Ausführungsprotokolle geschrieben werden sollen

ConnectionName

SAP-Verbindungsname

SAP-Verbindungsname

Beispiel

StudioMacros.ConnectionName = "w6r"

RunReason

Ausführungsgrund-String

Einen Grund für diese Ausführung angeben

RunType

0 - Run 2 - RunFirstFiveRows 3 - RunOnlyErrorRows 4 - RunOnlyUnProcessedRows 7 - ValidateSpecifiedRange 8 - ValidateFirstFiveRows 9 - ValidateOnlyErrorRows 10 - ValidateOnlyUnProcessedRows 15 - RunUnProcessedAndErrorRows 16 - ValidateUnProcessedAndErrorRows

Wählen Sie eine Ausführungsart aus den möglichen Werten aus

 

RunScript

NV

Skript ausführen

Beispielcode für die Ausführung des Transaction-Skripts
function RunPublishedTXR() {

  // ---------------------------------------------------------
  // 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;

  // Select the published file to Run
  ws.PublishedFile = "MM02_MacroTest";

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

Ausführen eines Query-Skripts mithilfe von Makros

  1. Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie im Google Sheets-Add-on die Option Vorlage öffnen auswählen.
  2. Navigieren Sie im Google-Sheet zu Erweiterungen, und klicken Sie auf Apps Script.
  3. Kopieren Sie den angegebenen Makrocode in den Apps Script-Editor, und fügen Sie ihn ein.
  4. Klicken Sie auf das Pluszeichen + neben Bibliotheken.
  5. Fügen Sie im Dialogfeld Bibliothek hinzufügen die Skript-ID der bereitgestellten Makrobibliothek ein.
    Anmerkung: Die Skript-ID wird generiert, wenn Sie die Bibliothek bereitstellen.
  6. Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion aus der Dropdown-Liste Version aus, und klicken Sie auf Hinzufügen.
  7. Konfigurieren Sie die Skriptparameter entsprechend Ihren Anforderungen:
    1. Startzeile
    2. Protokollspalte
    3. Ausführungstyp
    4. Verbindungsname
  8. Klicken Sie auf Speichern, um das Google-Sheet unter einem Namen zu speichern. Das Makro ist nun in die Vorlage eingebettet.
    Anmerkung: Sie können die Bibliotheksmethode registerDeveloperMetadata mindestens einmal manuell im Apps Script-Projekt ausführen: AutomateMacroLibraryQA.registerDeveloperMetadata()

    AutomateMacroLibraryQA ist der Standard-Namespace für die Makrobibliothek. Bei Bedarf kann ein anderer Name angegeben werden.

  9. Öffnen Sie ein beliebiges Query-Skript im Studio Client.
  10. Navigieren Sie zu Google Drive, und wählen Sie die im Makro eingebettete Vorlage aus.
  11. Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
  12. Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Prüfung einreichen.
  13. Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
  14. Nachdem das Skript genehmigt wurde, geben Sie den Namen der PublishedFile ein, und klicken Sie im Makro auf der Seite Apps Script auf Ausführen.

Eigenschaften für ein Query Add-on-Objekt

Ausführungseinstellungen oder erweiterte Ausführungsoptionen, die im Skript eingestellt sind, werden während der Ausführung des Makros nicht berücksichtigt. Diese müssen eingestellt werden, indem verschiedene Eigenschaften angewendet werden, die für das Add-on-Objekt eingeblendet wurden.

Eigenschaft/Funktion Wert(e)/Parameter Beschreibung

PublishedFile

Beschreibung der veröffentlichten Datei

Wählt die auszuführende, veröffentlichte Datei aus

StartRow

Zeilenanzahl

Google Sheets-Zeile, aus der heruntergeladene Datensätze geschrieben werden sollen.

RecordsToFetch

Anzahl der Datensätze

Anzahl der Datensätze, die bei der Query-Ausführung ausgegeben werden sollen

WriteHeader

Wahr/Falsch

Schreibt Zuordnungskopfzeilen für die heruntergeladenen Daten

ExtractAllRecords

Wahr/Falsch

Überschreibt RecordsToFetch und extrahiert alle Datensätze

RunReason

Ausführungsgrund-String

Geben Sie einen Ausführungsgrund an.

LogColumn

Spalte/Zelle:

Zeile oder Zelle, in die die Ausführungsprotokolle geschrieben werden sollen

ConnectionName

SAP-Verbindungsname

SAP-Verbindungsname

RunType

Ausführungsart

0 – Ausführung, um einstellungsgemäß Datensätze einzuholen

1 – RecordsToFetch überschreiben und nur die ersten 50 Datensätze herunterladen

RunScript

NV

Führen Sie das Skript aus.

Beispielcode für die Ausführung eines Query-Skripts
function RunPublishedQSQ() {

  // ---------------------------------------------------------
  // 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;

  // Select the published file to run
  ws.PublishedFile = "Table_20150113_150602";

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

Ein eigenes Makro erstellen und das Skript ausführen

  1. Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie die Option Vorlage öffnen im Google Sheets-Add-on verwenden.
  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. Navigieren Sie im Studio Client über Google Drive zur Anzeige und Auswahl der eingebetteten Makrovorlage.
  14. Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
  15. Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Überprüfung einreichen.
  16. Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
  17. Sobald das Skript genehmigt wurde, geben Sie auf der Seite Apps Script den Namen für die PublishedFile ein, und klicken Sie auf die Zeichnung, die Sie im Google-Sheet erstellt haben. Das Skript wird ausgeführt, und Sie können das Fenster schließen, sobald Sie die Meldung Makro erfolgreich ausgeführt erhalten.
Sie können auch die folgenden Skripte mit einem Makro ausführen:
  1. 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.
  2. 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.
  3. Cross-Chain-Skripte: Sie können Transaction- und Query-Skripte über verschiedene Ketten in einer einzigen Vorlage zusammen ausführen.
Anmerkung: Makros sind nicht verfügbar, wenn eine mit Makros aktivierte Google Sheets-Datei in Excel über In Excel öffnen von der Evolve Website aus geöffnet wird.