GlideSPScriptable - 범위 지정

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기31분

    • GlideSPScriptable API는 데이터와 상호작용하고 위젯에서 서비스 포털 기록 작업을 수행하는 메서드를 제공합니다.

    전역 $sp 개체를 사용하여 GlideSPScriptable 메서드에 액세스할 수 있습니다.

    GlideSPScriptable - canReadRecord(GlideRecord now_GR)

    사용자가 지정된 GlideRecord를 읽을 수 있으면 예를 반환합니다.

    레코드 종류가 kb_knowledge, sc_cat_item 또는 sc_category인 경우 메서드는 사용자가 항목을 볼 수 있는지 확인합니다.

    표 1. 매개변수
    이름 유형 설명
    now_GR GlideRecord 확인할 GlideRecord
    표 2. 반환
    유형 설명
    부울 기록이 유효하고 읽을 수 있으면 예입니다.

    서버 스크립트

    //Server script
data.items = [];
data.userName = gs.getUserDisplayName();
var now_GR = new GlideRecord("sc_cat_item");
now_GR.query();
while(now_GR.next() && data.items.length < 10) {
    if ($sp.canReadRecord(now_GR)) {
    data.items.push(now_GR.getDisplayValue("name"));
    }
}

//HTML template
<div class="panel panel-default">
    <div class="panel-heading">Hi, {{c.data.userName}}!</div>
    <div class="panel-body">
        Here are some things you can order:
        <ul><li ng-repeat="item in c.data.items">{{item}}</li></ul>
    </div>
</div>

    GlideSPScriptable - canReadRecord(문자열 테이블, 문자열 sysId)

    사용자가 지정된 GlideRecord를 읽을 수 있으면 예를 반환합니다.

    레코드 종류가 kb_knowledge, sc_cat_item 또는 sc_category인 경우 메서드는 사용자가 항목을 볼 수 있는지 확인합니다.

    표 3. 매개변수
    이름 유형 설명
    테이블 문자열 쿼리할 테이블의 이름입니다.
    sysId 문자열 쿼리할 기록의 Sys_id입니다.
    표 4. 반환
    유형 설명
    부울 기록이 유효하고 읽을 수 있으면 예입니다.

    GlideSPScriptable - canSeePage(String pageID)

    현재 로그인한 사용자에게 지정된 페이지를 볼 수 있는 권한이 있는 경우 예를 반환합니다.

    시스템은 역할 및 사용자 기준을 사용하여 권한을 결정합니다. 자세한 내용은 서비스 포털의 역할 및 사용자 기준별 페이지 보안 구성을 참조하십시오.

    표 5. 매개변수
    이름 유형 설명
    페이지 ID 문자열 페이지 [sp_page] 테이블의 페이지 ID입니다.
    표 6. 반환
    유형 설명
    부울 현재 로그인한 사용자에게 지정된 페이지를 볼 수 있는 권한이 있는지 여부를 나타내는 플래그입니다. 값은 다음과 같습니다.
    • true: 사용자가 페이지를 볼 수 있습니다.
    • false: 사용자가 페이지를 볼 수 없거나, 지정된 pageID가 유효하지 않거나, 사용자가 로그인하지 않았습니다.

    이 예시에서는 SP 머리글 메뉴의 Knowledge 메뉴 항목에 조건을 추가하여 kb_view2 페이지를 볼 수 있는 권한이 있는 사용자에게만 메뉴 항목을 표시합니다.

    GlideSPScriptable.canSeePage("kb_view2")

    GlideSPScriptable - getCatalogItem(문자열 sysId)

    sc_cat_item 또는 sc_cat_item_guide에 대한 모델과 뷰 모델을 반환합니다.

    이 메서드는 더 이상 사용되지 않습니다. 대신 getCatalogItem(String sysId, Boolean isOrdering) 메서드를 사용합니다. 이 메서드는 매개 변수가 false로 설정된 getCatalogItem(String sysId, Boolean isOrdering) 메서드를 isOrdering 호출하며, 이는 쓰기 역할 보안 검사가 수행됨을 의미합니다.

    이 방법을 사용하면 <sp-model />를 사용하여 카탈로그 항목을 렌더링하고 주문하는 데 필요한 데이터를 빠르게 가져올 수 있습니다. 카탈로그 항목의 사진이나 이름만 표시해야 하는 경우 GlideRecord를 사용하여 sc_cat_item 테이블을 쿼리합니다.

    표 7. 매개변수
    이름 유형 설명
    sysId 문자열 카탈로그 항목(sc_cat_item) 또는 주문 가이드(sc_cat_item_guide)의 sys_id입니다.
    표 8. 반환
    유형 설명
    객체 카탈로그 항목 변수 모델, 뷰, 섹션, 가격 책정 및 클라이언트 스크립트를 포함하는 객체입니다. 
    // Server script
