Testschritte für benutzerdefinierte UIs
Testen Sie angepasste Benutzeroberflächen wie UI-Seiten und UI-Makros, indem Sie deren HTML- und JavaScript-Seitenkomponenten abrufen und die von ihnen unterstützten Testaktionen identifizieren.
Testschritte für benutzerdefinierte UIs erfordern, dass das Automated Test Framework die testbaren Komponenten von einer Zielwebseite abruft und identifiziert.
Testbare Komponenten
Testbare Seitenkomponenten bestehen aus Standard-HTML und JavaScript mit folgenden Eigenschaften.
- Werden durch Benutzerinteraktion festgelegt oder angeklickt
- Testbare Seitenkomponenten ermöglichen es Benutzern, einen Wert festzulegen oder darauf zu klicken.
- Sind vom Document Object Model (DOM) aus zugänglich
- Testbare Seitenkomponenten sind vom DOM aus zugänglich und unterstützen die JavaScript-Bearbeitung des DOM. Testschritte für benutzerdefinierte UIs können nicht auf Seitenkomponenten im Schatten-DOM zugreifen.
- Sind für JavaScript zugänglich
- Testbare Seitenkomponenten sind für JavaScript zugänglich. Anwenderdefinierte UI-Testschritte können nicht auf Seitenkomponenten zugreifen, die direkt mit dem Betriebssystem interagieren, z. B. Dateifelder, oder nicht-HTML-Inhalte wie Excel- oder PDF-Dateien anzeigen.
- Sind nicht von benutzerdefinierten UI-Tests ausgeschlossen
- Testbare Seitenkomponenten sind nicht von benutzerdefinierten UI-Tests ausgeschlossen. Das Automated Test Framework schließt Seitenkomponenten aus, die bereits von anderen Testschrittkategorien getestet werden können, und schließt auch Seitenkomponenten aus, die mit ServiceNow AI Platform-Eigenschaften verbunden sind.
- Sind für den Seiteninspektor zugänglich
- Testbare Seitenkomponenten müssen Ergebnisse liefern, wenn sie vom Seiteninspektor aus betrachtet werden. Testdesigner können den Seiteninspektor verwenden, um die überprüfbaren Komponenten einer Seite zu identifizieren.
- Schaltflächen
- Links
- Seitentext
- UI-Steuerelemente
- UI-Makros
- ui_date
- ui_date_time
- ui_reference
- UI-Seiten
- Assistenten
Beispiele für nicht testbare Seitenkomponenten umfassen diese UI-Elemente.
| Grund nicht testbar | Nicht testbare Seitenkomponenten |
|---|---|
| Sind nicht einstellbar oder anklickbar | Versteckte Steuerelemente |
| HTML-Kommentare | |
| HTML-Layoutelemente wie div, section und span. | |
| HTML-Skriptelemente | |
| Sind aus DOM nicht zugänglich | Dashboards |
| Bilder | |
| Listen | |
| Berichte | |
| Schatten-DOM | |
| Sind für JavaScript nicht zugänglich | Excel-Dateien |
| Dateifelder | |
| PDF-Dateien | |
| Sind ServiceNow AI Platform-Eigenschaften | Flow Designer |
| Studio | |
| Upgradeüberwachung | |
| Sind durch andere Testschrittkategorien testbar | Formular-Feldbezeichnungen |
| Formular-Feldwerte | |
| Servicekatalog | |
| Arbeitsbereiche |
Einstellbare Seitenkomponenten
Eine einstellbar Komponente ist ein UI-Element, das über einen dynamischen Wert verfügt, beispielsweise ein Texteingabefeld. Einstellbare Komponenten unterstützen diese Testaktionen und Testschritte.
| Aktionen für Seiteninspektoren | Testschritte für benutzerdefinierte UIs |
|---|---|
| Komponentenwert festlegen | Komponentenwerte festlegen (Benutzerdefinierte UI) |
| Komponentenwert abrufen | Bestätigungstext auf Seite (Benutzerdefinierte UI) |
| Komponentenwertvalidierung (Benutzerdefinierte UI) | |
| Ist die Komponente deaktiviert? | Komponentenstatusvalidierung (Anwenderdefinierte UI) |
Einstellbare Komponenten haben einen Datentyp Das bestimmt, welche Werte ein anwenderdefinierter UI-Testschritt festlegen kann. Beispielsweise kann eine Seitenkomponente, die eine Referenz auf einen bestimmten Datensatz anzeigen soll, einen Referenzdatentyp haben, der nur Sys-ID-Werte anzeigt.
- Datum
- Datum/Uhrzeit
- Referenz
Weitere Informationen finden Sie unter Datentyp der Komponente überschreiben.
Anklickbare Seitenkomponenten
A Anklickbar Die Komponente ist ein UI-Element, mit dem Anwender interagieren können, indem sie auf klicken, z. B. Eingaben vom Typ „Kontrollkästchen“ oder „Optionsfeld“. Anklickbare Komponenten unterstützen diese Testaktionen.
| Aktionen für Seiteninspektoren | Testschritte für benutzerdefinierte UIs |
|---|---|
| Anklickbare Komponente | Klickkomponente (Benutzerdefinierte UI) |
| Komponentenwert abrufen | Bestätigungstext auf Seite (Benutzerdefinierte UI) |
| Komponentenwertvalidierung (Benutzerdefinierte UI) | |
| Ist die Komponente deaktiviert? | Komponentenstatusvalidierung (Benutzerdefinierte UI) |
Anklickbare Komponenten haben keinen Datentyp, da sie keine dynamischen Werte haben.
Abgerufene Seitenkomponenten
Automated Test Framework speichert eine Liste der abgerufenen Seitenkomponenten für jede benutzerdefinierte UI-Seite, die Sie testen. Testschritte für benutzerdefinierte UIs zeigen die Liste der abgerufenen Komponenten aus den Feldern Komponente und Komponentenwerte an.
Standardmäßig ist die Liste der Seitenkomponenten statisch und wird nur aktualisiert, wenn Testdesigner manuell auf Komponenten abrufen klicken. Administratoren können die Systemeigenschaft aktivieren sn_atf.page_data_capture.enabledZum Aktualisieren der Liste der Seitenkomponenten bei jeder Ausführung eines anwenderdefinierten UI-Testschritts. Durch die Aktivierung dieser Eigenschaft während des Testdesigns wird sichergestellt, dass Ihre Testdesigner immer Zugriff auf die aktuellste Liste der Seitenkomponenten haben. Durch Deaktivieren dieser Eigenschaft nach Abschluss des Testdesigns können Ihre Tests schneller ausgeführt werden, da Testschritte die zuvor abgerufene Liste der Seitenkomponenten verwenden können.
Das ServiceNow AI Platform behandelt die Liste der abgerufenen Seitenkomponenten als Daten und schließt sie nicht in Update-Sets oder Anwendungsdateien ein. Beim Übertragen von Tests von einer Instanz auf eine andere müssen Testdesigner die Seitenkomponenten erneut manuell abrufen.
Designüberlegungen
Folgen Sie diesen Designüberlegungen, wenn Sie benutzerdefinierte UI-Seiten und Seitenkomponenten testen.
- Mit dem Seiteninspektor testbare Seitenkomponenten identifizieren
- Der Seiteninspektor bestimmt, welche Seitenkomponenten für benutzerdefinierte UI-Tests verfügbar sind. Für den Seiteninspektor nicht verfügbare Seitenkomponenten stehen für benutzerdefinierte UI-Tests nicht zur Verfügung.
- Zur benutzerdefinierten UI navigieren, die Sie testen möchten
- Verwenden Sie vorhandene Testschritte, um zur benutzerdefinierten Ziel-UI zu navigieren. Verwenden Sie zum Testen eines Knowledge Base-Artikels die vorhandenen Testschritte, um zu einem Modul zu navigieren oder einen vorhandenen Datensatz zu öffnen. Die meisten benutzerdefinierten UI-Tests erfordern die Verwendung vorhandener Testschrittkategorien als Teil des Tests.
- Mit dem Komponentenbereich Seitenkomponenten identifizieren
- Der Komponentenbereich beschreibt das HTML-Layoutelement, das die Komponente enthält, z. B. ein Element
<div>oder<section>. Der Bereich hilft Testdesignern bei der Unterscheidung zwischen Komponenten, indem der Ort im Seitenlayout angegeben wird. - Eine benutzerdefinierte UI anstatt eine ServiceNow AI Platform-UI testen
- Das Automated Test Framework verhindert das Testen von benutzerdefinierten UIs mit ServiceNow AI Platform-Eigenschaften. Sie können beispielsweise keine Dashboards oder grafischen Designer testen. Erstellen Sie stattdessen Tests, um Ihre benutzerdefinierten UI-Seiten und -Elemente zu testen, da Sie diese UIs direkt steuern können.
- Mit HTML-Attributen die Testeigenschaften von Seitenkomponenten überschreiben
- Ändern Sie die Testeigenschaften einer bestimmten Seitenkomponente mithilfe von HTML-Attributen, die spezifisch für sind Automated Test Framework. Weitere Informationen finden Sie unter Komponententestaktionen überschreiben.
- Seitenkomponenten erneut abrufen, wenn Sie Tests in eine andere Instanz verschieben
- Testschritte für benutzerdefinierte UIs speichern UI-Komponenten nicht als Metadaten. Tester müssen die Seitenkomponenten erneut manuell abrufen, wenn Tests zwischen Instanzen verschoben werden.
Beispiel für Testen einer benutzerdefinierten UI
Sie können die Liste der abgerufenen Komponenten verwenden, um Testschritte für benutzerdefinierte UIs zu entwerfen. Angenommen, Sie möchten einen Knowledge Base-Artikel überprüfen und kommentieren. Ein Knowledge Base-Artikel enthält mehrere Seitenkomponenten, für die zum Testen Testschritte für benutzerdefinierte UIs erforderlich sind.
- Die Anzahl der Artikelansichten.
- Die Schaltflächen zum Markieren des Artikels als Hilfreich.
- Der Textbereich für Kommentar abgeben.
- Zu Modul navigieren. Navigieren Sie zum Modul „Veröffentlicht“ in der Anwendung „Knowledge“.
- Bestehenden Datensatz öffnen. Öffnen Sie das Formular „Knowledge“ mit der ID „Knowledge: KB0011110“.
- Klicken Sie auf eine UI Action. Klicken Sie auf die UI Action „Artikel anzeigen“ im Formular „Knowledge“.
- Bestätigungstext auf Seite (Benutzerdefinierte UI). Bestätigung, dass sich der Text „Entwickler“ auf der Seite befindet.
- Komponentenwerte festlegen (Benutzerdefinierte UI)an. Legen Sie die Komponenten auf der Seite wie folgt fest: „Textarea <textarea> [article_comments]“ = Mit aktuellem Artikel aktualisieren und nicht mit URL zum Artikel an anderer Stelle.
- Klickkomponente (Benutzerdefinierte UI)an. Klicken Sie auf die Komponente: „Schaltfläche <button>: Kommentar“.
- Bestätigungstext auf Seite (Benutzerdefinierte UI). Bestätigen Sie, dass sich der Text „Mit aktuellem Artikel aktualisieren und nicht mit URL zum Artikel an anderer Stelle“ auf der Seite befindet.
Version und Reihenfolge der anwenderdefinierten UI-Komponente
Wenn Sie eine Komponente in einem der anwenderdefinierten UI-Testschritte auswählen, wird möglicherweise die anwenderdefinierte UI-Version angezeigt. Wenn mehrere doppelte Komponenten vorhanden sind, wird die Reihenfolge der Komponenten angezeigt.
- Die anwenderdefinierte UI-Version wird nur angezeigt, wenn mindestens zwei verschiedene Komponenten mit verschiedenen anwenderdefinierten UI-Versionen vorhanden sind.
- Die Reihenfolge wird nur angezeigt, wenn im Dropdown-Menü für Komponenten doppelte Komponenten vorhanden sind. Sie können sie gemäß der angezeigten Reihenfolge unterscheiden.
- Sowohl die anwenderdefinierte UI-Version als auch die Reihenfolge werden angezeigt, wenn mehrere doppelte Komponenten aus verschiedenen Versionen vorhanden sind.
Komponenten werden identifiziert
<button sn-atf-id="consistentValue">Test</button>Verbessern Sie die Identifizierung von ATF-Komponenten
Identifizieren Sie Ihre Komponente mithilfe des Bezeichnungspfads, der in enthalten ist Seitenbereich Spalte. Beginnend mit RomeRelease, sn_atf.element.use_label_path Eigenschaft wurde standardmäßig auf „wahr“ festgelegt.
Wenn eine Komponente über verfügt sn-atf-Bereich Attribut, Seitenbereich Spalte zeigt an sn-atf-Bereich Wert. Wenn sn-atf-Bereich Attribut ist nicht vorhanden, der Bezeichnungspfad für diese Komponente wird in der Spalte „Seitenbereich“ angezeigt.
sn-atf-Bereich Attribut oder ein Bezeichnungspfad, der Wert wird als Standard angezeigt.Wenn Sie die erforderliche Komponente aus der Liste auswählen und auf klicken Übermitteln , Die Beschreibung des Testschritts wird auch mit weiteren Details aktualisiert.