PSBScratchpadUtil - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기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, 문자열 이름)

    지정된 스크래치패드 속성의 값을 반환합니다.

    표 1. 매개변수
    이름 유형 설명
    taskGR GlideRecord 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다.

    테이블: 원격 작업 [sn_sb_pro_remote_task] 및 제공자 작업 [sn_sb_pro_provider_task]
    이름 문자열 검색할 값이 있는 스크래치패드 속성의 이름입니다.

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

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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)

    지정된 작업과 연결된 모든 스크래치패드 속성의 속성 이름과 값(이름-값 쌍)을 반환합니다.

    표 3. 매개변수
    이름 유형 설명
    taskGR GlideRecord 반환할 연결된 스크래치패드 속성이 있는 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다.

    테이블: 원격 작업 [sn_sb_pro_remote_task] 및 제공자 작업 [sn_sb_pro_provider_task]
    표 4. 반환
    유형 설명
    객체 지정한 작업에 포함된 모든 속성 이름과 값입니다. 양식:

    { 이름1: 값1, 이름2: 값2, ... }

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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)

    지정된 작업 기록과 연결된 모든 스크래치패드 속성의 이름 목록을 반환합니다.

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

    테이블: 원격 작업 [sn_sb_pro_remote_task] 및 제공자 작업 [sn_sb_pro_provider_task]
    표 6. 반환
    유형 설명
    문자열 배열 지정된 작업 기록과 연결된 스크래치패드 속성의 이름 목록입니다.

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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)

    지정된 원격 작업 또는 제공자 작업과 연결된 스크래치패드 속성을 클라이언트 g_scratchpad에 배치합니다.

    UI 표시 비즈니스 규칙에서 이 메서드를 호출할 수 있습니다.

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

    테이블: 원격 작업 [sn_sb_pro_remote_task] 및 제공자 작업 [sn_sb_pro_provider_task]
    표 8. 반환
    유형 설명
    안 함

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

    PSBScratchpadUtil - remove(GlideRecord taskGR, 문자열 이름)

    스크래치패드 [sn_sb_scratchpad] 테이블에서 지정된 스크래치패드 속성을 삭제합니다.

    주:
    삭제는 다른 ServiceNow 인스턴스와 동기화되지 않습니다. 스크래치패드 속성은 연결된 작업 기록이 비활성화되거나 삭제된 후 지정된 기간(일)에 자동으로 삭제됩니다.
    표 9. 매개변수
    이름 유형 설명
    taskGR GlideRecord 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다.

    테이블: 원격 작업 [sn_sb_pro_remote_task] 및 제공자 작업 [sn_sb_pro_provider_task]
    이름 문자열 스크래치패드 [sn_sb_scratchpad] 테이블에서 제거할 스크래치패드 속성의 이름입니다.
    표 10. 반환
    유형 설명
    안 함

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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)

    스크래치패드 [sn_sb_scratchpad] 테이블에 속성을 삽입하거나 속성 값을 업데이트합니다.

    주:
    한 번의 호출로 업데이트할 수 있는 최대 속성 수는 50개입니다.
    표 11. 매개변수
    이름 유형 설명
    taskGR GlideRecord 지정된 스크래치패드 속성과 연결된 활성 원격 작업 또는 제공자 작업의 GlideRecord입니다.

    표: 원격 작업[sn_sb_pro_remote_task] 및 제공자 작업[sn_sb_pro_provider_task]
    이름 문자열 새 스크래치패드 속성 또는 기존 스크래치패드 속성의 이름입니다. 이 이름은 모든 스크래치패드 속성에서 고유해야 합니다.
    값 문자열 스크래치패드 속성의 값입니다.

    최대: 4,000자.
    client_side_accessible 부울 옵션입니다. 표시 비즈니스 규칙에서 populateClientScratchpadBR을 호출할 때 클라이언트 측 g_scratchpad에서 이 속성을 사용할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 속성을 사용할 수 있습니다.
    • false: 속성을 사용할 수 없습니다.

    기본값: false
    표 12. 반환
    유형 설명
    안 함

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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"