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 nośnika
• Token okaziciela – ustaw wartość tokena okaziciela (bez tekstu „Bosiarz” na początku)

6. Ustaw prawidłową paginację

Możesz utworzyć 2 oddzielne łączniki z identycznymi ustawieniami, z tą różnicą, że to ustawienie paginacji jest inne. Utwórz jeden łącznik dla zadań, w których API obsługuje paginację, a drugi dla zadań, w których API paginację. nie obsługuje paginacji.

A) Ustaw paginację dla Matrix42 Enterprise /SAM Connector (dla zadań wywołujących API , które nie obsługują paginacji)
Użyj wyłączonego, ponieważ API dataquery używany w przykładzie zadania zaplanowanego nie obsługuje paginacji:

B) Ustaw paginację dla Matrix42 Enterprise /SAM Connector dla zadań wywołujących API obsługujące paginację .

• Typ paginacji - Przyrost strony
• Atrybut strony paginacji - numer strony
• Paginacja Początek strony - 1
• Atrybut rozmiaru strony paginacji - pagesize
• Rozmiar strony w paginacji – ustaw go zgodnie z danymi. Sprawdź maksymalną wartość w dokumentacji Matrix42 Enterprise /SAM lub u konsultantów. Musi być mniejsza niż najmniejsza ilość danych zwrócona przez wywoływane API . Jeśli ustawisz tę wartość zbyt wysoko Matrix42 Enterprise lub SAM nie zwróci żadnych danych.

7. Uzupełnij informacje o użytkowniku API sieci Web

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

8. Zapisz informacje o złączu

9. Dodaj zewnętrzny certyfikat główny HTTPS systemu Matrix42 Enterprise lub SAM, który będzie uznawany za 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 Matrix42 Enterprise i Matrix42 SAM

• Następnym krokiem jest konfiguracja zaplanowanego zadania do odczytu danych lub zadania zdarzeń do zapisu danych oraz działań wobec Matrix42 Enterprise i SAM.

1. Dodaj zaplanowane zadanie w odpowiednim łączniku, klikając „Nowe zadanie”

2. Ustaw atrybuty zadania

Harmonogramowanie – ustaw harmonogram, jeśli to konieczne

Nazwa zadania – Ustaw nazwę informacyjną

Użycie zadań – zaplanowane

Typ mapowania – Szablon ogólny

Zapytanie – zapytanie zależy od tego, do którego punktu końcowego Matrix42 Enterprise lub API chcesz się odwołać, aby pobrać dane. Prawidłowy adres URL i parametry API znajdziesz w dokumentacji Matrix42 Enterprise .
W tym przykładzie: /data/fragments/SPSActivityClassBase?columns=ID,Subject,Description,TicketNumber

Podzapytania – możesz dodać podzapytania, jeśli chcesz odczytać więcej danych powiązanych z zestawem wyników zwróconym przez rzeczywiste zapytanie. W tym przykładzie nie korzystamy z tej funkcjonalności.

Nagłówki zapytania – można pozostawić puste

Znacznik wartości – pozostaw puste

Znacznik błędu – pozostaw puste

Próg bezpieczeństwa dla wywołań API – zaleca się ustawienie go dwa razy wyżej niż liczba stron zwracanych przez to API . Jeśli pozostawisz ten próg pusty, próg bezpieczeństwa zniknie, a łącznik może przejść w nieskończoną pętlę w przypadku błędu w konfiguracji.

Atrybut unikatowy – atrybut unikatowy w zbiorze wyników API . Zwykle identyfikator w API Matrix42 Enterprise , ale należy to potwierdzić w dokumentacji.

3. Uzupełnij informacje o awarii

Opcjonalne ustawienia obsługi awarii. Jeśli zaplanowane zadanie zakończy się niepowodzeniem, może utworzyć kartę danych w ESM, która wyświetli błąd. Jeśli ustawienia awarii są zdefiniowane, administrator nie musi ręcznie sprawdzać statusu zaplanowanych zadań.

