Azure DevOps

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.

En Azure DevOps, se usan varios esquemas de datos para organizar y administrar diferentes aspectos de un proyecto. Cada esquema se enfoca en un tipo específico de datos para estructurar la información de manera eficaz según las necesidades del proyecto.

• Modelo de datos del proyecto: Es un esquema que define cómo se organizan, vinculan y administran los datos relacionados con el proyecto, como elementos, repositorios, canalizaciones y equipos, dentro de Azure DevOps.
• Modelo de datos de información: Es un esquema que define cómo se estructuran, almacenan y acceden los artefactos de documentación, metadatos y comunicación en los proyectos de Azure DevOps.
• Modelo de datos del repositorio: Es un esquema que define cómo se organizan y administran los repositorios de código, las ramas, las confirmaciones, las solicitudes de extracción y los metadatos relacionados dentro de Azure DevOps.
• Modelo de datos de Analytics: Es un esquema que captura y organiza los datos históricos y en tiempo real de Azure DevOps para generar informes, paneles y análisis avanzados.
• Todos los modelos de datos: Una sola conexión que proporciona acceso a todos los modelos de datos en una sola conexión.

Puedes usar las siguientes propiedades de conexión para administrar los datos recuperados de Azure DevOps.

Catálogo

Esta propiedad especifica el nombre o el ID del proyecto al que deseas conectarte. Para obtener una lista de los IDs y nombres de los proyectos, ejecuta una consulta SELECT en la tabla Projects.

• Para consultar datos de un proyecto específico, configura Catalog como el nombre o el ID del proyecto en el formato Project_projectname.
  Si el nombre del proyecto es dev con el ID 2ee729d6-804d-4ece-84af-d5befa94abe8, establece Catalog en Project_dev o Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
• Para consultar datos que son independientes de un proyecto específico, configura Catalog como Devops. Si el nombre del catálogo es Devops, puedes usar cualquier nombre en lugar de Devops.

Esquema

Esta propiedad especifica el esquema que se usará. Los esquemas disponibles dependen del repositorio especificado. Para obtener una lista de los IDs y nombres de los repositorios, ejecuta una consulta SELECT en la tabla Repositories.

• Si configuras Catálogo y Esquema como INFORMATION en la configuración de la conexión, solo tendrás acceso al esquema del modelo de datos de información. No se expondrán otros catálogos ni esquemas de proyectos.
• Si Catálogo está configurado como un catálogo de proyectos, puedes establecer Esquema en uno de los siguientes valores: Analytics, Project o uno de los esquemas del repositorio. Una vez que selecciones el esquema adecuado, podrás consultar datos dentro de un repositorio específico.
  Para consultar datos de un repositorio con el ID 3ee729d6-804d-4ece-84af-d5befa94abe8, configura Catalog como Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

Para crear una aplicación en Azure Portal o MS Entra y utilizar todos los parámetros de la aplicación creada a nivel de la conexión de Azure AD, consulta Inicio rápido: Registra una aplicación con la plataforma de identidad de Microsoft y Registra una aplicación cliente en Microsoft Entra ID.

Acciones

En esta sección, se enumeran las acciones que admite el conector. Para comprender cómo configurar las acciones, consulta Ejemplos de acciones.

Acción CreateWorkItem

Esta acción crea un elemento de trabajo.

Parámetros de entrada de la acción CreateWorkItem

Para ver ejemplos sobre cómo configurar la acción CreateWorkItem, consulta Ejemplos.

Acción UpdateWorkItem

Parámetros de entrada de la acción UpdateWorkItem

Esta acción actualiza un elemento de trabajo.

Para ver ejemplos sobre cómo configurar la acción UpdateWorkItem, consulta Ejemplos.

Acción GetPullRequestCommits

Esta acción obtiene las confirmaciones de la solicitud de extracción especificada.

Parámetros de entrada de la acción GetPullRequestCommits

Parámetros de salida de la acción GetPullRequestCommits

Para ver ejemplos sobre cómo configurar la acción GetPullRequestCommits, consulta Ejemplos.

Acción PushChanges

Esta acción envía cambios a un repositorio en tu instancia de Azure DevOps.

Parámetros de entrada de la acción PushChanges

Para ver ejemplos sobre cómo configurar la acción PushChanges, consulta Ejemplos.

Acción DownloadReleaseLogs

Esta acción descarga los registros de la versión específica.

Parámetros de entrada de la acción DownloadReleaseLogs

