API-Testautomatisierung

Studio unterstützt API-Testautomatisierungsprojekte durch die Integration mit Postman, einem Softwareentwicklungstool zum Ausführen von Testaufrufen an APIs. Diese Integration beinhaltet auch Newman, ein Ausführungsprogramm für Kommandozeilen-Sammlungen für Postman zum Ausführen und Testen einer Sammlung direkt über die Befehlszeile.

Um eine Sammlung von Postman in Studio zu importieren, verwenden Sie den Assistenten Neuer Dienst für Bibliotheken und greifen Sie mit einem allgemeinen API-Schlüssel, den Sie im Abschnitt API-Schlüssel generieren können, auf die Postman-Sammlung zu.

Importierte Sammlungen können zum Testen von Projekten verwendet werden. Details zu den Voraussetzungen für Postman finden Sie hier.

Im Rahmen des Testens können in Studio-Bibliotheken importierte Postman-Sammlungen als .nupkg-Paket lokal oder im Orchestrator veröffentlicht und dann als Abhängigkeiten in Testautomatisierungsprojekten installiert werden.

Beispiel für API-Testautomatisierung

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.

   
   

   

   
   

Verwenden einer Swagger-Datei oder eines Swagger-Links

Dieses Beispiel zeigt, wie eine API-Testautomatisierung durchgeführt wird, indem entweder eine Swagger JSON-Datei in Studio oder ein Swagger-Link geladen wird.

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