PolarisUI – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Die PolarisUI Die API stellt Methoden zum Aktivieren bereit Next Experience Auf 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 Experience Standardmäßig.

    Weitere Informationen zu finden Next Experience, Siehe Die Next Experience-UI .

    Die PolarisUI API wird in bereitgestellt sn_ui Namespace.

    PolarisUI – canUsePolarisCSS()

    Überprüft, ob die aktuelle Seite verwenden kann Next Experience UI.

    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=false .
    • Der Seite oder dem übergeordneten Plugin wird die Verwendung von nicht verweigert Next Experience Durch einen Datensatz in der Tabelle „Unterstützung von Seitenthemen“ [sys_page_theme].

    Verwenden Sie diese Methode, um das Verhalten von oder bedingt zu ändern Jelly Ausgabe, wenn Next Experience Ist aktiviert.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die aktuelle Seite verwenden kann Next Experience UI.

    Gültige Werte:
    • Wahr: Die aktuelle Seite kann verwenden Next Experience UI.
    • Falsch: Die aktuelle Seite kann nicht verwenden Next Experience UI.

    Diese UI-Aktion leitet bei zu einer anderen Seite um Next Experience Wird 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()

    Gibt eine Liste der CSS-Klassennamen zurück, die von verwendet werden Next Experience UI.

    Verwenden Sie diese Methode im HTML-Format <body>Tag einer UI-Seite, für die die erforderlichen CSS-Klassen festgelegt werden sollen Next Experience Um richtig zu rendern.
    <body class="$[sn_ui.PolarisUI.getBodyClassNames()]">

    Die zurückgegebenen Klassennamen ändern sich je nach Systemeigenschaften und ob Sitzungs-Debug-Ausgabe vorhanden ist.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Liste der CSS-Klassennamen, die von verwendet werden Next Experience UI.

    Dieses Jelly-Skript fügt hinzu Next Experience Zu 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()

    Überprüft, ob Next Experience UI ist für den aktuellen Anwender aktiviert.

    Diese Methode überprüft, ob glide.ui.polaris.experienceSystemeigenschaft und glide.ui.polaris.useDie Anwendereinstellungen sind beide auf festgelegt Wahr .
    • glide.ui.polaris.experienceAktiviert Next Experience In der Instanz.
    • glide.ui.polaris.useDeaktiviert Next Experience Für angegebene Anwender, wenn auf festgelegt Falsch .
    Weitere Informationen zu finden Next Experience Systemeigenschaften und Anwendereinstellungen, siehe Next Experience-Systemeigenschaften .
    Hinweis:
    Diese Methode gibt „wahr“ zurück, auch wenn Next Experience Ist für die aktuelle Seite deaktiviert. Diese Methode ist nützlich, wenn ganze Experiences bedingt aktiviert oder zu verschiedenen Seiten umgeleitet werden sollen Next Experience Ist global aktiviert.
    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob Next Experience UI ist für den aktuellen Anwender aktiviert.

    Gültige Werte:
    • Wahr: Der Next Experience UI ist für den aktuellen Anwender aktiviert.
    • Falsch: Der Next Experience UI ist für den aktuellen Anwender nicht aktiviert.

    Auf dieser UI-Seite wird dem Anwender eine bedingte Nachricht angezeigt, wenn Next Experience Ist 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-UI Anstelle 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);