(function() {
    var sys_id = $sp.getParameter("sys_id")
    data.catItem = $sp.getCatalogItem(sys_id);
})();

// Client script
function($http, spUtil) {
    var c = this;
    var submitting = false;
    c.getIt = function() {
        if (submitting) return;
        $http.post(spUtil.getURL('sc_cat_item'), c.data.catItem).success(function(response) {
            if (response.answer) {
                c.req = response.answer;
                c.req.page = c.req.table == 'sc_request' ? 'sc_request' : 'ticket';
            }
        });
    }
}

//SCSS
.img-bg {
    padding: 5px;
    background-color: $brand-primary;
}

.img-responsive {
    margin: 0 auto;
}

.cat-icon {
    display: block;
    margin: -40px auto 0;
}

// HTML template
<div class="col-sm-4">
  <div class="panel panel-default">
    <div class="img-bg">
      <img ng-src="{{::data.catItem.picture}}" class="img-responsive" />
    </div>
    <span class="cat-icon fa fa-stack fa-lg fa-3x hidden-xs">
      <i class="fa fa-circle fa-stack-2x text-success"></i>
      <i class="fa fa-desktop fa-stack-1x fa-inverse"></i>
    </span>
    <div class="panel-body">
      <p class="lead text-center">{{::data.catItem.name}}</p>
      <ul class="list-unstyled">
        <li class="text-center" ng-if="::data.catItem.price">${Price}: {{::data.catItem.price}}</li>
      </ul>
      <sp-model form-model="::data.catItem" mandatory="mandatory"></sp-model>
      <p ng-if="c.req" class="text-center text-success">
        ${Request created!} <a href="?id={{c.req.page}}&table={{c.req.table}}&sys_id={{c.req.sys_id}}">{{c.req.number}}</a>
      </p>
      <button ng-if="!c.req" class="btn btn-default btn-block" ng-click="c.getIt()">${Get it}</button>
    </div>
  </div>
</div>

    GlideSPScriptable - getCatalogItem(String sysId, Boolean isOrdering)

    sc_cat_item 또는 sc_cat_item_guide에 대한 모델과 뷰 모델을 반환합니다.

    표 9. 매개변수
    이름 유형 설명
    sysId 문자열 카탈로그 항목(sc_cat_item) 또는 주문 가이드(sc_cat_item_guide)의 sys_id입니다.
    isOrdering (영문) 부울 예일 때는 역할 작성 보안 검사를 사용합니다. false인 경우 쓰기 역할 보안 검사를 사용합니다.

    사용자가 항목을 주문하거나 장바구니에 담은 경우 역할 생성을 사용하여 확인합니다.

    사용자가 주문하지 않는 경우(예: 누군가가 해당 항목과 연결된 변수를 보기 위해 요청된 항목을 보고 있는 경우) 쓰기 역할을 사용하여 확인합니다.
    표 10. 반환
    유형 설명
    객체 카탈로그 항목 변수 모델, 뷰, 섹션, 가격 책정 및 클라이언트 스크립트를 포함하는 객체입니다.

    GlideSPScriptable - getDisplayValue(문자열 필드 이름)

    위젯의 sp_instance 또는 sp_portal 기록에서 지정된 필드의 표시 값(값이 있고 있는 경우)을 반환합니다.

    표 11. 매개변수
    이름 유형 설명
    fieldName 문자열 필드의 이름
    표 12. 반환
    유형 설명
    문자열 sp_instance 또는 sp_portal 기록의 표시 값입니다. 
    //Server script
(function() {
    data.title = $sp.getDisplayValue("title");
    data.catalog = $sp.getDisplayValue("sc_catalog");
})();

