API-Testautomatisierung

Studio unterstützt die API-Testautomatisierung über den Assistenten Neue Dienste. Sie können API-Definitionen in verschiedenen API-Formaten importieren und testen, einschließlich Swagger-Formaten und anderen. Mit den API-Testautomatisierungsfunktionen von Studio können Sie automatisierte Tests für verschiedene Dienste erstellen, verwalten und ausführen.

Nach dem Import können Sie mithilfe von Dienstdefinitionen in Testautomatisierungsprojekten Endpunkte, Antworten und Verhaltensweisen validieren. Sie können Dienstbibliotheken auch als Pakete .nupkg veröffentlichen – entweder lokal oder in Orchestrator – und sie als Abhängigkeiten in Ihren Testworkflows wiederverwenden.

Studio unterstützt auch Postman als zusätzliche Option für das Importieren von API-Sammlungen. Um eine Sammlung zu importieren, generieren Sie einen API-Schlüssel in Ihrem Postman-Konto und verwenden Sie ihn im Assistenten Neuer Dienst . Studio ist in Newman integriert, das Befehlszeilenprogramm von Postman, sodass Sie Sammlungen direkt über die Befehlszeile validieren können. Weitere Informationen zu den Postman-Anforderungen finden Sie unter Postman-Sammlungen.

Verwenden des Assistenten für neue Dienste für die API-Testautomatisierung

Dieses Beispiel zeigt, wie Sie mithilfe des Assistenten Neuer Dienst mit der API-Testautomatisierung beginnen können, indem Sie entweder eine Swagger-JSON-Datei in Studio oder einen Swagger-Link laden.

Voraussetzungen

Um diesem Beispiel zu folgen, müssen Sie eine der folgenden Ressourcen verfügbar haben:

• Eine aus Swagger exportierte JSON-Datei, die sich auf Ihrer Maschine befindet.
• Ein Link zu einer Swagger-Datei.

Schritte

1. Wählen Sie in Ihrem Bibliotheksprojekt aus dem Menüband Design die Option Neuer Dienst aus.

   Das Fenster Dienst-Editor wird angezeigt.

2. Wählen Sie eine Swagger-Ressource aus, die Sie verwenden möchten:
   • Wählen Sie für eine lokale JSON-Swagger-Datei das Menü Weitere Optionen neben dem Feld Datei oder Link aus. Suchen und öffnen Sie die gewünschte Swagger-Datei, die importiert werden soll.
   • Wenn Sie einen Link zu einer Swagger-Datei verwenden, geben Sie den Swagger-Link direkt in das Feld Datei oder Link ein.
3. Wählen Sie im Dienst-Editor die Option Laden aus.

   Alle definierten Endpunkte aus der Swagger-Datei werden nun im Dienst-Editor geladen.

4. Geben Sie die benötigte Methode oder den benötigten Vorgang in das Suchfeld Suchvorgänge ein und zeigen Sie die zurückgegebenen Ergebnisse an.

   Bei Swagger-Dateien werden die Methoden für jeden Endpunkt, den Sie laden möchten, mit verschiedenen Farben gekennzeichnet.

   Der Namespace wird automatisch generiert, Sie können ihn jedoch bearbeiten.

5. Wählen Sie Speichern aus, um den Dienst in Ihre Bibliothek zu integrieren.

Abbildung 1. Eine geladene Swagger-Datei im Dienst-Editor

Beispiel für einen API-Test mit Postman

Im folgenden Beispiel wird eine in Postman definierte Datensammlung verwendet, in eine Studio-Bibliothek importiert, die Bibliothek mit der Sammlung veröffentlicht, in einem Testprojekt installiert und Testaktivitäten im UiPath.Testing.Activities-Paket verwendet, um die Datennutzung zu überprüfen.

Die Testfälle sind für einen Workflow konzipiert, der automatisch Kredite anwendet und Kreditdaten für Bankkunden abruft.

Informationen zu Postman- und Newman-Installationsvoraussetzungen finden Sie auf dieser Seite.

Definieren einer Datensammlung

