チュートリアルパート 4: サードパーティライブラリをインストールして使用する

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • ノードパッケージマネージャー (npm) からサードパーティライブラリをインストールし、JavaScript モジュールで使用します。

    始める前に

    「チュートリアルパート 3: ServiceNow Fluent コードでテーブルを定義する」を完了します。

    必要なロール：admin

    このタスクについて

    サードパーティライブラリをインストールすると、JavaScript モジュールの既存のオープンソース機能を使用して、アプリケーション開発を迅速化できます。次に、 index.now.ts ファイルのビジネスルールなど、ソースコード内のサーバー側スクリプト定義からサードパーティコードを呼び出す JavaScript モジュールを参照できます。

    この例では、Lodash ライブラリをインストールして、一般的な JavaScript ユーティリティとメソッドを取得します。サンプル JavaScript モジュールの showStateUpdate 関数でこれらのメソッドの 1 つである snakeCase を使用して、単語をスペースではなくアンダースコアで区切るメッセージ文字列をスネークケースで表示します。index.now.ts ファイルでは、サンプルビジネスルールは、スクリプトに showStateUpdate 関数を使用し、To Do アイテム [x_snc_hello_world_to_do] テーブルでレコードが更新された後に実行されるように構成されています。

    手順

    1. アプリケーションの Lodash ライブラリから snakeCase メソッドをインストールします。
      1. アクティビティバーから、[ファイルエクスプローラー] ビュー(ファイルエクスプローラー) を選択します。
      2. アプリケーションの package.json ファイルを開きます。
      3. [devDependencies] フィールドの後に、ライブラリのパッケージ名とバージョンを含む dependencies フィールドを追加します。 
        },
    "dependencies": {
        "lodash.snakecase": "4.1.1"
    }
}
      4. JavaScript モジュールで TypeScript を使用するアプリケーションの場合は、lodash.snakecase タイプを devDependencies フィールドに追加して、ライブラリのタイプ注釈を取得します。 
        "devDependencies": {
        "@types/lodash.snakecase": "4.1.1",
        "typescript": "5.5.4",
        "@servicenow/sdk": "2.2.4",
        "@servicenow/glide": "26.0.1",
        "eslint": "8.50.0",
        "@servicenow/eslint-plugin-sdk-app-plugin": "2.2.4"
    }
      5. 変更内容を保存します。
      6. プロンプトが表示されたら、[ 不足している依存関係のインストール] を選択します。
        ヒント:
        [依存関係のインストール] アイコン (依存 関係のインストール) を選択するか、コマンドパレットから [パッケージマネージャー:依存関係のインストール ] コマンドを使用することもできます。

        ServiceNow IDE に依存関係をインストールするためのオプション。

        ライブラリはモジュールとして node_modules ディレクトリにインストールされます。
    2. アプリケーションの JavaScript モジュールで Lodash ライブラリのコードを使用します。
      1. アプリケーションの src/server ディレクトリに移動します。
      2. script.tsサンプルモジュールを開きます。
      3. addInfoMessage メソッドで、Lodash の snakeCase メソッドでメッセージ文字列をラップして、スネークケースに変換します。 
        gs.addInfoMessage(snakeCase(`state updated from "${previousState}" to "${currentState}"`))
      4. 2 行目で、lodash モジュールの snakeCase メソッドのインポートを追加します。 
        import snakeCase from 'lodash.snakecase'
        注:
        グローバル Glide API もインポートされるため、モジュールコードで addInfoMessage などのメソッドを使用できます。 
        import { gs } from '@servicenow/glide'
      5. 変更内容を保存します。
    3. ステータスバーから、[ビルドとインストール] ] を選択します。

      のインストールが正常に完了すると、Lodash ライブラリが EcmaScript モジュール [sys_module] テーブルに追加され、script.ts モジュールが EcmaScript モジュール [sys_module] テーブルで更新されます。

    タスクの結果

    To Do アイテム [x_snc_hello_world_to_do] テーブルのレコードのフィールドを更新すると、サンプルビジネスルールが実行され、スペースではなくアンダースコアで区切られたメッセージがスネークケースで表示されます。

    スネークケースの showStateUpdate 関数からのメッセージ文字列

    次のタスク

    チュートリアルパート 5:別のインスタンスでアプリケーションのクローンを作成する に続きます。