//HTML template
<div>
    <h1>sp_instance.title: {{::data.title}}</h1>
    <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
</div>

    GlideSPScriptable - getField(GlideRecord now_GR, String fieldName)

    지정된 GlideRecord에서 지정된 필드에 대한 정보를 반환합니다.

    표 13. 매개변수
    이름 유형 설명
    now_GR GlideRecord 확인할 GlideRecord
    fieldName 문자열 정보를 찾을 필드
    표 14. 반환
    유형 설명
    객체 필드의 레이블, 값, displayValue 및 유형을 포함하는 객체입니다. 필드 이름의 GlideRecord가 잘못되었거나 필드를 읽을 수 없는 경우 null을 반환합니다.

    GlideSPScriptable - getFields(GlideRecord now_GR, String fieldNames)

    지정된 필드 이름 목록을 확인하고 유효한 필드 이름의 배열을 반환합니다.

    표 15. 매개변수
    이름 유형 설명
    now_GR GlideRecord 확인할 GlideRecord
    필드 이름 문자열 쉼표로 구분된 필드 이름 목록입니다.
    표 16. 반환
    유형 설명
    배열 유효한 필드의 배열입니다.

    GlideSPScriptable - getFieldsObject(GlideRecord now_GR, String fieldNames)

    지정된 필드 이름 목록을 확인하고 유효한 필드 이름의 객체를 반환합니다.

    표 17. 매개변수
    이름 유형 설명
    now_GR GlideRecord 확인할 GlideRecord
    필드 이름 문자열 쉼표로 구분된 필드 이름 목록입니다.
    표 18. 반환
    유형 설명
    객체 유효한 필드 이름을 포함하는 객체입니다.

    GlideSPScriptable - getForm(문자열 tableName, 문자열 sysId)

    양식을 반환합니다.

    표 19. 매개변수
    이름 유형 설명
    tableName 문자열 테이블 이름
    sysId 문자열 양식의 sys_id
    표 20. 반환
    유형 설명
    객체 양식

    GlideSPScriptable - getKBCategoryArticles(문자열 sys_id, 수 제한)

    지정된 범주와 그 하위 범주의 KB 문서를 반환합니다.

    성능 문제를 방지하려면 이 메서드를 사용하여 큰 범주의 아티클 또는 인라인 이미지가 있는 아티클을 반환하지 마십시오. 대신 getKBArticleSummaries()를 사용합니다.

    표 21. 매개변수
    이름 유형 설명
    sys_id 문자열 KB 문서 범주의 Sys_id입니다.
    제한 번호 반환된 최대 KB 문서 수입니다.
    표 22. 반환
    유형 설명
    배열 범주 내의 문서와 그 하위 범주에는 다음이 포함됩니다.
    • 게시됨의 workflow_state입니다.
    • 현재 날짜보다 크거나 같은 valid_to 날짜입니다.
    		 
    //Server script 
(function() {
    data.kbs = $sp.getKBCategoryArticles("0ac1bf8bff0221009b20ffffffffffec", 5);
})();

//HTML template
<div>
articles: {{::data.kbs}}
</div>

    GlideSPScriptable - getKBCategoryArticleSummaries(문자열 sys_id, 숫자 제한, 최대 문자 수)

    지정된 범주와 그 하위 범주에서 지식베이스 문서 요약을 반환합니다.

    표 23. 매개변수
    이름 유형 설명
    sys_id 문자열 KB 문서 범주의 Sys_id입니다.
    제한 번호 반환된 최대 KB 문서 수입니다.
    maxChars 번호 문서 텍스트에서 반환할 최대 문자 수입니다. 전체 문서 텍스트의 경우 값을 -1로 설정합니다.
    표 24. 반환
    유형 설명
    배열 범주 내의 문서와 그 하위 범주에는 다음이 포함됩니다.
    • 게시됨의 workflow_state입니다.
    • 현재 날짜보다 크거나 같은 valid_to 날짜입니다.
    		 
    //Server script 
(function() {
    data.summary = $sp.getKBCategoryArticleSummaries("0ac1bf8bff0221009b20ffffffffffec", 5, 200);
})();

