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

アプリケーション作成して、そのServiceNow SDKを使用してソースコードで開発します。

始める前に

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

必要なロール：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. 次の一連のプロンプトに応答します。

   プロンプト	応答
   テンプレートの選択	UI 開発をサポートするフルスタックアプリケーションを作成するかどうかや、JavaScript または TypeScript を使用してモジュールを作成するかどうかなどデフォルトのアプリケーション構造を決定するテンプレートを選択します。
   ServiceNow アプリケーションの名前	アプリケーションの名前を入力します。
   NPM パッケージ名	package.jsonファイルで使用されるアプリケーションパッケージの名前を入力します。 パッケージ名は、ノードパッケージマネージャー (npm) のパッケージ命名基準に準拠している必要があります。
   グローバル/スコープ対象のアプリを作成しますか？	スコープ対象のアプリケーションを作成するかグローバルアプリケーションを作成するかを選択します。 スコープ対象:アプリケーションファイルとデータへのアクセスを識別して制限することによって保護される、スコープ対象のアプリケーションを作成します。 グローバル:グローバルスコープでアプリケーションを作成し、他のグローバルアプリケーションからアクセスできるようにします。グローバルアプリケーションは、 Australia リリース以降のインスタンスでのみサポートされています。
   スコープ名	スコープ対象のアプリケーションの場合は、アプリケーションのスコープ指定します。 スコープ名はインスタンス上で一意で、x_<prefix> で始まり、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>

タスクの結果

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

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

次のタスク

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