API を使用した手動サービスのアプリケーションサービスへの変換

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：3分

    • JavaScript API を使用して既存の手動サービスをアプリケーションサービスに変換できます。イベント管理 では、アプリケーションサービスを使用してサービスパフォーマンスを監視し、健全性の問題を特定できます。

    手動サービスはサポートされなくなり、このサービスタイプと検出サービスは、アプリケーションサービスに置き換えられました。既存の手動サービスはアプリケーションサービスに変換する必要があります。アプリケーションサービスに変換する前に、手動サービス (ビジネスルールやスケジュール済みジョブなど) の自動化がビルドおよびテストされていることを確認します。
    注:
    手動サービスは静的で、アプリケーションサービスへの変換後も元の構造を保持します。インポートされた手動サービスを既存の CMDB ステータスで更新するには、元の手動サービスを入力してすべての CI が正しいサービスに割り当てられていることを確認するか、変換後に CMDB の変更で更新するオプションを実行します。
    変換プロセス中：
    • レコードクラスを変更することで、手動サービス [cmdb_ci_service_manual] テーブルからマッピング済みアプリケーションサービス [cmdb_ci_service_discovered] テーブルに手動サービスレコードが移動されます。
    • 元の手動サービス属性 (名前、所有者、運用ステータスなど) はすべてアプリケーションサービスで保持されます。
    • 手動サービスの構成アイテム (CI) は、変換後もアプリケーションサービスで保持されます。
    • CI の最新の変更について CMDB へのクエリが実行され、CI 影響度ルールが適用されます。
    この操作中にアプリケーションサービスに追加される CI 接続の最大数は、sa.service_max_ci_service_population プロパティによって設定されます。デフォルト値は 1,000 (1,000 接続) です。CI 接続の数を増やすと、パフォーマンスの問題が発生するおそれがあります。追加される CI 接続の最大数を調整するには、「システムプロパティを追加する」に記載されているように、sa.service_max_ci_service_population プロパティを追加します。

    sa.service_max_ci_service_population プロパティで指定された値よりも多くの CI を処理しようとすると、操作が失敗します。

    一度に 10 個程度の小さなチャンクで変換プロセスを実行して、変換の問題が発生した場合に問題のあるサービスを特定しやすくします。

    アプリケーションサービスは次の CI タイプをサポートしていません。
    • cmdb_ci_endpoint
    • cmdb_ci_translation_rule
    • cmdb_ci_config_file
    • cmdb_ci_qualifier
    • cmdb_ci_application_cluster
    上記の CI タイプが、変換する手動サービスで使用されている場合、変換は失敗します。このタイプの CI は、変換する前に削除する必要があります。変換後に新しい CI をアプリケーションサービスに追加することで置き換えることができます。

    ServiceNow インスタンスでドメインセパレーションを使用している場合、複数のドメインの CI が同じサービス内にある場合、変換は失敗します。変換前に関連 CI を置換または削除します。変換されたアプリケーションサービスには、そのアプリケーションサービスと同じドメインに割り当てられた CI のみが含まれます。

    JavaScript API は次のとおりです。

    BusinessServiceManager.migrateManualToApplicationService(String service_id)
    表 : 1. パラメーター
    名前 タイプ 説明
    service_id 文字列 変換する手動サービスの sys_id
    表 : 2. 返される内容
    タイプ 説明
    ブーリアン 変換に成功した場合は true、変換に失敗した場合は false
    既存の手動サービスの sys_id が 451047c6c0a8016400de0ae6df9b9d76 である場合は、次の API を実行してアプリケーションサービスに変換します。
    var bsManager = new SNC.BusinessServiceManager();
var res = bsManager.migrateManualToApplicationService("451047c6c0a8016400de0ae6df9b9d76");