ServiceNow SDK でアプリケーションをビルドして展開する

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

    • ServiceNow SDK で開発されたローカルアプリケーションビルドして、ServiceNow インスタンスに展開します。

    始める前に

    必要なロール： admin

    このタスクについて

    この手順では、ServiceNow SDK コマンドラインインターフェイス (CLI) を使用します。コマンドラインツールから「 now-sdk --help 」と入力すると、使用可能なコマンドとグローバルオプションに関する情報を取得できます。コマンドとそのパラメーターに関する追加情報を取得するには、コマンドと --help または -h を入力します。たとえば、now-sdk auth --help などです。CLI の詳細については、「 ServiceNow SDK CLI」を参照してください。

    手順

    1. アプリケーションディレクトリから、システム上のコマンドラインツールを開きます。
    2. インスタンス上のメタデータの変更を最新の状態に保つため、fetch コマンドを使用してアプリケーションをフェッチします。 
      now-sdk fetch --auth <alias>
      注:
      インスタンスからアプリケーションメタデータをフェッチする際に、JavaScript モジュールの更新は含まれません。
    3. ビルド コマンドを使用してアプリケーションをビルドします。
      ソース タイプコマンド
      JavaScript ソース 
      now-sdk build
      TypeScript ソース 
      npm run build

      このコマンドは、TypeScript ファイルを JavaScript モジュールにコンパイルし、アプリケーションをビルドします。アプリケーションでの TypeScript の使用の詳細については、「ServiceNow SDK で JavaScript モジュールの TypeScript を使用する」を参照してください。
      ビルドアーティファクトは dist/app ディレクトリに出力され、メタデータが dist/app/update ディレクトリ内に XML ファイルとして含まれます。展開可能パッケージが target ディレクトリに出力されます。
    4. deploy コマンドを使用してアプリケーションを展開します。 
      now-sdk deploy --auth <alias>
      警告:
      deploy コマンドで -reinstall true パラメーターを使用すると、インスタンスで他の開発者が作成したアプリケーションメタデータを削除できます。ビルドプロセス中に生成されたローカル展開パッケージに存在しないインスタンス上のアプリケーションメタデータは、すべて展開中に削除されます。アプリケーションをビルドする前に、now-sdk fetch コマンドを使用して、ローカルメタデータをインスタンスのメタデータと同期します。

    タスクの結果

    インスタンスでアプリケーションが更新され、ローカルの変更が反映されます。 ServiceNow Fluent コードはアプリケーションメタデータにコンパイルされ、アプリケーション内のモジュールがインスタンスで EcmaScript モジュール [sys_module] テーブルに追加されます。

    注:
    EcmaScript モジュール [sys_module] テーブルに不要になった以前のバージョンのモジュールがある場合、reinstall パラメーター (now-sdk deploy --reinstall true) を使用してアプリケーションをインストールすると、以前のバージョンのアプリケーションのモジュールがテーブルから削除されます。