SDK を使用してアプリケーションを作成または変換するServiceNow

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分
  • スコープ対象のアプリケーションを作成するか、既存のアプリケーションを変換して、アプリケーションで JavaScript モジュールとサードパーティライブラリを使用します。

    始める前に

    ServiceNowノード パッケージ マネージャー (npm) を使用して SDK をインストールします。詳細については、「ServiceNow SDK をインストールする」を参照してください。

    必要なロール:admin

    このタスクについて

    この手順では、 ServiceNow SDK コマンド・ライン・インターフェース (CLI) を使用します。コマンドと使用可能なパラメータの詳細については、を参照してください ServiceNow SDK CLI

    手順

    1. アプリケーションを追加するディレクトリーから、システム上でコマンド行ツールを開きます。
    2. ServiceNow SDK を起動します。
      now-sdk
      SDK は、使用可能なコマンドに関する情報を返します。
      ヒント:
      コマンドに関する追加情報を取得するには、コマンドと - -help または -h パラメーターを入力します。たとえば、 now-sdk auth --help などです。
    3. 非本番 ServiceNow インスタンスに対する認証。
      インスタンスはリリースである必要があります Washington DC
      1. auth コマンドでエイリアスを使用して、システムのデバイスキーチェーンまたは資格情報マネージャーにユーザー資格情報を保存します。
        now-sdk auth save [<alias>] [--host <instance url>] [--username <admin username>]

        このエイリアスをデフォルトのエイリアスとして設定するには、 --default または -d パラメーターをコマンドに追加します。

        例を次に示します。
        now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default
      2. プロンプトで、パスワードを入力します。
    4. スコープ対象のアプリケーションを作成するか、既存のアプリケーションを SDK で使用するように変換します。
      オプションステップ
      スコープ対象のアプリケーションの作成
      1. createコマンドを使用して、一連のガイダンスに従ってアプリケーションを作成します。
        now-sdk create <projectName> <scopeName> --interactive
        例を次に示します。
        now-sdk create example-app x_snc_example --interactive
        注:
        プロジェクト名は、NPM パッケージの命名規則に準拠している必要があります。スコープ名は x_&lt;prefix> で始まり、18 文字以下にする必要があります。詳細については、「名前空間識別子」を参照してください。
      2. 次のプロンプトに応答します。
        • sys_appに関連付けられた説明: &lt;description>
        • インスタンスでアプリケーションを構築して登録しますか?[はい/いいえ]
        • アプリケーションにサンプルテーブルを追加しますか?[はい/いいえ]
      既存のアプリケーションの変換 convert コマンドを使用して、インスタンスから既存のスコープ対象のアプリケーションを変換します。
      now-sdk convert <scopeName> <packageName>
      例を次に示します。
      now-sdk convert sn_example_app example-app
      注:
      グローバルアプリケーションを変換するには、 scopeName パラメーターにアプリケーション名を使用し、- -scopeId パラメーターにアプリケーションsys_IDを使用します。

    タスクの結果

    基本的なアプリケーション構造を持つスコープ対象のアプリケーションをローカルで使用できます。アプリケーションがビルドされ、インスタンスにデプロイされている場合、CLI はアプリケーションへの URL を返します (例: https://myinstance.service-now.com/sys_app.do?sys_id=&lt;sysID>)。

    作成時にインスタンスでアプリケーションをビルドおよび登録しないことを選択した場合、その時点までアプリケーションはインスタンスに展開されません。詳細については、「SDK を使用した ServiceNow アプリケーションのビルドとデプロイ」を参照してください。

    次のタスク

    アプリケーションで JavaScript モジュールまたはサードパーティライブラリを作成して使用します。詳細については、「アプリケーションでの JavaScript モジュールの作成と使用」と「アプリケーションでのサードパーティライブラリの使用」を参照。