GlideSPScriptable - 범위 지정됨

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 32분
  • GlideSPScriptable API는 위젯에서 데이터와 상호작용하고 기록 작업을 수행하는 메서드를 서비스 포털 제공합니다.

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

    GlideSPScriptable - canReadRecord(GlideRecord now_GR)

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

    기록 유형이 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를 읽을 수 있으면 예를 반환합니다.

    기록 유형이 kb_knowledge, sc_cat_item 또는 sc_category인 경우 메서드는 사용자가 항목을 볼 수 있는지 확인합니다.

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

    GlideSPScriptable - canSeePage(문자열 pageID)

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

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

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

    이 예에서는 SP 헤더 메뉴의 지식 메뉴 항목에 조건을 추가하여 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(문자열 sysId, 부울 isOrdering)

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

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

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

    예를 들어, 사용자가 주문하지 않는 경우, 누군가 해당 항목과 관련된 변수를 보기 위해 요청된 항목을 보고 있는 경우 쓰기 역할을 사용하여 확인하십시오.

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

    GlideSPScriptable - getDisplayValue(String 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 및 유형을 포함하는 객체입니다. 필드 이름의 GlideRecord가 잘못되었거나 필드를 읽을 수 없는 경우 null을 반환합니다.

    GlideSPScriptable - getFields(GlideRecord now_GR, String fieldNames)

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

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

    GlideSPScriptable - getFieldsObject(GlideRecord now_GR, 문자열 fieldNames)

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

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

    GlideSPScriptable - getForm(String tableName, String sysId)

    전달된 테이블 이름 및 기록 sys_id과 관련된 양식을 반환합니다.

    주:
    이 메서드는 지정된 테이블 및 관련 기록에 대한 교차 범위 액세스 권한을 적용합니다.
    표 19. 매개변수
    이름 유형 설명
    tableName 문자열 양식이 있는 테이블의 이름입니다.
    sysId 문자열 양식의 Sys_id입니다.
    표 20. 반환
    유형 설명
    객체 요청된 양식입니다.
    var sp = new GlideSPScriptable('');
    var res = sp.getForm('sys_user', '6816f79cc0a8016401c5a33be04be441');    // User sys ID information
    gs.info('Name: ' + res._fields.name.value);
    gs.info('E-mail: ' + res._fields.email.value);

    출력:

    Name: Harry Jones
     E-mail: harryjones@gmail.com

    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(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(문자열 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(String 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()

    서비스 포털 [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 매개변수가 제공된 경우 제공된 테이블과 시스템 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. 반환
    유형 설명
    무효

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

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

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

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

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

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

    GlideSPScriptable - getRecordVariables(GlideRecord now_GR, 부울 includeNilResponses)

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

    표 45. 매개변수
    이름 유형 설명
    now_GR GlideRecord 변수를 검색 서비스 카탈로그 할 기록입니다. 요청된 항목 [sc_req_item] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
    includeNil응답 부울 옵션입니다. 예일 경우 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] 기록 또는 기록 생성자를 통해 제출된 인시던트와 같이 변수가 정의된 기록 서비스 카탈로그 이어야 합니다.
    includeNil응답 부울 옵션입니다. 예일 경우 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 속성이 포함됩니다. 그렇지 않으면 테이블 및 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. 반환
    유형 설명
    무효

    GlideSPScriptable - getVariablesArray(부울 includeNilResponses)

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

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

    표 57. 매개변수
    이름 유형 설명
    includeNil응답 부울 옵션입니다. 예일 경우 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()

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

    이 메서드는 서비스 포털 사용자 기준 지원 플러그인(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=listid=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로 지정된 검색 소스를 볼 수 있으면 예를 반환합니다.

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