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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

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

    始める前に

    アプリケーションを作成、変換、またはクローンして、ワークスペースに追加します。詳細は、以下のトピックを参照してください。
    注:
    モジュールで TypeScript を使用するには、アプリケーションの作成時にテンプレートタイプとして TypeScript を選択します。

    必要なロール：admin

    このタスクについて

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

    手順

    1. 次のように移動する。 All (すべて) > アプリ開発 > ServiceNow IDE.
    2. アプリケーションでワークスペースを開きます。
    3. アクティビティバーから、[ファイルエクスプローラー] ビュー(ファイルエクスプローラー) を選択します。
    4. アプリケーションの src/server ディレクトリに、再利用するモジュールコードを含む JavaScript または TypeScript ファイルを作成します。
    5. オプション: グローバル Glide API をインポートして、モジュールから呼び出します。 
      import { gs } from '@servicenow/glide'
    6. モジュールで、エクスポートするコードを export ステートメントで指定します。

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

      次の例は、モジュール内の複数の機能 (関数と変数) の名前付きエクスポートを追加する 1 つの方法です。
      export { myFunction, myVariable };
    7. エクスポートされたモジュールのコードを他のモジュールまたはサーバー側スクリプトで使用します。
      ファイルステップ
      モジュール
      1. src/server ディレクトリから、JavaScript モジュールを作成するか開きます。
      2. import ステートメントを使用してモジュールコードをインポートします。
        次の例は、エクスポートされた機能をモジュールにインポートする 1 つの方法です。
        import { feature } from "path/to/module";
      3. このモジュールからモジュールコードを呼び出し、再利用します。
      ソースコード内のサーバー側スクリプト
      1. ソースコード (.now.ts ファイル) で、ビジネスルールなどのサーバー側スクリプトを含むアプリケーションメタデータの定義を作成するか、開きます。
      2. script プロパティで、モジュールコードをインポートして呼び出し、再利用します。
        関数をインポートするか、script タグが前に付いたインラインスクリプトを指定できます。
        • エクスポートされた関数、関数式、またはデフォルト関数をインポートします。例：
          script: FunctionExport,
        • インラインスクリプトでは、require ステートメントを使用してモジュールコードをインポートする必要があります。例：
          script: 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 のアプリケーションでサードパーティライブラリを使用する」を参照してください。