Azure DevOps

Mit dem Azure DevOps-Connector können Sie Vorgänge zum Einfügen, Löschen, Aktualisieren und Lesen in Azure DevOps-Daten ausführen.

Unterstützte Versionen

Dieser Connector unterstützt die folgenden Azure DevOps-Versionen.

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

Hinweise

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

  • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Informationen zu Netzwerkmustern finden Sie unter Netzwerkkonnektivität.
  • Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
  • Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu.
  • Aktivieren Sie die folgenden Dienste:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    Informationen zum Aktivieren von Diensten finden Sie unter Dienste aktivieren. Wenn diese Dienste oder Berechtigungen für Ihr Projekt zuvor nicht aktiviert wurden, werden Sie aufgefordert, sie beim Konfigurieren des Connectors zu aktivieren.

Connector konfigurieren

Eine Verbindung ist für eine Datenquelle spezifisch. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

  1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Seite „Verbindungen“

  2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
  3. Wählen Sie im Abschnitt Standort den Standort für die Verbindung aus.
    1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

    2. Tippen Sie auf Weiter.
  4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
    1. Connector: Wählen Sie Azure DevOps aus der Drop-down-Liste der verfügbaren Connectors aus.
    2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

      Verbindungsnamen müssen die folgenden Kriterien erfüllen:

      • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
      • Buchstaben müssen Kleinbuchstaben sein.
      • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
      • Verbindungsnamen dürfen maximal 49 Zeichen haben.
    4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
    5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
    6. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
    7. Konfigurieren Sie optional die Verbindungsknoteneinstellungen:

      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

    8. Azure-Mandant: Geben Sie den Namen oder die ID des Azure DevOps-Mandanten an.
    9. Organisation: Geben Sie den Namen der Organisation oder Sammlung an, die Azure DevOps verwendet.
    10. Schema: Geben Sie das Schema ein, z. B. „Informationen“ oder „Projekt“.
    11. Katalog: Geben Sie den Namen des Katalogs ein.
    12. Transformation anwenden: Geben Sie eine durch Kommas getrennte Liste von Transformationen ein.
    13. Azure DevOps-Version: Geben Sie die Version von Azure DevOps ein.
    14. Azure DevOps Service API: Geben Sie die REST API-Version von Azure DevOps ein.
    15. URL: Geben Sie die URL der Azure DevOps-Instanz an.
    16. Benutzerdefinierte Felder einbeziehen: Wählen Sie diese Option aus, um benutzerdefinierte Felder in die Spaltenliste aufzunehmen.
    17. Klicken Sie optional auf + LABEL HINZUFÜGEN, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
    18. Tippen Sie auf Weiter.
  5. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
    1. Zieltyp: Wählen Sie einen Zieltyp aus.
      • Wenn Sie den Zielhostnamen oder die Ziel-IP-Adresse angeben möchten, wählen Sie Hostadresse aus und geben Sie die Adresse in das Feld Host 1 ein.
      • Wenn Sie eine private Verbindung herstellen möchten, wählen Sie Endpunktanhang aus und wählen Sie den erforderlichen Anhang aus der Liste Endpunktanhang aus.

      Wenn Sie eine öffentliche Verbindung zu Ihren Back-End-Systemen mit zusätzlicher Sicherheit herstellen möchten, können Sie statische ausgehende IP-Adressen für Ihre Verbindungen konfigurieren und dann Ihre Firewallregeln konfigurieren, um nur bestimmte statische IP-Adressen zuzulassen.

      Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + ZIEL HINZUFÜGEN.

    2. Tippen Sie auf Weiter.
  6. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
    1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

      Die folgenden Authentifizierungstypen werden von der Azure DevOps-Verbindung unterstützt:

      • AzureAD
      • Einfach
    2. Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

    3. Tippen Sie auf WEITER.
  7. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
  8. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

  • AzureAD
    • ClientID: Geben Sie die Client-ID für die von Ihnen erstellte App ein.
    • Bereiche: Geben Sie alle Bereiche durch Kommas getrennt an, z. B. „read, write“.
    • Clientschlüssel: Geben Sie das Secret Manager-Secret mit dem Clientschlüssel für die verbundene App ein, die Sie erstellt haben.
    • Secret-Version: Wählen Sie die Secret-Version für das oben ausgewählte Secret aus.
    • Autorisierungs-URL: Geben Sie die Autorisierungs-URL des Clients an.
  • Basic
    • Persönliches Zugriffstoken: Geben Sie das generierte persönliche Zugriffstoken ein.
    • Secret-Version: Wählen Sie die Secret-Version für das eingegebene Secret aus.

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt werden die Beispielwerte für die verschiedenen Felder aufgeführt, die Sie beim Erstellen der Verbindung konfigurieren.

