---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DevOpsOrchestrationToolIntegrationHandler : inclus dans le champ d'application

# DevOpsOrchestrationToolIntegrationHandler : inclus dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'API DevOpsOrchestrationToolIntegrationHandler permet le traitement des charges utiles à partir d'outils personnalisés DevOps .

Un outil personnalisé DevOps est un outil qui n'a pas d'intégration avec DevOps. Pour obtenir la liste des outils dotés d'intégrations DevOps , reportez-vous à la section [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).

Cette API permet le traitement des charges utiles utilisées par le point de terminaison REST [DevOps : POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/9rUzpQvdymbgycDHCeINZw#devops-POST-tool "Publie la charge utile transmise dans la table Événement entrant [sn_devops_inbound] pour traitement par un flux secondaire personnalisé DevOps ."). Vous devez implémenter les méthodes de cette API dans un include de script avant d'appeler le point de terminaison POST /devops/tool/{capability} .

Cette API s'exécute dans l'espace de noms `sn_devops` . Pour plus d'informations sur DevOps, consultez [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(charge utile de l'objet) {#ariaid-title2}

Renvoie la valeur du paramètre à partir de la orchestrationTaskName charge utile pour le point de terminaison POST /devops/tool/{capability} .
Vous devez implémenter cette méthode dans un include de script avant d'appeler le point de terminaison [REST DevOps - POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/9rUzpQvdymbgycDHCeINZw#devops-POST-tool "Publie la charge utile transmise dans la table Événement entrant [sn_devops_inbound] pour traitement par un flux secondaire personnalisé DevOps .").
{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_mnx_hvm_ctb__entry__3}

| Nom | Type | Description |
|-|-|-|
| payload | Objet | Charge utile contenant les données de l'outil personnalisé acceptée par le point de terminaison REST POST /devops/tool/{capability}, où capability se trouve <kbd class="ph userinput">l’orchestration</kbd>. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Valeur du orchestrationTaskName paramètre de la charge utile. |
[Tableau 2. Renvoie]

{#DevOpsOrchToolIntH-getNIdOrchTask_O__table_nnx_hvm_ctb}  
Dans cet exemple, un include de script nommé <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler</kbd> implémente les méthodes handleTool et getNativeIdForOrchestrationTask. La méthode getNativeIdForOrchestrationTask est implémentée pour renvoyer la valeur du paramètre à partir de orchestrationTaskName la charge utile pour 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(String toolName) {#ariaid-title3}

Vérifie si ce gestionnaire est valide pour l'outil spécifié.
Vous devez implémenter cette méthode dans un include de script avant d'appeler [DevOps - POST /devops/tool/{capability}](https://servicenow-prod.fluidtopics.net/9rUzpQvdymbgycDHCeINZw#devops-POST-tool "Publie la charge utile transmise dans la table Événement entrant [sn_devops_inbound] pour traitement par un flux secondaire personnalisé DevOps .").
{#DevOpsOrchToolIntH-handleTool_S__table_gtf_1vm_ctb__entry__3}

| Nom | Type | Description |
|-|-|-|
| toolName | Chaîne | Nom de l'outil. Situé dans le champ Nom de l'outil de la table Intégration de l'outil DevOps \[sn_devops_tool_integration\]. |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si ce gestionnaire est valide pour l'outil spécifié. Valeurs possibles : * true : ce gestionnaire peut être utilisé pour l'outil spécifié. * false : ce gestionnaire ne peut pas être utilisé pour l'outil spécifié. {#DevOpsOrchToolIntH-handleTool_S__ul_ovl_gb4_ctb} |
[Tableau 4. Renvoie]

{#DevOpsOrchToolIntH-handleTool_S__table_htf_1vm_ctb}  
Dans cet exemple, un include de script nommé <kbd class="ph userinput">DevOpsOrchestrationCustomToolIntegrationHandler</kbd> implémente les méthodes handleTool et getNativeIdForOrchestrationTask. La méthode handleTool est implémentée pour vérifier que le nom transmis est destiné à l'outil correct. Remplacez `<< sn_devops_custom_tool >>` par le nom de l'outil que vous utilisez.

    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' 

    };