• Szablon awarii — wybierz szablon karty danych, który zostanie utworzony w razie wystąpienia błędów podczas udostępniania (połączenie ze źródłami danych, przekroczenie limitu czasu itp.).
• Folder awarii – wybierz folder, w którym będzie przechowywana karta danych awarii.
• Atrybut awarii — wybierz atrybut, w którym w szablonie awarii mają być przechowywane informacje o błędzie. Wybierz atrybut typu tekstowego.

4. Uzupełnij informacje o mapowaniach ogólnych

W sekcji mapowań konfigurujesz, który atrybut z komunikatu JSON zostanie odczytany do którego atrybutu na karcie danych Matrix42 Core , Pro and IGA .

• Szablon docelowy — wybierz szablon, aby zdefiniować mapowania atrybutów (w tym przykładzie Bilet)
• Folder docelowy – wybierz folder z listy folderów. Lista jest zawężana w celu dopasowania do wybranego szablonu (w tym przykładzie Bilety).
• Mapowanie typu źródła danych – opcjonalne. Jeśli jest ustawione, zapisuje typ łącznika do tego atrybutu.
• Mapowanie identyfikatorów zadań – numer identyfikacyjny zadania jest zapisywany w tym atrybucie. Prawidłowy wybór atrybutu zależy od konfiguracji szablonu.
• Ustaw wartość na karcie danych dla obiektu usuniętego z systemu źródłowego – tę funkcję aktywuje się, zaznaczając pole wyboru. Gdy obiekt, który został wcześniej odczytany z systemu zewnętrznego do rozwiązania, zostanie usunięty z systemu zewnętrznego, to zaplanowane zadanie zauważa, że obiekt został usunięty i oznacza wybrany atrybut karty danych żądaną wartością. Można tego użyć na przykład do ustawienia atrybutu Status na 09 – Zamknięty (jak pokazano na poniższym zrzucie ekranu). Nazwę i wartość atrybutu należy ustawić w zależności od konfiguracji szablonu.

• Mapowania atrybutów
  1. Atrybut zewnętrzny – który atrybut z API systemu Matrix42 Enterprise jest odczytywany z treści JSON
  2. Atrybut lokalny – do którego atrybutu w Matrix42 Core , Pro and IGA jest mapowany atrybut
• Można ustawić dodatkowe atrybuty do mapowań atrybutów, wybierając opcję Nowy atrybut
• Musisz dodać mapowanie również do atrybutu unikalnego, w tym przykładzie jest to ID. Należy je zmapować do atrybutu unikalnego w szablonie, w tym przykładzie text1.

5. Zapisz zadanie provisioningu, klikając przycisk Zapisz.

Jeśli brakuje niektórych wymaganych atrybutów, przycisk zapisu jest wyświetlany w kolorze szarym i pokazuje, czego brakuje w ustawieniach.

6. Skonfigurowałeś już zadanie łącznika oparte na harmonogramie

• Teraz możesz poczekać, aż zadanie zostanie rozpoczęte zgodnie z harmonogramem lub
• Uruchom zadanie ręcznie – klikając przycisk „Uruchom zadanie” u góry okna edycji zadania, zadanie jest konfigurowane do natychmiastowego uruchomienia. Zazwyczaj jest to przydatne w przypadku uruchomień testowych lub gdy nie chcesz zmieniać ustawień harmonogramu, ale chcesz uruchomić zadanie od razu.

Przykład komunikatu rozpoczynającego ręczne uruchomienie zadania:

Jeśli zadanie jest wykonywane ręcznie (uruchom zadanie) lub jest uruchamiane zgodnie z harmonogramem, status zadania można sprawdzić w kolumnie zarządzania listą zaplanowanych zadań, klikając przycisk „Wyświetl historię”.

1. Dodaj zaplanowane zadanie w odpowiednim łączniku, klikając „Nowe zadanie”

2. Ustaw atrybuty zadania

Harmonogramowanie – ustaw harmonogram, jeśli to konieczne

Nazwa zadania – Ustaw nazwę informacyjną

Użycie zadań – zaplanowane

Typ mapowania – Szablon ogólny