//HTML template
<div>
articles: {{::data.summary}}
</div>

    GlideSPScriptable - getKBCount(문자열 sys_id)

    정의된 지식베이스의 문서 수를 반환합니다.

    표 25. 매개변수
    이름 유형 설명
    sys_id 문자열 지식베이스 기록의 Sys_id입니다.
    표 26. 반환
    유형 설명
    번호 정의된 지식베이스의 지식 문서 수:
    • 게시됨의 workflow_state입니다.
    • 현재 날짜보다 크거나 같은 valid_to 날짜입니다.
    		 
    //Server script 
(function() {
    data.count = $sp.getKBCount("a7e8a78bff0221009b20ffffffffff17");
})();

//HTML template
<div>
articles: {{::data.count}}
</div>

    GlideSPScriptable - getListColumns(String tableName, String view)

    지정된 뷰에서 지정된 테이블의 열 목록을 반환합니다.

    표 27. 매개변수
    이름 유형 설명
    tableName 문자열 테이블 이름
    뷰 문자열 열을 필터링할 뷰
    표 28. 반환
    유형 설명
    객체 열 이름을 포함하는 객체입니다.

    GlideSPScriptable - getMenuItems(문자열 sysId)

    지정된 인스턴스에 대한 메뉴 항목의 배열을 반환합니다.

    표 29. 매개변수
    이름 유형 설명
    sysId 문자열 인스턴스의 sysId
    표 30. 반환
    유형 설명
    배열 지정된 인스턴스의 메뉴 항목

    GlideSPScriptable - getMenuHREF(GlideRecord 페이지)

    sp_menu 유형에 따라 URL의 (?id=) 부분을 반환합니다.

    표 31. 매개변수
    이름 유형 설명
    페이지 GlideRecord 페이지
    표 32. 반환
    유형 설명
    문자열 URL의 href 부분입니다.

    GlideSPScriptable - getParameter(문자열 이름)

    지정된 매개변수의 값을 반환합니다.

    표 33. 매개변수
    이름 유형 설명
    이름 문자열 쿼리 문자열 또는 게시 본문의 키 이름입니다.
    표 34. 반환
    유형 설명
    객체 지정된 매개변수를 객체로 반환합니다. 요청, JSON 요청 또는 위젯이 없는 경우 null을 반환합니다.

    GlideSPScriptable - getPortalRecord()

    Service Portal [sp_portal] 테이블에서 포털 기록을 반환합니다.

    표 35. 매개변수
    이름 유형 설명
    없음
    표 36. 반환
    유형 설명
    GlideRecord 서비스 포털 [sp_portal] 테이블의 현재 포털에 대한 포털 기록. 
    //Server script
(function() {
    var portalGr = $sp.getPortalRecord();
    data.logo = portalGr.getDisplayValue("logo");
    data.homepage = portalGr.getDisplayValue("homepage.id");
})();

//HTML template
<div>
    <img ng-src="{{::c.data.logo}}" />
    <a href="?id={{::c.data.homepage}}">Click here to go home</a>
</div>

    GlideSPScriptable - getRecord(문자열 테이블, 문자열 sys_id)

    매개변수가 제공되면 제공된 테이블 및 시스템 ID로 식별되는 GlideRecord를 반환합니다. 매개변수가 제공되지 않으면 현재 URL로 식별된 기록을 반환합니다.

    표 37. 매개변수
    이름 유형 설명
    테이블 문자열 옵션입니다. 반환할 기록의 테이블입니다. 포함된 매개변수가 없으면 현재 URL로 식별되는 테이블과 시스템 ID를 반환합니다.
    sys_id 문자열 옵션입니다. 반환할 기록의 시스템 ID입니다. 포함된 매개변수가 없으면 현재 URL로 식별된 기록을 반환합니다.
    표 38. 반환
    유형 설명
    GlideRecord 매개변수가 제공되면 제공된 테이블 및 Sys ID로 식별된 기록을 반환합니다.

    매개변수가 제공되지 않으면 현재 URL로 식별된 기록을 반환합니다.

    위젯이 다른 위젯에 의해 포함되거나 제공된 매개변수에 대한 기록을 찾을 수 없는 경우 null을 반환합니다.

    		 
    //Server script 
