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


---

# PSBScratchpadUtil - 범위 지정됨

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

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

PSBScratchpadUtil API는 공급자가 다른 서비스 교환 서비스 외부에 있는 "추가" 정보를 소비자와 공유할 수 있는 메서드를 제공합니다.

이 정보는 스크래치패드 \[sn_sb_scratchpad\] 테이블에 이름-값 쌍으로 저장됩니다. 공유된 정보는 제공자 작업 또는 원격 작업의 두 가지 유형 중 하나인 작업과 연결되어야 합니다.

연결된 작업이 활성 상태이면 업데이트된 스크래치패드 정보가 소비자 인스턴스와 동기화됩니다. 작업이 비활성화되거나 삭제되면 지정된 기간이 지나면 스크래치패드의 정보도 삭제됩니다. 기본적으로 3개입니다. 이 기본값은 sn_sb.scratchpad.autodelete.days 속성에 정의되어 있습니다.

제공자와 소비자 모두 스크래치패드 테이블에서 정보를 추가, 업데이트 및 제거할 수 있습니다. 소비자는 CSBScratchpadUtil API를 사용하여 이 정보를 업데이트합니다.

이 API에 액세스하려면 서비스 교환 제공자 애플리케이션(sn_sb_pro)을 설치해야 합니다. 이 API는 `sn_sb_pro` 네임스페이스에서 실행됩니다.

## PSBScratchpadUtil - get(GlideRecord taskGR, String name) {#ariaid-title2}

