API リリースノート

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：13分

    • ServiceNow® API を使用すると、カスタムアプリケーションとエクスペリエンスをビルドできます。Zurich リリースでは API の拡張と更新が行われています。

    Zurich リリースでの API の特長

    • スクリプトでサーバー側の JavaScript API を使用して、アプリケーションの機能を変更します。
    • フォームのロード時、フォームの送信時、フィールド値の変更時など、クライアントベースのイベントが発生するたびにクライアント API を実行します。
    • インバウンド REST API を使用して、アプリケーション内のさまざまな ServiceNow 機能とやり取りします。
    • クライアント ネクストエクスペリエンス API には、ネクストエクスペリエンス UI と互換性のあるクライアント API が含まれています。

    詳細については、「」を参照してください。

    Zurich リリースの新機能

    表 : 1. Zurich での新しいスコープ対象クラスと既存のスコープ対象クラスへの追加メソッド
    クラス メソッド
    • getCurrencyCode()
    • getNumericCurrencyCode()
    • getCurrencySymbol()
    • getSortedActiveCurrencySymbols()
    追加のユーザークエリ()
    • 追加属性()
    • 追加複数属性()
    • deleteAllAttributes()
    • deleteAttribute()
    • fetchAllAttributes()
    • fetchAttribute()
    • updateAllAttributes()
    • updateAttribute()
    フォームの上部に表示する追加のメッセージタイプのサポートが追加されました。
    • 追加HighMessage()
    • [Assigned to (アサイン先)]
    • 追加成功メッセージ()
    • [Submit (送信)] をクリックします。
    表 : 2. Zurich での新しいグローバルクラスと既存のグローバルクラスへの追加メソッド
    クラス メソッド
    追加のユーザークエリ()
    • 追加属性()
    • 追加複数属性()
    • deleteAllAttributes()
    • deleteAttribute()
    • fetchAllAttributes()
    • fetchAttribute()
    • updateAllAttributes()
    • updateAttribute()
    フォームの上部に表示する追加のメッセージタイプのサポートが追加されました。
    • 追加HighMessage()
    • [Assigned to (アサイン先)]
    • [Submit (送信)] をクリックします。
    • 追加成功メッセージ()
    メッセージ [sys_ui_message] テーブルからローカライズされたメッセージを取得します。ユーザーのセッション言語または指定された言語パラメーターに基づいてメッセージを動的にフェッチすることにより、インターナショナリゼーション (i18n) をサポートします。
    • getMessage()
    • getMessageLang()
    表 : 3. での新しいクライアントクラスと既存のクライアントクラスへの追加メソッド Zurich
    クラス メソッド
    • addChoice()
    • 追加HighMessage()
    • [Assigned to (アサイン先)]
    • [Submit (送信)] をクリックします。
    • 追加成功メッセージ()
    • clearChoices()
    • disableChoice()
    • enableChoice()
    • getAnnotationByName()
    • getAnnotations()
    • getChoice()
    • getOptions()
    • hideAnnotation()
    • hideRelatedLinks()
    • hideTemplateBar()
    • Choice を削除
    • setChoiceLabel()
    • setRelatedLinksDisplay()
    • showAnnotation()
    • showRelatedLinks()
    • showTemplateBar()
    • toggleAnnotations()
    • 破壊()
    • get()
    • [Assigned to] [Assigned to] [
    • getPreference()
    • getPreferences()
    • renderWithContent(Object)
    • renderWithContent(文字列)
    • setDialog()
    • setPreference()
    • setTitle()
    • タイプ()
    リフレッシュナビゲーター()
    • ストップウォッチ()
    • getTime()
    • 再起動()
    • toString()
    • addChoice()
    • 追加HighMessage()
    • [Assigned to (アサイン先)]
    • [Submit (送信)] をクリックします。
    • 追加成功メッセージ()
    • clearChoices()
    • disableChoice()
    • enableChoice()
    • getAnnotationByName()
    • getAnnotations()
    • getChoice()
    • getOptions()
    • hideAnnotation()
    • Choice を削除
    • setChoiceLabel()
    • showAnnotation()
    • toggleAnnotations()
    getRoles()
    表 : 4. での新しい REST API と既存の REST API への追加エンドポイント Zurich
    API エンドポイント
    • PUT now/conversation/member/{user_id}/drop
    • PUT now/conversation/member/{user_id}/update
    • POST /api/sn_omni_callback/callback/attempt
    • POST /api/sn_omni_callback/callback/create
    • PATCH /api/sn_omni_callback/callback/update
    表 : 5. の新しい REST API と既存の REST API への追加エンドポイント ServiceNow Store
    アプリケーション アプリケーションバージョン API エンドポイント
    高度なネットワークインベントリ 10.0 POST /api/sn_ni_adv/dcim/feed/{vendorname}
    見積管理 6.0.1
    • DELETE /sn_tmf_api/quote_management_api/quote/{id}
    • 取得 /sn_tmf_api/quote_management_api/見積もり
    • 取得 /sn_tmf_api/quote_management_api/quote/{id}
    • パッチ /sn_tmf_api/quote_management_api/quote/{id}
    • 投稿/sn_tmf_api/quote_management_api/見積もり
    電気通信オープン API 4.1.1
    • キャンセル /sn_tmf_api/work_order_management_api/cancelWorkOrder
    • GET /sn_tmf_api/work_order_management_api/workordermanagement
    • 取得 /sn_tmf_api/work_order_management_api/workorder/{id}
    • PATCH /sn_tmf_api/work_order_management_api/workOrder/{id}
    • POST /sn_tmf_api/work_order_management_api/workOrder

    このリリースでの変更

    表 : 6. Zurich で変更されたスコープ対象クラス
    クラス メソッド
    ソース添付ファイルレコードからの属性のコピーと添付ファイルのある属性の削除のサポート。
    • copy()
    • copy(targetFieldName)
    • copyAttachmentsByFieldNames()
    • deleteAllAttachment()
    • deleteAttachment()
    クラスで定義された IRE ルールを使用して CI を識別する前に、受信ペイロードの referenceItems プロパティを設定できます。
    • createOrUpdateCI()
    • createOrUpdateCIEnhanced()
    • identifyCIEnhanced()
    send() - 戻り値とエラー処理を追加しました。
    setHttpMethod() - method パラメータによる HEAD メソッド呼び出しのサポートを追加しました。
    表 : 7. Zurich で変更されたグローバルクラス
    クラス メソッド
    ソース添付ファイルレコードからの属性のコピーと添付ファイルのある属性の削除のサポート。
    • copy()
    • copy(targetFieldName)
    • copyAttachmentsByFieldNames()
    • deleteAllAttachment()
    • deleteAttachment()
    クラスで定義された IRE ルールを使用して CI を識別する前に、受信ペイロードの referenceItems プロパティを設定できます。
    • createOrUpdateCI()
    • createOrUpdateCIEnhanced()
    • identifyCIEnhanced()
    setHttpMethod() - method パラメータによる HEAD メソッド呼び出しのサポートを追加しました。
    表 : 8. で変更された REST API ServiceNow Store
    アプリケーション アプリケーションバージョン API エンドポイント
    Accounts Payable Invoice Processing v9.5.17 次のエンドポイントで添付ファイルがサポートされるようになりました。
    • POST sn_spend_intg/ap_invoice/json
    • POST sn_spend_intg/ap_invoice/xml
    電気通信オープン API v4.1.1 次のエンドポイントでは、 serviceOrderItem.service.serviceCharacteristic.valueType パラメーターを使用して複雑なサービス特性値タイプがサポートされるようになりました。
    • GET /sn_tmf_api/order/serviceOrder
    • 取得 /sn_tmf_api/order/serviceOrder/{id}
    • PATCH /sn_tmf_api/order/serviceOrder/{id}
    • POST /sn_tmf_api/order/serviceOrder
    電気通信オープン API v4.1.1 次の productSpecification エンドポイントは、 productSpecCharacteristic.valueType パラメーターを使用して複雑な製品仕様特性値タイプをサポートするように更新されています。
    • POST /sn_tmf_api/catalogmanagement/productSpecification
    • PATCH /sn_tmf_api/catalogmanagement/productSpecification/{id}
    • GET /sn_tmf_api/catalogmanagement/productSpecification/{id}
    • GET /sn_tmf_api/catalogmanagement/productSpecification
    電気通信オープン API v4.1.1 次のエンドポイントは、 productCharacteristic.valueType パラメーターを使用して複雑な製品特性値タイプをサポートするようになりました。
    • GET /sn_prd_invt/product
    • GET /sn_prd_invt/product/{id}
    • GET /sn_prd_invt/productinventory
    • GET /sn_prd_invt/productinventory/{inventoryId}
    • POST /sn_prd_invt/製品
    • POST /sn_prd_invt/productinventory
    電気通信オープン API v4.1.1 次のエンドポイントは、 productOrderItem.product.productCharacteristic.valueType パラメーターを使用して複雑な製品特性値タイプをサポートするようになりました。
    • GET /sn_ind_tmt_orm/order/productOrder
    • 取得 /sn_ind_tmt_orm/order/productOrder/{id}
    • 取得 /sn_ind_tmt_orm/productorder
    • 取得 /sn_ind_tmt_orm/productorder/{id}
    • PATCH /sn_ind_tmt_orm/order/productOrder/{id}
    • PATCH /sn_ind_tmt_orm/productOrder/{id}
    • POST /sn_ind_tmt_orm/order/productOrder
    • POST /sn_ind_tmt_orm/productOrder
    仮想エージェント API v4.0.0 action要求本文パラメーターの新しいオプションと対応する例。

    POST /sn_va_as_service/ボット/統合

    廃止

    • GlideEncrypter API は、更新された NIST 800-131A Rev 2 ガイドラインにより、Triple Data Encryption Standard (3DES) をサポートしなくなりました。
      • Zurich リリースにアップグレードする既存のインスタンスでは、GlideEncrypter API を使用できますが、キー管理フレームワークアルゴリズムを自動的に使用するように更新されています。この API を引き続き呼び出す方法の詳細については、 を参照してください。
      • Zurich リリース以降に作成されたすべての新しいインスタンスで、GlideEncrypter API はサポートされなくなりました。代わりに、すべての暗号化操作に対して Key Management Framework を直接使用します。
    • コアプラットフォームの動的スキーマから動的グループが削除されました。Zurich リリースより前に関連付けられた動的属性グループで定義された動的属性の場合、動的属性グループ用に設計された 2 つの方法が下位互換性のために引き続き機能します。

      これらのメソッドは、移行された属性と新しく作成された属性に対して null を返します。

      お客様は、現在の 動的属性 定義に移行して、将来の機能改善を利用することをお勧めします。移行の詳細については、Now Support ナレッジベースの 「Dynamic Schema Zurich Migration Guide (動的スキーマ チューリッヒ移行ガイド)」[KB2146133] の記事を参照してください。

    アクティベーション情報

    デフォルトでは、次の API が利用可能です。
    • 識別および調整
    • 識別エンジン
    • IdentificationEngineScriptableApi
    • GlideCurrencyCode
    • GlideCurrencySymbol
    • GlideForm(ネクストエクスペリエンス)
    • GlideModal (ネクストエクスペリエンス)
    • GlideNavigation (ネクストエクスペリエンス)
    • GlideRecord
    • GlideSysAttachment
    • GlideUser (ネクストエクスペリエンス)
    • ストップウォッチ (ネクストエクスペリエンス)
    次の API はプラグインのアクティブ化が必要です。
    • ProducerV2 には、ServiceNow Stream Connect Installer プラグイン (com.glide.hub.stream_connect.installer) が必要です。
    • 製品オーダーオープン API には、Order Management for Telecommunications (sn_ind_tmt_orm) プラグインが必要です。
    • サービスオーダーのオープン API には、Order Management for Telecommunications (sn_ind_tmt_orm) プラグインが必要です。