Azure DevOps

Le connecteur Azure DevOps vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur les données Azure DevOps.

Versions compatibles

Ce connecteur est compatible avec les versions suivantes d'Azure DevOps.

  • Azure DevOps 2022, 2020, 2019
  • Team Foundation Server 2018

Avant de commencer

Dans votre projet Google Cloud, effectuez les tâches suivantes :

  • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus sur les schémas de réseau, consultez Connectivité réseau.
  • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
  • Attribuez les rôles IAM roles/secretmanager.viewer et roles/secretmanager.secretAccessor au compte de service que vous souhaitez utiliser pour le connecteur.
  • Activez les services suivants :
    • secretmanager.googleapis.com (API Secret Manager)
    • connectors.googleapis.com (API Connectors)

    Pour comprendre comment activer des services, consultez Activer des services. Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer au moment de configurer le connecteur.

Configurer le connecteur

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + CRÉER pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

    2. Cliquez sur SUIVANT.
  4. Dans la section Détails de la connexion, procédez comme suit :
    1. Connecteur : sélectionnez Azure DevOps dans la liste déroulante des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
    3. Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Ils doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Ils ne peuvent pas dépasser 49 caractères.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    7. (Facultatif) Configurez les paramètres des nœuds de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    8. Locataire Azure : indiquez le nom ou l'ID du locataire Azure DevOps.
    9. Organisation : indiquez le nom de l'organisation ou de la collection qui utilise Azure DevOps.
    10. Schéma : saisissez le schéma, par exemple "information" ou "projet".
    11. Catalogue : saisissez le nom du catalogue.
    12. Appliquer une transformation : saisissez une liste de transformations séparées par une virgule.
    13. Édition Azure DevOps : saisissez l'édition d'Azure DevOps.
    14. API Azure DevOps Service : saisissez la version de l'API REST d'Azure DevOps.
    15. URL : indiquez l'URL de l'instance Azure DevOps.
    16. Inclure les champs personnalisés : sélectionnez cette option pour inclure les champs personnalisés dans la liste des colonnes.
    17. (Facultatif) Cliquez sur + AJOUTER UNE ÉTIQUETTE pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    18. Cliquez sur SUIVANT.
  5. Dans la section Destinations, saisissez des informations sur l'hôte distant (système backend) auquel vous souhaitez vous connecter.
    1. Type de destination : sélectionnez un type de destination.
      • Pour spécifier le nom d'hôte ou l'adresse IP de la destination, sélectionnez Adresse de l'hôte, puis saisissez l'adresse dans le champ Hôte 1.
      • Pour établir une connexion privée, sélectionnez Rattachement de point de terminaison, puis choisissez le rattachement requis dans la liste Rattachement de point de terminaison.

      Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.

      Pour saisir d'autres destinations, cliquez sur + AJOUTER UNE DESTINATION.

    2. Cliquez sur SUIVANT.
  6. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion Azure DevOps :

      • AzureAD
      • De base
    2. Pour savoir comment configurer ce type d'authentification, consultez Configurer l'authentification.

    3. Cliquez sur SUIVANT.
  7. Vérifier : vérifiez vos informations de connexion et d'authentification.
  8. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

  • AzureAD
    • ClientID : saisissez l'ID client de l'application que vous avez créée.
    • Niveaux d'accès : spécifiez tous les niveaux d'accès séparés par une virgule, tels que "read" (lecture) et "write" (écriture).
    • Code secret du client : saisissez le secret Secret Manager contenant le code secret du client pour l'application connectée que vous avez créée.
    • Version du secret : sélectionnez la version du secret sélectionné ci-dessus.
    • URL d'autorisation : indiquez l'URL d'autorisation du client.
  • Basic
    • Jeton d'accès personnel : saisissez le jeton d'accès personnel généré.
    • Version du secret : sélectionnez la version du secret saisi.

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Dans Azure DevOps, différents schémas de données sont utilisés pour organiser et gérer différents aspects d'un projet. Chaque schéma se concentre sur un type de données spécifique pour structurer efficacement les informations en fonction des besoins du projet.

  • Modèle de données de projet : schéma qui définit la façon dont les données liées au projet, telles que les éléments, les dépôts, les pipelines et les équipes, sont organisées, associées et gérées dans Azure DevOps.
  • Modèle de données d'informations : schéma qui définit la structure, le stockage et l'accès aux artefacts de documentation, de métadonnées et de communication dans les projets Azure DevOps.
  • Modèle de données du dépôt : schéma qui définit la manière dont les dépôts de code, les branches, les commits, les demandes d'extraction et les métadonnées associées sont organisés et gérés dans Azure DevOps.
  • Modèle de données Analytics : schéma qui capture et organise les données historiques et en temps réel d'Azure DevOps pour les rapports, les tableaux de bord et les analyses avancées.
  • Tous les modèles de données : une seule connexion qui permet d'accéder à tous les modèles de données.
