ServiceNow IDE のアプリケーションで JavaScript モジュールを作成して使用する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：5分

    • ServiceNow IDE で、JavaScript モジュールで再利用可能なコードブロックを定義して、コードベースを最適化します。

    始める前に

    アプリケーションを作成、変換、またはクローン作成して、ワークスペースに追加します。詳細については、「でのアプリケーションの追加 ServiceNow IDE」を参照してください。

    注:
    モジュールで TypeScript を使用するには、アプリケーションの作成時にテンプレートタイプとして TypeScript を選択します。

    必要なロール：admin

    このタスクについて

    スコープ対象のアプリケーションでの JavaScript モジュールの使用のサポート (制限事項を含む) については、「 JavaScript モジュールとサードパーティライブラリ」を参照してください。 JavaScript モジュールの作成に使用される構文に関する一般的な情報については、MDN Web Docs Web サイトの「JavaScript modules (JavaScript モジュール)」ページを参照してください。

    注:
    コード向け Now Assist を使用すると、コードのオートコンプリートスキルを使用して、モジュールスクリプトのコード提案を生成できます。詳細については、「Generate code with autocomplete」を参照してください。

    手順

    1. 移動先 すべて > アプリ開発 > ServiceNow IDE.
    2. アプリケーションでワークスペースを開きます。
    3. アクティビティバーから、[ファイルエクスプローラー] ビュー(ファイルエクスプローラー) を選択します。
    4. アプリケーションの src/server ディレクトリに、再利用するモジュールコードを含む JavaScript または TypeScript ファイルを作成します。
    5. オプション: サーバー API またはスクリプトインクルードをインポートして、モジュールから呼び出します。

      Glide API は、 @servicenow/glide パッケージまたはパッケージ内の名前空間からインポートできます。スクリプトインクルードは、 @servicenow/glide パッケージのアプリケーションスコープまたはグローバルスコープからインポートできます。

      たとえば、次のようになります。
      import { API } from "@servicenow/glide";
import { API } from "@servicenow/glide/<namespace>";
import { ScriptInclude } from "@servicenow/glide/<scope>";
import { global } from "@servicenow/glide/global";
    6. モジュールで、エクスポートするコードを export ステートメントで指定します。

      名前付きエクスポートまたはデフォルトのエクスポートを使用できます。名前付きエクスポートは変数、定数、関数、またはクラスにすることができますが、デフォルトのエクスポートは関数またはクラスのみにすることができます。

      次の例は、モジュール内の複数の機能 (関数と変数) の名前付きエクスポートを追加する 1 つの方法です。
      export { myFunction, myVariable };
    7. エクスポートされたモジュールのコードを他のモジュールまたはサーバー側スクリプトで使用します。
      ファイルステップ
      モジュール
      1. src/server ディレクトリから、JavaScript モジュールを作成するか開きます。
      2. import ステートメントを使用してモジュールコードをインポートします。
        次の例は、エクスポートされた機能をモジュールにインポートする 1 つの方法です。
        import { feature } from "path/to/module";
        注:
        ある TypeScript ファイルから別の TypeScript ファイルにコードをインポートするには、 .ts ファイル拡張子を含める必要があります。たとえば、「 ./module.ts」から { feature } をインポートします。
      3. このモジュールからモジュールコードを呼び出し、再利用します。
      ソースコード内のサーバー側スクリプト
      1. ソースコード (.now.ts ファイル) で、ビジネスルールなどのサーバー側スクリプトを含むアプリケーションメタデータの定義を作成するか、開きます。
      2. script プロパティで、モジュールコードをインポートして呼び出し、再利用します。
        関数をインポートするか、インラインスクリプトを指定できます。
        • エクスポートされた関数、関数式、またはデフォルト関数をインポートします。例：
          script: FunctionExport,
        • インラインスクリプトでは、require ステートメントを使用してモジュールコードをインポートする必要があります。例：
          script: `
    const { process } = require('./dist/modules/server/handler.js')
    process(request, response)`,

        ソースコードのサーバー側スクリプトの詳細については、「ServiceNow Fluent API リファレンス」を参照してください。
      サーバー側スクリプトレコード
      1. ビジネスルールなどのサーバー側スクリプトのレコードを開きます。
      2. require ステートメントを使用してモジュールコードをインポートします。
        次の例は、エクスポートされた機能をスクリプトにインポートする 1 つの方法です。
        const { feature } = require("path/to/module");
      3. このスクリプトからモジュールコードを呼び出し、再利用します。
    8. 変更内容を保存します。
    9. ステータスバーから、[ビルドとインストール] ] を選択します。

      ビルドと展開

      エディターで開いているアクティブなファイルによって、ビルドするアプリケーションが決まります。ファイルが開いていない場合は、プロンプトが表示されたらビルドするアプリケーションを選択します。

      ビルド後、モジュールは EcmaScript モジュール [sys_module] テーブルに追加されます。

    次のタスク

    JavaScript モジュールでサードパーティライブラリを使用するには、「ServiceNow IDE のアプリケーションでサードパーティライブラリを使用する」を参照してください。