---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# BusinessServiceManager -- Global

# BusinessServiceManager -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Die BusinessServiceManager Die API bietet Methoden, die das Servicemanagement vereinheitlichen, indem manuell erstellte Services in Anwendungsservices konvertiert, Anwendungsservices ausgefüllt und Konfigurationselemente und -Verbindungen hinzugefügt/entfernt werden.

Verwenden BusinessServiceManager Methoden in globalen Serverskripts. Sie müssen über die Rolle „Anwendungsservice-Administrator" \[App_Service_admin\] verfügen, um diese API aufzurufen.

## BusinessServiceManager -- BusinessServiceManager() {#ariaid-title2}

Instanziiert ein BusinessServiceManager-Objekt.
{#BSM-BusinessServiceManager__table_djw_xl5_ndb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#BSM-BusinessServiceManager__table_djw_xl5_ndb}  

    var bsManager = new SNC.BusinessServiceManager();

## BusinessServiceManager -- addCI(Zeichenfolge Service_ID, Zeichenfolge Source_ID, Zeichenfolge target_ID) {#ariaid-title3}

Fügt einem manuell erstellten Anwendungsservice ein CI hinzu.
{#BSM-addCI_S_S_S__table_ihq_zl5_ndb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| service_id | Zeichenfolge | SYS_ID des Anwendungsservice, dem ein CI hinzugefügt werden soll. Muss vom Typ „cmdb_ci_service_discovered." sein |
| source_id | Zeichenfolge | SYS_ID des CI, dessen ausgehende Verbindung mit dem Ziel-CI verbunden ist. |
| Target_ID | Zeichenfolge | SYS_ID des CI, das dem Service hinzugefügt werden soll. Kann kein ausgeschlossenes Element sein. Ausgeschlossene Elemente sind CIs, die in der Tabelle „Manuelle CI-Einschlüsse/-Ausschlüsse" \[svc_manual_ci_exclusions_inclusions.list\] konfiguriert sind. |
[Tabelle : 2. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 3. Rückgaben]

{#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');

### Fügen Sie einen neuen Einstiegspunkt hinzu {#BSM-addCI_S_S_S__section_ckd_wqg_cvb}

Verwenden Sie AddCI() Methode zum Hinzufügen eines neuen Einstiegspunkts zu einem Service, indem Sie die folgenden Parameterwerte in Ihrer Anforderung angeben:

* Geben Sie die Service_ID als normal an.
* Lassen Sie den Wert „Source_ID" leer. Verwenden Sie beispielsweise `„" `.
* Geben Sie für target_ID die SYS-ID des CI ein, unter dem der neue Einstiegspunkt hinzugefügt werden soll.
{#BSM-addCI_S_S_S__ul_s3g_cqm_cvb}  
Daher wird AddCI() Methode erstellt einen neuen Einstiegspunkt mit einer Verbindung zum angegebenen Ziel-CI. Das folgende Beispiel zeigt, wie ein neuer Einstiegspunkt hinzugefügt wird:

    //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}

Fügt dem Anwendungsservice einen Einstiegspunkt hinzu und startet die Discovery am Einstiegspunkt.
{#BSM-addEntryPoint_S_O__table_clj_sw2_zwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| serviceId | Stich | SYS_ID des Anwendungsservice, dem die Verbindung hinzugefügt werden soll. |
| EndpunktGr | Zeichenfolge | Glide-Datensatzobjekt in der CI-Endpunkt-Tabelle \[cmdb_ci_Endpoint\] oder ihrer untergeordneten Tabelle, die dem Anwendungsservice hinzugefügt werden soll. |
[Tabelle : 4. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, dass der Einstiegspunkt dem Anwendungsservice erfolgreich hinzugefügt wurde. Mögliche Werte: * Wahr: Das Hinzufügen war erfolgreich. * Falsch: Das Hinzufügen war nicht erfolgreich. {#BSM-addEntryPoint_S_O__ul_f52_dg2_zwb} |
[Tabelle : 5. Rückgaben]

{#BSM-addEntryPoint_S_O__table_dlj_sw2_zwb}  
Die folgende Methode „addEntryPoint()" zeigt, wie dem Anwendungsservice ein neuer Einstiegspunkt hinzugefügt wird.

    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);

Ausgabe:

    true

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

Fügt einen neuen Einstiegspunkt hinzu, ohne die Discovery zu starten.
{#BSM-addEntryPtWoStartDiscovery_S_O__table_at2_252_zwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| serviceId | Zeichenfolge | SYS_ID des Anwendungsservice, dem die Verbindung hinzugefügt werden soll. |
| EndpunktGr | Zeichenfolge | Glide-Datensatzobjekt in der CI-Endpunkt-Tabelle \[cmdb_ci_Endpoint\] oder ihrer untergeordneten Tabelle, die dem Anwendungsservice hinzugefügt werden soll. |
[Tabelle : 6. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, dass der Einstiegspunkt dem Anwendungsservice erfolgreich hinzugefügt wurde. Mögliche Werte: * Wahr: Das Hinzufügen war erfolgreich. * Falsch: Das Hinzufügen war nicht erfolgreich. {#BSM-addEntryPtWoStartDiscovery_S_O__ul_f52_dg2_zwb} |
[Tabelle : 7. Rückgaben]

{#BSM-addEntryPtWoStartDiscovery_S_O__table_bt2_252_zwb}  
Das folgende Beispiel zeigt, wie Sie die Methode addEntryPointWithoutStartDiscovery() verwenden, um dem Anwendungsservice einen neuen Einstiegspunkt hinzuzufügen, ohne die Discovery zu initiieren.

    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);

Ausgabe:

    true

## BusinessServiceManager -- addManualConnection(Zeichenfolge Source_ID, Objekt Manual_Endpoint, Zeichenfolge Service_ID) {#ariaid-title6}

Fügt einem Anwendungsservice eine manuell erstellte Verbindung hinzu.
{#BSM-addManualConnection_S_O_S__table_fkl_1bb_sdb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| source_id | Zeichenfolge | SYS-ID des CI, das der Verbindung hinzugefügt werden soll. |
| Manual_Endpoint | Objekt | GlideRecord-Objekt in der cmdb_ci_endpoint_manual-Tabelle, das dem Anwendungsservice hinzugefügt werden soll. |
| service_id | Zeichenfolge | SYS-ID des Anwendungsservice, dem die Verbindung hinzugefügt werden soll. |
[Tabelle : 8. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 9. Rückgaben]

{#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(Object gr, Zeichenfolge userSysID) {#ariaid-title7}

Überprüft die Rollen eines angegebenen Anwenders und die Berechtigungsdaten, die für einen angegebenen Service/eine angegebene Servicegruppe konfiguriert sind, und gibt einen booleschen Wert zurück, der angibt, ob der Anwender den Service/die Servicegruppe anzeigen kann.
Folgendes definiert den Prozess-Flow, mit dem die Methode bestimmt, ob der Anwender den Service/die Servicegruppe anzeigen kann:  
1. Wenn der angegebene Datensatz eine Servicegruppe ist, werden die Anwenderrollen und die Gruppenrichtlinie überprüft. Weitere Informationen zu zugewiesenen Rollen für Servicegruppen finden Sie unter [Assign a role to a service group](https://www.servicenow.com/docs/access?context=t_EMAssignRoleSvcGroup&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US).
2. Wenn die Rollenliste „itil", aber nicht „App_Service_admin" und „sam_Core_user" enthält, geben Sie „wahr" zurück.
3. Wenn die Rollenliste „Wartung" enthält, geben Sie „wahr" zurück.
4. Wenn die Rollenliste „App_serivce_user" enthält, jedoch nicht „App_Service_admin" und „sm_App_owner" enthält und der Service nicht funktionsfähig ist, geben Sie „falsch" zurück.
5. Überprüfen Sie die Gruppe des Service.
   1. Wenn der Service zu einer einzelnen Gruppe gehört und die Gruppe „alle" ist, geben Sie „wahr" zurück.
   2. Überprüft die Richtlinie für alle Gruppen, die nicht „alle" sind, auf Anwenderrollen und -Gruppen basierend auf den in angegebenen Regeln [Assign a role to a service group](https://www.servicenow.com/docs/access?context=t_EMAssignRoleSvcGroup&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US). Wenn einer von ihnen „wahr" zurückgibt, wird „wahr" zurückgegeben.
   {#BSM-isReadingPermitted_O_S__ol_wrc_tjy_dzb}
{#BSM-isReadingPermitted_O_S__table_snj_253_kyb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| gr | GlideRecord | GlideRecord des Service/der Servicegruppe. Dieser GlideRecord kann aus einer der folgenden Tabellen stammen: * Serviceinstanz \[cmdb_ci_service_auto\] * Anwendungsservicegruppe \[cmdb_ci_service_group\] * Dynamische CI-Gruppe \[cmdb_ci_query_based_service\] * Manuelle Services \[cmdb_ci_service_manual\] * Zugeordneter Anwendungsservice \[cmdb_ci_service_discovered\] * Service \[cmdb_ci_service\] |
| userSysId | Zeichenfolge | SYS_ID des Anwenderdatensatzes. Tabelle: Anwender \[sys_user\] |
[Tabelle : 10. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Anwender die Berechtigung zum Anzeigen des angegebenen Service/der angegebenen Servicegruppe hat. Mögliche Werte: * Wahr: Der Anwender kann den angegebenen Service/die angegebene Servicegruppe anzeigen. * Falsch: Anwender kann den angegebenen Service/die angegebene Servicegruppe nicht anzeigen. |
[Tabelle : 11. Rückgaben]

{#BSM-isReadingPermitted_O_S__table_tnj_253_kyb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um zu überprüfen, ob der angegebene Anwender auf die angegebene Servicegruppe zugreifen kann.

    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(Zeichenfolge Service_ID) {#ariaid-title8}

Konvertiert einen manuellen Service in einen Anwendungsservice.
{#BSM-migrateManualToITService_S__table_xjk_w41_sdb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| service_id | Zeichenfolge | SYS-ID des manuellen Service, der konvertiert werden soll. |
[Tabelle : 12. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn die Migration zu einem Anwendungsservice erfolgreich ist. |
[Tabelle : 13. Rückgaben]

{#BSM-migrateManualToITService_S__table_yjk_w41_sdb}  

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

## BusinessServiceManager -- populateApplicationService(Zeichenfolge Service_ID, Zahlenebenen, Zeichenfolge black_listed_relation_types) {#ariaid-title9}

Füllt einen Anwendungsservice mit Beziehungen und CIs vom angegebenen Einstiegspunkt aus.
{#BSM-populateDiscoveredService_S_N_S__table_crl_yx1_sdb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| service_id | Zeichenfolge | SYS-ID des auszufüllenden Anwendungsservice. |
| Ebenen | Nummer | Anzahl der CIs-Ebenen, die aus der CMDB hinzugefügt werden sollen. |
| black_listed_relation_types | Zeichenfolge | Beziehungstypen, die beim Ausfüllen des Anwendungsservice ausgeschlossen werden sollen. |
[Tabelle : 14. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Vorgang erfolgreich ist. |
[Tabelle : 15. Rückgaben]

{#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 (Zeichenfolge Service_ID, Zeichenfolge target_ID) {#ariaid-title10}

Entfernt ein manuell erstelltes CI aus einem Anwendungsservice.
{#BSM-removeManualCi_O_O__table_bcz_py1_sdb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| service_id | Zeichenfolge | SYS-ID des Anwendungsservice, aus dem ein CI entfernt werden soll. Hinweis: Das Übergeben eines GlideRecord-Objekts wird ebenfalls unterstützt. |
| Target_ID | Zeichenfolge | SYS-ID des CI, das aus dem Anwendungsservice entfernt werden soll. Hinweis: Das Übergeben eines GlideRecord-Objekts wird ebenfalls unterstützt. |
[Tabelle : 16. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 17. Rückgaben]

{#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}

Entfernt einen vorhandenen Einstiegspunkt aus dem Anwendungsservice.
{#BSM-removeEntryPoint_S_S__table_xj2_n32_zwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| serviceId | Zeichenfolge | SYS_ID des Anwendungsservice, dem die Verbindung hinzugefügt werden soll. |
| Endpunkt-SysId | Zeichenfolge | SYS_ID des zu entfernenden Einstiegspunktendpunkts. |
[Tabelle : 18. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, dass der Einstiegspunkt erfolgreich aus dem Anwendungsservice entfernt wurde. Mögliche Werte: * Wahr: Die Aktualisierung war erfolgreich. * Falsch: Das Update war nicht erfolgreich. |
[Tabelle : 19. Rückgaben]

{#BSM-removeEntryPoint_S_S__table_yj2_n32_zwb}  
Das folgende Beispiel entfernt den Einstiegspunkt, der der SYS_ID „aa65ebeedb91300964f6fa6629895ss" zugeordnet ist, aus dem angegebenen Anwendungsservice.

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

Ausgabe:

    true

## BusinessServiceManager -- removeManualConnection(Zeichenfolge Source_ID, Zeichenfolge Endpunkt_ID, Zeichenfolge Service_ID) {#ariaid-title12}

Entfernt eine manuell erstellte Verbindung und das verbundene CI aus einem Anwendungsservice.
{#BSM-removeManualConnection_S_S_S__table_spm_sbb_sdb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| source_id | Zeichenfolge | SYS-ID des CI, das mit dem Endpunkt verbunden ist. |
| Endpunkt_ID | Zeichenfolge | SYS-ID der manuell erstellten Verbindung, die aus dem Anwendungsservice entfernt werden soll |
| service_id | Zeichenfolge | SYS-ID des Anwendungsservice, von dem die Verbindung entfernt werden soll. |
[Tabelle : 20. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 21. Rückgaben]

{#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}

Aktualisiert einen vorhandenen Einstiegspunkt im Anwendungsservice.
{#BSM-updateEntryPoint_S_O__table_oht_422_zwb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| serviceId | Zeichenfolge | SYS_ID des Anwendungsservice, dem die Verbindung hinzugefügt werden soll. |
| EndpunktGr | Objekt | Glide-Datensatzobjekt in der CI-Endpunkt-Tabelle \[cmdb_ci_Endpoint\] oder ihrer untergeordneten Tabelle, die dem Anwendungsservice hinzugefügt werden soll. |
[Tabelle : 22. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, dass das Update erfolgreich auf den Einstiegspunkt angewendet wurde. Mögliche Werte: * Wahr: Die Aktualisierung war erfolgreich. * Falsch: Das Update war nicht erfolgreich. {#BSM-updateEntryPoint_S_O__ul_f52_dg2_zwb} |
[Tabelle : 23. Rückgaben]

{#BSM-updateEntryPoint_S_O__table_pht_422_zwb}  
Das folgende Beispiel „updateEntryPoint()" zeigt, wie die Verbindung mit einem neuen Einstiegspunkt aktualisiert wird.

    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);

Ausgabe:

    true