Nom du champ Modèle d'informations Modèle de projet Modèle de dépôt Modèle Analytics Tous les modèles Connexion AzureAD
Emplacementeurope-west1europe-west1europe-west1europe-west1asia-east1europe-west1
ConnecteurAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOps
Version du connecteur111111
Nom de connexionazuredevops-informationmodelazuredevops-projectmodelazuredevops-repositorymodelazuredevops-analyticsmodeldevopsazuredevops-oauth
Activer Cloud LoggingOuiOuiOuiOuiOuiOui
Niveau de journalisationDéboguerDéboguerDéboguerDéboguerDéboguerDéboguer
Compte de serviceVotre_Numéro_De_Projet@compteserviceVotre_Numéro_De_Projet@compteserviceVotre_Numéro_De_Projet@compteserviceVotre_Numéro_De_Projet@compteserviceVotre_Numéro_De_Projet@compteserviceVotre_Numéro_De_Projet@compteservice
Locataire AzureTenant_IdTenant_IdTenant_IdTenant_IdTenant_IdTenant_Id
OrganisationOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_Name
SchémaInformationsProjetRepository__RepositoryIdAnalyticsProjet
CatalogueDevopsProject_ProjectIdProject_ProjectIdProject_ProjectIdProject_ProjectId
Édition Azure DevOpsAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps Online
API Azure DevOps Service6.06.06.06.06.06.0
Inclure des champs personnalisésOuiOuiOuiOuiOuiOui
CustomizedDefaultCatalogNameCustomizedDefaultCatalogName=GoogleCustomizedDefaultCatalogName=Google
Nombre minimal de nœuds222222
Nombre maximal de nœuds505050505050
AuthentificationOuiOuiOuiOuiOuiOui
De baseOuiOuiOuiOuiOui
Jeton d'APIJeton d'API fourni par votre applicationJeton d'API fourni par votre applicationJeton d'API fourni par votre applicationJeton d'API fourni par votre applicationJeton d'API fourni par votre application
Version du secret111111
AzureADOui
ID clientID client
Valeur du code secret du clientValeur du code secret du client
Niveaux d'accèsuser_impersonation
URL d'autorisationhttps://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

Vous pouvez utiliser les propriétés de connexion suivantes pour gérer les données extraites d'Azure DevOps.

Catalogue

Cette propriété spécifie le nom ou l'ID du projet auquel vous souhaitez vous connecter. Pour obtenir la liste des ID et des noms de projets, exécutez une requête SELECT sur la table "Projects" (Projets).

  • Pour interroger les données d'un projet spécifique, définissez Catalog sur le nom ou l'ID du projet au format Project_projectname.
    Si le nom du projet est dev avec l'ID 2ee729d6-804d-4ece-84af-d5befa94abe8, définissez Catalog sur Project_dev ou Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
  • Pour interroger des données indépendantes d'un projet spécifique, définissez Catalog sur Devops. Si le nom du catalogue est Devops, vous pouvez utiliser n'importe quel nom à la place de Devops.

Schéma

Cette propriété spécifie le schéma à utiliser. Les schémas disponibles dépendent du dépôt spécifié. Pour obtenir la liste des ID et des noms de dépôts, exécutez une requête SELECT sur la table Repositories.

  • Si vous définissez Catalog (Catalogue) et Schema (Schéma) sur INFORMATION dans la configuration de la connexion, vous n'aurez accès qu'au schéma du modèle de données d'informations. Les autres catalogues ou schémas de projet ne seront pas exposés.
  • Si Catalogue est défini sur un catalogue de projet, vous pouvez définir Schéma sur l'une des valeurs suivantes : Analytics, Project ou l'un des schémas du dépôt. Une fois que vous avez sélectionné le schéma approprié, vous pouvez interroger les données d'un dépôt spécifique.
    Pour interroger les données d'un dépôt dont l'ID est 3ee729d6-804d-4ece-84af-d5befa94abe8, définissez Catalog sur Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

Pour créer une application sur le portail Azure/MS Entra et utiliser tous les paramètres de l'application créée au niveau de la connexion Azure AD, consultez Démarrage rapide : enregistrer une application auprès de la plate-forme d'identité Microsoft et Enregistrer une application cliente dans Microsoft Entra ID.

Limites du système

Le connecteur Azure DevOps peut traiter au maximum six transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Utiliser la connexion Azure DevOps dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Actions

Cette section liste les actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action CreateWorkItem

Cette action crée un élément de travail.

Paramètres d'entrée de l'action CreateWorkItem

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
Type Chaîne Oui Type d'élément de travail à créer.
De Chaîne Non Chemin d'accès source pour l'opération de copie ou de déplacement.
Op Chaîne Oui Opération de correction qui modifie l'élément de travail, comme ajouter, copier, déplacer, supprimer, remplacer ou tester.
Chemin d'accès STRING Oui Chemin d'accès à l'opération.
Valeur Chaîne Oui Valeur de l'opération.

Pour obtenir des exemples de configuration de l'action CreateWorkItem, consultez Exemples.

Action UpdateWorkItem

Paramètres d'entrée de l'action UpdateWorkItem

Cette action met à jour un élément de travail.

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
WorkItemId Chaîne Oui ID de l'élément de travail.
De Chaîne Non Chemin d'accès source pour l'opération de copie ou de déplacement.
Op Chaîne Oui Opération de correction qui modifie l'élément de travail, comme ajouter, copier, déplacer, supprimer, remplacer ou tester.
Chemin d'accès STRING Oui Chemin d'accès à l'opération.
Valeur Chaîne Oui Valeur de l'opération.

Pour obtenir des exemples de configuration de l'action UpdateWorkItem, consultez Exemples.

Action GetPullRequestCommits

Cette action récupère les commits pour la demande d'extraction spécifiée.

