Valmistelun määrittämiseen tarvitset käyttöoikeuden alustan määrityskonsoliin.

1. Avaa hallinta-alue (ratassymboli).
2. Avaa Yhdistimet-näkymä.
3. Valitse "Uusi liitin"

4. Valitse tietolähteen tyypiksi Generic REST API

5. Anna liittimelle nimi ja lisää yhteysasetukset:

• Liittimen nimi – anna liittimellesi käyttäjäystävällinen nimi (nimeä voi muuttaa jälkikäteen)
• Isännän URL-osoite - REST API :n perus-URL-osoite. https://<OMA_RAYVERKKOSI_URL>.raynetone.com/v1/resultDatabase (esimerkiksi: https://matrix42-demo-datahub.raynetone.com/v1/resultDatabase) Tätä voidaan käyttää etuliitteenä kutsuttavalle lopulliselle URL-osoitteelle.
• REST liittimen tyyppi - valitse Yleinen
• Todennusmenetelmä - Todennusotsikko
• Todennusotsikon nimi - ApiKey
• Todennusotsikon arvo - apikey-avaimesi arvo
• Sivutustyyppi - Sivun lisäys
• Sivutussivun attribuutti - sivu
• Sivutussivun alku - 1
• Sivutuksen sivun kokoattribuutti - page_size
• Sivutus Sivukoko - 500 (jos haluat käyttää suurempaa sivukokoa, varmista Raynet dokumentaatiosta, että he tukevat kyseistä sivukokoa)

6. Täytä Web API -käyttäjätiedot

• Web API -käyttäjä - valitse oikea Web API -käyttäjä, jota käytetään kirjoitettaessa tietoja ulkoisesta järjestelmästä Matrix42 Core , Pro and IGA ratkaisuihin
• Web API -salasana - Web API -käyttäjän salasana

8. Tallenna liittimen tiedot

9. Lisää Raynet juuritason https-varmenne, jotta yhdistinten hallinta (EPE) voi määrittää sen luotettavaksi. Tämän voi tehdä vain Matrix42 :lla: Lisää varmenne.

10. Matrix42 Core , Pro and IGA ratkaisut voivat nyt muodostaa yhteyden Raynet

• Seuraava vaihe on määrittää ajoitettu tehtävä tietojen lukemista varten tai tapahtumatehtävä tietojen kirjoittamista varten ja toiminnot Raynet kohtaan.

Tässä luvussa lisätään ajoitettu tehtävä datan lukemiseksi Raynet .

1. Lisää ajoitettu tehtävä oikean liittimen alle napsauttamalla ”Uusi tehtävä”

2. Tehtävän määritteet

Aikataulutus - Aseta aikataulu tarvittaessa

Tehtävän nimi - Aseta informatiivinen nimi

Tehtävien käyttö - Ajoitettu

Kartoitustyyppi - Yleinen mallipohja

Kysely – Kysely riippuu siitä, mitä tietoja haluat noutaa.
Tässä esimerkissä haemme käyttäjiä käyttämällä komentoa: resultTable/paged?tableName=DataTransformation-result_devices, joka pohjimmiltaan hakee kaikki tiedot Raynet DataTransformation-result_devices -table -taulukosta.

Alikyselyt - Voit lisätä alikyselyitä, jos haluat lukea lisää varsinaisen kyselyn palauttamaan tulosjoukkoon liittyviä tietoja. Tässä esimerkissä emme käytä alikyselyitä.

Kyselyotsikot - Raynet meidän on lisättävä nämä otsikot:
Hyväksy / application/json
Sisältötyyppi / application/json

Arvomerkki - tietueet

Virheen merkki - jätä tämä tyhjäksi

API kutsujen turvakynnys - suositellaan asettamaan se kaksi kertaa niin suureksi kuin kuinka monta sivua tämä API palauttaa. Jos jätät sen tyhjäksi, turvakynnystä ei ole ja liitin voi siirtyä loputtomaan silmukkaan, jos määrityksissä on virhe.

Yksilöllinen attribuutti - Yksilöllinen attribuutti API tulosjoukossa. Tässä tapauksessa import_id

3. Täytä vikatiedot

Valinnaiset asetukset virheiden käsittelyyn. Jos ajoitettu tehtävä epäonnistuu, ESM:ään voidaan luoda datakortti, joka näyttää virheen. Jos virheasetukset on määritetty, järjestelmänvalvojan ei tarvitse tarkistaa ajoitettujen tehtävien tilaa manuaalisesti.

• Virhemalli - Valitse datakortin malli, joka luodaan, jos valmistelun aikana ilmenee virheitä (yhteys tietolähteisiin, aikakatkaisut jne.).
• Vikakansio - Valitse kansio, johon vikatietokortti on tallennettu.
• Virheattribuutti – Valitse attribuutti, mihin virhemallissa virhetiedot tallennetaan. Valitse tekstityyppiattribuutti.