(function(){ 
var now_GR = $sp.getRecord(); 
data.tableLabel = now_GR.getLabel(); 
})(); 

//HTML template 
<div class="panel-heading"> 
<h4 class="panel-title">${{{data.tableLabel}} details}</h4> 
</div>

    GlideSPScriptable - getRecordDisplayValues(객체 데이터, GlideRecord from, 문자열 이름)

    지정된 필드의 표시 값을 데이터 매개변수에 복사합니다.

    표 39. 매개변수
    이름 유형 설명
    데이터 객체 지정된 필드에 대한 표시 값이 이 객체에 복사됩니다.
    시작 항목 GlideRecord 처리할 GlideRecord
    이름 문자열 쉼표로 구분된 필드 이름 목록입니다.
    표 40. 반환
    유형 설명
    void

    GlideSPScriptable - getRecordElements(객체 데이터, GlideRecord from, 문자열 이름)

    지정된 필드에 대해 요소의 이름, 표시 값 및 값을 데이터 매개변수에 복사합니다.

    표 41. 매개변수
    이름 유형 설명
    데이터 객체 요소의 이름, 표시 값 및 지정된 필드에 대한 값이 이 객체에 복사됩니다.
    시작 항목 GlideRecord 처리할 GlideRecord
    이름 문자열 쉼표로 구분된 필드 이름 목록입니다.
    표 42. 반환
    유형 설명
    void

    GlideSPScriptable - getRecordValues(객체 데이터, GlideRecord 소스, 문자열 이름)

    지정된 필드 이름의 값을 GlideRecord에서 데이터 매개변수로 복사합니다.

    표 43. 매개변수
    이름 유형 설명
    데이터 객체 지정된 필드의 값이 이 객체에 복사됩니다.
    시작 항목 GlideRecord 처리할 GlideRecord
    이름 문자열 쉼표로 구분된 필드 이름 목록입니다.
    표 44. 반환
    유형 설명
    void

    GlideSPScriptable - getRecordVariables(GlideRecord now_GR, 부울 includeNilResponses)

    기록과 관련된 변수를 문자열 형식으로 반환합니다 서비스 카탈로그 .

    표 45. 매개변수
    이름 유형 설명
    now_GR GlideRecord 변수를 검색할 서비스 카탈로그 기록입니다. 요청된 항목 [sc_req_item] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
    includeNilResponses 부울 옵션입니다. true이면 API에 사용자 정의 값이 없는 변수가 포함됩니다.
    표 46. 반환
    유형 설명
    문자열 서비스 카탈로그 기록과 연결된 변수입니다. 
    //Server script 
(function() {
var itemsGR = new GlideRecord("sc_req_item");
itemsGR.get('585d1bc44f4f13008a959a211310c77d');
	
data.scVars = $sp.getRecordVariables(itemsGR);

})();

//HTML template
<div>
Requested item variables: {{::data.scVars}}
</div>

    출력:

    Requested item variables: [
  {
    "display_value":"MetroPCS",
    "name":"carrier",
    "visible_summary":true,
    "id":"585d1bc44f4f13008a959a211310c77c",
    "label":"Allocated carrier",
    "type":"5",
    "value":"metropcs",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Unlimited",
    "name":"data_plan",
    "visible_summary":true,
    "id":"d05d1bc44f4f13008a959a211310c77c",
    "label":"Monthly data allowance",
    "type":"5",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"12 Months",
    "name":"duration",
    "visible_summary":true,
    "id":"d85d1bc44f4f13008a959a211310c77c",
    "label":"Contract duration",
    "type":"5",
    "value":"twelve_months",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Slate",
    "name":"color",
    "visible_summary":true,
    "id":"545d1bc44f4f13008a959a211310c77c",
    "label":"Color",
    "type":"5",
    "value":"slate",
    "visible_standalone":true,
    "visible_guide":true
  },
  {"display_value":"64GB",
    "name":"storage",
    "visible_summary":true,
    "id":"d45d1bc44f4f13008a959a211310c77c",
    "label":"Storage",
    "type":"5",
    "value":"sixtyfour",
    "visible_standalone":true,
    "visible_guide":true
  }
]

    GlideSPScriptable - getRecordVariablesArray(GlideRecord now_GR, 부울 includeNilResponses)

    기록과 연결된 변수 배열 서비스 카탈로그 을 반환합니다.

    표 47. 매개변수
    이름 유형 설명
    now_GR GlideRecord 변수를 검색할 서비스 카탈로그 기록입니다. 요청된 항목 [sc_req_item] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
    includeNilResponses 부울 옵션입니다. true이면 API에 사용자 정의 값이 없는 변수가 포함됩니다.
    표 48. 반환
    유형 설명
    객체 기록과 연결된 변수의 서비스 카탈로그 배열입니다. 
    //Server script 
