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 . https://<DIN_RAYNET_URL>.raynetone.com/v1/resultDatabase (till exempel: https://matrix42-demo-datahub.raynetone.com/v1/resultDatabase) Detta kan användas som prefix för den slutliga URL:en som ska anropas.
• REST kopplingstyp – välj Generisk
• Autentiseringsmetod - Autentiseringsrubrik
• Namn på autentiseringshuvud - ApiKey
• Autentiseringshuvudvärde - värdet på din apikey
• Pagineringstyp - Sidökning
• Pagineringssidaattribut - sida
• Paginering Sidstart - 1
• Attribut för sidstorlek för paginering - page_size
• Sidstorlek för paginering - 500 (om du vill använda en större sidstorlek, bekräfta från Raynet dokumentation att de stöder den sidstorleken)

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 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 Raynet root https-certifikat så att det 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 Raynet

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

I det här kapitlet lägger vi till schemalagda uppgifter för att läsa data från Raynet .

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 data du vill hämta.
I det här exemplet hämtar vi användare med hjälp av: resultTable/paged?tableName=DataTransformation-result_devices vilket i princip hämtar all data från Raynet DataTransformation-result_devices -table.

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 delfrågor.

Frågerubriker - för Raynet behöver vi lägga till dessa rubriker:
Acceptera / application/json
Innehållstyp / application/json

Värdemarkör - poster

Felmarkör - lämna detta 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. I det här fallet import_id

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 eftersom vi hämtar enheter)
• 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 Resurs/Servrar)
• Mappning av datakälltyp – valfritt. Om den är inställd skriver den kopplingstyp till det attributet.
• Mappning av uppgifts-ID – Uppgifts-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.

• Attributmappningar
  1. Externt attribut - vilket attribut från Raynet API 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 Unique Attribute, i det här exemplet är det import_id. Det måste mappas till det unika attributet i mallen, i det här exemplet Name.
• Den första mappningen använder en underfråga för att mappa användargruppmedlemskap till multiValueField-attributet. Andra mappningar är för mappningar av användarattribut i huvudfrågan.

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".

Raynet API innehåller filtreringsfunktioner som kan användas från Native Connectors.
Raynet API dokumentation relaterad till filterfunktionalitet, versionsinformation Raynet 2025.3 

För att använda filter i frågeattributet för en uppgift måste du URL-koda filtervärdet manuellt eller använda någon webbplats (till exempel https://www.urlencoder.org ) för att göra kodningen.

Filterexempel utan URL-kodning (fungerar inte): resultTable/paged?tableName=DataTransformation-result_devices&filter=["device_manufacturer","=""HP"]
Samma exempel-url kodad (fungerar): resultTable/paged?tableName=DataTransformation-result_devices&filter= %5B%22device_manufacturer%22%2C%22%3D%22%2C%22HP%22%5D

Begränsningar år 2025.3

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