4. Täytä yleisten yhdistämistietojen kenttä

Yhdistämisosiossa määritetään, mikä JSON-viestin attribuutti luetaan mihinkin Matrix42 Core , Pro and IGA -datakortin attribuuttiin.

• Kohdemalli – Valitse mallipohja määrittääksesi attribuuttimääritykset (tässä esimerkissä laite, koska noudamme laitteita)
• Kohdekansio - Valitse kansio kansioluettelosta. Luetteloa rajataan vastaamaan yhteensopivuutta valitun mallin kanssa. (tässä esimerkissä resurssi/palvelimet)
• Tietolähteen tyypin yhdistäminen - valinnainen. Jos se on asetettu, se kirjoittaa yhdistintyypin kyseiseen attribuuttiin.
• Tehtävätunnuksen yhdistäminen - Tehtävätunnusnumero kirjoitetaan tähän attribuuttiin. Oikean attribuutin valinta riippuu mallipohjan konfiguroinnista.
• Aseta arvo datakortille, jos objekti on poistettu lähdejärjestelmästä - Tämä toiminto aktivoidaan asettamalla valintaruutu päälle. Kun jokin aiemmin kolmannen osapuolen järjestelmästä ratkaisuun luettu objekti poistetaan kolmannen osapuolen järjestelmästä, tämä ajoitettu tehtävä huomaa, että se on poistettu, ja merkitsee kyseisen datakortin valitun attribuutin haluamallasi arvolla. Tätä voidaan käyttää esimerkiksi tilan attribuutin asettamiseen arvoon Poistettu. Tämän attribuutin nimi ja arvo on asetettava sen mukaan, miten mallipohjasi on määritetty.

• Ominaisuusmääritykset
  1. Ulkoinen attribuutti - mikä Raynet API n attribuutti luetaan JSON-rungosta
  2. Paikallinen attribuutti - mihin Matrix42 Core , Pro and IGA attribuuttiin se on yhdistetty
• Määritemäärityksiin on mahdollista asettaa lisää määritteitä valitsemalla Uusi määrite.
• Sinun on lisättävä yhdistämismääritys myös yksilölliseen attribuuttiin, tässä esimerkissä se on import_id. Se on yhdistettävä mallineen yksilölliseen attribuuttiin, tässä esimerkissä nimeen.
• Ensimmäinen yhdistämismääritys käyttää alikyselyä käyttäjäryhmien jäsenyyksien yhdistämiseen multiValueField-attribuuttiin. Muut yhdistämismääritykset koskevat pääkyselyn käyttäjäattribuuttien yhdistämismäärityksiä.

5. Tallenna valmistelutehtävä Tallenna-painikkeella.

Jos joitakin pakollisia ominaisuuksia puuttuu, tallennuspainike näkyy harmaana ja se näyttää asetuksista puuttuvat tiedot.

6. Olet nyt määrittänyt aikataulun mukaisen yhdistintehtävän

• Voit nyt odottaa, kunnes tehtävä aloitetaan aikataulun perusteella tai
• Suorita tehtävä manuaalisesti – napsauttamalla tehtävänmuokkausikkunan yläreunassa olevaa ”Suorita tehtävä” -painiketta tehtävä määritetään ajoitettavaksi alkamaan välittömästi. Yleensä testiajoihin tai jos et halua muuttaa aikatauluasetuksia, mutta haluat suorittaa tehtävän nyt.

Esimerkki manuaalisen tehtävän suorituksen aloitusviestistä:

Jos tehtävä suoritetaan manuaalisesti (suorita tehtävä) tai se suoritetaan aikataulun mukaisesti, tehtävän tilaa voidaan tarkastella Ajoitettujen tehtävien luettelon hallintasarakkeesta napsauttamalla ”Näytä historia” -painiketta.

Raynet API sisältää suodatusominaisuuksia, joita voidaan käyttää natiiviliittimistä.
Raynet API -dokumentaatio suodatustoiminnoista Raynet 2025.3 -julkaisutiedot 

Jos haluat käyttää suodatinta tehtävän kyselyattribuutissa, sinun on URL-koodattava suodatinarvo manuaalisesti tai käytettävä verkkosivustoa (esimerkiksi https://www.urlencoder.org ) koodauksen suorittamiseen.

Suodatinesimerkki ilman URL-koodausta (ei toimi): resultTable/paged?tableName=DataTransformation-result_devices&filter=["laitteen_valmistaja","=","HP"]
Sama esimerkki URL-osoitteesta koodattu (toimii): resultTable/paged?tableName=DataTransformation-result_devices&filter= %5B%22device_manufacturer%22%2C%22%3D%22%2C%22HP%22%5D

Rajoitukset vuonna 2025.3

Suorituskykysyistä ei tueta useampaa kuin yhtä alikyselytasoa ajoitetuille tehtäville.