In Azure DevOps werden verschiedene Datenschemas verwendet, um unterschiedliche Aspekte eines Projekts zu organisieren und zu verwalten. Jedes Schema konzentriert sich auf einen bestimmten Datentyp, um Informationen entsprechend den Projektanforderungen effektiv zu strukturieren.

  • Projektdatenmodell: Ein Schema, das definiert, wie projektbezogene Daten wie Elemente, Repositorys, Pipelines und Teams in Azure DevOps organisiert, verknüpft und verwaltet werden.
  • Informationsdatenmodell: Ein Schema, das definiert, wie Dokumentation, Metadaten und Kommunikationsartefakte in Azure DevOps-Projekten strukturiert, gespeichert und darauf zugegriffen wird.
  • Repository-Datenmodell: Ein Schema, das definiert, wie Code-Repositories, Branches, Commits, Pull-Anfragen und zugehörige Metadaten in Azure DevOps organisiert und verwaltet werden.
  • Analytics-Datenmodell: Ein Schema, das Verlaufs- und Echtzeitdaten aus Azure DevOps für Berichte, Dashboards und erweiterte Analysen erfasst und organisiert.
  • Alle Datenmodelle: Eine einzelne Verbindung, die Zugriff auf alle Datenmodelle bietet.
Feldname Informationsmodell Projektmodell Repository-Modell Analytics-Modell Alle Modelle AzureAD-Verbindung
Standorteurope-west1europe-west1europe-west1europe-west1asia-east1europe-west1
ConnectorAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOpsAzure DevOps
Connector-Version111111
Verbindungsnameazuredevops-informationmodelazuredevops-projectmodelazuredevops-repositorymodelazuredevops-analyticsmodeldevopsazuredevops-oauth
Cloud Logging aktivierenJaJaJaJaJaJa
ProtokollebeneFehlerbehebungFehlerbehebungFehlerbehebungFehlerbehebungFehlerbehebungFehlerbehebung
DienstkontoYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccountYour_Project_Number@serviceaccount
Azure-MandantTenant_IdTenant_IdTenant_IdTenant_IdTenant_IdTenant_Id
OrganisationOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_NameOrganization_Name
SchemaInformationenProjektRepository__RepositoryIdAnalyticsProjekt
KatalogDevopsProject_ProjectIdProject_ProjectIdProject_ProjectIdProject_ProjectId
Azure DevOps-VersionAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps OnlineAzureDevOps Online
Azure DevOps Service API6.06.06.06.06.06.0
Benutzerdefinierte Felder einbeziehenJaJaJaJaJaJa
CustomizedDefaultCatalogNameCustomizedDefaultCatalogName=GoogleCustomizedDefaultCatalogName=Google
Mindestanzahl von Knoten222222
Maximale Anzahl von Knoten505050505050
AuthentifizierungJaJaJaJaJaJa
EinfachJaJaJaJaJa
API-TokenVon Ihrer App bereitgestelltes API-TokenVon Ihrer App bereitgestelltes API-TokenVon Ihrer App bereitgestelltes API-TokenVon Ihrer App bereitgestelltes API-TokenVon Ihrer App bereitgestelltes API-Token
Secret-Version111111
AzureADJa
Client-IDClient_Id
ClientschlüsselwertClientschlüsselwert
Bereicheuser_impersonation
Autorisierungs-URLhttps://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

Mit den folgenden Verbindungseigenschaften können Sie Daten verwalten, die aus Azure DevOps abgerufen werden.

Katalog

Mit dieser Eigenschaft wird der Name oder die ID des Projekts angegeben, mit dem Sie eine Verbindung herstellen möchten. Wenn Sie eine Liste mit Projekt-IDs und ‑Namen abrufen möchten, führen Sie eine SELECT-Abfrage für die Tabelle „Projects“ aus.

  • Wenn Sie Daten für ein bestimmtes Projekt abfragen möchten, legen Sie Catalog auf den Projektnamen oder die Projekt-ID im Format Project_projectname fest.
    Wenn der Projektname dev mit der ID 2ee729d6-804d-4ece-84af-d5befa94abe8 ist, legen Sie Catalog auf Project_dev oder Project_2ee729d6-804d-4ece-84af-d5befa94abe8 fest.
  • Wenn Sie Daten abfragen möchten, die unabhängig von einem bestimmten Projekt sind, legen Sie Katalog auf DevOps fest. Wenn der Katalogname Devops lautet, können Sie anstelle von Devops einen beliebigen Namen verwenden.

Schema

Mit diesem Attribut wird das zu verwendende Schema angegeben. Die verfügbaren Schemas hängen vom angegebenen Repository ab. Wenn Sie eine Liste mit Repository-IDs und ‑Namen abrufen möchten, führen Sie eine SELECT-Abfrage für die Tabelle Repositories aus.

  • Wenn Sie in der Verbindungskonfiguration Katalog und Schema auf INFORMATION festlegen, haben Sie nur Zugriff auf das Information Data Model-Schema. Andere Projektkataloge oder ‑schemata werden nicht verfügbar gemacht.
  • Wenn Katalog auf einen Projektkatalog festgelegt ist, können Sie Schema auf Analytics, Project oder eines der Repository-Schemas festlegen. Nachdem Sie das entsprechende Schema ausgewählt haben, können Sie Daten in einem bestimmten Repository abfragen.
    Wenn Sie Daten aus einem Repository mit der ID 3ee729d6-804d-4ece-84af-d5befa94abe8 abfragen möchten, legen Sie Katalog auf Repository_3ee729d6-804d-4ece-84af-d5befa94abe8 fest.