Paramètres d'entrée de l'action GetPullRequestCommits

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID ou nom du dépôt. Si ProjectId n'est pas défini, vous devez définir RepositoryId.
PullRequestId Chaîne Oui ID de la demande d'extraction.

Paramètres de sortie de l'action GetPullRequestCommits

Pour obtenir des exemples de configuration de l'action GetPullRequestCommits, consultez Exemples.

Action PushChanges

Cette action transfère les modifications vers un dépôt dans votre instance Azure DevOps.

Paramètres d'entrée de l'action PushChanges

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID ou nom du dépôt. Si ProjectId n'est pas défini, vous devez définir RepositoryId.
BranchRefName Chaîne Oui Nom de la branche Git.
OldObjectId Chaîne Oui ID d'objet actuel de la branche.
CommitComment Chaîne Oui Spécifie le commentaire inclus dans le commit.
ChangesAggregate Chaîne Oui Objet agrégé contenant les détails de chaque modification apportée au commit.

Pour obtenir des exemples de configuration de l'action PushChanges, consultez Exemples.

Action DownloadReleaseLogs

Cette action télécharge les journaux pour la version spécifique.

Paramètres d'entrée de l'action DownloadReleaseLogs

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
ReleaseId Integer Oui ID de la version.
FileLocation Chaîne Non Emplacement du fichier.
Encodage STRING Non Type d'encodage d'entrée des FileData. Les valeurs autorisées sont NONE et BASE64. La valeur par défaut est BASE64.
FileStream STRING Non Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si FileLocation n'est pas fourni.

Pour obtenir des exemples de configuration de l'action DownloadReleaseLogs, consultez Exemples.

Action DownloadTestAttachment

Cette action télécharge une pièce jointe de résultat/d'exécution de test.

Paramètres d'entrée de l'action DownloadTestAttachment

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
ResultId Integer Non ID du résultat du test.
RunId Integer Oui ID de l'exécution du test.
AttachmentId STRING Non ID de la pièce jointe.
FileLocation Chaîne Non Emplacement du fichier.
Encodage STRING Non Type d'encodage d'entrée des FileData. Les valeurs autorisées sont NONE et BASE64. La valeur par défaut est BASE64.
FileStream STRING Non Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si FileLocation n'est pas fourni.

Pour obtenir des exemples de configuration de l'action DownloadTestAttachment, consultez Exemples.

Action SetProjectProperties

Cette action permet de créer, de modifier et de supprimer des propriétés de projet d'équipe.

Paramètres d'entrée de l'action SetProjectProperties

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
De Chaîne Non Chemin d'accès source pour l'opération de déplacement ou de copie.
Op Chaîne Oui Opération de correction qui modifie les propriétés du projet (ajout, copie, déplacement, suppression, remplacement ou test, par exemple).
Chemin d'accès STRING Oui Chemin d'accès à l'opération.
Valeur Chaîne Oui Valeur de l'opération.

Pour obtenir des exemples de configuration de l'action SetProjectProperties, consultez Exemples.

Action DeleteTestCase

Cette action supprime le scénario de test.

Paramètres d'entrée de l'action DeleteTestCase

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
TestcaseId Integer Oui ID du cas de test.

Pour obtenir des exemples de configuration de l'action DeleteTestCase, consultez Exemples.

Action RunPipeline

Cette action exécute un pipeline avec la configuration spécifiée.

Paramètres d'entrée de l'action RunPipeline

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
PipelineId Integer Oui ID du pipeline.
PipelineVersion Integer Non Version du pipeline à exécuter.
Ressources Chaîne Oui Ressources requises pour l'exécution.
Variables Chaîne Non Liste des variables et des valeurs à utiliser lors de l'exécution du pipeline.
StagesToSkip Chaîne Non Tableau des noms d'étapes à ignorer.
TemplateParameters Chaîne Non Mappage clé-valeur des paramètres utilisés lors de l'exécution du pipeline.

Pour obtenir des exemples de configuration de l'action RunPipeline, consultez Exemples.

Action CreatePullRequest

Cette action crée une demande d'extraction avec la configuration spécifiée.

Paramètres d'entrée de l'action CreatePullRequest

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID du dépôt.
Titre Chaîne Oui Titre de la demande d'extraction.
Description STRING Non Description de la demande d'extraction.
SourceRefName Chaîne Oui Nom de la branche source de la demande d'extraction#39;extraction.
TargetRefName Chaîne Oui Nom de la branche cible de la demande d'extraction'extraction.
CompletionOptions Chaîne Non Options qui affectent la façon dont la demande d'extraction sera fusionnée une fois terminée.
IsDraft Booléen Non Demande d'extraction brouillon / en cours de traitement.
Étiquettes Chaîne Non Libellés associés à la demande d'extraction.
MergeOptions Chaîne Non Options utilisées lors de l'exécution de la fusion de la demande d'extraction d'extraction.
Examinateurs Chaîne Non Liste des réviseurs de la demande d'extraction.
WorkItemRefs Chaîne Non Toutes les références aux éléments de travail associés à cette demande d'extraction;extraction.

Pour obtenir des exemples de configuration de l'action CreatePullRequest, consultez Exemples.

Action UpdatePullRequest

Cette action met à jour une demande d'extraction avec la configuration spécifiée.

