実践ServiceNow ー 自分が管理している資産をポータルに表示させる

# 概要
次ぎの2つの仕様を実装する：
1. サービスポータルに自分が管理している資産を表示されるウイジェットを作成する。<br/><img width="300" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/23124e99-b288-3444-209f-64375630a1c2.png"/>

1. メニューに自分が管理している資産を表示させ、クリックすると資産ウィジェットを配置してページを表示させる。<br/>![portal_my_widget_26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/383eb047-e9e0-3f4c-4aa6-246a74ba2b8c.png)

# 手順
ウィジェットで自分の資産を表示させる手順とメニューに自分の資産を表示させる手順を分けて説明します。
## ウィジェットで自分の資産を表示させる
1. アプリケーションナビゲータから「ポータル」を検索してService Portal下の「サービスポータル設定」を選択する。<br/>![portal_my_widget_10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/1a264e8e-dd10-8fb9-0e03-c4587b875e56.png)
1. 「デザイナー」を選択する。<br/>![portal_my_widget_11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/3956d48d-590a-b3cf-e830-4cf06593d35e.png)
1. 「従業務員ポータル」アイコンを選択する。<br/>![portal_my_widget_12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/95a3a9a2-6a8f-490c-408d-188eaab196e2.png)
1. 「データ」を検索する。<br/>![portal_my_widget_13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/bb0dff80-5abb-2ef8-82d8-ef4a18f6ca79.png)
1. 「インスタンス定義からのデータテーブル」をページ設定領域にドラッグ＆ドロップする。<br/>![portal_my_widget_14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/89af5fb4-3692-bab9-52ac-b04edcdd4175.png)
1. ドラッグ＆ドロップした「インすんタンス定義からのデータテーブル」ウィジェットの右上の編集アイコンを選択する。<br/>![portal_my_widget_15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/bb7fe57b-f66f-3a26-4e61-08e5c28ba936.png)
1. 次のように入力した後に「保存」ボタンを押下する。<table><tr><th>項目名</th><th>値</th></tr><tr><td>テーブル</td><td>資産[alm_asset]</td></tr><tr><td>フィルター</td><td>assigned_to=javascript:gs.getUserID()</td></tr><tr><td>フィールド</td><td>「asset_tag」、「model_category」、「display_name」</td></tr><tr><td>最大エントリ</td><td>10</td></tr><tr><td>順番</td><td>表示名</td></tr><tr><td>ソート方向</td><td>昇順</td></tr><tr><td>タイトル</td><td>自分の資産</td></tr></table><br/>![portal_my_widget_16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/eea6293e-08d5-70e7-e397-988630cddd64.png)
1. 次のように自分の資産がウィジェットに表示します。<br/>![portal_my_widget_17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/5a32046b-184d-aabe-e7fa-fa637394ed43.png)
1. サービスポータルページを表示してウィジェットに自分の資産が正しく表示していることを確認します。<br/>![portal_my_widget_18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/23124e99-b288-3444-209f-64375630a1c2.png)

## メニューに自分の資産を表示する項目を追加する
メニューで自分の資産を表示するようにします。
1. サービスポータル設定の右上の「ポータルテーブル」を選択します。<br/>![portal_my_widget_20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/1498e8b6-bd0f-a5c3-e05c-6b5055c42383.png)
2. 「メニュー付きインスタンス」を選択します。<br/>![portal_my_widget_21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/d00ca37d-83f3-7564-4c1c-33eded8226a6.png)
3. 「SPヘッダーメニュー」を選択します。<br/>![portal_my_widget_22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/4fb84e2d-d39a-1801-80b5-22612fe637d9.png)
1. 右側にSPヘッダーメニューが表示されます。下の関連リストの「メニューアイテム」リンクをクリックします。<br/>![portal_my_widget_23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/4d262230-2803-e872-70d7-48f0d3b39de7.png)
4. メニューに自分の資産項目を追加するので「新規」ボタンを押下します。<br/>![portal_my_widget_24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/ca27ae63-f3ef-fb16-3e53-7bf16873e842.png)
5. 次のように入力した後に「保存」ボタンを押下します。<table><tr><th>項目名</th><th>値</th></tr><tr><td>ラベル</td><td>自分の資産</td></tr><tr><td>種類</td><td>スクリプト化済みリスト</td></tr></table>スクリプト<pre>var max = 10;
var t = data;
data.count = 0;
var items = data.items = [];

