---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

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

# API を使用した手動サービスのアプリケーションサービスへの変換 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

JavaScript API を使用して既存の手動サービスをアプリケーションサービスに変換できます。イベント管理 では、アプリケーションサービスを使用してサービスパフォーマンスを監視し、健全性の問題を特定できます。
手動サービスはサポートされなくなり、このサービスタイプと検出サービスは、アプリケーションサービスに置き換えられました。既存の手動サービスはアプリケーションサービスに変換する必要があります。アプリケーションサービスに変換する前に、手動サービス (ビジネスルールやスケジュール済みジョブなど) の自動化がビルドおよびテストされていることを確認します。  
注:  
手動サービスは静的で、アプリケーションサービスへの変換後も元の構造を保持します。インポートされた手動サービスを既存の CMDB ステータスで更新するには、元の手動サービスを入力してすべての CI が正しいサービスに割り当てられていることを確認するか、変換後に CMDB の変更で更新するオプションを実行します。  
変換プロセス中：

* レコードクラスを変更することで、手動サービス \[cmdb_ci_service_manual\] テーブルからマッピング済みアプリケーションサービス \[cmdb_ci_service_discovered\] テーブルに手動サービスレコードが移動されます。
* 元の手動サービス属性 (名前、所有者、運用ステータスなど) はすべてアプリケーションサービスで保持されます。
* 手動サービスの構成アイテム (CI) は、変換後もアプリケーションサービスで保持されます。
* CI の最新の変更について CMDB へのクエリが実行され、CI 影響度ルールが適用されます。

{#convert-manual-to-application-service__ul_os3_3t3_tcb} この操作中にアプリケーションサービスに追加される CI 接続の最大数は、[sa.service_max_ci_service_population](https://www.servicenow.com/docs/access?context=components-installed-app-services&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) プロパティによって設定されます。デフォルト値は 1,000 (1,000 接続) です。CI 接続の数を増やすと、パフォーマンスの問題が発生するおそれがあります。追加される CI 接続の最大数を調整するには、「[システムプロパティを追加する](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=xanadu&pubname=xanadu-platform-administration&section=t_AddAPropertyUsingSysPropsList&ft:locale=en-US)」に記載されているように、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

{#convert-manual-to-application-service__ul_jqt_ftx_mdb} 上記の CI タイプが、変換する手動サービスで使用されている場合、変換は失敗します。このタイプの CI は、変換する前に削除する必要があります。変換後に新しい CI をアプリケーションサービスに追加することで置き換えることができます。

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

JavaScript API は次のとおりです。  

    BusinessServiceManager.migrateManualToApplicationService(String service_id)

{#convert-manual-to-application-service__table_dml_r31_4t__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| service_id | 文字列 | 変換する手動サービスの sys_id |
[表 : 1. パラメーター]

{#convert-manual-to-application-service__table_dml_r31_4t} {#convert-manual-to-application-service__table_eml_r31_4t__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 変換に成功した場合は `true`、変換に失敗した場合は `false` |
[表 : 2. 返される内容]

{#convert-manual-to-application-service__table_eml_r31_4t}  
既存の手動サービスの `sys_id` が <kbd class="ph userinput">451047c6c0a8016400de0ae6df9b9d76</kbd> である場合は、次の API を実行してアプリケーションサービスに変換します。

    var bsManager = new SNC.BusinessServiceManager();
    var res = bsManager.migrateManualToApplicationService("451047c6c0a8016400de0ae6df9b9d76");

**関連情報**   

* BusinessServiceManager - グローバル