Paramètres d'entrée de l'action UpdatePullRequest

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID du dépôt.
PullRequestId Chaîne Oui ID de la demande d'extraction.
Titre Chaîne Non Titre de la demande d'extraction.
Description STRING Non Description de la demande d'extraction.
État STRING Non État de la demande d'extraction.
TargetRefName Chaîne Non Nom de la branche cible de la demande d'extraction'extraction. Disponible uniquement lorsque la fonctionnalité de reciblage des RP est activée.
CompletionOptions Chaîne Non Options qui affectent la façon dont la demande d'extraction sera fusionnée une fois terminée.
MergeOptions Chaîne Non Options utilisées lors de l'exécution de la fusion de la demande d'extraction d'extraction.
AutoCompleteSetById Chaîne Non ID de l'utilisateur qui a activé la saisie semi-automatique.

Pour obtenir des exemples de configuration de l'action UpdatePullRequest, consultez Exemples.

Action GetPullRequestCommits

Cette action récupère les commits pour la demande d'extraction spécifiée avec la configuration spécifiée.

Paramètres d'entrée de l'action GetPullRequestCommits

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID du dépôt.
PullRequestId Chaîne Oui ID de la demande d'extraction.

Pour obtenir des exemples de configuration de l'action GetPullRequestCommits, consultez Exemples.

Action AddBuildTag

Cette action ajoute un tag à une compilation.

Paramètres d'entrée de l'action AddBuildTag

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
BuildId Chaîne Oui ID de la version.
Tag Chaîne Oui Balise à ajouter à la compilation.

Pour obtenir des exemples de configuration de l'action AddBuildTag, consultez Exemples.

Action DeleteBuildTag

Cette action supprime un tag d'une compilation.

Paramètres d'entrée de l'action DeleteBuildTag

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
BuildId Chaîne Oui ID de la version.
Tag Chaîne Oui Tag à supprimer de la compilation.

Pour obtenir des exemples de configuration de l'action DeleteBuildTag, consultez Exemples.

Action DownloadBuildReports

Cette action télécharge les rapports de compilation.

Paramètres d'entrée de l'action DownloadBuildReports

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
BuildId Integer Oui ID de la version.
FileLocation Chaîne Non Emplacement du fichier.
Encodage STRING Non Type d'encodage d'entrée des FileData. Les valeurs autorisées sont NONE et BASE64. La valeur par défaut est BASE64.
FileStream STRING Non Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si FileLocation n'est pas fourni.

Pour obtenir des exemples de configuration de l'action DownloadBuildReports, consultez Exemples.

Action DownloadBuildLogs

Cette action télécharge les journaux de compilation.

Paramètres d'entrée de l'action DownloadBuildLogs

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Oui ID du projet Azure DevOps.
BuildId Integer Oui ID de la compilation.
LogId Integer Oui ID du journal.
StartLine Integer Non Ligne de départ de la compilation.
EndLine Integer Non Ligne de fin de la compilation.
FileLocation Chaîne Non Emplacement du fichier.
Encodage STRING Non Type d'encodage d'entrée des FileData. Les valeurs autorisées sont NONE et BASE64. La valeur par défaut est BASE64.
FileStream STRING Non Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si FileLocation n'est pas fourni.

Pour obtenir des exemples de configuration de l'action DownloadBuildLogs, consultez Exemples.

Action UpdateUser

Cette action met à jour les informations d'un utilisateur.

Paramètres d'entrée de l'action UpdateUser

Nom du paramètre Type de données Obligatoire Description
UserId Chaîne Oui ID de l'utilisateur.
De Chaîne Non Chemin d'accès source pour l'opération de déplacement ou de copie.
Op Chaîne Oui Opération de correction qui modifie l'utilisateur, comme ajouter, copier, déplacer, supprimer, remplacer ou tester.
Chemin d'accès STRING Non Chemin d'accès à l'opération.
Valeur Chaîne Non Valeur de l'opération.

Pour obtenir des exemples de configuration de l'action UpdateUser, consultez Exemples.

Action CloneTestPlan

Cette action clone un plan de test.

Paramètres d'entrée de l'action CloneTestPlan

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Non ID du projet Azure DevOps.
DeepClone Booléen Non Cloner également tous les scénarios de test associés.
CloneRequirements Booléen Non Si la valeur est "true", les exigences sont clonées. La valeur par défaut est "false".
CopyAllSuites Booléen Non Copie toutes les suites d'un forfait source.
CopyAncestorHierarchy Booléen Non Copiez la hiérarchie des ancêtres.
DestinationWorkItemType Chaîne Non Nom du type d'élément de travail du clone.
OverrideParameters Chaîne Non Paires clé/valeur où la valeur de chaque clé est remplacée par la valeur spécifiée.
RelatedLinkComment Chaîne Non Ajoute un commentaire au plan de test cloné.
DestinationPlanAreaPath Chaîne Non Domaine du plan de test.
DestinationPlanBuildId Chaîne Non Créez des applications à tester.
DestinationPlanDescription Chaîne Non Description du plan de test.
DestinationPlanEndDate Chaîne Non Date de fin du plan de test.
DestinationPlanIteration Chaîne Non Chemin d'itération du plan de test.
DestinationPlanName Chaîne Oui Nom du plan de test.
DestinationPlanOwnerId Chaîne Non ID utilisateur du propriétaire du plan de test.
DestinationPlanProject Chaîne Non Nom du projet de destination.
DestinationPlanStartDate Chaîne Non la date de début du plan de test.
DestinationPlanState Chaîne Non État du plan de test.
DestinationPlanSync Booléen Non Spécifie le comportement des tests en double dans les suites d'un plan de test.
SourceTestPlanId Integer Oui ID du plan de test source.
SourceTestPlanSuiteId Integer Non Liste d'ID de suites de tests à cloner dans le plan de test source, séparés par une virgule.

