---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

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) 소요 시간: 15분

BusinessServiceManager API는 수동으로 만든 서비스를 애플리케이션 서비스로 변환하고, 애플리케이션 서비스를 채우고, 구성 항목 및 연결을 추가/제거하여 서비스 관리를 통합하는 메서드를 제공합니다.

전역 서버 스크립트에서 BusinessServiceManager 메서드를 사용합니다. 이 API를 호출하려면 애플리케이션 서비스 관리자 \[app_service_admin\] 역할이 있어야 합니다.

## BusinessServiceManager - 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(문자열 service_id, 문자열 source_id, 문자열 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입니다. |
| 엔드포인트Gr | 문자열 | 애플리케이션 서비스에 추가할 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: 추가에 성공했습니다. * 아니오: 추가에 실패했습니다. {#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입니다. |
| 엔드포인트Gr | 문자열 | 애플리케이션 서비스에 추가할 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: 추가에 성공했습니다. * 아니오: 추가에 실패했습니다. {#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(문자열 source_id, 객체 manual_endpoint, 문자열 service_id) {#ariaid-title6}

애플리케이션 서비스에 수동으로 생성된 연결을 추가합니다.
{#BSM-addManualConnection_S_O_S__table_fkl_1bb_sdb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| source_id | 문자열 | 연결에 추가할 CI의 시스템 ID입니다. |
| manual_endpoint | 객체 | 애플리케이션 서비스에 추가할 cmdb_ci_endpoint_manual 테이블의 GlideRecord 객체입니다. |
| service_id | 문자열 | 연결을 추가할 애플리케이션 서비스의 시스템 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 - isReadingAllowted(Object gr, string 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. 서비스가 단일 그룹에 속하고 그룹이 "모두"인 경우 예를 반환합니다.
   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: 사용자가 지정된 서비스/서비스 그룹을 볼 수 있습니다. * 아니오: 사용자가 지정된 서비스/서비스 그룹을 볼 수 없습니다. |
[표 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 | 문자열 | 변환할 수동 서비스의 시스템 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(문자열 service_id, 숫자 수준, 문자열 black_listed_relation_types) {#ariaid-title9}

지정된 엔트리포인트의 관계와 CI로 애플리케이션 서비스를 채웁니다.
{#BSM-populateDiscoveredService_S_N_S__table_crl_yx1_sdb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| service_id | 문자열 | 채울 애플리케이션 서비스의 시스템 ID입니다. |
| 수준 | 번호 | 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를 제거할 애플리케이션 서비스의 시스템 ID입니다. 주: GlideRecord 객체 전달도 지원됩니다. |
| target_id | 문자열 | 애플리케이션 서비스에서 제거할 CI의 시스템 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입니다. |
| 엔드포인트 시스템 ID | 문자열 | 제거할 엔트리포인트 엔드포인트의 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(문자열 source_id, 문자열 endpoint_id, 문자열 service_id) {#ariaid-title12}

수동으로 생성된 연결과 연결된 CI를 애플리케이션 서비스에서 제거합니다.
{#BSM-removeManualConnection_S_S_S__table_spm_sbb_sdb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| source_id | 문자열 | 엔드포인트에 연결된 CI의 시스템 ID입니다. |
| endpoint_id | 문자열 | 애플리케이션 서비스에서 제거할 수동 생성 연결의 시스템 ID |
| service_id | 문자열 | 연결을 제거할 애플리케이션 서비스의 시스템 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입니다. |
| 엔드포인트Gr | 객체 | 애플리케이션 서비스에 추가할 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