Informationen zum Erstellen einer Anwendung im Azure-Portal/MS Entra und zum Verwenden aller Parameter der erstellten Anwendung auf Azure AD-Verbindungsebene finden Sie unter Schnellstart: Registrieren einer Anwendung bei der Microsoft-Identitätsplattform und Registrieren einer Clientanwendung in Microsoft Entra ID.

Systembeschränkungen

Der Azure DevOps-Connector kann maximal 6 Transaktionen pro Sekunde und Knoten verarbeiten. Alle Transaktionen, die dieses Limit überschreiten, werden gedrosselt. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Azure DevOps-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

Aktionen

In diesem Abschnitt werden die vom Connector unterstützten Aktionen aufgeführt. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

Aktion „CreateWorkItem“

Durch diese Aktion wird ein Arbeitselement erstellt.

Eingabeparameter der Aktion „CreateWorkItem“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
Typ String Ja Der Typ des zu erstellenden Arbeitselements.
Von String Nein Der Quellpfad für den Kopiervorgang oder den Verschiebevorgang.
Op String Ja Der Patch-Vorgang, mit dem das Arbeitselement geändert wird, z. B. „add“, „copy“, „move“, „remove“, „replace“ oder „test“.
Pfad String Ja Der Pfad für den Vorgang.
Wert String Ja Der Wert für den Vorgang.

Beispiele für die Konfiguration der Aktion CreateWorkItem finden Sie unter Beispiele.

Aktion „UpdateWorkItem“

Eingabeparameter der Aktion „UpdateWorkItem“

Mit dieser Aktion wird ein Arbeitselement aktualisiert.

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
WorkItemId String Ja Die ID des Arbeitselements.
Von String Nein Der Quellpfad für den Kopiervorgang oder den Verschiebevorgang.
Op String Ja Der Patch-Vorgang, mit dem das Arbeitselement geändert wird, z. B. „add“, „copy“, „move“, „remove“, „replace“ oder „test“.
Pfad String Ja Der Pfad für den Vorgang.
Wert String Ja Der Wert für den Vorgang.

Beispiele für die Konfiguration der Aktion UpdateWorkItem finden Sie unter Beispiele.

GetPullRequestCommits-Aktion

Mit dieser Aktion werden die Commits für den angegebenen Pull Request abgerufen.

Eingabeparameter der Aktion „GetPullRequestCommits“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID oder der Name des Repositorys. Wenn die ProjectId nicht festgelegt ist, müssen Sie die RepositoryId festlegen.
PullRequestId String Ja Die ID der Pull-Anfrage.

Ausgabeparameter der Aktion „GetPullRequestCommits“

Beispiele für die Konfiguration der Aktion GetPullRequestCommits finden Sie unter Beispiele.

Aktion „PushChanges“

Mit dieser Aktion werden Änderungen per Push an ein Repository in Ihrer Azure DevOps-Instanz übertragen.

Eingabeparameter der PushChanges-Aktion

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID oder der Name des Repositorys. Wenn die ProjectId nicht festgelegt ist, müssen Sie die RepositoryId festlegen.
BranchRefName String Ja Der Name des Git-Branch.
OldObjectId String Ja Die aktuelle Objekt-ID des Zweigs.
CommitComment String Ja Gibt den im Commit enthaltenen Kommentar an.
ChangesAggregate String Ja Ein zusammenfassendes Objekt, das Details zu jeder Änderung im Commit enthält.

Beispiele für die Konfiguration der Aktion PushChanges finden Sie unter Beispiele.

Aktion „DownloadReleaseLogs“

Durch diese Aktion werden die Logs für die jeweilige Version heruntergeladen.

Eingabeparameter der Aktion „DownloadReleaseLogs“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
ReleaseId Ganzzahl Ja Die ID des Releases.
FileLocation String Nein Der Speicherort der Datei.
Codierung String Nein Der Codierungstyp der FileData-Eingabe. Die zulässigen Werte sind NONE und BASE64. Der Standardwert ist BASE64.
FileStream String Nein Eine Instanz eines Ausgabestreams, in den Dateidaten geschrieben werden. Wird nur verwendet, wenn „FileLocation“ nicht angegeben ist.

Beispiele für die Konfiguration der Aktion DownloadReleaseLogs finden Sie unter Beispiele.

Aktion „DownloadTestAttachment“

Durch diese Aktion wird eine Anlage für ein Testergebnis oder einen Testlauf heruntergeladen.

Eingabeparameter der Aktion „DownloadTestAttachment“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
ResultId Ganzzahl Nein Die ID des Testergebnisses.
RunId Ganzzahl Ja Die ID des Testlaufs.
AttachmentId String Nein Die ID des Anhangs.
FileLocation String Nein Der Speicherort der Datei.
Codierung String Nein Der Codierungstyp der FileData-Eingabe. Die zulässigen Werte sind NONE und BASE64. Der Standardwert ist BASE64.
FileStream String Nein Eine Instanz eines Ausgabestreams, in den Dateidaten geschrieben werden. Wird nur verwendet, wenn „FileLocation“ nicht angegeben ist.

Beispiele für die Konfiguration der Aktion DownloadTestAttachment finden Sie unter Beispiele.

Aktion „SetProjectProperties“

Mit dieser Aktion können Teambereichsprojekteigenschaften erstellt, aktualisiert und gelöscht werden.

