こんにちは。ざわかける！のざわ(@zw_kakeru)です。
今回はServiceNowが提供しているApp Engine Studio上のUI Builderにおける、Script Includesの使い方についてです。(アルファベットの単語が4つも並んでる…)
スクリプトを実際に書く場所をどうやって見つけるかという話がメインです。
初見だとハマると思う(私はハマった)ので、ここに書き記しておきます。
動作環境
ServiceNow: Rome起きたこと
App Engine Studioでアプリケーションを作成し、UI Builder上で左下のアイコンをクリックしてPage Scriptsを開きます。
ページ上で動くClientスクリプトをここに記述していくことができるのですが、ふと見ると”Script Includes”なるオプションがあります。
名前からして、他で記述したスクリプトをここで流用できるのだろうと予測できますが、この機能をどうやって使えばいいのかいまいち分かりません。
「Add」ボタンでスクリプトを追加するのは分かるのですが、ここで追加されるスクリプトは果たして一体どこに書けばいいのでしょうか。
おそらくServiceManagement側で確認ができるのですが、ServiceManagementで「Scripts」とかで検索してみてもそれらしいモジュールが全くヒットしません。
というかここに5つくらいデフォルトで用意されているスクリプトが表示されていますが、これらがServiceManagementのどこにもありません。
所在地を見つけることができないので、これらのスクリプトの使い方も分からなければ何をしてくれるのかも分かりません。
どうやって探せばいいのでしょうか。
“Page scripts”の説明動画を見てみると(公式ブログもとても参考になります)、
Script Includesの中身を編集するのに”UX Client Script”モジュールを使っていることが分かります。
ここにアクセスすれば解決。と思ってServiceManagementで検索をかけてみますが、
なんと、”UX Client Script”を検索しても引っかかりません。なんでやねん。
完全にお手上げですね。
やったこと
なぜ検索で表示されないのか全く分かりませんが、仕方がないのでURL上で直接アクセスする方法を試してみます。
まず、ServiceManagementのホーム画面を開いてそのURLを確認します。
文字列がつらつらと並んでいますが、まずここのuri=%2以降の文字列を削除します。
https://devXXXXX.service-now.com/nav_to.do?uri=%2そして、後ろにsys_ux_client_script_include_list.doの文字を追加します。
https://devXXXXX.service-now.com/nav_to.do?uri=%2sys_ux_client_script_include_list.do
はい、Enterを押してください。
すると。
ばっちり、”UX Client Script”モジュールにアクセスすることができました！
やったあ。
先程UI BUilder側に表示されていたデフォルトのスクリプトもここにいますね！
ここに自分の好きなスクリプトを書くことで、UI Builderから呼び出すことができます。
ちなみに(分かるかもしれませんが)Serverスクリプトとなります。
もう一つの解決方法
私は上記のやり方を実施しましたが、もう一つのアクセス方法を紹介します。
ServiceManagementの検索窓に直接sys_ux_client_script_include_list.doを入力します。
(sys_ux_client_script_include.listまででも大丈夫らしいです。)
この方法でも”UX Client Script”モジュールにアクセスできます。
こちらの方が簡単ですね。
というかここの検索窓にモジュールのパスを入力したら直接飛べるんですね…知りませんでした。
そんなことどこかに書いてあったかなあ。
おわりに
以前も言ったかもしれませんが、ServiceNowはドキュメントが大量にあるにはありますが全然体系だって整理されていないので、欲しい情報を見つけ出すのにとても苦労します。
解決までさらっと書いていますが、”UX Client Script”がどこにいるのか本当に分からなくて結構長い時間ハマっていました。
(Tipsに書く内容はいつもそうなのですが..)
最終的にNowCommunityに質問を投げて、世界の有識者たちに今回の方法を教えてもらいました。ありがとうございました。
にしても検索でも出てこないのは困ります…何故…
はい、今回は以上です。
