--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # UI スクリプト # UI スクリプト {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分 UI スクリプトを使用すると、クライアント側の JavaScript を再利用可能な形式にパッケージ化できます。これは、スクリプトインクルードがサーバー側の JavaScript を格納する方法と似ています。アドミニストレーターは、UI スクリプトを作成し、それらをクライアントスクリプト、他のクライアント側のスクリプトオブジェクト、および HTML コードから実行できます。 UI スクリプトはモバイルではサポートされていません。 ## グローバル UI スクリプト {#ariaid-title2} UI スクリプトを作成してグローバルとして指定すると、システム内の任意のフォームでスクリプトを使用できるようになります。スコープ対象のアプリケーションからグローバル UI スクリプトを作成することはできません。 UI スクリプトをグローバルとして指定すると、システム内の任意のフォームが使用できるようになります。たとえば、関数 helloWorld() を持ち、\[グローバル\] フィールドがオンになっている UI スクリプトを作成できます。 function helloWorld() { alert('Hi'); } このグローバル UI スクリプトを作成した後、作成したクライアントスクリプトまたは UI ポリシーから helloWorld() 関数を呼び出すことができます。 ## UI スクリプトの作成 {#ariaid-title3} 再利用可能なクライアント側の JavaScript コードを定義する UI スクリプトを作成します。 ### 手順 UI スクリプトを作成するには、 システム UIUI スクリプト をクリックし、レコードを作成または編集します (フィールドの説明についてはテーブルを参照)。 {#t_CreateAUIScript__table_zsc_z4z_sr__entry__2} | フィールド | 説明 | |-|-| | スクリプト名 | UI スクリプトの名前。名前がシステム上で一意であることを確認してください。 | | API 名 | スコープとスクリプト名を含む、UI スクリプトの API 名 (x_custom_app.HelloWorld など)。 | | アプリケーション | UI スクリプトを含むアプリケーション。 | | アクティブ | UI スクリプトがアクティブかどうかを示すインジケーター。アクティブな UI スクリプトのみを実行できます。 | | グローバル | スクリプトがシステム内のすべてのページでロードされるかどうかを示すインジケーター。 注: パフォーマンスに影響を与える可能性があるため、グローバル UI スクリプトを作成するときは注意が必要です。スコープ対象のアプリケーションからグローバル UI スクリプトを作成することはできません。 | | 説明 | スクリプトの目的の概要。 | | スクリプト | 他のスクリプトから呼び出されたときに実行するクライアント側のスクリプト。 | [表 : 1. UI スクリプト] {#t_CreateAUIScript__table_zsc_z4z_sr} ## UI スクリプトの実行 {#ariaid-title4} UI スクリプトを実行するときは、次のガイドラインに従ってください。 ### フォームからの UI スクリプトの実行 フォームで UI スクリプトを実行するには、[フォーマッターを作成してフォームに追加します](https://www.servicenow.com/docs/access?context=t_CreateAFormatter&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)。関連する [UI マクロ](https://servicenow-prod.fluidtopics.net/SDbTtd8ZzXr9cfP3Pv3NlQ#c_UIMacros "UI マクロは、アドミニストレーターがユーザーインターフェイスに追加できる個別のスクリプト化されたコンポーネントです。")で、 `g:requires` タグを含め、name= パラメーターを UI スクリプト名の後に .jsdbx 拡張子を付けて指定します。フォームビューにフォーマッターを追加します。 このコードにより、UI スクリプトの定義と結果をブラウザーですぐに利用できるようになります。 var now_GR = new GlideRecord('sys_ui_script'); gr.orderByDesc('sys_updated_on'); gr.query(); gr.next(); gr.getValue('sys_updated_on'); ### HTML での UI スクリプトの呼び出し {#r_RunUIScripts__section_o5w_npl_d2b} HTML コードから UI スクリプトを実行するには、 `]]>` タグを使用し、 `src=` 引数を UI スクリプトの API 名の後に .jsdbx 拡張子を付けて指定します。たとえば、CoolClock という名前の UI スクリプトを次のコードに含めます。