Pneumatic-Workflows ermöglichen es Ihnen, mehrere benutzerdefinierte Datenfelder zu dem Anstoßformular und jeder Stufe des Prozesses hinzuzufügen. Was wäre, wenn ich Ihnen sagen würde, wie Sie die Werte dieser Datenfelder von außerhalb von Pneumatic erhalten und sie beispielsweise in tabellarischer Form in eine Google Sheets-Tabelle einfügen könnten? Sie können dies tun, indem Sie die öffentliche API von Pneumatic nutzen.
Richten Sie Ihre Umgebung ein
Wir haben für Sie eine Google Sheets-Tabelle mit einem AppScript vorbereitet, das mit einem von Ihnen bereitgestellten API-Schlüssel und einer Vorlagen-ID auf die öffentliche API von Pneumatic zugreift.
Es wird als schreibgeschützte Tabelle geteilt, daher müssen Sie vor Beginn eine eigene Kopie davon erstellen.
Finden Sie Ihren API-Schlüssel und Ihre Vorlagen-ID
Damit das Skript ordnungsgemäß ausgeführt wird, müssen Sie Ihren API-Schlüssel und eine Vorlagen-ID bereitstellen, da es die Werte der Datenfelder für Workflows basierend auf einer bestimmten Vorlage abruft. Sie finden Ihren API-Schlüssel auf Ihrer Integrationsseite. Kopieren Sie ihn einfach und fügen Sie ihn in die Tabelle ein.
Die nächste Information, die Sie bereitstellen müssen, ist eine Vorlagen-ID, gehen Sie zu den Vorlagen, wählen Sie eine Vorlage, von der Sie Datenfelder abrufen möchten, und schauen Sie sich die URL für die Vorlage an:
Die Vorlagen-ID ist der numerische Code vor dem letzten Schrägstrich in der URL, kopieren Sie diesen einfach und geben Sie ihn in die Tabelle unter dem API-Schlüssel ein. Kopieren Sie ihn einfach und fügen Sie ihn in die dritte Zeile der Tabelle ein, fügen Sie ein Komma hinzu und dann einen weiteren API-Feldnamen und so weiter.
Finden Sie Ihre Feld-IDs
Das letzte Stück Information, das Sie benötigen, ist eine durch Kommas getrennte Liste der API-Namen der Datenfelder, deren Werte Sie abrufen möchten.
Ich weiß, das mag ein wenig einschüchternd klingen, aber Sie können diese auch in Ihrer Benutzeroberfläche finden. Auf der Vorlagenbearbeitungsseite öffnen Sie das Anstoßformular oder die Aufgabe, die die Felder enthält, die Sie interessieren, gehen Sie dann in das Hamburger-Menü rechts, der API-Name des Feldes ist der erste Eintrag in der Liste, die sich öffnet.
Kopieren Sie ihn einfach und fügen Sie ihn in die dritte Zeile der Tabelle ein, fügen Sie ein Komma hinzu und dann einen weiteren API-Feldnamen und so weiter.
Berechtigungen
Wenn Sie versuchen, eines der Skripte in der Tabelle auszuführen, wird Google Sie um die Berechtigung bitten, sie auszuführen, geben Sie die Berechtigung durch Klicken auf Zulassen.
Ausführen des Beispiels App Script
Sobald Sie all diese Informationen bereitgestellt haben, klicken Sie einfach auf Datenfelder abrufen und das Skript füllt die vierte Zeile mit den Namen der Felder, wie Sie sie definiert haben, während die anderen Zeilen die Namen der Workflows und die Werte für die Felder enthalten:
Beachten Sie, dass Google Sie beim ersten Versuch, das Skript auszuführen, um die Berechtigung dazu bitten wird, klicken Sie also auf Zulassen und dann erneut auf die Schaltfläche.
Das Skript selbst finden Sie unter Erweiterungen —> Apps Script
Das Skript, das der Schaltfläche Datenfelder abrufen zugeordnet ist, heißt showFieldValues, Sie können es nach Belieben betrachten und ändern:
Es holt die Werte, die Sie in die Tabelle eingeben, stellt dann ein Konfigurationsobjekt und ein Parameterobjekt zusammen, das Parameterobjekt wird dann in eine queryString umgewandelt und zum apiUrl-Parameter hinzugefügt. Das Skript führt dann eine Abrufanfrage auf dem UrlFetchApp-Objekt aus.
Es durchläuft dann die analysierten Ergebnisse der Anfrage, um die Werte für die Datenfelder abzurufen. Beim Abrufen der Werte für die erste Zeile erhält es auch die Namen für die Spalten (dafür ist die if-Anweisung in der inneren for-Schleife).
Starten von mehreren Workflows aus Google Sheets
Erfahren Sie, wie Sie die API von Pneumatic verwenden können, um mehrere Workflows in Pneumatic programmgesteuert basierend auf tabellarischen Daten in einer Google Sheets-Tabelle zu starten.
Die Datei enthält auch mehrere andere Beispielskripte, die Daten von der Pneumatic-API abrufen. Alle diese holen die Vorlagen-ID und den API-Schlüssel aus der Tabelle und protokollieren dann einfach die Ergebnisse in das Ausführungsprotokoll. Auf diese Weise können Sie sehen, welche Art von Daten Sie erhalten können, indem Sie auf die verschiedenen Endpunkte der Pneumatic-API zugreifen.
3-Minuten-Lektüre
