GlideSPScriptable - 범위 지정

위젯에서 서비스 포털 데이터와 상호작용하고 기록 작업을 수행합니다.

전역 $sp 객체를 사용하여 GlideSPScriptable 메서드에 액세스합니다.

범위가 지정된 GlideSPScriptable - canReadRecord(GlideRecord now_GR)

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

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

표 1. 매개변수

이름	유형	설명
now_GR	GlideRecord	확인할 GlideRecord입니다.

표 2. 반환

유형	설명
부울	기록이 유효하고 읽을 수 있으면 True입니다.

서버 스크립트

//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를 읽을 수 있으면 true를 반환합니다.

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

표 3. 매개변수

이름	유형	설명
테이블	문자열	쿼리할 테이블의 이름입니다.
sysId	문자열	쿼리할 기록의 Sys_id입니다.

표 4. 반환

유형	설명
부울	기록이 유효하고 읽을 수 있으면 True입니다.

범위가 지정된 GlideSPScriptable - canSeePage(pageID 문자열)

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

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

표 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로 isOrdering 설정하여 getCatalogItem(String sysId, Boolean 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(문자열 sysId, 부울 isOrdering)

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

표 9. 매개변수

이름	유형	설명
sysId	문자열	카탈로그 항목(sc_cat_item) 또는 주문 가이드(sc_cat_item_guide)의 sys_id입니다.
이스오더링	부울	예일 때는 역할 작성 보안 검사를 사용합니다. false인 경우 쓰기 역할 보안 검사를 사용합니다. 사용자가 항목을 주문하거나 카트에 있는 경우 역할 생성을 사용하여 확인합니다. 예를 들어, 사용자가 주문하지 않는 경우 누군가 요청 항목을 보고 해당 항목과 관련된 변수를 보고 쓰기 역할을 사용하여 확인합니다.

표 10. 반환

유형	설명
객체	카탈로그 항목 변수 모델, 뷰, 섹션, 가격 책정 및 클라이언트 스크립트를 포함하는 객체입니다.

범위가 지정된 GlideSPScriptable - getDisplayValue(fieldName 문자열)

위젯의 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, 문자열 fieldName)

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

표 13. 매개변수

이름	유형	설명
now_GR	GlideRecord	확인할 GlideRecord
fieldName	문자열	정보를 찾을 필드

표 14. 반환

유형	설명
객체	필드의 레이블, 값, displayValue 및 type을 포함하는 객체입니다. 필드 이름의 GlideRecord가 잘못되었거나 필드를 읽을 수 없는 경우 null을 반환합니다.

범위가 지정된 GlideSPScriptable - getFields(GlideRecord now_GR, fieldNames 문자열)

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

표 15. 매개변수

이름	유형	설명
now_GR	GlideRecord	확인할 GlideRecord
필드 이름	문자열	쉼표로 구분된 필드 이름 목록입니다.

표 16. 반환

유형	설명
배열	유효한 필드의 배열입니다.

범위가 지정된 GlideSPScriptable - getFieldsObject(GlideRecord now_GR, fieldNames 문자열)

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

표 17. 매개변수

이름	유형	설명
now_GR	GlideRecord	확인할 GlideRecord
필드 이름	문자열	쉼표로 구분된 필드 이름 목록입니다.

표 18. 반환

유형	설명
객체	유효한 필드 이름이 들어 있는 개체입니다.

범위가 지정된 GlideSPScriptable - getForm(tableName 문자열, sysId 문자열)

양식을 반환합니다.

표 19. 매개변수

이름	유형	설명
tableName	문자열	테이블의 이름입니다
sysId	문자열	양식의 sys_id

표 20. 반환

유형	설명
객체	양식

범위가 지정된 GlideSPScriptable - getKBCategoryArticles(String sys_id, Number limit)

지정된 범주와 해당 하위 범주의 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(String sys_id, Number limit, Number maxChars)

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

표 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(String 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(tableName 문자열, 뷰 문자열)

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

표 27. 매개변수

이름	유형	설명
tableName	문자열	테이블 이름
view	문자열	열을 필터링할 뷰입니다

표 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	Service Portal [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)

매개변수가 제공되면 제공된 테이블 및 Sys ID로 식별된 GlideRecord를 반환합니다. 매개변수가 제공되지 않은 경우 현재 URL로 식별된 기록을 반환합니다.

표 37. 매개변수

이름	유형	설명
테이블	문자열	옵션입니다. 반환할 기록의 테이블입니다. 매개변수가 포함되지 않은 경우 현재 URL로 식별된 테이블 및 Sys 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 원본, 문자열 이름)

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

표 39. 매개변수

이름	유형	설명
데이터	객체	지정된 필드의 표시 값이 이 객체에 복사됩니다.
보낸 사람	GlideRecord	처리할 GlideRecord입니다.
이름	문자열	쉼표로 구분된 필드 이름 목록입니다.

표 40. 반환

유형	설명
void

범위가 지정된 GlideSPScriptable - getRecordElements(객체 데이터, GlideRecord 원본, 문자열 이름)

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

표 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] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
includeNilResponse를 포함합니다.	부울	옵션입니다. 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] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
includeNilResponse를 포함합니다.	부울	옵션입니다. 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, number, entries, user_sys_id, user_full_name, user_login, label, table 및 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. 매개변수

이름	유형	설명
includeNilResponse를 포함합니다.	부울	옵션입니다. 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(문자열, sysID, 객체 옵션)

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

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

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

표 63. 매개변수

이름	유형	설명
없음

표 64. 반환

유형	설명
부울	사용자 기준이 활성화된 경우 예입니다.

범위가 지정된 GlideSPScriptable - log(객체 메시지)

Service Portal 로그 항목 [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 Service Portal 페이지의 URL로 변환합니다.

이 메서드를 사용하여 사용자가 플랫폼 UI 양식 또는 목록 URL을 요청할 때 올바른 Service Portal 페이지로 로그인한 후 리디렉션하는 등의 작업을 수행합니다. id=list 및 id=form 페이지 대상은 사용자 지정할 수 없습니다.

주:

테이블, sys_id 및 sysparm_query 값은 원래 URL에서 유지됩니다. sysparm_view 그렇지 않습니다.

표 67. 매개변수

이름	유형	설명
url	문자열	플랫폼 UI URL

표 68. 반환

유형	설명
문자열	변환된 Service Portal 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(stringsearchSourceID)

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

사용자가 사용자 기준에 의해 제한되지 않는 경우 true를 반환합니다. 사용자 기준이 Service Portal 자산에 미치는 영향에 대한 자세한 내용은 Service Portal에 대한 사용자 기준을 참조하십시오.

주:

이 메서드는 검색 원본의 역할 기반 사용 권한을 평가하지 않으므로 사용자 기준을 사용하는 경우에만 사용해야 합니다.

표 69. 매개변수

이름	유형	설명
searchSourceID	문자열	검색 소스 기록의 Sys_id입니다.

표 70. 반환

유형	설명
부울	현재 사용자에게 검색 소스에 대한 읽기 권한이 있는 경우 예입니다.