(function() {
var itemsGR = new GlideRecord("sc_req_item");
itemsGR.get('585d1bc44f4f13008a959a211310c77d');
	
data.scVars = $sp.getRecordVariablesArray(itemsGR);

})();

//HTML template
<div>
Requested item variables: {{::data.scVars}}
</div>

    출력:

    Requested item variables: [
  {
    "display_value":"MetroPCS",
    "name":"carrier",
    "visible_summary":true,
    "id":"585d1bc44f4f13008a959a211310c77c",
    "label":"Allocated carrier",
    "type":"5",
    "value":"metropcs",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Unlimited",
    "name":"data_plan",
    "visible_summary":true,
    "id":"d05d1bc44f4f13008a959a211310c77c",
    "label":"Monthly data allowance",
    "type":"5",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"12 Months",
    "name":"duration",
    "visible_summary":true,
    "id":"d85d1bc44f4f13008a959a211310c77c",
    "label":"Contract duration",
    "type":"5",
    "value":"twelve_months",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Slate",
    "name":"color",
    "visible_summary":true,
    "id":"545d1bc44f4f13008a959a211310c77c",
    "label":"Color",
    "type":"5",
    "value":"slate",
    "visible_standalone":true,
    "visible_guide":true
  },
  {"display_value":"64GB",
    "name":"storage",
    "visible_summary":true,
    "id":"d45d1bc44f4f13008a959a211310c77c",
    "label":"Storage",
    "type":"5",
    "value":"sixtyfour",
    "visible_standalone":true,
    "visible_guide":true
  }
]

    GlideSPScriptable - getStream(문자열 테이블, 문자열 sysId)

    지정된 기록에 대한 활동 스트림을 가져옵니다. 이 방법은 작업 테이블을 확장하는 테이블에서 작동합니다.

    표 49. 매개변수
    이름 유형 설명
    테이블 문자열 테이블 이름
    sysID 문자열 기록의 sys_id
    표 50. 반환
    유형 설명
    객체 작업 테이블을 확장하는 테이블이 지정되면 display_value, sys_id, short_description, 숫자, 항목, user_sys_id, user_full_name, user_login, 레이블, 테이블 및 journal_fields 속성이 포함됩니다. 그렇지 않으면 table 및 sys_id 속성이 포함됩니다.
    주:
    user_login 속성에는 현재 사용자의 사용자 ID가 포함되어 있습니다. user_sys_id 및 iser_full_name 속성은 쿼리된 기록의 작성자를 참조합니다.

    GlideSPScriptable - getUserInitials()

    사용자의 이니셜을 반환합니다.

    표 51. 매개변수
    이름 유형 설명
    없음
    표 52. 반환
    유형 설명
    문자열 사용자의 이니셜

    GlideSPScriptable - getValue(문자열 이름)

    JSON 요청, 인스턴스 또는 포털의 명명된 값을 반환합니다.

    표 53. 매개변수
    이름 유형 설명
    이름 문자열 JSON 요청, 인스턴스 또는 포털의 이름입니다.
    표 54. 반환
    유형 설명
    객체 지정된 매개변수의 값입니다. 지정된 엔터티가 없거나 이러한 매개 변수가 없는 경우 Null입니다. 
    //Server script
(function() {
    data.title = $sp.getValue("title");
    data.catalog = $sp.getValue("sc_catalog");
})();

//HTML templage
<div>
    <h1>sp_instance.title: {{::data.title}}</h1>
    <h1>sp_portal.sc_catalog: {{::data.catalog}}</h1>
