---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PolarisUI - 범위 지정됨

# PolarisUI - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

PolarisUI API는 직접 UI 페이지에서 사용하도록 설정하는 넥스트 경험 메서드를 제공합니다.

UI 페이지 \[sys_ui_page\]는 직접 필드가 선택된 경우 직접입니다. 직접 UI 페이지에는 공통 HTML 페이지 템플릿이 포함되지 않으며 페이지에서 사용하려는 모든 CSS와 JavaScript가 포함되어야 합니다.

모든 비직접적 UI 페이지는 기본적으로 사용됩니다 넥스트 경험 .

에 대한 넥스트 경험자세한 내용은 [넥스트 경험 UI를](https://www.servicenow.com/docs/access?context=next-experience-landing-page&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 참조하십시오.

PolarisUI API는 `sn_ui` 네임스페이스 내에서 제공됩니다.

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

현재 페이지에서 UI를 넥스트 경험 사용할 수 있는지 확인합니다.
이 메서드는 다음 조건이 모두 충족되면 `true` 를 반환합니다.

* sn_ui. PolarisUI.isEnabled()가 `true입니다.`
* 요청 URL 매개변수 sysparm_use_polaris 가 `false`로 설정되지 않았습니다.
* 리퍼러 HTTP 요청 헤더에 `sysparm_use_polaris=false`가 포함되어 있지 않습니다.
* 페이지 테마 지원 \[sys_page_theme\] 테이블의 기록에서 페이지 또는 상위 플러그인의 사용 넥스트 경험 이 거부되지 않습니다.
{#PolarisUI-canUsePolarisCSS__ul_acr_xnb_vrb}

이 메서드를 사용하여 동작 또는 [Jelly](https://servicenow-prod.fluidtopics.net/_AkNHYcMZ~92uvNLG~t77A "Jelly를 사용하여 XML을 HTML로 변환합니다.") 출력을 조건부로 변경합니다(활성화된 경우 넥스트 경험 ).
{#PolarisUI-canUsePolarisCSS__table_vzz_nkq_prb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 부울 | 현재 페이지에서 UI를 사용할 수 있는지 여부를 나타내는 플래그입니다.넥스트 경험 유효한 값은 다음과 같습니다. * true: 현재 페이지에서 UI를 넥스트 경험 사용할 수 있습니다. * false: 현재 페이지에서 UI를 넥스트 경험 사용할 수 없습니다. {#PolarisUI-canUsePolarisCSS__ul_pgy_hv2_5rb} |
[표 2. 반환]

{#PolarisUI-canUsePolarisCSS__table_wzz_nkq_prb}  
이 UI 작업은 현재 양식에서 실행 중인 경우 넥스트 경험 다른 페이지로 리디렉션됩니다.

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

이 Jelly 스크립트는 를 사용하여 넥스트 경험페이지에 대해 다른 스타일시트를 설정합니다.

    <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}

UI에서 사용하는 CSS 클래스 이름의 목록을 반환합니다 넥스트 경험 .
UI 페이지의 HTML `<body>` 태그에서 이 메서드를 사용하여 올바르게 렌더링하는 데 넥스트 경험 필요한 CSS 클래스를 설정합니다.

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

반환된 클래스 이름은 시스템 속성 및 세션 디버그 출력이 있는지 여부에 따라 변경됩니다.
{#PolarisUI-getBodyClassNames__table_hkn_1lq_prb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | UI에서 사용하는 CSS 클래스 이름의 목록입니다.넥스트 경험 |
[표 4. 반환]

{#PolarisUI-getBodyClassNames__table_ikn_1lq_prb}  
이 Jelly 스크립트는 사용자 지정 UI 페이지에 추가 넥스트 경험 됩니다.

    <?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}

현재 사용자에 대해 UI가 넥스트 경험 활성화되어 있는지 확인합니다.
이 메서드는 시스템 속성과 glide.ui.polaris.use 사용자 기본 설정이 glide.ui.polaris.experience 모두 true로 설정되어 있는지 확인합니다.

* glide.ui.polaris.experience 인스턴스에서 활성화 넥스트 경험 합니다.
* glide.ui.polaris.use아니오로 설정된 경우 지정된 사용자에 대해 비활성화 넥스트 경험 됩니다.

{#PolarisUI-isEnabled__ul_hrj_nq2_5rb}시스템 속성 및 사용자 기본 설정에 대한 넥스트 경험 자세한 내용은 [넥스트 경험 시스템 속성을](https://www.servicenow.com/docs/access?context=pol-sys-properties&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 참조하십시오.  
주:  
이 메서드는 현재 페이지에 대해 비활성화된 경우에도 넥스트 경험 true를 반환합니다. 이 방법은 전역적으로 활성화된 경우 넥스트 경험 조건부로 전체 경험을 활성화하거나 다른 페이지로 리디렉션하는 데 유용합니다.
{#PolarisUI-isEnabled__table_ljc_djq_prb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 부울 | 현재 사용자에 대해 UI를 넥스트 경험 사용할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 현재 사용자에 대해 UI가 넥스트 경험 활성화됩니다. * false: 현재 사용자에 대해 UI를 넥스트 경험 사용할 수 없습니다. {#PolarisUI-isEnabled__ul_pgy_hv2_5rb} |
[표 6. 반환]

{#PolarisUI-isEnabled__table_mjc_djq_prb}  
이 UI 페이지는 현재 사용자에 대해 활성화된 경우 넥스트 경험 사용자에게 조건부 메시지를 표시합니다.

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

이 비즈니스 규칙은 사용자가 기록 대신 클릭하여 기록 코어 UI넥스트 경험을 볼 수 있는 정보 메시지를 기록 디스플레이에 표시합니다. 비즈니스 규칙 조건 필드가 `!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);


