Palvelupyyntöjen luominen ESS:stä ESM:ään

Jotta Efecte Self-Service pystyy luomaan uusia palvelupyyntöjä tai hakemaan niitä oikein, seuraavien attribuuttien ja attribuuttikoodien on oltava olemassa ja niillä on oltava arvo:

• Efecte efecte_id
• statusAttribute - status
• requestedForEmailAttribute – RequestedFor
• serviceItemExternalIdAttribute – ServiceItem. Jos tämän attribuutin arvo on tyhjä, ESS käyttää arvoa, joka on määritetty kohdassa defaultIntegrationServiceItemId ESS:n Efecte Service Management -liittimessä.

Jos mikä tahansa yllä luetelluista pakollisista kentistä on tyhjä, palvelupyyntöä ei luoda.

Palvelupyyntöjen käsittelyä koskevat yksityiskohtaiset säännöt ovat seuraavat:

• WebShopId - jos tämä on annettu, suoritetaan olemassa olevan palvelupyynnön päivitys
• efecte_id - jos WebShopId on tyhjä eikä ESS:ssä ole pyyntöä annetulla efecte_id-arvolla, luodaan uusi palvelupyyntö. Jos ESS:ssä on jo pyyntö kyseisellä efecte_id-arvolla, olemassa oleva pyyntö päivitetään
• RequestedFor - ESS:n organisaatiotiedoissa on oltava käyttäjä, jonka sähköpostiosoite vastaa arvoa. Jos näin ei ole, palvelupyyntöä ei luoda.
• OrderedBy - organisaatiotiedoissa on oltava käyttäjä, jonka sähköpostiosoite vastaa arvoa. Jos näin ei ole, palvelupyyntöä ei luoda. Jos kentän arvo on tyhjä, käytetään sen sijaan RequestedFor-sähköpostiosoitetta
• ServiceItem - täysin samalla Item ID -tunnuksella olevan palvelunimikkeen on oltava olemassa ja voimassa (tarkistukset tehdään myös Efecte Self Servicen työkopiota vasten). Jos tämä ehto ei täyty, palvelupyyntöä ei luoda ESS:ssä
• ServiceOffering- jos tämä on asetettu, palvelupyyntö luodaan annetulla nimellä. Jos attribuuttia ei ole asetettu, palvelutarjouksen nimi kopioidaan ESS:ssä ServiceItemin perusteella löydetystä palvelutarjouksesta
• ServiceItemName - jos tämä on asetettu, palvelupyyntö luodaan kyseisellä nimellä. Jos attribuuttia ei ole asetettu, palvelun nimi kopioidaan ESS:ssä ServiceItemin perusteella löydetystä palvelunimikkeestä
• Price / MonthlySubscription - jos nämä on asetettu, palvelupyyntö luodaan vastaavilla tiedoilla. Jos attribuutteja ei ole asetettu, ne kopioidaan ServiceItemin perusteella löydetystä palvelunimikkeestä
• AdditionalInformation - jos lisätietoattribuutin arvo alkaa merkkijonolla "Description:", liitin ottaa käyttöön "Description:"-osan jälkeisen tekstin rivin loppuun asti. Jos lisätietokenttä ei ala "Description:"-etuliitteellä, koko attribuutin arvon sisältö käsitellään

Tietämyskannan artikkeleiden arvostelujen vastaanottaminen ESS:stä ESM:ään

Käyttäjät voivat arvostella tietämyskannan artikkeleita ESS:ssä, jos ominaisuus on otettu käyttöön ESS:ssä. Jotta tietämyskannan artikkeleiden arvostelu voidaan ottaa käyttöön ESM:ssä, seuraavat vaiheet on suoritettava:

• Lisää attribuutti "Rating" tietämyskannan artikkelin malliin
• Aseta attribuutille AverageHandler.
• Metatietoja ei tarvita, mutta halutessasi voit asettaa ProgressBar-enimmäisarvoksi: 1 ja Progress Bar -tilaksi: value. Nämä asetukset näyttävät arvon edistymispalkkina.
• Datatyyppi: Decimal number. (Käsittelijän asettaminen muuttaa datatyypin automaattisesti käsittelijän mukaan)
• Aseta näkyvyydeksi: Show in view only
• Tallenna attribuutti
• Siirry luokkaan, jossa attribuutti sijaitsee
• Varmista, että attribuutilla on koodi (annetaan yleensä automaattisesti)
• Määritä attribuutin käyttöoikeudet
• Varmista, että ESS:n määrityksissä arvostelu on kytketty tähän attribuuttiin
• Luo näkymiä, jotka käyttävät Rating-attribuuttia tietämyskannan artikkeleiden keskiarvoarvostelujen näyttämiseen

Palveluilmoitusten julkaiseminen ESM:stä ESS:ään

Ilmoitusten julkaiseminen ESM:stä ESS:ään on toteutettu seuraavien ominaisuuksien avulla:

• Kuuntelijat (listeners), jotka lähettävät ilmoituksia ESM:stä ESS:ään SendDataCardXmlToHttpAction-toiminnolla
• Kuuntelija, joka asettaa ilmoituksen vanhenemaan
• Tapahtuma, joka käynnistää tietokortin tallennuksen, kun ilmoituksen voimassaolo on päättynyt. Tietokortin tallennus käynnistää edellä mainitun kuuntelijan.

Palveluilmoitusten käyttöönotto olemassa olevassa ESM-ESS-ympäristössä

Määrityspaketin tuominen

