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 . https://<TWÓJ_URL_RAYNET>.raynetone.com/v1/resultDatabase (na przykład: https://matrix42-demo-datahub.raynetone.com/v1/resultDatabase). Można go użyć jako prefiksu dla końcowego adresu URL, który zostanie wywołany.
• Typ łącznika REST – wybierz Ogólny
• Metoda uwierzytelniania – nagłówek uwierzytelniania
• Nazwa nagłówka uwierzytelniania - ApiKey
• Wartość nagłówka uwierzytelniania – wartość Twojego klucza API
• Typ paginacji - Przyrost strony
• Atrybut strony paginacji - strona
• Paginacja Początek strony - 1
• Atrybut rozmiaru strony paginacji - page_size
• Paginacja Rozmiar strony - 500 (jeśli chcesz użyć większego rozmiaru strony, sprawdź w dokumentacji Raynet , czy obsługują taki rozmiar strony)

6. 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 certyfikat główny https Raynet , który ma być zaufany przez Connector Management (EPE). Można to zrobić tylko za pomocą Matrix42 : Dodaj certyfikat.

10. Rozwiązania Matrix42 Core , Pro and IGA mogą teraz łączyć się z Raynet

• Następnym krokiem jest konfiguracja zaplanowanego zadania do odczytu danych lub zadania zdarzeń do zapisu danych i działań w Raynet .

W tym rozdziale dodamy zaplanowane zadanie odczytu danych z Raynet .

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, jakie dane chcesz pobrać.
W tym przykładzie pobieramy użytkowników za pomocą: resultTable/paged?tableName=DataTransformation-result_devices co zasadniczo spowoduje pobranie wszystkich danych z tabeli Raynet DataTransformation-result_devices.

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 używamy podzapytań.

Nagłówki zapytania – w przypadku Raynet musimy dodać następujące nagłówki:
Akceptuj / aplikacja/json
Typ zawartości / aplikacja/json

Znacznik wartości - rekordy

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 . W tym przypadku import_id

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, ponieważ pobieramy urządzenia)
• Folder docelowy – wybierz folder z listy folderów. Lista jest zawężana w celu dopasowania do wybranego szablonu (w tym przykładzie Zasób/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. 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 Raynet 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 import_id. Należy je zmapować do atrybutu unikalnego w szablonie, w tym przykładzie jest to nazwa.
• Pierwsze mapowanie wykorzystuje podzapytanie do mapowania przynależności użytkowników do grup na atrybut multiValueField. Pozostałe mapowania dotyczą mapowania atrybutów użytkownika w głównym zapytaniu.

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ę”.

API Raynet zawiera funkcje filtrowania, z których można korzystać z poziomu natywnych łączników.
Dokumentacja API Raynet dotycząca funkcjonalności filtrów Informacje o wydaniu Raynet 2025.3 

Aby użyć filtru w atrybucie zapytania zadania, należy ręcznie zakodować wartość filtru w adresie URL lub skorzystać z jakiejś witryny (na przykład https://www.urlencoder.org ) w celu wykonania kodowania.

Przykład filtra bez kodowania adresu URL (nie działa): resultTable/paged?tableName=DataTransformation-result_devices&filter=["device_manufacturer","=","HP"]
Ten sam przykładowy adres URL zakodowany (działa): resultTable/paged?tableName=DataTransformation-result_devices&filter= %5B%22device_manufacturer%22%2C%22%3D%22%2C%22HP%22%5D

Ograniczenia w 2025.3

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