지정된 스크래치패드 속성의 값을 반환합니다.
{#PSBScrUtil-get_GR_S__table_sm3_fpg_czb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
| 이름 | 문자열 | 값을 검색할 스크래치패드 속성의 이름입니다. 테이블: 스크래치패드 \[sn_sb_scratchpad\] |
[표 1. 매개변수]

{#PSBScrUtil-get_GR_S__table_sm3_fpg_czb} {#PSBScrUtil-get_GR_S__table_tm3_fpg_czb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 또는 null | 요청된 스크래치패드 속성의 값입니다. 속성을 찾을 수 없는 경우 Null입니다. |
[표 2. 반환]

{#PSBScrUtil-get_GR_S__table_tm3_fpg_czb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var rtGR = new GlideRecord("sn_sb_pro_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) { 
      var util = new sn_sb_pro.PSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(util.get(rtGR, "name1"));
    } 

출력:

    "value1"

## PSBScratchpadUtil - getAll(GlideRecord taskGR) {#ariaid-title3}

지정된 작업과 관련된 모든 스크래치패드 속성의 속성 이름과 값(이름-값 쌍)을 반환합니다.
{#PSBScrUtil-getAll_GR__table_ism_vpg_czb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 연결된 스크래치패드 속성을 반환할 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
[표 3. 매개변수]

{#PSBScrUtil-getAll_GR__table_ism_vpg_czb} {#PSBScrUtil-getAll_GR__table_jsm_vpg_czb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 지정된 작업에 포함된 모든 속성 이름과 값입니다. 형식으로: `{ 이름1: 값1, 이름2: 값2, ... }` |
[표 4. 반환]

{#PSBScrUtil-getAll_GR__table_jsm_vpg_czb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var rtGR = new GlideRecord("sn_sb_pro_remote_task");
    rtGR.setLimit(1);
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {  
      var util = new sn_sb_pro.PSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(JSON.stringify(util.getAll(rtGR))); 
    }

출력:

    { "name1": "value1" }

## PSBScratchpadUtil - getNames(GlideRecord taskGR) {#ariaid-title4}

지정된 작업 기록과 관련된 모든 스크래치패드 속성의 이름 목록을 반환합니다.
{#PSBScrUtil-getNames_GR__table_r5k_dqg_czb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 연결된 모든 스크래치패드 속성의 이름 목록을 반환할 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
[표 5. 매개변수]

{#PSBScrUtil-getNames_GR__table_r5k_dqg_czb} {#PSBScrUtil-getNames_GR__table_s5k_dqg_czb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 배열 | 지정된 작업 기록과 관련된 스크래치패드 속성의 이름 목록입니다. |
[표 6. 반환]

{#PSBScrUtil-getNames_GR__table_s5k_dqg_czb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var rtGR = new GlideRecord("sn_sb_pro_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_pro.PSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      gs.info(JSON.stringify(util.getNames(rtGR))); 
    }

출력:

    [ "name1" ]

## PSBScratchpadUtil - populateClientScratchpadBR(GlideRecord taskGR) {#ariaid-title5}

지정된 원격 작업 또는 제공자 작업과 연결된 스크래치패드 속성을 클라이언트 g_scratchpad에 배치합니다.
UI 표시 비즈니스 규칙에서 이 메서드를 호출할 수 있습니다.
{#PSBScrUtil-popClientScratch_GR__table_ikg_qdb_fzb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 연결된 스크래치패드 항목을 클라이언트 g_scratchpad에 배치해야 하는 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
[표 7. 매개변수]

{#PSBScrUtil-popClientScratch_GR__table_ikg_qdb_fzb} {#PSBScrUtil-popClientScratch_GR__table_jkg_qdb_fzb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 반환]

{#PSBScrUtil-popClientScratch_GR__table_jkg_qdb_fzb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    new sn_sb_pro.PSBScratchpadUtil().populateClientScratchpadBR(current);

## PSBScratchpadUtil - remove(GlideRecord taskGR, String name) {#ariaid-title6}

스크래치패드 \[sn_sb_scratchpad\] 테이블에서 지정된 스크래치패드 속성을 삭제합니다.
주:  
삭제는 다른 ServiceNow 인스턴스와 동기화되지 않습니다. 스크래치패드 속성은 연결된 작업 기록이 비활성화되거나 삭제된 후 지정된 기간(일)에 자동으로 삭제됩니다.
{#PSBScrUtil-remove_GR_S__table_x3b_nqg_czb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
| 이름 | 문자열 | 스크래치패드 \[sn_sb_scratchpad\] 테이블에서 제거할 스크래치패드 속성의 이름입니다. |
[표 9. 매개변수]

{#PSBScrUtil-remove_GR_S__table_x3b_nqg_czb} {#PSBScrUtil-remove_GR_S__table_y3b_nqg_czb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 10. 반환]

{#PSBScrUtil-remove_GR_S__table_y3b_nqg_czb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var rtGR = new GlideRecord("sn_sb_pro_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();  
    rtGR.next() 
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_pro.PSBScratchpadUtil();
      util.update(rtGR, "name1", "value1"); 
      util.remove(rtGR, "name1");
      gs.info(util.get(rtGR, "name1")); 
    }

출력:

    undefined

## PSBScratchpadUtil - update(GlideRecord taskGR, 문자열 이름, 문자열 값, 부울 client_side_accessible) {#ariaid-title7}

스크래치패드 \[sn_sb_scratchpad\] 테이블에 속성을 삽입하거나 속성 값을 업데이트합니다.
주:  
한 번의 호출에서 업데이트할 수 있는 최대 속성 수는 50입니다.
{#PSBScrUtil-update_GR_S_S_B__table_z4p_4kg_czb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| taskGR | GlideRecord | 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다. 테이블: 원격 작업 \[sn_sb_pro_remote_task\] 및 제공자 작업 \[sn_sb_pro_provider_task\] |
| 이름 | 문자열 | 새 또는 기존 스크래치패드 속성의 이름입니다. 이 이름은 모든 스크래치패드 속성에서 고유해야 합니다. |
| 값 | 문자열 | 스크래치패드 속성의 값입니다. 최대: 4000자. |
| client_side_accessible | 부울 | 옵션입니다. 표시 비즈니스 규칙에서 populateClientScratchpadBR을 호출할 때 클라이언트 측 g_scratchpad에서 이 속성을 사용할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 속성을 사용할 수 있습니다. * false: 속성을 사용할 수 없습니다. 기본값: false |
[표 11. 매개변수]

{#PSBScrUtil-update_GR_S_S_B__table_z4p_4kg_czb} {#PSBScrUtil-update_GR_S_S_B__table_app_4kg_czb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 12. 반환]

{#PSBScrUtil-update_GR_S_S_B__table_app_4kg_czb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    var rtGR = new GlideRecord("sn_sb_pro_remote_task");
    rtGR.setLimit(1); 
    rtGR.query();
    rtGR.next()
    if (rtGR.isValidRecord()) {
      var util = new sn_sb_pro.PSBScratchpadUtil();
      util.update(rtGR, "name1", "value2");
      gs.info(util.get(rtGR, "name1")); 
    }

출력:

    "value2"