Pour obtenir des exemples de configuration de l'action CloneTestPlan, consultez Exemples.

Action CloneTestSuite

Cette action clone les détails de la suite de tests.

Paramètres d'entrée de l'action CloneTestSuite

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Non ID du projet Azure DevOps.
DeepClone Booléen Non Clone tous les scénarios de test associés.
CloneRequirements Booléen Non Si la valeur est "true", les exigences sont clonées. La valeur par défaut est "false".
CopyAllSuites Booléen Non Copie toutes les suites d'un forfait source.
CopyAncestorHierarchy Booléen Non Copie la hiérarchie des ancêtres.
DestinationWorkItemType Chaîne Non Nom du type d'élément de travail pour le clone.
OverrideParameters Chaîne Non Paires clé/valeur où la valeur de chaque clé est remplacée par la valeur spécifiée.
RelatedLinkComment Chaîne Non Ajoute un commentaire à la suite de tests clonée.
DestinationTestSuiteId Integer Oui ID de la suite de tests de destination.
DestinationProjectName Chaîne Non Nom du projet à la destination.
SourceTestSuiteId Integer Oui ID de la suite de tests source.

Pour obtenir des exemples de configuration de l'action CloneTestSuite, consultez Exemples.

Action CloneTestCase

Cette action clone les détails du scénario de test.

Paramètres d'entrée de l'action CloneTestCase

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Non ID du projet Azure DevOps.
IncludeAttachments Booléen Non Inclut les pièces jointes d'un cas de test si la valeur est définie sur "true". La valeur par défaut est "false".
IncludeLinks Booléen Non Si la valeur est définie sur "true", les liens sont inclus. La valeur par défaut est "false".
RelatedLinkComment Chaîne Non Pour ajouter un commentaire au cas de test cloné.
DestinationTestPlanId Integer Oui ID du plan de test de destination.
DestinationTestSuiteId Integer Oui ID de la suite de tests de destination.
SourceTestPlanId Integer Oui ID du plan de test source.
SourceTestSuiteId Integer Oui ID de la suite de tests source.
TestCaseId Integer Oui Liste d'ID de cas de test à cloner, séparés par une virgule.

Pour obtenir des exemples de configuration de l'action CloneTestCase, consultez Exemples.

Action DeletePullRequestAttachment

Cette action supprime les détails des pièces jointes des demande d'extraction.

Paramètres d'entrée de l'action DeletePullRequestAttachment

Nom du paramètre Type de données Obligatoire Description
ProjectId Chaîne Non ID du projet Azure DevOps.
RepositoryId Chaîne Oui ID du dépôt.
PullRequestId Integer Oui ID de la demande d'extraction.
FileName STRING Oui Nom de la pièce jointe.

Pour obtenir des exemples de configuration de l'action DeletePullRequestAttachment, consultez Exemples.

Exemples d'actions

Exemple : Créer un élément de travail

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreateWorkItem, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateWorkItem aura une valeur semblable à la suivante :

    [{
    "Success": "True"
    }]
    

Pour créer différentes entités telles qu'une tâche, une épopée, une user story, un scénario de test, une fonctionnalité et un problème, il vous suffit de modifier la valeur du champ "Type" dans la charge utile d'entrée.
Pour définir un type sur "Épic", vous pouvez définir "Type": "Epic". De même, vous pouvez remplacer la valeur par "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature" ou "Type": "Issue" pour créer l'entité correspondante.

Exemple : Mettre à jour un élément de travail

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateWorkItem, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdateWorkItem aura une valeur semblable à la suivante :

    [{
    "Success": "True"
    }]
    

Exemple : Obtenir une demande d'extraction d'un commit

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action GetPullRequestCommits, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche GetPullRequestCommits aura une valeur semblable à la suivante :

    [ { "CommitId": "7299b6623d7d146751d8cf280af301f9a345ff05", "AuthorName": "jeffersonloveshi.k", "AuthorEmail": "jeffersonloveshiking@gmail.com", "AuthoredDate": "2024-08-12 11:25:23.0", "CommitterName": "lakshminarayana.k", "CommitterEmail": "jeffersonloveshiking@gmail.com", "CommittedDate": "2024-08-12 11:25:23.0", "Comment": "Added sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/7299b6623d7d146751d8cf280af301f9a345ff05" } ]
    

