Zum Konfigurieren der Bereitstellung benötigen Sie Zugriff auf die Plattformkonfigurationskonsole.

1. Öffnen Sie den Administrationsbereich (ein Zahnradsymbol).
2. Öffnen Sie die Connectors-Ansicht.
3. Wählen Sie „Neuer Connector“

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

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

• Connector-Name – geben Sie Ihrem Connector einen benutzerfreundlichen Namen (der Name kann später geändert werden)
• Host-URL – Basis-URL für REST API . https://<IHRE_RAYNET_URL>.raynetone.com/v1/resultDatabase (zum Beispiel: https://matrix42-demo-datahub.raynetone.com/v1/resultDatabase). Dies kann als Präfix für die endgültige aufzurufende URL verwendet werden.
• REST Connector-Typ – wählen Sie „Allgemein“
• Authentifizierungsmethode – Auth-Header
• Name des Authentifizierungsheaders – ApiKey
• Authentifizierungsheaderwert – Wert Ihres API-Schlüssels
• Paginierungstyp - Seiteninkrement
• Seitenattribut „Paginierung“ – Seite
• Seitennummerierung Seitenanfang - 1
• Seitengrößenattribut für die Seitennummerierung – page_size
• Seitengröße der Seitennummerierung: 500 (wenn Sie eine größere Seitengröße verwenden möchten, überprüfen Sie anhand Raynet -Dokumentation, ob diese Seitengröße unterstützt wird)

6. Web API Benutzerinformationen ausfüllen

• Web API Benutzer – wählen Sie den richtigen Web- API Benutzer aus, der beim Schreiben von Daten aus einem externen System in Matrix42 Core , Pro and IGA Lösungen verwendet wird
• Web API Passwort – Passwort für den Web API Benutzer

8. Connector-Informationen speichern

9. Fügen Sie Raynet Stamm-HTTPS-Zertifikat hinzu, dem das Connector-Management (EPE) vertrauen soll. Dies ist nur mit Matrix42 möglich: Zertifikat hinzufügen.

10. Matrix42 Core , Pro and IGA Lösungen können jetzt eine Verbindung zu Raynet herstellen

• Der nächste Schritt besteht darin, geplante Aufgaben zum Lesen von Daten oder Ereignisaufgaben zum Schreiben von Daten und Aktionen in Richtung Raynet zu konfigurieren.

In diesem Kapitel fügen wir eine geplante Aufgabe zum Lesen von Daten aus Raynet hinzu.

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

2. Aufgabenattribute festlegen

Planung – Legen Sie bei Bedarf eine Planung fest

Aufgabenname - Legen Sie einen aussagekräftigen Namen fest

Aufgabennutzung – Geplant

Zuordnungstyp – Generische Vorlage

Abfrage – Die Abfrage hängt davon ab, welche Daten Sie abrufen möchten.
In diesem Beispiel rufen wir Benutzer mithilfe von „resultTable/paged?tableName=DataTransformation-result_devices“ ab, wodurch grundsätzlich alle Daten aus Raynet DataTransformation-result_devices-Tabelle abgerufen werden.

Unterabfragen – Sie können Unterabfragen hinzufügen, wenn Sie weitere Daten zum von der eigentlichen Abfrage zurückgegebenen Ergebnissatz lesen möchten. In diesem Beispiel verwenden wir keine Unterabfragen.

Abfrageheader – für Raynet müssen wir diese Header hinzufügen:
Akzeptieren / application/json
Inhaltstyp / Anwendung/JSON

Wertmarker - Datensätze

Fehlermarkierung – lassen Sie dies leer

Sicherheitsschwelle für API Aufrufe – es wird empfohlen, sie doppelt so hoch einzustellen wie die Anzahl der von dieser API zurückgegebenen Seiten. Wenn Sie diesen Wert leer lassen, gibt es keine Sicherheitsschwelle, und der Connector kann bei einem Konfigurationsfehler in eine Endlosschleife geraten.

Eindeutiges Attribut - Eindeutiges Attribut im API Ergebnissatz. In diesem Fall import_id

3. Fehlerinformationen eingeben

Optionale Einstellungen für die Fehlerbehandlung. Wenn geplante Aufgaben fehlschlagen, kann eine Datenkarte für ESM erstellt werden, die den Fehler anzeigt. Wenn Fehlereinstellungen definiert sind, muss der Administrator den Status geplanter Aufgaben nicht manuell überprüfen.

• Fehlervorlage – Wählen Sie eine Datenkartenvorlage aus, die im Falle von Fehlern während der Bereitstellung (Verbindung zu Datenquellen, Zeitüberschreitungen usw.) erstellt wird.
• Fehlerordner – Wählen Sie den Ordner aus, in dem die Fehlerdatenkarte gespeichert ist.
• Fehlerattribut – Wählen Sie ein Attribut aus, in dem in der Fehlervorlage die Fehlerinformationen gespeichert werden sollen. Wählen Sie das Attribut vom Typ „Text“ aus.

