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


---

# DevOpsOrchestrationToolIntegrationHandler -- Umfang

# DevOpsOrchestrationToolIntegrationHandler -- Umfang {#ariaid-title1}

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

Die DevOpsOrchestrationToolIntegrationHandler API aktiviert die Verarbeitung von Nutzlasten aus anwenderdefinierten DevOpsTools.

Ein anwenderdefinierter DevOpsDas Tool ist ein Tool, das keine Integration mit aufweist DevOps. Für eine Liste der Tools, die haben DevOpsIntegrationen, siehe [DevOps Change Velocity integrations](https://www.servicenow.com/docs/access?context=dev-ops-overview&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

Diese API ermöglicht die Verarbeitung von Nutzlasten, die vom REST-Endpunkt verwendet werden [DevOps -- POST /devops/Tool/{Capability}](https://servicenow-prod.fluidtopics.net/MPCSWbMDktox49rfXzTdAw#devops-POST-tool "Postet die übergebene Nutzlast in die Tabelle „eingehendes Ereignis“ [sn_devops_inbound] zur Verarbeitung durch einen anwenderdefinierten DevOpssubflow."). Sie müssen die Methoden dieser API in einer Skripteinbindung implementieren, bevor Sie aufrufen /devops/Tool/{Capability} VERÖFFENTLICHEN Endpunkt.

Diese API wird in ausgeführt `sn_devops `Namespace. Weitere Informationen zu DevOps finden Sie unter [DevOps Config](https://www.servicenow.com/docs/access?context=devops-config-landing-page&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

## DevOpsOrchestrationToolIntegrationHandler -- getNativeIdForOrchestrationTask (Objektnutzlast) {#ariaid-title2}

Gibt den Wert von zurück orchestrationTaskNameParameter aus der Nutzlast für /devops/Tool/{Capability} VERÖFFENTLICHEN Endpunkt.
Sie müssen diese Methode in einer Skripteinbindung implementieren, bevor Sie den REST-Endpunkt aufrufen [DevOps -- POST /devops/Tool/{Capability}](https://servicenow-prod.fluidtopics.net/MPCSWbMDktox49rfXzTdAw#devops-POST-tool "Postet die übergebene Nutzlast in die Tabelle „eingehendes Ereignis“ [sn_devops_inbound] zur Verarbeitung durch einen anwenderdefinierten DevOpssubflow.").
{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nutzlast | Objekt | Nutzlast, die Daten aus dem anwenderdefinierten Tool enthält, die vom REST-Endpunkt akzeptiert werden /devops/Tool/{Capability} VERÖFFENTLICHEN , Wo capabilityIst <kbd class="ph userinput">Orchestration </kbd>. |
[Tabelle : 1. Parameter]

{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb} {#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert von orchestrationTaskNameParameter aus der Nutzlast. |
[Tabelle : 2. Rückgaben]

{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb}  
In diesem Beispiel eine Skripteinbindung mit dem Namen <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler </kbd>Implementiert die Methoden HandleTool Und GetNativeIdForOrchestrationTask . Die GetNativeIdForOrchestrationTask Die Methode ist implementiert, um den Wert von zurückzugeben orchestrationTaskNameParameter aus der Nutzlast für POST /devops/Tool/{Capability}.

    var DevOpsOrchestrationCustomToolIntegrationHandler = Class.create(); 

    DevOpsOrchestrationCustomToolIntegrationHandler.prototype = {     

        handleTool: function(toolName) { 
            if (!gs.nil(toolName) && toolName == 'sn_devops_custom_tool') 
                return true; 
            return false; 
        }, 

        getNativeIdForOrchestrationTask: function(payload) { 
            return payload.orchestrationTaskName; 
        }, 

        type: 'DevOpsOrchestrationCustomToolIntegrationHandler' 

    }; 

## DevOpsOrchestrationToolIntegrationHandler -- handleTool(Zeichenfolge toolName) {#ariaid-title3}

Überprüft, ob dieser Handler für das angegebene Tool gültig ist.
Sie müssen diese Methode vor dem Aufrufen in einer Skripteinbindung implementieren [DevOps -- POST /devops/Tool/{Capability}](https://servicenow-prod.fluidtopics.net/MPCSWbMDktox49rfXzTdAw#devops-POST-tool "Postet die übergebene Nutzlast in die Tabelle „eingehendes Ereignis“ [sn_devops_inbound] zur Verarbeitung durch einen anwenderdefinierten DevOpssubflow.").
{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| toolName | Zeichenfolge | Name des Tools. Tabelle: <var class="keyword varname">Toolname </var>Feld der Tabelle „DevOps-Toolintegration \[sn_devops_tool_integration\]" |
[Tabelle : 3. Parameter]

{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb} {#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob dieser Handler für das angegebene Tool gültig ist. Mögliche Werte: * Wahr: Dieser Handler kann für das angegebene Tool verwendet werden. * Falsch: Dieser Handler kann nicht für das angegebene Tool verwendet werden. {#DevOpsOrchToolIntH-handleTool_S__ul_ovl_gb4_ctb} |
[Tabelle : 4. Rückgaben]

{#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb}  
In diesem Beispiel eine Skripteinbindung mit dem Namen <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler </kbd>Implementiert die Methoden HandleTool Und GetNativeIdForOrchestrationTask . Die HandleTool Die Methode wird implementiert, um zu überprüfen, ob der übergebene Name für das richtige Tool gilt. Ersetzen `„sn_devops_custom_tool" `Mit dem Namen des Tools, das Sie verwenden.

    var DevOpsOrchestrationCustomToolIntegrationHandler = Class.create(); 

    DevOpsOrchestrationCustomToolIntegrationHandler.prototype = {     

      handleTool: function(toolName) { 
        if (!gs.nil(toolName) && toolName == 'sn_devops_custom_tool') 
          return true; 
        return false; 
      }, 

      getNativeIdForOrchestrationTask: function(payload) { 
        return payload.orchestrationTaskName; 
      }, 

      type: 'DevOpsOrchestrationCustomToolIntegrationHandler' 

    };


