Azure DevOps

Ejemplos de configuración de conexiones

En esta sección se indican los valores de ejemplo de los distintos campos que se configuran al crear la conexión.

En Azure DevOps, se usan varios esquemas de datos para organizar y gestionar diferentes aspectos de un proyecto. Cada esquema se centra en un tipo de datos específico para estructurar la información de forma eficaz en función de las necesidades del proyecto.

• Modelo de datos de proyecto: un esquema que define cómo se organizan, vinculan y gestionan los datos relacionados con el proyecto, como elementos, repositorios, pipelines y equipos, en Azure DevOps.
• Modelo de datos de información: un esquema que define cómo se estructuran, almacenan y accede a la documentación, los metadatos y los artefactos de comunicación en los proyectos de Azure DevOps.
• Modelo de datos de repositorio: un esquema que define cómo se organizan y gestionan los repositorios de código, las ramas, las confirmaciones, las solicitudes de extracción y los metadatos relacionados en Azure DevOps.
• Modelo de datos de Analytics: un esquema que recoge y organiza datos históricos y en tiempo real de Azure DevOps para generar informes, paneles de control y analíticas avanzadas.
• Todos los modelos de datos: una sola conexión que proporciona acceso a todos los modelos de datos en una sola conexión.

Puede usar las siguientes propiedades de conexión para gestionar los datos obtenidos de Azure DevOps.

Catálogo

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

• Para consultar los datos de un proyecto específico, asigna el nombre o el ID del proyecto al campo Catálogo con el formato Project_nombreproyecto.
  Si el nombre del proyecto es dev y su ID es 2ee729d6-804d-4ece-84af-d5befa94abe8, asigna a Catalog el valor Project_dev o Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
• Para consultar datos que no dependan de un proyecto específico, define Catálogo 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 va a 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 asigna el valor INFORMATION a Catálogo y Esquema en la configuración de la conexión, solo tendrá acceso al esquema del modelo de datos de información. No se expondrán otros catálogos ni esquemas de proyectos.
• Si Catalog se asigna a un catálogo de proyectos, puede asignar a Schema uno de los siguientes valores: Analytics, Project o uno de los esquemas del repositorio. Una vez que hayas seleccionado el esquema adecuado, podrás consultar los datos de un repositorio específico.
  Para consultar datos de un repositorio con el ID 3ee729d6-804d-4ece-84af-d5befa94abe8, define 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 en el nivel de conexión de Azure AD, consulta los artículos Inicio rápido: Registrar una aplicación con la plataforma de identidad de Microsoft y Registrar una aplicación cliente en Microsoft Entra ID.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulte los ejemplos de acciones.

Acción CreateWorkItem

De esta forma, se crea un elemento de trabajo.

Parámetros de entrada de la acción CreateWorkItem

Para ver un ejemplo de 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 un ejemplo de 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 un ejemplo de cómo configurar la acción GetPullRequestCommits, consulta Ejemplos.

Acción PushChanges

Esta acción inserta los cambios en un repositorio de tu instancia de Azure DevOps.

Parámetros de entrada de la acción PushChanges

Para ver un ejemplo de cómo configurar la acción PushChanges, consulta Ejemplos.

Acción DownloadReleaseLogs

Con esta acción se descargan los registros de la versión específica.

Parámetros de entrada de la acción DownloadReleaseLogs

Para ver un ejemplo de cómo configurar la acción DownloadReleaseLogs, consulta Ejemplos.

Acción DownloadTestAttachment

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

Parámetros de entrada de la acción DownloadTestAttachment

Para ver un ejemplo de cómo configurar la acción DownloadTestAttachment, consulta Ejemplos.

Acción SetProjectProperties

Esta acción puede crear, actualizar y eliminar propiedades de proyectos de equipo.

Parámetros de entrada de la acción SetProjectProperties

Para ver un ejemplo de cómo configurar la acción SetProjectProperties, consulta Ejemplos.

Acción DeleteTestCase

Esta acción elimina el caso de prueba.

Parámetros de entrada de la acción DeleteTestCase

Para ver un ejemplo de cómo configurar la acción DeleteTestCase, consulta Ejemplos.

Acción RunPipeline

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

Parámetros de entrada de la acción RunPipeline

Para ver un ejemplo de 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 un ejemplo de 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 un ejemplo de 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 indicada.

Parámetros de entrada de la acción GetPullRequestCommits

Para ver un ejemplo de cómo configurar la acción GetPullRequestCommits, consulta Ejemplos.

Acción AddBuildTag

Al hacerlo, se añade una etiqueta a una compilación.