Para ver ejemplos sobre cómo configurar la acción DownloadReleaseLogs, consulta Ejemplos.

Acción DownloadTestAttachment

Esta acción descarga un archivo adjunto de un resultado o ejecución de prueba.

Parámetros de entrada de la acción DownloadTestAttachment

Para ver ejemplos sobre cómo configurar la acción DownloadTestAttachment, consulta Ejemplos.

Acción SetProjectProperties

Esta acción puede crear, actualizar y borrar propiedades del proyecto de equipo.

Parámetros de entrada de la acción SetProjectProperties

Para ver ejemplos sobre cómo configurar la acción SetProjectProperties, consulta Ejemplos.

Acción DeleteTestCase

Esta acción borra el caso de prueba.

Parámetros de entrada de la acción DeleteTestCase

Para ver ejemplos sobre cómo configurar la acción DeleteTestCase, consulta Ejemplos.

Acción de RunPipeline

Esta acción ejecuta una canalización con la configuración especificada.

Parámetros de entrada de la acción RunPipeline

Para ver ejemplos sobre cómo configurar la acción RunPipeline, consulta Ejemplos.

Acción CreatePullRequest

Esta acción crea una solicitud de extracción con la configuración especificada.

Parámetros de entrada de la acción CreatePullRequest

Para ver ejemplos sobre cómo configurar la acción CreatePullRequest, consulta Ejemplos.

Acción UpdatePullRequest

Esta acción actualiza una solicitud de extracción con la configuración especificada.

Parámetros de entrada de la acción UpdatePullRequest

Para ver ejemplos sobre cómo configurar la acción UpdatePullRequest, consulta Ejemplos.

Acción GetPullRequestCommits

Esta acción obtiene las confirmaciones de la solicitud de extracción especificada con la configuración especificada.

Parámetros de entrada de la acción GetPullRequestCommits

Para ver ejemplos sobre cómo configurar la acción GetPullRequestCommits, consulta Ejemplos.

Acción AddBuildTag

Esta acción agrega una etiqueta a una compilación.

Parámetros de entrada de la acción AddBuildTag

Para ver ejemplos sobre cómo configurar la acción AddBuildTag, consulta Ejemplos.

Acción DeleteBuildTag

Esta acción borra una etiqueta de una compilación.

Parámetros de entrada de la acción DeleteBuildTag

Para ver ejemplos sobre cómo configurar la acción DeleteBuildTag, consulta Ejemplos.

Acción DownloadBuildReports

Esta acción descarga informes de compilación.

Parámetros de entrada de la acción DownloadBuildReports

Para ver ejemplos sobre cómo configurar la acción DownloadBuildReports, consulta Ejemplos.

Acción DownloadBuildLogs

Esta acción descarga registros de compilación.

Parámetros de entrada de la acción DownloadBuildLogs

Para ver ejemplos sobre cómo configurar la acción DownloadBuildLogs, consulta Ejemplos.

Acción UpdateUser

Esta acción actualiza los detalles de un usuario.

Parámetros de entrada de la acción UpdateUser

Para ver ejemplos sobre cómo configurar la acción UpdateUser, consulta Ejemplos.

Acción CloneTestPlan

Esta acción clona un plan de pruebas.

Parámetros de entrada de la acción CloneTestPlan

Para ver ejemplos sobre cómo configurar la acción CloneTestPlan, consulta Ejemplos.

Acción CloneTestSuite

Esta acción clona los detalles del conjunto de pruebas.

Parámetros de entrada de la acción CloneTestSuite

Para ver ejemplos sobre cómo configurar la acción CloneTestSuite, consulta Ejemplos.

Acción CloneTestCase

Esta acción clona los detalles del caso de prueba.

Parámetros de entrada de la acción CloneTestCase

Para ver ejemplos sobre cómo configurar la acción CloneTestCase, consulta Ejemplos.

Acción DeletePullRequestAttachment

Esta acción borra los detalles de los archivos adjuntos de la solicitud de extracción.

Parámetros de entrada de la acción DeletePullRequestAttachment

Para ver ejemplos sobre cómo configurar la acción DeletePullRequestAttachment, consulta Ejemplos.

Ejemplos de acciones

Ejemplo: Crea un elemento de trabajo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CreateWorkItem y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea CreateWorkItem tendrá un valor similar al siguiente:

[{
"Success": "True"
}]