Eingabeparameter der Aktion „SetProjectProperties“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
Von String Nein Der Quellpfad für den Verschiebungs- oder Kopiervorgang.
Op String Ja Der Patch-Vorgang, mit dem die Projekteigenschaften geändert werden, z. B. „add“, „copy“, „move“, „remove“, „replace“ oder „test“.
Pfad String Ja Der Pfad für den Vorgang.
Wert String Ja Der Wert für den Vorgang.

Beispiele für die Konfiguration der Aktion SetProjectProperties finden Sie unter Beispiele.

DeleteTestCase-Aktion

Durch diese Aktion wird der Testlauf gelöscht.

Eingabeparameter der Aktion „DeleteTestCase“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
TestcaseId Ganzzahl Ja Die ID des Testlaufs.

Beispiele für die Konfiguration der Aktion DeleteTestCase finden Sie unter Beispiele.

RunPipeline-Aktion

Bei dieser Aktion wird eine Pipeline mit der angegebenen Konfiguration ausgeführt.

Eingabeparameter der RunPipeline-Aktion

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
PipelineId Ganzzahl Ja Die ID der Pipeline.
PipelineVersion Ganzzahl Nein Die Version der Pipeline, die ausgeführt werden soll.
Ressourcen String Ja Die Ressourcen, die für den Lauf erforderlich sind.
Variablen String Nein Die Liste der Variablen und Werte, die während der Pipelineausführung verwendet werden sollen.
StagesToSkip String Nein Das Array der Stufennamen, die übersprungen werden sollen.
TemplateParameters String Nein Eine Schlüssel/Wert-Zuordnung von Parametern, die während der Pipelineausführung verwendet werden.

Beispiele für die Konfiguration der Aktion RunPipeline finden Sie unter Beispiele.

CreatePullRequest-Aktion

Mit dieser Aktion wird ein Pull-Request mit der angegebenen Konfiguration erstellt.

Eingabeparameter der Aktion „CreatePullRequest“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID des Repositorys.
Titel String Ja Titel der Pull-Anfrage.
Beschreibung String Nein Die Beschreibung der Pull-Anfrage.
SourceRefName String Ja Der Name des Quell-Branch der Pull-Anfrage.
TargetRefName String Ja Der Name des Ziel-Branch der Pull-Anfrage.
CompletionOptions String Nein Optionen, die sich darauf auswirken, wie die Pull-Anfrage zusammengeführt wird, wenn sie abgeschlossen ist.
IsDraft Boolesch Nein Pull-Anfrage als Entwurf / WIP
Labels String Nein Die mit der Pull-Anfrage verknüpften Labels.
MergeOptions String Nein Optionen, die beim Zusammenführen der Pull-Anfrage verwendet werden.
Rezensenten String Nein Eine Liste der Prüfer der Pull-Anfrage.
WorkItemRefs String Nein Alle Arbeitsaufgabenreferenzen, die mit dieser Pull-Anfrage verknüpft sind.

Beispiele für die Konfiguration der Aktion CreatePullRequest finden Sie unter Beispiele.

UpdatePullRequest-Aktion

Mit dieser Aktion wird ein Pull-Request mit der angegebenen Konfiguration aktualisiert.

Eingabeparameter der Aktion „UpdatePullRequest“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID des Repositorys.
PullRequestId String Ja Die ID der Pull-Anfrage.
Titel String Nein Titel der Pull-Anfrage.
Beschreibung String Nein Die Beschreibung der Pull-Anfrage.
Status String Nein Status der Pull-Anfrage.
TargetRefName String Nein Der Name des Ziel-Branch der Pull-Anfrage. Nur verfügbar, wenn die Funktion für das Retargeting von Produkten aktiviert ist.
CompletionOptions String Nein Optionen, die sich darauf auswirken, wie die Pull-Anfrage zusammengeführt wird, wenn sie abgeschlossen ist.
MergeOptions String Nein Optionen, die beim Zusammenführen der Pull-Anfrage verwendet werden.
AutoCompleteSetById String Nein ID des Nutzers, der die automatische Vervollständigung aktiviert hat.

Beispiele für die Konfiguration der Aktion UpdatePullRequest finden Sie unter Beispiele.

GetPullRequestCommits-Aktion

Mit dieser Aktion werden die Commits für den angegebenen Pull-Request mit der angegebenen Konfiguration abgerufen.

Eingabeparameter der Aktion „GetPullRequestCommits“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID des Repositorys.
PullRequestId String Ja ID der Pull-Anfrage.

Beispiele für die Konfiguration der Aktion GetPullRequestCommits finden Sie unter Beispiele.

AddBuildTag-Aktion

Mit dieser Aktion wird einem Build ein Tag hinzugefügt.

Eingabeparameter der Aktion „AddBuildTag“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
BuildId String Ja Die ID des Builds.
Tag String Ja Das Tag, das dem Build hinzugefügt werden soll.

Beispiele für die Konfiguration der Aktion AddBuildTag finden Sie unter Beispiele.

DeleteBuildTag-Aktion

Mit dieser Aktion wird ein Tag aus einem Build gelöscht.