4. Füllen Sie die allgemeinen Zuordnungsinformationen aus

Im Abschnitt „Zuordnungen“ konfigurieren Sie, welches Attribut aus der JSON-Nachricht in welches Attribut auf Matrix42 Core , Pro and IGA Datenkarte gelesen wird.

• Zielvorlage – Wählen Sie eine Vorlage aus, um Attributzuordnungen zu definieren (in diesem Beispiel „Gerät“, da wir Geräte abrufen).
• Zielordner - Wählen Sie einen Ordner aus einer Liste aus. Die Liste wird entsprechend der Kompatibilität mit der ausgewählten Vorlage eingegrenzt. (In diesem Beispiel: Asset/Server)
• Zuordnung des Datenquellentyps – optional. Wenn diese Option festgelegt ist, wird der Konnektortyp in dieses Attribut geschrieben.
• Task-ID-Zuordnung – Die Task-ID-Nummer wird in dieses Attribut geschrieben. Die richtige Attributauswahl hängt von der Konfiguration Ihrer Vorlage ab.
• Wert für Datenkarte für aus dem Quellsystem gelöschtes Objekt setzen – Diese Funktion wird durch Aktivieren des Kontrollkästchens aktiviert. Wenn ein Objekt, das zuvor aus einem Drittsystem in die Lösung eingelesen wurde, aus dem Drittsystem gelöscht wird, erkennt diese geplante Aufgabe die Löschung und markiert das ausgewählte Attribut der Datenkarte mit dem gewünschten Wert. Dies kann beispielsweise verwendet werden, um das Statusattribut auf „Gelöscht“ zu setzen. Dieser Attributname und -wert muss entsprechend der Konfiguration Ihrer Vorlage festgelegt werden.

• Attributzuordnungen
  1. Externes Attribut - welches Attribut aus der Raynet API aus dem JSON-Body gelesen wird
  2. Lokales Attribut - welches Attribut in Matrix42 Core , Pro and IGA abgebildet wird
• Es ist möglich, zusätzliche Attribute für Attributzuordnungen festzulegen, indem Sie Neues Attribut
• Sie müssen auch eine Zuordnung zum eindeutigen Attribut hinzufügen, in diesem Beispiel ist es import_id. Dies muss dem eindeutigen Attribut auf der Vorlage zugeordnet werden, in diesem Beispiel Name.
• Die erste Zuordnung verwendet eine Unterabfrage, um Benutzergruppenmitgliedschaften dem Attribut „multiValueField“ zuzuordnen. Andere Zuordnungen dienen der Zuordnung von Benutzerattributen der Hauptabfrage.

5. Speichern Sie die Bereitstellungsaufgabe über die Schaltfläche „Speichern“.

Wenn einige erforderliche Attribute fehlen, wird die Schaltfläche „Speichern“ grau angezeigt und es wird angezeigt, was in den Einstellungen fehlt.

6. Sie haben nun eine zeitgesteuerte Connector-Aufgabe konfiguriert

• Sie können jetzt warten, bis die Aufgabe basierend auf der Planung gestartet wird oder
• Task manuell ausführen – Durch Klicken auf die Schaltfläche „Task ausführen“ oben im Task-Bearbeitungsfenster wird der Task so konfiguriert, dass er sofort gestartet wird. Dies ist normalerweise für Testläufe oder wenn Sie die Zeitplaneinstellungen nicht ändern, sondern den Task sofort ausführen möchten.

Beispiel einer Meldung zum Starten der manuellen Aufgabenausführung:

Wenn die Aufgabe manuell ausgeführt wird (Aufgabe ausführen) oder gemäß Zeitplan ausgeführt wird, kann der Aufgabenstatus in der Verwaltungsspalte der Liste der geplanten Aufgaben durch Klicken auf die Schaltfläche „Verlauf anzeigen“ überprüft werden.

Raynet API enthält Filterfunktionen, die von nativen Konnektoren verwendet werden können.
Raynet API Dokumentation zur Filterfunktionalität Raynet 2025.3-Versionshinweise 

Um den Filter im Abfrageattribut der Aufgabe zu verwenden, müssen Sie den Filterwert manuell per URL kodieren oder die Kodierung über eine Website (z. B. https://www.urlencoder.org ) durchführen.

Filterbeispiel ohne URL-Kodierung (funktioniert nicht): resultTable/paged?tableName=DataTransformation-result_devices&filter=["device_manufacturer","=","HP"]
Gleiches Beispiel-URL codiert (funktioniert): resultTable/paged?tableName=DataTransformation-result_devices&filter= %5B%22device_manufacturer%22%2C%22%3D%22%2C%22HP%22%5D

Einschränkungen im Jahr 2025.3

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