Ajastettavat tehtävät
palveluohjelma tarjoaa mahdollisuuden luoda ajastettuja tehtäviä, jotka suorittavat toiminnon automaattisesti määritettynä ajankohtana määritettyjen ehtojen mukaisesti. Ajastettujen tehtävien avulla voit suorittaa esimerkiksi automaattisesti käynnistyviä toimintoja, kuten sähköpostin lähettämistä, tekstitiedostojen luomista ja kortin tietojen muuttamista. Voit määrittää tehtävätyypin ja sen ajoituksen Schedulable task editor -muokkaimella.
Kun avaat näkymän Schedulable tasks, Edit Schedulable Tasks -taulukko luetteloi mahdolliset määritetyt tehtävät. Ajastetuilla tehtävillä on vihreä kuvake. Tehtävillä, joita ei ole koskaan suoritettu, on punainen kuvake.
Schedulable tasks -näkymässä voit poistaa käyttämättömät tehtävät napsauttamalla roskakorikuvaketta. Muokataksesi olemassa olevaa tehtävää, napsauta sen nimeä. Voit myös luoda uusia tehtäviä napsauttamalla Add a new task -painiketta.
Ajastettavien tehtävien luominen
Avataksesi Schedulable task editor -muokkaimen, avaa hallintakäyttöliittymän Schedulable tasks -osio ja napsauta Schedulable Tasks. Edit schedulable tasks -näkymän vasemmassa yläkulmassa napsauta Add a new task. Valitse tehtävän tyyppi. Schedulable task editor avautuu työalueelle.
Kaikille ajastettaville tehtäville on määritettävä seuraavat tiedot:
- Description – Kirjoita tehtävälle kuvaus, joka näytetään Edit schedulable tasks -näkymässä. Voit kuvata tehtävän käyttötarkoituksen ja erottaa samantyyppiset tehtävät toisistaan.
- User – Valitse käyttäjä, jonka oikeuksilla tehtävä suoritetaan.
Scheduling – Aktivoi tehtävä ottamalla Scheduling käyttöön. Jos jätät ajastuksen pois käytöstä, ESM tallentaa tehtävän mutta ei suorita sitä. - Run – Määritä, milloin tehtävä suoritetaan.
- Every day: Valitse, kuinka monen minuutin tai tunnin välein tehtävä suoritetaan. Starting from -kohdasta voit määrittää aloitusajan ja ajastaa eri tehtävät suoritettaviksi eri aikoihin, jotta ne eivät ole päällekkäin tai ovat ainakin pääosin eri aikaan, mikäli näin halutaan.
- Every week: Valitse, minä viikonpäivinä tehtävä suoritetaan. Aika (@hh:mm) -kohdasta voit määrittää aloitusajan ja ajastaa eri tehtävät suoritettaviksi eri aikoihin, jotta ne eivät ole päällekkäin tai ovat ainakin pääosin eri aikaan, mikäli näin halutaan.
- Every month: Valitse, minä kuukauden päivänä tehtävä suoritetaan. Aika (@hh:mm) -kohdasta voit määrittää aloitusajan ja ajastaa eri tehtävät suoritettaviksi eri aikoihin, jotta ne eivät ole päällekkäin tai ovat ainakin pääosin eri aikaan, mikäli näin halutaan.
- Every quarter: Valitse, mitkä vuosineljänneksen kuukaudet (1, 2, 3) ja minä kyseisen kuukauden päivänä tehtävä suoritetaan. Aika (@hh:mm) -kohdasta voit määrittää aloitusajan ja ajastaa eri tehtävät suoritettaviksi eri aikoihin, jotta ne eivät ole päällekkäin tai ovat ainakin pääosin eri aikaan, mikäli näin halutaan.
- Myös tehtäväkohtaiset ominaisuudet ovat pakollisia.
Tehtäväkohtaiset ominaisuudet näytetään työalueella ajastuksen alapuolella. Jokaisella tehtävällä on oma ominaisuusjoukkonsa.
Määritä tehtäväkohtaiset ominaisuudet valitun tehtävätyypin mukaan. Pakolliset ominaisuudet näytetään heti, kun näkymä avataan. Valinnaisia ominaisuuksia voi lisätä add property -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 arvon voi valita pudotusvalikosta tai valintapainikkeella.
Kysymysmerkkikuvake avaa ominaisuuden ohjetekstin. Ominaisuuden voi poistaa napsauttamalla poistokuvaketta (x) ominaisuuden oikealla puolella.
Manuaalisesti lisätyt ominaisuuksien nimet ja arvot ovat kirjainkokoherkkiä ja niiden on oltava tarkkoja. Asetusten nimet on esimerkiksi kirjoitettava täsmälleen ohjetekstissä ilmoitetulla tavalla.
Tehtävätyypit on kuvattu alla.
CSVImportTask (CSV-liitin)
CSV-liitin tietojen tuomiseen ulkoisista järjestelmistä. CSV-tiedosto voidaan hakea paikalliselta levyltä tai SFTP-palvelimelta. Tiedoston on oltava RFC 4180 -standardin mukainen. Tukee SFTP-yhteyttä sekä julkisen avaimen että salasanan todennuksella. Tuotavan tiedoston tiedostopäätteen on oltava .csv.
ChatIntegration -ajastettu tehtävä
Käytä tätä tehtävää yhdessä Giosg Live -alustaan perustuvan Efecte Multi-Room Chatin kanssa. Kaikki chat-keskustelutallenteet voidaan hakea Giosg Live -alustalta Efecte Service Managementiin raportointi- ja auditointitarkoituksiin. Tämä Efecte Service Managementin ajastettu tehtävä huolehtii tietojen pyytämisestä ja tallentamisesta. Valitse tietojen hakuväliksi kerran päivässä, mieluiten aikaisin aamulla esimerkiksi klo 04.00–06.00. Edellisen arkipäivän tietojen hakeminen vie jonkin verran aikaa, joten tehtävän suorittaminen useammin vaikuttaa negatiivisesti koko ratkaisun suorituskykyyn.
Huomautus:
Mallin chat_session on oltava olemassa, jotta tämä ajastettu tehtävä toimii.
DateCheckerTask
Käyttämällä DateCheckerTask -tehtävää voit saada ajastettuja sähköpostiraportteja tai tiedostoja korteista, joiden päivämääräkentät täsmäävät määritettyihin ehtoihin. Toimiakseen halutulla tavalla tehtävä tarvitsee alla kuvatut pakolliset ominaisuudet. Valinnaiset ominaisuudet on kuvattu valinnaisten ominaisuuksien taulukossa.
Pakolliset DateCheckerTask-ominaisuudet:
Pakolliset DateCheckerTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
checked.attribute.code |
[attribute_code] |
Sen attribuutin/attribuuttien attribuuttikoodi, jonka arvoa ESM tarkistaa tehtävän laukaisemiseksi. Attribuutin tietotyypin on oltava date tai date and time. Jos syötät useamman koodin, erota ne pilkuilla. |
checked.template.code |
[template_code] |
Sen mallin/mallien mallikoodi, jonka arvoa ESM tarkistaa tehtävän laukaisemiseksi. Jos syötät useamman koodin, erota ne pilkuilla. |
trigger.date |
[now+5d] |
now-päivämääräkaava toiminnon laukaisemiseen. Kaavan syntaksi on seuraava: now±<n>d, jossa
|
mail.subject |
[Aiheteksti] |
Sähköpostin aihe. |
mail.recipient |
[sähköpostiosoite] |
Vastaanottajan sähköpostiosoite, jota ESM käyttää viestin To -kentässä. Jos syötät useamman osoitteen, erota ne pilkuilla. |
mail.from |
[sähköpostiosoite] |
Lähettäjän sähköpostiosoite, jota ESM käyttää viestin From-kentässä. |
mail.header |
[Hyvä vastaanottaja] |
Viestin rungon ylätunniste. |
mail.footer |
[Terveisin, ] |
Viestin rungon alatunniste. |
mail.report |
[$entity_name$ on the $template$ has been changed.] |
Raporttiviesti, jossa voit käyttää seuraavia attribuuttien paikkamerkkejä:
Raportissa paikkamerkit korvataan todellisilla attribuuttiarvoilla: ”Data card $entity_name$ from the $template$ has been changed. The new $attribute_name$ value is $value$” ”Kortti Volkswagen Passat 1.6 Firstline mallilla Car on muuttunut. Uusi Owner on JOHN SMITH.” |
Valinnaiset DateCheckerTask-ominaisuudet:
Valinnaiset DateCheckerTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
report.method |
file or mail or onlyStore |
Raportin toimitustapa. Oletustapa on mail. Jos asetettu arvoon onlyStore, löydetyt kortit tallennetaan mallille liitettyjen kuuntelijoiden ja attribuuttikäsittelijöiden laukaisemiseksi. |
trigger.date.strict |
[true / false] |
Jos asetettu arvoon true, löydetään vain laukaisupäivän kortit. Muutoin löydetään myös kortit, joiden trigger.date-arvo on ennen laukaisupäivää. |
included.datacards |
[all / visible / hidden] |
Määrittää, mitkä kortit sisällytetään niiden piilotustilan perusteella. Oletusarvo on "visible". |
file.path |
[c:\temp] |
Jos käytät file-tapaa, ESM tarvitsee polun levyasemalla olevaan hakemistoon, johon tiedosto tallennetaan. ”uploads” on oletushakemisto. Jos viitattua hakemistoa ei ole olemassa, toiminto epäonnistuu ja lokissa näkyy virhe. |
file.name |
[report.txt] |
Jos käytät file-tapaa, ESM tarvitsee tiedostolle nimen. ”report.txt” on oletusnimi. |
EventTask
Voit ottaa käyttöön tai poistaa käytöstä korttitapahtumien, kuten Mail- ja Save-tapahtumien, suorittamisen tämän tehtävän asetusten kautta. EventTask vaatii käyttäjän (jonka oikeuksilla tehtävä suoritetaan) ja ajastussäännöt.
ESM 2023.3:sta alkaen, jos tapahtumakohteen (joka määrittää, mitkä tapahtumat EventTask suorittaa) hakemisessa 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ällaisessa tilanteessa tapahtuma merkitään tilaan "partially succeeded" ja ilmoitus näytetään EventTaskin käyttöliittymässä:
MessageQueueTask
Viestijonon viestien lähettämisen suorittamiseen. Jos jonossa on viestejä, tämä tehtävä käynnistää niiden lähettämisen. Lisätietoja viestijono-osiossa.
LicenseMonitoringTask
Ohjelmistoresurssien hallintatehtävä, jolla seurataan yrityksen käytössä olevia ja vapaita ohjelmistolisenssejä.
Se lähettää sähköpostiraportin ohjelmistolisenssirikkomuksista eli asennetuista ohjelmistoista ilman lisenssiä sekä ohjelmistoista, joiden asennusmäärä ylittää lisenssien sallitun määrän. Pakolliset ominaisuudet on kuvattu alla olevassa taulukossa.
Pakolliset LicenseMonitoringTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
no.licenses.header |
[Teksti] |
Ylätunniste lisenssittömille ohjelmistoille. |
too.many.installations.header |
[Teksti] |
Ylätunniste ohjelmistoille, joita on asennettu enemmän kuin lisenssejä on. |
mail.subject |
[Aiheteksti] |
Sähköpostin aihe. |
mail.sender |
[sähköpostiosoite] |
Sähköpostin lähettäjän osoite. |
mail.receiver |
[sähköpostiosoite] |
Sähköpostin vastaanottajan osoite. |
Tekniset tiedot
LicenseMonitoringTask luo raportin kaikista valvotuista ohjelmistoasennuksista, joilla ei ole lisenssipoolia. Valvotulla ohjelmistoasennuskortilla ei ole lisenssipoolia, jos kortin attribuutti LicenseManagementLicenseReference ei viittaa lisenssipooliin. Raportti kertoo myös, millä tietokoneella kyseinen ohjelmisto on asennettuna.
Luotu raportti kertoo myös, missä lisenssipooleissa on liikaa asennuksia. Tämä tehdään etsimällä lisenssipoolit, joihin viittaavien valvottujen ohjelmistoasennusten määrä on suurempi kuin attribuutin LicenseManagementLicenseAmount arvo.
MailTask
MailTask on tarkoitettu korttien luomiseen sähköpostiviesteistä. Se lukee sähköpostia postilaatikosta, jonka on perustuttava sähköpostitiliin (jaettuja postilaatikoita ei tueta), tuo sähköpostin ESM:ään, liittää sähköpostin ja sen liitteet korttiin ja poistaa sitten viestin postilaatikosta.
Seuraavat taulukot kuvaavat MailTaskin ominaisuudet.
Pakolliset MailTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
group.id |
[ryhmätunnus] |
Sen kansion tunnus, johon sähköpostista luotu kortti sijoitetaan. |
template.code |
[template_code] |
Sen mallin mallikoodi, johon ESM perustaa sähköpostista luodun kortin. |
reply.message |
[Viestin teksti] |
Vastausviesti, jonka ESM lähettää lähettäjälle. |
Valinnaiset MailTask-ominaisuudet | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
template.code.fall.back |
[template_code] |
Varamallin mallikoodi. ESM perustaa kortin varamalliin, jos se ei löydä seurantanumeroa ensisijaisesta mallista. |
reply.disabled |
any |
Jos ominaisuudella on mikä tahansa arvo, ESM ei lähetä automaattista vastausta alkuperäiseen sähköpostiviestiin. |
reply.sender |
[sähköpostiosoite] |
Lähettäjän osoite, jota ESM käyttää vastausviestin From -kentässä. Jos tätä ei ole asetettu, käytetään sähköpostin vastaanottajan osoitetta. |
attribute.code.body |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin Body-kentästä. |
attribute.code.from |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin From -kentästä. Arvo voi olla pilkuilla eroteltu luettelo monella arvolla varustettuja attribuutteja varten. |
attribute.code.subject |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin Subject-kentästä. |
attribute.code.recipient |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin molemmista To ja Cc-kentistä. |
attribute.code.to |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin To-kentästä. |
attribute.code.cc |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin Cc-kentästä. |
attribute.code.timestamp |
[attribute_code] |
Sen attribuutin attribuuttikoodi, joka saa arvon sähköpostiviestin vastaanottoajan mukaan. |
group.map.attribute.code |
[attribute_code] |
Käytetään lähettäjäkohtaisen päätöksen tekemiseen siitä, mihin kansioon sähköpostista luodut kortit sijoitetaan. Anna tähän sen attribuutin koodi mallissa, joka kuvaa sähköpostin lähettäjää – esim. Client-malli. Sinulla on myös oltava viittauskenttä attribute.code.from-arvona. Kansioilla, joiden joukosta valinta tehdään, on oltava määritettynä mapToGroupAttributeValue-metatieto sekä arvo, joka vastaa attribuuttikentän arvoja. |
attribute.code.mail.tracking |
[attribute_code] |
Sen attribuutin attribuuttikoodi, jonka arvo toimii sähköpostin seurantatunnuksena. |
attribute.code.message.as.link |
[attribute_code] |
Attribuutin koodi, johon sähköpostiviestit linkitetään. Tämä attribuutti vaatii EntityStateMail-käsittelijän viestien käsittelyyn sekä external reference-tietotyypin. |
attribute.code.attachment.as.link |
[attribute_code] |
Attribuutin koodi, johon mahdolliset sähköpostin liitteet linkitetään. Attribuutin tietotyypin on oltava external reference. |
mail.store.host |
[server_IP or network_name] |
Sen postipalvelimen isäntänimi, josta sähköposti luetaan. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.store.port |
[port_number] |
Postipalvelimen portti. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.store.user |
[user_name] |
Postipalvelinyhteyden todentamiseen käytetty käyttäjä. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.store.password |
[password] |
Postipalvelinyhteyden todentamiseen käytetty salasana. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.transport.host |
[hostname] |
Postin välityspalvelimen isäntänimi. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.transport.port |
[port_number] |
Postin välityspalvelimen portin numero. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.transport.user |
[user_name] |
Postin välityspalvelinyhteyden todentamiseen käytetty käyttäjä. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.transport.password |
[password] |
Postin välityspalvelinyhteyden todentamiseen käytetty salasana. Ohittaa arvon, joka on tiedostossa framework.properties. |
mail.folder.name |
[folder_name] |
Sen postilaatikon kansion nimi, josta sähköposti luetaan. Ohittaa arvon, joka on tiedostossa framework.properties. |
any attribute code |
[attribute_code] |
Tähän voidaan antaa mikä tahansa kiinteä attribuuttikentän arvo, joka sijoitetaan sähköpostista luotuun korttiin. |
update:attribute code:current value |
Uusi arvo |
Määrittämällä ominaisuuden, jonka nimi on muotoa "update:YYY:ZZZ" ja YYY vastaa attribuuttikoodia ja ZZZ vastaa attribuutin nykyistä arvoa, attribuutin arvo korvataan ominaisuuden arvolla. Esimerkiksi ominaisuuden avain voi olla "update:status:On hold" ja arvo "In progress". Tämä tarkoittaa, että kun uusi sähköposti liitetään korttiin, jonka nykyinen tila on "On hold", se päivitetään tilaan "In progress" Jos ominaisuuden avain päättyy merkkijonoon $EMPTY$, arvo asetetaan vain, jos nykyinen arvo on tyhjä. Jos ominaisuuden avain päättyy merkkijonoon $ALWAYS$, arvo päivitetään aina. Vain seuraavat tietotyypit ovat tuettuja: string, static string ja text. Arvo asetetaan ennen käsittelijöiden tai kuuntelijoiden laukeamista. |
autoUpdateMapping:tag |
[attribute_code] |
Määrittämällä tämän ominaisuuden, erityisesti muotoillusta sähköpostista saadut arvot voidaan asettaa attribuutin arvoksi. Esimerkiksi "autoUpdateMapping:issue" arvolla "description": Attribuutti, jonka koodi on 'description', päivitetään sähköpostista saadulla arvolla. Sähköpostista etsitään tagia '[issue]:'. Kaikki tagin jälkeen samalla rivillä oleva sisältö katsotaan arvoksi. Jos sähköposti sisältää useita rivejä sam alle tagille (esim. [issue]:), vain viimeisin arvo otetaan käyttöön. Kortilla oleva olemassa oleva arvo korvataan aina. HUOM. Tagin tarkka muoto riippuu määrityksestä. HUOM. Tuetut tietotyypit ovat: String, Text, Date, Date and time, Reference, Backreference, External reference, Number ja Decimal number. Tähän asetukseen voi määrittää useita eri tageja koskevia määrityksiä. |
static.autoUpdateMapping:tag.value |
[attribute_code].[static value] |
Tätä asetusta voidaan käyttää, kun ulkoisen järjestelmän useita eri arvoja on kartoitettava yhdeksi staattiseksi arvoksi ESM:ssä. Esimerkiksi "static.autoUpdateMapping:newStatus.:new,untouched" arvolla "status.New": Staattinen attribuutti, jonka koodi on 'status', päivitetään arvoon 'New', jos sähköpostin tagin arvo on 'new' tai 'untouched'. Sähköpostista etsitään tagia '[newStatus]:'.
HUOM. Tagin tarkka muoto riippuu määrityksestä.
Hierarkkisilla staattisilla arvoilla käytä käytäntöä ’ylätason arvo/alatason arvo’ |
autoUpdateStartTag |
tagin aloitusmerkkijono |
Sähköpostissa erikoisarvojen merkitsemiseen käytettävän aloitustagin muoto.
Esimerkiksi '$NAME$'. Merkkijonoa 'NAME' käytetään tagien nimien paikkamerkkinä. Oletusarvo on '[NAME]:'.
Jos asetusta autoUpdateEndTag ei ole määritetty, kaikki aloitustagin jälkeen samalla rivillä oleva sisältö katsotaan arvoksi.
Tämä asetus on yksiarvoinen.
HUOM! Tageja etsitään vain sähköpostin rungosta. Sähköpostin aihetta ei sisällytetä. |
autoUpdateEndTag |
tagin aloitusmerkkijono |
Sähköpostissa erikoisarvojen merkitsemiseen käytettävän lopetustagin muoto.
Esimerkiksi '$/NAME$'. Merkkijonoa 'NAME' käytetään tagien nimien paikkamerkkinä. Ei oletusarvoa. Jos tämä asetus on määritetty, kaikki aloitustagin ja vastaavan lopetustagin välissä oleva sisältö katsotaan arvoksi.
Tämä asetus on yksiarvoinen. HUOM! Tageja etsitään vain sähköpostin rungosta. Sähköpostin aihetta ei sisällytetä. |
AutoUpdateMapping-esimerkit
Tämä osio sisältää muutamia esimerkkejä autoUpdate-asetusten määrittämisestä.
Esimerkki 1: Tässä esimerkissä on ensin määritys, sitten tuotu sähköposti ja lopuksi kuvakaappaus luodusta kortista:
Esimerkki 2:
Esimerkki 3:
Esimerkki 4:
Esimerkki 5:
ReportExportTask
ReportExportTaskia voidaan käyttää valitun raportin viemiseen tiedostoon halutussa muodossa. Sekä taulukkomuotoiset yksityiskohtaiset raportit että graafiset raportit ovat tuettuja.
Huomautus:
ReportExportTask tukee nykyään vain Efecte ITSM release 6 -muotoisia raportteja. Nykyisessä Workspace-käyttöliittymässä luotuja ja tallennettuja näkymiä ei vielä tueta.
Taulukkomuotoisten yksityiskohtaisten raporttien tulostiedoston muoto voidaan määrittää XSLT-tiedostolla. Oletuksena CSV- ja HTML-viennit ovat sisäänrakennettuja, mutta myös useat muut tiedostomuodot ovat mahdollisia. Muita yksityiskohtaisten raporttien tiloja (minimal, referrers, full) ei tueta.
Graafiset raportit tuottavat PNG-kuvatiedoston.
Huomautus:
On-premise-asennuksissa varmista, että Tomcat-prosessia suorittavalla käyttäjätilillä on kirjoitusoikeus kohdassa target.file.name määritettyyn kansioon.
Pakolliset ReportExportTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
report.id |
[raportin tunnus] |
Sen raportin tunnus, joka muunnetaan ja viedään tällä tehtävällä. (Tunnus on linkin URL-osoitteen bookmarkID-parametri.) Useille raporteille on määritettävä useita tehtäviä. |
target.file.dir |
[teksti] |
Polku muunnetun tiedoston kohdehakemistoon. On-premise-asennuksissa varmista, että Tomcat-prosessia suorittavalla käyttäjätilillä on kirjoitusoikeus kohdassa target.file.name määritettyyn kansioon. |
target.file.name |
[teksti] |
Kohdetiedoston nimi. Voi sisältää $now$-päivämääräkaavan, joka korvataan nykyisellä päivämäärällä. Päivämäärän muoto on yyyy-mm-dd. Jos samanniminen tiedosto on jo olemassa kohdesijainnissa, se korvataan. |
Valinnaiset ReportExportTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
target.file.encoding |
[teksti] |
Kohdetiedoston merkistökoodaus. Oletusarvo on UTF-8. |
transform.file |
[teksti, tiedostonimi] |
XSLT-tiedosto, jota käytetään raportin tulos-xml:n muuntamiseen lopulliseen muotoon. Viedäksesi tiedoston CSV-muodossa, kirjoita tähän kenttään CSV. Viedäksesi tiedoston HTML-taulukkomuodossa, kirjoita tähän kenttään HTML Viedäksesi tiedoston johonkin muuhun XSLT-tiedostossa määritettyyn muotoon, kirjoita polku XSLT-tiedostoon. Jos kenttä jätetään tyhjäksi, tulos-xml viedään sellaisenaan. |
xslt.[parameter] |
[xslt-parametrin arvo] |
Kaikki parametrit, joiden etuliite on xslt., välitetään XSLT-muunnokseen etuliite poistettuna (esim. xslt.some.parameter välitetään XSLT:lle nimellä some.parameter). Lisätietoja on alla olevassa Tekniset tiedot-osiossa. |
css.file |
[teksti, tiedostonimi] |
CSS-tiedosto, joka liitetään tekstiraportteihin. Tuettu sisäänrakennettu arvo on DEFAULT. Jos kenttä jätetään tyhjäksi, tiedostoa ei lisätä. Arvo on järkevä käytettäessä transform.file = HTML. |
header.include |
[true/false/name] |
Jos asetettu arvoon 'true', tulos-xml:ään sisällytetään otsikkorivi. Otsikkorivi sisältää raportissa valittujen attribuuttien koodit. Jos asetettu arvoon ‘name’, otsikot ovat attribuuttien nimiä. Oletusarvo on 'false'. |
date.convert |
[true, false] |
Jos asetettu arvoon true, kaikki päivämääräattribuutit muunnetaan PlatformSettings-asetusten date.output.pattern ja datetime.output.pattern. Jos asetettu arvoon false, arvo on sellaisenaan kuin Java Virtual Machine sen palauttaa. Oletusarvo on false. |
image.width |
[luku] |
Jos määritetty raportti tuottaa graafisen raportin, tämä määrittää kuvan leveyden pikseleinä. Oletusarvo on 640, enimmäisarvo 1920. |
image.height |
[luku] |
Jos määritetty raportti tuottaa graafisen raportin, tämä määrittää kuvan leveyden pikseleinä. Oletusarvo on 640, enimmäisarvo 1080. |
Tekniset tiedot:
XSLT-muunnosta voidaan käyttää ESM:n tulos-xml:n viemiseen mihin tahansa tekstipohjaiseen tiedostomuotoon – esimerkiksi CSV:hen, eri xml-muotoihin tai html:ään. XSLT-muunnos tukee XSLT 1.0:aa ja XPath 1.0:aa.
Tavallisten ominaisuuksien lisäksi ReportExportTaskia voidaan käyttää myös XSLT-muunnoksen parametrien määrittämiseen. Kun parametrit välitetään XSLT-muunnostiedostoon, xslt.-etuliite poistetaan parametrin nimestä (esim. xslt.some.parameter muuttuu XSLT-muunnoksessa muotoon some.parameter). Tuetut parametrit riippuvat täysin käytetystä XSLT:stä.
Monella arvolla varustettujen viittausten tiedot ryhmitellään yhteen xml-multivalue-elementtiin tai yhteen csv-tiedoston sarakkeeseen. Alkuperäistä viittausta ei voida tunnistaa.
ESM:n toteuttama CSV-muunnos tukee seuraavia parametreja:
CSV-muunnoksen parametrit | ||
Nimi |
Arvo |
Kuvaus |
xslt.csv.separator.value |
[mikä tahansa merkki] |
Sarakkeiden välinen erotin. Oletusarvo on ‘,’. |
xslt.csv.separator.multivalue |
[mikä tahansa merkki] |
Monien arvojen välinen erotin. Oletusarvo on ’|’. |
xslt.csv.quote.values |
[true/false] |
Määrittää, suljetaanko kaikki arvot lainausmerkkeihin. Oletusarvo on ’true’. |
VIHJE! CSV-tiedostoissa käytetty muoto on kuvattu tarkasti RFC 4180 -standardissa, http://www.rfc-editor.org/rfc/rfc4180.txt
Huomautus:
XSLT-muunnoksen parametrit voidaan antaa myös ESM:n alustan asetuksissa, jolloin ne vaikuttavat kaikkiin ReportExportTask-tehtäviin; ReportExportTaskissa annetut parametrit kuitenkin ohittavat alustan asetusten parametrit. XSLT-muunnoksen parametrien muoto alustan asetuksissa on report.export.xslt.[parametri].
Jos haluat esimerkiksi määrittää globaalin erotinarvon CSV-muunnokselle, lisää alustan asetus nimellä result.export.xslt.csv.separator.value .
Kaavio ReportExportTaskissa käytetystä hakutuloksen XML-skeemasta:
ReportMailTask
ReportMailTaskia voidaan käyttää luomaan sähköposti, joka sisältää useita vanhalla Efecte Report Wizardilla luotuja raportteja (ei enää suositella käytettäväksi). Postipalvelimen asetukset määritetään alustan asetuksissa. Lähettäjä, vastaanottaja(t), aihe ja sähköpostin sisältö määritetään tehtävän ominaisuuksilla.
- ReportMailTask tukee vain Efecte ITSM 6 -muotoisia raportteja.
- Sekä taulukkomuotoiset yksityiskohtaiset raportit että graafiset raportit ovat tuettuja.
- Taulukkomuotoisten yksityiskohtaisten raporttien tulostiedoston muoto voidaan määrittää XSLT-tiedostolla. Oletuksena CSV- ja HTML-viennit ovat sisäänrakennettuja, mutta myös useat muut tiedostomuodot ovat mahdollisia. Muita yksityiskohtaisten raporttien tiloja (minimal, referrers, full) ei tueta.
- Graafiset raportit tuottavat PNG-kuvia.
- Group by -raportteja ei tueta.
- Seuraavat ominaisuudet eivät ole määritettävissä ReportMailTaskille: report.id, target.file.dir, target.file.name
Määritys on hyvin samankaltainen kuin ReportExportTaskissa. Seuraavat taulukot sisältävät vain lisäasetukset.
Pakolliset ReportMailTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
mail.from |
[sähköpostiosoite] |
Voimassa oleva sähköpostiosoite. |
mail.recipient |
[sähköpostiosoite(et)] |
Voimassa oleva sähköpostiosoite to-kentän vastaanottajille. Voidaan erottaa pilkulla tai puolipisteellä. CC- tai BCC-kenttien vastaanottajia ei tueta. |
mail.subject |
[teksti] |
Sähköpostin aihe. |
Valinnaiset ReportMailTask-ominaisuudet | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
mail.message[.ORDINAL] |
[teksti] |
Valinnainen viesti ennen raportteja. Voi sisältää html-tageja, kuten <br/> rivinvaihtoa varten. Yksi rivi voi sisältää 450 merkkiä. Voidaan määrittää useita rivejä, joilla on yksilöllinen järjestysnumero. |
mail.report.[ORDINAL].[ID] |
[teksti] |
Samankaltainen kuin ReportExportTaskissa report.id. Kyseisellä tunnuksella oleva raportti lähetetään sähköpostilla. (Tunnus on linkin URL-osoitteen bookmarkID-parametri.) Jos yhdessä sähköpostissa on useita raportteja, voit määrittää useita arvoja yksilöllisillä järjestysnumeroilla. Ominaisuuden arvo riippuu ominaisuuden mail.attachment.disposition arvosta. Jos se on inline, tämän ominaisuuden arvo on lyhyt kuvaus, joka näytetään sähköpostissa ennen raporttia. Jos ominaisuuden arvo on mail.attachment.disposition on attachment, tämä ominaisuus tarkoittaa luodun liitteen tiedostonimeä. Kiinnitä huomiota tiedostopäätteeseen. Sen on vastattava asetusta mail.attachment.text.content.type ja transform.file. Jotkin sähköpostiohjelmat käyttävät tiedostopäätettä valitakseen esikatselu- tai apuohjelman liitteen avaamiseen. Jotkin sähköpostiohjelmat käyttävät liitteen sisältötyyppiä. |
mail.attachment.disposition |
[attachment, inline] |
Ominaisuus määrittää, miten raportit lisätään sähköpostiin. Mahdolliset arvot ovat attachment (raportit liitteinä) ja inline (raportit osana viestin runkoa). Oletusarvo on inline |
mail.attachment.text.content.type |
[teksti] |
Jos ominaisuus mail.attachment.disposition on asetettu arvoon attachment, tämä asetus määrittää tekstiraporttien sisältötyypin. Tämän on vastattava asetusta transform.file. Jotkin sähköpostiohjelmat käyttävät tätä ominaisuutta valitakseen esikatselu- 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, image.height. Katso tarkempi kuvaus kohdasta ReportExportTask
DataCardsArchiverTask
DataCardsArchiverTask on tarkoitettu korttien viemiseen tiedostojärjestelmään tai suoraan ulkoiseen järjestelmään https-pyyntömenetelmällä. Molemmat menetelmät (file ja https request) käyttävät Efecte ESM:n standardia XML-muotoa, joka saattaa vaatia muuntamisen kohdejärjestelmän tietomalliin.
Vain Efecte-ylläpitäjät voivat tallentaa listanäkymiä työtilan Archive-osioon. Archive-osioon tallennetut listaraportit voidaan arkistoida DataCardsArchiverTask-ajastetulla tehtävällä.
Huomautus:
Tämä tehtävä on suunniteltu sisällyttämään tietoa vain nykyisestä mallista, ei viittausten kautta tulevaa tietoa.
Vain ylläpitäjät voivat tallentaa, tarkastella tai edes nähdä Archive-välilehden näkymissään.
Arkistointitehtävä ei arkistoi tiedostoliitteitä tai sähköposteja, jotka on linkitetty arkistoituihin kortteihin. Vaikka kortit poistettaisiin, poistettujen korttien tiedostot (sähköpostit ja tiedostoliitteet) jäävät tiedostojärjestelmään, ellei niitä poisteta toisella ajastetulla tehtävällä: CleanRemovedFilesTask. Huomaa myös, ettei tiedostoarkistointi eikä https-pyyntömenetelmä lähetä tiedostoliitteitä eikä sähköposteja määritettyyn kansiorakenteeseen tai kolmannen osapuolen järjestelmään.
Pakolliset DataCardsArchiverTask-ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Archive type |
[file, http request] |
Viedäänkö tiedostojärjestelmään (arvo: file) vai lähetetäänkö https:llä ulkoiseen järjestelmään (arvo: https request). |
Delete data cards |
[True | False] |
Poistetaanko kortit viennin jälkeen tiedostoon vai ei. Oletuksena kortteja ei poisteta. |
Archive report |
[pudotusvalikko Archive-osion raporteista] |
Archive-raportti, jonka kortit arkistoidaan. Tämä raportti on tallennettava Working space -osion Archive-erikoisosioon. |
Export all attributes in data cards |
[True | False] |
Jos asetettu arvoon ‘True’, kaikki vietyjen korttien attribuutit lähetetään arkistoinnin kohteeseen, vaikka listanäkymässä olisi valittuna vain yksi sarake. |
Jos Archive type on ‘file’, seuraavat DataCardsArchiverTask-ominaisuudet ovat pakollisia | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
File location |
[sijainti palvelimella, johon ESM:llä on käyttöoikeus] |
Sijainti, johon viedyt kortit viedään xml-tiedostoina, kun 'Archive'-ominaisuus on asetettu arvoon 'file'. ESM:llä on myös oltava oikeus tallentaa tiedostoja haluttuun sijaintiin.
Määritä tähän “/polku/kansioon” |
Jos Archive type on ‘https request’, seuraavat DataCardsArchiverTask-ominaisuudet ovat pakollisia | ||
|---|---|---|
Nimi |
Arvo |
Kuvaus |
External system address |
[ulkoisen järjestelmän URL-osoite] |
Esim. osoite toiseen ESM:ään. ESM-tapauksessa tarkista parametrit aina nimetyltä konsultilta. Osoitteen on alettava merkeillä ‘https://’ |
External system user name |
[käyttäjätunnus] |
Perustodennuksen käyttäjätunnus ulkoiselle järjestelmälle. |
External system user password |
[password] |
Perustodennuksen käyttäjän salasana ulkoiselle järjestelmälle |
External system connection parameters |
[ulkoisen järjestelmän yhteysparametrit] |
Yhteysparametrit. Aikakatkaisun yksikkö on sekunti. Esimerkkejä esitellään alla. |
External system expected response |
[200=.*, 201=.*] |
Odotetut vastauskoodit ulkoiselta järjestelmältä pilkulla eroteltuna (oletusarvo: "200=.*, 201=.*"). |
External system batch size |
[eräkoko] |
Yhdessä pyynnössä lähetettävien korttien enimmäismäärä (oletus: 10000). |
Esimerkki yhteydestä 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 yhteysparametrit esim.
- acceptSelfSignedCertificates=true ,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60
Archive type: file
Kun Archive type -arvona käytetään file-arvoa, luotu ESM-entiteetin XML-tiedosto tallennetaan palvelimen tiedostojärjestelmään. Ominaisuuden File location on osoitettava olemassa olevaan hakemistoon, johon ESM:llä on kirjoitusoikeus. Tiedostonimi muodostetaan muodossa [task_id]_[time_stamp]_[report_name].xml. Tiedostoja ei poisteta.
Archive type: https request
Kun käytetään https request -tapaa, luotu ESM-entiteetin XML-tiedosto lähetetään kolmannen osapuolen järjestelmään https-pyyntönä. Tarkista taulukko (Table: Required DataCardArchiverTask properties, when Archive type is ‘https request’) pakollisista ominaisuuksista, kun käytetään https request -arkistointitapaa.
Https request -menetelmä käyttää MessageQueueta. Kun DataCardArchiverTask suoritetaan, XML lähetetään kolmannen osapuolen järjestelmään välittömästi. Jos https-pyynnön lähetys epäonnistuu esim. kolmannen osapuolen järjestelmä ei vastaa, pyyntö tallennetaan viestijonoon ja suoritetaan uudelleen, kun MessageQueueTask suoritetaan seuraavan kerran. Jotta https-pyyntö toimisi oikein, Efecte-ylläpitäjän on määritettävä MessageQueueTask.
Tiedostot poistetaan, kun vienti on suoritettu onnistuneesti.
External system expected response
Ominaisuus External system expected response määrittää odotettujen vastauskoodien ja -viestien yhdistelmän ulkoiselta järjestelmältä.
Expected Response Code: Koodi ilmaisee ulkoisen järjestelmän vastauskoodin sen mukaan, hyväksytäänkö vai hylätäänkö pyyntö. Esim. 200, 404.
Expected Response Message: ESM tarkistaa vastausviestin saaduista vastauksista. Sisällön tarkistus tehdään säännöllisillä lausekkeilla.
Käytetty muoto on:
code1=message1,code2=message2 (pilkku erottimena)
Esimerkki 1: 200=,404=Nothing to be archived
Sekä 200 että 404 hyväksytään vastauskoodeina. Koodilla 200 vastausviestin tulee olla tyhjä tai null. Koodilla 404 vastausviestissä tulee olla teksti "Nothing to be archived".
Esimerkki 2: 200=.+
Vain 200 hyväksytään vastauskoodina. Mikä tahansa sisältö vastausviestissä hyväksytään.
Lokitus
DataCardsArchiverTask kirjaa toimintansa info- ja debug-tasolla tiedostoon itsm.log. Saadaksesi yksityiskohtaisempaa tietoa tehtävän ja ulkoisen järjestelmän välisestä viestinnästä voit asettaa myös debug-lokitason paketille com.efecte.queue.
CleanRemovedFilesTask
CleanRemovedFilesTask on tarkoitettu tiedostojärjestelmässä olevien viittaamattomien / orpojen tiedostojen, kuten sähköpostien ja liitteiden, siivoamiseen. Jos tätä tehtävää ei suoriteta, nämä resurssit jäävät tiedostojärjestelmään käyttäen levytilaa, vaikka niihin viittaava kortti poistettaisiin.
Tämä ajastettava tehtävä on oletuksena käytössä ja suoritetaan päivittäin. Efecte-ylläpitäjä voi ajastaa tehtävän uudelleen tai poistaa sen käytöstä kohdasta Scheduled tasks.
Huomaa: Tämä toiminto ei poista orpotiedostoja, jotka olivat järjestelmässä jo ennen päivitystä ESM-versioon 2018.3.2.
Ajastettujen tehtävien muokkaaminen ja poistaminen
Voit tarkastella ja muokata kaikkia luotuja tehtäviä Edit schedulable tasks -näkymässä. Avataksesi näkymän, avaa Maintenance-näkymän General-välilehti ja napsauta Schedulable Tasks. Napsauta näkymässä sen tehtävän nimeä, jota haluat muokata.
Edit schedulable tasks -näkymä avautuu työalueelle, mukaan lukien Schedulable task editor ja Task properties -näkymä. Tee muutokset olemassa oleviin tietoihin ja napsauta Save tallentaaksesi muokatun ajastetun tehtävän.
Voit poistaa käyttämättömät tehtävät Edit schedulable tasks -näkymästä. Valitse Remove-valintaruudut poistettavien tehtävien vierestä ja napsauta Remove-painiketta toiminnon suorittamiseksi.
Provisiointitehtävät
Provisiointitehtävät ovat automatisoituja, ajastettavia tehtäviä, jotka on tarkoitettu käyttäjien identiteettitietojen tuomiseen Efecte Service Management Tooliin joko LDAP-rajapinnalla (Lightweight Directory Access Protocol) Active Directorylle, OpenLDAP:lle, IBM LDAP:lle, FreeIPA:lle tai Microsoft Graph API:lla Microsoft Azure AD:lle. Efecte Provisioning Engine (EPE) IGA-ratkaisumme osana nopeuttaa käyttäjien provisiointia (kutsutaan myös täytäntöönpanoksi identiteetin- ja käyttöoikeushallinnan alalla). EPE toimii todellisena rinnakkaiskäsittelymenetelmänä, joka mahdollistaa useiden ajastettujen ja tapahtumapohjaisten käyttöoikeusmuutosten tekemisen.
Huomio! ESM 2023.3:sta alkaen provisiointitehtävät sijaitsevat IGA-välilehdellä – eivät enää Schedulable tasks -välilehdellä.
Tuodut määritykset tallennetaan EPE-Master-tietokantaan (Efecte Provisioning Engine - Master), ei Efecte Service Management (ESM) -tietokantaan. Identity Attribute Mapping ja Access Rights Mapping tallennetaan ESM:ään, ja niihin vaikuttaa ESM:n mallien ja kansioiden muuttaminen.
Yhdistääksesi Efecte Service Management Toolin ja Efecte Provisioning Enginen, sinun on määritettävä useita asetuksia hallintakäyttöliittymän Platform Settings -kohdassa.
Oletuksena Efecte Provisioning Engineen yhdistämiseen tarvittavat ominaisuudet haetaan consulista. Siksi consul.enabled-ominaisuus on asetettava arvoon true. Sen jälkeen voit varmistaa, että myös “provisioning.configuration.consul” on käytössä.
Kun Consul on käytössä, kaikki Efecte Provisioning Enginen tarvitsemat määritykset määritetään:
Provisiointitehtävän määritys Active Directorylle
Efecte Provisioning Engine käyttää LDAP-rajapintaa (Lightweight Directory Access Protocol) Active Directorylle, OpenLDAP:lle, IBM LDAP:lle ja Redhat LDAP:lle (FreeIPA). Ominaisuudet on nimetty kyseessä olevan hakemiston mukaan. Muuten tarvittavat määritykset ovat samat.
Yleiset provisiointitehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Provisiointityyppi |
[Scheduled-based provisioning, Event-based provisioning, Authentication] |
Provisiointityyppi voidaan luokitella tarpeen mukaan. Muut provisiointitehtävän ominaisuudet näytetään valitun tyypin mukaan. |
Kartoitustyyppi |
[Identity & Access Rights] |
Lisää molempien kartoitusten osiot. |
Nimi |
[Teksti] |
Provisiointitehtävän nimi. |
WebAPI-käyttäjä |
[WebAPI-käyttäjän valinta] |
WebAPI-käyttäjä, jota käytetään EPE:n ja ESM:n väliseen viestintään |
WebAPI-salasana |
[Teksti] |
WebAPI-käyttäjän salasana. Pakollinen kenttä, joka on täytettävä provisioinnin toimimiseksi. |
Pakolliset provisiointitehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
LDAP uniqueIdentifierId |
[Teksti] |
Jokaisella tuontiprosessilla on yksilöllinen prosessitunnus LDAP uniqueIdentifierId, jota käytetään avaimena provisiointimoottorin masterissa erottamaan tämä prosessi muista tuontiprosesseista provisiointimoottorin masterissa. Tunniste tarvitaan, jotta myöhemmät muutokset tai poistot kohdistuvat oikeaan kohteeseen. |
LDAP host |
[IP-osoite tai isäntänimi] |
Kohdehakemiston IP-osoite tai isäntänimi. |
LDAP port |
[Portti] |
Kohdehakemiston portti määrittää, mihin porttiin Active Directoryssa Provisioning Engine muodostaa yhteyden. |
LDAP username |
[Käyttäjätunnus]@[Toimialue] |
LDAP-yhteydessä käytettävä käyttäjätunnus. LDAP:ssa käyttäjätunnus on tyypillisesti käyttäjän käyttäjätunnus tai DN. |
LDAP password |
[Teksti] |
LDAP-yhteydessä käytettävä salasana. Salasana annetaan selkokielisenä tekstinä. |
LDAP authenticationMethod |
[simple, strong, none] |
LDAP-yhteydessä käytettävä todennustyyppi. Seuraavat todennustyypit ovat tuettuja: – simple – strong – none |
LDAP securityProtocol |
[simple, ssl] |
LDAP-yhteydessä käytettävä suojausprotokolla. Seuraavat suojausprotokollat ovat tuettuja: – ssl: Provisioning Engine muodostaa LDAPs-yhteyden Active Directoryyn – simple: Provisioning Engine muodostaa LDAP-yhteyden Active Directoryyn Huomio! SSL on otettava käyttöön, jotta salasanoja voidaan provisioida ja käyttäjän voimassaoloa muuttaa AD:ssa. |
LDAP userBase |
[Teksti] |
Määritä käyttäjien perusta. Esimerkki: CN=Users,DC=adtest,DC=local Huomio! Kun provisiointitehtävän määrityksessä on asetettu “Read OU path from the datacard”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP group-/userbase), jossa voit määrittää, mistä attribuutista tämä tieto luetaan. |
LDAP userFilter |
[Teksti] |
Määritä käyttäjien suodatin. Esimerkki: (objectClass=user) Huomio! Kun provisiointitehtävän määrityksessä on asetettu “Read OU path from the datacard”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP group-/userbase), jossa voit määrittää, mistä attribuutista tämä tieto luetaan. |
LDAP groupBase |
[Teksti] |
Määritä ryhmien perusta. Esimerkki: CN=Group,DC=adtest,DC=local Huomio! Kun provisiointitehtävän määrityksessä on asetettu “Read OU path from the datacard”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP group-/userbase), jossa voit määrittää, mistä attribuutista tämä tieto luetaan. |
LDAP groupFilter |
[Teksti] |
Määritä ryhmien suodatin. Esimerkki: (objectClass=group) Huomio! Kun provisiointitehtävän määrityksessä on asetettu “Read OU path from the datacard”, orkestrointitoiminnot näyttävät lisäominaisuuden (LDAP group-/userbase), jossa voit määrittää, mistä attribuutista tämä tieto luetaan. |
Valinnaiset provisiointitehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
LDAP ignoredOusForUsers |
[Teksti] |
Määritä <OU>-elementit, jotka jätetään huomiotta käyttäjiä etsittäessä. Käyttäjä jätetään huomiotta, jos se sijaitsee suoraan jossakin määritetyistä <OU>-elementeistä tai jonkin niistä alipuussa. Esimerkki: OU=Sales,DC=adtest,DC=local |
LDAP ignoredOusForGroups |
[Teksti] |
Määritä <OU>-elementit, jotka jätetään huomiotta ryhmiä etsittäessä. Ryhmä jätetään huomiotta, jos se sijaitsee suoraan jossakin määritetyistä <OU>-elementeistä tai jonkin niistä alipuussa. Esimerkki: OU=Finance,DC=adtest,DC=local |
Käyttäjän oletusasetukset | ||
Nimi |
Arvo |
Kuvaus |
Ensimmäisen kirjautumisen salasana |
[Teksti] / [työnkulku / malli] |
Tämä vaihtoehto näkyy, kun Provisiointityyppi on määritetty muotoon “Event-based provisioning”. Tätä salasanaa käytetään, kun “New user creation” -toiminto otetaan käyttöön. Ylläpitäjät voivat halutessaan määrittää oletussalasanan, jota käytetään uusien käyttäjien ensimmäisenä kirjautumissalasanana valitussa käyttäjätietovarastossa. Toinen vaihtoehto on generoida satunnainen salasana työnkulussa / mallissa. |
Identity Attribute Mapping
Provisiointitehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttäjän identiteettitiedot kustakin Active Directorystä. Nämä tiedot on kartoitettava Efecte Service Management Toolin tietorakenteisiin.
Yllä olevassa kuvassa Identity Attribute Mappings kuvaa, miten kohteet ja attribuutit kartoitetaan Efecte Service Management Toolin ja kohteena olevan Active Directoryn välillä. Identity Attribute Mapping määrittää Active Directoryn käyttäjäobjektin attribuutit ja käyttäjän attribuutit, jotka kartoitetaan. Käyttöliittymän vasen sarake (yllä olevassa kuvassa) osoittaa kentät, jotka Provisioning Engine poimii Active Directorysta. Käyttöliittymän oikea sarake osoittaa ESM:n kansion/mallin/attribuutin, johon Active Directorysta poimittu kenttä lisätään/päivitetään. Kun on tarpeen hakea AD-attribuutti, jolla on useampi kuin yksi arvo, kuten 'memberOf', se on kartoitettava myös ESM:n mallin monella arvolla varustettuun attribuuttiin
Pakolliset ominaisuudet näytetään heti, kun näkymä avataan. Valinnaisia ominaisuuksia voi lisätä add property -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 arvon voi valita pudotusvalikosta tai valintapainikkeella.
Ominaisuuden voi poistaa napsauttamalla poistokuvaketta (x) ominaisuuden oikealla puolella. Manuaalisesti lisätyt ominaisuuksien nimet ja arvot ovat kirjainkokoherkkiä ja niiden on oltava tarkkoja. Asetusten nimet on esimerkiksi kirjoitettava täsmälleen ohjetekstissä ilmoitetulla tavalla.
Huomautus:
EPE-version 2021.1 alkaen voit määrittää luettelon käyttäjien poissuljetuista DN:istä, kun tietoja viedään ESM:ään. Tämä parannus mahdollistaa tiettyjen käyttäjien sulkemisen pois ESM-viennistä.
Access Rights Mapping
Efecte Provisioning Enginessä käyttöoikeudet ilmaistaan tyypillisesti LDAP-ryhminä, AD:ssa tyypillisesti joko suojaus- tai jakeluryhmänä. Provisiointitehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttöoikeudet kustakin Active Directorystä. Nämä tiedot on kartoitettava Efecte Service Management Toolin tietorakenteisiin. Access Rights Mapping määrittää provisiointimoottorin tehtävätyypille ominaiset asetukset.
“Target template code”- ja “Folder code”-ominaisuudet näytetään heti, kun näkymä avataan; myös kartoitukset ainakin distinguishedNamelle, objectGUID:lle ja datasourceidille ovat pakollisia, ja nämä kolme kenttää näytetään automaattisesti. Valinnaisia ominaisuuksia voi lisätä add property -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 arvon voi valita pudotusvalikosta tai valintapainikkeella. Kun on tarpeen hakea AD-attribuutti, jolla on useampi kuin yksi arvo, kuten 'memberOf', se on kartoitettava myös ESM:n mallin monella arvolla varustettuun attribuuttiin
EPE-version 2021.1 alkaen voit määrittää luettelon ryhmien poissuljetuista DN:istä, kun tietoja viedään ESM:ään. Tämä parannus mahdollistaa tiettyjen ryhmien sulkemisen pois ESM-viennistä.
Efecte Provisioning Engine tukee useita eri LDAP-hakemistoja, jotka tukevat LDAP-käyttöliittymää. Määritysnäkymässä ominaisuuksien nimet vaihtelevat valitun hakemiston mukaan. Vaaditut identiteetti- tai käyttöoikeuskartoitukset saattavat vaihdella valitun hakemiston mukaan.
Provisiointitehtävän määritys Azure AD:lle
Azure AD -provisiointitehtävän määritysnäkymä:
Yleiset provisiointitehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Provisiointityyppi |
[Scheduled-based provisioning, Event-based provisioning, Authentication] |
Provisiointityyppi voidaan luokitella tarpeen mukaan. Muut provisiointitehtävän ominaisuudet näytetään valitun tyypin mukaan.
Huomautus. Jotkin uuteen todennuskomponenttiin liittyvät määritykset saattavat näkyä joissakin hallintakäyttöliittymän osissa. Näillä muutoksilla ei ole vaikutusta olemassa oleviin asiakasympäristöihin. |
Kartoitustyyppi |
[Identity & Access Rights] |
Lisää molempien kartoitusten osiot. |
Nimi |
[Teksti] |
Provisiointitehtävän nimi. |
WebAPI-käyttäjä |
[WebAPI-käyttäjän valinta] |
WebAPI-käyttäjä, jota käytetään EPE:n ja ESM:n väliseen viestintään. |
WebAPI-salasana |
[Teksti] |
WebAPI-käyttäjän salasana. Pakollinen kenttä, joka on täytettävä provisioinnin toimimiseksi. |
Azure AD -provisiointitehtävän ominaisuudet | ||
Nimi |
Arvo |
Kuvaus |
Azure uniqueIdentifierId |
[Teksti] |
Jokaisella tuontiprosessilla on yksilöllinen prosessitunnus Azure uniqueIdentifierId, jota käytetään avaimena provisiointimoottorin masterissa erottamaan tämä prosessi muista tuontiprosesseista provisiointimoottorin masterissa. Tunniste tarvitaan, jotta myöhemmät muutokset tai poistot kohdistuvat oikeaan kohteeseen. |
Application (client) ID |
[Merkkijono] |
Määrittää palvelun päämiehen (service principal) sovellustunnuksen. |
Directory (tenant) ID |
[Merkkijono] |
Määrittää vuokraajan (tenant) tunnuksen. Käytä osoitetta https://login.microsoftonline.com/<tenant-id> ja korvaa <tenant-id> sovelluksen rekisteröinnin Directory (tenant) ID-arvolla. |
Login URL |
[Teksti] |
Määrittää App Service -sovelluksesi URL-osoitteen. |
Graph API URL |
[Teksti] |
Määrittää App Service -sovelluksesi Graph App Service -sovelluksesi URL-osoite. |
Azure AD -parametrit käyttäjille ja ryhmille | ||
Nimi |
Arvo |
Kuvaus |
Käyttäjien tuontiparametri |
[Teksti] |
Määritä käyttäjien suodatin. Esimerkki suodattimesta: $filter=startswith(givenName%2C) |
Ryhmien tuontiparametri |
[Teksti] |
Määritä ryhmien suodatin. Esimerkki suodattimesta: $filter=startswith(displayName%2C) |
Efecte Provisioning Engine käyttää Microsoft Graph API:a yhdistääkseen Microsoft Azure AD:hen. Jos on tarpeen hakea vain osa käyttäjistä Azure AD:sta, se onnistuu suodattimilla. Linkki lisätietoihin 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 |
Todennustapa |
[Secret / Certificate] |
Asiakassovelluksen salaisuus (Client Secret), joko salasana tai julkisen/yksityisen avaimen pari (varmenne). |
Salaisuuden arvo |
[teksti] |
Tämä arvo vaaditaan, kun Todennustapa: “Secret” on valittu. Käytä sovelluksen rekisteröinnissä luotua asiakassovelluksen salaisuutta. |
Julkisen avaimen alias |
[teksti] |
Tämä arvo vaaditaan, kun Todennustapa: “Certificate” on valittu. Anna tähän arvoon julkisen avaimen alias. |
Yksityisen avaimen alias |
[teksti] |
Tämä arvo vaaditaan, kun Todennustapa: “Certificate” on valittu. Anna tähän arvoon yksityisen avaimen alias. |
Yksityisen avaimen salasana |
[teksti] |
Tämä arvo vaaditaan, kun Todennustapa: “Certificate” on valittu. Anna tähän arvoon yksityisen avaimen salasana. |
Identity Attribute Mapping Azure AD:lle
Provisiointitehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttäjän identiteettitiedot kustakin Azure Active Directorystä. Nämä tiedot on kartoitettava Efecte Service Management Toolin tietorakenteisiin.
Yllä olevassa kuvassa Identity Attribute Mappings kuvaa, miten kohteet ja attribuutit kartoitetaan Efecte Service Management Toolin ja kohteena olevan Azure AD:n välillä. Identity Attribute Mapping määrittää Azure AD:n käyttäjä- tai ryhmäobjektin attribuutit ja käyttäjän tai roolin attribuutit, jotka kartoitetaan. Käyttöliittymän vasen sarake (yllä olevassa kuvassa) osoittaa kentät, jotka Provisioning Engine poimii Azure AD:sta. Käyttöliittymän oikea sarake osoittaa ESM:n kansion/mallin/attribuutin, johon Azure AD:sta poimittu kenttä lisätään/päivitetään.
Pakolliset ominaisuudet näytetään heti, kun näkymä avataan. Valinnaisia ominaisuuksia voi lisätä add property -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 arvon voi valita pudotusvalikosta tai valintapainikkeella.
Ominaisuuden voi poistaa napsauttamalla poistokuvaketta (x) ominaisuuden oikealla puolella. Manuaalisesti lisätyt ominaisuuksien nimet ja arvot ovat kirjainkokoherkkiä ja niiden on oltava tarkkoja. Asetusten nimet on esimerkiksi kirjoitettava täsmälleen ohjetekstissä ilmoitetulla tavalla.
Huomautus:
EPE-version 2021.1 alkaen voit määrittää luettelon käyttäjien poissuljetuista ID:istä, kun tietoja viedään ESM:ään. Tämä parannus mahdollistaa tiettyjen käyttäjien sulkemisen pois ESM-viennistä.
Access Rights Mapping Azure AD:lle
Efecte Provisioning Enginessä käyttöoikeudet ilmaistaan tyypillisesti Azure AD -ryhminä, Azuressa tyypillisesti joko suojausryhmänä tai Office 365 (O365) -ryhmänä. Suojausryhmiä käytetään käyttäjien pääsyn hallintaan sovelluksen sisäisiin resursseihin, ja O365-ryhmiä käyttäjien yhteistyön helpottamiseen jaetuissa Microsoftin verkkoresursseissa. Provisiointitehtävän tuloksena Efecte Service Management Tool vastaanottaa käyttöoikeudet kustakin Azure AD:sta. Nämä tiedot on kartoitettava Efecte Service Management Toolin tietorakenteisiin. Access Rights Mapping määrittää provisiointimoottorin tehtävätyypille ominaiset asetukset.
“Target template code”- ja “Folder code”-ominaisuudet näytetään heti, kun näkymä avataan; myös kartoitukset ainakin id:lle ja datasourceidille ovat pakollisia, ja nämä kolme kenttää näytetään automaattisesti. Valinnaisia ominaisuuksia voi lisätä add property -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 arvon voi valita pudotusvalikosta tai valintapainikkeella.
Huomautus:
EPE-version 2021.1 alkaen voit määrittää luettelon ryhmien poissuljetuista ID:istä, kun tietoja viedään ESM:ään. Tämä parannus mahdollistaa tiettyjen ryhmien sulkemisen pois ESM-viennistä.
Provisiointitehtävän tilatiedot
Ylläpitäjillä on näkyvyys Extract- ja Load-tilaan kaikissa tuetuissa käyttäjätietovaraston provisiointitehtävissä. Tarvittaessa ylläpitäjät voivat myös ladata käyttäjä- ja ryhmätiedostoja lisätietojen tarkastelua varten. Extract-tila kertoo, miten tiedot haettiin lähteestä, ja Load-tila kertoo, miten EPE onnistui lataamaan tiedot ESM:ään. Extract-/Load-tilan taulukoita ei päivitetä reaaliajassa; tarvittaessa käyttäjä voi napsauttaa 'Update'-painiketta sivun ylätunnisteessa. Tämä sivu päivittyy myös, kun se avataan uudelleen.
Provisiointitehtävien tuonti / vienti
Efecte Provisioning -version 2021.1 alkaen tarjoamme mahdollisuuden tuoda / viedä provisiointitehtäviä. Tämä mahdollistaa olemassa olevien provisiointitehtävien viemisen. On mahdollista valita, mitkä olemassa olevista provisiointitehtävistä viedään.
Import / Export -painikkeet näytetään Scheduled tasks -näkymän vasemmalla puolella.
Kun käyttäjä napsauttaa “Export”-painiketta, hänelle näytetään kaikki mahdolliset tehtävät, joista hän voi valita haluamansa tehtävät joustavasti.
Kun käyttäjä napsauttaa “Ok”-painiketta, provisiointitehtävät viedään XML-tiedostoon. Viety XML-tiedosto voidaan sitten käyttää provisiointitehtä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”, “TaskName”, ja jos aiot tuoda ne olemassa olevaan ympäristöön, on suositeltavaa muuttaa niitä tuonnin aikaisten virheiden välttämiseksi.
Table of Contents