Saatavilla on määrityspaketti (efecte-configuration_ESS_ANNOUNCEMENTS.xml), joka sisältää Service Announcement -mallin ja suurimman osan määrityksistä. Myös alla mainitut tiedostot ovat saatavilla erillisinä tiedostoina. Määrityspaketin tuominen asettaa suurimman osan asetuksista automaattisesti ja vähentää alla olevien vaiheiden tekemiseen tarvittavaa työtä. Tuo määrityspaketti Maintenance-näkymän Import configurations -toiminnolla.

Paketti sisältää:

• Service Announcement -mallin.
• Kuuntelijat.
• Valmiiksi täytetyt Platform-asetukset, joita on muokattava tuonnin jälkeen.
• Viestijonotehtävän (message queue task).
• Tapahtuman, joka käynnistää ilmoituksen vanhenemisen.

Jos tuot paketin, voit ohittaa seuraavat osat:

• Service Announcement -mallin ja kuuntelijoiden tuominen.
• Yhden tapahtuman määrittäminen Self-Service Announcement -malliin.
• Osa MessageQueue-tehtävän määrityksistä. Ajastusasetukset on silti asetettava.

Onnistuneen määritystuonnin jälkeen sinun pitäisi saada seuraava raportti:

Malleja luotu: 1
Tietokorttikuuntelijoita luotu: 3
Kansioita luotu: 0
Rooleja luotu: 0
Käyttäjiä luotu: 0
Raportteja luotu: 0
Dashboardeja luotu: 0
Ajastettavia tehtäviä luotu: 1
Mallitapahtumia luotu: 1
Käyttöoikeuksia luotu: 0
Platform-asetuksia luotu: 3
Asetteluja luotu: 0

Voit käyttää seuraavia osioita varmistaaksesi, että kaikki määritykset ovat oikein, ja täyttääksesi osat, jotka on määritettävä manuaalisesti määritystuonnin jälkeen.

Service Announcement -mallin ja kuuntelijoiden tuominen

• Tuo Service Announcement -malli ESM:ään mallien tuontitoiminnolla.
• ESM_Template_ESS_Announcement_2015_4.xml
• Tarkista mallin käyttöoikeudet ja valitse, millä rooleilla on pääsy malliin.
• Luo kansio "Service announcements", johon mallin tietokortteja voidaan luoda. Salli Service Announcement -tietokorttien luominen tähän kansioon.
• Tuo nämä kuuntelijat Self-Service Announcement -malliin:
  • Ensimmäinen asettaa apuarvon last action: 1_presave.set_Last_Action_For_ESS_Announcement.xml
  • Toinen lähettää ilmoituksen ESS:ään: 2_postsave.1.POST_ESS_Announcement_To_ESS.xml
  • Kolmas poistaa ilmoituksen ESS:stä: 3_postsave.2.DELETE_ESS_Announcement_From_ESS.xml

ESS API-tokenin lisääminen ESM:n platform-asetuksiin

• Jos ympäristösi on pilvessä, ota yhteyttä osoitteeseen servicedesk@efecte.com Efecte Service Desk, niin he voivat toimittaa sinulle ESS API-tokenin, jota tarvitaan ESM-ESS-viestinnässä.
• Jos ympäristösi on on-premise, siirry ESS:n global admin -osioon ja luo API-token siellä.
• Luo uusi platform-asetus "ess.token".
• Aseta tämän asetuksen arvoksi kopioimalla ja liittämällä API-token siihen.
• Asetuksen nimen voi määrittää itse, mutta oletuskuuntelijassa asetuksen nimi on 'ess.token'. Jos muutat nimeä, päivitä sekä platform-asetus että kuuntelija.

ESS-vuokraaja-asetusten (Tenant) lisääminen platform-asetuksiin

• Luo uusi platform-asetus "ess.tenant".
• Aseta ESS-vuokraajasi (Tenant) nimi tämän asetuksen arvoksi, esim. mycompany.

ESS-URL-osoitteen lisääminen platform-asetuksiin

• Luo uusi platform-asetus 'ess.announcement.url'.
• On-premise-ympäristössä: Aseta ESS-URL-osoitteesi tämän asetuksen arvoksi, esim. https://mycompany.testefecte.com:55443/announcement
• Pilviympäristössä: Aseta ESS-URL-osoitteesi tämän asetuksen arvoksi, esim. https://mycompany.efectecloud-dev.com/api/ssc/announcement
• Portti ja palvelun nimi /announcement pysyvät samoina kaikissa ESS-ympäristöissä.
• Asetuksen nimen voi määrittää itse, mutta oletuskuuntelijassa asetuksen nimi on 'ess.announcement.url'. Jos muutat nimeä, päivitä sekä platform-asetus että kuuntelija.

Ilmoitusten käyttöönotto ESS:stä

• Aseta 'Announcements enabled' ESS:n vuokraajan (tenant) hallinnassa - Settings

Yhden tapahtuman määrittäminen Self-Service Announcement -malliin

Ajastettavien tehtävien tarkistaminen ja määrittäminen

• EventTask on määritettävä käynnistämään tapahtuma. Useimmissa ympäristöissä tämä on jo olemassa, eikä muutoksia tarvita.
• MessageQueueTask on määritettävä siivoamaan ja käsittelemään jonossa oleva kohde uudelleen. Sen suorittaminen 5 minuutin välein on oletusasetus.
  
  

Verkkoasetusten tarkistaminen ja määrittäminen

Varmista, että ilmoitusportti on käytettävissä eivätkä palomuurit tms. estä yhteyksiä ESM:stä ESS-ympäristöön.