Zapytanie – zapytanie zależy od punktu końcowego API Matrix42 SAM, który chcesz wywołać, aby pobrać dane. Zapoznaj się z dokumentacją Matrix42 SAM, aby uzyskać prawidłowy adres URL i parametry API .
W tym przykładzie: dataquery/aad704de-a242-c667-123b-08d45a5faa97

Uwaga! Jeśli używasz API DataQuery Matrix42 Enterprise /SAM (jak w tym przykładzie), domyślnie zwraca on tylko 10 000 obiektów. API DataQuery nie obsługuje stronicowania. Jeśli potrzebujesz pobrać więcej niż 10 000 obiektów, skontaktuj się Matrix42 i poproś o zwiększenie limitu środowiskowego. Więcej informacji poniżej:

„ Liczba rekordów odpowiedzi na zapytanie o dane
Ustawienie PDRDwpConfigurationClass.DataQueryMaxResponseRecords definiuje maksymalną liczbę rekordów zwracanych przez usługę internetową „Zapytanie o dane”.
Wartość domyślna: 10 000 rekordów.

Podzapytania – możesz dodać podzapytania, jeśli chcesz odczytać więcej danych powiązanych z zestawem wyników zwróconym przez rzeczywiste zapytanie. W tym przykładzie nie korzystamy z tej funkcjonalności.

Nagłówki zapytania – można pozostawić puste

Znacznik wartości – pozostaw puste

Znacznik błędu – pozostaw puste

Próg bezpieczeństwa dla wywołań API – zaleca się ustawienie go dwa razy wyżej niż liczba stron zwracanych przez to API . Jeśli pozostawisz ten próg pusty, próg bezpieczeństwa zniknie, a łącznik może przejść w nieskończoną pętlę w przypadku błędu w konfiguracji.

Atrybut unikatowy – atrybut unikatowy w zbiorze wyników API . Zwykle identyfikator w API SAM Matrix42 , ale proszę to potwierdzić w dokumentacji.

3. Uzupełnij informacje o awarii

Opcjonalne ustawienia obsługi awarii. Jeśli zaplanowane zadanie zakończy się niepowodzeniem, może utworzyć kartę danych w ESM, która wyświetli błąd. Jeśli ustawienia awarii są zdefiniowane, administrator nie musi ręcznie sprawdzać statusu zaplanowanych zadań.

• Szablon awarii — wybierz szablon karty danych, który zostanie utworzony w razie wystąpienia błędów podczas udostępniania (połączenie ze źródłami danych, przekroczenie limitu czasu itp.).
• Folder awarii – wybierz folder, w którym będzie przechowywana karta danych awarii.
• Atrybut awarii — wybierz atrybut, w którym w szablonie awarii mają być przechowywane informacje o błędzie. Wybierz atrybut typu tekstowego.

4. Uzupełnij informacje o mapowaniach ogólnych

W sekcji mapowań konfigurujesz, który atrybut z komunikatu JSON zostanie odczytany do którego atrybutu na karcie danych Matrix42 Core , Pro and IGA .

• Szablon docelowy — wybierz szablon, aby zdefiniować mapowania atrybutów (w tym przykładzie Urządzenie)
• Folder docelowy – wybierz folder z listy folderów. Lista jest zawężana w celu dopasowania do wybranego szablonu (w tym przykładzie Zasoby/Serwery).
• Mapowanie typu źródła danych – opcjonalne. Jeśli jest ustawione, zapisuje typ łącznika do tego atrybutu.
• Mapowanie identyfikatorów zadań – numer identyfikacyjny zadania jest zapisywany w tym atrybucie. Prawidłowy wybór atrybutu zależy od konfiguracji szablonu.
• Ustaw wartość na karcie danych dla obiektu usuniętego z systemu źródłowego – tę funkcjonalność aktywuje się, zaznaczając pole wyboru. Gdy obiekt, który został wcześniej odczytany z systemu zewnętrznego do rozwiązania, zostanie usunięty z systemu zewnętrznego, to zaplanowane zadanie zauważa, że obiekt został usunięty i oznacza wybrany atrybut karty danych żądaną wartością. Można tego użyć na przykład do ustawienia atrybutu Status na Usunięty. Nazwa i wartość atrybutu muszą zostać ustawione zgodnie z konfiguracją szablonu. W tym przykładzie ta funkcjonalność nie jest używana.