Definieren Sie in Postman entweder eine Datensammlung, oder importieren Sie eine vorhandene Datensammlung in Ihren aktuellen Arbeitsbereich. Wir haben eine Datensammlung zum Beantragen eines Darlehens sowie zum Abrufen und Löschen von Kreditdetails erstellt. Bei Verwendung in einem API-Testprojekt überprüft diese Sammlung, ob die Logik unseres Workflows korrekt ist.

Importieren von Sammlungen

Um eine Sammlung in Studio zu importieren, erstellen Sie ein Bibliotheksprojekt und verwenden Sie das Fenster Neuer Dienst. Der Zugriff auf die Sammlung wird über den Postman API-Schlüssel gewährt. Fügen Sie diesen Schlüssel im Feld Datei oder Link hinzu und klicken Sie auf Laden.

Wählen Sie nur die Endpunkte aus, die Sie in Ihr Projekt laden möchten, und fügen Sie bei Bedarf einen neuen Namespace hinzu.

Aktivieren Sie das Kontrollkästchen Verknüpfte Sammlungen, damit ein Link verwendet wird, um die neueste Version Ihrer Sammlung zur Laufzeit anstatt eine lokal gespeicherte Version auszuführen. Klicken Sie auf Speichern, wenn Sie fertig sind.

Verwenden von Datensammlungen

Nachdem die Sammlung in die Studio-Bibliothek importiert wurde, werden ihre Endpunkte automatisch in Aktivitäten umgewandelt, die auf der Registerkarte Aktivitäten unter dem zuvor festgelegten Namespace verfügbar sind.

In unserem Beispiel wurde für jede Aktivität, die von den Endpunkten generiert wird, eine separate Sequenzdatei erstellt.

Fügen Sie nach dem Hinzufügen einer Aktivität die Postman-Umgebung (zwischen Anführungszeichen "") im Bedienfeld Eigenschaften hinzu.

Datenwerte, die in der Postman-Sammlung definiert sind, werden als Argumente importiert:

Bibliotheken können lokal oder in Orchestrator als .nupkg-Paket veröffentlicht werden.

Laden der Bibliothek im API-Testprojekt

1. Erstellen Sie ein Testprojekt in Studio mit dem Projekttyp Testautomatisierung.
   
   

   

   
   
2. Installieren Sie die veröffentlichte Bibliothek als Abhängigkeit mithilfe des Fensters Pakete verwalten.
   
   

   

   
   
3. Sequenzdateien, die zuvor in der Bibliothek definiert wurden, sind jetzt im Bedienfeld Aktivitäten unter dem Namespace der Bibliothek zusammen mit Aktivitäten verfügbar, die aus dem Postman-Import generiert wurden.
   
   

   

   
   
4. Verwenden Sie diese Aktivitäten in Ihrem API-Testautomatisierungsprojekt in Kombination mit Aktivitäten, die Teil des UiPath.Testing.Activities-Pakets sind. Wir haben ein Testprojekt erstellt, um die bei der Beantragung eines Darlehens in unserer Demo-Anwendung eingegebenen Daten zu überprüfen. Dieser kleine Test verwendet einen Satz von hartcodierten Variablen, die hier im Bedienfeld Eigenschaften sichtbar sind:
   
   

   

   
   

   Dieser einfache Testprozess wurde als Rauchtest verwendet, um zu überprüfen, ob die Anwendung korrekt reagiert hat. Je nach Ihren Automatisierungsanforderungen können in Studio mehrere solcher Tests erstellt werden.

5. Um mehrere Szenarien in einem Testprojekt zu überprüfen, wechseln Sie zum Menüband „Neue > Datengesteuerter Testfall“. Importieren Sie das Dataset, wie hier erläutert. Im Folgenden finden Sie ein Beispiel für einen solchen Testfall. Die Werte werden nun in Argumenten gespeichert und in der Aktivität zugeordnet.
   
   

   

   
   
6. Wählen Sie Datei ausführen oder Datei mit Datenvarianten debuggen aus, und wählen Sie die zu verwendenden Daten. Dies ist hilfreich, wenn Sie mehrere Szenarien mit mehreren Datensätzen testen.
   
   

   

   
   

7. Nach dem Ausführen des Prozesses werden die Ergebnisse im Bedienfeld Ausgabe angezeigt.