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.

   
   

   

   
   

Using a Swagger file or link

This example shows how to perform API Test Automation by loading either a Swagger JSON file in Studio or a Swagger link.

Voraussetzungen

To follow this example, you need to have one of the following resources available:

• A JSON file exported from Swagger, that is located on your machine.
• A link to a Swagger file.

Schritte

1. In your library project, from the Design ribbon, select New Service.

   The Service Editor window is displayed.

2. Choose a Swagger resource you want to use:
   • For a local JSON Swagger file, select the More Options menu adjacent to the File or Link field. Browse and open the desired Swagger file to import.
   • If you are using a link to a Swagger file, enter the Swagger link directly into the File or Link field.
3. In the Service Editor, select Load.

   All defined endpoints from the Swagger file are now loaded in the Service Editor.

4. Type in the method or operation you need in the Search Operations search box and view the returned results.

   For Swagger files, the methods are marked with different colors for each endpoint that you want to load.

   The namespace is generated automatically, but you can edit it.

5. Select Save to integrate the service into your library.

Figure 1. A loaded Swagger file in the Service Editor