Para crear varias entidades, como una tarea, una épica, una historia de usuario, un caso de prueba, una función y un problema, solo debes modificar el valor del campo "Type" en la carga útil de entrada.
Para establecer un tipo como Épica, puedes configurar "Type": "Epic". Del mismo modo, puedes cambiar el valor a "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature" o "Type": "Issue" para crear la entidad correspondiente.

Ejemplo: Actualiza un elemento de trabajo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción UpdateWorkItem y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea UpdateWorkItem tendrá un valor similar al siguiente:

[{
"Success": "True"
}]

Ejemplo: Obtén una solicitud de extracción de una confirmación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción GetPullRequestCommits y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea GetPullRequestCommits tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Envía cambios a un repositorio

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción PushChanges y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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 }" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea PushChanges tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Descarga los registros de una versión

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DownloadReleaseLogs y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DownloadReleaseLogs tendrá un valor similar al siguiente:

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

Ejemplo: Descarga un archivo adjunto de un resultado o una ejecución de prueba

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DownloadTestAttachment y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DownloadTestAttachment tendrá un valor similar al siguiente:

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

Ejemplo: Establece las propiedades de un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción SetProjectProperties y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea SetProjectProperties tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: Borra un caso de prueba

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DeleteTestCase y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DeleteTestCase tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: Ejecuta una canalización para un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción RunPipeline y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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 }" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea RunPipeline tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Actualiza una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción UpdatePullRequest y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea UpdatePullRequest tendrá un valor similar al siguiente:

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

Ejemplo: Crea una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CreatePullRequest y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea CreatePullRequest tendrá un valor similar al siguiente:

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

Ejemplo: Obtén la confirmación de una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción GetPullRequestCommits y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea GetPullRequestCommits tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Agrega una etiqueta de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción AddBuildTag y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea AddBuildTag tendrá un valor similar al siguiente:

[{ "Status": "Success" }]

Ejemplo: Borra una etiqueta de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DeleteBuildTag y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DeleteBuildTag tendrá un valor similar al siguiente:

[{ "Status": "Success" }] 

Ejemplo: Descarga un informe de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DownloadBuildReports y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DownloadBuildReports tendrá un valor similar al siguiente:

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

Ejemplo: Descarga registros de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DownloadBuildLogs y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DownloadBuildLogs tendrá un valor similar al siguiente:

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

Ejemplo: Actualiza un usuario

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción UpdateUser y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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 }}" }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Update User tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: Clona un plan de pruebas

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CloneTestPlan y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo 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 }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea CloneTestPlan tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Clona un conjunto de pruebas

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CloneTestSuite y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea CloneTestSuite tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Clona un caso de prueba

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción CloneTestCase y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
   

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea CloneTestCase tendrá un valor similar al siguiente:

[ { "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" } ]

Ejemplo: Borra un archivo adjunto de una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Selecciona la acción DeletePullRequestAttachment y haz clic en Listo.
3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value:

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }
   

Esta acción devuelve un mensaje de confirmación de DeletePullRequestAttachment. Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea DeletePullRequestAttachment tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplos de operaciones de entidades

Recupera todos los paneles de un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Dashboards en la lista Entity.
3. Selecciona la operación List y haz clic en Listo.
4. En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente. Consulta la sección de notas a continuación.

El valor de filterClause siempre debe pasarse entre comillas simples (') en este formato.
Puedes usar filterClause para filtrar un determinado conjunto de registros según cualquier columna.

Ejemplo: Recupera un solo panel con su ID

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Dashboards en la lista Entity.
3. Selecciona la operación Get y haz clic en Listo.
4. Establece el ID de la entidad en "2f671e29-e48f-4d26-8869-859e154b5f20", que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "2f671e29-e48f-4d26-8869-859e154b5f20" en el campo Input Value y elige EntityId como variable local.

   El valor del ID de entidad debe pasarse directamente, como "2f671e29-e48f-4d26-8869-859e154b5f20". Aquí, "2f671e29-e48f-4d26-8869-859e154b5f20" es el valor de clave primaria único que se pasa.

   En algunos casos, pasar un solo ID de entidad puede causar un error porque la entidad tiene dos claves compuestas. En esos casos, puedes usar filterClause y pasar el valor, como id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Ejemplo: Quita un panel con su ID

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Dashboards en la lista Entity.
3. Selecciona la operación Delete y haz clic en Listo.
4. Establece el ID de la entidad en "2f671e29-e48f-4d26-8869-859e154b5f20", que es la clave que se pasará. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "2f671e29-e48f-4d26-8869-859e154b5f20" en el campo Input Value y elige EntityId como variable local.

   Si la entidad tiene dos claves comerciales o primarias compuestas, en lugar de especificar entityId, puedes establecer filterClause en id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Ejemplo: Crea un panel nuevo en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Dashboard en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea un derecho de usuario nuevo en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Users en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea una búsqueda nueva en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Queries en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "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 la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea una canalización nueva en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Pipelines en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "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 la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": 9 }
   

Ejemplo: Crea un grupo de implementación en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona DeploymentGroups en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "Deployment group 2 Googlecloud" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": 139 }
   

Ejemplo: Crea una nueva configuración de prueba en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestPlan en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "Googlecloud_TestPlan" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": 106 }
   

Ejemplo: Crea un conjunto de pruebas en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestSuite en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": 22264 }
   

Ejemplo: Crea una ejecución de prueba en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestRun en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "TestRun_Googlecloud1"}
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": 46 }
   