Exemple : Déployer des modifications vers un dépôt

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action PushChanges, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "BranchRefName": "refs/heads/US_Googlecloud_Push1", "OldObjectId": "4d66aafb75efda2bbdda7a2b609b152b1b715b7e", "CommitComment": "Googlecloud PUSH Changes", "ChangesAggregate": "{\n \"changeType\": \"edit\",\n \"item\": {\n \"path\": \"/tasks.md\"\n },\n \"newContent\": {\n \"content\": \"# Tasks\\n\\n* Item 1\\n* Item 2\",\n \"contentType\": \"rawtext\"\n }\n }" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche PushChanges aura une valeur semblable à la suivante :

    [ { "NewObjectId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitTreeId": "7e7394dcfc5b4d4cf2c8c21d70a96fe34f8eaf3e", "AuthorName": "Charlie Cruz", "AuthorEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "AuthoredDate": "2024-11-19 07:04:42.0", "CommitterName": "Charlie Cruz", "CommitterEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "CommittedDate": "2024-11-19 07:04:42.0", "CommitUrl": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/commits/949e4710336bc5bdc779ca6b334e029c2f50a029", "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "RepositoryName": "refs/heads/US_Googlecloud_Push1", "PushId": "193", "PushDate": "2024-11-19T07:04:42.5793751Z", "PushURL": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/pushes/193" } ]
    

Exemple : Télécharger les journaux d'une version

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadReleaseLogs, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadReleaseLogs aura une valeur semblable à la suivante :

    [ { "Status": "Success", "FileData": "{Base64encodedvalue}]
    

Exemple : Télécharger une pièce jointe de résultat/d'exécution de test

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadTestAttachment, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadTestAttachment aura une valeur semblable à la suivante :

    [ { "Status": "Success", "FileData": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAABlSURBVDhP7cxBCsAgDERR739pG/CnGJI0FopQ8O2cjNP6R85QbeNQU7wT1dkijaQ3vkZoWElaoTeJojW01cYh0jwfgiFBV/lEjOZtacijN/nLkOBHhIaVDgn+Wdycp6FXzlCl9wt0Y0cAzHo/zgAAAABJRU5ErkJggg==" } ]
    

Exemple : Définir les propriétés d'un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action SetProjectProperties, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche SetProjectProperties aura une valeur semblable à la suivante :

    [ { "Status": "Success" } ]
    

Exemple : Supprimer un scénario de test

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeleteTestCase, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteTestCase aura une valeur semblable à la suivante :

    [ { "Status": "Success" } ]
    

Exemple : Exécuter un pipeline pour un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RunPipeline, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "PipelineId": 7, "Resources": "{\n \"repositories\": {\n \"self\": {\n \"refName\": \"refs/heads/main\" // Specify the branch or tag\n }\n }\n }" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche RunPipeline aura une valeur semblable à la suivante :

    [ { "State": "inProgress", "RunId": "16", "RunName": "20241113.2", "RunHref": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/pipelines/7/runs/16", "CreatedDate": "2024-11-13 12:07:38.9237296" } ]
    

Exemple : Mettre à jour une demande d'extraction

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdatePullRequest, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": "26", "Description": "updated pull req", "Title": "Googlecloud M pull request" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UpdatePullRequest aura une valeur semblable à la suivante :

    [ { "Status": "Success", "PullRequestId": 26 } ]
    

Exemple : Créer une demande d'extraction

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreatePullRequest, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "Title": "Googlecloud M pull request", "SourceRefName": "refs/heads/Test_Branch", "TargetRefName": "refs/heads/main" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreatePullRequest aura une valeur semblable à la suivante :

    [ { "Status": "Success", "PullRequestId": 26 } ]
    

Exemple : Obtenir un commit de demande d'extraction;extraction

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action GetPullRequestCommits, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche GetPullRequestCommits aura une valeur semblable à la suivante :

    [ { "CommitId": "ebb720c5b93c52341cb86ccfb42258bb562a8406", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:24:19.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:24:19.0", "Comment": "Updated sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/ebb720c5b93c52341cb86ccfb42258bb562a8406" }, { "CommitId": "353f74b48ada83111449b922f4660a338e058989", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:23:01.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:23:01.0", "Comment": "Updated bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/353f74b48ada83111449b922f4660a338e058989" }, { "CommitId": "50a74dee46f8bcad4637d730994144f944c7d589", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:21:59.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:21:59.0", "Comment": "Added bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/50a74dee46f8bcad4637d730994144f944c7d589" }, { "CommitId": "9813f562b0548144006f773314704db274c757c4", "AuthorName": "Alex amal", "AuthorEmail": "cloudysanfrancisco@gmail.com", "AuthoredDate": "2024-11-26 11:19:29.0", "CommitterName": "Alex amal", "CommitterEmail": "cloudysanfrancisco@gmail.com", "CommittedDate": "2024-11-26 11:19:29.0", "Comment": "hello", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/9813f562b0548144006f773314704db274c757c4" } ]
    

Exemple : Ajouter un tag de compilation

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddBuildTag, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche AddBuildTag aura une valeur semblable à la suivante :

    [{ "Status": "Success" }]
    

Exemple : Supprimer un tag de compilation

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeleteBuildTag, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeleteBuildTag aura une valeur semblable à la suivante :

    [{ "Status": "Success" }] 
    

Exemple : Télécharger un rapport de compilation

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadBuildReports, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadBuildReports aura une valeur semblable à la suivante :

    [ { "Status": "Success", "FileData": "Base64-format data" } ]
    

Exemple : Télécharger les journaux de compilation

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadBuildLogs, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadBuildLogs aura une valeur semblable à la suivante :

    [ { "Status": "Success", "FileData": "Base64-format data" } ]
    

Exemple : Mettre à jour un utilisateur

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateUser, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "UserId": "088a8c28-1b83-4538-9c74-b7ca97eb4ef2", "Op": "add", "Path": "/projectEntitlements/50fac9d4-37aa-4a13-a81a-887d12be7b9f", "Value": "{ \"projectRef\": {\n \"id\": \"50fac9d4-37aa-4a13-a81a-887d12be7b9f\",\n \"name\": \"Postman_Testing_Project\"\n }, \n \"group\": {\n \"groupType\": \"projectContributor\"\n }}" }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche Update User aura une valeur semblable à la suivante :

    [ { "Status": "Success" } ]
    

Exemple : Cloner un plan de test

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CloneTestPlan, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "CloneRequirements": true, "CopyAllSuites": true, "RelatedLinkComment": "Cloned from existing test plan googlecloud", "DestinationPlanName": "TestPlan 2", "DestinationPlanAreaPath": "GCPTesting_New_Project", "DestinationPlanIteration": "GCPTesting_New_Project", "DestinationPlanProject": "GCPTesting_New_Project", "SourceTestPlanId": 1, "CopyAncestorHierarchy": true }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CloneTestPlan aura une valeur semblable à la suivante :

    [ { "CloneOperationId": null, "CloneOperationState": "queued", "sourcetestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestplan_project_name": "GCPTesting_New_Project", "sourcetestplan_project_state": "unchanged", "sourcetestplan_project_visibility": "unchanged", "sourcetestplan_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestplan_id": "1", "sourcetestplan_name": "Test Plan 1", "destinationtestplan_id": "15", "destinationtestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestplan_project_name": "GCPTesting_New_Project", "destinationtestplan_project_state": "unchanged", "destinationtestplan_project_visibility": "unchanged", "destinationtestplan_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestplan_updateddate": "2025-01-07T14:02:31.247Z", "destinationtestplan_updatedby_displayname": "Charlie Cruz", "destinationtestplan_updatedby_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_updatedby_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_rootsuite_id": "16", "destinationtestplan_rootsuite_name": "TestPlan 2", "destinationtestplan__links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15", "destinationtestplan__links_clienturl_href": "mtms://dev.azure.com:443/sunitavenkata2024/p:GCPTesting_New_Project/Testing/testplan/connect?id=15", "destinationtestplan__links_rootsuite_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15/Suites/16", "destinationtestplan_revision": "1", "destinationtestplan_name": "TestPlan 2", "destinationtestplan_areapath": "GCPTesting_New_Project", "destinationtestplan_startdate": "2025-01-07T14:02:31.0878913Z", "destinationtestplan_enddate": "2025-01-14T14:02:31.0878913Z", "destinationtestplan_iteration": "GCPTesting_New_Project", "destinationtestplan_owner_displayname": "sunita m V", "destinationtestplan_owner_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_owner_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_state": "Active", "destinationtestplan_testoutcomesettings_syncoutcomeacrosssuites": "false", "cloneoptions_relatedlinkcomment": "Cloned from existing test plan gcp", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "true", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/0" } ]
    

Exemple : cloner une suite de tests

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CloneTestSuite, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CloneTestSuite aura une valeur semblable à la suivante :

    [ { "CloneOperationId": 2, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_id": "18", "sourcetestsuite_name": "Test Plan 3", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "2", "destinationtestsuite_name": "Test Plan 1", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "false", "cloneoperationresponse_opid": "2", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Suites/CloneOperation/2" } ]
    

Exemple : Cloner un scénario de test

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CloneTestCase, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
    
  4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CloneTestCase aura une valeur semblable à la suivante :

    [ { "CloneOperationId": 3, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_testcaseids": "3", "sourcetestsuite_id": "2", "sourcetestsuite_name": "Test Plan 1", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "21", "destinationtestsuite_name": "Test Plan 4", "cloneoptions_includelinks": "false", "cloneoptions_includeattachments": "false", "cloneoperationresponse_opid": "3", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/3" } ]
    

Exemple : Supprimer une pièce jointe d'une demande d'extraction d'extraction

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeletePullRequestAttachment, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }
    
  4. Cette action renvoie un message de confirmation de l'action DeletePullRequestAttachment. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DeletePullRequestAttachment aura une valeur semblable à la suivante :

    [ { "Status": "Success" } ]
    

Exemples d'opérations d'entité

Récupérer tous les tableaux de bord d'un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Dashboards dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client. Veuillez consulter la section "Remarque" ci-dessous.

  5. La valeur de filterClause doit toujours être transmise entre guillemets simples (') dans ce format.
    Vous pouvez utiliser filterClause pour filtrer un certain ensemble d'enregistrements en fonction de n'importe quelle colonne.

Exemple : Récupérer un seul tableau de bord à l'aide de son ID

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Dashboards dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "2f671e29-e48f-4d26-8869-859e154b5f20", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "2f671e29-e48f-4d26-8869-859e154b5f20" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

    La valeur de l'ID d'entité doit être transmise directement, par exemple "2f671e29-e48f-4d26-8869-859e154b5f20". Dans cet exemple, "2f671e29-e48f-4d26-8869-859e154b5f20" est la valeur de clé primaire unique qui est transmise.

    Dans certains cas, la transmission d'un seul ID d'entité peut entraîner une erreur, car l'entité comporte deux clés composites. Dans ce cas, vous pouvez utiliser filterClause et transmettre la valeur, par exemple id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Exemple : Supprimer un tableau de bord à l'aide de son ID

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Dashboards dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "2f671e29-e48f-4d26-8869-859e154b5f20", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "2f671e29-e48f-4d26-8869-859e154b5f20" dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

    Si l'entité comporte deux clés métier ou clés primaires composites, vous pouvez définir la filterClause sur id='2f671e29-e48f-4d26-8869-859e154b5f20' au lieu de spécifier l'entityId.

Exemple : Créer un tableau de bord dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Dashboard dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "a2402c49-6c17-43a9-bfc4-3701d07bcfee" }
    

Exemple : Créer un droit d'accès utilisateur dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "5e373a81-073d-4d64-a2c5-23d0b6cc287f" }
    

Exemple : Créer une requête dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Queries dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "New Queries Googlecloud", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "IsFolder": true, "Wiql": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] = 'New' ORDER BY [System.ChangedDate] DESC", "ParentQueryId": "df947cf9-dbbe-43bc-93a4-3e4d7287adb8" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "cf4a25e8-d2d2-48b7-a483-dd901c78293b" }
    

Exemple : Créer un pipeline dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Pipelines dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": 9 }
    

Exemple : Créer un groupe de déploiement dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez DeploymentGroups dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "Deployment group 2 Googlecloud" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": 139 }
    

Exemple : Créer une configuration de test dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestPlan dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "Googlecloud_TestPlan" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": 106 }
    

Exemple : Créer une suite de tests dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestSuite dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": 22264 }
    

Exemple : Créer une série de tests dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestRun dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "TestRun_Googlecloud1"}
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": 46 }
    

Exemple : Créer un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Projects dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Projects aura une valeur semblable à la suivante :

    { "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
    
  5. L'ID généré après l'opération de création d'un projet n'est pas l'ID de projet réel.
    Pour récupérer les détails exacts du projet, vous devez effectuer l'opération List avec le nom du projet comme condition de filtre, par exemple Name= 'Google Project Integration'.

Exemple : Créer une équipe dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Teams dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "M new team"}
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
    

Exemple : Créer un environnement dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Environments dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "9" }
    

Exemple : Créer un widget dans un tableau de bord

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Widgets dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "Name": "Widget 2", "DashboardId": "6cb82f8d-393c-422e-b4e3-563d5e34fc31", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1", "RowPosition": 4, "ColumnPosition": 4, "RowSpanSize": 1, "ColumnSpanSize": 2, "ContributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.OtherLinksWidget" }
    

    Cet exemple montre comment ajouter des widgets. Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche de connecteur aura une valeur semblable à la suivante :

    { "Id": "7d049ae2-d995-4b3e-9ebd-662d94a53cc8" }
    

Exemple : Ajouter un réviseur à une demande d'extraction dans un dépôt

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez PullRequestReviewers dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "PullRequestId": null }
    

Exemple : Créer un groupe de variables dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez VariableGroups dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc",
      "Type": "Vsts",
      "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
      "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"Variable Group new test\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"Googlecloud-Demo-Project\"\n      }\n    }\n  ]",
      "Name": "Variable Group new test"
    }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    {"Id": "12"}
    

Exemple : Créer une définition de compilation dans un dépôt

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez BuildDefinition dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    {"Id": "25"}
    

Exemple : Créer une version dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Releases dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
    

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

    { "Id": "13" }
    

Exemple : Modifier le nom ou la description d'une équipe dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Teams dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "M new team update" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Teams. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 5285fb98-a1bc-42e1-9668-3c2780061367.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
    

Exemple : Mettre à jour une requête dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Queries dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Update Queries" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité des requêtes. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 81797017-624d-4967-bc85-842a817bff48.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "81797017-624d-4967-bc85-842a817bff48" }
    

Exemple : Mettre à jour un tableau de bord dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Dashboard dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": " update from googlecloud" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité du tableau de bord. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 139.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "139" }
    

Exemple : Mettre à jour une suite de tests dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestSuite dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "UPdated_Suite", "ParentSuiteId": 108 }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité TestSuite. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 22264.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "22264" }
    

