För att konfigurera provisionering behöver du åtkomst till plattformskonfigurationskonsolen.

1. Öppna administrationsområdet (en kugghjulssymbol).
2. Öppna vyn Kontakter.
3. Välj "Ny koppling"

4. Välj datakälltyp som Generic REST API

5. Ange ett namn för kontakten och lägg till anslutningsinställningar:

• Anslutningsnamn - ge din anslutning ett vänligt namn (namnet kan ändras i efterhand)
• Värd-URL - bas-URL för REST API . Detta kan användas som prefix för den slutliga URL:en som ska anropas.
• REST kopplingstyp – välj Generisk
• Autentiseringsmetod - Välj bärartoken
• Bärartoken - ange värde för bärartoken (utan bärartext i början)

6. Ställ in korrekt paginering

Du kan skapa två separata kopplingar med identiska inställningar, förutom att denna pagineringsinställning är annorlunda. Skapa en koppling för uppgifter där API stöder paginering och en annan koppling för uppgifter där API stöder inte paginering.

A) Ange paginering för Matrix42 Enterprise /SAM Connector (för uppgifter som anropar API :er som inte stöder paginering)
Använd inaktiverad eftersom dataquery- API som används i exemplet med schemalagd uppgift inte stöder paginering:

B) Ange paginering för Matrix42 Enterprise /SAM Connector, för uppgifter som anropar API : er som stöder paginering .

• Pagineringstyp - Sidökning
• Sidattribut för paginering - sidnummer
• Paginering Sidstart - 1
• Attribut för sidstorlek för paginering - sidstorlek
• Sidstorlek för sidnumrering – ställ in detta enligt dina data. Kontrollera maxvärdet från Matrix42 Enterprise /SAM-dokumentationen eller från konsulter. Detta måste vara mindre än den minsta mängd data som returneras av API du anropar. Om du ställer in detta för högt returnerar Matrix42 Enterprise eller SAM inga data.

7. Uppfylla användarinformation för Web API

• Web API användare - välj rätt Web API användare som används vid skrivning av data från externa system till Matrix42 Core , Pro and IGA lösningar
• Web API lösenord – lösenord för Web API användaren

8. Spara kontaktinformation

9. Lägg till ett externt Matrix42 Enterprise eller SAM-systems root-https-certifikat som ska vara betrott av Connector Management (EPE). Detta kan endast göras med Matrix42 : Lägg till certifikat.

10. Matrix42 Core , Pro and IGA lösningar kan nu ansluta till Matrix42 Enterprise och Matrix42 SAM

• Nästa steg är att konfigurera en schemalagd uppgift för dataläsning eller en händelseuppgift för dataskrivning och åtgärder mot Matrix42 Enterprise och SAM.

1. Lägg till schemalagd uppgift under rätt anslutning genom att klicka på "Ny uppgift"

2. Ange uppgiftsattribut

Schemaläggning - Ställ in schemaläggning om det behövs

Uppgiftsnamn - Ange informativt namn

Uppgiftsanvändning - Schemalagd

Mappningstyp - Generisk mall

Fråga – Frågan beror på vilken Matrix42 Enterprise eller API slutpunkt du vill anropa för att hämta data. Se Matrix42 Enterprise -dokumentationen för korrekt API URL och parametrar.
I det här exemplet: /data/fragments/SPSActivityClassBase?columns=ID,Ämne,Beskrivning,Ämnesnummer

Delfrågor – Du kan lägga till delfrågor om du vill läsa mer data relaterad till resultatmängden som returneras av den faktiska frågan. I det här exemplet använder vi inte den funktionen.

Frågerubriker – kan lämnas tomma

Värdemarkör - lämna tomt

Felmarkör - lämna tomt

Säkerhetsgräns för API anrop - föreslås att den sätts dubbelt så hög som antalet sidor som detta API returnerar. Om du lämnar den tom finns det ingen säkerhetsgräns och då kan Connector gå till oändlig loop om det uppstår ett fel i konfigurationen.

Unikt attribut - Unikt attribut på API resultatmängden. Vanligtvis ID i Matrix42 Enterprise API :er, men bekräfta det från dokumentationen.

3. Fyll i felinformation

Valfria inställningar för felhantering. Om en schemalagd uppgift misslyckas kan ett datakort skapas till ESM 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. Välj texttypsattribut.

4. Fyll i information om generiska mappningar

I mappningsavsnittet konfigurerar du vilket attribut från JSON-meddelandet som ska läsas till vilket attribut på Matrix42 Core , Pro and IGA -datakortet.

