GlideSPScriptable - スコープ対象

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む35読むのに数分

    • サービスポータルウィジェットで、データを操作してレコード操作を実行します。

    GlideSPScriptable メソッドにアクセスするには、グローバル $sp オブジェクトを使用します。

    スコープ対象 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(文字列 table, 文字列 sysId)

    ユーザーが指定された GlideRecord を読み込むことができる場合は true を返します。

    レコードタイプが kb_knowledge、sc_cat_item、または sc_category の場合、このメソッドはユーザーがアイテムを表示できるかどうかをチェックします。

    表 : 3. パラメーター
    名前 タイプ 説明
    テーブル 文字列 クエリするテーブルの名前。
    sysId 文字列 クエリするレコードの sys_id。
    表 : 4. 返される内容
    タイプ 説明
    ブーリアン レコードが有効で読み取り可能な場合は true。

    スコープ対象 GlideSPScriptable - canSeePage(文字列 pageID)

    現在ログインしているユーザーが指定されたページを表示する権限を持っている場合は true を返します。

    システムは、ロールとユーザー基準を使用して権限を決定します。詳細については、「 ロール別のページ セキュリティの設定 」および 「サービス ポータルのユーザー基準」を参照してください。

    表 : 5. パラメーター
    名前 タイプ 説明
    pageID 文字列 ページ [sp_page] テーブルのページ ID。
    表 : 6. 返される内容
    タイプ 説明
    ブーリアン 現在ログインしているユーザーが指定されたページを表示する権限を持っているかどうかを示すフラグ。次の値が含まれます。
    • true：ユーザーはページを表示できます。
    • false：ユーザーはページを表示できないか、指定された pageID が有効でないか、ユーザーがログインしていません。

    この例では、SP ヘッダーメニューのナレッジメニューアイテムに条件を追加して、kb_view2 ページを表示する権限を持つユーザーにのみメニューアイテムを表示します。

    GlideSPScriptable.canSeePage("kb_view2")

    スコープ対象 GlideSPScriptable - getCatalogItem(文字列 sysId)

    sc_cat_item または sc_cat_item_guide のモデルとビューモデルを返します。

    このメソッドは廃止されました。代わりに getCatalogItem(文字列 sysId, ブーリアン isOrdering) メソッドを使用してください。このメソッドは、isOrdering パラメーターを false に設定して getCatalogItem(文字列 sysId, ブーリアン 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 ブーリアン true の場合、作成ロールのセキュリティチェックを使用します。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. 返される内容
    タイプ 説明
    オブジェクト フィールドの label、value、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(文字列 sys_id, 数値 limit)

    指定されたカテゴリとそのサブカテゴリの KB 記事を返します。

    パフォーマンスの問題を回避するために、このメソッドを使用して大きなカテゴリの記事やインライン画像を含む記事を返さないでください。代わりに、getKBArticleSummaries() を使用してください。

    表 : 21. パラメーター
    名前 タイプ 説明
    sys_id 文字列 KB 記事カテゴリの sys_id。
    limit 数値 返される 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, 数値 limit, 数値 maxChars)

    指定されたカテゴリとそのサブカテゴリのナレッジベース記事のサマリーを返します。

    表 : 23. パラメーター
    名前 タイプ 説明
    sys_id 文字列 KB 記事カテゴリの sys_id。
    limit 数値 返される 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(文字列 tableName, 文字列 view)

    指定されたビューで指定されたテーブルの列のリストを返します。

    表 : 27. パラメーター
    名前 タイプ 説明
    tableName 文字列 テーブルの名前
    view 文字列 列をフィルターするビュー
    表 : 28. 返される内容
    タイプ 説明
    オブジェクト 列名を含むオブジェクト。

    スコープ対象 GlideSPScriptable - getMenuItems(文字列 sysId)

    指定されたインスタンスのメニューアイテムのアレイを返します。

    表 : 29. パラメーター
    名前 タイプ 説明
    sysId 文字列 インスタンスの sysId
    表 : 30. 返される内容
    タイプ 説明
    アレイ 指定されたインスタンスのメニューアイテム

    スコープ対象 GlideSPScriptable - getMenuHREF(GlideRecord page)

    sp_menu タイプに基づいて、URL の (?id=) 部分を返します。

    表 : 31. パラメーター
    名前 タイプ 説明
    page GlideRecord ページ
    表 : 32. 返される内容
    タイプ 説明
    文字列 URL の href 部分。

    スコープ対象 GlideSPScriptable - getParameter(文字列 name)

    指定されたパラメーターの値を返します。

    表 : 33. パラメーター
    名前 タイプ 説明
    name 文字列 クエリ文字列または投稿本文のキーの名前。
    表 : 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(文字列 table, 文字列 sys_id)

    パラメーターが指定されている場合は、指定されたテーブルと Sys ID で識別される GlideRecord を返します。パラメーターが指定されていない場合は、現在の URL で識別されるレコードを返します。

    表 : 37. パラメーター
    名前 タイプ 説明
    テーブル 文字列 オプション。返されるレコードのテーブル。パラメーターが含まれていない場合は、現在の URL で識別されるテーブルと Sys ID を返します。
    sys_id 文字列 オプション。返されるレコードの Sys 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(オブジェクト data, GlideRecord from, 文字列 names)

    指定されたフィールドの表示値を data パラメーターにコピーします。

    表 : 39. パラメーター
    名前 タイプ 説明
    data オブジェクト 指定されたフィールドの表示値がこのオブジェクトにコピーされます。
    from GlideRecord 処理する GlideRecord。
    names 文字列 フィールド名のカンマ区切りリスト。
    表 : 40. 返される内容
    タイプ 説明
    なし

    スコープ対象 GlideSPScriptable - getRecordElements(オブジェクト data, GlideRecord from, 文字列 names)

    指定されたフィールドに対して、要素名、表示値、および値を data パラメーターにコピーします。

    表 : 41. パラメーター
    名前 タイプ 説明
    data オブジェクト 指定されたフィールドの要素名、表示値、および値がこのオブジェクトにコピーされます。
    from GlideRecord 処理する GlideRecord。
    names 文字列 フィールド名のカンマ区切りリスト。
    表 : 42. 返される内容
    タイプ 説明
    なし

    スコープ対象 GlideSPScriptable - getRecordValues(オブジェクト data, GlideRecord from, 文字列 names)

    指定されたフィールド名の値を GlideRecord から data パラメーターにコピーします。

    表 : 43. パラメーター
    名前 タイプ 説明
    data オブジェクト 指定されたフィールドの値がこのオブジェクトにコピーされます。
    from GlideRecord 処理する GlideRecord。
    names 文字列 フィールド名のカンマ区切りリスト。
    表 : 44. 返される内容
    タイプ 説明
    なし

    スコープ対象 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(文字列 table, 文字列 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(文字列 name)

    JSON 要求、インスタンス、またはポータルの名前付き値を返します。

    表 : 53. パラメーター
    名前 タイプ 説明
    name 文字列 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(オブジェクト data, 文字列 names)

    要求またはインスタンスの値を data パラメーターにコピーします。

    表 : 55. パラメーター
    名前 タイプ 説明
    data オブジェクト パラメーター値を受信します。
    names 文字列 フィールド名のカンマ区切り文字列。
    表 : 56. 返される内容
    タイプ 説明
    なし

    スコープ対象 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(文字列 sysID, オブジェクト options)

    id または sys_id でウィジェットを取得し、指定されたオプションを使用してそのウィジェットのサーバースクリプトを実行し、ウィジェットモデルを返します。

    表 : 59. パラメーター
    名前 タイプ 説明
    sysID 文字列 ウィジェットの sys_id または widget_id
    options オブジェクト ウィジェットのサーバースクリプトに渡すオブジェクト。このオブジェクトをサーバースクリプトの options として参照します。
    注:
    この関数に渡されたオプションは、そのスクリプトの [最初の実行 (first execution)] に埋め込みウィジェットのサーバースクリプトでのみ使用できます。埋め込みウィジェットからのサーバースクリプトへの後続の呼び出しには、渡されたオブジェクトプロパティは含まれません。
    表 : 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 User Criteria Support プラグイン (com.glide.service-portal.user-criteria) がアクティブで、[Service Portal のエンタイトルメントのために、ロールのフィールドではなくユーザー基準レコードの使用を有効にします] (glide.service_portal.user_criteria_enabled) システムプロパティが true に設定されている場合に true を返します。

    表 : 63. パラメーター
    名前 タイプ 説明
    なし
    表 : 64. 返される内容
    タイプ 説明
    ブーリアン ユーザー基準が有効な場合は true。

    スコープ対象 GlideSPScriptable - log(オブジェクト message)

    サービス ポータルのログ エントリ [sp_log] テーブルに出力します。ログインユーザーには sp_admin ロールまたは admin ロールが必要です。

    表 : 65. パラメーター
    名前 タイプ 説明
    message オブジェクト ページの出力 サービスポータル として送信するメッセージを表す 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 ページのターゲットはカスタマイズできないことに注意してください。
    注:
    table、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(文字列 searchSourceID)

    現在のユーザーが searchSourceID で指定された検索ソースを表示できる場合は true を返します。

    ユーザーがユーザー基準によって制限されていない場合は true を返します。ユーザー基準がサービス ポータルの資産に与える影響の詳細については、「 サービス ポータルのユーザー基準」を参照してください。
    注:
    このメソッドは検索ソースのロールベースの権限を評価しないため、ユーザー基準が有効になっている場合にのみ使用する必要があります。
    表 : 69. パラメーター
    名前 タイプ 説明
    searchSourceID 文字列 検索ソースレコードの sys_id。
    表 : 70. 返される内容
    タイプ 説明
    ブーリアン 現在のユーザーが検索ソースへの読み取りアクセス権を持っている場合は true。