Eingabeparameter der Aktion „DeleteBuildTag“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
BuildId String Ja Die ID des Builds.
Tag String Ja Das Tag, das aus dem Build entfernt werden soll.

Beispiele für die Konfiguration der Aktion DeleteBuildTag finden Sie unter Beispiele.

Aktion „DownloadBuildReports“

Durch diese Aktion werden Build-Berichte heruntergeladen.

Eingabeparameter der Aktion „DownloadBuildReports“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
BuildId Ganzzahl Ja Die ID des Builds.
FileLocation String Nein Der Speicherort der Datei.
Codierung String Nein Der Codierungstyp der FileData-Eingabe. Die zulässigen Werte sind NONE und BASE64. Der Standardwert ist BASE64.
FileStream String Nein Eine Instanz eines Ausgabestreams, in den Dateidaten geschrieben werden. Wird nur verwendet, wenn „FileLocation“ nicht angegeben ist.

Beispiele für die Konfiguration der Aktion DownloadBuildReports finden Sie unter Beispiele.

Aktion „DownloadBuildLogs“

Mit dieser Aktion werden Build-Logs heruntergeladen.

Eingabeparameter der Aktion „DownloadBuildLogs“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Ja Die ID des Azure DevOps-Projekts.
BuildId Ganzzahl Ja ID des Builds.
LogId Ganzzahl Ja Die ID des Logs.
StartLine Ganzzahl Nein Die Startzeile des Builds.
EndLine Ganzzahl Nein Die letzte Zeile des Builds.
FileLocation String Nein Der Speicherort der Datei.
Codierung String Nein Der Codierungstyp der FileData-Eingabe. Die zulässigen Werte sind NONE und BASE64. Der Standardwert ist BASE64.
FileStream String Nein Eine Instanz eines Ausgabestreams, in den Dateidaten geschrieben werden. Wird nur verwendet, wenn „FileLocation“ nicht angegeben ist.

Beispiele für die Konfiguration der Aktion DownloadBuildLogs finden Sie unter Beispiele.

Aktion „UpdateUser“

Mit dieser Aktion werden die Nutzerdetails aktualisiert.

Eingabeparameter der Aktion „UpdateUser“

Parametername Datentyp Erforderlich Beschreibung
UserId String Ja Die ID des Nutzers.
Von String Nein Der Quellpfad für den Verschiebungs- oder Kopiervorgang.
Op String Ja Der Patchvorgang, mit dem der Nutzer geändert wird, z. B. „add“, „copy“, „move“, „remove“, „replace“ oder „test“.
Pfad String Nein Der Pfad für den Vorgang.
Wert String Nein Der Wert für den Vorgang.

Beispiele für die Konfiguration der Aktion UpdateUser finden Sie unter Beispiele.

Aktion „CloneTestPlan“

Durch diese Aktion wird ein Testplan geklont.

Eingabeparameter der Aktion „CloneTestPlan“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Nein Die ID des Azure DevOps-Projekts.
DeepClone Boolesch Nein Dabei werden auch alle zugehörigen Testläufe geklont.
CloneRequirements Boolesch Nein Wenn auf „true“ gesetzt, werden die Anforderungen geklont. Der Standardwert ist „false“.
CopyAllSuites Boolesch Nein Kopiert alle Testgruppen aus einem Quellplan.
CopyAncestorHierarchy Boolesch Nein Übergeordnete Hierarchie kopieren
DestinationWorkItemType String Nein Name des Arbeitsvorgangstyps des Klons.
OverrideParameters String Nein Schlüssel/Wert-Paare, in denen der Wert jedes Schlüssels durch den angegebenen Wert überschrieben wird.
RelatedLinkComment String Nein Fügt dem geklonten Testplan einen Kommentar hinzu.
DestinationPlanAreaPath String Nein Bereich des Testplans.
DestinationPlanBuildId String Nein Erstellen Sie die App so, dass sie getestet werden kann.
DestinationPlanDescription String Nein Die Beschreibung des Testplans.
DestinationPlanEndDate String Nein Das Enddatum für den Testplan.
DestinationPlanIteration String Nein Der Iterationspfad des Testplans.
DestinationPlanName String Ja Der Name des Testplans.
DestinationPlanOwnerId String Nein Die Nutzer-ID des Inhabers des Testplans.
DestinationPlanProject String Nein Der Projektname des Ziels.
DestinationPlanStartDate String Nein Das Startdatum des Testplans.
DestinationPlanState String Nein Der Status des Testplans.
DestinationPlanSync Boolesch Nein Gibt an, wie sich doppelte Tests in verschiedenen Suiten in einem Testplan verhalten müssen.
SourceTestPlanId Ganzzahl Ja Die ID des Quelltestplans.
SourceTestPlanSuiteId Ganzzahl Nein Eine durch Kommas getrennte Liste von Test-Suite-IDs, die im Quelltestplan geklont werden sollen.

Beispiele für die Konfiguration der Aktion CloneTestPlan finden Sie unter Beispiele.

Aktion „CloneTestSuite“

Bei dieser Aktion werden die Details der Testsuite geklont.

