--- sourceDocument: Yokohama Erstellen oder ändern Sie Anwendungen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/application-development Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Erstellen oder ändern Sie Anwendungen ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- Testschritte für benutzerdefinierte UIs ======================================= Testschritte für benutzerdefinierte UIs {#ariaid-title1} ======================================================== * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer 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. Hinweis: Next UI Experience-Seiten werden von anwenderdefinierten UI-Testschritten nicht unterstützt, insbesondere nicht von konfigurierbaren Arbeitsbereichen (mit Ausnahme von Formularschritten) und UI Builder. Testbare Komponenten {#custom-ui-test-steps__section_sd1_rfv_bgb} ----------------------------------------------------------------- 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. : Neue Browserregisterkarten oder -fenster werden von anwenderdefinierten UI-Testschritten nicht unterstützt. 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 Now Platform-Eigenschaften verbunden sind. Sind für den Seiteninspektor zugänglich : Testbare Seitenkomponenten müssen Ergebnisse liefern, wenn sie vom [Seiteninspektor](https://servicenow-prod.fluidtopics.net/dyTmEZu3OaxjYrSAuYB9wA "Identifizieren Sie die HTML- und JavaScript-Seitenkomponenten in Ihren Anwenderoberflächen, die für anwenderdefinierte UI-Tests verfügbar sind. Aktivieren Sie automatisierte Tests, indem Sie sicherstellen, dass Ihre Anwenderoberflächen nur testbare Seitenkomponenten enthalten.") aus betrachtet werden. Testdesigner können den Seiteninspektor verwenden, um die überprüfbaren Komponenten einer Seite zu identifizieren. Beispiele für testbare Seitenkomponenten umfassen diese UI-Elemente. * Schaltflächen * Links * Seitentext * UI-Steuerelemente * UI-Makros * ui_date * ui_date_time * ui_reference {#custom-ui-test-steps__ul_izq_p31_bgb} * UI-Seiten * Assistenten {#custom-ui-test-steps__ul_yl4_nty_4fb} Beispiele für nicht testbare Seitenkomponenten umfassen diese UI-Elemente. {#custom-ui-test-steps__table_j5s_pyy_1gb__entry__2} | Grund nicht testbar | Nicht testbare Seitenkomponenten | |-------------------------------------------------|------------------------------------------------| | Sind nicht einstellbar oder anklickbar | Versteckte Steuerelemente | | Sind nicht einstellbar oder anklickbar | HTML-Kommentare | | Sind nicht einstellbar oder anklickbar | HTML-Layoutelemente wie div, section und span. | | Sind nicht einstellbar oder anklickbar | HTML-Skriptelemente | | Sind aus DOM nicht zugänglich | Dashboards | | Sind aus DOM nicht zugänglich | Bilder | | Sind aus DOM nicht zugänglich | Listen | | Sind aus DOM nicht zugänglich | Berichte | | Sind aus DOM nicht zugänglich | Schatten-DOM | | Sind für JavaScript nicht zugänglich | Excel-Dateien | | Sind für JavaScript nicht zugänglich | Dateifelder | | Sind für JavaScript nicht zugänglich | PDF-Dateien | | Sind Now Platform-Eigenschaften | Flow Designer | | Sind Now Platform-Eigenschaften | Studio | | Sind Now Platform-Eigenschaften | Upgradeüberwachung | | Sind durch andere Testschrittkategorien testbar | Formular-Feldbezeichnungen | | Sind durch andere Testschrittkategorien testbar | Formular-Feldwerte | | Sind durch andere Testschrittkategorien testbar | Servicekatalog | | Sind durch andere Testschrittkategorien testbar | Arbeitsbereiche | [Tabelle : 1. Beispiel für nicht testbare Seitenkomponenten] {#custom-ui-test-steps__table_j5s_pyy_1gb} Einstellbare Seitenkomponenten {#custom-ui-test-steps__section_kmt_kwt_1gb} --------------------------------------------------------------------------- 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. {#custom-ui-test-steps__table_qt2_mqy_1gb__entry__2} | Aktionen für Seiteninspektoren | Testschritte für benutzerdefinierte UIs | |---------------------------------|------------------------------------------------------| | Komponentenwert festlegen | Komponentenwerte festlegen (Benutzerdefinierte UI) | | Komponentenwert abrufen | Bestätigungstext auf Seite (Benutzerdefinierte UI) | | Komponentenwert abrufen | Komponentenwertvalidierung (Benutzerdefinierte UI) | | Ist die Komponente deaktiviert? | Komponentenstatusvalidierung (Anwenderdefinierte UI) | [Tabelle : 2. Testoptionen für einstellbare Komponenten] {#custom-ui-test-steps__table_qt2_mqy_1gb} Einstellbare Komponenten haben einen Datentyp, der 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. Automated Test Framework ermöglicht UI-Entwicklern, einen Datentyp anzugeben, der bei benutzerdefinierten UI-Tests verwendet werden soll. UI-Entwickler können Seitenkomponenten einen Datentyp zuweisen, um sicherzustellen, dass ein Testschritt einen gültigen Wert festlegt. Diese Datentypen werden unterstützt. * Datum * Datum/Uhrzeit * Referenz {#custom-ui-test-steps__ul_vzp_ygv_bgb} Weitere Informationen finden Sie unter [Datentyp der Komponente überschreiben](https://servicenow-prod.fluidtopics.net/a7Zm1b5VzDv~OGVk1WIl8w "Verwenden Sie die Attribute sn-atf-data-type und sn-atf-data-type-params, um den in einem Testschritt „Komponentenwert festlegen“ angezeigten Feldtyp zu überschreiben."). Anklickbare Seitenkomponenten {#custom-ui-test-steps__section_rhc_mwt_1gb} -------------------------------------------------------------------------- Eine klickbare Komponente ist ein UI-Element, mit dem Anwender durch Klicken interagieren können, z. B. Eingaben vom Typ „Kontrollkästchen" oder „Optionsfeld". Anklickbare Komponenten unterstützen diese Testaktionen. {#custom-ui-test-steps__table_fcv_cry_1gb__entry__2} | Aktionen für Seiteninspektoren | Testschritte für benutzerdefinierte UIs | |---------------------------------|------------------------------------------------------| | Anklickbare Komponente | Klickkomponente (Benutzerdefinierte UI) | | Komponentenwert abrufen | Bestätigungstext auf Seite (Benutzerdefinierte UI) | | Komponentenwert abrufen | Komponentenwertvalidierung (Benutzerdefinierte UI) | | Ist die Komponente deaktiviert? | Komponentenstatusvalidierung (Benutzerdefinierte UI) | [Tabelle : 3. Testoptionen für anklickbare Komponenten] {#custom-ui-test-steps__table_fcv_cry_1gb} Anklickbare Komponenten haben keinen Datentyp, da sie keine dynamischen Werte haben. Abgerufene Seitenkomponenten {#custom-ui-test-steps__section_otr_v1k_cgb} ------------------------------------------------------------------------- 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 sn_atf.page_data_capture.enabled aktivieren, um die Liste der Seitenkomponenten jedes Mal zu aktualisieren, wenn ein anwenderdefinierter UI-Testschritt ausgeführt wird. 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 Now 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 {#custom-ui-test-steps__section_kzp_5qb_qfb} --------------------------------------------------------------- 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 `
` oder `
`. Der Bereich hilft Testdesignern bei der Unterscheidung zwischen Komponenten, indem der Ort im Seitenlayout angegeben wird. Eine benutzerdefinierte UI anstatt eine Now Platform-UI testen : Das Automated Test Framework verhindert das Testen von benutzerdefinierten UIs mit Now 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 für Automated Test Frameworkspezifisch sind. Weitere Informationen finden Sie unter [Komponententestaktionen überschreiben](https://servicenow-prod.fluidtopics.net/CQ3~jBKTz9PRe3CQ5PA8ug#develop-testable-components "Ändern Sie die Testeigenschaften einer bestimmten Seitenkomponente mithilfe von HTML-Attributen, die für Automated Test Frameworkspezifisch sind."). 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 {#custom-ui-test-steps__section_oph_4ts_4fb} --------------------------------------------------------------------------------------------- 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. Abbildung : 1. Beispiel Knowledge Base-Artikelseite Für diese Seitenkomponenten sind beispielsweise Testschritte für benutzerdefinierte UIs erforderlich. 1. Die Anzahl der Artikelansichten. 2. Die Schaltflächen zum Markieren des Artikels als Hilfreich. 3. Der Textbereich für Kommentar abgeben. {#custom-ui-test-steps__ol_nkz_p5f_pfb} In diesen Schritten werden Tests für benutzerdefinierte UIs für einen Knowledge Base-Artikel veranschaulicht. Der Beispieltest besteht aus diesen vorhandenen und benutzerdefinierten UI-Testschritten. 1. Zu Modul navigieren. Navigieren Sie zum Modul „Veröffentlicht" in der Anwendung „Knowledge". 2. Bestehenden Datensatz öffnen. Öffnen Sie das Formular „Knowledge" mit der ID „Knowledge: KB0011110". 3. Klicken Sie auf eine UI Action. Klicken Sie auf die UI Action „Artikel anzeigen" im Formular „Knowledge". 4. Bestätigungstext auf Seite (Benutzerdefinierte UI). Bestätigung, dass sich der Text „Entwickler" auf der Seite befindet. 5. Komponentenwerte festlegen (Benutzerdefinierte UI)an. Legen Sie die Komponenten auf der Seite wie folgt fest: „Textarea \ \[article_comments\]" = Mit aktuellem Artikel aktualisieren und nicht mit URL zum Artikel an anderer Stelle. 6. Klickkomponente (Benutzerdefinierte UI)an. Klicken Sie auf die Komponente: „Schaltfläche \: Kommentar". 7. 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. {#custom-ui-test-steps__ol_h5s_brs_4fb} Abbildung : 2. Beispiel für Testschritte für einen Knowledge Base-Artikeltest Version und Reihenfolge der anwenderdefinierten UI-Komponente {#custom-ui-test-steps__section_ptz_sxc_jlb} ---------------------------------------------------------------------------------------------------------- Wenn Sie in einem der anwenderdefinierten UI-Testschritte eine Komponente auswählen, wird möglicherweise die Version der anwenderdefinierten UI angezeigt. Wenn mehrere doppelte Komponenten vorhanden sind, wird die Reihenfolge der Komponenten angezeigt. Hinweis: * Die Version der anwenderdefinierten UI wird nur angezeigt, wenn mindestens zwei verschiedene Komponenten mit unterschiedlichen Versionen der anwenderdefinierten UI vorhanden sind. * Die Reihenfolge wird nur angezeigt, wenn im Dropdown-Menü für Komponenten doppelte Komponenten vorhanden sind. Sie können sie entsprechend der angezeigten Reihenfolge eindeutiger machen. * Sowohl die anwenderdefinierte UI-Version als auch die Reihenfolge werden angezeigt, wenn mehrere doppelte Komponenten aus verschiedenen Versionen vorhanden sind. {#custom-ui-test-steps__ul_fwz_m5k_hcc} Identifizierende Komponenten {#custom-ui-test-steps__section_x4b_nhb_5mb} ------------------------------------------------------------------------- Implementieren Sie eine alternative Methode zur Identifizierung Ihrer Komponente, indem Sie das Attribut sn-atf-id verwenden. Dies ist nützlich, wenn das Attribut name oder id Ihrer Komponente dynamisch ist und sich bei jeder Ausführung eines Tests ändert. Fügen Sie das Attribut sn-atf-id mit einem konsistenten Wert hinzu, damit ATF Ihre Komponente bei der Ausführung eines Tests identifizieren kann. Außerdem können Sie Ihre Komponente beim Erstellen eines Tests identifizieren. Zum Beispiel in einer Schaltflächenkomponente Hinweis: Ab Release Rome : Wenn Sie genau eine Komponente auf der Seite haben, die über das Attribut sn-atf-id verfügt, findet ATF diese Komponente unabhängig von anderen Attributen in dieser Komponente. Verbessern Sie die Identifizierung von ATF-Komponenten {#custom-ui-test-steps__section_acq_qxg_hpb} --------------------------------------------------------------------------------------------------- Identifizieren Sie Ihre Komponente anhand des Bezeichnungspfads, der in der Spalte „Seitenbereich" enthalten ist. Ab Release Rome ist die Eigenschaft `sn_atf.element.use_label_path` standardmäßig auf „true" festgelegt. Wenn eine Komponente über das Attribut `sn-atf-area` verfügt, zeigt die Spalte Seitenbereich den Wert `sn-atf-area an`. Wenn das Attribut `sn-atf-area` nicht vorhanden ist, wird der Bezeichnungspfad für diese Komponente in der Spalte Seitenbereich angezeigt. Hinweis: Wenn Sie mehrere identisch benannte Bezeichnungswerte haben, hilft Ihnen der Bezeichnungspfad, die richtige Komponente zu identifizieren. Wenn eine Komponente kein Attribut `sn-atf-area` oder keinen Bezeichnungspfad hat, wird der Wert als Standard angezeigt. Wenn Sie die erforderliche Komponente aus der Liste auswählen und auf Absendenklicken, wird auch die Beschreibung des Testschritts mit weiteren Details aktualisiert. * **[Seiteninspektor](https://servicenow-prod.fluidtopics.net/dyTmEZu3OaxjYrSAuYB9wA)** Identifizieren Sie die HTML- und JavaScript-Seitenkomponenten in Ihren Anwenderoberflächen, die für anwenderdefinierte UI-Tests verfügbar sind. Aktivieren Sie automatisierte Tests, indem Sie sicherstellen, dass Ihre Anwenderoberflächen nur testbare Seitenkomponenten enthalten. * **[Den Seiteninspektor aktivieren und verwenden](https://servicenow-prod.fluidtopics.net/_OOiDcJJT5gEbgd02BMIBg)** Aktivieren Sie eine Entwicklereinstellung, um die innerhalb der Plattform geöffneten UI-Seiten zu überprüfen. Mit dem manuellen Seiteninspektor können Sie Seiten prüfen, die auf einer neuen Registerkarte geöffnet werden, z. B. Serviceportal-Seiten. * **[Erstellen Sie einen anwenderdefinierten UI-Test](https://servicenow-prod.fluidtopics.net/Gy2wih3qBWJgpj46SoFmBw)** Testen Sie Komponenten in benutzerdefinierten UI-Seiten. * **[Komponententestaktionen überschreiben](https://servicenow-prod.fluidtopics.net/CQ3~jBKTz9PRe3CQ5PA8ug#develop-testable-components)** Ändern Sie die Testeigenschaften einer bestimmten Seitenkomponente mithilfe von HTML-Attributen, die für Automated Test Frameworkspezifisch sind. * **[Datentyp der Komponente überschreiben](https://servicenow-prod.fluidtopics.net/a7Zm1b5VzDv~OGVk1WIl8w)** Verwenden Sie die Attribute `sn-atf-data-type` und `sn-atf-data-type-params`, um den in einem Testschritt „Komponentenwert festlegen" angezeigten Feldtyp zu überschreiben. * **[Select2-Funktionen in ATF](https://servicenow-prod.fluidtopics.net/E2eXq7yp4sRPu_NAvLX1PQ)** Verwenden Sie die Komponente Auswählen2, um Ihre Option einfach in einem Dropdown-Menü zu suchen und auszuwählen.