• Målmall – Välj en mall för att definiera attributmappningar (i det här exemplet Ticket)
• Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibiliteten med den valda mallen. (i det här exemplet ärenden)
• Mappning av datakälltyp – valfritt. Om den är inställd skriver den kopplingstyp till det attributet.
• Mappning av aktivitets-ID – aktivitets-ID-numret skrivs till detta attribut. Rätt attribut att välja beror på hur din mall är konfigurerad.
• Ange värde för datakort för objekt som raderats från källsystemet - Den här funktionen aktiveras genom att markera kryssrutan. När ett objekt som tidigare lästes från ett tredjepartssystem till en lösning raderas från tredjepartssystemet, meddelar den här schemalagda uppgiften att det har raderats och markerar det valda attributet för datakortet med önskat värde. Detta kan till exempel användas för att ställa in Statusattributet till 09 - Stängt (som visas i skärmdumpen nedan). Attributnamnet och attributvärdet måste ställas in baserat på hur din mall är konfigurerad.

• Attributmappningar
  1. Externt attribut - vilket attribut från Matrix42 Enterprise -system API et läses från JSON-kroppen
  2. Lokalt attribut - till vilket attribut i Matrix42 Core , Pro and IGA -attributet mappas
• Det är möjligt att ange ytterligare attribut till attributmappningar genom att välja Nytt attribut.
• Du måste även lägga till mappning till Unikt attribut, i det här exemplet är det ID. Det måste mappas till det unika attributet i mallen, i det här exemplet text1.

5. Spara provisioneringsuppgiften från knappen Spara.

Om vissa obligatoriska attribut saknas visas spara-knappen i grått och den visar vad som saknas i inställningarna.

6. Du har nu konfigurerat schemalagd kopplingsuppgift

• Du kan nu vänta tills uppgiften har startats baserat på schemaläggning eller
• Kör uppgiften manuellt – genom att klicka på knappen ”Kör uppgift” högst upp i uppgiftsredigeringsfönstret konfigureras uppgiften så att den schemaläggs att starta omedelbart. Vanligtvis för testkörningar eller om du inte vill ändra schemainställningarna, men vill köra uppgiften nu.

Exempel på startmeddelande för manuell körning av uppgift:

Om uppgiften körs manuellt (kör uppgift) eller enligt schemaläggning kan uppgiftens status granskas från hanteringskolumnen för listan över schemalagda uppgifter genom att klicka på knappen "Visa historik".

1. Lägg till schemalagd uppgift under rätt anslutning genom att klicka på "Ny uppgift"

2. Ange uppgiftsattribut

Schemaläggning - Ställ in schemaläggning om det behövs

Uppgiftsnamn - Ange informativt namn

Uppgiftsanvändning - Schemalagd

Mappningstyp - Generisk mall

Fråga – Frågan beror på vilken Matrix42 SAM API slutpunkt du vill anropa för att hämta data. Se Matrix42 SAM-dokumentationen för korrekt API URL och parametrar.
I det här exemplet: dataquery/aad704de-a242-c667-123b-08d45a5faa97

Obs! Om du använder Matrix42 Enterprise /SAM dataquery API (som i det här exemplet) returnerar det som standard endast 10 000 objekt. Dataquery API stöder inte paginering. Om du behöver hämta fler än 10 000 objekt, kontakta Matrix42 och be om att öka din miljögräns. Mer information nedan:

Antal poster för datafrågasvar
Inställningen PDRDwpConfigurationClass.DataQueryMaxResponseRecords definierar det maximala antalet poster som returneras av webbtjänsten "Data Query".
Standardvärde: 10 000 poster.

Delfrågor – Du kan lägga till delfrågor om du vill läsa mer data relaterad till resultatmängden som returneras av den faktiska frågan. I det här exemplet använder vi inte den funktionen.

Frågerubriker – kan lämnas tomma

Värdemarkör - lämna tomt

Felmarkör - lämna tomt

Säkerhetsgräns för API anrop - föreslås att den sätts dubbelt så hög som antalet sidor som detta API returnerar. Om du lämnar den tom finns det ingen säkerhetsgräns och då kan Connector gå till oändlig loop om det uppstår ett fel i konfigurationen.

Unikt attribut - Unikt attribut på API resultatmängden. Vanligtvis ID i Matrix42 SAM API :er, men bekräfta det från dokumentationen.

3. Fyll i felinformation

Valfria inställningar för felhantering. Om en schemalagd uppgift misslyckas kan ett datakort skapas till ESM 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. Välj texttypsattribut.

4. Fyll i information om generiska mappningar

I mappningsavsnittet konfigurerar du vilket attribut från JSON-meddelandet som ska läsas till vilket attribut på Matrix42 Core , Pro and IGA -datakortet.

• Målmall – Välj en mall för att definiera attributmappningar (i det här exemplet Enhet)
• Målmapp – Välj en mapp från en lista med mappar. Listan begränsas för att matcha kompatibilitet med vald mall. (i det här exemplet Resurser/Servrar)
• Mappning av datakälltyp – valfritt. Om den är inställd skriver den kopplingstyp till det attributet.
• Mappning av aktivitets-ID – aktivitets-ID-numret skrivs till detta attribut. Rätt attribut att välja beror på hur din mall är konfigurerad.
• Ange värde för datakort för objekt som raderats från källsystemet - Den här funktionen aktiveras genom att markera kryssrutan. När ett objekt som tidigare lästes från ett tredjepartssystem till en lösning raderas från tredjepartssystemet, meddelar den här schemalagda uppgiften att det har raderats och markerar det valda attributet för datakortet med önskat värde. Detta kan till exempel användas för att ställa in Statusattributet till Borttaget. Attributnamnet och attributvärdet måste ställas in baserat på hur din mall är konfigurerad. I det här exemplet används inte den här funktionen.

• Attributmappningar
  1. Externt attribut - vilket attribut från Matrix42 SAM-system API et läses från JSON-kroppen
  2. Lokalt attribut - till vilket attribut i Matrix42 Core , Pro and IGA -attributet mappas
• Det är möjligt att ange ytterligare attribut till attributmappningar genom att välja Nytt attribut.
• Du måste även lägga till mappning till Unikt attribut, i det här exemplet är det Id. Det måste mappas till ett unikt attribut i mallen, i det här exemplet Intune-ID.

5. Spara provisioneringsuppgiften från knappen Spara.

Om vissa obligatoriska attribut saknas visas spara-knappen i grått och den visar vad som saknas i inställningarna.

6. Du har nu konfigurerat schemalagd kopplingsuppgift

• Du kan nu vänta tills uppgiften har startats baserat på schemaläggning eller
• Kör uppgiften manuellt – genom att klicka på knappen ”Kör uppgift” högst upp i uppgiftsredigeringsfönstret konfigureras uppgiften så att den schemaläggs att starta omedelbart. Vanligtvis för testkörningar eller om du inte vill ändra schemainställningarna, men vill köra uppgiften nu.

Exempel på startmeddelande för manuell körning av uppgift:

Om uppgiften körs manuellt (kör uppgift) eller enligt schemaläggning kan uppgiftens status granskas från hanteringskolumnen för listan över schemalagda uppgifter genom att klicka på knappen "Visa historik".

Här är ett grundläggande exempel på händelseuppgift och orkestreringsnod, som används för att skapa aktivitetstyp 6-ärenden till Matrix42 Enterprise. I produktionsanvändning måste du utforma vilken typ av ärenden du vill skapa och vilka attribut som behöver ställas in på dem.

1. Lägg till händelsebaserad uppgift under rätt anslutning genom att klicka på "Ny uppgift"

2. Ange attribut för uppgiften

Uppgiftsnamn - beskrivande unikt namn
Uppgiftsanvändning - Händelse
Mappningstyp - Generisk mall
Fråga - URL för det API du vill anropa. I det här exemplet skapar vi en ticket, så vi använder frågan: /ticket/ (den slutliga API URL:en som ska anropas konstrueras genom att sammanfoga connector-URL:en, denna fråge-URL och orkestreringsnodens REST URL). Du kan också lämna frågan tom och ange din API-URL till attributet REST URL för orkestreringsnoden.

Formatering av datumattribut – ange rätt format om du provisionerar datumattribut

DateTime-attributformaterare – ange rätt format om du etablerar datetime-attribut

Ställ in generiska mappningar

Målmall - mall från vilken arbetsflöde du ska anropa den här uppgiften
Målmapp - mapp för dina data

Inga attribut har angetts för mappningstabellen (externt attribut - lokalt attribut). Attributmappning görs på arbetsflödesorkestreringsnoden.

3. Spara uppgift

4. Skapa Orchestration-noden i ditt arbetsflöde för att anropa denna händelsebaserade uppgift

Orkestrera - Pro
Datakälla - Generiskt REST API
Aktivitet - Generiskt REST anrop
Target - Skapa ärende som serviceförfrågan (ditt händelsebaserade uppgiftsnamn)
Åtgärd - I det här exemplet POST eftersom vi skapar ärenden med API som skapar ärendet.
REST URL - i det här exemplet create?activitytype=6 eftersom vi skapar ärenden med aktivitetstyp 6
REST Body – du kan generera API anropskroppen direkt här. Eller i mer komplicerade fall generera den separat (i skriptnoden) till något attribut, och sedan använda det attributet här. I det här fallet skapas kroppen för att skapa ett ärende direkt här, med hjälp av kodvariablerna för attributen subject och details.
Kroppen som vi använder i det här exemplet har hårdkodad Användare (du kan överväga att använda någon annan logik för det), ämnes- och beskrivningsvärden läses från datakortsattributen ämne och detaljer.
{
"Ämne": "$ämne$",
"Beskrivning": "$detaljer$",
"Prioritet": 0,
"Påverkan": 0,
"Brådskande": 0,
"Användare":"0e8aac28-b2df-ef11-58b1-005056905558"
}

REST Response-attribut - svaret från API anropet kommer att lagras i detta attribut
Undantag Pro provisionering – om det är problem med API anropet kommer undantaget att lagras i detta attribut

Slutför ditt arbetsflöde, andra noder och flöde

Spara arbetsflöde och publicera det

5. Testarbetsflöde och händelsebaserad uppgift

Begränsningar år 2025.3

Av prestandaskäl stöds inte fler än en nivå av underfrågor för schemalagda uppgifter.