Eingabeparameter der CloneTestSuite-Aktion

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Nein Die ID des Azure DevOps-Projekts.
DeepClone Boolesch Nein Alle zugehörigen Testläufe werden geklont.
CloneRequirements Boolesch Nein Wenn auf „true“ gesetzt, werden die Anforderungen geklont. Der Standardwert ist „false“.
CopyAllSuites Boolesch Nein Kopiert alle Testgruppen aus einem Quellplan.
CopyAncestorHierarchy Boolesch Nein Kopiert die übergeordnete Hierarchie.
DestinationWorkItemType String Nein Der Name des Arbeitsaufgaben-Typs für den Klon.
OverrideParameters String Nein Schlüssel/Wert-Paare, in denen der Wert jedes Schlüssels durch den angegebenen Wert überschrieben wird.
RelatedLinkComment String Nein Fügt der geklonten Testsuite einen Kommentar hinzu.
DestinationTestSuiteId Ganzzahl Ja Die ID der Zieltestsuite.
DestinationProjectName String Nein Der Projektname am Zielort.
SourceTestSuiteId Ganzzahl Ja Die ID der Quelltestsuite.

Beispiele für die Konfiguration der Aktion CloneTestSuite finden Sie unter Beispiele.

Aktion „CloneTestCase“

Bei dieser Aktion werden Testfalldetails geklont.

Eingabeparameter der Aktion „CloneTestCase“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Nein Die ID des Azure DevOps-Projekts.
IncludeAttachments Boolesch Nein Enthält Anhänge eines Testlaufs, wenn „true“ festgelegt ist. Der Standardwert ist „false“.
IncludeLinks Boolesch Nein Wenn „true“ festgelegt ist, werden die Links eingefügt. Der Standardwert ist „false“.
RelatedLinkComment String Nein So fügen Sie dem geklonten Testlauf einen Kommentar hinzu:
DestinationTestPlanId Ganzzahl Ja Die ID des Zieltestplans.
DestinationTestSuiteId Ganzzahl Ja Die ID der Zieltestsuite.
SourceTestPlanId Ganzzahl Ja Die ID des Quelltestplans.
SourceTestSuiteId Ganzzahl Ja Die ID der Quelltestsuite.
TestCaseId Ganzzahl Ja Eine durch Kommas getrennte Liste mit Testlauf-IDs, die geklont werden sollen.

Beispiele für die Konfiguration der Aktion CloneTestCase finden Sie unter Beispiele.

Aktion „DeletePullRequestAttachment“

Durch diese Aktion werden Details zu Pull-Request-Anhängen gelöscht.

Eingabeparameter der Aktion „DeletePullRequestAttachment“

Parametername Datentyp Erforderlich Beschreibung
ProjectId String Nein Die ID des Azure DevOps-Projekts.
RepositoryId String Ja Die ID des Repositorys.
PullRequestId Ganzzahl Ja Die ID der Pull-Anfrage.
FileName String Ja Der Name des Attachments.

Beispiele für die Konfiguration der Aktion DeletePullRequestAttachment finden Sie unter Beispiele.

Beispiele für Aktionen

Beispiel: Arbeitselement erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CreateWorkItem aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CreateWorkItem-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
    "Success": "True"
    }]
    

Wenn Sie verschiedene Entitäten wie Aufgabe, Epic, User Story, Testlauf, Funktion und Problem erstellen möchten, müssen Sie nur den Wert des Felds „Type“ in der Eingabe-Payload ändern.
Wenn Sie den Typ auf „Epic“ festlegen möchten, können Sie "Type": "Epic" festlegen. Sie können den Wert auch in „Typ“: „Aufgabe“, „Typ“: „User Story“, „Typ“: „Testlauf“, „Typ“: „Funktion“ oder „Typ“: „Problem“ ändern, um die entsprechende Einheit zu erstellen.

Beispiel: Arbeitsaufgabe aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion UpdateWorkItem aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UpdateWorkItem-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{
    "Success": "True"
    }]
    

Beispiel: Pull-Anfrage für einen Commit abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion GetPullRequestCommits aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des GetPullRequestCommits-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Änderungen per Push in ein Repository übertragen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion PushChanges aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "BranchRefName": "refs/heads/US_Googlecloud_Push1", "OldObjectId": "4d66aafb75efda2bbdda7a2b609b152b1b715b7e", "CommitComment": "Googlecloud PUSH Changes", "ChangesAggregate": "{\n \"changeType\": \"edit\",\n \"item\": {\n \"path\": \"/tasks.md\"\n },\n \"newContent\": {\n \"content\": \"# Tasks\\n\\n* Item 1\\n* Item 2\",\n \"contentType\": \"rawtext\"\n }\n }" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des PushChanges-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Logs eines Releases herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadReleaseLogs aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadReleaseLogs-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Anhang eines Testergebnisses oder Testlaufs herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadTestAttachment aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadTestAttachment-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Projekteigenschaften festlegen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion SetProjectProperties aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des SetProjectProperties-Vorgangs einen Wert, der dem folgenden ähnelt:

    [ { "Status": "Success" } ]
    

Beispiel: Testlauf löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeleteTestCase aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteTestCase-Vorgangs einen Wert, der dem folgenden ähnelt:

    [ { "Status": "Success" } ]
    