Ejemplo: Crea un proyecto nuevo

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Projects en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea Projects tendrá un valor similar al siguiente:

   { "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
   

El ID que se genera después de realizar la operación Create en un proyecto no es el ID real del proyecto.
Para recuperar los detalles exactos del proyecto, debes realizar la operación List con el nombre del proyecto como condición de filtro, por ejemplo, Name= 'Google Project Integration'.

Ejemplo: Crea un equipo en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Teams en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "M new team"}
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea un entorno en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Environments en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": "9" }
   

Ejemplo: Crea un widget nuevo en un panel

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Widgets en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

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

   En este ejemplo, se muestra cómo agregar un widget. Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Agrega un revisor a una solicitud de extracción en un repositorio

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona PullRequestReviewers en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: Crea un grupo de variables en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona VariableGroups en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   {
     "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 la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {"Id": "12"}
   

Ejemplo: Crea una nueva definición de compilación en un repositorio

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona BuildDefinition en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   {"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   {"Id": "25"}
   

Ejemplo: Crea una versión en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Releases en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload como variable local.

   { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
   

   Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

   { "Id": "13" }
   

Ejemplo: Actualiza el nombre o la descripción de un equipo en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Teams en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "M new team update" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de Teams. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 5285fb98-a1bc-42e1-9668-3c2780061367.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: Actualiza una consulta en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Queries en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Update Queries" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de las consultas. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 81797017-624d-4967-bc85-842a817bff48.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: Actualiza un panel en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Dashboard en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": " update from googlecloud" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad del panel. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 139.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "139" }
   

Ejemplo: Actualiza un conjunto de pruebas en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestSuite en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "UPdated_Suite", "ParentSuiteId": 108 }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de TestSuite. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 22264.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "22264" }
   

Ejemplo: Actualiza un grupo de implementación en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona DeploymentGroups en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Deployment" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de DeploymentGroups. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 138.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "138" }
   

Ejemplo: Actualiza un plan de prueba en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestPlan en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "TestPlan_Update" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de TestPlan. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 104.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "104" }
   

Ejemplo: Actualiza una ejecución de prueba en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona TestRuns en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de TestRuns. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en 46.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "46" }
   

Ejemplo: Actualiza un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Projects en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Projects Update" }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de los proyectos. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: Actualiza un entorno en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Environments en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Environment Update M", "Description": "Update environment " }
   

5. Establece el ID de la entidad en Data Mapper en la entidad de los entornos. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en { "Id": "9" }.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 9 }
   

Ejemplo: Actualiza un grupo de variables en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona VariableGroups en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {
     "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. Establece el ID de la entidad en Data Mapper en la entidad de VariableGroups. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en { "Id": "12" }.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 12 }
   

Ejemplo: Actualiza la definición de una compilación en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona BuildDefinition en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
   

5. Establece el ID de entidad en Data Mapper en la entidad de BuildDefinition. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 25 }
   

Ejemplo: Actualiza un revisor de solicitud de extracción en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona PullRequestReviewers en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   {"isFlagged": true}
   

5. Configura el ID de la entidad en Data Mapper como la entidad de PullRequestReviewers. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: Actualiza una versión en un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Releases en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
   

5. Establece el ID de la entidad en el asignador de datos para la entidad de los lanzamientos. Para establecer el ID de la entidad, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar entityId, también puedes establecer filterClause en {"Id": 13}.

   Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {"Id": 13 }