</div>

    GlideSPScriptable - getValues(객체 데이터, 문자열 이름)

    요청 또는 인스턴스에서 데이터 매개변수로 값을 복사합니다.

    표 55. 매개변수
    이름 유형 설명
    데이터 객체 매개변수 값을 수신합니다.
    이름 문자열 필드 이름의 쉼표로 구분된 문자열입니다.
    표 56. 반환
    유형 설명
    void

    GlideSPScriptable - getVariablesArray(부울 includeNilResponses)

    URL의 기록과 연결된 변수 배열 서비스 카탈로그 을 반환합니다.

    예를 들어 URL에 id=form&table=sc_req_item&sys_id=832e9620db4f330083766b984b9619cf 매개변수가 포함된 경우 API는 요청된 항목 [sc_req_item] 테이블의 지정된 기록과 연결된 변수를 반환합니다. 요청된 항목 [sc_req_item] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.

    표 57. 매개변수
    이름 유형 설명
    includeNilResponses 부울 옵션입니다. true이면 API에 사용자 정의 값이 없는 변수가 포함됩니다.
    표 58. 반환
    유형 설명
    객체 테이블과 연결된 변수의 배열입니다. 
    //Server script 
(function() {	
data.scVars = $sp.getVariablesArray();
})();

//HTML template
<div Current record variables: {{::data.scVars}} ></div>

    출력:

    Current record variables: [
  {
    "display_value":"unlimited",
    "name":"data","visible_summary":
    true,"id":"472e5620db4f330083766b984b96198a",
    "label":"Data",
    "type":"6",
    "value":"unlimited",
    "visible_standalone":true,
    "visible_guide":true
  },
  {
    "display_value":"Black",
    "name":"color",
    "visible_summary":true,
    "id":"c72e5620db4f330083766b984b96198a",
    "label":"Color",
    "type":"6",
    "value":"Black",
    "visible_standalone":true,
    "visible_guide":true
  }
]

    GlideSPScriptable - getWidget(String sysID, Object options)

    ID 또는 sys_id로 위젯을 가져오고, 제공된 옵션을 사용하여 해당 위젯의 서버 스크립트를 실행한 다음, 위젯 모델을 반환합니다.

    표 59. 매개변수
    이름 유형 설명
    sysID 문자열 위젯 sys_id 또는 widget_id
    옵션 객체 위젯의 서버 스크립트에 전달할 객체입니다. 이 개체를 서버 스크립트의 옵션 으로 참조합니다.
    주:
    이 함수에 전달된 모든 옵션은 해당 스크립트를 처음 실행할 때 포함된 위젯의 서버 스크립트에서만 사용할 수 있습니다. 포함된 위젯에서 서버 스크립트에 대한 후속 호출에는 전달된 개체 속성이 포함되지 않습니다.
    표 60. 반환
    유형 설명
    객체 sp-widget과 함께 사용할 위젯 모델입니다. 
    //Server script
data.myWidget = $sp.getWidget('widget_id', {p1: param1, p2: param2});

//HTML
<sp-widget widget="c.data.myWidget"></sp-widget>

    GlideSPScriptable - isRTLEnabled()

    연결된 포털에서 RTL(오른쪽에서 왼쪽 언어)을 사용할 수 있는지와 현재 사용자의 언어가 방향 RTL인지 여부를 확인합니다.

    이 메서드를 사용하여 포털 UI에 RTL 관련 CSS가 필요한지 확인합니다.

    표 61. 매개변수
    이름 유형 설명
    없음
    표 62. 반환
    유형 설명
    부울 RTL 플래그가 활성화되어 있고 현재 사용자의 세션 언어가 방향 RTL인지 여부를 나타내는 플래그입니다.

    가능한 값:

    • true: RTL 플래그가 활성화됩니다.
    • false: RTL 플래그를 사용할 수 없습니다.

    데이터 유형: 부울

    다음 코드 예제에서는 이 메서드를 사용하여 포털 페이지에 표시할 아이콘의 유형을 결정하는 방법을 보여 줍니다.

    // Server script  
(function() {
  data.isRTLEnabled = $sp.isRTLEnabled();
 })(); 

