Generisk SQL koppling
Generisk SQL koppling är en del av de inbyggda kopplingarna för kopplingshantering (EPE Pro Engine) och används för att läsa data från kundernas databas. Före version 2025.1 var namnet på denna generiska SQL koppling "Generisk databaskoppling".
2025.3-versionen lade till stöd för händelsebaserade uppgifter.
2025.3-versionen lade till stöd för tabellalias för schemalagda uppgifter.
Connector stöder följande databasmotorer: Mariadb, My sql , Postgre sql , Ms sql Server och Oracle.
Generisk SQL koppling kräver konfiguration enligt kundens användningsfall, och i princip har konfigurationen tre (3) steg:
- Konfigurera koppling – gör det möjligt för kopplingen att upprätta en anslutning till databasen
- Konfigurera schemalagd uppgift - används när data läses från databasen
- Konfigurera händelsebaserad uppgift – används när data läses/skrivs från/till databasen från noden Workflow Orchestation
Allmänna funktioner
Kontakter - allmänna funktioner
Kontakter - allmänna funktioner
I den här artikeln beskrivs allmänna funktioner för att hantera nativa kopplingar i lösningen. Alla nativa kopplingar hanteras från samma gränssnitt för kopplingshantering.
Observera att det finns separata beskrivningar för varje kontakt, där kontaktspecifika funktioner och konfigurationsinstruktioner beskrivs i detalj.
För att kunna komma åt hantering av anslutningar måste användaren ha administratörsbehörighet till kundens plattformskonfiguration. När åtkomst beviljas korrekt visas fliken för anslutningar och användaren kan hantera anslutningar.
Vänstermeny
Hantering av kopplingar är indelat i fyra flikar:
- Översikt – för att skapa och uppdatera Native Connectors. Administratörsanvändaren kan se sin status, typ och hur många schemalagda uppgifter eller händelseuppgifter som är kopplade till dem.
- Autentisering – för att skapa och uppdatera autentiseringsuppgifter. Pro tillhandahållandeuppgift för autentisering behövs för att Secure Access ska kunna definiera vilka kunders slutanvändare som har åtkomst till Matrix42 Core , Pro and IGA inloggningssidorna.
- Loggar – för att ladda ner Native Connector- och Secure Access loggar från användargränssnittet.
- Inställningar – allmänna inställningar för Native Connectors och Secure Access , inklusive miljötyp för loggning och övervakning.
Fliken Översikt över kontakter
Från översiktssidan kan användaren enkelt och snabbt se status för alla kopplingar.
Övre fältet:
- Status för inbyggda kopplingar (EPE)
- Grön text indikerar att Native Connectors är online. Alla nödvändiga tjänster är igång.
- Röd text indikerar att det är ett problem med Native Connectors, att alla tjänster inte körs.
- Status för Secure Access ( ESA )
- Grön text indikerar att Secure Access är online. Alla nödvändiga tjänster är igång.
- Röd text indikerar att det är ett problem med Secure Access , att alla tjänster inte körs.
- Versionsnumret för Native Connectors visas i det övre högra hörnet
Övre fältet för listvy:
- Ny koppling – öppnar ett nytt fönster för att lägga till och konfigurera en ny koppling
- Ta bort koppling(ar) – arbetsflödesreferenser beräknas och ett popup-fönster visas för att bekräfta borttagningen (observera att beräkningen av referenser kan ta flera sekunder)
- Exportera – Administratören kan exportera en eller flera kopplingar (och uppgifter) från miljön. Används vanligtvis för att exportera kopplingar och kopplingar (och uppgifter) från test till produkt. Hemlig information om inbyggda kopplingar är lösenordsskyddad.
- Importera – Administratören kan importera en eller flera kopplingar (och uppgifter) till miljön. Används vanligtvis för att importera kopplingar (och uppgifter) från test till prod.
- Administratören kan inte importera från det gamla EPE-gränssnittet (äldre än 2024.1) till det nya. Käll- och målmiljöer måste ha samma version.
- Importen misslyckas om konfigurationen (mallar, attribut) inte är densamma - till exempel när något attribut saknas.
- Om du importerar något med samma kopplingsdetaljer kommer det att slås samman under befintlig koppling
- Uppdatera – Administratören kan uppdatera kopplingsvyn genom att klicka på knappen .
Listvy för översikt,
- Välj kontakt(er) - Välj en kontakt genom att klicka på kryssrutan framför kontaktraden eller genom att klicka på kryssrutan i rubrikraden markeras alla kontakter.
- Id - Automatiskt genererat unikt ID för kopplingen. Kan inte redigeras eller ändras.
- Status - indikerar status för schemalagd uppgift
-
Grön bockmarkering - Uppgiften utförs utan fel
-
Röda korset - Uppgiften är utförd, men det har uppstått fel
-
Grå klocka - Uppgiften är inte utförd än, väntar på schemaläggning -
Orange - en av uppgifterna har ett problem
- Inget värde - Schemalagd uppgift saknas
-
- Namn - Anslutningsnamn tillagt i anslutningsinställningar. Unikt namn på anslutningskonfigurationen för en datakälla.
- Typ - indikerar mål-/källsystem
- Schemalagd – informerar hur många schemalagda uppgifter som är konfigurerade
- Händelse - informerar hur många händelseuppgifter som är konfigurerade
- Hantera
- Pennikon – öppnar kopplingsinställningar (dubbelklicka på kopplingsraden, även inställningarna öppnas)
- Pappersikon – kopierar kopplingen
- Stopp - arbetsflödesreferenser beräknas och ett popup-fönster visas för att bekräfta borttagningen.
- Sök – Användaren kan söka efter kopplingar genom att ange söktermen i motsvarande fält. Fälten Id, Status, Namn, Typ, Schemalagd och Händelse kan sökas.
Information om schemalagda uppgifter (klicka på pilen framför kopplingen)
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Övre fältet för schemalagda uppgifter
- Ny uppgift – öppnar konfigurationssidan för ny uppgift
- Ta bort uppgift(er) – tar bort den/de valda uppgiften/uppgiftarna från systemet och de kan inte längre återställas.
- Uppdatera - uppdatera vyn över schemalagda uppgifter
- Sök – användaren kan söka efter uppgiften genom att ange söktermen i motsvarande fält för Id, namn, aktiverad, extraktions-/laddningsstatus.
Listvy för schemalagda uppgifter
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Aktiverad - Visar om uppgiften är schemalagd eller inte
-
Grön bockmarkering – Uppgiften är schemalagd
-
Röda korset - Uppgiften är inte schemalagd
-
- Extraheringsstatus – Visar status för dataextrahering från målkatalogen/systemet
- Grön bockmarkering - data har extraherats
- Röda korset - data extraheras med fel eller extraheringen misslyckades
-
Klocka - Uppgiften väntar på körning
-
- Laddningsstatus - Visar status för dataexport från json-fil till kundens lösning
- Grön bockmarkering - data har importerats till kundens lösning
-
Rött kors - data importeras med fel eller importen misslyckades
-
- Hantera
- Pennikon – öppnar aktivitetsinställningar i ett eget fönster (dubbelklick på aktivitetsraden öppnar även aktivitetsinställningar)
- Pappersikon - kopierar uppgiften
- Klockikon – öppnar vyn för uppgiftshistorik
- Stopp - ta bort uppgift, popup-fönster öppnas för att bekräfta borttagningen
Vy över schemalagd uppgiftshistorik
Genom att klicka på klockikonen i raden för schemalagda uppgifter visas historiken för schemaläggningen.
Övre fältet för visningshistorik
- Uppdatera – uppdaterar statusen för schemalagda uppgifter. Detta påverkar inte uppgiften, det uppdaterar bara användargränssnittet för att visa den senaste informationen om den körda uppgiften.
Listvy för historik över schemalagda uppgifter
- Radens färg anger status
- Grön - uppgiften har utförts
- Röd - fel uppstod under körning
-
- Körnings-ID - unikt ID för den schemalagda uppgiftsraden
- Planerad extraktionstid - när nästa extraktion från katalogen/applikationen är schemalagd att ske
- Utdragets slutförande tid - när utdraget slutfördes
- Extraheringsstatus - status för att hämta data från katalogen/applikationen
- Starttid för laddning – när nästa laddning till kundens lösning är schemalagd
- Lastningstid - när lastningen var klar
- Laddningsstatus - status för laddning av information till kundens lösning
Listvy för status för schemalagd uppgift
- Faktisk starttid - tidsstämpel för faktisk start
- Användarfil - JSON-fil som innehåller användarinformation läst från katalogen/applikationen
- Gruppfil - JSON-fil som innehåller gruppinformation läst från katalogen/applikationen
- Generisk fil - JSON-fil som innehåller generisk information läst från katalogen/applikationen
- Extrahera information - detaljerad information om att läsa information från katalogen/applikationen
- Ladda information - detaljerad information om hur informationen laddas till kundernas Matrix42 Core , Pro and IGA -lösningar
Redigera fönster för schemalagd uppgift
Konfigurationen för schemalagd uppgift kan öppnas genom att klicka på pennikonen eller dubbelklicka på uppgiftsraden.
Vänstermeny och attribut varierar beroende på valda alternativ och därför kan mer detaljerade instruktioner för att redigera uppgifter hittas i kopplingens beskrivning, men det finns gemensamma funktioner för alla schemalagda uppgifter som beskrivs nedan.
Sparar uppgiften
Om obligatorisk information saknas i uppgiften, kommer muspekaren över spara-knappen att visa vilka attribut som fortfarande är tomma.
Övre fältet för att redigera schemalagd uppgift
- Kör uppgift manuellt – administratören kan köra uppgiften manuellt utanför den definierade schemaläggningen
- Stoppa uppgift – administratören kan stoppa en schemalagd uppgift som för närvarande körs. Uppgiften stoppas och statusen ändras till stoppad. Den väntar i detta tillstånd tills nästa tidpunkt inträffar.
- Rensa datacachen – Datacachen för nästa provisionering av användare och grupper kommer att rensas. Det betyder att nästa körning körs som förstagångskörning.
- Som standard rensar vi cachen varje dag klockan 00:00 UTC
- Om du vill rensa cachen vid en annan tidpunkt måste du ange ett annat värde i värdfilen 'custom.properties'.
- EPE-cachen rensas också när EPE startas om, hela miljön startas om och EPE-mappningar har ändrats.
Information om händelseuppgift
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Översta fältet för händelseuppgifter
- Ny uppgift – öppnar konfigurationssidan för ny händelseuppgift
- Ta bort uppgift(er) - tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Uppdatera - uppdaterar vyn för händelseuppgifter
- Visa arbetsflödesreferenser – beräknar arbetsflödesrelationer och statusar för uppgifter. Detta är mycket användbart om du inte vet från vilka arbetsflöden händelsebaserade uppgifter används.
Listvy för händelseuppgifter
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Arbetsflödesrelationer
- Frågetecknet visar ett popup-fönster med detaljerad information om referensen
- Arbetsflödesstatus
- Används inte - Inga relationer till arbetsflödet
- Används - Arbetsflöde(n) kopplade till uppgift, uppgiften kan inte tas bort
- Hantera
- Pennikon - öppnar aktivitetsinställningar i eget fönster
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort uppgiften, ett popup-fönster visas för att bekräfta borttagningen
Redigera fönster för händelseuppgift
Konfigurationen för händelseuppgiften kan öppnas genom att klicka på pennikonen eller dubbelklicka på uppgiftsraden.
Vänstermeny och attribut varierar beroende på valda alternativ och därför kan mer detaljerade instruktioner för redigering av uppgifter hittas i kopplingbeskrivningen, men det finns gemensamma funktioner för alla händelseuppgifter som beskrivs nedan.
Redigera händelseuppgiftsfönstret
- Uppgiftsanvändning, redigerbar? – detta visas när du redigerar en befintlig uppgift och ändrar uppgiftsanvändningstypen kommer att avbryta arbetsflöden
- Mappningstyp, redigerbar? - detta visas när du redigerar en befintlig uppgift och ändring av mappningstypen kommer att avbryta arbetsflöden.
Sparar uppgiften
Om obligatorisk information saknas i uppgiften, kommer muspekaren över spara-knappen att visa vilka attribut som fortfarande är tomma.
Fliken Autentisering
Autentisering för Matrix42 Core , Pro and IGA -lösningar konfigureras från fliken autentisering. Observera att endast vissa av kopplingarna (katalogkopplingar) stöder autentisering, så det är inte möjligt att skapa autentiseringsuppgifter för alla tillgängliga kopplingar.
Övre fältet för autentisering
- Ny koppling – öppnar ett nytt fönster för att konfigurera den nya kopplingen (observera att inte alla kopplingar stöder autentisering)
- Ta bort koppling(ar) – tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Exportera - användaren kan exportera en eller flera uppgifter från miljön. Används vanligtvis för att exportera uppgifter från test till prod. EPE-kontakter är lösenordsskyddade.
- Observera att Realm för autentiseringsuppgifter inte exporteras, du måste ställa in det manuellt efter importen.
- Importera - användaren kan importera en eller flera uppgifter till miljön. Används vanligtvis för att importera uppgifter från test till prod.
- Uppdatera - uppdaterar vyn för autentiseringsuppgifter
Listvy för autentiseringsöversikt
- Välj kontakt(er) - Välj en kontakt genom att klicka på kryssrutan framför kontaktraden eller genom att klicka på kryssrutan i rubrikraden markeras alla kontakter.
- Id - Automatiskt genererat unikt ID för kopplingen. Kan inte redigeras eller ändras.
- Namn - Anslutningsnamn tillagt i anslutningsinställningar. Unikt namn på anslutningskonfigurationen för en datakälla.
- Typ - indikerar mål-/källsystem
- Antal – anger hur många autentiseringsuppgifter som är konfigurerade
- Hantera
- Pennikon - öppnar inställningen för autentiseringsuppgift i ett eget fönster
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort vald uppgift
Information om autentiseringsuppgift
När du klickar på pilen i början av kopplingsraden visas alla relaterade schemalagda uppgifter och händelseuppgifter.
Översta fältet för autentiseringsöversikt
- Skapa ny uppgift – öppnar konfigurationssidan för ny autentiseringsuppgift
- Ta bort uppgift(er) - tar bort markerade uppgifter, ett popup-fönster visas för att bekräfta borttagningen.
- Uppdatera - uppdaterar vyn för autentiseringsuppgifter
Listvy för autentiseringsöversikt,
- Välj uppgift(er) – Markera den uppgift som ska tas bort från listvyn genom att markera.
- Id - Unikt ID för uppgiften. Genereras automatiskt och kan inte ändras.
- Namn - Uppgiftsnamn som läggs till i uppgiftsinställningarna, unikt namn för uppgiften.
- Hantera
- Pennikon – öppnar aktivitetsinställningar i ett eget fönster (dubbelklicka på aktivitetsraden, öppnar även inställningsfönstret)
- Pappersikon - kopierar uppgiften
- Stoppikon – tar bort uppgiften, ett popup-fönster visas för att bekräfta borttagningen
Fliken Loggar
Fliken Loggar är för att ladda ner loggar för Native Connector och Secure Access från användargränssnittet för detaljerad felsökning.
- epe-master- loggar - innehåller varnings-, felsöknings- och felnivåmeddelanden om Native Connectors och information om hur länge uppgiftsåtgärder har vidtagits.
- epe-worker-ad -loggar - innehåller extraheringsdata för Active Directory anslutningen (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-worker-azure -loggar – innehåller extraheringsdatastatus för Entra ID (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-worker-ldap- loggar - innehåller extraheringsdata för LDAP (vad Native Connector laddar till kundernas Matrix42 Core , Pro and IGA lösningar). Om valet är tomt betyder det att katalogen inte används i den här miljön.
- epe-launcher- loggar - innehåller information om EPE-uppskjutningar
- datapump-itsm l ogs - Innehåller information om dataexport till kunders Matrix42 Core , Pro and IGA lösningar.
- esa -loggar – Innehåller information om Secure Access åtkomstautentisering.
Inställningsfliken
Inställningsflikar används för att övervaka miljöer med kopplingar.
- Miljötyp - är obligatorisk att vara vald och information används till exempel för att definiera varningar kritiskt.
- Test – välj detta när din miljö används som testmiljö
- Pro d – välj detta när din miljö används som produktionsmiljö
- Demo – välj detta när din miljö används som demo- eller utbildningsmiljö
- Utvecklare – välj detta när din miljö används som utvecklingsmiljö
Vad övervakar vi?
- Fel i schemalagd provisionering (extrahering av data, export av data till ESM, föråldrade certifikat, felaktiga lösenord, felaktig sökbas/filter, felaktiga mappningar etc.)
- Fel i händelsebaserad provisionering (misslyckades med att skriva till AD / Azure , etc.)
- Händelsebaserad provisionering – vilka kopplingar används för att skriva data till program/kataloger.
- ESA fler än tio misslyckade inloggningsförsök till en användare under de senaste 3 dagarna
- Miljötyp - är obligatorisk att vara vald och information används till exempel för att definiera varningar kritiskt.
Datamigreringar
Klicka inte på ”Migrera attributmappningar” eller ”Migrera arbetsflöden” om du inte begär det av Matrix42 .
Kundinstruktioner
Kundinstruktioner finns härifrån .
Konfigurera generisk SQL anslutning
I det här kapitlet beskrivs konfigurationsinstruktioner för hur SQL anslutningen ska kunna ansluta till kundens databas.
För att få åtkomst till kopplingshantering måste användaren ha behörighet till Efecte Platform-konfigurationen.
1. Öppna administrationsområdet för Efecte (en kugghjulssymbol).
2. Öppna kopplingsvyn.
3. Välj ny kontakt
4. Välj datakälltypen Generisk SQL
5. Komplettera information relaterad till kundens databas
- Anslutningsnamn - ge din anslutning ett vänligt namn (namnet kan ändras i efterhand)
- SQL värd - värdadressen som kommer att användas för att ansluta till kunddatabasen
- SQL port - portnummer som kommer att användas för att ansluta till kunddatabasen
- SQL databastyp - välj vilken databastyp som ska användas
- SQL databasnamn - namn på kunddatabasen
- SQL användarnamn - databaskontonamn som används för att läsa och skriva data till kunddatabasen
- SQL lösenord - lösenord för databaskontot
6. Uppfylla användarinformation för Web API
- Web API användare - välj rätt Web API användare som används när data skrivs från kunddatabasen till kundens Efecte-lösning
- Web API lösenord – lösenord för Web API användaren
7. Spara kontaktinformation
- Tryck på "testa anslutning" för att bekräfta att port- och värdinformationen är korrekt inställd:
8. Kundernas Efecte-lösning kan nu ansluta till kunddatabasen
- Nästa steg är att konfigurera schemalagda eller händelsebaserade uppgifter.
Allmän uid för schemalagda uppgifter
General g uid ance for scheduled tasks
How to Create New Scheduled Task to import data
For configuring scheduled-based provisioning task, you will need access to Administration / Connectors tab.
1. Open the Administration area (a cogwheel symbol).
2. Open Connectors view.
3. Choose Connector for Scheduled-based task and select New Task
Note! If connector is not created, you have to choose first New connector and after that New task.
4. Continue with connector specific instructions: Native Connectors
Should I use Incremental, Full or Both?
Scheduled task can be either Incremental or Full -type.
Do not import permissions with AD and LDAP incremental task
Incremental task has issue with permissions importing. At the moment it is recommended not to import group memberships with incremental scheduled task.
On Microsoft Active Directory and OpenLDAP connectors, remove this mapping on incremental task:
Setting on Scheduled tasks:
Incremental type is supported only for Microsoft Active Directory, LDAP and Microsoft Graph API (formerly known as Entra ID) Connectors.
Incremental type means, that Native Connectors (EPE) fetches data from source system, using changed timestamp information, so it fetches only data which is changed or added after previous incremental task run.
When Incremental type task is run for very first time, it does a full fetch (and it marks the current timestamp to EPE database), thereafter, task uses that timestamp to ask the data source for data that changed since that timestamp (and then EPE updates the timestamp to EPE database for next task run). Clearing task cache doesn't affect this timestamp, so Incremental task is always incremental after first run.
Full type is supported for all Connectors.
Full type import fetches always all data (it's configured to fetch) from source system, on every run.
Both Full and Incremental type tasks use also Task cache in EPE, which makes certain imports faster and lighter for M42 system.
By default that task cache is cleared ad midnight UTC time. When cache is cleared, next import after that is run without caching used to reason if data fetched should be pushed to ESM, all fetched data is pushed to ESM. But after that, next task runs until next time cache is cleared, are using EPE cache to determine if fetched data needs to be pushed to ESM or not.
You can configure at what time of day task cache is emptied, by changing global setting in EPE datapump configuration:
/opt/epe/datapump-itsm/config/custom.properties
which is by default set to: clearCacheHours24HourFormat=0
You can also clear cache many times a day, but that needs to be thinked carefully, as it has impact on overall performance as EPE will push changes to ESM, that probably are already there, example(do not add spaces to attribute value): clearCacheHours24HourFormat=6,12
After changing this value, reboot EPE datapump container to take change into use.
Recommendations:
Have always by default Full type scheduled task.
If you want to fetch changes to data fetched already by full task, more frequently than you can run full task, add also incremental task. Usually incremental task is not needed.
Recommended Scheduling Sequence
Recommended scheduling sequence, depends how much data is read from Customers system/directory to the Matrix42 Core, Pro or IGA solution and is import Incremental or Full.
Examples for scheduling,
| Total amount of users | Total amount of groups | Full load sequence | Incremental load sequence |
| < 500 | < 1000 |
Every 30 minutes if partial load is not used Four (4) times a day if partial load is used |
Every 10 minutes |
| < 2000 | < 2000 |
Every 60 minutes, if partial load is not used Four (4) times a day if partial load is used |
Every 15 minutes |
| < 5000 | < 3000 |
Every four (4) hours, if partial load is not used Twice a day if partial load is used |
Every 15 minutes |
| < 10 000 | < 5000 | Maximum imports twice a day, no matter if partial load is or is not used | Every 30 minutes |
| < 50 000 | < 7000 | Maximum import once a day, no matter if partial load is or is not used | Every 60 minutes |
| Over 50 000 | Over 7000 | There might be a need for another EPE-worker, please contact Product Owner | Separately evaluated |
Please note that if there are several tasks running at the same time you may need more EPE-workers. The tasks should be scheduled at different times and can be completed according to the table above. However, if there are more than 6 tasks running at the same time, the number of epeworkers should be increased. It's best practice not to schedule tasks to run at same time, if possible.
Recommendations related to performance
If the amount fo data to be imported is over 10000 concider these things:
Adjust log level of ESM and DATAPUMP to ERROR-level, to lowe the amount of logging during task run
Have as few as possible automations starting immediately for imported datacards (listeners, handlers, workflows), as those make ESM to take longer time handling new datacards.
Set removed accounts and entitlements status removed/disabled
With this functionality, you can mark account and entitlement status to e.g. Deleted or Disabled, when account or entitlement is removed from source system. Starting from version 2025.3 you can also set status to generic objects (not only to accounts/identities and entitlements/groups).
For version 2025.3 and newer
In version 2025.3 these settings are moved from properties files to Task UI. Also you can now set these settings for Generic objects, which have not been possible before this version.
There is separate configuration for each scheduled task, and for all mapping types. Here is example of this config on task:
For version 2025.2 and older
This functionality is available for “full” type scheduled tasks.
Settings are on datapump dockers configuration file. To change those parameter values, you need to set those in /opt/epe/datapump-itsm/config/custom.properties file.
Configuration
To enable disabling functionality, datapump config should have these parameters set to true:
disable.unknown.esm.users=truedisable.unknown.esm.groups=true
Those 2 parameters are false by default in 2024.2 and 2025.1 versions. In 2025.2 and newer version those are true by default.
Next are these parameters:
personTemplateStatusCodeAttributeKey=accountStatuspersonTemplateStatusAttributeDisabledValueKey=DeletedgroupTemplateStatusCodeAttributeKey=statusgroupTemplateStatusAttributeDisabledValueKey=5 - Removed
First two attributes should point to the DatacardHiddenState attribute in the User template, and tell which value should be send there when the user is deleted.
By default its accountStatus and Value 5 - Removed on IGA Account template.
All these needs to match with the attribute configuration:
Same thing applies for the next two paramaters, but its for Groups.'
If you need to change those parameters in properties file, do changes in Datapump container to file: /opt/epe/datapump-itsm/config/custom.properties and those changes will then survive over container reboot and will be copied on reboot to /opt/epe/datapump-itsm/config/application.properties.
Description
Tasks save their __taskid__ shown as Task Id mapping in the UI to the datacards, its then used to determine if the datacard was added by this task. In case there are multiple tasks with different sets of users.
This field was previously used as datasourceid, but since we moved to the model where connector can have multiple tasks its identifier cannot be used anymore, thats why the field was repurposed as taskid instead.
Taking users as an example, when task runs ESM is asked for the list of users that have its taskid in Task Id mapping field, and doesn't have a personTemplateStatusAttributeDisabledValueKey value in the personTemplateStatusCodeAttributeKey
This result is then compared to what the task fetched, and the datacards of users that were not fetched have their personTemplateStatusattribute set to value specified in the config - 5 - Removedby default.
Example log below shows described process and informs that one user was removed.
Same thing applies to groups but groupTemplateStatusattributes are used instead.
Notes
- Feature works only with full fetch scheduled tasks..
- No support for generic templates yet, only identity and access
- When migrating from the previous versions where datasourceid was still used it needs to run at least once to set its taskid’s in the datacards first.
- EPE identifies Disabled users or groups as the ones that were removed from the AD, at the present we do not support statuses related to the entity beign active or not.
- EPE does not enable users back on its own.
- If more than one tasks fetches the same users or groups it may overwrite the taskid in the datacard depending on which task ran last. It is suggested that many full type tasks are not fetching same user or group.
- Always do configuration file changes to custom.properties, do not change only application.properties as those changes are lost on container reboot if you have not done same changes to custom.properties.
Konfigurera schemalagd uppgift för att läsa data
SQL anslutningen används för att läsa data från kunddatabasen och konfigureras från plattformen genom att skapa schemalagda uppgifter.
Hur man skapar en ny uppgift för schemalagd Pro
För att konfigurera schemalagda uppgifter behöver du åtkomst till plattformskonfigurationskonsolen.
Obs! Om ingen koppling skapas måste du först skapa en "ny koppling" och därefter kan du skapa nya uppgifter.
1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna kopplingsvyn.
3. Välj den anslutning som den schemalagda uppgiften är konfigurerad för.
4. Välj ny uppgift under rätt koppling
5. Definiera schemaläggning för uppgiften (om och hur schemalagda uppgifter ska köras regelbundet). Välj schemaläggningssekvens, vilket beror på hur mycket data som läses till kundens lösning.
Rekommenderad schemaläggningssekvens beror på hur mycket data som läses från kundens databas till lösningen.
Exempel på schemaläggning för läsning av databasrader.
| Totalt antal databasrader | Laddningssekvens |
| < 1500 | Var 10:e minut |
| < 4000 | Var 15:e minut |
| < 8000 | Var 15:e minut |
| < 15 000 | Var 30:e minut |
| < 50 000 | Var 60:e minut |
| Över 50 000 | Separat utvärderad |
5. Fyll i uppgiftsuppgifter
- Fyll i ett unikt uppgiftsnamn för den schemalagda uppgiften.
- Uppgiftsanvändning indikerar att det är uppgiften som används för att läsa data eller skriva data. Observera att om händelsetypen ändras i efterhand kan det avbryta arbetsflödena. I schemalagda uppgifter måste denna typ vara schemalagd.
- Mappningstypen är Generisk mall
Fyll i SQL fråga och attributnamn för ObjectG uid
- SQL fråga - SELECT-satsen används för att välja data från en databas.
- Attributnamn för ObjectG uid -
Fyll i felinformation
Valfria inställningar för felhantering. Om en schemalagd uppgift misslyckas kan ett datakort skapas som visar felet. Om felinställningar har definierats behöver administratören inte manuellt kontrollera statusen för schemalagda uppgifter.
- Felmall – Välj en mall för datakort som skapas vid fel under etableringen (anslutning till datakällor, timeouts etc.)
- Felmapp – Välj mapp där feldatakortet lagras.
- Felattribut – Välj ett attribut där i felmallen felinformationen ska lagras.
6. Fyll i generiska mappningar
- Målmall – Välj en mall för att definiera attributmappningar
- Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibilitet med vald mall.
- Attributmappningar
Om du använder kolumnalias i din select SQL klausul måste du även använda dessa i mappningstabellen. Till exempelSelect id as identifier, name from devices
Sedan behöver du mappa identifierare och namn (de är skiftlägeskänsliga)- Externt attribut - vilket attribut från databasen är mappat
- Lokalt attribut - till vilket attribut i M42 lösningsdata mappas.
Om du inte använder kolumnalias måste din mappning vara exakt som den är med tabellalias. select d.name from devices d;
Då borde mappningen vara:
7. Det är möjligt att ange ytterligare attribut, som läses från databasen, genom att välja Nytt attribut.
8. Spara provisioneringsuppgiften från knappen Spara. Om vissa obligatoriska attribut saknas visas knappen Spara i grått och visar vad som saknas i inställningarna.
12. Du har nu konfigurerat en schemalagd kopplingsuppgift för läsning av databasdata.
- Du kan nu vänta tills uppgiften har startats baserat på schemaläggning eller
- Kör uppgiften manuellt – genom att klicka på knappen konfigureras uppgiften för att schemaläggas att starta omedelbart. Vanligtvis för testkörningar eller om du inte vill ändra schemainställningarna, men vill köra uppgiften nu.
Konfigurera händelsebaserad uppgift
2025.3-versionen lade till stöd för händelsebaserade uppgifter.
Händelseuppgift används när data skrivs (eller andra händelsebaserade SQL anrop görs från Workflow) till kundernas SQL databas. Dessa funktioner för anslutningshantering är tillgängliga för alla Matrix42 Core , Pro and IGA -lösningar.
Exempel på användning av händelsebaserade uppgifter:
- Lägg till konto (lägg till rad i tabell)
- Uppdatera person (lägg till rad i tabell)
- Ta bort konto (ta bort rad från tabell)
- Välj en rad från tabellen (val kan returnera 0 eller 1 rad)
All konfiguration relaterad till anslutningshantering och händelsebaserade provisioneringsuppgifter konfigureras i Matrix42 Core , Pro eller IGA -anslutningsvyn.
1. Öppna konfigurationsvyn Matrix42 Core , Pro eller IGA (en kugghjulssymbol).
2. Öppna kopplingsvyn
3. Välj kopplingen som ska använda händelseuppgiften
4. Välj "Ny uppgift" under korrekta kopplingar Lista över händelsebaserade uppgifter
5. Fyll i uppgiftsinställningar
- Uppgiftsnamn - Ange ett namn för uppgiften, det kommer att visas i kopplingsvyn.
- Det är god praxis att namnge en uppgift på ett sätt som beskriver dess syfte, till exempel [Mallnamn]:[Aktivitet] IGA -tjänstförfrågan: Lägg till konto
- Uppgiftsanvändningen indikerade att det är den uppgift som används för att läsa data eller skriva data. Kan ändras i efterhand, men det rekommenderas inte om händelseuppgiften används. Det kommer att störa arbetsflöden.
- Mappningstypen beror på vilken typ av information som läses från katalogen. Val av identitetsmappningar visas baserat på den här inställningen.
- Generisk (en mall) – används när generisk information läses från katalogen. Detta kan vara vilken typ av data som helst.
Varning om att ändra uppgiftsanvändning eller mappningstyp när händelseuppgift används:
6. Fyll i uppgiftsparametrar och generiska mappningar
- SQL fråga - sql du vill köra
Exempel: SELECT e.id som identifierare, e.name FROM employees e WHERE e.id = $first_name$
Resultatet för valda SQL klausuler kommer att lagras i attributet som är satt till Orchestration-noden. Attributet Response:
Parametrar till sql klausuler sätts med hjälp av syntaxen $attributecode$, som i det här exemplet: $first_name$
Andra SQL exempel:
INSERT INTO employees (id, name) VALUES (1, '$first_name$');
UPDATE employees SET name = '$first_name$' WHERE id = $id$;
DELETE FROM employees WHERE id = 1;
- Målmall – Välj en mall för att definiera attributmappningar
- Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibilitet med selectedTemplate.
- Konfigurera inga generiska mappningar för händelsebaserade uppgifter i generiska SQL Connector (dessa mappningar används inte)
7. Spara uppgift
Spara provisioneringsuppgiften med knappen "spara"
Om någon obligatorisk information saknas kan du inte spara uppgiften och spara-knappen visar den information som saknas.
8. Konfigurera arbetsflödet för att använda den här händelsebaserade uppgiften med Orchestration-noden
Nästa steg är att konfigurera arbetsflödet för att använda den här händelsebaserade uppgiften.
Från arbetsflödesmotorn i plattformen är det möjligt att köra provisioneringsaktiviteter mot kunddatabaser. Det betyder att vilken som helst av de tillgängliga orkestreringsnodernas aktiviteter kan köras när som helst i arbetsflödet med hjälp av aktiviteten: Kör händelseuppgift.
Arbetsflödesreferenser visas på översiktssidan för kopplingar (du kan uppdatera arbetsflödesreferenser med knappen "Visa arbetsflödesreferenser"):
Felsökning
I det här kapitlet beskrivs felsökningsalternativ,
- Om felmall används, kontrollera korrekt datakort
- Kontrollera historiken för schemalagda uppgifter från kopplingshanteringen
- Kontrollera Pro loggar