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 . Dies kann als Präfix für die endgültige aufzurufende URL verwendet werden.
• REST Connector-Typ – wählen Sie „Allgemein“
• Authentifizierungsmethode – Bearer-Token auswählen
• Bearer Token - Wert des Bearer Tokens festlegen (ohne Bearer-Text am Anfang)

6. Korrekte Seitennummerierung einstellen

Sie können zwei separate Konnektoren mit identischen Einstellungen erstellen, mit der Ausnahme, dass die Paginierungseinstellung unterschiedlich ist. Erstellen Sie einen Konnektor für Aufgaben, bei denen API die Paginierung unterstützt, und einen weiteren Konnektor für Aufgaben, bei denen API unterstützt keine Paginierung.

A) Paginierung für Matrix42 Enterprise /SAM Connector festlegen (für Aufgaben, die API aufrufen, die keine Paginierung unterstützen)
Verwendung deaktiviert, da die im Beispiel für eine geplante Aufgabe verwendete DataQuery API keine Paginierung unterstützt:

B) Legen Sie die Paginierung für Matrix42 Enterprise /SAM Connector fest, für Aufgaben, API aufrufen , die die Paginierung unterstützen .

• Paginierungstyp - Seiteninkrement
• Paginierungsseitenattribut – Seitennummer
• Seitennummerierung Seitenanfang - 1
• Seitengrößenattribut für die Seitennummerierung – Seitengröße
• Seitengröße der Paginierung – stellen Sie diese entsprechend Ihren Daten ein. Überprüfen Sie den Maximalwert in der Matrix42 Enterprise /SAM-Dokumentation oder bei Beratern. Dieser muss kleiner sein als die kleinste Datenmenge, die von der aufgerufenen API zurückgegeben wird. Wenn Sie diesen Wert zu hoch einstellen, gibt Matrix42 Enterprise oder SAM keine Daten zurück.

7. 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 ein externes Root-HTTPS-Zertifikat für Matrix42 Enterprise oder SAM-Systeme hinzu, dem das Connector Management (EPE) vertraut. Dies ist nur mit Matrix42 möglich: Zertifikat hinzufügen.

10. Matrix42 Core , Pro and IGA Lösung kann jetzt mit Matrix42 Enterprise und Matrix42 SAM verbunden werden

• Der nächste Schritt besteht darin, geplante Aufgaben zum Lesen von Daten oder Ereignisaufgaben zum Schreiben von Daten und Aktionen für Matrix42 Enterprise und SAM zu konfigurieren.

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, welchen Matrix42 Enterprise oder API Endpunkt Sie zum Abrufen von Daten aufrufen möchten. Die korrekte API URL und die Parameter finden Sie in Matrix42 Enterprise -Dokumentation.
In diesem Beispiel: /data/fragments/SPSActivityClassBase?columns=ID,Subject,Description,TicketNumber

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 diese Funktion nicht.

Abfrageüberschriften – können leer gelassen werden

Wertmarkierung - leer lassen

Fehlermarkierung – leer lassen

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. Normalerweise ID in Matrix42 Enterprise API , aber bestätigen Sie dies anhand der Dokumentation.

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 Ticket).
• 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: Tickets)
• 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 festlegen – Diese Funktion wird durch Aktivieren des Kontrollkästchens aktiviert. Wenn ein Objekt, das zuvor aus einem Drittanbietersystem in die Lösung eingelesen wurde, aus dem Drittanbietersystem 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 09 – Geschlossen zu setzen (siehe Beispiel-Screenshot unten). Dieser Attributname und -wert muss basierend auf der Konfiguration Ihrer Vorlage festgelegt werden.

• Attributzuordnungen
  1. Externes Attribut – welches Attribut aus der Matrix42 Enterprise -System 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 die ID. Diese muss dem eindeutigen Attribut auf der Vorlage zugeordnet werden, in diesem Beispiel Text1.

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.

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, welchen Matrix42 SAM API Endpunkt Sie zum Abrufen von Daten aufrufen möchten. Die korrekte API URL und die Parameter finden Sie in Matrix42 SAM-Dokumentation.
In diesem Beispiel: dataquery/aad704de-a242-c667-123b-08d45a5faa97

Hinweis! Wenn Sie Matrix42 Enterprise /SAM Dataquery API verwenden (wie in diesem Beispiel), werden standardmäßig nur 10.000 Objekte zurückgegeben. Die Dataquery API unterstützt keine Paginierung. Wenn Sie mehr als 10.000 Objekte abrufen müssen, wenden Sie sich an Matrix42 und bitten Sie um eine Erhöhung Ihres Umgebungslimits. Weitere Informationen finden Sie unten:

„ Datenabfrageantwortdatensätze zählen
Die Einstellung PDRDwpConfigurationClass.DataQueryMaxResponseRecords definiert die maximale Anzahl von Datensätzen, die vom Webdienst „Datenabfrage“ zurückgegeben werden.
Standardwert: 10.000 Datensätze. “

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 diese Funktion nicht.

Abfrageüberschriften – können leer gelassen werden

Wertmarkierung - leer lassen

Fehlermarkierung – leer lassen

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. Normalerweise ID in Matrix42 SAM- API , aber bestätigen Sie dies anhand der Dokumentation.

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).
• 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: Assets/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. Dies geschieht, wenn ein zuvor aus einem Drittsystem in die Lösung eingelesenes Objekt aus dem Drittsystem gelöscht wird. Diese geplante Aufgabe erkennt 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. Attributname und Attributwert müssen entsprechend der Konfiguration Ihrer Vorlage festgelegt werden. In diesem Beispiel wird diese Funktion nicht verwendet.

• Attributzuordnungen
  1. Externes Attribut – welches Attribut aus der Matrix42 SAM-System- 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 die ID. Diese muss dem eindeutigen Attribut auf der Vorlage zugeordnet werden, in diesem Beispiel der Intune-ID.

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.

Hier ist ein einfaches Beispiel für eine Ereignisaufgabe und einen Orchestrierungsknoten, die zum Erstellen von Tickets des Aktivitätstyps 6 für Matrix42 Enterprise verwendet werden. Im Produktionseinsatz müssen Sie festlegen, welche Tickettypen Sie erstellen möchten und welche Attribute für diese festgelegt werden müssen.

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

2. Attribute für Aufgaben festlegen

Aufgabenname – beschreibender eindeutiger Name
Aufgabenverwendung – 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: /ticket/ (die endgültige aufzurufende API URL wird durch Verkettung der Connector-URL, dieser Abfrage-URL und REST -URL des Orchestrierungsknotens erstellt). Sie können die Abfrage auch leer lassen und Ihre API-URL auf REST URL-Attribut des Orchestrierungsknotens setzen.

Datumsattributformatierer – legen Sie das richtige Format fest, wenn Sie Datumsattribute bereitstellen

DateTime-Attributformatierer – Legen Sie das richtige Format fest, wenn Sie Datums-/Uhrzeitattribute bereitstellen

Festlegen generischer Zuordnungen

Zielvorlage - Vorlage, aus deren Workflow Sie diese Aufgabe aufrufen möchten
Zielordner - Ordner für Ihre Daten

Keine Attribute für die Zuordnungstabelle festlegen (externes Attribut – lokales Attribut). Die Attributzuordnung erfolgt auf dem Workflow-Orchestrierungsknoten.

3. Aufgabe speichern

4. Erstellen Sie einen Orchestrierungsknoten für Ihren Workflow, um diese ereignisbasierte Aufgabe aufzurufen

Orchestrate – Pro -Engine
Datenquelle – Generische REST API
Aktivität – Generischer REST Aufruf
Ziel – Ticket als Serviceanfrage erstellen (Ihr ereignisbasierter Aufgabenname)
Aktion – In diesem Beispiel POST, da wir Tickets mit API erstellen, die Tickets erstellt.
REST URL – in diesem Beispiel create?activitytype=6, da wir Tickets mit Aktivitätstyp 6 erstellen
REST Text – Sie können den Text API Aufrufs direkt hier generieren. In komplizierteren Fällen können Sie ihn auch separat (im Skriptknoten) für ein Attribut generieren und dieses Attribut dann hier verwenden. In diesem Fall wird der Text zum Erstellen des Tickets direkt hier erstellt, wobei die Attributcodevariablen „Betreff“ und „Details“ verwendet werden.
Der in diesem Beispiel verwendete Textkörper hat einen fest codierten Benutzer (Sie könnten in Erwägung ziehen, hierfür eine andere Logik zu verwenden). Die Werte für Betreff und Beschreibung werden aus den Betreff- und Detailattributen der Datenkarten gelesen.
{
"Betreff": "$subject$",
"Beschreibung": "$details$",
"Priorität": 0,
"Auswirkung": 0,
"Dringlichkeit": 0,
"Benutzer":"0e8aac28-b2df-ef11-58b1-005056905558"
}

REST Antwortattribut – die Antwort des API Aufrufs wird in diesem Attribut gespeichert
Pro -Ausnahme – wenn es ein Problem mit API Aufruf gibt, wird die Ausnahme in diesem Attribut gespeichert

Finalisieren Sie Ihren Workflow, andere Knoten und Flows

Workflow speichern und veröffentlichen

5. Testen Sie Workflow und ereignisbasierte Aufgaben

Einschränkungen im Jahr 2025.3

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