Beispiel: Pipeline für ein Projekt ausführen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion RunPipeline aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "PipelineId": 7, "Resources": "{\n \"repositories\": {\n \"self\": {\n \"refName\": \"refs/heads/main\" // Specify the branch or tag\n }\n }\n }" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des RunPipeline-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Pull-Anfrage aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion UpdatePullRequest aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": "26", "Description": "updated pull req", "Title": "Googlecloud M pull request" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des UpdatePullRequest-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Pull-Anfrage erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CreatePullRequest aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "Title": "Googlecloud M pull request", "SourceRefName": "refs/heads/Test_Branch", "TargetRefName": "refs/heads/main" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CreatePullRequest-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Commit einer Pull-Anfrage abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion GetPullRequestCommits aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des GetPullRequestCommits-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Build-Tag hinzufügen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion AddBuildTag aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AddBuildTag-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{ "Status": "Success" }]
    

Beispiel: Build-Tag löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeleteBuildTag aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeleteBuildTag-Vorgangs einen Wert, der dem folgenden ähnelt:

    [{ "Status": "Success" }] 
    

Beispiel: Build-Bericht herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadBuildReports aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadBuildReports-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Build-Logs herunterladen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DownloadBuildLogs aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DownloadBuildLogs-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Nutzer aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion UpdateUser aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "UserId": "088a8c28-1b83-4538-9c74-b7ca97eb4ef2", "Op": "add", "Path": "/projectEntitlements/50fac9d4-37aa-4a13-a81a-887d12be7b9f", "Value": "{ \"projectRef\": {\n \"id\": \"50fac9d4-37aa-4a13-a81a-887d12be7b9f\",\n \"name\": \"Postman_Testing_Project\"\n }, \n \"group\": {\n \"groupType\": \"projectContributor\"\n }}" }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Update User-Vorgangs einen Wert, der dem folgenden ähnelt:

    [ { "Status": "Success" } ]
    

Beispiel: Testplan klonen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CloneTestPlan aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "CloneRequirements": true, "CopyAllSuites": true, "RelatedLinkComment": "Cloned from existing test plan googlecloud", "DestinationPlanName": "TestPlan 2", "DestinationPlanAreaPath": "GCPTesting_New_Project", "DestinationPlanIteration": "GCPTesting_New_Project", "DestinationPlanProject": "GCPTesting_New_Project", "SourceTestPlanId": 1, "CopyAncestorHierarchy": true }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CloneTestPlan-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Testsuite klonen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CloneTestSuite aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CloneTestSuite-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel: Testlauf klonen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion CloneTestCase aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
    
  4. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des CloneTestCase-Vorgangs einen Wert, der dem folgenden ähnelt:

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

Beispiel – Pull-Request-Anhang löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
  2. Wählen Sie die Aktion DeletePullRequestAttachment aus und klicken Sie auf Fertig.
  3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }
    
  4. Diese Aktion gibt eine Bestätigungsmeldung für DeletePullRequestAttachment zurück. Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des DeletePullRequestAttachment-Vorgangs einen Wert ähnlich dem folgenden:

    [ { "Status": "Success" } ]
    

Beispiele für Entitätsvorgänge

Alle Dashboards in einem Projekt abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Dashboards aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
  4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause gemäß den Kundenanforderungen festlegen. Weitere Informationen finden Sie im Abschnitt „Hinweis“ unten.

  5. Der Wert für filterClause sollte immer in einfachen Anführungszeichen (') in diesem Format übergeben werden.
    Mit der filterClause können Sie bestimmte Datensätze anhand beliebiger Spalten filtern.

Beispiel: Einzelnes Dashboard anhand der ID abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Dashboards aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Legen Sie die Entitäts-ID auf „2f671e29-e48f-4d26-8869-859e154b5f20“ fest. Dies ist der zu übergebende Schlüssel. Klicken Sie zum Festlegen der Entitäts-ID im Abschnitt Data Mapper des Data Mapping auf Open Data Mapping Editor und geben Sie dann "2f671e29-e48f-4d26-8869-859e154b5f20" in das Feld Input Value ein. Wählen Sie „EntityId“ als lokale Variable aus.

    Der Wert für „Entity ID“ sollte direkt übergeben werden, z. B. „2f671e29-e48f-4d26-8869-859e154b5f20“. Hier ist „2f671e29-e48f-4d26-8869-859e154b5f20“ der eindeutige Primärschlüsselwert, der übergeben wird.

    In einigen Fällen kann das Übergeben einer einzelnen Entitäts-ID einen Fehler verursachen, da die Entität zwei zusammengesetzte Schlüssel hat. In solchen Fällen können Sie filterClause verwenden und den Wert übergeben, z. B. id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Beispiel: Dashboard anhand der ID entfernen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Dashboards aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
  4. Legen Sie die Entitäts-ID auf „2f671e29-e48f-4d26-8869-859e154b5f20“ fest. Dies ist der Schlüssel, der übergeben werden soll. Klicken Sie zum Festlegen der Entitäts-ID im Abschnitt Data Mapper des Data Mapping auf Open Data Mapping Editor und geben Sie dann "2f671e29-e48f-4d26-8869-859e154b5f20" in das Feld Input Value ein. Wählen Sie „EntityId“ als lokale Variable aus.

    Wenn eine Entität zwei zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId die filterClause auf id='2f671e29-e48f-4d26-8869-859e154b5f20' festlegen.

Beispiel: Neues Dashboard in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Dashboard aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Neue Nutzerberechtigung in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Users aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Neue Abfrage in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Queries aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "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" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Neue Pipeline in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Pipelines aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": 9 }
    

Beispiel: Bereitstellungsgruppe in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie DeploymentGroups aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "Deployment group 2 Googlecloud" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": 139 }
    

Beispiel: Neue Testkonfiguration in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestPlan aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "Googlecloud_TestPlan" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": 106 }
    

Beispiel: Testsuite in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestSuite aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": 22264 }
    

Beispiel: Testlauf in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestRun aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "TestRun_Googlecloud1"}
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": 46 }
    

