Erstellen Ihres ersten Connectors

In diesem Abschnitt wird erläutert, wie Sie einen Connector mit Connector Builder erstellen und innerhalb einer Automatisierung verwenden. Das Beispiel behandelt das Erstellen eines Connectors in einem manuellen Prozess, sodass wir automatisch Punkte beheben, die andernfalls normalerweise übersprungen werden können.

Der Workflow, den wir entwerfen, ist dazu bestimmt, tägliche Slack-Nachrichten von interessanten Aktienkursen zu erhalten. Polygon.io bietet eine Reihe kostenloser APIs, die Aktieninformationen abrufen und für unsere Zwecke verwendet werden können. Sie haben einen schnellen Registrierungsprozess, der uns im Gegensatz dazu einen API-Schlüssel zur Verfügung stellt, um die API-Aufrufe auszuführen, die wir ausführen müssen.

Hinweis:

Sie können sich auch den Abschnitt Erstellen Ihres Connectors über eine API-Definition ansehen. Hier wird erklärt, wie Sie eine Swagger-Definition importieren und den Connector-Generator den größten Teil der Arbeit für Sie erledigen.

Registrieren Sie sich mit Polygon.io

Die meisten Anbieteranwendungen erfordern Authentifizierungsdetails in Form von Benutzername und Kennwort, OAuth-App, API-Schlüssel usw. Bei Polygon.io ist das nicht anders. Es bietet eine kostenlose Registrierung, um einige ihrer APIs auszuprobieren.

1. Gehen Sie zu Polygon.io und erstellen Sie ein Konto.
2. Öffnen Sie Ihr Dashboard und wählen Sie API-Schlüssel aus, um Ihren Schlüssel anzuzeigen.

Erstellen Sie einen Connector im Connector Builder

Navigieren Sie zu Integration Service und wählen Sie Connector erstellen aus.

Beginnen wir mit einem leeren Connector. Wenn Sie eine API-Definition zur Hand haben (Swagger, YAML usw.), können Sie Mit API-Definition beginnen auswählen und der Connector-Generator den größten Teil der Konfigurationsarbeit für Sie übernehmen.

1. Laden Sie das polygon.svg -Symbol aus dem Web herunter, um Ihrem Katalog das Logo hinzuzufügen.

   Hinweis: Alle Bildtypen werden unterstützt, aber wir empfehlen die Verwendung einer quadratischen SVG-Datei.

2. Fügen Sie einen Namen und eine Beschreibung für Ihren benutzerdefinierten Connector hinzu und wählen Sie dann Erstellen.

Richten Sie die Authentifizierung ein und stellen Sie die Verbindung her

Die Dokumentation „Erste Schritte “ von Polygon verweist darauf, dass Sie bei jedem API-Aufruf an ihre Plattform Ihren API-Schlüssel in den Headern oder als Abfrageparameter senden müssen. Dazu müssen Sie es in die Header einfügen, wie im folgenden Beispiel erläutert:

1. Übergeben Sie Ihren API-Schlüssel in der Abfragezeichenfolge wie folgt, wobei <your_token> der API-Schlüssel ist:

   https://api.polygon.io/v2/aggs/ticker/AAPL/range/1/day/2023-01-09/2023-01-09?apiKey=<your_token>
   

2. Alternativ können Sie der Anforderung einen Autorisierungsheader mit Ihrem API-Schlüssel als Token in der folgenden Form hinzufügen, wobei <your_token> der API-Schlüssel ist:

   Authorization: Bearer <your_token>
   

3. Navigieren Sie im Connector Builder zu Einstellungen und wählen Sie die Registerkarte Basis-API aus. Legen Sie die Basis-URL auf https://api.polygon.io fest.

   Hinweis:

   In diesem Beispiel fügen wir den Abschnitt version "v2" nicht zur Basis-URL hinzu. Dadurch können wir einige der älteren Standard-API-Aufrufe ausführen.

   

4. Wechseln Sie als Nächstes zur Registerkarte Authentifizierung , um Ihren bevorzugten Authentifizierungstyp aus der Dropdownliste auszuwählen. Wählen wir in diesem Beispiel Persönliches Zugriffstoken (PAT) aus. Hinweis: Die Polygon-Dokumentation bezieht sich auf einen API-Schlüssel, aber da er als Authorization: Bearer <your\_token> gesendet werden muss, ist er tatsächlich näher an einem Token im OAuth-Stil. Daher ist ein persönliches Zugriffstoken (PAT) technisch die bessere Definition. Lesen Sie mehr über die verschiedenen Authentifizierungstypen.

5. Kopieren Sie Ihren API-Schlüssel von Polygon und legen Sie den Wert fest als: Bearer <your_key>.

6. Legen Sie das Feld Benutzer fragen auf Nein fest, damit Benutzer beim Erstellen einer Verbindung mit diesem Connector nicht nach ihrem Schlüssel gefragt werden. Dies liegt daran, dass wir diesen Connector nicht über unseren Mandanten hinaus freigeben werden. Wenn Sie den Connector jedoch für andere als den Mandanten freigeben möchten, fügen Sie keinen eigenen Schlüssel hinzu. Legen Sie Benutzer fragen auf Ja fest, damit andere Benutzer aufgefordert werden, den Polygon-Dienst selbst zu abonnieren. Die vorkonfigurierten Authentifizierungstypen im Connector Builder übernehmen den größten Teil der Arbeit für Sie. Beispielsweise sendet das persönliche Zugriffstoken automatisch Automation: Bearer <your\_token> als Auth-Header, anstatt dass Sie diese Konfiguration selbst erstellen müssen.

   

7. Richten Sie eine Verbindung mit der oben genannten Konfiguration ein, indem Sie die Schaltfläche Nicht verbunden > Verbindung hinzufügen auswählen. Beachten Sie, dass dies bereits wie jeder andere Integration Service-Connector funktioniert. Wählen Sie Verbinden aus, damit Sie eine Testverbindung haben, an die Sie API-Aufrufe senden können.

Testen Sie Ihre API-Aufrufe

Nachdem wir eine Verbindung zur Dritt-Software hergestellt haben, beginnen wir mit der Ausführung der eigentlichen API-Aufrufe.

1. Navigieren Sie zum Bereich auf der linken Seite zu API > Neue Ressourcengruppe erstellen. Das Ziel ist es, eine tägliche Slack-Benachrichtigung zum Eröffnungspreis einer bestimmten Aktien zu erhalten. Der Endpunkt, den wir jetzt implementieren werden, ist die Tägliche Open/Close-API von Polygon.

   

2. Kopieren Sie im Fenster Neue Ressourcengruppe erstellen die Endpunktinformationen aus den Polygon-Dokumenten.

3. Legen Sie den Pfad auf /open-close/{stocksTicker}/{date} fest.

4. Aktivieren Sie in der Liste Methoden auswählen die Option Datensatz abrufen (GETBYID), da wir ein einzelnes Objekt anstelle eines Arrays von Objekten auswählen.

5. Geben Sie einen Anzeigenamen an, z. B. Öffnen – Schließen für Lager. Der Connector-Generator konvertiert die {x} -Variablen automatisch in Pfadvariablen.

6. Wählen Sie Erstellen aus, um diese Ressource hinzuzufügen.

   

   

7. Um zu testen, ob das Setup funktioniert, wählen Sie die Schaltfläche Anforderung senden neben Ihrer Ressource aus. Dadurch werden Werte für die beiden Pfadparameter erstellt. Wir können sie dem Verwendungsbeispiel in den Polygon-Dokumenten entnehmen.

   

Veröffentlichen Sie den Connector im Katalog

Sie können ein paar zusätzliche Schritte ausführen, damit Ressourcen und Parameter besser aussehen und sich verhalten. Identifizieren Sie beispielsweise, dass der Datumsparameter vom Typ DateTime ist, und geben Sie die Maske als Beispiel an. Durch die Angabe von Anzeigenamen wird Ihr Connector innerhalb der Studio-Aktivität besser angezeigt. Die folgende Abbildung zeigt, wie diese Felder eingerichtet werden:

Wählen Sie als letzten Schritt Veröffentlichen aus, um Ihren Connector für Ihren Mandanten zu veröffentlichen. Der Connector wird in der Liste der Connectors angezeigt, die auf Ihrem Mandanten angezeigt werden, und jeder, der denselben Mandanten verwendet, kann den Polygon-Connector verwenden.

Weitere Informationen finden Sie im Abschnitt Veröffentlichen Ihres Connectors .

Verwenden Sie den Connector in UiPath Studio

Das Erstellen eines benutzerdefinierten Connectors im Integration Service ist nur relevant, wenn Sie ihn tatsächlich in einem Workflow verwenden können.

So testen Sie Ihren benutzerdefinierten Connector in einem Workflow:

1. Öffnen Sie UiPath Studio und erstellen Sie ein neues Projekt. Zum Beispiel die täglichen Aktienpreise von Slack. Da wir tägliche Nachrichten erhalten möchten, ist die erste in diesem Workflow verwendete Aktivität ein Zeit-Trigger.
2. Wenn Sie als Nächstes eine Polygon-Aktivität auf die Canvas ziehen, werden Sie aufgefordert, mit Ihrem Konto eine Verbindung mit Polygon.io herzustellen.
3. Sobald eine Verbindung hergestellt ist, konfigurieren Sie die Aktivität Polygon zum Abrufen von Informationen über Apple-Aktien (AAPL). Sie können die Ressource, für die Sie sich interessieren, hart codieren, aber Sie müssen das Datum so formatieren, dass es das Laufzeitdatum ist.
4. Fügen Sie als Nächstes eine Slack-Aktivität Send Message to Channel hinzu, um diese Informationen an einen Kanal zu senden. Wenn Sie die Informationen an sich selbst senden möchten, verwenden Sie Nachricht an Benutzer senden.

Hinweis:

Die API von Polygon akzeptiert zu einem bestimmten Zeitpunkt nur eine Transaktion. Sie können Studio jedoch so konfigurieren, dass mehrere Aufrufe über den Connector ausgeführt werden und auch die Benachrichtigung über den täglichen Wechselkurs der UiPath-Aktie (PATH) übermittelt wird.