---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PolarisUI -- Umfang

# PolarisUI -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die PolarisUI API stellt Methoden zum Aktivieren bereit Next ExperienceAuf direkten UI-Seiten.

Eine UI-Seite \[sys_ui_page\] ist direkt, wenn der Direkt Feld ist Ausgewählt . Eine direkte UI-Seite enthält nicht die allgemeine HTML-Seitenvorlage und muss alle CSS- und JavaScript-Elemente enthalten, die Sie auf der Seite verwenden möchten.

Alle nicht direkten UI-Seiten werden verwendet Next ExperienceStandardmäßig.

Für weitere Informationen zu Next Experience, Siehe [Die Next Experience-UI](https://www.servicenow.com/docs/access?context=next-experience-landing-page&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).

Die PolarisUI API wird in bereitgestellt `sn_ui `Namespace.

## PolarisUI -- canUsePolarisCSS() {#ariaid-title2}

Überprüft, ob die aktuelle Seite verwenden kann Next ExperienceUI.
Diese Methode gibt zurück `Wahr `Wenn alle der folgenden Bedingungen erfüllt sind.

* sn_ui.PolarisUI.isEnabled() Ist `Wahr `.
* Der Anforderungs-URL-Parameter sysparm_use_polarisIst nicht auf festgelegt `Falsch `.
* Der Header der Referrer-HTTP-Anforderung enthält nicht `Sysparm_use_polaris=falsch `.
* Die Verwendung der Seite oder ihres übergeordneten Plugins wird nicht verweigert Next ExperienceDurch einen Datensatz in der Tabelle „Unterstützung von Seitenthemen" \[sys_page_Theme\].
{#PolarisUI-canUsePolarisCSS__ul_acr_xnb_vrb}

Verwenden Sie diese Methode, um das Verhalten oder bedingt zu ändern [Gelee](https://www.servicenow.com/docs/access?context=r_JellyTags&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Ausgabe, wenn Next ExperienceIst aktiviert.
{#PolarisUI-canUsePolarisCSS__table_vzz_nkq_prb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#PolarisUI-canUsePolarisCSS__table_vzz_nkq_prb} {#PolarisUI-canUsePolarisCSS__table_wzz_nkq_prb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die aktuelle Seite verwenden kann Next ExperienceUI. Gültige Werte: * Wahr: Die aktuelle Seite kann verwenden Next ExperienceUI. * Falsch: Die aktuelle Seite kann nicht verwenden Next ExperienceUI. {#PolarisUI-canUsePolarisCSS__ul_pgy_hv2_5rb} |
[Tabelle : 2. Rückgaben]

{#PolarisUI-canUsePolarisCSS__table_wzz_nkq_prb}  
Diese UI-Aktion leitet bei zu einer anderen Seite um Next ExperienceWird im aktuellen Formular ausgeführt.

    var id = current.getUniqueValue();
    if (sn_ui.PolarisUI.canUsePolarisCSS())
    	action.setRedirectUrl("/now/custom/application/record/" + id);
    return "/record.do?sys_id=" + id;

Dieses Jelly-Skript legt ein anderes Stylesheet für Seiten mit fest Next Experience.

    <g:evaluate var="jvar_css_path">
    	// Core UI content css record
    	var id = "5e8fde63d713310074304187ed61030d";

    	if (sn_ui.PolarisUI.canUsePolarisCSS())
    		id = "84f03cc87120a00cfab6dd207cb0b72";
    	
    	"/" + id + ".cssdbx";
    </g:evaluate>
    <link href="${jvar_css_path}" rel="stylesheet" type="text/css" />

## PolarisUI -- getBodyClassNames() {#ariaid-title3}

Gibt eine Liste von CSS-Klassennamen zurück, die von verwendet werden Next ExperienceUI.
Verwenden Sie diese Methode im HTML-Format `<body>`Tag einer UI-Seite, für die die erforderlichen CSS-Klassen festgelegt werden sollen Next ExperienceUm richtig zu rendern.

    <body class="$[sn_ui.PolarisUI.getBodyClassNames()]">

Die zurückgegebenen Klassennamen ändern sich je nach Systemeigenschaften und ob eine Sitzungs-Debug-Ausgabe vorhanden ist.
{#PolarisUI-getBodyClassNames__table_hkn_1lq_prb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#PolarisUI-getBodyClassNames__table_hkn_1lq_prb} {#PolarisUI-getBodyClassNames__table_ikn_1lq_prb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Liste der CSS-Klassennamen, die von verwendet werden Next ExperienceUI. |
[Tabelle : 4. Rückgaben]

{#PolarisUI-getBodyClassNames__table_ikn_1lq_prb}  
Dieses Jelly-Skript fügt hinzu Next ExperienceZu einer anwenderdefinierten UI-Seite.

    <?xml version="1.0" encoding="utf-8" ?>
    <j:jelly trim="true" xmlns:j="jelly:core" xmlns:g="glide" xmlns:g2="null">
        <g2:doctype name="html" />
        <g:inline template="dir_checker.xml"/>
        <html class="${jvar_text_direction}" lang="$[gs.getSession().getLanguage()]">
            <head>
                <g:inline template="set_theme_vars.xml" /> <!-- sets jvar_theme and jvar_css_cache_key -->
                <g:requires name="styles/css_includes_my_app.css" includes="true" params="$[jvar_css_cache_key]" /> 
                <g:if_polaris>
    	<g:then><g:inline template="polarisberg_output.xml"/></g:when>
    	<g:else><g:inline template="heisenberg_output.xml" type="css"/></g:else>
                 </g:if_polaris>
            </head>
            <body class="$[sn_ui.PolarisUI.getBodyClassNames()]">
                Your UI page content here
            </body>
        </html>
    </j:jelly>

## PolarisUI -- isEnabled() {#ariaid-title4}

Überprüft, ob Next ExperienceUI ist für den aktuellen Anwender aktiviert.
Diese Methode überprüft, ob glide.ui.polaris.experienceSystemeigenschaft und glide.ui.polaris.useAnwendereinstellungen sind beide auf festgelegt Wahr .

* glide.ui.polaris.experienceAktiviert Next ExperienceAuf der Instanz.
* glide.ui.polaris.useDeaktiviert Next ExperienceFür angegebene Anwender, wenn auf festgelegt Falsch .

{#PolarisUI-isEnabled__ul_hrj_nq2_5rb}Für weitere Informationen zu Next ExperienceSystemeigenschaften und Anwendereinstellungen, siehe [Next Experience-Systemeigenschaften](https://www.servicenow.com/docs/access?context=pol-sys-properties&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US).  
Hinweis:  
Diese Methode gibt „wahr" zurück, auch wenn Next ExperienceIst für die aktuelle Seite deaktiviert. Diese Methode ist nützlich, wenn ganze Experiences bedingt aktiviert oder zu verschiedenen Seiten umgeleitet werden sollen Next ExperienceIst global aktiviert.
{#PolarisUI-isEnabled__table_ljc_djq_prb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#PolarisUI-isEnabled__table_ljc_djq_prb} {#PolarisUI-isEnabled__table_mjc_djq_prb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob Next ExperienceUI ist für den aktuellen Anwender aktiviert. Gültige Werte: * Wahr: Die Next ExperienceUI ist für den aktuellen Anwender aktiviert. * Falsch: Der Next ExperienceUI ist für den aktuellen Anwender nicht aktiviert. {#PolarisUI-isEnabled__ul_pgy_hv2_5rb} |
[Tabelle : 6. Rückgaben]

{#PolarisUI-isEnabled__table_mjc_djq_prb}  
Auf dieser UI-Seite wird dem Anwender eine bedingte Nachricht angezeigt, wenn Next ExperienceIst für den aktuellen Anwender aktiviert.

    <j:if test="${sn_ui.PolarisUI.isEnabled()}">
    	<a href="...">Click here to learn more about the new UI changes</a>
    </j:if>

Diese Business-Regel zeigt eine Infonachricht in der Datensatzanzeige an, auf die ein Anwender klicken kann, um den Datensatz in anzuzeigen Core-UIAnstelle von Next Experience. Die Business-Regel Bedingung Feld ist auf festgelegt `!Current.isNewRecord() && sn_ui.PolarisUI.isEnabled() && sn_ui.PolarisUI.canUsePolarisCSS() `.

    // business rule script field

    (function executeRule(current, previous /*null when async*/) {

    	var sysId = current.getUniqueValue();
    	gs.addInfoMessage("<a href='/incident.do?sys_id="+ sysId +"&sysparm_use_polaris=false'>Click here to load this page in Core UI</a>");

    })(current, previous);