Beispiel: Neues Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Projects aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des Projects-Vorgangs einen Wert, der dem folgenden ähnelt:

    { "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
    
  5. Die ID, die nach dem Ausführen des Vorgangs „Create“ für ein Projekt generiert wird, ist nicht die tatsächliche Projekt-ID.
    Wenn Sie die genauen Projektdetails abrufen möchten, müssen Sie den List-Vorgang mit dem Projektnamen als Filterbedingung ausführen, z. B. Name= 'Google Project Integration'.

Beispiel: Team in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Teams aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "M new team"}
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Umgebung in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Environments aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": "9" }
    

Beispiel: Neues Widget in einem Dashboard erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Widgets aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "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" }
    

    In diesem Beispiel wird gezeigt, wie Sie Widgets hinzufügen. Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Prüfer zu einer Pull-Anfrage in einem Repository hinzufügen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie PullRequestReviewers aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

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

Beispiel: Variablengruppe in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie VariableGroups aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    {
      "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"
    }

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    {"Id": "12"}
    

Beispiel: Neue Builddefinition in einem Repository erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie BuildDefinition aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    {"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    {"Id": "25"}
    

Beispiel: Release in einem Projekt erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Releases aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload“ als lokale Variable aus.
    { "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
    

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload der Connector-Aufgabe einen Wert, der dem folgenden ähnelt:

    { "Id": "13" }
    

Beispiel: Namen oder Beschreibung eines Teams in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Teams aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "M new team update" }
    
  5. Legen Sie die Entitäts-ID in Data Mapper für die Entität von Teams fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 5285fb98-a1bc-42e1-9668-3c2780061367 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

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

Beispiel: Abfrage in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Queries aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Update Queries" }
    
  5. Legen Sie die Entitäts-ID in Data Mapper für die Entität der Abfragen fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 81797017-624d-4967-bc85-842a817bff48 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

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

Beispiel: Dashboard in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Dashboard aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": " update from googlecloud" }
    
  5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität des Dashboards fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 139 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": "139" }
    

Beispiel: Testsuite in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestSuite aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "UPdated_Suite", "ParentSuiteId": 108 }
    
  5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der TestSuite fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 22264 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": "22264" }
    

Beispiel: Bereitstellungsgruppe in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie DeploymentGroups aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Deployment" }
    
  5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität der DeploymentGroups fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie EntityId/ConnectorInputPayload/FilterClause als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 138 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": "138" }
    

Beispiel: Testplan in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestPlan aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "TestPlan_Update" }
    
  5. Legen Sie die Entitäts-ID in Data Mapper auf die Entität des Testplans fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 104 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": "104" }
    

Beispiel: Testlauf in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie TestRuns aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
    
  5. Legen Sie die Entitäts-ID in Data Mapper für die Entität der Testläufe fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf 46 festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": "46" }
    

Beispiel: Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Projects aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Projects Update" }
    
  5. Legen Sie die Entitäts-ID in Data Mapper für die Entität der Projekte fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" } festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

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

Beispiel: Umgebung in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Environments aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Environment Update M", "Description": "Update environment " }
    
  5. Legen Sie die Entitäts-ID in Data Mapper für die Entität der Umgebungen fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf { "Id": "9" } festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": 9 }
    

Beispiel: Variablengruppe in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie VariableGroups aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    {
      "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. Legen Sie die Entitäts-ID in Data Mapper für die Entität der VariableGroups fest. Klicken Sie dazu auf Open Data Mapping Editor, geben Sie einen Wert ähnlich dem folgenden in das Feld Input Value ein und wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf { "Id": "12" } festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": 12 }
    

Beispiel: Build-Definition in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie BuildDefinition aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
    
  5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität der BuildDefinition fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'} festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    { "Id": 25 }
    

Beispiel: Prüfer einer Pull-Anfrage in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie PullRequestReviewers aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    {"isFlagged": true}
    
  5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität der PullRequestReviewers fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'} festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

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

Beispiel: Release in einem Projekt aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Releases aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.
    { "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
    
  5. Legen Sie die Entitäts-ID im Data Mapper auf die Entität der Veröffentlichungen fest. Klicken Sie zum Festlegen der Entitäts-ID auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Wählen Sie „EntityId/ConnectorInputPayload/FilterClause“ als lokale Variable aus.

    Anstelle der entityId können Sie auch die filterClause auf {"Id": 13} festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload des Connector-Tasks zurückgegeben:

    {"Id": 13 }
    

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte