---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# BusinessServiceManager - グローバル

# BusinessServiceManager - グローバル {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：16分

BusinessServiceManager API は、手動で作成されたサービスをアプリケーションサービスに変換し、アプリケーションサービスを設定し、構成アイテムと接続を追加/削除することで、サービス管理を統合するメソッドを提供します。

グローバルサーバースクリプトで BusinessServiceManager メソッドを使用します。この API を呼び出すには、アプリケーションサービスアドミニストレーター \[app_service_admin\] ロールが必要です。

## ビジネスサービスマネージャー - BusinessServiceManager() {#ariaid-title2}

BusinessServiceManager オブジェクトをインスタンス化します。
{#BSM-BusinessServiceManager__table_djw_xl5_ndb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#BSM-BusinessServiceManager__table_djw_xl5_ndb}  

    var bsManager = new SNC.BusinessServiceManager();

## BusinessServiceManager:addCI(String service_id, String source_id, String target_id) {#ariaid-title3}

手動で作成したアプリケーションサービスに CI を追加します。
{#BSM-addCI_S_S_S__table_ihq_zl5_ndb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| service_id | 文字列 | CI を追加するアプリケーションサービスのSys_id。タイプは cmdb_ci_service_discovered である必要があります。 |
| source_id | 文字列 | 送信接続がターゲット CI に結合する CI の Sys_id。 |
| target_id | 文字列 | サービスに追加する CI のSys_id。除外アイテムにすることはできません。除外されるアイテムは、手動 CI 包含/除外 \[svc_manual_ci_exclusions_inclusions.list\] テーブルで構成された CI です。 |
[表 : 2. パラメーター]

{#BSM-addCI_S_S_S__table_ihq_zl5_ndb} {#BSM-addCI_S_S_S__table_jhq_zl5_ndb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

{#BSM-addCI_S_S_S__table_jhq_zl5_ndb}  

    //Application service is 'PeopleSoft Portals'
    //Source CI is windows server 'PS Apache01'
    //Target CI is 'SAP WEB01'

    var bsManager = new SNC.BusinessServiceManager();
    var appService = bsManager.addCI('2fce42d80a0a0bb4004af34d7e3984c8','3a27d4370a0a0bb4006316812bf45439', '3a6cadc1c0a8ce01001f1e5d0d7d68fa');

### 新しいエントリポイントを追加 {#BSM-addCI_S_S_S__section_ckd_wqg_cvb}

addCI() メソッドを使用して、要求に次のパラメーター値を指定して、サービスに新しいエントリーポイントを追加します。

* 通常どおりservice_IDを指定します。
* source_ID値は空のままにします。たとえば、 `''` を使用します。
* \[target_ID\] には、新しいエントリーポイントを追加する CI の Sys ID を入力します。
{#BSM-addCI_S_S_S__ul_s3g_cqm_cvb}  
その結果、 addCI() メソッドは、指定されたターゲット CI に接続する新しいエントリーポイントを作成します。新しいエントリーポイントを追加する方法の例を次に示します。

    //Application service sys_id is '49de2b3187cd9d50d5c8a6880cbb35ea' 
    //Source CI is passed as an empty string as '' 
    //Target CI sys id is '15ca5fb187129910d5c8a6880cbb3537'   

    var bsManager = new SNC.BusinessServiceManager(); 
    var appService = bsManager.addCI('49de2b3187cd9d50d5c8a6880cbb35ea','', '15ca5fb187129910d5c8a6880cbb3537');

## BusinessServiceManager:addEntryPoint(serviceId, endpointGr) {#ariaid-title4}

アプリケーションサービスにエントリーポイントを追加し、エントリーポイントでディスカバリーを開始します。
{#BSM-addEntryPoint_S_O__table_clj_sw2_zwb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| serviceId | 刺す | 接続を追加するアプリケーションサービスのSys_id。 |
| endpointGr | 文字列 | アプリケーションサービスに追加する CI エンドポイント \[cmdb_ci_endpoint\] テーブルまたはその子テーブルの Glide レコードオブジェクト。 |
[表 : 4. パラメーター]

{#BSM-addEntryPoint_S_O__table_clj_sw2_zwb} {#BSM-addEntryPoint_S_O__table_dlj_sw2_zwb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | エントリーポイントがアプリケーションサービスに正常に追加されたことを示すフラグ。 可能な値： * true:追加に成功しました。 * false:追加に失敗しました。 {#BSM-addEntryPoint_S_O__ul_f52_dg2_zwb} |
[表 : 5. 返される内容]

{#BSM-addEntryPoint_S_O__table_dlj_sw2_zwb}  
次の addEntryPoint() メソッドは、アプリケーションサービスに新しいエントリーポイントを追加する方法を示しています。

    var now_GR = new GlideRecord("cmdb_ci_endpoint_tcp");
    now_GR.initialize(); 
    now_GR.setValue("host", "10.196.39.251");
    now_GR.setValue("port", "8080");
    now_GR.insert();
    var bsManager = new SNC.BusinessServiceManager();
    var serviceId = "5bf65ebeedb91300964f6fa662989533";
    bsManager.addEntryPoint(serviceId,now_GR);

出力：

    true

## BusinessServiceManager - addEntryPointWithoutStartDiscovery(serviceId, endpointGr) {#ariaid-title5}

ディスカバリーを開始せずに新しいエントリーポイントを追加します。
{#BSM-addEntryPtWoStartDiscovery_S_O__table_at2_252_zwb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| serviceId | 文字列 | 接続を追加するアプリケーションサービスのSys_id。 |
| endpointGr | 文字列 | アプリケーションサービスに追加する CI エンドポイント \[cmdb_ci_endpoint\] テーブルまたはその子テーブルの Glide レコードオブジェクト。 |
[表 : 6. パラメーター]

{#BSM-addEntryPtWoStartDiscovery_S_O__table_at2_252_zwb} {#BSM-addEntryPtWoStartDiscovery_S_O__table_bt2_252_zwb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | エントリーポイントがアプリケーションサービスに正常に追加されたことを示すフラグ。 可能な値： * true:追加に成功しました。 * false:追加に失敗しました。 {#BSM-addEntryPtWoStartDiscovery_S_O__ul_f52_dg2_zwb} |
[表 : 7. 返される内容]

{#BSM-addEntryPtWoStartDiscovery_S_O__table_bt2_252_zwb}  
次の例は、addEntryPointWithoutStartDiscovery() メソッドを使用して、ディスカバリーを開始せずにアプリケーションサービスに新しいエントリーポイントを追加する方法を示しています。

    var now_GR = new GlideRecord("cmdb_ci_endpoint_tcp");
    now_GR.initialize(); 
    now_GR.setValue("host", "10.196.39.251");
    now_GR.setValue("port", "8080");
    now_GR.insert();
    var bsManager = new SNC.BusinessServiceManager();
    var serviceId = "5bf65ebeedb91300964f6fa662989533";
    bsManager.addEntryPointWithoutStartDiscovery(serviceId,now_GR);

出力：

    true

## BusinessServiceManager - addManualConnection(String source_id, Object manual_endpoint, String service_id) {#ariaid-title6}

手動で作成した接続をアプリケーションサービスに追加します。
{#BSM-addManualConnection_S_O_S__table_fkl_1bb_sdb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| source_id | 文字列 | 接続に追加する CI の Sys ID。 |
| manual_endpoint | オブジェクト | アプリケーションサービスに追加するcmdb_ci_endpoint_manualテーブルの GlideRecord オブジェクト。 |
| service_id | 文字列 | 接続を追加するアプリケーションサービスの Sys ID。 |
[表 : 8. パラメーター]

{#BSM-addManualConnection_S_O_S__table_fkl_1bb_sdb} {#BSM-addManualConnection_S_O_S__table_gkl_1bb_sdb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 9. 返される内容]

{#BSM-addManualConnection_S_O_S__table_gkl_1bb_sdb}  

    var now_GR = new GlideRecord("cmdb_ci_endpoint_manual");
    now_GR.initialize(); 
    now_GR.name='myEndpoint'; 
    now_GR.insert();

    var bsManager = new SNC.BusinessServiceManager();
    var appService = bsManager.addManualConnection("3a307c930a0a0bb400353965d0b8861f", now_GR, "2fce42d80a0a0bb4004af34d7e3984c8");

## BusinessServiceManager:isReadingPermitted(オブジェクト gr, 文字列 userSysID) {#ariaid-title7}

指定されたユーザーのロールと、指定されたサービス/サービスグループに設定された権限データを確認し、ユーザーがサービス/サービスグループを表示できるかどうかを示すブール値を返します。
ユーザーがサービス/サービスグループを表示できるかどうかを判断するためにメソッドが使用するプロセスフローを以下に定義します。  
1. 指定されたレコードがサービスグループの場合は、ユーザーロールとグループポリシーを確認します。サービスグループにアサインされたロールの詳細については、「 [Assign a role to a service group](https://www.servicenow.com/docs/access?context=t_EMAssignRoleSvcGroup&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)」を参照してください。
2. ロールリストに「itil」が含まれていても「app_service_admin」と「sam_core_user」が含まれていない場合は、true を返します。
3. ロールリストに「maint」が含まれている場合は、true を返します。
4. ロールリストに「app_serivce_user」が含まれていても「app_service_admin」と「sm_app_owner」が含まれておらず、サービスが運用されていない場合は、false を返します。
5. サービスのグループを確認します。
   1. サービスが単一のグループに属し、グループが「すべて」である場合は、true を返します。
   2. 「すべて」以外のグループについては、\[ [Assign a role to a service group](https://www.servicenow.com/docs/access?context=t_EMAssignRoleSvcGroup&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)\] で指定されたルールに基づいてユーザーロールとグループのポリシーをチェックします。いずれかが true を返す場合は、true を返します。
   {#BSM-isReadingPermitted_O_S__ol_wrc_tjy_dzb}
{#BSM-isReadingPermitted_O_S__table_snj_253_kyb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| gr | GlideRecord | サービス/サービスグループの GlideRecord。この GlideRecord は、次のいずれかのテーブルから取得できます。 * サービスインスタンス \[cmdb_ci_service_auto\] * アプリケーションサービスグループ \[cmdb_ci_service_group\] * ダイナミック CI グループ \[cmdb_ci_query_based_service\] * 手動サービス \[cmdb_ci_service_manual\] * マップ済みアプリケーションサービス \[cmdb_ci_service_discovered\] * サービス \[cmdb_ci_service\] |
| userSysId | 文字列 | ユーザーレコードの Sys_id。 テーブル： ユーザー \[sys_user\] |
[表 : 10. パラメーター]

{#BSM-isReadingPermitted_O_S__table_snj_253_kyb} {#BSM-isReadingPermitted_O_S__table_tnj_253_kyb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | ユーザーが指定されたサービス/サービスグループを表示する権限を持っているかどうかを示すフラグ。 可能な値： * true:ユーザーは指定されたサービス/サービスグループを表示できます。 * false:ユーザーは指定されたサービス/サービスグループを表示できません。 |
[表 : 11. 返される内容]

{#BSM-isReadingPermitted_O_S__table_tnj_253_kyb}  
次のコード例は、このメソッドを呼び出して、指定されたユーザーが指定されたサービスグループにアクセスできることを確認する方法を示しています。

    var cmdbServGr = new GlideRecord('cmdb_ci_service_discovered');
    cmdbServGr.addQuery('sys_id', "123123123123123123123123");
    cmdbServGr.query();
    var userId = gs.getUserID();

    var bsManager = new SNC.BusinessServiceManager();
    while (cmdbServGr.next()) {
      var answer = bsManager.isReadingPermitted(cmdbServGr, userId);

      //do something with / according to the answer

    }

## BusinessServiceManager - migrateManualToApplicationService(文字列 service_id) {#ariaid-title8}

手動サービスをアプリケーションサービスに変換します。
{#BSM-migrateManualToITService_S__table_xjk_w41_sdb__entry__3}

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

{#BSM-migrateManualToITService_S__table_xjk_w41_sdb} {#BSM-migrateManualToITService_S__table_yjk_w41_sdb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | アプリケーションサービスへの移行が成功した場合は True。 |
[表 : 13. 返される内容]

{#BSM-migrateManualToITService_S__table_yjk_w41_sdb}  

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

## BusinessServiceManager - populateApplicationService(String service_id, Number levels, String black_listed_relation_types) {#ariaid-title9}

指定されたエントリーポイントから関係と CI をアプリケーションサービスに入力します。
{#BSM-populateDiscoveredService_S_N_S__table_crl_yx1_sdb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| service_id | 文字列 | 入力するアプリケーションサービスの Sys ID。 |
| levels | 数値 | CMDB から追加する CI のレベル数。 |
| black_listed_relation_types | 文字列 | アプリケーションサービスの入力時に除外する関係タイプ。 |
[表 : 14. パラメーター]

{#BSM-populateDiscoveredService_S_N_S__table_crl_yx1_sdb} {#BSM-populateDiscoveredService_S_N_S__table_drl_yx1_sdb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 操作が成功した場合は True。 |
[表 : 15. 返される内容]

{#BSM-populateDiscoveredService_S_N_S__table_drl_yx1_sdb}  

    var bsManager = new SNC.BusinessServiceManager();
    var appService = bsManager.populateApplicationService("5bf65ebeedb91300964f6fa662989533", 10, "Depends on::Used by");

## BusinessServiceManager - removeCI(文字列 service_id, 文字列 target_id) {#ariaid-title10}

アプリケーションサービスから手動で作成された CI を削除します。
{#BSM-removeManualCi_O_O__table_bcz_py1_sdb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| service_id | 文字列 | CI を削除するアプリケーションサービスの Sys ID。 注: GlideRecord オブジェクトの受け渡しもサポートされています。 |
| target_id | 文字列 | アプリケーションサービスから削除する CI の Sys ID。 注: GlideRecord オブジェクトの受け渡しもサポートされています。 |
[表 : 16. パラメーター]

{#BSM-removeManualCi_O_O__table_bcz_py1_sdb} {#BSM-removeManualCi_O_O__table_ccz_py1_sdb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 17. 返される内容]

{#BSM-removeManualCi_O_O__table_ccz_py1_sdb}  

    var bsManager = new SNC.BusinessServiceManager();
    var appService = bsManager.removeCI("2fce42d80a0a0bb4004af34d7e3984c8", "3a290cc60a0a0bb400000bdb386af1cf");

## BusinessServiceManager:removeEntryPoint(serviceId, endpointSysId) {#ariaid-title11}

アプリケーションサービスから既存のエントリーポイントを削除します。
{#BSM-removeEntryPoint_S_S__table_xj2_n32_zwb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| serviceId | 文字列 | 接続を追加するアプリケーションサービスのSys_id。 |
| endpointSysId | 文字列 | 削除するエントリーポイントエンドポイントのSys_id。 |
[表 : 18. パラメーター]

{#BSM-removeEntryPoint_S_S__table_xj2_n32_zwb} {#BSM-removeEntryPoint_S_S__table_yj2_n32_zwb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | エントリーポイントがアプリケーションサービスから正常に削除されたことを示すフラグ。 可能な値： * true:更新に成功しました。 * false:更新は成功しませんでした。 |
[表 : 19. 返される内容]

{#BSM-removeEntryPoint_S_S__table_yj2_n32_zwb}  
次の例ではSys_id指定されたアプリケーションサービスから「aa65ebeedb91300964f6fa6629895ss」に関連付けられたエントリーポイントを削除します。

    var bsManager = new SNC.BusinessServiceManager();
    var serviceId = "5bf65ebeedb91300964f6fa662989533";
    var entrypointId = "aa65ebeedb91300964f6fa6629895ss";
    bsManager.removeEntryPoint(serviceId, entrypointId);

出力：

    true

## BusinessServiceManager - removeManualConnection(String source_id, String endpoint_id, String service_id) {#ariaid-title12}

アプリケーションサービスから手動で作成された接続と接続された CI を削除します。
{#BSM-removeManualConnection_S_S_S__table_spm_sbb_sdb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| source_id | 文字列 | エンドポイントに接続されている CI の Sys ID。 |
| endpoint_id | 文字列 | アプリケーションサービスから削除する手動で作成された接続の Sys ID |
| service_id | 文字列 | 接続の削除元のアプリケーションサービスの Sys ID。 |
[表 : 20. パラメーター]

{#BSM-removeManualConnection_S_S_S__table_spm_sbb_sdb} {#BSM-removeManualConnection_S_S_S__table_tpm_sbb_sdb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 21. 返される内容]

{#BSM-removeManualConnection_S_S_S__table_tpm_sbb_sdb}  

    var bsManager = new SNC.BusinessServiceManager();
    var appService = bsManager.removeManualConnection("3a307c930a0a0bb400353965d0b8861f", "60ce3176edb91300964f6fa6629895d1", "2fce42d80a0a0bb4004af34d7e3984c8");

## BusinessServiceManager - updateEntryPoint(serviceId, endpointGr) {#ariaid-title13}

アプリケーションサービスの既存のエントリーポイントを更新します。
{#BSM-updateEntryPoint_S_O__table_oht_422_zwb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| serviceId | 文字列 | 接続を追加するアプリケーションサービスのSys_id。 |
| endpointGr | オブジェクト | アプリケーションサービスに追加する CI エンドポイント \[cmdb_ci_endpoint\] テーブルまたはその子テーブルの Glide レコードオブジェクト。 |
[表 : 22. パラメーター]

{#BSM-updateEntryPoint_S_O__table_oht_422_zwb} {#BSM-updateEntryPoint_S_O__table_pht_422_zwb__entry__2}

| タイプ | 説明 |
|-|-|
| ブーリアン | 更新がエントリーポイントに正常に適用されたことを示すフラグ。 可能な値： * true:更新に成功しました。 * false:更新は成功しませんでした。 {#BSM-updateEntryPoint_S_O__ul_f52_dg2_zwb} |
[表 : 23. 返される内容]

{#BSM-updateEntryPoint_S_O__table_pht_422_zwb}  
次の updateEntryPoint() の例は、新しいエントリーポイントで接続を更新する方法を示しています。

    var now_GR = new GlideRecord("cmdb_ci_endpoint_http");
    now_GR.get("11f65ebeedb91300964f6fa66298951");
    now_GR.setValue("protocol", "https");
    var bsManager = new SNC.BusinessServiceManager();
    var serviceId = "5bf65ebeedb91300964f6fa662989533";
    bsManager.updateEntryPoint(serviceId,now_GR);

出力：

    true