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


---

# spContextManager - 클라이언트

# spContextManager - 클라이언트 {#ariaid-title1}

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

위젯의 데이터를 서비스 포털 페이지의 서비스 포털 다른 애플리케이션 및 서비스에서 사용할 수 있도록 합니다. 예를 들어, 위젯 데이터가 페이지에서 열릴 때 위젯 데이터를 에이전트 채팅 전달합니다 서비스 포털 .

spContextManager API는 위젯 클라이언트 스크립트에 사용할 수 있는 AngularJS 서비스입니다서비스 포털.

이 API에 전달되는 키는 페이지당 고유합니다. 예를 들어 `'agent-chat'` 키가 addContext() 메서드를 통해 페이지의 다른 위젯에 의해 이미 초기화된 경우 updateContextForKey() 메서드를 사용하여 키의 데이터를 업데이트해야 합니다. 사용 가능한 키는 다음과 같습니다. agent-chat: 위젯 데이터를 로 보냅니다.에이전트 채팅

에 에이전트 채팅데이터 전달에 대한 자세한 내용은 [서비스 포털에서 에이전트 채팅 구성을](https://www.servicenow.com/docs/access?context=configure-va-in-sp&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 참조하십시오.

## spContextManager - addContext(문자열 키, 객체 컨텍스트) {#ariaid-title2}

키를 초기화하고 위젯 데이터를 값으로 추가합니다. 예를 들어, 'agent-chat' 키에 데이터를 추가하여 사용할 수 있도록 에이전트 채팅합니다.
페이지의 서비스 포털 특정 키에 데이터가 처음 추가될 때 이 방법을 사용합니다. 페이지의 다른 위젯에서 키를 이미 사용하고 있는 경우 대신 updateContextForKey() 메서드를 사용합니다.
{#SPCM-addContext_S_O__table_dsz_dcz_qhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키 | 문자열 | 데이터를 보낼 키의 이름입니다. 사용 가능한 키에는에이전트 채팅이 포함됩니다. 위젯 데이터가 페이지에서 열릴 서비스 포털 때 해당 데이터를 전송합니다에이전트 채팅. |
| 컨텍스트 | 객체 | 키 매개변수에 지정된 애플리케이션 또는 서비스로 전송할 JSON 형식의 위젯 데이터입니다. 예: `{'approval_count': 5}`. |
[표 1. 매개변수]

{#SPCM-addContext_S_O__table_dsz_dcz_qhb} {#SPCM-addContext_S_O__table_esz_dcz_qhb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 2. 반환]

{#SPCM-addContext_S_O__table_esz_dcz_qhb}  
`에 approval_count` 전달합니다.에이전트 채팅 사용자가 홈페이지에서 대화 서비스 포털 를 에이전트 채팅 시작하면 시스템은 에이전트 채팅 `iframe` URL에 `&sysparm_approval_count=5`를 추가합니다.

    function ($scope, spContextManager) {
        spContextManager.addContext('agent-chat', {
            'approval_count': 5       
        });
    };

## spContextManager - getContext() {#ariaid-title3}

페이지의 위젯에서 정의한 각 키 및 관련 데이터 객체를 반환합니다.
이 방법을 사용하면 성능에 영향을 줄 수 있습니다. 이 메서드를 사용하여 페이지에서 초기화되는 키를 파악하고 현재 값을 가져옵니다. 액세스해야 하는 키를 알고 있는 경우 대신 getContextForKey() 메서드를 사용하십시오.
{#SPCM-getContext__table_qgk_tdz_qhb__entry__3}

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

{#SPCM-getContext__table_qgk_tdz_qhb} {#SPCM-getContext__table_rgk_tdz_qhb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 페이지에 정의된 각 키 및 관련 데이터 객체입니다. |
[표 4. 반환]

{#SPCM-getContext__table_rgk_tdz_qhb}  

    function ($scope, spContextManager) {
      spContextManager.getContext();
    } 

## spContextManager - getContextForKey(문자열 키, 부울 returnPromise) {#ariaid-title4}

키와 연결된 위젯 데이터를 반환합니다.
{#SPCM-getContextForKey_S_B__table_w2r_jcz_qhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키 | 문자열 | 컨텍스트를 가져올 키의 이름입니다. 사용 가능한 키는 다음과 같습니다. agent-chat: 위젯 데이터를 로 보냅니다.에이전트 채팅 |
| 약속 반환 | 부울 | 키와 연결된 데이터를 약속 또는 객체로 반환할지 여부를 결정하는 플래그입니다. 값은 다음과 같습니다. * True: 데이터를 약속으로 반환합니다. 페이지의 다른 위젯이 addContext() 메서드를 사용하여 동일한 키를 초기화하는 경우 이 옵션을 사용합니다. promise를 반환하면 키가 아직 초기화되지 않은 경우 정의되지 않은 객체가 반환되지 않습니다. * False: 키와 연결된 데이터가 포함된 객체를 반환합니다. {#SPCM-getContextForKey_S_B__ul_ccf_jvc_shb} |
[표 5. 매개변수]

{#SPCM-getContextForKey_S_B__table_w2r_jcz_qhb} {#SPCM-getContextForKey_S_B__table_x2r_jcz_qhb__entry__2}

| 유형 | 설명 |
|-|-|
| 약속 | returnPromise가 예일 경우 페이지의 다른 위젯이 키를 초기화할 때 이행되는 약속을 반환합니다. |
| 객체 | returnPromise가 아니오일 경우 키와 연결된 데이터가 포함된 객체를 반환합니다. 예: `{approval_count: 5}`. |
[표 6. 반환]

{#SPCM-getContextForKey_S_B__table_x2r_jcz_qhb}  
`에 approval_count` 전달합니다.에이전트 채팅 사용자가 홈페이지에서 대화 서비스 포털 를 에이전트 채팅 시작하면 시스템은 에이전트 채팅 `iframe` URL에 `&sysparm_approval_count=5`를 추가합니다.

    function ($scope, spContextManager) {
      spContextManager.getContextForKey('agent-chat', true).then(function(context) {
        context = context || {};
        context.approval_count = 5; 
        spContextManager.updateContextForKey('agent-chat', context);
      });
    } 

## spContextManager - updateContextForKey(문자열 키, 객체 컨텍스트) {#ariaid-title5}

기존 키로 데이터를 보냅니다. 예를 들어 페이지의 다른 위젯이 'agent-chat' 키를 사용하여 데이터를 구성으로 에이전트 채팅 전달하는 경우 addContext() 메서드를 사용하는 대신 키의 컨텍스트를 업데이트해야 합니다.
{#SPCM-updateContextForKey_S_O__table_mhr_lcz_qhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 키 | 문자열 | 데이터를 보낼 키의 이름입니다. 사용 가능한 키에는에이전트 채팅이 포함됩니다. 위젯 데이터가 페이지에서 열릴 서비스 포털 때 해당 데이터를 전송합니다에이전트 채팅. |
| 컨텍스트 | 객체 | 키 매개변수에 지정된 애플리케이션 또는 서비스로 전송할 JSON 형식의 위젯 데이터입니다. 예: `{'approval_count': 5}`. |
[표 7. 매개변수]

{#SPCM-updateContextForKey_S_O__table_mhr_lcz_qhb} {#SPCM-updateContextForKey_S_O__table_nhr_lcz_qhb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 8. 반환]

{#SPCM-updateContextForKey_S_O__table_nhr_lcz_qhb}  
`에 approval_count` 전달합니다.에이전트 채팅 사용자가 홈페이지에서 대화 서비스 포털 를 에이전트 채팅 시작하면 시스템은 에이전트 채팅 `iframe` URL에 `&sysparm_approval_count=5`를 추가합니다.

    function ($scope, spContextManager) {
      spContextManager.getContextForKey('agent-chat', true).then(function(context) {
        context = context || {};
        context.approval_count = 5; 
        spContextManager.updateContextForKey('agent-chat', context);
      });
    }