Aikataulutettavat tehtävät
The Ajoituspalvelu tarjoaa sinulle mahdollisuuden luoda ajoitettuja tehtäviä, jotka suorittavat toiminnon automaattisesti määritettynä aikana määritettyjen ehtojen mukaisesti. Ajoitettujen tehtävien avulla voit suorittaa automaattisesti käynnistettäviä toimintoja, kuten sähköpostin lähettämisen, tekstitiedostojen luomisen ja datakortin tietojen muuttamisen. Voit määrittää tehtävän tyypin ja suoritusajankohdan Ajoitettavat tehtävät -editorilla .
Kun avaat Ajoitettavat tehtävät -näkymän, Muokkaa ajoitettavia tehtäviä -taulukko listaa mahdolliset määritetyt tehtävät. Ajoitetuilla tehtävillä on vihreä kuvake. Tehtävillä, joita ei ole koskaan suoritettu, on punainen kuvake.
Ajoitettavat tehtävät -näkymässä voit poistaa käyttämättömiä tehtäviä napsauttamalla roskakorikuvaketta. Voit muokata olemassa olevaa tehtävää napsauttamalla sen nimeä. Voit myös luoda uusia tehtäviä napsauttamalla Lisää uusi tehtävä -painiketta.
Aikataulutettavien tehtävien luominen
Pääset ajoitettavien tehtävien editoriin avaamalla järjestelmänvalvojan käyttöliittymän Aikataulutettavat tehtävät -osion ja napsauttamalla Aikataulutettavat tehtävät. Napsauta Muokkaa ajoitettavia tehtäviä -näkymän vasemmassa yläkulmassa Lisää uusi tehtävä . Valitse tehtävän tyyppi. Aikataulutettavien tehtävien editori avautuu työalueelle.
Kaikille ajoitettaville tehtäville on määritettävä seuraavat tiedot:
- Kuvaus – Anna tehtävän kuvaus, joka näkyy Muokkaa ajoitettavia tehtäviä -näkymässä. Voit määrittää tehtävän käytön ja erottaa tehtävät saman tehtävätyypin perusteella.
- Käyttäjä – Valitse käyttäjä, jonka oikeuksilla tehtävä suoritetaan.
Aikataulutus – Aktivoi tehtävä asettamalla aikataulutus käyttöön. Jos jätät aikataulutuksen pois päältä, ESM tallentaa tehtävän, mutta ei suorita sitä. - Suorita – Määritä, milloin tehtävä suoritetaan.
- Joka päivä: Valitse x minuutin tai tunnin välein, jolloin tehtävä suoritetaan. Aloituskohdasta voit määrittää aloitusajan ja myös ajoittaa eri tehtävien suorituksen eri aikoina, jotta ne eivät mene päällekkäin tai ainakin enimmäkseen suoritetaan eri aikoina, jos haluat.
- Joka viikko: Valitse viikonpäivät, jolloin tehtävä suoritetaan. Kellonaika (@hh:mm) antaa sinun päättää aloitusajan ja myös ajoittaa eri tehtävien suorittamisen eri aikoina, jotta ne eivät mene päällekkäin tai ainakin enimmäkseen suoritetaan eri aikoina, jos haluat.
- Joka kuukausi: Valitse kuukauden päivä, jona tehtävä suoritetaan. Kellonaika (@hh:mm) antaa sinun päättää aloitusajan ja myös ajoittaa eri tehtävien suorituksen eri aikoina, jotta ne eivät mene päällekkäin tai ainakin enimmäkseen suoritetaan eri aikaan, jos haluat.
- Joka vuosineljännes: Valitse vuosineljänneksen kuukaudet (1, 2, 3) ja minä kuukauden päivänä tehtävä suoritetaan. Kellonaika (@hh:mm) antaa sinun päättää aloitusajan ja myös ajoittaa eri tehtävien suorittamisen eri aikoina, jotta ne eivät mene päällekkäin tai ainakin enimmäkseen suoritetaan eri aikoina, jos haluat.
- Myös tehtäväkohtaisia ominaisuuksia vaaditaan.
Tehtäväkohtaiset tehtäväominaisuudet näkyvät aikataulutuksen alapuolella olevassa työalueella. Jokaisella tehtävällä on erilaiset tehtäväominaisuudet.
Määritä tehtäväkohtaiset ominaisuudet valitun tehtävätyypin perusteella. Pakolliset ominaisuudet näkyvät heti, kun näkymä avataan. Valinnaisia ominaisuuksia voidaan lisätä Lisää ominaisuus -painikkeella. Käytännössä jokainen ominaisuus koostuu nimi-arvo-parista, joka tarkentaa tai muuttaa tehtävän toimintaa. Joillakin ominaisuuksilla on käyttöliittymä, jonka avulla voit valita arvon alasvetovalikosta tai napsauttamalla valintanappia.
Kysymysmerkkikuvake avaa ominaisuuden ohjetekstin. Ominaisuus poistetaan napsauttamalla ominaisuuden oikealla puolella olevaa poistokuvaketta (x).
Manuaalisesti lisätyt ominaisuuksien nimet ja arvot ovat kirjainkokoriippuvaisia ja niiden on oltava tarkkoja. Esimerkiksi asetusten nimet on merkittävä täsmälleen ohjetekstin mukaisesti.
Tehtävätyypit on kuvattu alla.
CSVImportTask (CSV-liitin)
CSV-liitin tietojen tuomiseen ulkoisista järjestelmistä. CSV-tiedosto voidaan noutaa paikalliselta levyltä tai SFTP-palvelimelta. Tiedoston on oltava RFC 4180 -standardin mukainen. Tukee SFTP:tä julkisen avaimen todennuksella ja salasanatodennuksella. Tuotavan tiedoston tiedostopäätteen on oltava .csv.
ChatIntegration-ajoitetun tehtävän
Käytä tätä tehtävää yhdessä Giosg Live -alustan Efecte Multi-Room Chat -ominaisuuden kanssa. Kaikki keskustelutietueet voidaan hakea Giosg Live -alustalta Efecte Service Managementiin raportointia ja auditointia varten. Tämä Efecte Service Managementin ajoitettu tehtävä hoitaa tietojen pyytämisen ja tallentamisen. Valitse tietojen hakemisen aikaväliksi kerran päivässä, mieluiten aamuvarhaisella, kuten klo 04.00-06.00. Edellisen arkipäivän tietojen hakeminen vie jonkin aikaa tuodakseen ne, joten sen suorittaminen useammin vaikuttaa negatiivisesti koko ratkaisun suorituskykyyn.
Huomautus:
Jotta tämä ajoitettu tehtävä toimisi, chat_session-mallin on oltava läsnä.
Päivämääräntarkistustehtävä
DateCheckerTask- tehtävän avulla voit saada ajoitettuja sähköpostiraportteja tai tiedostoja datakorteista, joiden päivämääräkentät vastaavat asetettuja kriteerejä. Jotta tehtävä toimisi tarkoitetulla tavalla, sen on täytettävä alla olevassa pakollisissa ominaisuuksissa kuvatut ominaisuudet. Valinnaiset ominaisuudet on kuvattu valinnaisten ominaisuuksien taulukossa.
Pakolliset DateCheckerTask-ominaisuudet:
Pakolliset DateCheckerTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
tarkistettu.attribuutti.koodi |
[attribuuttikoodi] |
Niiden attribuuttien attribuuttikoodi, joiden arvoa ESM tarkistaa tehtävän laukaisun varalta. Attribuutin tietotyypin on oltava date tai date and time . Jos syötät useamman kuin yhden koodin, erota koodit pilkuilla. |
tarkistettu.malli.koodi |
[mallikoodi] |
Niiden mallipohjien mallipohjan koodi, joiden arvoa ESM tarkistaa tehtävän käynnistyksen varalta. Jos syötät useamman kuin yhden koodin, erota koodit pilkuilla. |
liipaisupäivämäärä |
[nyt+5 päivää] |
Toiminnon käynnistävä nyt -päivämäärä-makro. Makron syntaksi on seuraava: nyt ±<n>d , missä
|
sähköpostin.aihe |
[Aiheteksti] |
Postin aihe. |
postin.vastaanottaja |
[Sähköpostiosoite] |
Vastaanottajan sähköpostiosoite, jota ESM käyttää viestin Vastaanottaja- kentässä. Jos annat useamman kuin yhden osoitteen, erota osoitteet pilkuilla. |
sähköposti.lähettäjä |
[Sähköpostiosoite] |
Lähettäjän sähköpostiosoite, jota ESM käyttää viestin Lähettäjä-kentässä. |
sähköpostin otsikko |
[Hyvä herra] |
Viestin rungon otsikko. |
mail.footer |
[Ystävällisin terveisin,] |
Viestin rungon alatunniste. |
sähköpostiraportti |
[$entity_name$ kohteessa $template$ on muuttunut.] |
Raporttiviesti, jossa voit käyttää seuraavia attribuuttien paikkamerkkejä:
Raportissa paikkamerkit korvataan todellisilla attribuuttiarvoilla: ”Datakortti $entity_name$ mallineesta $template$ on muuttunut. Uusi $attribute_name$-arvo on $value$” ” Volkswagen Passat 1.6 Firstline -tietokortin tiedot mallissa Auto on muuttunut. Uusi omistaja on JOHN SMITH .” |
Valinnaiset DateCheckerTask-ominaisuudet:
Valinnaiset DateCheckerTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
raportti.menetelmä |
tiedosto tai sähköposti tai vainStore |
Raportin toimitustapa. Oletusarvoinen menetelmä on mail . Jos arvoksi onlyStore asetettu , löydetyt datakortit tallennetaan mallipohjaan liitettyihin triggerikuuntelijoihin ja attribuuttien käsittelijöihin. |
liipaisinpäivämäärä.tiukka |
[tosi / taru] |
Jos arvoksi on asetettu true , löydetään vain liipaisupäivämäärän kortit. Muussa tapauksessa löydetään myös kortit, joiden trigger.date -arvo on peräisin ennen liipaisupäivämäärää. |
Mukana olevat.tietokortit |
[kaikki / näkyvät / piilotetut] |
Määrittää, mitkä datakortit sisällytetään ja mitkä ovat piilotettuja. Oletusarvo on "näkyvä". |
tiedosto.polku |
[c:\temp] |
Jos käytät tiedosto-menetelmää, ESM vaatii polun datalevyn hakemistoon, johon tiedosto tallennetaan. Oletuskansio on ”uploads”. Jos viitattua hakemistoa ei ole olemassa, toiminto epäonnistuu ja loki näyttää virheen. |
tiedosto.nimi |
[raportti.txt] |
Jos käytät tiedosto-metodia, ESM vaatii tiedostolle nimen. Oletusnimi on ”raportti.txt”. |
Tapahtumatehtävä
Voit hallita datakorttitapahtumien, kuten sähköposti- ja tallennustapahtumien, suoritusta ottamalla käyttöön tai poistamalla käytöstä tapahtumien suorituksen tämän tehtävän määritysasetuksissa. EventTask vaatii käyttäjän (jonka käyttöoikeuksia käytetään tehtävän suorittamiseen) ja ajoitussäännöt.
ESM 2023.3 -versiosta alkaen, jos tapahtumakohteen (joka määrittää EventTaskin suorittamat tapahtumat) etsinnässä on virheitä, yleensä määritysongelmien vuoksi, nämä virheet eivät estä tehtävää löytämästä ja suorittamasta oikein määritettyjä tapahtumia. Tällaisissa tilanteissa tapahtuma merkitään "osittain onnistuneeksi" ja EventTaskin käyttöliittymään tulee ilmoitus:
Viestijonon viestien lähettämisen suorittamiseen. Jos jonossa on viestejä, tämä tehtävä käynnistää viestien lähettämisen. Lisätietoja viestijono-osiossa.
ViestijonoTehtävä
Viestijonon viestien lähettämisen suorittamiseen. Jos jonossa on viestejä, tämä tehtävä käynnistää viestien lähettämisen. Lisätietoja viestijono-osiossa.
Lisenssinvalvontatehtävä
Ohjelmistoresurssien hallintatehtävä yrityksen ilmaisten ja käytettyjen ohjelmistolisenssien seurantaan.
Se lähettää sähköpostiraportin ohjelmistolisenssien rikkomuksista, eli asennetuista ohjelmistoista ilman lisenssiä ja ohjelmistoista, joissa on enemmän asennuksia kuin lisenssi sallii. Vaaditut ominaisuudet on kuvattu alla olevassa taulukossa.
Vaaditut LicenseMonitoringTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
no.licenses.header |
[Teksti] |
Lisensoimattomien ohjelmistojen otsikko. |
liian.monta.asennusta.otsikko |
[Teksti] |
Ylätunniste ohjelmistolle, joka on asennettu useammin kuin lisenssien määrä. |
sähköpostin.aihe |
[Aiheteksti] |
Postin aihe. |
sähköpostin.lähettäjä |
[Sähköpostiosoite] |
Sähköpostin lähettäjän osoite. |
postin.vastaanottaja |
[Sähköpostiosoite] |
Postin vastaanottajan osoite. |
Tekniset tiedot
LicenseMonitoringTask luo raportin kaikista valvotuista ohjelmistoasennuksista, joilla ei ole lisenssipoolia. Valvottujen ohjelmistoasennusten datakortilla ei ole lisenssipoolia, jos datakortin attribuutti LicenseManagementLicenseReference ei viittaa lisenssipooliin. Raportissa mainitaan myös, millä tietokoneella tämä ohjelmisto on asennettu.
Luotu raportti ilmoittaa myös, missä lisenssipooleissa on liikaa asennuksia. Tämä tehdään etsimällä lisenssipooleja, joihin viittaa enemmän valvottuja ohjelmistoasennuksia kuin LicenseManagementLicenseAmount-attribuutin arvo antaa.
MailTask
MailTask on tarkoitettu datakorttien luomiseen sähköposteista. Se lukee sähköpostin postilaatikosta, jonka on perustuttava sähköpostitiliin (jaettuja postilaatikoita ei tueta), tuo sähköpostin ESM:ään, liittää sähköpostin ja liitteet datakorttiin ja poistaa sitten viestin postilaatikosta.
Seuraavissa taulukoissa kuvataan MailTask-ominaisuudet.
Pakolliset MailTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
ryhmä.id |
[ryhmän tunnus] |
Sen kansion tunnus, johon sähköpostista luotu datakortti luodaan. |
template.code |
[mallikoodi] |
Sen mallin mallipohjan koodi, johon ESM:n on tarkoitus perustaa postista luotu datakortti. |
vastausviesti |
[Viestin teksti] |
Vastausviesti, jonka ESM toimittaa lähettäjälle. |
Valinnaiset MailTask-ominaisuudet | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
template.code.fall.back |
[mallikoodi] |
Varamallin mallin koodi. ESM perustaa datakortin varamalliin, jos se ei löydä seurantanumeroa ensisijaisesta mallista. |
vastaus.poissa käytöstä |
mikä tahansa |
Jos ominaisuudella on arvoa, ESM ei lähetä vastausta alkuperäiseen sähköpostiviestiin automaattisesti. |
vastaus.lähettäjä |
[sähköpostiosoite] |
Lähettäjän osoite, jota ESM käyttää vastausviestin Lähettäjä - kentässä. Jos tätä ei ole asetettu, käytetään sähköpostin vastaanottajan osoitetta. |
attribuutti.koodi.runko |
[attribuuttikoodi] |
Sen attribuutin koodi, joka saa arvon sähköpostiviestin tekstikentästä . |
attribuutti.koodi.lähteestä |
[attribuuttikoodi] |
Sähköpostiviestin Lähettäjä-kentästä arvon saavan attribuutin koodi . Arvo voi olla pilkulla erotettu luettelo, jos arvo on useita. |
attribuutti.koodi.aihe |
[attribuuttikoodi] |
Sen määritteen ominaisuuskoodi, joka saa arvon sähköpostiviestin Aihe- kentästä . |
attribuutti.koodi.vastaanottaja |
[attribuuttikoodi] |
Sen attribuutin koodi, joka saa arvon sähköpostiviestin Vastaanottaja- ja Kopio- kentistä. |
attribuutti.koodi.kohteeseen |
[attribuuttikoodi] |
Sen määritteen määritekoodi, joka saa arvon sähköpostiviestin Vastaanottaja - kentästä. |
attribuutti.koodi.cc |
[attribuuttikoodi] |
Sen määritteen ominaisuuskoodi, joka saa arvon sähköpostiviestin kopio- kentästä. |
attribuutti.koodi.aikaleima |
[attribuuttikoodi] |
Sen attribuutin koodi, joka saa sähköpostiviestin vastaanottoaikaa vastaavan arvon. |
ryhmä.kartta.attribuutti.koodi |
[attribuuttikoodi] |
Käytetään lähettäjäperusteiseen päätökseen kansiosta, johon sähköpostista luodut datakortit luodaan. Tässä annat sähköpostin lähettäjää kuvaavan mallin attribuutin koodin – esim. Asiakas -mallin. Sinulla on myös oltava viittauskenttä attribute.code.from - arvona. Kansioissa, joiden välillä valinta tehdään, on oltava mapToGroupAttributeValue -metatiedot määriteltynä ja arvo, joka vastaa attribuuttikentän arvoja. |
attribuutti.koodi.sähköpostin.seuranta |
[attribuuttikoodi] |
Sen määritteen määritekoodi, jonka arvo toimii sähköpostin seurannan tunnuksena. |
attribuutti.koodi.viesti.as.linkki |
[attribuuttikoodi] |
Sähköpostiviestien linkittämiseen käytetyn attribuutin koodi. Tämä attribuutti vaatii EntityStateMail- käsittelijän viestien käsittelyyn ja ulkoisen viitetietotyypin . |
attribuutti.koodi.liite.as.linkki |
[attribuuttikoodi] |
Koodi attribuutille, johon mahdolliset sähköpostin liitteet linkitetään. Attribuutin tietotyypin on oltava ulkoinen viite . |
mail.store.host |
[palvelimen_IP tai verkon_nimi] |
Sen sähköpostipalvelimen isäntänimi, jolta sähköposti luetaan. Korvaa framework.properties- määrityksessä olevan arvon . |
mail.store.port |
[porttinumero] |
Sähköpostipalvelimen portti. Korvaa framework.properties- määrityksessä olevan arvon . |
mail.store.user |
[käyttäjänimi] |
Käyttäjä, jota käytetään sähköpostipalvelinyhteyden todentamiseen. Korvaa framework.properties- arvossa olevan arvon . |
sähköpostikauppa.salasana |
[salasana] |
Salasana, jota käytetään sähköpostipalvelinyhteyden todentamiseen. Korvaa framework.properties- tiedostossa olevan arvon . |
mail.transport.host |
[isäntänimi] |
Sähköpostin välityspalvelimen isäntänimi. Korvaa framework.properties- määrityksessä olevan arvon . |
postin.kuljetus.portti |
[porttinumero] |
Sähköpostin välityspalvelimen porttinumero. Korvaa framework.properties- määrityksessä olevan arvon . |
mail.transport.user |
[käyttäjänimi] |
Käyttäjä, jota käytetään sähköpostin välityspalvelinyhteyden todentamiseen. Korvaa framework.properties- arvossa olevan arvon . |
mail.transport.password |
[salasana] |
Salasana, jota käytetään sähköpostin välityspalvelinyhteyden todentamiseen. Korvaa framework.properties- tiedostossa olevan arvon . |
sähköpostin.kansion.nimi |
[kansion_nimi] |
Postilaatikon kansion nimi, josta sähköposti luetaan. Korvaa framework.properties- arvossa olevan arvon . |
mikä tahansa attribuuttikoodi |
[attribuuttikoodi] |
Tähän voidaan antaa mikä tahansa kiinteä attribuuttikentän arvo, joka sitten sijoitetaan sähköpostista luotuun tietokorttiin. |
päivitys:attribuuttikoodi:nykyinen arvo |
Uusi arvo |
Konfiguroimalla ominaisuuden, jonka nimi on muotoa "update:YYY:ZZZ" ja YYY vastaa attribuutin koodia ja ZZZ vastaa attribuutin nykyistä arvoa, attribuutin arvo korvataan ominaisuuden arvolla. Esimerkiksi ominaisuusavain voi olla "update:status:On hold" ja arvo voi olla "In distribution". Tämä tarkoittaa, että kun uusi sähköposti liitetään datakorttiin, jonka nykyinen tila on "On hold", se päivittyy tilaan "In distribution". Jos ominaisuusavain päättyy merkkiin $EMPTY$, arvo asetetaan, jos nykyinen arvo on tyhjä. Jos ominaisuusavain päättyy merkkiin $ALWAYS$, arvo päivittyy aina. Vain seuraavia tietotyyppejä tuetaan: merkkijono, staattinen merkkijono ja teksti. Arvo asetetaan ennen käsittelijöiden tai kuuntelijoiden käynnistymistä. |
autoUpdateMapping:tunniste |
[attribuuttikoodi] |
Määrittämällä tämän ominaisuuden arvot erityisesti muotoillusta sähköpostista voidaan asettaa attribuutin arvoksi. Esimerkiksi "autoUpdateMapping:issue" arvolla "description": ESM:ssä koodilla 'description' varustettu attribuutti päivitetään sähköpostin arvon perusteella. Sähköpostista haetaan tunnistetta '[issue]:'. Kaikki samalla rivillä tagin jälkeen tuleva arvo katsotaan arvoksi. Jos sähköpostissa on useita rivejä sama tagi (esim. [ongelma]:), vain viimeisintä arvoa käytetään. Datakortilla oleva arvo korvataan aina. Huom. Tagin tarkka muoto riippuu määrityksistä. Huom. Tuetut tietotyypit ovat: merkkijono, teksti, päivämäärä, päivämäärä ja aika, viite, takaviittaus, ulkoinen viite, numero ja desimaaliluku. Tällä asetuksella voi olla useita määrityksiä eri tageille. |
static.autoUpdateMapping:tag.value |
[attribuuttikoodi].[staattinen arvo] |
Tätä asetusta voidaan käyttää, kun useita ulkoisen järjestelmän eri arvoja on yhdistettävä yhdeksi staattiseksi arvoksi ESM:ssä. Esimerkiksi "static.autoUpdateMapping:newStatus.:new,untouched" arvolla "status.New": ESM:ssä oleva staattinen attribuutti, jonka koodi on 'status', päivittyy arvoon 'New', jos sähköpostin tagin arvo on 'new' tai 'untouched'. Sähköpostista haetaan tagia '[newStatus]:'. Huom. Tagin tarkka muoto riippuu määrityksistä. Hierarkkisten staattisten arvojen kanssa käytetään käytäntöä 'pääarvo/Aliarvo' |
automaattinen päivityskäynnistystunniste |
tagin aloitusmerkkijono |
Sähköpostin erikoisarvojen merkitsemiseen käytettävän aloitustunnisteen muoto. Esimerkiksi '$NAME$'. Merkkijonoa 'NAME' käytetään paikkamerkkinä tagien nimille. Oletusarvo on '[NAME]:'. Jos autoUpdateEndTag-asetusta ei ole määritelty, kaikkea samalla rivillä olevaa aloitustunnistetta seuraavaa tunnistetta pidetään arvona. Tämä asetus on yksiarvoinen. HUOMAUTUS! Tunnisteita haetaan vain sähköpostin rungosta. Sähköpostin aihetta ei sisällytetä. |
automaattinen päivityslopputunniste |
tagin aloitusmerkkijono |
Sähköpostissa erikoisarvojen merkitsemiseen käytettävän lopputunnisteen muoto. Esimerkiksi '$/NAME$'. Merkkijonoa 'NAME' käytetään paikkamerkkinä tagien nimille. Ei oletusarvoa. Jos tämä asetus on määritetty, kaikkea aloitustagin ja vastaavan lopetustagin välillä pidetään arvona. Tämä asetus on yksiarvoinen. HUOMAUTUS! Tunnisteita haetaan vain sähköpostin rungosta. Sähköpostin aihetta ei sisällytetä. |
AutoUpdateMapping-esimerkkejä
Tässä osiossa on muutamia esimerkkejä automaattisen päivityksen asetuksista.
Esimerkki 1: Tässä esimerkissä on ensin konfiguraatio, sitten tuotu sähköposti ja alhaalla on kuvakaappaus luodusta datakortista:
Esimerkki 2:
Esimerkki 3:
Esimerkki4:
Esimerkki 5:
RaporttiVieTehtävä
ReportExportTask-funktiolla voidaan viedä valittu raportti tiedostoon halutussa muodossa. Ohjelma tukee sekä yksityiskohtaisia raportteja taulukkomuodossa että graafisia raportteja.
Huomautus:
ReportExportTask tukee nyt vain Efecte ITSM release 6 -muodossa olevia raportteja. Nykyisessä Workspace-käyttöliittymässä luotuja ja tallennettuja näkymiä ei vielä tueta.
Taulukkomuotoisten yksityiskohtaisten raporttien tulostustiedostomuoto voidaan määrittää XSLT-tiedostolla. Oletusarvoisesti CSV- ja HTML-viennit ovat sisäänrakennettuja, mutta useita muitakin tiedostomuotoja on mahdollista käyttää. Muita yksityiskohtaisten raporttien tiloja (minimaalinen, viittaava, täysi) ei tueta.
Graafiset raportit tuottavat tiedoston, joka sisältää PNG-kuvan.
Huomautus:
Paikallisissa asennuksissa varmista, että Tomcat-prosessia suorittavalla käyttäjätilillä on kirjoitusoikeudet target.file.name-tiedostossa määritettyyn kansioon.
Pakolliset ReportExportTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
raportti.id |
[raportin tunnus] |
Tämän tehtävän muuntaman ja viemän raportin tunnus. (Tunnus on linkin URL-osoitteen bookmarkID-parametri.) Useita raportteja varten sinun on määritettävä useita tehtäviä. |
kohde.tiedosto.hakemisto |
[teksti] |
Polku muunnetun tiedoston kohdehakemistoon. Paikallisissa asennuksissa varmista, että Tomcat-prosessia suorittavalla käyttäjätilillä on kirjoitusoikeudet target.file.name-tiedostossa määritettyyn kansioon. |
kohde.tiedosto.nimi |
[teksti] |
Kohdetiedoston nimi. Saattaa sisältää $now$-päivämäärämakron, joka korvataan nykyisellä päivämäärällä. Päivämäärän muoto on vvvv-kk-pp. Jos kohdesijainnissa on jo samanniminen tiedosto, se korvataan. |
Valinnaiset ReportExportTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
kohde.tiedosto.koodaus |
[teksti] |
Kohdetiedoston koodaus. Oletusarvo on UTF-8. |
muunnos.tiedosto |
[teksti, tiedostonimi] |
XSLT-tiedosto, jota käytetään raportin tuloksena olevan XML-tiedoston muuntamiseen lopulliseen muotoon. Vie tiedosto CSV-muodossa kirjoittamalla CSV tähän kenttään. Vie tiedosto HTML-taulukkomuodossa kirjoittamalla HTML tähän kenttään Jos haluat viedä tiedoston jossakin muussa XSLT-tiedostossa määritetyssä muodossa, anna XSLT-tiedoston polku. Jos jätät tämän tyhjäksi, tuloksena oleva XML viedään sellaisenaan. |
xslt.[parametri] |
[xslt-parametrin arvo] |
Kaikki xslt.- etuliitteellä varustetut parametrit välitetään XSLT-muunnokseen ilman etuliitettä (esim. xslt.some.parameter- parametri välitetään XSLT-muunnokseen nimellä some.parameter ). Lisätietoja on alla olevassa Tekniset tiedot -osiossa. |
css.tiedosto |
[teksti, tiedostonimi] |
CSS-tiedosto, joka liitetään tekstiraportteihin. Tuettu sisäänrakennettu arvo on OLETUS. Jos tämä jätetään tyhjäksi, tiedostoa ei lisätä. Arvo on kohtuullinen käytettäessä transform.file = HTML . |
otsikko.sisältää |
[tosi/epätosi/nimi] |
Jos arvoksi asetetaan 'true', tulokseen XML sisällytetään otsikkorivi. Otsikkorivi sisältää raportissa valittujen attribuuttien koodit. Jos arvoksi on asetettu 'name', otsikot ovat attribuuttien nimiä. Oletusarvo on 'false'. |
päivämäärä.muunna |
[tosi, taru] |
Jos arvoksi asetetaan true, kaikki päivämääräattribuutit muunnetaan PlatformSettings-asetusten date.output.pattern ja datetime.output.pattern mukaisesti . Jos arvoksi asetetaan false, arvo on sellainen kuin Java Virtual Machine palauttaa ne. Oletusarvo on epätosi. |
kuvan.leveys |
[määrä] |
Jos määritetty raportti tuottaa graafisen raportin, tämä määrittää kuvan leveyden pikseleinä. Oletusarvo on 640, maksimiarvo on 1920. |
kuvan.korkeus |
[määrä] |
Jos määritetty raportti tuottaa graafisen raportin, tämä määrittää kuvan leveyden pikseleinä. Oletusarvo on 640, maksimiarvo on 1080. |
Tekniset tiedot:
XSLT-muunnosta voidaan käyttää ESM-tuloksen XML-tiedoston viemiseen mihin tahansa tekstipohjaiseen tiedostomuotoon – esimerkiksi CSV-, Different XML- tai HTML-tiedostomuotoon. XSLT-muunnosta tuetaan XSLT 1.0:aa ja XPath 1.0:aa.
Normaalien ominaisuuksien lisäksi ReportExportTask-funktiota voidaan käyttää myös XSLT-muunnoksen parametrien määrittämiseen. Kun parametrit välitetään XSLT-muunnostiedostoon, xslt.-etuliite poistetaan parametrien nimistä (esim. xslt.joku.parametri muuttuu muotoon joku.parametri XSLT-muunnoksessa). Tuetut parametrit riippuvat täysin käytetystä XSLT:stä.
Moniarvoisten viittausten tiedot ryhmitellään yhteen XML-moniarvoelementtiin tai yhteen sarakkeeseen CSV-tiedostossa. Alkuperäistä viittausta ei voida tunnistaa.
ESM:n toteuttama CSV-muunnos tukee seuraavia parametreja:
CSV-muunnospaperit | ||
Nimi |
Arvo |
Kuvaus |
xslt.csv.erotin.arvo |
[mikä tahansa merkki] |
Sarakkeiden erotinmerkki. Oletusarvo on ' , '. |
xslt.csv.erotin.moniarvo |
[mikä tahansa merkki] |
Moniarvojen erotinmerkki. Oletusarvo on ' | '. |
xslt.csv.quote.values |
[tosi/väärin] |
Määrittää, laitetaanko kaikki arvot lainausmerkkeihin. Oletusarvo on ' true '. |
VINKKI! CSV-tiedostojen muoto on kuvattu yksityiskohtaisesti RFC 4180:ssa, http://www.rfc-editor.org/rfc/rfc4180.txt
Huomautus:
XSLT-muunnoksen parametrit voidaan antaa myös ESM-alustan asetuksissa, jolloin ne vaikuttavat kaikkiin ReportExportTask-tehtäviin. ReportExportTask-tehtävässä annetut parametrit kuitenkin ohittavat alustan asetusparametrit. XSLT-muunnosparametrien muoto alustan asetuksissa on report.export.xslt.[parametri].
Jos esimerkiksi haluat määrittää CSV-transformaation globaalin erotinarvon, lisää alusta-asetus nimeltä result.export.xslt.csv.separator.value .
ReportExportTask-tehtävässä käytetyn hakutuloksen XML-rakenteen kaavio:
Raporttisähköpostitehtävä
ReportMailTask-komennolla voidaan luoda sähköposti, joka sisältää useita vanhalla Efecte Report Wizardilla (ei enää suositella) luotuja raportteja. Sähköpostipalvelimen asetukset määritellään alustan asetuksissa. Lähettäjä, vastaanottaja(t), aihe ja sähköpostin sisältö määritetään tehtävän ominaisuuksissa.
- ReportMailTask tukee vain Efecte ITSM 6 -muodossa olevia raportteja.
- Yksityiskohtaisia raportteja taulukkomuodossa sekä graafisia raportteja tuetaan.
- Taulukkomuotoisten yksityiskohtaisten raporttien tulostustiedostomuoto voidaan määrittää XSLT-tiedostolla. Oletusarvoisesti CSV- ja HTML-viennit ovat sisäänrakennettuja, mutta useita muitakin tiedostomuotoja on mahdollista käyttää. Muita yksityiskohtaisten raporttien tiloja (minimaalinen, viittaava, täysi) ei tueta.
- Graafiset raportit tuottavat PNG-kuvia.
- Ryhmittelyperuste-raportteja ei tueta.
- Seuraavia ominaisuuksia ei voi määrittää ReportMailTask-tehtävälle: report.id, target.file.dir, target.file.name
Määritys on hyvin samanlainen kuin ReportExportTask. Seuraavissa taulukoissa on vain lisäasetuksia.
Pakolliset ReportMailTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
sähköposti.lähettäjä |
[sähköpostiosoite] |
Kelvollinen sähköpostiosoite. |
postin.vastaanottaja |
[sähköpostiosoite[t]] |
Vastaanottajan sähköpostiosoite on voimassa. Voidaan erottaa pilkulla tai puolipisteellä. Kopio- tai Piilokopio-kenttien vastaanottajia ei tueta. |
sähköpostin.aihe |
[teksti] |
Sähköpostin aihe. |
Valinnaiset ReportMailTask-ominaisuudet | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
sähköposti.viesti[.JÄRJESTYKSELLINEN] |
[teksti] |
Valinnainen viesti ennen raportteja. Voi sisältää html-tageja, kuten <br/> rivinvaihtoja varten. Yksi rivi voi sisältää 450 merkkiä. Useille riveille voidaan määrittää yksilöllinen järjestysnumero. |
sähköpostiraportti.[Järjestysnumero].[ID] |
[teksti] |
Samanlainen kuin ReportExportTask report.id . Kyseisellä tunnuksella varustettu raportti lähetetään sähköpostin mukana. (Id on linkin URL-osoitteen kirjanmerkki-parametri.) Useita raportteja varten yhdessä sähköpostiviestissä voit määrittää useita arvoja yksilöllisillä järjestysnumeroilla. Ominaisuuden arvo riippuu mail.attachment.disposition -ominaisuuden arvosta . Jos se on rivillä , ominaisuuden arvo on lyhyt kuvaus, joka näytetään sähköpostissa ennen raporttia. Jos mail.attachment.disposition -ominaisuuden arvo on attachment , tämä ominaisuus tarkoittaa luodun liitteen tiedostonimeä. Huomioi tiedostopääte. Sen on vastattava asetuksia mail.attachment.text.content.type ja transform.file . Jotkut sähköpostiohjelmat käyttävät tiedostopäätettä valitakseen esikatselun tai apuohjelman liitteiden avaamiseksi. Jotkut sähköpostiohjelmat käyttävät liitteen sisältötyyppiä. |
sähköpostin.liitteen.käsittely |
[liite, tekstissä] |
Pro määrittää, miten raportit lisätään sähköpostiin. Mahdollisia arvoja ovat attachment (raportit ovat liitteinä) ja inline (raportit ovat osa sähköpostin runkoa). Oletusarvo on tekstissä |
sähköpostin.liite.teksti.sisältö.tyyppi |
[teksti] |
Jos mail.attachment.disposition -ominaisuuden arvoksi on asetettu attachment , tämä asetus määrittää tekstiraporttien sisältötyypin. Tämän on oltava sama kuin transform.file -asetus . Jotkin sähköpostiohjelmat käyttävät tätä ominaisuutta valitakseen esikatselun tai apuohjelman liitteen avaamiseen. Jotkin sähköpostiohjelmat käyttävät vain tiedostopäätettä. Esimerkkiarvot: text/plain , text/html (oletus). |
Huomautus:
ReportExportTaskin ja ReportMailTaskin yhteisiä ominaisuuksia ovat: target.file.encoding, transform.file, css.file, header.include, date.convert, image.width ja image.height. Katso yksityiskohtainen kuvaus ReportExportTaskin kohdasta.
DataCardsArchiverTehtävä
DataCardsArchiverTask on tarkoitettu datakorttien vientiin tiedostojärjestelmään tai suoraan ulkoiseen järjestelmään https-pyyntömetodin avulla. Molemmat menetelmät (tiedosto ja https-pyyntö) käyttävät Efecte ESM:n standardin mukaista XML-muotoa, joka saattaa vaatia muuntamista kohdejärjestelmän tietomallimuotoon.
Vain Efecte-järjestelmänvalvojat voivat tallentaa luettelonäkymiä työtilan arkisto-osioon. Arkisto-osioon tallennetut luetteloraportit voidaan arkistoida käyttämällä DataCardsArchiverTask-ajoitettua tehtävää.
Huomautus:
Tämä tehtävä on suunniteltu siten, että se sisältää vain nykyisen mallin tiedot, ei viittausten kautta tulevia tietoja.
Vain ylläpitäjät voivat tallentaa, tarkastella tai edes nähdä arkistovälilehden näkymissään.
Arkistointitehtävä ei arkistoi arkistoituihin datakortteihin linkitettyjä tiedostoliitteitä tai sähköposteja. Vaikka datakortit poistettaisiin, poistettujen datakorttien tiedostot (sähköpostit ja tiedostoliitteet) jäävät tiedostojärjestelmään, ellei niitä poisteta toisella ajoitetulla tehtävällä: CleanRemovedFilesTask. Huomaa myös, että tiedostojen arkistointi tai https-pyyntömenetelmä eivät lähetä tiedostoliitteitä tai sähköposteja määritettyyn kansiorakenteeseen tai kolmannen osapuolen järjestelmään.
Pakolliset DataCardsArchiverTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Arkiston tyyppi |
[tiedosto, http-pyyntö] |
Vienti tiedostojärjestelmään (arvo: tiedosto) vai lähetys https:n kautta ulkoiseen järjestelmään (arvo: https-pyyntö). |
Poista datakortit |
[Tosi | Epätosi] |
Poistetaanko datakortit tiedostoon viennin jälkeen vai jätetäänkö ne siihen. Oletusarvoisesti datakortteja ei poisteta. |
Arkistoraportti |
[raporttien pudotusvalikko Arkisto-osiossa] |
Arkistoi raportti, jonka datakortit haluat arkistoida. Tämä raportti on tallennettava työtilan Arkisto-osioon. |
Vie kaikki datakorttien määritteet |
[Tosi | Epätosi] |
Jos arvoksi on asetettu 'Tosi', kaikki vietyjen datakorttien ominaisuudet lähetetään arkistointikohteeseen, vaikka luettelonäkymässä olisi valittuna yksi sarake. |
Jos arkiston tyyppi on 'tiedosto', seuraavat DataCardsArchiverTask-ominaisuudet ovat pakollisia. | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
Tiedoston sijainti |
[sijainti palvelimella, johon ESM:llä on pääsy] |
Location , johon viedyt datakortit viedään XML-tiedostoina, kun 'Archive'-ominaisuudeksi on asetettu 'file'. ESM:llä tulee myös olla oikeudet tallentaa tiedostoja haluttuun sijaintiin. Määrittele tässä “/polku/kansioon” |
Jos arkistointityyppi on 'https-pyyntö', seuraavat DataCardsArchiverTask-ominaisuudet ovat pakollisia. | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
Ulkoinen järjestelmäosoite |
[ulkoisen järjestelmän URL-osoite] |
Esim. osoite toiseen ESM:ään. ESM:n tapauksessa tarkista parametrit aina nimetyltä konsultilta. Osoitteen on alettava 'https://' |
Ulkoisen järjestelmän käyttäjänimi |
[käyttäjätunnus] |
Ulkoisen järjestelmän peruskäyttöoikeustunnus. |
Ulkoisen järjestelmän käyttäjän salasana |
[salasana] |
Ulkoisen järjestelmän peruskäyttäjän salasana |
Ulkoisen järjestelmän liitäntäparametrit |
[ulkoisen järjestelmän liitäntäparametrit] |
Yhteysparametrit. Aikakatkaisuyksikkö on sekunti. Esimerkkejä on alla. |
Ulkoisen järjestelmän odotettu vastaus |
[200=.*, 201=.*] |
Ulkoisesta järjestelmästä odotetut vastauskoodit pilkulla erotettuna (oletusarvo: "200=.*, 201=.*"). |
Ulkoisen järjestelmän eräkoko |
[erän koko] |
Yksittäisissä pyynnöissä lähetettävien datakorttien enimmäismäärä (oletus: 10000). |
Esimerkki yhteyden muodostamisesta toiseen ESM:ään
- Ulkoisen järjestelmän osoite, esim. https://environment.efectecloud.com/api/itsm/dataCardImport.ws?folderCode=alerts&createDataCards=true&updateDataCards=true&createEmptyReferences=true
- Ulkoisen järjestelmän liitäntäparametrit, esim.
- acceptSelfSignedCertificates=true, connectionRequestTimeout=60, connectTimeout=60, socketTimeout=60
Arkiston tyyppi: tiedosto
Kun tiedostoa käytetään arkistointityypissä, luotu ESM-entiteetin XML-tiedosto tallennetaan palvelimen tiedostojärjestelmään. Pro Tiedoston sijainnin on osoitettava olemassa olevaan hakemistoon, johon ESM-oikeuksilla on oikeus kirjoittaa tietoja. Tiedostonimi luodaan muodossa [tehtävätunnus]_[aikaleima]_[raportin_nimi].xml. Tiedostoja ei poisteta.
Arkiston tyyppi: https-pyyntö
Kun käytetään https-pyyntöä, luotu ESM-entiteetin XML-tiedosto lähetetään kolmannen osapuolen järjestelmään https-pyyntönä. Tarkista taulukosta (Taulukko: Vaaditut DataCardArchiverTask-ominaisuudet, kun arkistointityyppi on 'https-pyyntö') pakolliset ominaisuudet, kun käytetään https-pyynnön arkistointityyppiä.
Https-pyyntömetodi käyttää MessageQueue-metodia. Kun DataCardArchiverTask on suoritettu, XML lähetetään kolmannen osapuolen järjestelmään välittömästi. Jos https-pyynnön lähetys epäonnistuu, esimerkiksi jos kolmannen osapuolen järjestelmä ei vastaa, pyyntö tallennetaan viestijonoon ja suoritetaan uudelleen, kun MessageQueueTask on suoritettu seuraavan kerran. Jotta https-pyyntö toimisi oikein, Efecte-ylläpitäjän on konfiguroitava MessageQueueTask.
Tiedostot poistetaan, kun vienti on suoritettu onnistuneesti.
Ulkoisen järjestelmän odotettu vastaus
Ulkoisen järjestelmän odotettu vastaus -ominaisuus määrittää ulkoisen järjestelmän odotettujen vastauskoodien ja viestien yhdistelmän.
Odotettu vastauskoodi: Koodi osoittaa ulkoisen järjestelmän vastaaman koodin riippumatta siitä, hyväksytäänkö vai hylätäänkö pyyntö. Esim. 200, 404.
Odotettu vastausviesti: ESM tarkistaa vastausviestin vastaanotetuista vastauksista. Viestin sisällön tarkistus hoidetaan säännöllisillä lausekkeilla.
Käytetty muoto on:
code1=message1,code2=message2 (using comma as delimiter)
Esimerkki 1: 200=,404=Ei mitään arkistoitavaa
Sekä koodi 200 että 404 hyväksytään vastauskoodiksi. Koodin 200 tapauksessa vastausviestin tulee olla tyhjä tai null. Koodin 404 tapauksessa vastausviestiin tulee sisällyttää teksti "Ei mitään arkistoitavaa".
Esimerkki 2: 200=.+
Vastauskoodiksi hyväksytään vain 200. Mikä tahansa vastausviestin sisältö hyväksytään.
Metsätalous
DataCardsArchiverTask kirjaa aktiviteettinsa info- ja debug-tasolla itsm.log-tiedostoon. Saat tarkempia tietoja tehtävän ja ulkoisen järjestelmän välisestä kommunikaatiosta asettamalla lokitason debug-asetuksen myös com.efecte.queue-paketille.
PuhdistaPoistetutTiedotTehtävä
CleanRemovedFilesTask on tarkoitettu viittaamattomien/orpojen tiedostojen, kuten sähköpostien ja liitteiden, puhdistamiseen tiedostojärjestelmästä. Jos tätä tehtävää ei suoriteta, kyseiset resurssit jäävät tiedostojärjestelmään ja käyttävät levytilaa, vaikka resursseihin viittaava datakortti poistettaisiin.
Tämä ajoitettava tehtävä on oletusarvoisesti käytössä ja suoritetaan päivittäin. Efecte-järjestelmänvalvoja voi joko ajoittaa tehtävien ajoituksen uudelleen tai poistaa sen käytöstä Ajoitetut tehtävät -kohdasta.
Huomaa: Tämä toiminto ei poista orpoja tiedostoja, jotka ovat olleet järjestelmässä ennen ESM-versioon 2018.3.2 päivitystä.
Ajoitettujen tehtävien muokkaaminen ja poistaminen
Voit tarkastella ja muokata kaikkia luotuja tehtäviä Muokkaa ajoitettavia tehtäviä -näkymässä. Siirry näkymään avaamalla Yleiset-välilehti Ylläpito-näkymässä ja napsauttamalla Ajoitettavat tehtävät. Napsauta näkymässä sen tehtävän nimeä, jota haluat muokata.
Työalueelle avautuu Muokkaa ajoitettavia tehtäviä -näkymä, joka sisältää Ajoitettavat tehtävät -editorin ja Tehtävän ominaisuudet -näkymän. Tee muutokset olemassa oleviin tietoihin ja tallenna muokattu ajoitettu tehtävä napsauttamalla Tallenna.
Voit poistaa käyttämättömiä tehtäviä Muokkaa ajoitettavia tehtäviä -näkymässä. Valitse Poista-valintaruudut poistettavien tehtävien vierestä ja napsauta Poista-painiketta toiminnon loppuun saattamiseksi.
Pro
Pro hallintatehtävät ovat automatisoituja, ajoitettavia tehtäviä, joiden tarkoituksena on tuoda käyttäjän identiteettitiedot Efecte Service Management Tooliin käyttämällä joko Lightweight Directory Access Pro (LDAP) -rajapintaa Active Directory , OpenLDAP :n, IBM LDAP , FreeIPA:n tai Microsoft Graph API n (Microsoft Azure AD tai Efecte Provisioning Engine (EPE) käyttöä IGA ratkaisussamme. Tämä nopeuttaa käyttäjien käyttöoikeuksien hallintaa (jota kutsutaan myös toteutukseksi identiteetin ja hallinnon hallinnan alueella). EPE toimii aidosti rinnakkaisena käsittelymenetelmänä, joka sallii useita ajoitettuja ja tapahtumapohjaisia käyttöoikeusmuutoksia.
Huomautus! ESM 2023.3:sta lähtien valmistelutehtävät sijaitsevat IGA välilehdellä – eivät enää Ajoitettavat tehtävät -välilehdellä.
Tuodut kokoonpanot tallennetaan EPE-Master-tietokantaan ( Efecte Provisioning Engine - Master), eivät Efecte Service Management (ESM) -tietokantaan. Identiteettiattribuuttien ja käyttöoikeuksien yhdistämismääritykset tallennetaan ESM:ään, ja niihin vaikuttavat ESM:ssä muuttuvat mallit ja kansiot. 
Efecte Service Management -työkalun ja Efecte Provisioning Engine yhdistämiseksi on tarpeen määrittää useita asetuksia alustan asetuksissa hallintakäyttöliittymässä.
Oletusarvoisesti ominaisuudet, jotka tarvitaan Efecte Provisioning Engine yhdistämiseen, noudetaan consulilta. Siksi sinun on asetettava consul.enabled-ominaisuuden arvoksi true. Tämän jälkeen voit varmistaa, että myös ”provisioning.configuration.consul” on käytössä.
Kun Consul on käytössä, kaikki tarvittavat määritykset on määritelty Efecte Provisioning Engine :
Active Directory Pro määritys
Efecte Provisioning Engine käyttää Lightweight Directory Access Pro (LDAP) -rajapintaa Active Directory ja OpenLDAP , IBM LDAP ja Redhat LDAP:n (FreeIPA) kanssa. Pro nimetään kyseessä olevan hakemiston mukaan. Muuten tarvittavat määritykset ovat samat.
Pro valmistelutehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Pro |
[Ajoitettuun provisiointiin perustuva, tapahtumapohjainen provisiointiin perustuva, todennus] |
Pro voidaan luokitella tarpeen mukaan. Valmistelutehtävän muut ominaisuudet näytetään valitun tyypin mukaan. |
Yhdistämistyyppi |
[Identiteetti ja käyttöoikeudet] |
Lisää osiot molemmille yhdistämismäärityksille. |
Nimi |
[Teksti] |
Valmistelutehtävän nimi. |
Web- API käyttäjä |
[Web API -käyttäjän valinta] |
EPE:n ja ESM:n väliseen viestintään käytettävä web API käyttäjä |
API salasana |
[Teksti] |
Web API -käyttäjän salasana. Pakollinen kenttä täytettäväksi, jotta käyttöönotto toimii. |
Vaaditut Pro ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
LDAP- uniqueIdentifier |
[Teksti] |
Jokaisella tuontiprosessilla on yksilöllinen prosessitunnus LDAP uniqueIdentifier Id , jota käytetään avaimena valmistelumoottorin päätasolla erottamaan prosessikohtainen muista valmistelumoottorin päätasolla olevista tuontiprosesseista. Tunnistetta tarvitaan, jotta myöhemmät muutokset tai poistot kohdistetaan oikeaan kohteeseen. |
LDAP-isäntä |
[IP-osoite tai isäntänimi] |
Kohdehakemiston IP-osoite tai isäntänimi. |
LDAP-portti |
[Satama] |
Kohdehakemiston portti määrittää, mihin Active Directory -porttiin Pro Engine muodostaa yhteyden. |
LDAP-käyttäjätunnus |
[Käyttäjänimi]@[Verkkotunnus] |
LDAP-yhteyden muodostamiseen käytetty käyttäjätunnus. LDAP-yhteydessä käyttäjätunnus on tyypillisesti käyttäjän käyttäjätunnus tai tunnistenimi. |
LDAP-salasana |
[Teksti] |
LDAP-yhteyden salasana. Salasana annetaan selkokielisenä tekstinä. |
LDAP-todennusmenetelmä |
[yksinkertainen, vahva, ei mitään] |
LDAP-yhteydessä käytetty todennustyyppi. Seuraavia todennustyyppejä tuetaan: – yksinkertainen – vahva – ei yhtään |
LDAP- Pro |
[yksinkertainen, ssl] |
LDAP-yhteydessä käytetty suojausprotokolla. Seuraavia suojausprotokollia tuetaan: – ssl : Pro muodostaa LDAP-yhteyden Active Directory – yksinkertainen : Pro muodostaa LDAP-yhteyden Active Directory Huomautus! SSL-salauksen on oltava käytössä, jotta salasanoja voidaan määrittää ja käyttäjätunnusten voimassaoloa voidaan muuttaa AD :ssä. |
LDAP-käyttäjäkanta |
[Teksti] |
Määritä käyttäjien perusjoukko. Esimerkki: CN=Käyttäjät,DC=adtest,DC=local Huomautus! Kun provisiointitehtävän konfiguraatioksi on asetettu ”Lue OU-polku datakortilta”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP-ryhmä-/käyttäjäkanta), jossa voit määrittää attribuutin, josta tämä tieto voidaan lukea. |
LDAP-käyttäjäsuodatin |
[Teksti] |
Määritä käyttäjille suodatin. Esimerkki: (objectClass=user) Huomautus! Kun provisiointitehtävän konfiguraatioksi on asetettu ”Lue OU-polku datakortilta”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP-ryhmä-/käyttäjäkanta), jossa voit määrittää attribuutin, josta tämä tieto voidaan lukea. |
LDAP-ryhmäpohja |
[Teksti] |
Määritä ryhmien pohja. Esimerkki: CN=Group,DC=adtest,DC=local Huomautus! Kun provisiointitehtävän konfiguraatioksi on asetettu ”Lue OU-polku datakortilta”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP-ryhmä-/käyttäjäkanta), jossa voit määrittää attribuutin, josta tämä tieto voidaan lukea. |
LDAP-ryhmäsuodatin |
[Teksti] |
Määritä ryhmille suodatin. Esimerkki: (objectClass=group) Huomautus! Kun provisiointitehtävän konfiguraatioksi on asetettu ”Lue OU-polku datakortilta”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP-ryhmä-/käyttäjäkanta), jossa voit määrittää attribuutin, josta tämä tieto voidaan lukea. |
Valinnaiset Pro ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
LDAP ohitti käyttäjät |
[Teksti] |
Määritä <OU>-elementit, jotka tulisi ohittaa käyttäjiä haettaessa. Käyttäjä ohitetaan, jos se on suoraan jossakin määritellyistä <OU>-elementeistä ja myös jos se on jonkin määritellyn <OU>-elementin alipuussa. Esimerkki: OU=Sales,DC=adtest,DC=local |
LDAP ohittiOusForGroupsin |
[Teksti] |
Määritä <OU>-elementit, jotka tulisi ohittaa ryhmiä haettaessa. Ryhmä ohitetaan, jos se on suoraan jossakin määritellyistä <OU>-elementeistä ja myös, jos se on jonkin määritellyn <OU>-elementin alipuussa. Esimerkki: OU=Talous,DC=adtest,DC=paikallinen |
Käyttäjän asetukset | ||
Nimi |
Arvo |
Kuvaus |
Salasana ensimmäiselle kirjautumiselle |
[Teksti] / [työnkulku / mallipohja] |
Tämä vaihtoehto on näkyvissä, kun Pro on määritetty ”Tapahtumapohjainen valmistelu”. Tätä salasanaa käytetään, kun ”Uuden käyttäjän luonti” -toiminto otetaan käyttöön. Järjestelmänvalvojat voivat valita, haluavatko he määrittää oletussalasanan, jota käytetään ensimmäiseksi kirjautumissalasanaksi uusille käyttäjille, jotka luodaan valittuun käyttäjätietovarastoon. Toinen vaihtoehto on luoda satunnainen salasana työnkulussa/mallissa. |
Identiteettiominaisuuksien kartoitus
Valmistelutehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttäjän tunnistetiedot kultakin Active Directory . Nämä tiedot on yhdistettävä Efecte Service Management Toolin tietorakenteisiin. 
Yllä olevassa kuvassa näkyvät identiteettiattribuuttien yhdistämismääritykset kuvaavat, miten kohteet ja määritteet yhdistetään Efecte Service Management Toolin ja kohde- Active Directory välillä. Identiteettiattribuuttien yhdistämismääritykset määrittelevät Active Directory käyttäjäobjektin määritteet ja yhdistettävät käyttäjäattribuutit. Käyttöliittymän vasen sarake (kuva yllä) osoittaa kentät, jotka Pro poimii Active Directory . Käyttöliittymän oikea sarake osoittaa ESM:ssä olevan kansion/mallin/määritteen, jonka Active Directory poimittu kenttä lisää/päivitetään. Kun on tarpeen noutaa AD attribuutti, jolla on useampi kuin yksi arvo, kuten 'memberOf', se on yhdistettävä myös ESM:n mallineen moniarvoiseen määritteeseen.
Pakolliset ominaisuudet näytetään heti, kun näkymä avataan. Valinnaisia ominaisuuksia voidaan lisätä Lisää ominaisuus -painikkeella. Käytännössä jokainen ominaisuus koostuu nimi-arvo-parista, joka tarkentaa tai muuttaa tehtävän toimintaa. Joillakin ominaisuuksilla on käyttöliittymä, jonka avulla voit valita arvon alasvetovalikosta tai napsauttamalla valintanappia.
Ominaisuus poistetaan napsauttamalla ominaisuuden oikealla puolella olevaa poistokuvaketta (x). Manuaalisesti lisättyjen ominaisuuksien nimet ja arvot ovat kirjainkokoriippuvaisia ja niiden on oltava tarkkoja. Esimerkiksi asetusten nimet on merkittävä täsmälleen ohjetekstin mukaisesti.
Huomautus:
EPE-versiosta 2021.1 alkaen sallimme käyttäjien poissuljettujen DN-nimien luettelon määrittämisen tietoja ESM:ään vietäessä. Tämä parannus mahdollistaa tiettyjen käyttäjien poissulkemisen ESM-viennistä.
Käyttöoikeuksien yhdistäminen
Efecte Provisioning Engine käyttöoikeudet ilmaistaan tyypillisesti LDAP-ryhminä, AD :ssä tyypillisesti joko suojaus- tai jakeluryhmänä. Tämän seurauksena Efecte Service Management Tool saa käyttöoikeudet kultakin Active Directory provisiointitehtävästä. Nämä tiedot on yhdistettävä Efecte Service Management Toolin tietorakenteisiin. Käyttöoikeuksien yhdistäminen määrittää provisiointimoottorin tehtävätyypin erityisominaisuudet.
”Kohdemallin koodi” ja ”Kansiokoodi” -ominaisuudet näytetään heti, kun näkymä avataan. Myös ainakin distinguishedName-, objectGUID- ja datasourceid-kenttien yhdistämismääritykset ovat pakollisia, ja nämä kolme kenttää näytetään automaattisesti. Valinnaisia ominaisuuksia voidaan lisätä Lisää ominaisuus -painikkeella. Käytännössä jokainen ominaisuus koostuu nimi-arvo-parista, joka tarkentaa tai muuttaa tehtävän toimintaa. Joillakin ominaisuuksilla on käyttöliittymä, jonka avulla voit valita arvon pudotusvalikosta tai napsauttamalla valintanappia. Kun on tarpeen hakea AD attribuutti, jolla on useampi kuin yksi arvo, kuten 'memberOf', se on myös yhdistettävä ESM:n Template-mallin moniarvoiseen attribuuttiin.
EPE-versiosta 2021.1 alkaen sallimme ryhmien poissuljettujen tunnisteiden luettelon määrittämisen tietoja ESM:ään vietäessä. Tämä parannus mahdollistaa tiettyjen ryhmien poissulkemisen ESM-viennistä.
Efecte Provisioning Engine tukee useita eri LDAP-hakemistoja, jotka toimivat LDAP-käyttöliittymässä. Määritysnäkymässä ominaisuuksien nimillä on eri nimiä valitusta hakemistosta riippuen. Vaadittavat identiteetti- tai käyttöoikeusmääritykset voivat vaihdella valitusta hakemistosta riippuen.
Azure AD n Pro määritys
Azure AD n käyttöönottotehtävän määritysnäkymä:
Pro valmistelutehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Pro |
[Ajoitettuun provisiointiin perustuva, tapahtumapohjainen provisiointiin perustuva, todennus] |
Pro voidaan luokitella tarpeen mukaan. Valmistelutehtävän muut ominaisuudet näytetään valitun tyypin mukaan. Huomautus . Jotkin uuteen todennuskomponenttiin liittyvät määritykset saattavat näkyä joissakin osissa hallintakäyttöliittymää. Näillä muutoksilla ei ole vaikutusta olemassa oleviin asiakasympäristöihin. |
Yhdistämistyyppi |
[Identiteetti ja käyttöoikeudet] |
Lisää osiot molemmille yhdistämismäärityksille. |
Nimi |
[Teksti] |
Valmistelutehtävän nimi. |
Web- API käyttäjä |
[Web API -käyttäjän valinta] |
Web API käyttäjä, jota käytetään EPE:n ja ESM:n väliseen viestintään. |
API salasana |
[Teksti] |
Web API -käyttäjän salasana. Pakollinen kenttä täytettäväksi, jotta käyttöönotto toimii. |
Azure AD Pro -tehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Azure uniqueIdentifier -tunnus |
[Teksti] |
Jokaisella tuontiprosessilla on yksilöllinen prosessitunnus Azure uniqueIdentifier Id , jota käytetään avaimena valmistelumoottorin päätasolla erottamaan prosessikohtainen muista valmistelumoottorin päätasolla olevista tuontiprosesseista. Tunnistetta tarvitaan, jotta myöhemmät muutokset tai poistot kohdistetaan oikeaan kohteeseen. |
Sovelluksen (asiakkaan) tunnus |
[Merkkijono] |
Määrittää palvelun päänimen sovellustunnuksen. |
Hakemiston (vuokralaisen) tunnus |
[Merkkijono] |
Määrittää vuokralaisen tunnuksen. Käytä https://login.microsoftonline.com/<tenant-id> ja korvaa <tenant-id> sovelluksen rekisteröinnin hakemiston (vuokralaisen) tunnuksella . |
Kirjautumisosoite |
[Teksti] |
Määrittää App Service -sovelluksesi URL-osoitteen. |
Graafin API URL-osoite |
[Teksti] |
Määrittää Graph App Service -sovelluksesi URL-osoitteen. |
Azure AD -parametrit käyttäjille ja ryhmille | ||
Nimi |
Arvo |
Kuvaus |
Tuo käyttäjät -parametri |
[Teksti] |
Määritä käyttäjille suodatin. Esimerkki suodattimesta: $suodatin=alkaa(annettuNimi%2C) |
Tuo ryhmät -parametri |
[Teksti] |
Määritä ryhmien suodatin. Esimerkki suodattimesta : $suodatin=alkaa(näyttöNimi%2C) |
Efecte Provisioning Engine käyttää Microsoft Graph API muodostaakseen yhteyden Microsoft Azure AD . Jos Azure AD stä on tarpeen hakea vain osa käyttäjistä, se voidaan tehdä suodattimien avulla. Lisätietoja API suodattimista löytyy Microsoftin dokumentaatiosta: https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0
Yhteyden suojaus | ||
Nimi |
Arvo |
Kuvaus |
Todennusmenetelmä |
[Salainen / Todistus] |
Asiakkaan (sovelluksen) salaisuus, joko salasana tai julkinen/yksityinen avainpari (varmenne). |
Salaisen avaimen arvo |
[teksti] |
Tämä arvo on pakollinen, kun todennusmenetelmäksi on valittu ”Salainen”. Käytä sovelluksen rekisteröinnin yhteydessä luomaasi asiakassalaisuutta. |
Julkisen avaimen alias |
[teksti] |
Tämä arvo on pakollinen, kun todennusmenetelmäksi on valittu ”Varmenne”. Pro tälle arvolle julkisen avaimen alias. |
Yksityisen avaimen alias |
[teksti] |
Tämä arvo on pakollinen, kun todennusmenetelmäksi on valittu ”Varmenne”. Pro tälle arvolle yksityisen avaimen alias. |
Yksityisen avaimen salasana |
[teksti] |
Tämä arvo on pakollinen, kun todennusmenetelmäksi on valittu ”Varmenne”. Pro yksityisen avaimen salasana tälle arvolle. |
Identiteettiattribuuttien yhdistäminen Azure AD
Valmistelutehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttäjän tunnistetiedot kultakin Azure Active Directory . Nämä tiedot on yhdistettävä Efecte Service Management Toolin tietorakenteisiin.
Yllä olevassa kuvassa näkyvät identiteettiattribuuttimääritykset kuvaavat, miten kohteet ja määritteet yhdistetään Efecte Service Management Toolin ja kohde- Azure AD välillä. Identiteettiattribuuttimääritykset määrittelevät Azure AD n käyttäjä- tai ryhmäobjektin määritteet ja käyttäjä- tai roolimääritteet, jotka yhdistetään. Käyttöliittymän vasen sarake (yllä oleva kuva) osoittaa kentät, jotka Pro poimii Azure AD stä. Käyttöliittymän oikea sarake osoittaa ESM:ssä olevan kansion/mallin/attribuutin, johon Azure AD stä poimittu kenttä lisätään/päivitetään.
Pakolliset ominaisuudet näytetään heti, kun näkymä avataan. Valinnaisia ominaisuuksia voidaan lisätä Lisää ominaisuus -painikkeella. Käytännössä jokainen ominaisuus koostuu nimi-arvo-parista, joka tarkentaa tai muuttaa tehtävän toimintaa. Joillakin ominaisuuksilla on käyttöliittymä, jonka avulla voit valita arvon alasvetovalikosta tai napsauttamalla valintanappia.
Ominaisuus poistetaan napsauttamalla ominaisuuden oikealla puolella olevaa poistokuvaketta (x). Manuaalisesti lisättyjen ominaisuuksien nimet ja arvot ovat kirjainkokoriippuvaisia ja niiden on oltava tarkkoja. Esimerkiksi asetusten nimet on merkittävä täsmälleen ohjetekstin mukaisesti.
Huomautus:
EPE-versiosta 2021.1 alkaen sallimme käyttäjien poissuljettujen tunnisteiden luettelon määrittämisen tietoja ESM:ään vietäessä. Tämä parannus mahdollistaa tiettyjen käyttäjien poissulkemisen ESM-viennistä.
Azure AD n käyttöoikeuksien yhdistäminen
Efecte Provisioning Engine käyttöoikeudet ilmaistaan tyypillisesti Azure AD -ryhminä, Azure tyypillisesti joko suojaus- tai Office 365 (O365) -ryhminä. Suojausryhmiä käytetään käyttäjien pääsyn hallintaan sovelluksen sisäisiin resursseihin ja O365-ryhmiä käyttäjien yhteistyön helpottamiseen jaettujen Microsoftin verkkoresurssien kanssa. Tämän seurauksena Efecte Service Management Tool saa käyttöoikeudet kultakin Azure AD :ltä käyttöönottotehtävästä. Nämä tiedot on yhdistettävä Efecte Service Management Toolin tietorakenteisiin. Käyttöoikeuksien yhdistäminen määrittää käyttöönottomoottorin tehtävätyypin tietyt ominaisuudet.
”Kohdemallin koodi” ja ”Kansiokoodi” -ominaisuudet näytetään heti, kun näkymä avataan. Myös ainakin id:n ja datasourceid:n yhdistämismääritykset ovat pakollisia, ja nämä kolme kenttää näytetään automaattisesti. Valinnaisia ominaisuuksia voidaan lisätä Lisää ominaisuus -painikkeella. Käytännössä jokainen ominaisuus koostuu nimi-arvo-parista, joka tarkentaa tai muuttaa tehtävän toimintaa. Joillakin ominaisuuksilla on käyttöliittymä, jonka avulla voit valita arvon alasvetovalikosta tai napsauttamalla valintanappia.
Huomautus:
EPE-versiosta 2021.1 alkaen sallimme ESM:ään vietäessä poissuljettujen ryhmien tunnisteiden luettelon määrittämisen. Tämä parannus mahdollistaa tiettyjen ryhmien poissulkemisen ESM-viennistä.
Pro tilatiedot
Järjestelmänvalvojilla on näkyvyyttä kaikkien tuettujen käyttäjätietovaraston valmistelutehtävien purkamisen ja lataamisen tilaan. Tarvittaessa järjestelmänvalvojat voivat myös ladata käyttäjä- ja ryhmätiedostoja lisätietoja varten. Purkamisen tila antaa tietoa siitä, miten tiedot noudettiin lähteestä, ja lataustila antaa tietoa siitä, miten EPE pystyi lataamaan tietoja ESM:ään. Purkamisen/lataamisen tilataulukoita ei päivitetä reaaliajassa, vaan käyttäjä voi tarvittaessa napsauttaa sivun otsikossa olevaa "Päivitä"-painiketta. Tämä sivu päivitetään myös sen jälkeen, kun avaat sen uudelleen.
Pro tuonti/vienti
Efecte Pro -versiosta 2021.1 eteenpäin tarjoamme mahdollisuuden tuoda ja viedä provisiointitehtäviä. Tämä mahdollistaa olemassa olevien provisiointitehtävien viennin. On mahdollista valita, mitkä olemassa olevista provisiointitehtävistä viedään.
Tuo/Vie-painikkeet näkyvät Ajoitetut tehtävät -näkymän vasemmalla puolella.
Kun käyttäjä napsauttaa ”Vie”-painiketta, hänelle näytetään kaikki mahdolliset tehtävät, joista hän voi joustavasti valita sopivat tehtävät.
Kun käyttäjä napsauttaa ”Ok”-painiketta, valmistelutehtävät viedään XML-tiedostoon. Vietyä XML-tiedostoa voidaan sitten käyttää valmistelutehtävien tuomiseen valittuun ympäristöön. Jos haluat tuoda ne samaan ympäristöön, on suositeltavaa muokata kahta ominaisuutta XML-tiedostossa. Jokaiselle viedylle tehtävälle on kaksi ominaisuutta: ”UniqueIdentifierId” ja ”TaskName”, ja jos aiot tuoda ne olemassa olevaan ympäristöön, on suositeltavaa muuttaa näitä ominaisuuksia virheiden välttämiseksi tuonnin aikana.