// HTML template 
<div> <i ng-class="c.data.isRTLEnabled ? 'fa fa-arrow-right' : 'fa fa-arrow-left'"></i> </div>

    GlideSPScriptable - isUserCriteriaEnabled()

    사용자 기준이 활성화된 경우 예를 반환합니다.

    서비스 포털 사용자 기준 지원 플러그인(com.glide.service-portal.user-criteria)이 활성 상태이고 서비스 포털 권리에 대한 역할 필드 대신 사용자 기준 기록 사용 활성화(glide.service_portal.user_criteria_enabled) 시스템 속성이 true로 설정된 경우 이 메서드는 true를 반환합니다.

    표 63. 매개변수
    이름 유형 설명
    없음
    표 64. 반환
    유형 설명
    부울 사용자 기준이 활성화된 경우 예입니다.

    GlideSPScriptable - log(객체 메시지)

    서비스 포털 로그 항목 [sp_log] 테이블에 출력을 기록합니다. 로그인한 사용자에게 sp_admin 또는 관리자 역할이 있어야 합니다.

    표 65. 매개변수
    이름 유형 설명
    메시지 객체 페이지에서 출력으로 보낼 메시지를 나타내는 JavaScript 객체 또는 문자열입니다 서비스 포털 .
    표 66. 반환
    유형 설명
    없음

    다음 예제에서는 미리 정의된 오류가 발생하는 경우 이를 기록하는 방법을 보여 줍니다.

    var demo_data = null;
var params = null;
if (gr.getValue("demo_data")) {
   try {
	demo_data = JSON.parse(gr.getValue("demo_data"));
	params = (demo_data.options) ? demo_data.options : null;
	} catch(e) {
	$sp.log(e);
   }
}

    GlideSPScriptable - mapUrlToSPUrl(문자열 url)

    플랫폼 UI의 목록이나 양식을 요청하는 URL을 해당 id=list 또는 id=form 서비스 포털 페이지의 URL로 변환합니다.

    이 메서드를 사용하여 사용자가 플랫폼 UI 양식 또는 목록 URL을 요청할 때 로그인 후 올바른 서비스 포털 페이지로 사용자를 리디렉션하는 등의 작업을 수행할 수 있습니다. id=list 및 id=form 페이지 대상은 사용자 지정할 수 없습니다.
    주:
    테이블, sys_id 및 sysparm_query 값은 원래 URL에서 유지됩니다. sysparm_view 그렇지 않습니다.
    표 67. 매개변수
    이름 유형 설명
    URL 문자열 플랫폼 UI URL
    표 68. 반환
    유형 설명
    문자열 변환된 서비스 포털 URL.

    전달된 URL이 플랫폼 UI에서 목록이나 양식을 요청하지 않으면 null 값이 반환됩니다.

    목록 예시

    GlideSPScriptable().mapUrlToSPUrl("http://demo.service-now.com/task_list.do?sysparm_userpref_module=1523b8d4c611227b00be8216ec331b9a&sysparm_query=assigned_to=javascript:getMyAssignments()&sysparm_clear_stack=true"))

    반환

    id=list&table=task&filter=assigned_to=javascript:getMyAssignments()&sys_id=&v=

    양식 예

    GlideSPScriptable().mapUrlToSPUrl("incident.do?sys_id=12bc12bc12bc12bc12bc12bc12bc12bc")

    반환

    id=form&table=incident&filter=&sys_id=12bc12bc12bc12bc12bc12bc12bc12bc&v=

    GlideSPScriptable - userCanSeeSearchSourceByCriteria(String searchSourceID)

    현재 사용자가 searchSourceID로 지정된 검색 소스를 볼 수 있는 경우 true를 반환합니다.

    사용자가 사용자 기준에 의해 제한되지 않으면 예를 반환합니다. 사용자 기준이 서비스 포털 자산에 미치는 영향에 대한 자세한 내용은 서비스 포털의 사용자 기준을 참조하십시오.
    주:
    이 메서드는 검색 소스의 역할 기반 사용 권한을 평가하지 않으며 사용자 기준이 활성화된 경우에만 사용해야 합니다.
    표 69. 매개변수
    이름 유형 설명
    검색 소스 ID 문자열 검색 소스 기록의 Sys_id입니다.
    표 70. 반환
    유형 설명
    부울 현재 사용자에게 검색 소스에 대한 읽기 권한이 있는 경우 예입니다.