Für die Konfiguration der Bereitstellung benötigen Sie Zugriff auf die Plattform-Konfigurationskonsole.

1. Öffnen Sie den Administrationsbereich (Zahnradsymbol).
2. Öffnen Sie die Konnektorenansicht.
3. Wählen Sie „Neuer Konnektor“.

4. Wählen Sie als Datenquellentyp „Generische REST API aus.

5. Geben Sie dem Konnektor einen Namen und fügen Sie die Verbindungseinstellungen hinzu:

• Konnektorname – Geben Sie Ihrem Konnektor einen aussagekräftigen Namen (der Name kann später geändert werden).
• Host-URL – Basis-URL für REST API . Diese kann als Präfix für die endgültige Aufruf-URL verwendet werden.
• REST Connector-Typ – Generisch auswählen
• Authentifizierungsmethode – Dynamisches Token auswählen

• Anmelde-URL: https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Anmeldetext (ändern Sie Ihre Client-ID und Ihr Client-Geheimnis, die anderen beiden Attribute haben feste Werte): client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Anmeldemethode: POST
• Anmeldeinhaltstyp: application/x-www-form-urlencoded
• Anmeldetoken gültig für (in Sekunden): 3598
• Anmelde-Header: Content-Type = application/x-www-form-urlencoded
• Token-Nutzung: Bearer @TOKEN@
• Token-Attribut in der Antwort: Zugriffstoken

6. Stellen Sie die korrekte Paginierung ein, wenn Sie diese Verbindung mit geplanten Aufgaben verwenden möchten.

7. WebAPI Benutzerinformationen bereitstellen

• WebAPI Benutzer – Wählen Sie den korrekten WebAPI Benutzer aus, der beim Schreiben von Daten aus einem externen System in Matrix42 Core , Pro and IGA Lösungen verwendet wird.
• WebAPI Passwort – Passwort für den WebAPI Benutzer

8. Steckerinformationen speichern

9. Fügen Sie ein externes Microsoft Azure DevOps-Stammzertifikat (HTTPS) hinzu, das von der Connector-Verwaltung (EPE) als vertrauenswürdig eingestuft werden soll. Dies kann nur über Matrix42 : Zertifikat hinzufügen erfolgen.

10. Matrix42 Core , Pro and IGA Lösung kann nun eine Verbindung zu Microsoft Azure DevOps herstellen.

• Im nächsten Schritt werden geplante Aufgaben zum Lesen von Daten oder Ereignisaufgaben zum Schreiben von Daten sowie Aktionen für Microsoft Azure DevOps konfiguriert.

Das Lesen von Daten aus Microsoft Azure DevOps mit geplanten Aufgaben wird derzeit nicht unterstützt . Grund dafür ist, dass Microsoft Azure DevOps eine Paginierungsmethode verwendet, die von unserem generischen REST API Connector nicht unterstützt wird. Der Antwortheader von Azure DevOps enthält ein x-ms-continuationtoken für die Paginierung.

Sie können aber weiterhin ein Objekt aus Azure DevOps lesen, indem Sie ereignisbasierte Aufgaben und den Workflow-Orchestrierungsknoten mit der Aktion GET verwenden.

Hier ist ein einfaches Beispiel für eine Ereignisaufgabe und einen Orchestrierungsknoten, die verwendet werden, um Tickets für Microsoft Azure DevOps zu erstellen.

1. Fügen Sie unter dem richtigen Connector eine ereignisbasierte Aufgabe hinzu, indem Sie auf „Neue Aufgabe“ klicken.

2. Attribute für die Aufgabe festlegen

Aufgabenname – beschreibender, eindeutiger Name
Aufgabennutzung - Ereignis
Zuordnungstyp – Generische Vorlage
Abfrage – URL der API , die Sie aufrufen möchten. In diesem Beispiel erstellen wir ein Ticket, daher verwenden wir die Abfrage: Sie können dieses Feld leer lassen. In diesem Beispiel legen wir die API-URL im REST -URL-Attribut des Orchestrierungsknotens fest.

Abfrageheader: Stellen Sie diese drei Header wie im Screenshot dargestellt ein.
Akzeptieren / application/json
X-TFS-FedAuthRedirect / Unterdrücken
Content-Type / application/json-patch+json

Datumsattribut-Formatierer – Legen Sie das korrekte Format fest, wenn Sie Datumsattribute bereitstellen: JJJJ-MM-TT
Datums- und Zeitattributformatierer – Legen Sie das korrekte Format fest, wenn Sie Datums- und Zeitattribute bereitstellen: JJJJ-MM-TTTHH:mm:ssZ

Generische Zuordnungen festlegen

Zielvorlage – Vorlage, aus deren Workflow Sie diese Aufgabe aufrufen werden.
Zielordner – Ordner für Ihre Daten

Es wurden keine Attribute in der Zuordnungstabelle festgelegt (externes Attribut – lokales Attribut). Die Attributzuordnung erfolgt auf dem Workflow-Orchestrierungsknoten.

3. Aufgabe speichern

4. Erstellen Sie einen Orchestrierungsknoten in Ihrem Workflow, um diese ereignisbasierte Aufgabe aufzurufen.

Orchestrate – Pro Visioning Engine
Datenquelle – Generische REST API
Aktivität – Generischer REST Aufruf
Ziel – AD O-Ticket erstellen (Ihr ereignisbasierter Aufgabenname)
Aktion – In diesem Beispiel POST, da wir Tickets erstellen.
REST URL - in diesem Beispiel /$Bug?api-version=7.1, da wir Tickets vom Typ Bug erstellen. Sie können diesen Bug in etwas anderes ändern, das von Azure DevOps unterstützt wird, um verschiedene Tickettypen zu erstellen.
REST Body – Hier können Sie API Aufruftext direkt generieren. In komplexeren Fällen können Sie ihn separat (im Skriptknoten) für ein Attribut generieren und dieses Attribut dann hier verwenden. In diesem Fall wird der Text zum Erstellen eines Tickets direkt hier generiert.
Der Body in diesem Beispiel enthält die Werte für Titel und Reproduktionsschritte, die aus den Attributen „Betreff“ und „Details“ der Datenkarte gelesen werden. Der Aufwand ist für Version 3.0 fest codiert. Tag „MyTESTTag“ und AreaPath sind fest auf „Test\\My team1“ codiert. Der tatsächliche AreaPath enthält nur einen Backslash (\), benötigt aber zwei Backslashes (\\), um JSON-kompatibel zu sein.
[
{ "op": "add", "path": "/fields/System.Title", "value": "$subject$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.TCM.ReproSteps", "value": "$details$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.Scheduling.Effort", "value": 3.0 },
{ "op": "add", "path": "/fields/System.Tags", "value": "MyTESTTag" },
{ "op": "add", "path": "/fields/System.AreaPath", "value": "Test\\My team1" }
]

REST Antwortattribut – die Antwort des API Aufrufs wird in diesem Attribut gespeichert.
Pro – Falls ein Problem mit API Aufruf auftritt, wird die Ausnahme in diesem Attribut gespeichert.

Schließen Sie Ihren Workflow mit weiteren Knoten und Abläufen ab.

Workflow speichern und veröffentlichen

5. Test-Workflow und ereignisbasierte Aufgaben

Dieser Beispiel-Workflow erstellt ein Bug-Ticket und fügt eine Unteraufgabe dafür hinzu.

AD O-Ticket hinzufügen

Holen Sie sich AD O-Ticketnummer

AD O-Unteraufgabe hinzufügen

nutzt die erstellte Bug-Ticketnummer, die wir dem Attribut „get AD O ticket number“ -node zugeordnet haben.

Beschränkungen im Jahr 2025.3

Aus Performancegründen werden mehr als eine Ebene von Unterabfragen für geplante Aufgaben nicht unterstützt.

Geplante Aufgaben zum Lesen großer Datenmengen aus Microsoft Azure DevOps werden nicht unterstützt, da Microsoft Azure DevOps die Paginierungsmethode verwendet, die von unserem generischen REST API Connector nicht unterstützt wird.