var user = gs.getUser().getID();
items.record_watchers = [];
items.record_watchers.push({'table':'alm_asset','filter':'assigned_to=' + user.toString()});

var gr = new GlideRecord('alm_asset');
gr.addQuery("assigned_to", user);
gr.orderBy('display_name')
gr.setLimit(max);
gr.query();

while (gr.next()) {
  var a = {};
  var title = gr.display_name.toString() ;
  addCI(title, gr.sys_id);
}

function addCI(title, query) {
	data.count++;
	var link = {};
	link.title = title;
	link.type = 'link';
	link.href='?id=index'; // ホームページを開く
	// link.href='nav_to.do?uri=alm_hardware.do?sys_id=' + query; // 当該資産ページを開く
	items.push(link);
}</pre>
![portal_my_widget_25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/ea0a5b5b-31fc-e861-07c3-fb992bf70595.png)
6. メニューに「自分の資産」が追加されて選択すると資産一覧が表示されることを確認します。<br/>
![portal_my_widget_26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/383eb047-e9e0-3f4c-4aa6-246a74ba2b8c.png)

# 資産一覧ウィジェットを自作する
ServiceNowから標準で提供されている「インすんタンス定義からのデータテーブル」ウィジェット」を利用することもできますが、自分でもウィジェットを作成することもできます。例として、自分の資産一覧を表示するウィジェットを作成します。
![portal_my_asset_widget_23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e85e6f58-a477-9c75-47f2-452d6889a2a6.png)

1. アプリケーションナビゲータから「ポータル」を検索してService Portal下の「サービスポータル設定」を選択します。<br/>![portal_my_asset_widget_10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/bf362995-61a6-a8f4-6b39-2046aeb1d679.png)
1. 「ウィジェットエディター」アイコンを選択します。<br/>![portal_my_asset_widget_11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/285ecef7-b6a1-871d-0efc-6d0b120460a3.png)
1. 「新規ウィジェットの作成」をクリックします。<br/>![portal_my_asset_widget_12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e4496846-5f45-be0c-987d-c88e603ce074.png)
1. ウィジェット名を入力します。<br/>下の例では名前を「MyAsset」にしています。上が表示名で下が内部で利用される名前です。内部名は小英数、アンダースコア、ハイフンにします。<br/>![portal_my_asset_widget_13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/fdad3d0d-0aa3-500a-096b-902dc813df75.png)
1. ウィジェットのコードを入力します。<br/>HTMLテンプレート<pre>&lt;div class="panel panel-primary">
  &lt;div class="panel-heading">自分の資産&lt;/div>
  &lt;div class="panel-body">
		&lt;table>
      &lt;tr>
        &lt;th class="tableHeader">タグ&lt;/th>
        &lt;th class="tableHeader">カテゴリ&lt;/th>
        &lt;th class="tableHeader">名前&lt;/th>
      &lt;/tr>
     &lt;tr ng-repeat="asset in data.assets | orderBy: display_name">
       &lt;td>{{asset.asset_tag}}&lt;/td>
       &lt;td>{{asset.model_category}}&lt;/td>
       &lt;td>&lt;a href ="nav_to.do?uri=alm_hardware.do?sys_id={{asset.sysid}}">{{asset.display_name}}&lt;/a>&lt;/td>
     
&lt;/tr>                         
    &lt;/table>
  &lt;/div>
&lt;/div</pre>クライアントスクリプト<pre>api.controller=function() {
  /* widget controller */
  var c = this;
};</pre>サーバースクリプト<pre>(function() {
  data.userID = gs.getUserID();
  data.assets = [];
  var gr = new GlideRecordSecure('alm_asset');
  gr.addQuery('assigned_to', gs.getUserID());
    gr.setLimit(20);
    gr.orderByDesc("display_name")
  gr.query();
  data.recordCount = gr.getRowCount();
  data.assets = [];
  while (gr.next()) {
    var asset = {};
    asset.asset_tag = (gr.asset_tag != null) ? gr.asset_tag + '' : '';
    asset.model_category = gr.model_category.getDisplayValue();
    asset.display_name = gr.display_name + '';
    asset.assigned_to = gr.assigned_to.getDisplayValue();
    asset.sysid = gr.sys_id + '';
    data.assets.push(asset);
  }
})();</pre>![portal_my_asset_widget_14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/8cfa14c6-761f-33eb-8046-682d374aae6b.png)
6. 「CSS-SCSS」をチェックしてCSS-SCSSを入力します。入力した後に「保存」ボタンを押下します。<pre>table  {
  border: 1px solid grey;
  border-collapse: collapse;
  padding: 5px;
}
th, td {
  padding: 5px;
}
table tr:nth-child(odd) {
  background-color: #e5e5e5;
}
table tr:nth-child(even) {
  background-color: #ffffff;
}
.tableHeader {
  text-align:center;
  padding:5px;
  background-color:#dcdcdc;
}</pre>![portal_my_asset_widget_15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e973c6c6-6fc8-f911-0193-bc0ab9b70b90.png)
7.保存されると次のようにメッセージが表示されます。<br/>![portal_my_asset_widget_16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/5210355f-27eb-dcbf-d27c-28a40876d54f.png)
8.ウィジェットをポータルに配置します。<br/>メニューから「デザイナー」を選択します。<br/>![portal_my_asset_widget_17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/7bf620db-ddbb-237c-afc3-3ce415b076ed.png)
9.「従業員ポータル」アイコンを選択します。<br/>![portal_my_asset_widget_20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/1f3e1c90-df44-d90f-d011-3aeda302d9ea.png)
10.配置するウィジェットを検索します。<br/>今回は作成したウィジェットを配置するので「my」を検索して「MyAsset」を探します。<br/>![portal_my_asset_widget_21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/0251a8ac-a31f-e597-5455-963a45eb7572.png)
11.ドラッグ＆ドロップして「MyAsset」ウィジェットをポータルページに配置します。<br/>![portal_my_asset_widget_22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e2b46ac8-ab6f-ee0c-7e51-b545270d8e75.png)
[portal_my_asset_widget_23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e85e6f58-a477-9c75-47f2-452d6889a2a6.png)
12.自分資産一覧が表示されます。<br/>![portal_my_asset_widget_23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/e85e6f58-a477-9c75-47f2-452d6889a2a6.png)

## ウィジェット名を日本語にする
国際化対応する場合は名前は英語の方がよいですが、日本語のみのサイトを構築する場合はウィジェット名を日本語に変更することができます。日本語に変更するとウィジェットを日本語で検索することができます。
1. アプリケーションナビゲータから「ウィジェット」を検索して、Service Portal下の「ウィジェット」を選択します。<br/>![portal_my_asset_widget_33.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/8c83afb5-6455-09e9-d493-85bdc7c20f16.png)
1. 名前を変更するウィジェットを検索する。<br/>下の例では名前が「MyAsset」で検索しています。<br/>![portal_my_asset_widget_30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/f1659669-a810-f958-252e-1c52b3b91ab8.png)
1. 名前を変更するウィジェットを選択します。<br/>下の例では「MyAsset」を選択します。<br/>![portal_my_asset_widget_31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/35c29508-3861-1d80-8ba3-257d8d754f8f.png)
1. ウィジェットの名前を日本語に変更して「更新」ボタンを押下します。<br/>![portal_my_asset_widget_32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/61acb489-8ab0-00d7-567c-429f5fca95c9.png)
1. 名前を日本語にすると日本語でウィジェットを検索することが出来ます。<br/>![portal_my_asset_widget_34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/ede96427-59eb-80cc-af20-4a0133c0c107.png)