Parámetros de entrada de la acción AddBuildTag

Para ver un ejemplo de cómo configurar la acción AddBuildTag, consulta Ejemplos.

Acción DeleteBuildTag

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

Parámetros de entrada de la acción DeleteBuildTag

Para ver un ejemplo de 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 un ejemplo de cómo configurar la acción DownloadBuildReports, consulta Ejemplos.

Acción DownloadBuildLogs

Esta acción descarga los registros de compilación.

Parámetros de entrada de la acción DownloadBuildLogs

Para ver un ejemplo de 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 un ejemplo de 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 un ejemplo de cómo configurar la acción CloneTestPlan, consulta Ejemplos.

Acción CloneTestSuite

Esta acción clona los detalles de la suite de pruebas.

Parámetros de entrada de la acción CloneTestSuite

Para ver un ejemplo de 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 un ejemplo de cómo configurar la acción CloneTestCase, consulta Ejemplos.

Acción DeletePullRequestAttachment

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

Parámetros de entrada de la acción DeletePullRequestAttachment

Para ver un ejemplo de cómo configurar la acción DeletePullRequestAttachment, consulta Ejemplos.

Ejemplos de acciones

Ejemplo: crear un elemento de trabajo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateWorkItem y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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 tiene que modificar el valor del campo "Type" en la carga útil de entrada.
Para definir el tipo como Épico, puedes definir "Type": "Epic". Del mismo modo, puede cambiar el valor a "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature" o "Type": "Issue" para crear la entidad correspondiente.

Ejemplo: actualizar un elemento de trabajo

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UpdateWorkItem y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea UpdateWorkItem tendrá un valor similar al siguiente:

[{
"Success": "True"
}]

Ejemplo: obtener una solicitud de extracción de una confirmación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetPullRequestCommits y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: aplicar cambios en un repositorio

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción PushChanges y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: descargar los registros de una versión

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadReleaseLogs y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DownloadReleaseLogs tendrá un valor similar al siguiente:

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

Ejemplo: descargar 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. Seleccione la acción DownloadTestAttachment y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DownloadTestAttachment tendrá un valor similar al siguiente:

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

Ejemplo: definir las propiedades de un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción SetProjectProperties y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea SetProjectProperties tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: eliminar un caso de prueba

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeleteTestCase y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DeleteTestCase tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: ejecutar un flujo de procesamiento de un proyecto

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción RunPipeline y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: actualizar una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UpdatePullRequest y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea UpdatePullRequest tendrá un valor similar al siguiente:

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

Ejemplo: crear una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreatePullRequest y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea CreatePullRequest tendrá un valor similar al siguiente:

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

Ejemplo: obtener una confirmación de solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción GetPullRequestCommits y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: añadir una etiqueta de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción AddBuildTag y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea AddBuildTag tendrá un valor similar al siguiente:

[{ "Status": "Success" }]

Ejemplo: eliminar una etiqueta de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeleteBuildTag y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DeleteBuildTag tendrá un valor similar al siguiente:

[{ "Status": "Success" }] 

Ejemplo: descargar un informe de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadBuildReports y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DownloadBuildReports tendrá un valor similar al siguiente:

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

Ejemplo: descargar registros de compilación

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadBuildLogs y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea DownloadBuildLogs tendrá un valor similar al siguiente:

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

Ejemplo: actualizar un usuario

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UpdateUser y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response de la tarea Update User tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplo: clonar un plan de pruebas

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CloneTestPlan y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: clonar una suite de pruebas

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CloneTestSuite y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: clonar un caso de prueba

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CloneTestCase y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayload response 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: eliminar un archivo adjunto de una solicitud de extracción

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeletePullRequestAttachment y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce 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 connectorOutputPayloadresponseDeletePullRequestAttachment de la tarea tendrá un valor similar al siguiente:

[ { "Status": "Success" } ]

Ejemplos de operaciones de entidades

Recuperar 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, a continuación, haz clic en Hecho.
4. Entrada de tarea de la tarea Conectores, puede definir el filterClause según los requisitos del cliente. Consulta la sección Nota que se incluye más abajo.

El valor de filterClause siempre debe incluirse entre comillas simples ("'") con este formato.
Puede usar filterClause para filtrar un conjunto de registros en función de cualquier columna.