Exemple : Mettre à jour un groupe de déploiement dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez DeploymentGroups dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Deployment" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité DeploymentGroups. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 138.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "138" }
    

Exemple : Mettre à jour un plan de test dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestPlan dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "TestPlan_Update" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité TestPlan. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 104.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "104" }
    

Exemple : Mettre à jour une série de tests dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez TestRuns dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité TestRuns. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 46.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "46" }
    

Exemple : Mettre à jour un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Projects dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Projects Update" }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Projects. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }
    

Exemple : Mettre à jour un environnement dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Environments dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Environment Update M", "Description": "Update environment " }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité des environnements. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur { "Id": "9" }.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": 9 }
    

Exemple : Mettre à jour un groupe de variables dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez VariableGroups dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
      "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"New VariableGroup googlecloud updated\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"GoogleCloud-Demo-Project\"\n      }\n    }\n  ]",
      "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
      "Name": "Variable Group new test updated"
    }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité VariableGroups. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et sélectionnez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur { "Id": "12" }.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": 12 }
    

Exemple : Mettre à jour une définition de compilation dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez BuildDefinition dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité BuildDefinition. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": 25 }
    

Exemple : Mettre à jour un réviseur de demande d'extraction dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez PullRequestReviewers dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {"isFlagged": true}
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité PullRequestReviewers. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    { "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81","PullRequestId": null}
    

Exemple : Mettre à jour une version dans un projet

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Releases dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    { "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
    
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Releases. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur {"Id": 13}.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    {"Id": 13 }
    

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes