Ein Transaction-Skript mit Makros ausführen
- Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie im Google Sheets-Add-on die Option Vorlage öffnen auswählen.
- Klicken Sie in Google Sheets unter Erweiterungen auf Apps Script.
- Kopieren Sie auf der Seite Apps Script den bereitgestellten Makrocode, und fügen Sie ihn in den Editor ein.
- Klicken Sie auf das Pluszeichen + neben Bibliotheken.
- 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.
- Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion aus der Dropdown-Liste Version aus, und klicken Sie auf Hinzufügen.
- Konfigurieren Sie die Skriptparameter entsprechend Ihren Anforderungen:
- Startzeile
- Endzeile
- Protokollspalte
- Ausführungstyp
- Verbindungsname und weitere verfügbare Eigenschaften
- 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
registerDeveloperMetadatamindestens einmal manuell im Apps Script-Projekt ausführen:AutomateMacroLibraryQA.registerDeveloperMetadata()AutomateMacroLibraryQAist der Standard-Namespace für die Makrobibliothek. Bei Bedarf kann ein anderer Name angegeben werden. - Öffnen Sie ein beliebiges Transaction-Skript im Studio Client.
- Navigieren Sie zu Google Drive, und wählen Sie die im Makro eingebettete Vorlage aus.
- Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
- Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Prüfung einreichen.
- Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
- 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 |
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
- Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie im Google Sheets-Add-on die Option Vorlage öffnen auswählen.
- Navigieren Sie im Google-Sheet zu Erweiterungen, und klicken Sie auf Apps Script.
- Kopieren Sie den angegebenen Makrocode in den Apps Script-Editor, und fügen Sie ihn ein.
- Klicken Sie auf das Pluszeichen + neben Bibliotheken.
- 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.
- Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion aus der Dropdown-Liste Version aus, und klicken Sie auf Hinzufügen.
- Konfigurieren Sie die Skriptparameter entsprechend Ihren Anforderungen:
- Startzeile
- Protokollspalte
- Ausführungstyp
- Verbindungsname
- 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
registerDeveloperMetadatamindestens einmal manuell im Apps Script-Projekt ausführen:AutomateMacroLibraryQA.registerDeveloperMetadata()AutomateMacroLibraryQAist der Standard-Namespace für die Makrobibliothek. Bei Bedarf kann ein anderer Name angegeben werden. - Öffnen Sie ein beliebiges Query-Skript im Studio Client.
- Navigieren Sie zu Google Drive, und wählen Sie die im Makro eingebettete Vorlage aus.
- Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
- Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Prüfung einreichen.
- Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
- 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. |
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
- Öffnen Sie die Google Sheets-Vorlage über Google Drive, indem Sie die Option Vorlage öffnen im Google Sheets-Add-on verwenden.
- Klicken Sie auf der Registerkarte Einfügen auf Zeichnungen.
- 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.
- Wählen Sie die eingefügte Form aus, und klicken Sie auf die drei Punkte.
- Klicken Sie auf Skript zuweisen.
- Geben Sie im Dialogfeld Skript zuweisen den Skriptnamen ein, und klicken Sie auf OK.
- Klicken Sie auf der Registerkarte Erweiterungen auf Apps Script.
- Auf der Seite Apps Script können Sie Ihren eigenen Makrocode im Editor erstellen und Ausführungsparameter konfigurieren.
- Klicken Sie neben Bibliotheken auf das Pluszeichen +.
- 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.
- Klicken Sie auf Suchen, wählen Sie die aktuelle Bibliotheksversion unter der Option Version aus, und klicken Sie auf Hinzufügen.
- Klicken Sie auf Speichern, um das Google-Sheet unter einem Namen zu speichern. Jetzt ist das Makro in die Vorlage eingebettet.
- Navigieren Sie im Studio Client über Google Drive zur Anzeige und Auswahl der eingebetteten Makrovorlage.
- Die Felder zuordnen. Weitere Informationen finden Sie im Abschnitt Felder zuordnen.
- Lösung zur Überprüfung einreichen. Weitere Informationen finden Sie im Abschnitt Skript zur Überprüfung einreichen.
- Die Lösung genehmigen. Weitere Informationen finden Sie im Abschnitt Lösungen in Studio genehmigen, ablehnen oder neu zuweisen.
- 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.
- 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.
- 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.
- Cross-Chain-Skripte: Sie können Transaction- und Query-Skripte über verschiedene Ketten in einer einzigen Vorlage zusammen ausführen.