Ejemplo: obtener un único panel de control mediante 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, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad "2f671e29-e48f-4d26-8869-859e154b5f20", que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Asignación de datos de Asignador de datos, haga clic en Abrir editor de asignación de datos. A continuación, introduzca "2f671e29-e48f-4d26-8869-859e154b5f20" en el campo Valor de entrada y elija EntityId como variable local.

   El valor del ID de entidad debe transferirse directamente, como "2f671e29-e48f-4d26-8869-859e154b5f20". En este caso, "2f671e29-e48f-4d26-8869-859e154b5f20" es el valor de clave principal único que se transfiere.

   En algunos casos, si se envía un solo ID de entidad, puede producirse un error porque la entidad tiene dos claves compuestas. En esos casos, puede usar filterClause y transferir el valor, como id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Ejemplo: eliminar un panel de control mediante 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, a continuación, haz clic en Hecho.
4. Asigna el ID de entidad "2f671e29-e48f-4d26-8869-859e154b5f20", que es la clave que se va a transferir. Para definir el ID de entidad, en la sección Asignación de datos de Asignador de datos, haga clic en Abrir editor de asignación de datos. A continuación, introduzca "2f671e29-e48f-4d26-8869-859e154b5f20" en el campo Valor de entrada y elija EntityId como variable local.

   Si la entidad tiene dos claves empresariales o primarias compuestas, en lugar de especificar el entityId, puede definir filterClause como id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Ejemplo: Crear 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 Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear un nuevo derecho de usuario 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear 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 Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear una nueva canalización 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear una 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear una 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear 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 Create y, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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 connectorOutputPayload de la respuesta Projects tendrá un valor similar al siguiente:

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

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

Ejemplo: Crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear un widget en un panel de control

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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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 añadir widgets. Si la integración se realiza correctamente, el parámetro connectorOutputPayload de la respuesta de la tarea del conector tendrá un valor similar al siguiente:

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

Ejemplo: añadir 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: crear una 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Crear 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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: Cambiar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

5. En Data Mapper, asigna el ID de entidad a la entidad de Teams. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 5285fb98-a1bc-42e1-9668-3c2780061367.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Update Queries" }
   

5. En Data Mapper, asigna el ID de entidad a la entidad de las consultas. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 81797017-624d-4967-bc85-842a817bff48.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: actualizar un panel de control 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": " update from googlecloud" }
   

5. Defina el ID de entidad en Data Mapper como la entidad del panel de control. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 139.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "139" }
   

Ejemplo: actualizar una suite 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

5. Define el ID de entidad en Data Mapper como la entidad de TestSuite. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 22264.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "22264" }
   

Ejemplo: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Deployment" }
   

5. Defina el ID de entidad en Data Mapper como la entidad de DeploymentGroups. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 138.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "138" }
   

Ejemplo: actualizar un plan de pruebas 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "TestPlan_Update" }
   

5. En Data Mapper, asigna el ID de entidad a la entidad de TestPlan. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 104.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "104" }
   

Ejemplo: actualizar una 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

5. En Data Mapper, asigna el ID de entidad a la entidad TestRuns. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como 46.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": "46" }
   

Ejemplo: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   { "Name": "Projects Update" }
   

5. En Data Mapper, asigna el ID de entidad a la entidad de los proyectos. Para definir el ID de entidad, haz clic en Open Data Mapping Editor y, a continuación, introduce un valor similar al siguiente en el campo Input Value y elige EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

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

Ejemplo: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

5. Defina el ID de entidad en Data Mapper como la entidad de los entornos. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como { "Id": "9" }.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 9 }
   

Ejemplo: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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. Defina el ID de entidad en Data Mapper como la entidad de VariableGroups. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como { "Id": "12" }.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 12 }
   

Ejemplo: actualizar una definición de 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija 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. Asigna el ID de entidad en Data Mapper a la entidad de BuildDefinition. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   { "Id": 25 }
   

Ejemplo: actualizar un revisor de una 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   {"isFlagged": true}
   

5. Define el ID de entidad en Data Mapper como la entidad de PullRequestReviewers. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

   Al ejecutar este ejemplo, se devuelve 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: actualizar 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, a continuación, haz clic en Hecho.
4. En la sección Data Mapper (Asignador de datos) de la tarea Data Mapping (Asignación de datos), haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

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

5. Define el ID de entidad en Data Mapper como la entidad de los lanzamientos. Para definir el ID de entidad, haga clic en Open Data Mapping Editor y, a continuación, introduzca un valor similar al siguiente en el campo Input Value y elija EntityId/ConnectorInputPayload/FilterClause como variable local.

   En lugar de especificar el entityId, también puede definir filterClause como {"Id": 13}.

   Al ejecutar este ejemplo, se devuelve una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {"Id": 13 }