M42 CoreProIGA Anschluss
So integrieren Sie Matrix42 Core , Pro oder IGA Lösung in eine andere Instanz der Matrix42 Core , Pro oder IGA -Lösung
M42 CoreProIGA Anschluss
So integrieren Sie Matrix42 Core , Pro oder IGA Lösung in eine andere Instanz der Matrix42 Core , Pro oder IGA -Lösung
M42 CoreProIGA Anschluss
M42 CoreProIGA Connector (früher Efecte Connector / Efecte ESM Connector) ist Teil der Connector Management Native Connectors und dient zum Lesen/Schreiben von Datenkarten in andere Matrix42 Core , Pro oder IGA -Lösungen. Er kann für alle Matrix42 Core , Pro oder IGA -Lösungen verwendet werden, die Pro Engine verwenden.
M42 CoreProIGA Connector muss entsprechend dem Anwendungsfall des Kunden konfiguriert werden. Die Konfiguration umfasst grundsätzlich drei (3) Schritte:
- Connector konfigurieren – ermöglicht dem Connector, eine Verbindung zur Ziellösung Matrix42 Core Pro IGA herzustellen
- Geplante Aufgabe konfigurieren – wird verwendet, wenn Daten aus der Matrix42 Core Pro IGA -Ziellösung gelesen werden
- Ereignisaufgabe konfigurieren – wird verwendet, wenn Daten in die Ziellösung Matrix42 Core Pro IGA geschrieben werden
- Außerdem müssen Workflow-Orchestrierungsknoten konfiguriert werden (Erstellen/Aktualisieren/Löschen von Datenkarten).
Wichtig zu wissen!
Beim M42 CoreProIGA Konnektor müssen Sie besonders darauf achten, dass keine Endlosschleife zwischen zwei Matrix42 Core Pro IGA -Lösungen entsteht. Dies kann passieren, wenn Daten in eine andere Matrix42 Core Pro IGA Lösung geschrieben werden und der Workflow-Orchestrierungsknoten nicht für eine der verzögernden Aktivitäten konfiguriert ist:
Timer
Genehmigung
Wartebedingung
Manuelle Aufgabe (wenn der Knoten beim Rollback nicht sofort als erledigt markiert wird)
Anweisungen für die Version 2024.2 und neuer
Allgemeine Funktionalitäten
Konnektoren - allgemeine Funktionalitäten
Konnektoren - allgemeine Funktionalitäten
In diesem Artikel werden allgemeine Funktionen zur Verwaltung nativer Konnektoren in der Lösung beschrieben. Alle nativen Konnektoren werden über dieselbe Benutzeroberfläche zur Konnektorverwaltung verwaltet.
Beachten Sie, dass es für jeden Konnektor eine separate Beschreibung gibt, in der die konnektorspezifischen Funktionen und Konfigurationsanweisungen detailliert beschrieben werden.
Um auf die Connector-Verwaltung zugreifen zu können, benötigt der Benutzer Administratorrechte für die Plattformkonfiguration des Kunden. Bei korrekter Zugriffsberechtigung wird die Registerkarte „Connector“ angezeigt und der Benutzer kann die Connectors verwalten.
Linkes Menü
Die Connector-Verwaltung ist in vier Registerkarten unterteilt:
- Übersicht – zum Erstellen und Aktualisieren nativer Konnektoren. Der Administrator kann deren Status und Typ sowie die Anzahl der ihnen zugeordneten geplanten oder ereignisbezogenen Aufgaben sehen.
- Authentifizierung – zum Erstellen und Aktualisieren von Authentifizierungsaufgaben. Für Secure Access ist Pro Bereitstellungsaufgabe für die Authentifizierung erforderlich, um festlegen zu können, welche Endbenutzer des Kunden auf die Anmeldeseite Matrix42 Core , Pro and IGA zugreifen können.
- Protokolle – zum Herunterladen von Native Connector- und Secure Access Protokollen von der Benutzeroberfläche.
- Einstellungen – allgemeine Einstellungen für native Konnektoren und Secure Access , einschließlich Umgebungstyp für Protokollierung und Überwachung.
Registerkarte „Konnektorenübersicht“
Auf der Übersichtsseite kann der Benutzer einfach und schnell den Status aller Konnektoren sehen.
Obere Leiste:
- Status für native Konnektoren (EPE)
- Grüner Text zeigt an, dass Native Connectors online ist. Alle benötigten Dienste sind aktiv und werden ausgeführt.
- Roter Text weist darauf hin, dass ein Problem mit Native Connectors vorliegt und nicht alle Dienste ausgeführt werden.
- Status für Secure Access ( ESA )
- Grüner Text zeigt an, dass Secure Access online ist. Alle erforderlichen Dienste sind aktiv und werden ausgeführt.
- Roter Text zeigt an, dass ein Problem mit Secure Access vorliegt und alle Dienste nicht ausgeführt werden.
- Die Versionsnummer des nativen Connectors wird in der oberen rechten Ecke angezeigt
Obere Leiste für die Listenansicht:
- Neuer Connector – öffnet ein neues Fenster zum Hinzufügen und Konfigurieren eines neuen Connectors
- Konnektor(en) entfernen – Workflow-Referenzen werden berechnet und ein Popup-Fenster wird angezeigt, um die Entfernung zu bestätigen (beachten Sie, dass die Berechnung der Referenzen mehrere Sekunden dauern kann).
- Exportieren – Der Administrator kann einen oder mehrere Konnektoren (und Aufgaben) aus der Umgebung exportieren. Wird normalerweise zum Exportieren von Konnektoren und Konnektoren (und Aufgaben) vom Test in die Produktion verwendet. Die geheimen Informationen nativer Konnektoren sind passwortgeschützt.
- Importieren – Der Administrator kann einen oder mehrere Konnektoren (und Aufgaben) in die Umgebung importieren. Wird normalerweise zum Importieren von Konnektoren (und Aufgaben) vom Test in die Produktion verwendet.
- Der Administrator kann nicht von der alten EPE-Benutzeroberfläche (älter als 2024.1) in die neue importieren. Quell- und Zielumgebung müssen dieselbe Version haben.
- Der Import schlägt fehl, wenn die Konfiguration (Vorlagen, Attribute) nicht identisch ist – zum Beispiel wenn ein Attribut fehlt
- Wenn Sie etwas mit den gleichen Connector-Details importieren, wird es unter dem vorhandenen Connector zusammengeführt
- Aktualisieren – Der Administrator kann die Connector-Ansicht aktualisieren, indem er auf die Schaltfläche klickt .
Listenansicht zur Übersicht,
- Konnektor(en) auswählen - Wählen Sie einen Konnektor aus, indem Sie das Kontrollkästchen vor der Konnektorzeile anklicken. Durch Anklicken des Kontrollkästchens in der Kopfzeile werden alle Konnektoren ausgewählt.
- ID – Automatisch generierte eindeutige ID des Connectors. Kann nicht bearbeitet oder geändert werden.
- Status – zeigt den Status der geplanten Aufgabe an
-
Grünes Häkchen - Aufgabe wird ohne Fehler ausgeführt
-
Rotes Kreuz - Aufgabe wird ausgeführt, aber es sind Fehler aufgetreten
-
Graue Uhr – Aufgabe wurde noch nicht ausgeführt, wartet auf Planung -
Orange – eine der Aufgaben hat ein Problem
- Kein Wert – geplante basierte Aufgabe fehlt
-
- Name – Konnektorname, der den Konnektoreinstellungen hinzugefügt wurde. Eindeutiger Name des Konnektors, der die Konfiguration für eine Datenquelle enthält
- Typ – gibt das Ziel-/Quellsystem an
- Geplant – informiert darüber, wie viele geplante Aufgaben konfiguriert sind
- Ereignis - informiert darüber, wie viele Ereignisaufgaben konfiguriert sind
- Verwalten
- Stiftsymbol – öffnet die Konnektoreinstellungen (durch Doppelklicken auf die Konnektorzeile werden auch die Einstellungen geöffnet)
- Papiersymbol – kopiert den Konnektor
- Stopp – Workflow-Referenzen werden berechnet und ein Popup-Fenster wird angezeigt, um die Entfernung zu bestätigen
- Suchen – Der Benutzer kann den Connector suchen, indem er den Suchbegriff in das entsprechende Feld eingibt. Die Felder ID, Status, Name, Typ, Geplant und Ereignis können durchsucht werden.
Informationen zu geplanten Aufgaben (klicken Sie auf den Pfeil vor dem Connector)
Wenn Sie auf den Pfeil am Anfang der Verbindungszeile klicken, werden alle zugehörigen geplanten und ereignisbezogenen Aufgaben angezeigt
Obere Leiste für geplante Aufgaben
- Neue Aufgabe – öffnet die Konfigurationsseite für eine neue Aufgabe
- Aufgabe(n) entfernen – entfernt die ausgewählte(n) Aufgabe(n) aus dem System und sie können nicht mehr wiederhergestellt werden.
- Aktualisieren – Aktualisieren Sie die Ansicht geplanter Aufgaben
- Suche – Der Benutzer kann nach Aufgaben suchen, indem er den Suchbegriff in das entsprechende Feld für ID, Name, aktiviert, Extrahieren/Laden-Status eingibt.
Listenansicht für geplante Aufgaben
- Aufgabe(n) auswählen - Wählen Sie die zu löschende Aufgabe aus der Listenansicht durch Ankreuzen aus.
- ID – Eindeutige ID der Aufgabe. Wird automatisch generiert und kann nicht geändert werden.
- Name – Den Aufgabeneinstellungen hinzugefügter Aufgabenname, eindeutiger Name der Aufgabe.
- Aktiviert – Zeigt an, ob die Aufgabe geplant ist oder nicht
-
Grünes Häkchen – Aufgabe ist geplant
-
Rotes Kreuz – Aufgabe ist nicht geplant
-
- Extraktionsstatus – Zeigt den Status der Datenextraktion aus dem Zielverzeichnis/-system an
- Grünes Häkchen – Daten wurden erfolgreich extrahiert
- Rotes Kreuz – Daten wurden mit Fehler(n) extrahiert oder die Extraktion ist fehlgeschlagen
-
Uhr – Aufgabe wartet auf Ausführung
-
- Ladestatus – Zeigt den Status des Datenexports aus der JSON-Datei zur Kundenlösung an
- Grünes Häkchen – Daten wurden erfolgreich in die Kundenlösung importiert
-
Rotes Kreuz – Daten wurden mit Fehler(n) importiert oder der Import ist fehlgeschlagen
-
- Verwalten
- Stiftsymbol – öffnet die Aufgabeneinstellungen in einem eigenen Fenster (durch Doppelklicken auf die Aufgabenzeile werden die Aufgabeneinstellungen ebenfalls geöffnet)
- Papiersymbol – kopiert die Aufgabe
- Uhrensymbol – öffnet die Aufgabenverlaufsansicht
- Stopp - Aufgabe entfernen, Popup-Fenster öffnet sich, um das Entfernen zu bestätigen
Verlaufsansicht geplanter Aufgaben
Durch Klicken auf das Uhrensymbol in der Zeile mit den geplanten Aufgaben wird der Zeitplanverlauf angezeigt.
Obere Leiste für den Anzeigeverlauf
- Aktualisieren – Aktualisiert den Status der geplanten Aufgabe. Dies hat keine Auswirkungen auf die Aufgabe, sondern aktualisiert lediglich die Benutzeroberfläche, um die neuesten Informationen zum Aufgabenlauf anzuzeigen.
Listenansicht für den Verlauf geplanter Aufgaben
- Die Farbe der Zeile zeigt den Status an
- Grün – Aufgabe erfolgreich ausgeführt
- Rot – während der Ausführung ist ein Fehler aufgetreten
-
- Ausführungs-ID – eindeutige ID für die geplante Aufgabenzeile
- Geplanter Zeitpunkt des Extrahierens – wann der nächste Extrahieren aus dem Verzeichnis/der Anwendung erfolgen soll
- Zeitpunkt der Extraktionsfertigstellung – wann die Extraktion abgeschlossen wurde
- Status extrahieren - Status zum Abrufen von Daten aus dem Verzeichnis/der Anwendung
- Ladestartzeit – wann die nächste Ladung zur Kundenlösung erfolgen soll
- Ladeabschlusszeit – wann der Ladevorgang abgeschlossen war
- Ladestatus - Status zum Laden von Informationen zur Kundenlösung
Listenansicht für den Status geplanter Aufgaben
- Tatsächliche Startzeit - Zeitstempel für den tatsächlichen Start
- Benutzerdatei – JSON-Datei mit Benutzerinformationen, die aus dem Verzeichnis/der Anwendung gelesen wurden
- Gruppendatei – JSON-Datei mit Gruppeninformationen, die aus dem Verzeichnis/der Anwendung gelesen wurden
- Generische Datei – JSON-Datei mit allgemeinen Informationen, die aus dem Verzeichnis/der Anwendung gelesen wurden
- Informationen extrahieren - detaillierte Informationen zum Lesen von Informationen aus dem Verzeichnis/der Anwendung
- Ladeinformationen - detaillierte Informationen zum Laden der Informationen für Matrix42 Core , Pro and IGA -Lösung des Kunden
Bearbeitungsfenster für geplante Aufgabe
Die Konfiguration für geplante Aufgaben kann durch Klicken auf das Stiftsymbol oder Doppelklicken auf die Aufgabenzeile geöffnet werden.
Das linke Menü und die Attribute variieren je nach den ausgewählten Optionen. Ausführlichere Anweisungen zum Bearbeiten von Aufgaben finden Sie daher in der Connector-Beschreibung. Es gibt jedoch gemeinsame Funktionen für alle geplanten Aufgaben, die unten beschrieben werden.
Speichern der Aufgabe
Falls in der Aufgabe obligatorische Informationen fehlen, können Sie durch Bewegen der Maus über die Schaltfläche „Speichern“ anzeigen, welche Attribute noch leer sind.
Obere Leiste zum Bearbeiten geplanter Aufgaben
- Aufgabe manuell ausführen – Der Administrator kann Aufgaben außerhalb der definierten Planung manuell ausführen
- Aufgabe stoppen – Der Administrator kann eine geplante Aufgabe stoppen, die aktuell ausgeführt wird. Die Aufgabe wird gestoppt und der Status auf „Gestoppt“ geändert. Die Aufgabe wartet in diesem Zustand bis zum nächsten Zeitpunkt.
- Datencache leeren – Der Datencache für die nächste Bereitstellung von Benutzern und Gruppen wird geleert. Dies bedeutet, dass der nächste Lauf wie beim ersten Lauf ausgeführt wird.
- Standardmäßig leeren wir den Cache jeden Tag um 00:00 UTC
- Wenn Sie den Cache zu einem anderen Zeitpunkt leeren möchten, müssen Sie in der Hostdatei „custom.properties“ einen anderen Wert angeben.
- Der EPE-Cache wird auch gelöscht, wenn EPE neu gestartet wird, die gesamte Umgebung neu gestartet wird und EPE-Zuordnungen geändert wurden
Informationen zur Ereignisaufgabe
Wenn Sie auf den Pfeil am Anfang der Verbindungszeile klicken, werden alle zugehörigen geplanten und ereignisbezogenen Aufgaben angezeigt
Obere Leiste für Ereignisaufgaben
- Neue Aufgabe – öffnet die Konfigurationsseite für eine neue Ereignisaufgabe
- Aufgabe(n) entfernen - entfernt ausgewählte Aufgabe(n), ein Popup-Fenster erscheint, um die Entfernung zu bestätigen
- Aktualisieren – aktualisiert die Ereignisaufgabenansicht
- Workflow-Referenzen anzeigen - berechnet aufgabenbezogene Workflow-Beziehungen und Status. Dies ist sehr nützlich, wenn Sie nicht wissen, aus welchen Workflows ereignisbasierte Aufgaben verwendet werden.
Listenansicht für Ereignisaufgaben
- Aufgabe(n) auswählen - Wählen Sie die zu löschende Aufgabe aus der Listenansicht durch Ankreuzen aus.
- ID – Eindeutige ID der Aufgabe. Wird automatisch generiert und kann nicht geändert werden.
- Name – Den Aufgabeneinstellungen hinzugefügter Aufgabenname, eindeutiger Name der Aufgabe.
- Workflow-Beziehungen
- Fragezeichen zeigt Popup-Fenster mit detaillierten Informationen zur Referenz
- Workflow-Status
- Nicht verwendet – Keine Beziehung zum Workflow
- In Verwendung – Workflow(s) an Aufgabe angehängt, Aufgabe kann nicht entfernt werden
- Verwalten
- Stiftsymbol – öffnet Aufgabeneinstellungen in einem eigenen Fenster
- Papiersymbol – kopiert die Aufgabe
- Stoppsymbol - entfernt die Aufgabe, ein Popup-Fenster wird angezeigt, um das Entfernen zu bestätigen
Bearbeitungsfenster für Ereignisaufgabe
Die Konfiguration für Ereignisaufgaben kann durch Klicken auf das Stiftsymbol oder Doppelklicken auf die Aufgabenzeile geöffnet werden.
Das linke Menü und die Attribute variieren je nach ausgewählten Optionen. Ausführlichere Anweisungen zum Bearbeiten von Aufgaben finden Sie daher in der Connector-Beschreibung. Es gibt jedoch gemeinsame Funktionen für alle Ereignisaufgaben, die unten beschrieben werden.
Fenster „Ereignisaufgabe bearbeiten“
- Aufgabennutzung, bearbeitbar? - Dies wird angezeigt, wenn die Bearbeitung einer vorhandenen Aufgabe und die Änderung des Aufgabennutzungstyps Arbeitsabläufe unterbricht.
- Zuordnungstyp, bearbeitbar? - Dies wird angezeigt, wenn die Bearbeitung einer vorhandenen Aufgabe und die Änderung des Zuordnungstyps Arbeitsabläufe unterbricht.
Speichern der Aufgabe
Falls in der Aufgabe obligatorische Informationen fehlen, können Sie durch Bewegen der Maus über die Schaltfläche „Speichern“ sehen, welche Attribute noch leer sind.
Registerkarte „Authentifizierung“
Die Authentifizierung für Matrix42 Core , Pro and IGA Lösungen wird über die Registerkarte „Authentifizierung“ konfiguriert. Beachten Sie, dass nur einige der Konnektoren (Verzeichniskonnektoren) die Authentifizierung unterstützen. Daher ist es nicht möglich, Authentifizierungsaufgaben für alle verfügbaren Konnektoren zu erstellen.
Obere Leiste zur Authentifizierung
- Neuer Connector – öffnet ein neues Fenster zum Konfigurieren eines neuen Connectors (beachten Sie, dass nicht alle Connectors die Authentifizierung unterstützen)
- Konnektor(en) entfernen – entfernt ausgewählte Aufgabe(n), ein Popup-Fenster wird angezeigt, um die Entfernung zu bestätigen
- Exportieren – Der Benutzer kann eine oder mehrere Aufgaben aus der Umgebung exportieren. Wird normalerweise zum Exportieren von Aufgaben vom Test in die Produktion verwendet. EPE-Konnektoren sind passwortgeschützt.
- Beachten Sie, dass Realm für Authentifizierungsaufgaben nicht exportiert wird. Sie müssen dies nach dem Import manuell einstellen
- Importieren – Der Benutzer kann eine oder mehrere Aufgaben in die Umgebung importieren. Wird normalerweise zum Importieren von Aufgaben vom Test in die Produktion verwendet.
- Aktualisieren – aktualisiert die Ansicht der Authentifizierungsaufgaben
Listenansicht zur Authentifizierungsübersicht
- Konnektor(en) auswählen - Wählen Sie einen Konnektor aus, indem Sie das Kontrollkästchen vor der Konnektorzeile anklicken. Durch Anklicken des Kontrollkästchens in der Kopfzeile werden alle Konnektoren ausgewählt.
- ID – Automatisch generierte eindeutige ID des Connectors. Kann nicht bearbeitet oder geändert werden.
- Name – Konnektorname, der den Konnektoreinstellungen hinzugefügt wurde. Eindeutiger Name des Konnektors, der die Konfiguration für eine Datenquelle enthält
- Typ – gibt das Ziel-/Quellsystem an
- Anzahl - informiert darüber, wie viele Authentifizierungsaufgaben konfiguriert sind
- Verwalten
- Stiftsymbol – öffnet die Authentifizierungsaufgabeneinstellung in einem eigenen Fenster
- Papiersymbol – kopiert die Aufgabe
- Stoppsymbol – entfernt ausgewählte Aufgabe
Informationen zur Authentifizierungsaufgabe
Wenn Sie auf den Pfeil am Anfang der Verbindungszeile klicken, werden alle zugehörigen geplanten und ereignisbezogenen Aufgaben angezeigt
Obere Leiste für die Authentifizierungsübersicht
- Neue Aufgabe erstellen – öffnet die Konfigurationsseite für eine neue Authentifizierungsaufgabe
- Aufgabe(n) entfernen - entfernt ausgewählte Aufgabe(n), ein Popup-Fenster erscheint, um die Entfernung zu bestätigen
- Aktualisieren – aktualisiert die Ansicht der Authentifizierungsaufgaben
Listenansicht zur Authentifizierungsübersicht,
- Aufgabe(n) auswählen - Wählen Sie die zu löschende Aufgabe aus der Listenansicht durch Ankreuzen aus.
- ID – Eindeutige ID der Aufgabe. Wird automatisch generiert und kann nicht geändert werden.
- Name – Den Aufgabeneinstellungen hinzugefügter Aufgabenname, eindeutiger Name der Aufgabe.
- Verwalten
- Stiftsymbol – öffnet die Aufgabeneinstellungen in einem eigenen Fenster (ein Doppelklick auf die Aufgabenzeile öffnet auch das Einstellungsfenster)
- Papiersymbol – kopiert die Aufgabe
- Stoppsymbol - entfernt die Aufgabe, ein Popup-Fenster wird angezeigt, um das Entfernen zu bestätigen
Registerkarte „Protokolle“
Die Registerkarte „Protokolle“ dient zum Herunterladen von Native Connector- und Secure Access Protokollen von der Benutzeroberfläche zur detaillierten Fehlerbehebung.
- epe-master -Protokolle – enthalten Warn-, Debug- und Fehlermeldungen zu nativen Konnektoren und Informationen darüber, wie lange Aufgabenaktionen ausgeführt wurden.
- epe-worker-ad- Protokolle – enthalten den Status der extrahierten Daten des Active Directory Connectors (was der Native Connector in Matrix42 Core , Pro and IGA -Lösung des Kunden lädt). Wenn die Auswahl leer ist, bedeutet dies, dass das Verzeichnis in dieser Umgebung nicht verwendet wird.
- epe-worker-azure -Protokolle – enthält den extrahierten Datenstatus der Entra ID (was der Native Connector in Matrix42 Core , Pro and IGA Lösung des Kunden lädt). Wenn die Auswahl leer ist, bedeutet dies, dass das Verzeichnis in dieser Umgebung nicht verwendet wird.
- epe-worker-ldap -Protokolle – enthalten den Status der extrahierten Daten von LDAP (was der Native Connector in Matrix42 Core , Pro and IGA Lösung des Kunden lädt). Wenn die Auswahl leer ist, bedeutet dies, dass das Verzeichnis in dieser Umgebung nicht verwendet wird.
- epe-launcher logs - enthält Informationen zu EPE-Starts
- datapump-itsm logs – Enthält Informationen zum Datenexport an Matrix42 Core , Pro and IGA Lösung des Kunden.
- esa logs – Enthält Informationen zur Secure Access Authentifizierung.
Registerkarte „Einstellungen“
Die Registerkarten „Einstellungen“ werden zum Überwachen von Umgebungen mit Konnektoren verwendet.
- Umgebungstyp – muss zwingend ausgewählt werden und die Informationen werden beispielsweise zum Definieren kritischer Warnungen verwendet.
- Test – wählen Sie diese Option, wenn Ihre Umgebung als Testumgebung verwendet wird.
- Pro d - wählen Sie dies, wenn Ihre Umgebung als Produktionsumgebung verwendet wird
- Demo - wählen Sie diese Option, wenn Ihre Umgebung als Demo- oder Schulungsumgebung verwendet wird
- Dev – wählen Sie dies, wenn Ihre Umgebung als Entwicklungsumgebung verwendet wird
Was überwachen wir?
- Fehler bei der zeitplanbasierten Bereitstellung (Extrahieren von Daten, Exportieren von Daten nach ESM, veraltete Zertifikate, falsche Passwörter, falsche Suchbasis/Filter, falsche Zuordnungen usw.)
- Fehler bei der ereignisbasierten Bereitstellung (Fehler beim Schreiben in AD / Azure usw.)
- Ereignisbasierte Bereitstellung – welche Konnektoren werden zum Schreiben von Daten in Anwendungen/Verzeichnisse verwendet.
- ESA Mehr als zehn fehlgeschlagene Anmeldeversuche für einen Benutzer in den letzten drei Tagen
- Umgebungstyp – muss zwingend ausgewählt werden und die Informationen werden beispielsweise zum Definieren kritischer Warnungen verwendet.
Datenmigrationen
Klicken Sie nicht auf „Attributzuordnungen migrieren“ oder „Workflows migrieren“, wenn Sie nicht von Matrix42 dazu aufgefordert werden.
Efecte-Connector konfigurieren
In diesem Kapitel werden Konfigurationsanweisungen für den Efecte-Connector beschrieben, um eine Verbindung zu einer anderen Efecte-Lösung herstellen zu können.
Sehen Sie sich anhand des Bildes an, wie zwei Efecte-Lösungen benannt sind, damit Sie den Anweisungen leichter folgen können.
Für den Zugriff auf die Connector-Verwaltung muss der Benutzer über Berechtigungen zur Efecte-Plattformkonfiguration verfügen.
1. Öffnen Sie den Efecte-Administrationsbereich (ein Zahnradsymbol).
2. Öffnen Sie die Konnektoransicht.
3. Neuen Connector auswählen
4. Wählen Sie den Datenquellentyp Efecte
5. Informationen zur Efecte 1 -Lösung erfüllen
- Connector-Name – geben Sie Ihrem Connector einen benutzerfreundlichen Namen (der Name kann später geändert werden)
- Host-URL – Hostadresse, die für die Verbindung mit der Efecte-Lösung verwendet wird
- Benutzername – Efecte 1-Lösung Web API Benutzername
- Passwort - Efecte 1 Lösung Web- API Benutzerpasswort
6. Informationen zur Efecte 2 -Lösung erfüllen
- Web API Benutzer – Efecte 2-Lösung Web API Benutzername
- Liste aller lokalen Efecte-Benutzer
- Web API Passwort - Efecte 2 Lösungen Web- API -Benutzerpasswort
7. Steckerinformationen speichern.
7. Nachdem Sie die Connector-Details gespeichert haben, können Sie auf die Schaltfläche „Verbindung testen“ klicken und testen, ob der Connector eine Verbindung zur Ziellösung von Efecte herstellen kann.
9. Wenn Sie vorhandene Connector-Details bearbeiten, denken Sie daran, Ihre Änderungen zu speichern und anschließend die Verbindung zu testen.
Allgemeine uid für geplante Aufgaben
Allgemeine uid für geplante Aufgaben
So erstellen Sie eine neue geplante Aufgabe zum Importieren von Daten
Zum Konfigurieren zeitplanbasierter Bereitstellungsaufgaben benötigen Sie Zugriff auf die Registerkarte „Administration/Konnektoren“.
1. Öffnen Sie den Administrationsbereich (ein Zahnradsymbol).
2. Öffnen Sie die Connectors- Ansicht.
3. Wählen Sie Connector für geplante Aufgaben und wählen Sie Neue Aufgabe
Hinweis! Wenn kein Connector erstellt wird, müssen Sie zuerst „Neuer Connector“ und danach „ Neue Aufgabe“ auswählen.
4. Fahren Sie mit den Connector-spezifischen Anweisungen fort: Native Connectors
Soll ich inkrementell, vollständig oder beides verwenden?
Geplante Aufgaben können entweder inkrementell oder vollständig sein.
Importieren Sie keine Berechtigungen mit AD und LDAP-Inkrementalaufgaben
Bei inkrementellen Aufgaben treten Probleme beim Importieren von Berechtigungen auf. Derzeit wird empfohlen, Gruppenmitgliedschaften nicht mit inkrementellen geplanten Aufgaben zu importieren.
Entfernen Sie bei Microsoft Active Directory und OpenLDAP Konnektoren diese Zuordnung bei inkrementellen Aufgaben:
Einstellungen für geplante Aufgaben:
Der inkrementelle Typ wird nur für Microsoft Active Directory , LDAP- und Microsoft Graph API Konnektoren (früher bekannt als Entra ID ) unterstützt.
Inkrementeller Typ bedeutet, dass Native Connectors (EPE) Daten vom Quellsystem abruft und dabei geänderte Zeitstempelinformationen verwendet. Es werden also nur Daten abgerufen, die nach der vorherigen Ausführung der inkrementellen Aufgabe geändert oder hinzugefügt wurden.
Beim ersten Ausführen einer inkrementellen Aufgabe wird ein vollständiger Abruf durchgeführt (und der aktuelle Zeitstempel in der EPE-Datenbank markiert). Anschließend verwendet die Aufgabe diesen Zeitstempel, um die Datenquelle nach Daten zu fragen, die sich seit diesem Zeitstempel geändert haben (und EPE aktualisiert den Zeitstempel in der EPE-Datenbank für den nächsten Aufgabenlauf). Das Leeren des Aufgabencaches hat keinen Einfluss auf diesen Zeitstempel, daher ist die inkrementelle Aufgabe nach dem ersten Ausführen immer inkrementell.
Der vollständige Typ wird für alle Konnektoren unterstützt.
Der vollständige Typimport ruft bei jedem Durchlauf immer alle Daten (für deren Abruf er konfiguriert ist) vom Quellsystem ab.
Sowohl vollständige als auch inkrementelle Aufgaben verwenden auch den Aufgabencache in EPE, wodurch bestimmte Importe für M42 System schneller und einfacher werden.
Standardmäßig wird der Task-Cache um Mitternacht (UTC) geleert. Nach dem Leeren des Caches wird der nächste Import ohne Zwischenspeicherung ausgeführt, um zu entscheiden, ob die abgerufenen Daten an ESM gesendet werden sollen. Alle abgerufenen Daten werden an ESM gesendet. Danach wird der nächste Task ausgeführt, bis der Cache erneut geleert wird. Dabei wird der EPE-Cache verwendet, um zu bestimmen, ob die abgerufenen Daten an ESM gesendet werden sollen oder nicht.
Sie können konfigurieren, zu welcher Tageszeit der Task-Cache geleert wird, indem Sie die globalen Einstellungen in der EPE-Datapump-Konfiguration ändern:
/opt/epe/datapump-itsm/config/ benutzerdefinierte .properties
Dies ist standardmäßig auf clearCacheHours24HourFormat=0 eingestellt.
Sie können den Cache auch mehrmals täglich leeren, aber das muss sorgfältig überlegt werden, da es Auswirkungen auf die Gesamtleistung hat, da EPE Änderungen an ESM weitergibt, die wahrscheinlich bereits vorhanden sind, Beispiel (fügen Sie dem Attributwert keine Leerzeichen hinzu): clearCacheHours24HourFormat=6,12
Starten Sie den EPE-Datapump-Container nach der Änderung dieses Werts neu, um die Änderung zu übernehmen.
Empfehlungen:
Standardmäßig ist immer der vollständige Typ der geplanten Aufgabe verfügbar.
Wenn Sie Änderungen an Daten, die bereits durch die vollständige Aufgabe abgerufen wurden, häufiger abrufen möchten, als Sie die vollständige Aufgabe ausführen können, fügen Sie auch eine inkrementelle Aufgabe hinzu. Normalerweise ist eine inkrementelle Aufgabe nicht erforderlich.
Empfohlene Planungsreihenfolge
Die empfohlene Planungssequenz hängt davon ab, wie viele Daten aus dem System/Verzeichnis des Kunden in die Matrix42 Core , Pro oder IGA Lösung gelesen werden und ob der Import inkrementell oder vollständig erfolgt.
Beispiele für die Terminplanung,
| Gesamtzahl der Benutzer | Gesamtzahl der Gruppen | Volllastsequenz | Inkrementelle Ladesequenz |
| < 500 | < 1000 | Alle 30 Minuten, wenn keine Teillast genutzt wird Vier (4) Mal täglich bei Teillast |
Alle 10 Minuten |
| < 2000 | < 2000 | Alle 60 Minuten, wenn keine Teillast genutzt wird Vier (4) Mal täglich bei Teillast |
Alle 15 Minuten |
| < 5000 | < 3000 | Alle vier (4) Stunden, wenn keine Teillast verwendet wird Bei Teillast zweimal täglich |
Alle 15 Minuten |
| < 10 000 | < 5000 | Maximale Importe zweimal täglich, egal ob Teilladung genutzt wird oder nicht | Alle 30 Minuten |
| < 50 000 | < 7000 | Maximale Einfuhr einmal täglich, unabhängig davon, ob Teilladung genutzt wird oder nicht | Alle 60 Minuten |
| Über 50.000 | Über 7000 | Möglicherweise besteht Bedarf an einem weiteren EPE-Mitarbeiter. Bitte wenden Sie sich an den Pro . | Getrennt ausgewertet |
Bitte beachten Sie, dass bei gleichzeitiger Ausführung mehrerer Aufgaben möglicherweise mehr EPE-Worker benötigt werden. Die Aufgaben sollten zu unterschiedlichen Zeiten geplant und gemäß der obigen Tabelle abgeschlossen werden. Laufen jedoch mehr als sechs Aufgaben gleichzeitig, sollte die Anzahl der EPE-Worker erhöht werden. Es empfiehlt sich, Aufgaben möglichst nicht gleichzeitig auszuführen.
Empfehlungen zur Leistung
Wenn die Menge der zu importierenden Daten über 10.000 liegt, beachten Sie Folgendes:
Passen Sie die Protokollebene von ESM und DATAPUMP auf die ERROR-Ebene an, um den Protokollierungsumfang während der Taskausführung zu verringern
Sorgen Sie dafür, dass möglichst wenige Automatisierungen sofort für importierte Datenkarten (Listener, Handler, Workflows) gestartet werden, da diese dazu führen, dass ESM mehr Zeit für die Verarbeitung neuer Datenkarten benötigt.
Setzen Sie den Status entfernter Konten und Berechtigungen auf „entfernt/deaktiviert“.
Mit dieser Funktion können Sie den Status von Konten und Berechtigungen beispielsweise als „Gelöscht“ oder „Deaktiviert“ markieren, wenn das Konto oder die Berechtigung aus dem Quellsystem entfernt wird. Ab Version 2025.3 können Sie den Status auch für generische Objekte festlegen (nicht nur für Konten/Identitäten und Berechtigungen/Gruppen).
Für Version 2025.3 und neuer
In Version 2025.3 wurden diese Einstellungen aus den Eigenschaftendateien in die Task-Benutzeroberfläche verschoben. Außerdem können Sie diese Einstellungen jetzt für generische Objekte festlegen, was vor dieser Version nicht möglich war.
Für jede geplante Aufgabe und für alle Zuordnungstypen gibt es eine separate Konfiguration. Hier ist ein Beispiel für diese Konfiguration für die Aufgabe:
Für Version 2025.2 und älter
Diese Funktion ist für geplante Aufgaben des Typs „vollständig“ verfügbar.
Die Einstellungen befinden sich in der Konfigurationsdatei des Datapump-Dockers. Um diese Parameterwerte zu ändern, müssen Sie sie in der Datei /opt/epe/datapump-itsm/config/custom.properties festlegen.
Konfiguration
Um die Deaktivierungsfunktion zu aktivieren, müssen in der Datapump-Konfiguration die folgenden Parameter auf „true“ gesetzt sein:
disable.unknown. esm .users=true
disable.unknown. esm .groups=true
Diese beiden Parameter sind in den Versionen 2024.2 und 2025.1 standardmäßig „false“. In 2025.2 und neueren Versionen sind sie standardmäßig „true“.
Als nächstes folgen diese Parameter:
personTemplateStatusCodeAttributeKey=accountStatus
personTemplateStatusAttributeDisabledValueKey=Deleted
groupTemplateStatusCodeAttributeKey=status
groupTemplateStatusAttributeDisabledValueKey=5 - Removed
Die ersten beiden Attribute sollten auf das Attribut „DatacardHiddenState“ in der Benutzervorlage verweisen und angeben, welcher Wert dorthin gesendet werden soll, wenn der Benutzer gelöscht wird.
Standardmäßig sind es accountStatus und „Value 5 - Removed in IGA Account .
All dies muss mit der Attributkonfiguration übereinstimmen:
Dasselbe gilt für die nächsten beiden Parameter, allerdings für Gruppen.‘
Wenn Sie diese Parameter in der Eigenschaftendatei ändern müssen, nehmen Sie die Änderungen im Datapump-Container in der Datei vor: /opt/ epe /datapump-itsm/config/ custom .properties. Diese Änderungen bleiben dann beim Neustart des Containers erhalten und werden beim Neustart nach /opt/ epe /datapump-itsm/config/application.properties kopiert.
Beschreibung
Aufgaben speichern ihre __taskid__ die als Task Id mapping in der Benutzeroberfläche angezeigt wird, zu den Datenkarten. Sie wird dann verwendet, um festzustellen, ob die Datenkarte von dieser Aufgabe hinzugefügt wurde. Falls es mehrere Aufgaben mit unterschiedlichen Benutzergruppen gibt.
Dieses Feld wurde zuvor als Datenquellen-ID verwendet, aber da wir zu dem Modell gewechselt sind, bei dem der Connector mehrere Aufgaben haben kann, kann seine Kennung nicht mehr verwendet werden. Deshalb wurde das Feld stattdessen als Task-ID umfunktioniert.
Nehmen wir Benutzer als Beispiel: Wenn eine Aufgabe ausgeführt wird, wird ESM nach der Liste der Benutzer gefragt, deren Task-ID im Feld Task Id mapping steht und die keinen personTemplateStatusAttributeDisabledValueKey -Wert im personTemplateStatusCodeAttributeKey haben.
Dieses Ergebnis wird dann mit dem verglichen, was die Aufgabe abgerufen hat, und bei den Datenkarten der Benutzer, die nicht abgerufen wurden, wird das Attribut personTemplateStatus auf den in der Konfiguration angegebenen Wert gesetzt – 5 - Removed .
Das folgende Beispielprotokoll zeigt den beschriebenen Vorgang und informiert darüber, dass ein Benutzer entfernt wurde.
Dasselbe gilt für Gruppen, aber stattdessen werden groupTemplateStatus Attribute verwendet.
Hinweise
- Die Funktion funktioniert nur mit geplanten Aufgaben zum vollständigen Abrufen.
- Noch keine Unterstützung für generische Vorlagen, nur Identität und Zugriff
- Bei der Migration von früheren Versionen, in denen noch die Datenquellen-ID verwendet wurde, muss sie mindestens einmal ausgeführt werden, um zuerst die Task-IDs in den Datenkarten festzulegen.
- EPE identifiziert deaktivierte Benutzer oder Gruppen als diejenigen, die aus dem AD entfernt wurden. Derzeit unterstützen wir keine Statusangaben dazu, ob die Entität aktiv ist oder nicht.
- EPE aktiviert Benutzer nicht selbstständig.
- Wenn mehrere Tasks dieselben Benutzer oder Gruppen abrufen, kann die Task-ID in der Datenkarte überschrieben werden, je nachdem, welcher Task zuletzt ausgeführt wurde. Es wird vermutet, dass viele Tasks vom Typ „vollständig“ nicht denselben Benutzer oder dieselbe Gruppe abrufen.
- Nehmen Sie Änderungen an der Konfigurationsdatei immer an benutzerdefinierten Eigenschaften vor. Ändern Sie nicht nur die Anwendungseigenschaften, da diese Änderungen beim Neustart des Containers verloren gehen, wenn Sie nicht dieselben Änderungen an benutzerdefinierten Eigenschaften vorgenommen haben.
Konfigurieren Sie die geplante Aufgabe zum Lesen von Daten
In diesem Kapitel finden Sie Konfigurationsanweisungen, wenn Datenkarten nur von der Quelllösung Efecte gelesen werden.
Beachten Sie auf dem Bild, wie zwei Efecte-Lösungen benannt sind, damit die Anweisungen leichter befolgt werden können.
Zum Konfigurieren zeitplanbasierter Aufgaben benötigen Sie Zugriff auf die Konfigurationskonsole der Efecte-Plattform.
Hinweis! Wenn kein Connector erstellt wird, müssen Sie zuerst einen „neuen Connector“ erstellen. Danach können Sie neue Aufgaben erstellen.
1. Öffnen Sie den Efecte-Administrationsbereich (ein Zahnradsymbol).
2. Öffnen Sie die Konnektoransicht.
3. Wählen Sie den Connector, für den die zeitplanbasierte Aufgabe konfiguriert ist
4. Wählen Sie unter dem richtigen Connector eine neue Aufgabe aus
5. Definieren Sie die Planung für die Aufgabe (ob und wie die geplante Aufgabe regelmäßig ausgeführt werden soll). Wählen Sie die Planungssequenz, die davon abhängt, wie viele Daten in die Efecte-Lösung gelesen werden.
6. Aufgabendetails ausfüllen
- Geben Sie einen eindeutigen Aufgabennamen für die zeitplanbasierte Aufgabe ein. Beachten Sie, dass der Name später nicht mehr geändert werden kann.
- Die Task-Nutzung gibt an, dass es sich um die Task handelt, die zum Lesen oder Schreiben von Daten verwendet wird.
- Beachten Sie, dass die Arbeitsabläufe unterbrochen werden können, wenn der Ereignistyp nachträglich geändert wird.
- Der Zuordnungstyp ist immer generisch
- Filterabfrage – Dies ist optional. Sie können Filter verwenden, um nur bestimmte Datenkarten aus der Efecte-Quelllösung zu lesen. Wenn der Wert leer bleibt, werden alle zur Vorlage gehörenden Datenkarten aus der Efecte-Quelllösung gelesen. Es wird EQL Syntax verwendet, zum Beispiel:
- SELECT-Entität FROM Entität, WHERE entity.template.code = 'system' AND entity.deleted = 0 AND $access_rights_group$ ist nicht null
- EQL Dokumentation: https://docs.efecte.com/webapi-esm/efecte-query-language-description-esm
- Vorlagencode – Vorlagencode der Efecte-Lösung (welche Datenkarten werden aus der Efecte-Lösungsquelle gelesen)
- Ordnercode – Ordnercode der Efecte-Lösung (wo Datenkarten gespeichert werden)
- Tipp! Sie können Listener verwenden, um Datenkarten in andere Ordner zu verschieben
7. Fehlerinformationen eingeben
Optionale Einstellungen für die Fehlerbehandlung. Wenn eine geplante Aufgabe fehlschlägt, kann eine Datenkarte für die Efecte-Lösung (nicht für die Quelllösung) 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.
8. Zuordnungen für generische Vorlagen
Generische Daten werden in jede vom Benutzer gewünschte Vorlage eingelesen und es ist zwingend erforderlich, Zielordner, Datenquellen-ID und eindeutige Werte festzulegen, die zur Identifizierung von Daten zwischen zwei Efecte-Lösungen verwendet werden.
- Zielvorlage – Wählen Sie eine Efecte-Lösungsvorlage aus, in die Daten aus der Efecte-Quelllösung gelesen werden.
- Zielordner – wählen Sie den Efecte-Lösungsordner aus (die Liste wird eingegrenzt, um die Kompatibilität mit der ausgewählten Vorlage zu gewährleisten), in den die Daten aus der Efecte-Quelllösung gelesen werden.
- Attributzuordnungen
- Auf der linken Seite: Quelle Efecte Lösungsattribut
- Die Datenquellen-ID (Datasourceid) ist der Name der Connector-Aufgabe, der in einigen Fällen nützlich ist, um in Datenkarten angezeigt zu werden
- Efecte ID eindeutiges Attribut in Datenkarten, normalerweise mit IDgenerator-Handler
- Auf der rechten Seite: Efecte-Lösungsattribut
- Auf der linken Seite: Quelle Efecte Lösungsattribut
- Durch Auswahl der Schaltfläche „Neues Attribut“ können zusätzliche Attribute festgelegt werden, die aus der Quelllösung von Efecte gelesen werden.
11. Speichern Sie die Bereitstellungsaufgabe über die Schaltfläche „Speichern“. Wenn einige erforderliche Attribute fehlen, wird die Schaltfläche „Speichern“ grau angezeigt und zeigt an, was in den Einstellungen fehlt.
12. Sie haben jetzt eine zeitplanbasierte Connector-Aufgabe für den Efecte-Connector konfiguriert, um Datenkarten aus der Efecte-Quelllösung zu lesen.
- Sie können jetzt warten, bis die Aufgabe basierend auf der Planung gestartet wird oder
- Aufgabe manuell ausführen - Durch Klicken auf die Schaltfläche wird die Aufgabe so konfiguriert, dass sie sofort gestartet wird. Dies ist normalerweise für Testläufe oder wenn Sie die Zeitplaneinstellungen nicht ändern, die Aufgabe aber sofort ausführen möchten.
Konfigurieren Sie die Ereignisaufgabe zum Schreiben von Daten
Alle Konfigurationen im Zusammenhang mit Efecte Provisioning Engine und ereignisbasierten Bereitstellungsaufgaben werden in der Efecte Service Management-Plattform konfiguriert.
Beachten Sie auf dem Bild, wie zwei Efecte-Lösungen benannt sind, damit die Anweisungen leichter befolgt werden können.
1. Öffnen Sie die Konfigurationsansicht der Efecte-Plattform (ein Zahnradsymbol).
2. Konnektorenansicht öffnen
3. Wählen Sie den Connector, der die Ereignisaufgabe verwenden soll
4. Wählen Sie unter dem richtigen Connector „Neue Aufgabe“
5. Aufgabendetails ausfüllen
- Aufgabenname – Geben Sie der Aufgabe einen Namen, er wird in der Konnektoransicht angezeigt.
- Es empfiehlt sich, eine Aufgabe so zu benennen, dass ihr Zweck beschrieben wird, zum Beispiel
- Die angegebene Taskverwendung ist die Task, die zum Lesen oder Schreiben von Daten verwendet wird. Kann nachträglich geändert werden, wird aber nicht empfohlen, wenn eine Ereignistask verwendet wird. Dadurch werden Arbeitsabläufe unterbrochen.
- Der Zuordnungstyp ist immer eine generische Vorlage
6. Fügen Sie Details zur Ziellösungsvorlage hinzu
- Es ist nicht erforderlich, die Filterabfrage auszufüllen, sie wird nur für die geplanten Aufgaben verwendet.
- Vorlagencode – Quellcode der Efecte-Lösung, in dem Daten erstellt oder gelöscht werden
- Ordnercode – Quellcode der Efecte-Lösung, in dem Daten erstellt oder gelöscht werden
- Tipp! Sie können Listener verwenden, um Datenkarten in verschiedene Ordner zu verschieben
8. Generische Zuordnungen definieren
- Zielvorlage – Wählen Sie eine Vorlage aus der Quell-Efecte-Lösung aus, in der Informationen aus der Ziel-Efecte-Lösung gelesen werden
- Zielordner – Wählen Sie einen Ordner aus der Quelllösung von Efecte aus (die Liste wird eingegrenzt, um die Kompatibilität mit der ausgewählten Vorlage sicherzustellen), aus dem die Daten gelesen werden.
- Attributzuordnungen
- Auf der linken Seite: Ziel Efecte Lösungsattribut
- Die Datenquellen-ID (Datasourceid) ist der Name der Connector-Aufgabe, der in einigen Fällen nützlich ist, um in Datenkarten angezeigt zu werden
- Efecte ID eindeutiges Attribut in der Datenkarte, normalerweise unter Verwendung des IDgenerator-Handlers
- Auf der rechten Seite: Efecte-Lösungsattribut
- Auf der linken Seite: Ziel Efecte Lösungsattribut
- Durch Auswahl der Schaltfläche „Neues Attribut“ können zusätzliche Attribute festgelegt werden, die aus der Ziellösung von Efecte gelesen werden.
9. Speichern Sie die Bereitstellungsaufgabe über die Schaltfläche „Speichern“. Wenn obligatorische Informationen fehlen, können Sie die Aufgabe nicht speichern. In diesem Fall werden die fehlenden Informationen über die Schaltfläche „Speichern“ angezeigt.
10. Im nächsten Schritt konfigurieren Sie den Workflow für die ereignisbasierte Aufgabe. Über die Workflow-Engine der Efecte-Plattform können Bereitstellungsaktivitäten für eine andere Efecte-Lösung ausgeführt werden. Das bedeutet, dass jede Aktivität der verfügbaren Orchestrierungsknoten an jedem Punkt des Workflows ausgeführt werden kann.
Workflow-Referenzen werden auf der Connector-Übersichtsseite angezeigt.
Konfigurieren des bidirektionalen Connectors
In Fällen, in denen ein bidirektionaler Anschluss erforderlich ist, müssen Sie besonders darauf achten, dass Sie keine Schleife zwischen zwei Efecte-Lösungen erstellen.
Beim Konfigurieren des bidirektionalen Connectors ist es erforderlich, dass in beiden Efecte-Lösungen sowohl geplante als auch ereignisbasierte Aufgaben konfiguriert werden.
Beachten Sie auf dem Bild, wie zwei Efecte-Lösungen benannt sind, damit die Anweisungen leichter befolgt werden können.
Es gibt mehrere verschiedene Szenarien, wie ein bidirektionaler Konnektor konfiguriert werden kann. Hier haben wir jedoch gängige Szenarien und Beispiele für die Konfiguration aufgelistet.
Szenario 1
Effekt 1 erstellt basierend auf dem Tickettyp ein Ticket für Effekt 2 und Effekt 2 sendet basierend auf dem Status ein Ticket zurück.
Konfiguration in Effekt 1.
- Erstellen Sie eine ereignisbasierte Aufgabe wie in der Anleitung oben für ereignisbasierte Aufgaben beschrieben.
- Konfigurieren Sie Ihren Workflow wie in den Anweisungen unten für Workflow-Aktivitäten beschrieben.
- Erstellen Sie eine Bedingung für den Workflow „Effekt 1“, um zu prüfen, ob das Ticket an „Effekt 2“ gesendet werden soll.
Hier ist beispielsweise ein Workflow in Effekt 1, der ein Ticket an Effekt 2 sendet, wenn der Tickettyp Vorfall ist.
- Erstellen Sie eine Bedingung für den Workflow „Effekt 1“, um zu prüfen, ob das Ticket an „Effekt 2“ gesendet werden soll.
- Erstellen Sie eine zeitplanbasierte Aufgabe, wie in den Anweisungen oben für zeitplanbasierte Aufgaben beschrieben.
- Fügen Sie einen Filter für die Aufgabe hinzu, die den Status des Tickets in Effekt 2 überprüft. In diesem Fall muss das Ticket in Effekt 2 gelöst werden, bevor es in Effekt 1 gelesen wird.
- Fügen Sie einen Filter für die Aufgabe hinzu, die den Status des Tickets in Effekt 2 überprüft. In diesem Fall muss das Ticket in Effekt 2 gelöst werden, bevor es in Effekt 1 gelesen wird.
Konfiguration in Efecte 2.
- Erstellen Sie einen Web API Benutzer für den Efecte1-Efecte-Connector und senden Sie die Anmeldeinformationen an den Efecte 1-Administrator.
- Der WebAPI-Benutzer muss über die Berechtigung zum Lesen von Vorfalldatenkarten mit dem Status „Gelöst“ verfügen.
- Geben Sie Attributcodes des Vorfalls an, die aus Efecte 2 bis Efecte 1 gelesen werden
Szenario 2
Effekt 1 erstellt ein Ticket für Effekt 2 und aktualisiert das vorhandene Ticket in Effekt 2 mit geänderten Informationen (Beschreibungsfeld wurde aktualisiert).
Konfiguration in Effekt 1.
- Erstellen Sie eine ereignisbasierte Aufgabe wie in der Anleitung oben für ereignisbasierte Aufgaben beschrieben.
- Konfigurieren Sie Ihren Workflow wie in den Anweisungen unten für Workflow-Aktivitäten beschrieben.
- Es müssen Bedingungen im Workflow vorhanden sein, wenn ein Ticket von Effekt 1 bis Effekt 2 erstellt wird.
- Es muss ein Bereitstellungsknoten mit der Aktion „Datenkarte erstellen“ vorhanden sein. Beispiel:
Konfiguration in Efecte 2.
- Erstellen Sie einen Web API Benutzer für den Efecte 1 EFfecte-Connector und senden Sie die Anmeldeinformationen an den Efecte 1-Administrator
- Der WebAPI-Benutzer muss über die Berechtigung zum Lesen von Vorfalldatenkarten verfügen
- Geben Sie Attributcodes des Vorfalls an, die aus Efecte 1 bis Efecte 2 gelesen werden
- Erstellen Sie eine zeitplanbasierte Aufgabe, wie in den Anweisungen oben für zeitplanbasierte Aufgaben beschrieben.
- Fügen Sie einen Filter für die Aufgabe hinzu, die den Status des Tickets in Effekt 1 überprüft. In diesem Fall darf das Ticket in Effekt 1 nicht gelöst werden, bevor es in Effekt 2 gelesen wird.
- Fügen Sie einen Filter für die Aufgabe hinzu, die den Status des Tickets in Effekt 1 überprüft. In diesem Fall darf das Ticket in Effekt 1 nicht gelöst werden, bevor es in Effekt 2 gelesen wird.
Szenario 3.
Efecte 1 liest alle Anwendungsdatenkarten aus Efecte 2, Daten werden in Efecte 1 geändert und wieder in Efecte 2 aktualisiert.
Konfiguration in Effekt 1.
- Erstellen Sie eine zeitplanbasierte Aufgabe wie oben beschrieben. Beispiel:
- Erstellen Sie eine ereignisbasierte Aufgabe wie in der Anleitung oben für ereignisbasierte Aufgaben beschrieben.
- Konfigurieren Sie Ihren Workflow wie in den Anweisungen unten für Workflow-Aktivitäten beschrieben.
Konfiguration in Efecte 2.
- Erstellen Sie einen Web API Benutzer für den Efecte 1 Efecte-Connector und senden Sie die Anmeldeinformationen an den Efecte 1-Administrator
- Der WebAPI-Benutzer muss über die Berechtigung zum Lesen von Anwendungsdatenkarten verfügen.
- Geben Sie Attributcodes der Anwendungsvorlage an, die aus Efecte 2 bis Efecte 1 gelesen werden
Szenario 4.
Effekt 1 erstellt eine manuelle Zugriffsrechtsanforderung als Ticket für Effekt 2 und sendet es basierend auf einer Statusänderung an Effekt 1 zurück.
Konfiguration in Effekt 1.
- Erstellen Sie eine ereignisbasierte Aufgabe wie in der Anleitung oben für ereignisbasierte Aufgaben beschrieben.
- Konfigurieren Sie Ihren Workflow wie in den Anweisungen unten für Workflow-Aktivitäten beschrieben.
- Erstellen Sie eine Bedingung für den Workflow „Effekt 1“, um zu prüfen, ob das Ticket an „Effekt 2“ gesendet werden soll.
Beispiel: Der Workflow in Effekt 1 sendet eine Zugriffsrechtsanforderung als Ticket an Effekt 2, wenn der Bereitstellungstyp manuell ist.
- Erstellen Sie eine Bedingung für den Workflow „Effekt 1“, um zu prüfen, ob das Ticket an „Effekt 2“ gesendet werden soll.
Konfiguration in Efecte 2.
- Erstellen Sie einen Web API Benutzer für den Efecte 1 Efecte-Connector und senden Sie die Anmeldeinformationen an den Efecte 1-Administrator
- Der WebAPI-Benutzer muss über die Berechtigung zum Bearbeiten des Statusattributs in Datenkarten für Zugriffsrechtsanforderungen verfügen.
- Geben Sie den Statusattributcode der Vorlage für die Zugriffsrechtsanforderung und ihre Werte an.
- Erstellen Sie eine ereignisbasierte Aufgabe wie in der Anleitung oben für ereignisbasierte Aufgaben beschrieben.
- Konfigurieren Sie Ihren Workflow wie in den Anweisungen unten für Workflow-Aktivitäten beschrieben.
- Fügen Sie dem Workflow Bedingungen hinzu, wenn der Efecte-Connector den Status auf Efecte 1 ändern soll. Zum Beispiel, wenn der Status 07 – Gelöst ist
Anweisungen für Version 2024.1 und ältere Versionen
Konfigurieren Sie geplante Aufgaben
Zum Konfigurieren zeitplanbasierter Bereitstellungsaufgaben benötigen Sie Zugriff auf die Konfigurationskonsole der Efecte-Plattform.
1. Öffnen Sie den Efecte-Administrationsbereich (ein Zahnradsymbol).
2. IGA Ansicht öffnen
3. Wählen Sie „Neue Aufgabe hinzufügen“ für die zeitgesteuerte Pro
4. Wählen Sie Efecte ESM aus der Liste Neue Aufgabe hinzufügen
5. Geben Sie einen eindeutigen Namen für die Bereitstellungsaufgabe ein
6. Wählen Sie den Web API Benutzer (Liste aller lokalen Efecte-Benutzer) und geben Sie das Passwort ein
7. Wählen Sie eine Fehlervorlage der Datenkarte aus, die im Falle von Fehlern während der Bereitstellung (Verbindung zu Datenquellen, Zeitüberschreitungen usw.) erstellt wird.
8. Wählen Sie die Planungssequenz, die davon abhängt, wie viele Daten an die Efecte-Lösung des Kunden gelesen werden
9. Füllen Sie den Abschnitt Pro aus, in dem Informationen für die Verbindung definiert werden
10. Füllen Sie den Abschnitt „Efecte ESM Template Mapping“ aus
- Remote-ESM-Vorlagencodename - Vorlagencode des Remote-ESM
- Remote-ESM-Ordnercodename - Ordnercode des Remote-ESM
- Die linke Seite der Zuordnungen ist für Remote-Attribute und die rechte Seite für die lokale ESM-Instanz
- datasourceid und efecte_id sind erforderliche Zuordnungen
- datasourceid sollte ein String-Attribut sein. Der Name des Connectors wird beim Importieren von Daten in Efecte in der DatasourceID der Zieldatenkarte angezeigt.
- efecte_id muss ein eindeutiges Attribut der Vorlage sein, normalerweise wird der ID-Generator-Handler verwendet
14. Bereitstellungsaufgabe über die obere Leiste speichern
15. Sie haben nun die zeitplanbasierte Bereitstellungsaufgabe konfiguriert und können
- Testen der Verbindung
- Aufgabe manuell ausführen
16. Wenn die Aufgabe manuell ausgeführt wird (Aufgabe manuell ausführen) oder gemäß Zeitplan ausgeführt wird, kann der Aufgabenstatus unter der Registerkarte „Status extrahieren/laden“ überprüft werden.
Ereignisbasierte Aufgabe konfigurieren
Alle Konfigurationen im Zusammenhang mit Efecte Provisioning Engine und ereignisbasierten Bereitstellungsaufgaben werden in der Efecte Service Management-Plattform konfiguriert.
1. Öffnen Sie den Efecte-Administrationsbereich (ein Zahnradsymbol).
2. IGA Ansicht öffnen
3. Wählen Sie „Neue Aufgabe hinzufügen“ für die zeitgesteuerte Pro
4. Wählen Sie Efecte ESM aus der Liste Neue Aufgabe hinzufügen
5. Geben Sie einen eindeutigen Namen für die Bereitstellungsaufgabe ein
6. Füllen Sie den Abschnitt Pro Eigenschaften“ aus, in dem Informationen zur Verbindung definiert werden. Hinweis: Für die Filterabfrage sind keine Werte erforderlich. Sie wird nur für geplante Aufgaben verwendet.
7. Füllen Sie den Abschnitt „Efecte ESM Template Mapping“ aus
- Remote-ESM-Vorlagencodename - Vorlagencode des Remote-ESM
- Remote-ESM-Ordnercodename - Ordnercode des Remote-ESM
- Die linke Seite der Zuordnungen ist für Remote-Attribute und die rechte Seite für die lokale ESM-Instanz
- datasourceid und efecte_id sind erforderliche Zuordnungen
- datasourceid sollte ein String-Attribut sein. Der Name des Connectors wird beim Importieren von Daten in Efecte in der DatasourceID der Zieldatenkarte angezeigt.
- efecte_id muss ein eindeutiges Attribut der Vorlage sein. Normalerweise wird der ID-Generator-Handler verwendet.
8. Bereitstellungsaufgabe über die obere Leiste speichern
9. Sie haben nun die ereignisbasierte Bereitstellungsaufgabe konfiguriert und können die Verbindung testen
10. Der nächste Schritt besteht darin, den Workflow für die Verwendung dieser ereignisbasierten Aufgabe zu konfigurieren. Über die Workflow-Engine der Efecte Service Management-Plattform können Bereitstellungsaktivitäten für Efecte ESM ausgeführt werden. Dies bedeutet, dass jede der verfügbaren Aktivitäten zu jedem Zeitpunkt des Workflows ausgeführt werden kann.
Workflow-Aktivitäten (Orchestrierungsknoten)
Datenkarte erstellen
In der obigen Abbildung werden die Efecte ESM-Vorlagenzuordnungen aus Pro gefüllt. Administratoren wählen das richtige Efecte ESM-Ziel aus und können die für die ausgewählte Aufgabe konfigurierten Identitätszuordnungen anzeigen. In dieser Orchestrierungsansicht dürfen Administratoren keine Zuordnungen ändern; diese werden nur als visuelle Hilfe angezeigt. Sollten Änderungen an den Zuordnungen erforderlich sein, müssen diese in der Konfigurationsansicht der Pro vorgenommen werden.
„Ziel“ zeigt alle Connector-Aufgaben an, die für Efecte ESM konfiguriert sind, und die Aufgabenzuordnungen beziehen sich auf dieselbe Vorlage, in der sich der Workflow selbst befindet.
Die Pro ist eine optionale Eigenschaft dieses Workflowknotens. Administratoren können diese Eigenschaft so konfigurieren, dass Ausnahmen geschrieben werden, wenn während der Bereitstellungsaktionen Ausnahmen auftreten.
Datenkarte löschen
Administratoren wählen das richtige Efecte ESM-„Ziel“ aus. In dieser Orchestrierungsansicht dürfen Administratoren keine Zuordnungen oder Bedingungen ändern. Wenn Änderungen erforderlich sind, müssen diese in der Konfigurationsansicht der Pro ausgeführt werden.
„Ziel“ zeigt alle Connector-Aufgaben an, die für Efecte ESM konfiguriert sind, und die Aufgabenzuordnungen beziehen sich auf dieselbe Vorlage, in der sich der Workflow selbst befindet.
Die Pro ist eine optionale Eigenschaft dieses Workflowknotens. Administratoren können diese Eigenschaft so konfigurieren, dass Ausnahmen geschrieben werden, wenn während der Bereitstellungsaktionen Ausnahmen auftreten.
Fehlerbehebung
In diesem Kapitel werden Möglichkeiten zur Fehlerbehebung beschrieben,
- Falls eine Fehlervorlage verwendet wird, überprüfen Sie die korrekte Datenkarte
- Überprüfen Sie den Verlauf geplanter Aufgaben über die Connector-Verwaltung
- Überprüfen Sie die Protokolle Efecte Provisioning Engine
Einschränkungen
Diese Einschränkungen gelten, wenn Quell- und Zielsystem denselben Attributtyp haben. Einige davon funktionieren möglicherweise, wenn Sie den Attributtyp auf einem anderen System in „String“ ändern.
Einschränkungen für ereignisbasierte Aufgaben
- E-Mails werden nicht unterstützt
- Anhänge, also externe Referenzen (FileUpload-Handler) werden nicht unterstützt
- Datumsattribute werden nicht unterstützt
- DateTime-Attribute werden nicht unterstützt
- Worklog-Handler wird nicht unterstützt
Einschränkungen für geplante Aufgaben
- Attribute vom Typ „Datum“ (Sie müssen diese Attributen vom Typ „Zeichenfolge“ zuordnen)
- Attribute vom Typ DateTime (Sie müssen diese Attributen vom Typ String zuordnen)
- Worklog-Handler wird nicht unterstützt