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. Tätä voidaan käyttää etuliitteenä kutsuttavalle lopulliselle URL-osoitteelle.
• REST liittimen tyyppi - valitse Yleinen
• Todennusmenetelmä - Valitse haltijan tunnus
• Haltijan tunnus - aseta haltijan tunnusarvon (ilman haltijan tunnustekstiä alussa)

6. Aseta oikea sivutus

Voit luoda kaksi erillistä liitintä identtisillä asetuksilla, paitsi että tämä sivutusasetus on erilainen. Luo yksi liitin tehtäville, joissa API tukee sivutusta, ja toinen liitin tehtäville, joissa API ei tue sivutusta.

A) Sivutuksen asettaminen Matrix42 Enterprise /SAM-liittimelle (tehtäville, jotka kutsuvat API -rajapintoja, jotka eivät tue sivutusta)
Käytä käytöstä poistettua, koska ajoitetun tehtävän esimerkissä käytetty dataquery- API ei tue sivutusta:

B) Sivutuksen asettaminen Matrix42 Enterprise /SAM-liittimelle tehtäville, jotka kutsuvat sivutusta tukevia API -rajapintoja.

• Sivutustyyppi - Sivun lisäys
• Sivutussivun ominaisuus - sivunumero
• Sivutussivun alku - 1
• Sivutuksen sivun kokoattribuutti - sivun koko
• Sivutuskoko – aseta tämä tietojesi mukaan. Tarkista maksimiarvo Matrix42 Enterprise /SAM:n dokumentaatiosta tai konsulteilta. Tämän on oltava pienempi kuin kutsumasi API n palauttama pienin tietomäärä. Jos asetat tämän liian suureksi Matrix42 Enterprise tai SAM ei palauta mitään tietoa.

7. 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ää ulkoinen Matrix42 Enterprise tai SAM-järjestelmän juuri-https-varmenne, jotta yhdistinten hallinta (EPE) voi luottaa siihen. Tämän voi tehdä vain Matrix42 :lla: Lisää varmenne.

10. Matrix42 Core , Pro and IGA ratkaisut voidaan nyt yhdistää Matrix42 Enterprise ja Matrix42 SAM:iin.

• Seuraava vaihe on määrittää ajoitettu tehtävä tietojen lukemista varten tai tapahtumatehtävä tietojen kirjoittamista varten sekä toiminnot Matrix42 Enterprise ja SAM:ia kohtaan.

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ä Matrix42 Enterprise tai API päätepistettä haluat kutsua tiedon hakemiseksi. Katso oikea API URL ja parametrit Matrix42 Enterprise -dokumentaatiosta.
Tässä esimerkissä: /data/fragments/SPSActivityClassBase?columns=ID,Aihe,Kuvaus,Lippunumero

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

Kyselyotsikot – voidaan jättää tyhjiksi

Arvomerkki - jätä tyhjäksi

Virheen merkki - jätä 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. Yleensä tunniste Matrix42 Enterprise API -rajapinnoissa, mutta varmista se dokumentaatiosta.

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

• Kohdemallipohja – Valitse mallipohja määritteiden yhdistämismääritysten määrittämiseksi (tässä esimerkissä tiketti)
• Kohdekansio - Valitse kansio kansioluettelosta. Luetteloa rajataan vastaamaan yhteensopivuutta valitun mallin kanssa. (tässä esimerkissä Tiketit)
• Tietolähteen tyypin yhdistäminen - valinnainen. Jos se on asetettu, se kirjoittaa yhdistintyypin kyseiseen attribuuttiin.
• Tehtävätunnuksen yhdistäminen - Tehtävätunnus 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 esimerkiksi käyttää tilan attribuutin asettamiseen arvoon 09 - Suljettu (kuten alla olevassa esimerkkikuvakaappauksessa näkyy). Tämän attribuutin nimi ja arvo on asetettava mallipohjan määritysten perusteella.

• Ominaisuusmääritykset
  1. Ulkoinen attribuutti - mikä Matrix42 Enterprise -järjestelmän 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 ID. Se on yhdistettävä mallineen yksilölliseen attribuuttiin, tässä esimerkissä text1.

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 tilan voi tarkastella Ajoitettujen tehtävien luettelon hallintasarakkeesta napsauttamalla ”Näytä historia” -painiketta.

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ä Matrix42 SAM API -päätepistettä haluat kutsua tiedon hakemiseksi. Katso oikea API URL ja parametrit Matrix42 SAM -dokumentaatiosta.
Tässä esimerkissä: dataquery/aad704de-a242-c667-123b-08d45a5faa97

Huom! Jos käytät Matrix42 Enterprise /SAM dataquery API (kuten tässä esimerkissä), se palauttaa oletuksena vain 10 000 objektia. Dataquery API ei tue sivutusta. Jos sinun on noudettava yli 10 000 objektia, ota yhteyttä Matrix42 ja pyydä nostamaan ympäristösi rajaa. Lisätietoja alla:

Tietokyselyvastausten tietueiden määrä
Asetus PDRDwpConfigurationClass.DataQueryMaxResponseRecords määrittää "Data Query" -verkkopalvelun palauttamien tietueiden enimmäismäärän.
Oletusarvo: 10 000 tietuetta.

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

Kyselyotsikot – voidaan jättää tyhjiksi

Arvomerkki - jätä tyhjäksi

Virheen merkki - jätä 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. Yleensä tunnus Matrix42 SAM API :ssa, mutta varmista se dokumentaatiosta.

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 valmistelussa 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 ominaisuusmääritysten määrittämiseksi (tässä esimerkissä laite)
• Kohdekansio - Valitse kansio kansioluettelosta. Luetteloa rajataan vastaamaan yhteensopivuutta valitun mallin kanssa. (tässä esimerkissä Resurssit/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. Tässä esimerkissä tätä toimintoa ei käytetä.

• Ominaisuusmääritykset
  1. Ulkoinen attribuutti - mikä Matrix42 SAM API attribuutti luetaan JSON-rungosta
  2. Paikallinen attribuutti - mihin Matrix42 Core , Pro and IGA attribuuttiin se on yhdistetty
• Määritysten yhdistämismää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 Id. Se on yhdistettävä mallineen yksilölliseen attribuuttiin, tässä esimerkissä Intune-tunnukseen.

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

Tässä on perusesimerkki tapahtumatehtävästä ja orkestrointisolmusta, joita käytetään luomaan activitytype 6 -tikettejä Matrix42 yritysympäristöön. Tuotantokäytössä sinun on suunniteltava, minkä tyyppisiä tikettejä haluat luoda ja mitä ominaisuuksia niille on asetettava.

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

2. Määritä tehtävälle määritteet

Tehtävän nimi - kuvaava yksilöllinen nimi
Tehtävien käyttö - Tapahtuma
Yhdistämistyyppi - Yleinen mallipohja
Kysely - kutsuttavan API n URL-osoite. Tässä esimerkissä luomme tiketin, joten käytämme kyselyä: /ticket/ (lopullinen kutsuttava API URL-osoite muodostetaan yhdistämällä liittimen URL-osoite, tämä kyselyn URL-osoite ja orkestrointisolmun REST URL-osoite). Voit myös jättää kyselyn tyhjäksi ja asettaa API-URL-osoitteeksi Orkestrointisolmun REST URL-attribuutin.

Päivämääräattribuutin muotoilija - aseta oikea muoto, jos olet määrittämässä päivämääräattribuutteja

Päivämäärä- ja aika-attribuuttien muotoilija – aseta oikea muoto, jos olet määrittämässä päivämäärä- ja aika-attribuutteja

Aseta yleiset määritykset

Kohdemallipohja – mallipohja, josta työnkulkua aiot kutsua tätä tehtävää
Kohdekansio - kansio tiedoillesi

Määritystaululle (ulkoinen määrite - paikallinen määrite) ei ole asetettu määritteitä. Määritteiden yhdistäminen tehdään työnkulun orkestrointisolmussa.

3. Tallenna tehtävä

4. Luo työnkulkuusi Orchestration-solmu kutsuaksesi tätä tapahtumapohjaista tehtävää.

Orchestrate - Pro
Tietolähde - Yleinen REST API
Aktiviteetti - Yleinen REST kutsu
Target - Luo tiketti palvelupyynnöksi (tapahtumapohjainen tehtävänimi)
Toiminto - Tässä esimerkissä POST-funktio luo tikettejä API lla, joka luo tiketit.
REST URL - tässä esimerkissä create?activitype=6, koska luomme tikettejä, joiden activitytype on 6
REST runko – voit luoda API -kutsurungon suoraan tähän. Tai monimutkaisemmissa tapauksissa luoda sen erikseen (skriptin solmussa) jollekin attribuutille ja käyttää sitten kyseistä attribuuttia tässä. Tässä tapauksessa tiketin luomiseen tarvittava runko luodaan suoraan tähän käyttämällä subject- ja details-attribuuttikoodimuuttujia.
Tässä esimerkissä käyttämämme runko sisältää kiinteästi koodatun käyttäjän (voit harkita jonkin muun logiikan käyttöä), ja subject- ja description-arvot luetaan datakortin subject- ja details-attribuuteista.
{
"Aihe": "$aihe$",
"Kuvaus": "$yksityiskohdat$",
"Prioriteetti": 0,
"Vaikutus": 0,
"Kiireellisyys": 0,
"Käyttäjä": "0e8aac28-b2df-ef11-58b1-005056905558"
}

REST vastausattribuutti - API kutsun vastaus tallennetaan tähän attribuuttiin
Pro - jos API kutsussa on ongelma, poikkeus tallennetaan tähän attribuuttiin

Viimeistele työnkulkusi muut solmut ja työnkulku

Tallenna työnkulku ja julkaise se

5. Testien työnkulku ja tapahtumapohjainen tehtävä

Rajoitukset vuonna 2025.3

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