# 自分の資産用のページにウィジェットを配置する
メニューや既存のページにウィジェットを配置するのではなく、自分の資産用のページを作成してメニューからページに移動できるようにします。
## 自分の資産用のページを作成する
1. アプリケーションナビゲータから「ポータル」を検索して、Service Portal下の「サービスポータル設定」を選択します。<br/>![portal_my_asset_widget_40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/880a5669-653b-7bf5-1718-d7c541931f88.png)
1. 「デザイナー」アイコンを選択します。<br/>![portal_my_asset_widget_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/2cd26c70-43bb-c643-18ea-e0bce6e9afed.png)
1. 「新規ページを追加する」リンクをクリックします。<br/>![portal_my_asset_widget_42.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/ebb10e6d-77c2-c147-c9d6-1363686ad591.png)
1. ページ名を入力します。ページタイトルは表示される名前で、ページIDは内部で利用される識別子です。ページを選択する場合などはページIDを使います。<br/>![portal_my_asset_widget_43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/c802c1e6-43a7-8711-bcb9-bd33991e5aec.png)
1. ページレイアウトを選択します。<br/>今回は自分の資産ウィジェットのみを配置するので「12」を選択します。<br/>![portal_my_asset_widget_44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/82882dd9-3bb1-4c3a-aaf8-b20c49d28b80.png)
1. ページにウィジェットを配置します。<br/>左メニューからウィジェットを選択してページ領域にドラッグ＆ドロップします。<br/>「インスタンス定義からのデータテーブル」を配置する場合は「ウィジェットで自分の資産を表示させる」の手順4を実施します。<br/>![portal_my_asset_widget_45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/7f85aa8d-967b-d5c4-f7f5-cd23f44ca3fb.png)
1. ウィジェットがページに表示されます。メニューから「プレビュー」を選択してポータルでどのように表示されるかを確認します。<br/>![portal_my_asset_widget_46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/3a00b59d-b962-9787-e892-9da403463095.png)
1. ポータルのプレビューページが表示されます。<br/>![portal_my_asset_widget_47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/6f179923-f568-e793-1d71-057862ef1439.png)

## メニューからページを開くようにする
作成した自分の資産ぺーじをメニューから開くようにします。
1. 「サービスポータル設定」ページのメニューから「ポータルテーブル」を選択して、「メニュー付きインスタンス」を選択します。<br/>![portal_my_asset_widget_50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/1de2da0d-be79-9fe4-5a1c-e13e8818fd03.png)
2. 「SPヘッダーメニュー」を選択して、右側に表示されるメニュー設定の下にある「メニューアイテム」リンクをクリックします。<br/>![portal_my_asset_widget_51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/21374e29-4cb8-d66f-ed88-ec6f32b6df4e.png)
3. 新しいメニュー項目を追加します。<br/>「新規」ボタンを押下します。<br/>![portal_my_asset_widget_52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/558505fd-a080-5add-95e5-4819da87e50e.png)
4. 次のように設定した後に「保存」ボタンを押下します。<table><tr><th>項目名</th><th>値</th><th>コメント</th></tr><tr><td>ラベル</td><td>自分の資産ページ</td><td></td></tr><tr><td>種類</td><td>ページ</td><td></td></tr><tr><td>ページ</td><td>myasses</td><td>リンクするページのID</td></tr></table>
![portal_my_asset_widget_53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/8a832aea-3113-136e-f9aa-3d1d8e8c483f.png)
6.「自分の資産ページ」がニューに追加されて選択すると自分の資産ページが表示されます。<br/>![portal_my_asset_widget_54.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/698027/896b7cf4-498d-2c30-68db-03695a7d363c.png)

以上