を使用してアプリケーションを作成 する ServiceNow SDK

  • リリースバージョン: Zurich
  • 更新日 2025年01月30日
  • 所要時間:5分
  • スコープ対象のアプリケーションを作成する して、 ServiceNow SDKを使用してソースコードで開発します。

    始める前に

    ServiceNow SDK を使用して、ServiceNow インスタンスに対する認証を行います。詳細については、「を使用した ServiceNow インスタンスへの認証 ServiceNow SDK」を参照してください。

    必要なロール:admin

    このタスクについて

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

    手順

    1. アプリケーションのローカルディレクトリを作成します。
    2. Visual Studio Codeで、ディレクトリを開きます。
    3. アプリケーションディレクトリから、統合されたターミナルウィンドウを開きます。
    4. init コマンドを使用して、ガイド付き一連のプロンプトに従ってアプリケーションを作成します。
      npx @servicenow/sdk init
      注:
      npx コマンドを使用すると、ServiceNow SDKがグローバルではなくアプリケーションディレクトリにインストールされます。
    5. 次の一連のプロンプトに応答します。
      プロンプト 応答
      テンプレートの選択 デフォルトのアプリケーション構造を定義するテンプレートを選択します。
      • 基本的な now-sdk 定型文:ソースコードでの開発に必要な基本構造のみを備えたアプリケーション。
      • JavaScript now-sdk + basic: ServiceNow Fluent および JavaScript での開発用に構成されたアプリケーション。
      • JavaScript now-sdk + fullstack React: ServiceNow Fluent、JavaScript、および React での開発用に構成されたアプリケーション。
      • TypeScript now-sdk + basic: ServiceNow Fluent および TypeScript での開発用に構成されたアプリケーション。src/server ディレクトリ内の TypeScript ソースファイルは JavaScript モジュールにトランスパイルされます。
      • TypeScript now-sdk + fullstack React: ServiceNow Fluent、TypeScript、および React での開発用に構成されたアプリケーション。src/server ディレクトリ内の TypeScript ソースファイルは JavaScript モジュールにトランスパイルされます。
      ServiceNow アプリケーションの名前 アプリケーションの名前を入力します。
      NPM パッケージ名 package.jsonファイルで使用されるアプリケーションパッケージの名前を入力します。

      パッケージ名は、ノードパッケージマネージャー (npm) のパッケージ命名基準に準拠している必要があります。

      スコープ名 アプリケーションのスコープを入力します。

      スコープ名はインスタンス上で一意で、x_<プリフィックス> で始まり、18 文字以下である必要があります。詳細については、「名前空間識別子」を参照してください。

      次の例では、Example App (x_snc_example_app) という名前のスコープ対象のアプリケーションが作成されます。
      $ npx @servicenow/sdk init
      [now-sdk] Bootstrapping a new ServiceNow application project...
      ? Select a template: now-sdk + basic
      ? Name of ServiceNow Application:  Example App
      ? NPM package name:  example-app
      ? Scope name:  x_snc_example_app
      [now-sdk] Application created successfully.
                Install the required dependencies with your preferred package manager before running "$now-sdk build".
                Ex: Run "npm install" if using npm.
    6. お好みのパッケージマネージャーを使用して、必要なサードパーティの依存関係をインストールします。
      たとえば、ノードパッケージマネージャー (npm) を使用する場合は、 npm install を実行します。
    7. build コマンドを使用してアプリケーションをビルドします。
      now-sdk build
    8. オプション: install コマンドを使用して、インスタンスにアプリケーションをインストールします。
      now-sdk install --auth <alias>

    タスクの結果

    デフォルトのアプリケーション構造を持つスコープ対象のアプリケーションは、ローカルで使用できます。 アプリケーション構造の詳細については、「ソースコードでアプリケーションをビルドする」トピックの「アプリケーションの構造」セクションを参照してください。

    アプリケーションが正常にインストールされると、インスタンスで使用できるようになります。アプリケーションのインストールの詳細については、「 でのアプリケーションのとインストールの展開ServiceNow SDK」を参照してください。

    次のタスク

    Visual Studio Codeで、ServiceNow Fluent を使用したソースコードでのアプリケーションの開発、カスタム JavaScript モジュールの作成、またはサードパーティライブラリの追加を開始します。 詳細については、「ServiceNow SDK を使用したアプリケーションの開発」を参照してください。