Lokale Entwicklung

Sie können zwar alle Aufgaben in Verbindung mit Connectors über die Apps Script-Onlineumgebung erledigen, doch einige davon können mit der Zeit repetitiv und fehleranfällig werden.

dscc-gen ist ein spezielles Tool, das für diese sich wiederholenden Aufgaben gedacht ist, damit Sie sich auf die Lösung Ihres Geschäftsproblems konzentrieren können, anstatt auf Fehler, die durch Automatisierung vermieden werden können.

Voraussetzungen

dscc-gen verwenden

dscc-gen kann neue Community-Connector-Projekte erstellen oder mit vorhandenen Projekten verwendet werden.

Vorhandene Connectors

dscc-gen kann auch für vorhandene Projekte verwendet werden. Kopieren Sie zuerst die Datei scriptId und führen Sie dann den folgenden Befehl aus. Ersetzen Sie dabei YOUR_SCRIPT_ID durch scriptId:

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Sie werden aufgefordert, einige Details zu Ihrem Connector einzugeben. Wenn Sie noch keine Bereitstellung mit dem Namen "Produktion" haben, wird eine für Sie erstellt. Ihr vorhandener Code wird nicht geändert, Sie haben aber Zugriff auf alles, was dscc-gen tun kann.

Neue Connectors

Führen Sie den folgenden Befehl aus, um einen neuen Community-Connector mit dscc-gen zu erstellen:

npx @google/dscc-gen connector

Sie werden aufgefordert, einige Details für den neuen Connector einzugeben. Erstnutzer werden aufgefordert, clasp zu authentifizieren. clasp ist ein Tool zum Erstellen und Ändern von Apps Script-Projekten über die Befehlszeile.

Nachdem Sie alle Eingabeaufforderungen ausgeführt haben, erstellt dscc-gen ein neues Apps Script-Projekt und gibt alle möglichen Funktionen aus.

Was kann dscc-gen tun?

Befehl Beschreibung
npm run open Öffnen Sie Ihr Projekt in Apps Script.
npm run push Übertragen Sie Ihre lokalen Änderungen in Apps Script.
npm run watch Achten Sie auf lokale Änderungen und übertragen Sie diese an Apps Script.
npm run prettier Formatieren Sie Ihren Code gemäß den Community-Standards.
npm run try_latest Öffnen Sie die Bereitstellung mit Ihrem aktuellen Code in Looker Studio.
npm run try_production Öffnen Sie Ihre Produktionsbereitstellung in Looker Studio.
npm run update_production Aktualisieren Sie Ihre Produktionsbereitstellung, um den neuesten Code zu verwenden.

Wie sollte ich diese Funktion verwenden?

Die Verwendung von dscc-gen läuft häufig ungefähr so ab:

  1. Wählen Sie eine Funktion aus, die Sie dem Connector hinzufügen möchten.
  2. Führen Sie npm run watch aus, damit lokale Änderungen an Apps Script übertragen werden.
  3. Codeänderungen kannst du in deinem bevorzugten JavaScript-Editor vornehmen.
  4. Führen Sie npm run tryLatest aus und prüfen Sie, ob das neue Feature wie erwartet funktioniert.
  5. Führen Sie npm run updateProduction aus, um Ihre Produktionsbereitstellung mit dem neuen Feature zu aktualisieren.
  6. Führen Sie npm run tryProduction aus und prüfen Sie, ob das neue Feature funktioniert.

Script-ID abrufen

Zum Abrufen der scriptId rufen Sie Ihr vorhandenes Projekt auf und kopieren dann den Abschnitt der URL nach /d/ und vor /edit. Beispiel: die folgende URL:

  • Ursprüngliche URL: https://script.google.com/a/google.com/d/example-script-id/edit
  • Skript-ID: example-script-id