• Mapowania atrybutów
  1. Atrybut zewnętrzny – który atrybut z API systemu SAM Matrix42 jest odczytywany z treści JSON
  2. Atrybut lokalny – do którego atrybutu w Matrix42 Core , Pro and IGA jest mapowany atrybut
• Można ustawić dodatkowe atrybuty do mapowań atrybutów, wybierając opcję Nowy atrybut
• Musisz dodać mapowanie również do atrybutu unikalnego, w tym przykładzie jest to identyfikator. Należy go zmapować do atrybutu unikalnego w szablonie, w tym przykładzie identyfikatora usługi Intune.

5. Zapisz zadanie provisioningu, klikając przycisk Zapisz.

Jeśli brakuje niektórych wymaganych atrybutów, przycisk zapisu jest wyświetlany w kolorze szarym i pokazuje, czego brakuje w ustawieniach.

6. Skonfigurowałeś już zadanie łącznika oparte na harmonogramie

• Teraz możesz poczekać, aż zadanie zostanie rozpoczęte zgodnie z harmonogramem lub
• Uruchom zadanie ręcznie – klikając przycisk „Uruchom zadanie” u góry okna edycji zadania, zadanie jest konfigurowane do natychmiastowego uruchomienia. Zazwyczaj jest to przydatne w przypadku uruchomień testowych lub gdy nie chcesz zmieniać ustawień harmonogramu, ale chcesz uruchomić zadanie od razu.

Przykład komunikatu o uruchomieniu zadania ręcznego:

Jeśli zadanie jest wykonywane ręcznie (uruchom zadanie) lub jest uruchamiane zgodnie z harmonogramem, status zadania można sprawdzić w kolumnie zarządzania listą zaplanowanych zadań, klikając przycisk „Wyświetl historię”.

Oto podstawowy przykład zadania zdarzenia i węzła orkiestracji, które służą do tworzenia zgłoszeń typu 6 w systemie Matrix42 Enterprise. W środowisku produkcyjnym należy zaprojektować typy zgłoszeń, które chcemy utworzyć, oraz atrybuty, które należy im nadać.

1. Dodaj zadanie oparte na zdarzeniu 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 API które chcesz wywołać. W tym przykładzie tworzymy bilet, więc używamy zapytania: /ticket/ (ostateczny adres URL API do wywołania jest tworzony przez połączenie adresu URL konektora, adresu URL tego zapytania i adresu URL REST węzła orkiestracji). Możesz również pozostawić zapytanie puste i ustawić adres URL API na atrybut adresu URL REST węzła orkiestracji.

Formater atrybutów daty — ustaw poprawny format, jeśli tworzysz atrybuty daty

Formater atrybutów DateTime — ustaw poprawny format, jeśli tworzysz atrybuty datetime

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 jako żądanie usługi (nazwa zadania oparta na zdarzeniu)
Akcja - W tym przykładzie POST, ponieważ tworzymy zgłoszenia za pomocą API , który tworzy zgłoszenia.
REST URL – w tym przykładzie create?activitytype=6, ponieważ tworzymy zgłoszenia z typem aktywności 6
Treść REST – treść wywołania API można wygenerować bezpośrednio tutaj. W bardziej skomplikowanych przypadkach można wygenerować ją osobno (w węźle skryptu) dla pewnego atrybutu, a następnie użyć tego atrybutu tutaj. W tym przypadku treść do utworzenia zgłoszenia jest tworzona bezpośrednio tutaj, przy użyciu zmiennych kodu atrybutów subject i details.
W tym przykładzie używamy zakodowanego na stałe użytkownika (można rozważyć zastosowanie innej logiki), wartości tematu i opisu są odczytywane z atrybutów tematu i szczegółów karty danych.
{
"Temat": "$subject$",
"Opis": "$details$",
„Priorytet”: 0,
„Wpływ”: 0,
„Pilność”: 0,
„Użytkownik”: „0e8aac28-b2df-ef11-58b1-005056905558”
}

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

Ograniczenia w 2025.3

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