---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference
Release :
- xanadu
ft:locale :
- de-DE
ft:publication_title :
- Xanadu-API-Referenz
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# DevOpsOrchestrationToolIntegrationHandler: Bereichsbezogen
# DevOpsOrchestrationToolIntegrationHandler: Bereichsbezogen {#ariaid-title1}
* Freigeben Version: Xanadu
*
* Aktualisiert 1. August 2024
*
*  1 Minute Lesedauer
Die DevOpsOrchestrationToolIntegrationHandler- API ermöglicht die Verarbeitung von Nutzlasten aus anwenderdefinierten DevOps -Tools.
Ein anwenderdefiniertes DevOps -Tool ist jedes Tool, das keine Integration mit DevOpshat. Eine Liste der Tools mit DevOps -Integrationen finden Sie unter [DevOps Change Velocity integrations](https://www.servicenow.com/docs/access?context=dev-ops-overview&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).
Diese API ermöglicht die Verarbeitung von Nutzlasten, die vom REST-Endpunkt [DevOps -- POST /devops/tool/{capability}](https://www.servicenow.com/docs/uM~_ridYg2~ktlFHLgWi1g#devops-POST-tool "Postet die übergebene Nutzlast zur Verarbeitung durch einen anwenderdefinierten Subflow DevOps ] in der Tabelle „Eingehendes Ereignis“ [sn_devops_inbound].")verwendet werden. Sie müssen die Methoden dieser API in einer Skripteinbindung implementieren, bevor Sie den Endpunkt POST /devops/tool/{capability} aufrufen.
Diese API wird im Namespace `sn_devops ausgeführt`. Weitere Informationen zu DevOps finden Sie unter [DevOps Config](https://www.servicenow.com/docs/access?context=devops-config-landing-page&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).
## DevOpsOrchestrationToolIntegrationHandler -- getNativeIdForOrchestrationTask(Object payload) {#ariaid-title2}
Gibt den Wert des Parameters orchestrationTaskName aus der Nutzlast für den Endpunkt POST /devops/tool/{capability} zurück.
Sie müssen diese Methode in einer Skripteinbindung implementieren, bevor Sie den REST-Endpunkt [DevOps - POST /devops/tool/{capability} aufrufen](https://www.servicenow.com/docs/uM~_ridYg2~ktlFHLgWi1g#devops-POST-tool "Postet die übergebene Nutzlast zur Verarbeitung durch einen anwenderdefinierten Subflow DevOps ] in der Tabelle „Eingehendes Ereignis“ [sn_devops_inbound].").
{#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 POST /devops/tool/{capability}akzeptiert wird, wobei capability für die Orchestrationsteht. |
[Tabelle : 1. Parameter]
{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb} {#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb__entry__2}
| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert des Parameters orchestrationTaskName aus der Nutzlast. |
[Tabelle : 2. Ergebnisse]
{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb}
In diesem Beispiel implementiert eine Skripteinbindung namens DevOpsOrchestrationCustomToolIntegrationHandler die Methoden handleTool und getNativeIdForOrchestrationTask. Die Methode „ getNativeIdForOrchestrationTask " ist implementiert, um den Wert des Parameters orchestrationTaskName aus der Nutzlast für POST /devops/tool/{capability} zurückzugeben.
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(StringtoolName) {#ariaid-title3}
Überprüft, ob dieser Handler für das angegebene Tool gültig ist.
Sie müssen diese Methode in einer Skripteinbindung implementieren, bevor Sie [DevOps - POST /devops/tool/{capability}](https://www.servicenow.com/docs/uM~_ridYg2~ktlFHLgWi1g#devops-POST-tool "Postet die übergebene Nutzlast zur Verarbeitung durch einen anwenderdefinierten Subflow DevOps ] in der Tabelle „Eingehendes Ereignis“ [sn_devops_inbound].")aufrufen.
{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb__entry__3}
| Name | Typ | Beschreibung |
|-|-|-|
| toolName | Zeichenfolge | Name des Tools. Befindet sich im Feld Toolname in der Tabelle „DevOps-Tool-Integration" \[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 für das angegebene Tool nicht verwendet werden. {#DevOpsOrchToolIntH-handleTool_S__ul_ovl_gb4_ctb} |
[Tabelle : 4. Ergebnisse]
{#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb}
In diesem Beispiel implementiert eine Skripteinbindung namens DevOpsOrchestrationCustomToolIntegrationHandler die Methoden handleTool und getNativeIdForOrchestrationTask. Die Methode „ handleTool " wird implementiert, um zu überprüfen, ob der übergebene Name für das richtige Tool gilt. Ersetzen Sie `„sn_devops_custom_tool"` durch den Namen des verwendeten Tools.
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'
};