Aby skonfigurować provisioning, potrzebny będzie dostęp do konsoli konfiguracji platformy.

1. Otwórz obszar Administracji (symbol koła zębatego).
2. Otwórz widok Złącza.
3. Wybierz „Nowy łącznik”

4. Wybierz typ źródła danych: Ogólne REST API

5. Podaj nazwę łącznika i dodaj ustawienia połączenia:

• Nazwa złącza – nadaj złączu przyjazną nazwę (nazwę można później zmienić)
• Adres URL hosta – adres URL bazowy dla REST API . Można go użyć jako prefiksu do wywołania adresu URL końcowego.
• Typ łącznika REST – wybierz Ogólny
• Metoda uwierzytelniania – Wybierz token dynamiczny

• Adres URL logowania: https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Treść logowania (zmień client_id i client_secret, pozostałe dwa atrybuty mają stałe wartości): client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Metoda logowania: POST
• Typ zawartości logowania: application/x-www-form-urlencoded
• Token logowania ważny przez (w sekundach): 3598
• Nagłówki logowania: Content-Type = application/x-www-form-urlencoded
• Użycie tokena: Nośnik @TOKEN@
• Atrybut tokena w odpowiedzi: access_token

6. Ustaw prawidłową paginację, jeśli zamierzasz używać tego połączenia z zadaniami zaplanowanymi

7. Uzupełnij informacje o użytkowniku WebAPI

• Użytkownik WebAPI — wybierz właściwego użytkownika WebAPI , który będzie używany podczas zapisywania danych z systemu zewnętrznego do rozwiązań Matrix42 Core , Pro and IGA
• Hasło WebAPI - hasło użytkownika WebAPI

8. Zapisz informacje o złączu

9. Dodaj zewnętrzny certyfikat główny https Microsoft Azure DevOps, który ma być zaufany przez funkcję zarządzania łącznikami (EPE). Można to zrobić tylko za pomocą Matrix42 : Dodaj certyfikat.

10. Rozwiązanie Matrix42 Core , Pro and IGA może teraz łączyć się z usługą Microsoft Azure DevOps

• Następnym krokiem jest skonfigurowanie zaplanowanego zadania do odczytu danych lub zadania zdarzeń do zapisu danych i działań w odniesieniu do usługi Microsoft Azure DevOps.

Odczyt danych z Microsoft Azure DevOps za pomocą zaplanowanych zadań nie jest obecnie obsługiwany . Powodem jest to, że Microsoft Azure DevOps korzysta z metody stronicowania, która nie jest obsługiwana przez nasz łącznik Generic REST API . W Azure DevOps nagłówek odpowiedzi zawiera token x-ms-continuationtoken dla stronicowania.

Można jednak nadal odczytać jeden obiekt z usługi Azure DevOps, używając zadań opartych na zdarzeniach i węzła Workflow Orchestration z akcją GET.

Poniżej przedstawiono podstawowy przykład zadania zdarzenia i węzła orkiestracji, które służą do tworzenia zgłoszeń w usłudze Microsoft Azure DevOps.

1. Dodaj zadanie oparte na zdarzeniach pod właściwym łącznikiem, klikając „Nowe zadanie”

2. Ustaw atrybuty dla zadania

Nazwa zadania – opisowa, unikalna nazwa
Użycie zadania – zdarzenie
Typ mapowania - Szablon ogólny
Zapytanie – adres URL interfejsu API , do którego chcesz wywołać. W tym przykładzie tworzymy zgłoszenie, więc używamy zapytania: Możesz to pole pozostawić puste. W tym przykładzie ustawimy adres URL interfejsu API na atrybut REST URL węzła Orchestration.

Nagłówki zapytania: ustaw te trzy nagłówki tak, jak pokazano na zrzucie ekranu.
Akceptuj / aplikacja/json
X-TFS-FedAuthRedirect / Suppress
Typ zawartości / aplikacja/json-patch+json

Formater atrybutu daty — ustaw poprawny format, jeśli tworzysz atrybuty daty: rrrr-MM-dd
Formater atrybutu DateTime — ustaw poprawny format, jeśli tworzysz atrybuty datetime: rrrr-MM-ddTHH:mm:ssZ

Ustaw mapowania ogólne

Szablon docelowy – szablon, z którego przepływu pracy będziesz wywoływać to zadanie
Folder docelowy – folder na Twoje dane

Nie ustawiono atrybutów w tabeli mapowania (atrybut zewnętrzny - atrybut lokalny). Mapowanie atrybutów odbywa się w węźle koordynacji przepływu pracy.

3. Zapisz zadanie

4. Utwórz węzeł orkiestracji dla swojego przepływu pracy, aby wywołać to zadanie oparte na zdarzeniach

Orchestrate - Silnik Pro
Źródło danych — ogólny REST API
Aktywność — ogólne wywołanie REST
Cel — Utwórz zgłoszenie AD O (nazwa zadania oparta na zdarzeniu)
Akcja – w tym przykładzie POST, ponieważ tworzymy zgłoszenia
Adres URL REST — w tym przykładzie /$Bug?api-version=7.1. Ponieważ tworzymy zgłoszenia typu Bug, możesz zmienić ten błąd na inny typ obsługiwany przez usługę Azure DevOps, aby utworzyć inne typy zgłoszeń.
Treść REST – możesz wygenerować treść wywołania API bezpośrednio tutaj. Lub, w bardziej skomplikowanych przypadkach, wygenerować ją osobno (w węźle skryptu) dla jakiegoś atrybutu, a następnie użyć tego atrybutu tutaj. W tym przypadku treść do utworzenia zgłoszenia jest tworzona bezpośrednio tutaj.
W tym przykładzie używamy wartości „Title” i „ReproSteps” odczytanych z atrybutów „temat” i „szczegóły” karty danych. Effort jest zakodowany na stałe dla wersji 3.0. Tag „MyTESTTag” i „AreaPath” są zakodowane na stałe jako „Test\\My team1”. Rzeczywisty „areaPath” ma tylko jeden tag „\”, ale musi on mieć podwójny tag „\\”, aby był zgodny z formatem JSON.
[
{ "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\\Mój zespół1" }
]

Atrybut odpowiedzi REST — odpowiedź wywołania API zostanie zapisana w tym atrybucie
Wyjątek w Pro — jeśli wystąpi problem z wywołaniem API , wyjątek zostanie zapisany w tym atrybucie

Zakończ swój przepływ pracy, inne węzły i przepływ

Zapisz przepływ pracy i opublikuj go

5. Przetestuj przepływ pracy i zadanie oparte na zdarzeniach

Ten przykładowy przepływ pracy tworzy jedno zgłoszenie błędu i dodaje do niego jedno podzadanie

Dodaj bilet AD O

Uzyskaj numer biletu AD O

Dodaj podzadanie AD O

wykorzystuje utworzony numer zgłoszenia błędu, który zapisaliśmy w celu przypisania do węzła „pobierz numer zgłoszenia AD O”

Ograniczenia w 2025.3

Ze względów wydajnościowych nie jest obsługiwany więcej niż jeden poziom podzapytań dla zadań zaplanowanych.

Zaplanowane zadania odczytu dużych ilości danych z usługi Microsoft Azure DevOps nie są obsługiwane, ponieważ usługa Microsoft Azure DevOps korzysta z metody paginacji, która nie jest obsługiwana przez nasz łącznik ogólnego interfejsu REST API .