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 von uns entworfene Workflow ist dazu gedacht, täglich Slack-Nachrichten zu interessantenAktienpreisen zu erhalten. Polygon.io bietet eine Reihe kostenloser APIs, die Bestandsinformationen abrufen und für unsere Zwecke verwendet werden können. Sie haben einen schnellen Anmeldeprozess, der uns im Gegenzug einen API-Schlüssel zur Verfügung stellt, um die API-Aufrufe zu starten, die wir machen müssen.

Hinweis:

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

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

Within Automation Suite, navigate to Integration Service and select Build your connector.

Beginnen wir mit einem leeren Connector. Wenn Sie eine Form der API-Definition zur Hand haben (Swagger, YAML usw.), können Sie Mit API-Definition beginnen auswählen und den Connector-Generator die meisten Konfigurationsarbeiten für Sie erledigen lassen.

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 aus.

Richten Sie die Authentifizierung ein und stellen Sie die Verbindung her

In der Dokumentation „Erste Schritte“ mit Polygon wird darauf verwiesen, dass jeder API-Aufruf an ihre Plattform erfordert, dass Sie Ihren API-Schlüssel in den Headern oder als Abfrageparameter senden. Dazu müssen Sie sie zu den Headern hinzufü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 folgender Form hinzufügen, wobei <your_token> der API-Schlüssel ist:

   Authorization: Bearer <your_token>

3. Navigieren Sie im Connector-Generator zu Einstellungen und wählen Sie die Registerkarte Basis-API aus. Legen Sie die Basis-URL auf https://api.polygon.io.
   Hinweis: In diesem Beispiel fügen wir den Abschnitt version "v2" nicht zur Basis-URL hinzu. Dadurch können wir einige der älteren 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, befindet er sich tatsächlich näher an einem OAuth-Token. Daher ist Persönliches Zugriffstoken (Personal Access Token, PAT) die technisch bessere Definition. Lesen Sie mehr über die verschiedenen Authentifizierungstypen.

5. Kopieren Sie Ihren API-Schlüssel aus 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. Wenn Sie den Connector jedoch über den Mandanten hinaus freigeben möchten, fügen Sie nicht Ihren 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 Großteil der Arbeit für Sie. Beispielsweise sendet Persönliches Zugriffstoken automatisch Authorisierung: Bearer <your_token> als Authentifizierungsheader, ohne dass Sie diese Konfiguration selbst erstellen müssen.

   
   

   

   
   
7. Richten Sie eine Verbindung mit der obigen 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, sodass Sie eine Testverbindung haben, an die Sie API-Aufrufe tätigen 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 linken Bereich zu API > Neue Ressourcengruppe erstellen. Das Ziel ist es, eine tägliche Slack-Benachrichtigung zum Eröffnungspreis einer bestimmten Aktion 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}.
4. Aktivieren Sie in der Liste Methoden auswählen die Option Datensatz abrufen (GETBYID), da wir ein einzelnes Objekt und nicht ein Array 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 Anwendungsbeispiel in den Polygon-Dokumenten entnehmen.
   
   

   

   
   

Veröffentlichen Sie den Connector im Katalog

Mit ein paar zusätzlichen Schritten können Sie das Aussehen und Verhalten von Ressourcen und Parametern verbessern. Ermitteln Sie beispielsweise, dass der Parameter Date vom Typ DateTime ist, und geben Sie die Maske als Beispiel an. Durch die Angabe von Anzeigenamen wird Ihr Connector in der Studio-Aktivität besser angezeigt. Ein Beispiel finden Sie im folgenden Screenshot

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 in Ihrem Mandanten angezeigt, und jeder, der denselben Mandanten verwendet, kann den Polygon-Connector sehen und verwenden.

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

Verwenden Sie den Connector in UiPath Studio

Die Anzeige eines 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 Slack-Aktienpreise. Da wir tägliche Nachrichten erhalten möchten, ist die erste in diesem Workflow verwendete Aktivität ein Time 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 Send Message to User.

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 über den täglichen Aktionskurs von UiPath (PATH) informiert werden.

Ihr Flow sollte wie folgt aussehen: