Efecte Service Management -liitin pähkinänkuoressa

Tämän liittimen avulla Efecte Self Service voi

• Luo uusia tapauksia ja palvelupyyntöjä Efecte Service Managementissa
• Kysely päivittyy, kun Efecte Service Managementin tapauksia ja palvelupyyntöjä muutetaan (esimerkiksi kun pyynnön tila muuttuu)
• Kysele ja lähetä arviointitietoja tietokannan artikkeleista, jotka liittyvät Vinkkejä ja niksejä -osioon
• Kysele ja lähetä arvostelutietoja ja kommentteja uusista ideoista Tykkää ideastani -toiminnon kautta
• Dynaamisen käyttäjädatan kysely Efecte Service Managementista (MyServices)
• Kyselytiedot palvelutarjoustietojen ylläpitämiseksi datatasolla (luettelon nimikkeet)
• Lähetä hyväksymispäätökset visuaalisten työnkulkujen hyväksynnöille Efecte Service Managementissa
• Lähetä loppukäyttäjiltä kerätty palaute Efecte Service Managementille

Suurin osa yhdistimen toiminnoista toimii automaattisesti käyttäen oletusarvoja, joihin viitataan kaikkialla tässä asiakirjassa.

Tässä artikkelissa kuvataan Efecte Service Management Connectorin toimintaa ESS-versiossa 2022.3 tai uudemmissa.

Tuetut mallit

Efecte-liittimessä on valmiina kaksi tuettua mallipohjaa: palvelupyyntö (ServiceRequest) ja tapahtuma (Incident). Jos on tarpeen tukea useita mallipohjia, vuokralaiselle voidaan ottaa käyttöön useita ESM-liittimiä, ja pyyntöjen kohde voi poiketa oletusarvoisesta. Tässä tapauksessa vain yksi liittimistä voi sisältää tietokannan, ja kuten ideani konfiguroinnissa, jos jompaakumpaa liittimistä on konfiguroitu useita, artikkelien näyttämiseen kotisivulla käytetään Efecte Self-Serviceen viimeksi noudettua tulosjoukkoa. Tämä voi johtaa hämmentävään käyttökokemukseen, erityisesti osoittimien kanssa eri ESM:n lähteisiin.

Toisaalta yhden mallin käyttö voi olla kiinnostavaa. Oikein määritetyllä tavalla kaikki pyynnöt voidaan ohjata haluttuun malliin. Kiinnitä kuitenkin huomiota attribuuttikoodeihin ja tila-arvoihin sekä keinoihin erottaa eri pyyntötyypit toisistaan, jotta vältetään ylimääräisten lokien syntyminen yhteensopimattomien määritysten vuoksi.

ESM-viestin muoto

ESS- ja ESM-tuotteiden välillä vaihdettujen viestien muoto on kiinteästi koodattu.

Huomautus: MyService-ominaisuuden moniarvoiset kentät välitetään CSV-muodossa XML-tagien sisällä.

Yhteyskonfiguraatio

ESM-yhteyden konfigurointiin käytä com.efecte.integration.connector.configuration.ConnectionConfiguration-luokan bean-komponenttia seuraavan esimerkin mukaisesti:

<bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration"> 
<property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
<property name="user" value="webapi-user" />
<property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
<property name="connectionRequestTimeout" value="300" />
<property name="connectTimeout" value="300" />
<property name="socketTimeout" value="300" />
<property name="acceptSelfSignedCertificates" value="false"/>
<property name="allowAllHostnamesInCertificate" value="false"/>
   </bean>

Huom! Kun käytetään useita liittimiä ja jotkut niistä viittaavat eri yhteyskonfiguraatioihin (kuten eri ympäristöihin), niillä tulisi olla yksilöllinen tunniste yhteyskonfiguraatiota kohden. Toisin sanoen varmista, ettei sinulla ole samaa bean-tunnusta kahdelle eri yhteyskonfiguraatiolle. Tämä määritys koskee yhteyden muodostamista kahteen eri ESM-ympäristöön yhdestä ESS:stä, joten voi olla hyvä idea ilmoittaa ympäristö bean-tunnuksessa, esim.

paputunnus="yhteyskonfiguraatioympäristönNimi"

Tämä papu tukee seuraavia ominaisuuksia:

Palvelupyynnön määritys

Palvelupyyntöjen määritteiden yhdistämismääritykset voidaan määrittää connector-efecte.xml-tiedostossa. Esimerkkikokoonpano kaikista käytettävissä olevista vaihtoehdoista:

<bean id="connectorEfecte"
 class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="serviceRequestAttributes">
<bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
<property name="templateCode" value="ServiceRequest"/>
<property name="bundleTemplateCode" value="ServiceRequestBundle"/>
<property name="folderCode" value="ServiceRequests"/>
<property name="attachmentAttribute" value="RequestAttachments"/>
<property name="statusAttribute" value="status"/>
<property name="reopenReasonAttribute" value="reopen_reason"/> 
<property name="creationDateAttribute" value="created"/>
<property name="deadlineAttribute" value="deadline"/>
<property name="updatedAttribute" value="updated"/>
<property name="efecteIdAttribute" value="efecte_id"/>
<property name="languageAttribute" value="Language"/>
<property name="feedbackAttribute" value="rating"/>
<property name="resolutionTextAttribute" value="resolution"/>
<property name="supportPersonAttribute" value="support_person"/>
<property name="serviceOfferingNameAttribute" value="ServiceOffering"/>
<property name="serviceItemNameAttribute" value="ServiceItemName"/>
<property name="serviceItemExternalIdAttribute" value="ServiceItem"/>
<property name="priceAttribute" value="Price"/>
<property name="monthlySubscriptionAttribute" value="MonthlySubscription"/>
<property name="requestedForAttribute" value="RequestedFor"/>
<property name="costCenterAttribute" value="CostCenter"/>
<property name="deliveryAddressAttribute" value="DeliveryAddress"/>
<property name="orderedByAttribute" value="OrderedBy"/>
<property name="additionalInformationAttribute" value="AdditionalInformation"/>
<property name="siteIDAttribute" value="SiteID"/>
<property name="siteNameAttribute" value="SiteName"/>
<property name="requestBundleAttribute" value="RequestBundle"/>
<property name="requestBundleNameAttribute" value="RequestBundleName"/>
<property name="orderedByEmailAttribute" value="OrderedBy:email"/>
<property name="requestedForEmailAttribute" value="RequestedFor:email"/>
<property name="commentAttribute" value="external_comments"/>
<property name="reasonAttribute" value="user_reason"/>
<property name="dedicatedApproverAttribute" value="DedicatedApprover"/>
<property name="superiorApproverAttribute" value="approving_manager"/>
<property name="totalPriceAttribute" value="totalPrice"/>
 <property name="quantityAttribute" value="quantity"/>
 <property name="totalMonthlySubscriptionAttribute"value="TotalMonthlySubscription"/>
  <property name="punchout" value="punchOutOrderId"/>
</bean>
 </property>
 <!-- other configuration -->
</bean> 

Tapahtumien yhdistämismäärityksiä voidaan muokata vuokraajan järjestelmänvalvojan käyttöliittymässä tukikanavan määritysvälilehdellä. Uuden tukikanavan luomisen jälkeen oletusarvot näkyvät määrityksissä.

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

Jos palvelutarjoukselle on valittu ”Tuotemäärä käytössä”, palvelupyynnölle käsitellään seuraavat lisäsäännöt:

Huomautus! Yllä luetellut ominaisuudet ovat oletusarvoja. Jos näitä on muutettava, vastaavat koodit on lisättävä liitintiedostoon.

PunchOut-toiminto mahdollistaa Efecte Self Service -käyttäjille ulkoisen verkkokaupan käytön tuotteiden keräämiseen palvelupyyntöönsä. PunchOut-toimintoa varten liittimessä tarvitaan seuraavat määritteet. Lisätietoja on PunchOut- uid .

Seurantaliitin

Seurantaliitin käynnistää kyselyn Efecte Service Managementin päivityksistä sekä tapahtumien että palvelupyyntöjen osalta. ESM:stä ESS:ään tulevien tapahtumien oletusverkkotunnusten yhdistämismääritys ja palvelupyyntöjen palvelukohteiden yhdistämismääritys voidaan määrittää asettamalla seuraavat EfecteTrackingConnector-paanin ominaisuudet:

Huomautus! Oletusarvoisesti kysely koskee tapauksia, ei palvelupyyntöjä. Palvelupyyntöjen kyselyä varten Efecte Tracking Connector on lisättävä liitintiedostoon.

Jotta uusien palvelupyyntöjen kysely toimisi oikein, seuraavat määritteet ovat pakollisia ESM-puolella:

• Pyynnön tunniste välitetään efecteIdAttribute-attribuutissa, oletusarvo 'efecte_id'
• StatusAttribute.default 'status' -muuttujassa välitetty tila
• Asiakkaan tunniste välitetään requestedForEmailAttribute-määritteessä oletusarvoisesti 'RequestedFor:email'.
• Kohteen tunnus välitetään serviceItemExternalIdAttribute-attribuutissa, oletusarvo 'ServiceItem' - jos tämän attribuutin arvo on tyhjä, liitin ottaa arvon seurantaliittimen konfiguraatiossa olevasta defaultIntegrationServiceItemId-attribuutista.

Jotta uusien tapahtumien kysely toimisi oikein, seuraavat ominaisuudet ovat pakollisia ESM-puolella:

• Tapahtuman tunniste välitetään efecteIdAttribute-attribuutissa, oletusarvo 'efecte_id'
• StatusAttribute.default 'status' -muuttujassa välitetty tila
• Asiakkaan tunniste välitetään asiakkaan sähköpostiosoitteen attribuutissa, oletusarvoinen customer:email
• IntegrationCategoryAttribute-ominaisuudessa välitetty kategorian tunnus, oletusarvoinen WebShopCategory - jos tämän attribuutin arvo on tyhjä, liitin ottaa arvon seurantaliittimen konfiguraatiossa olevasta defaultIntegrationCategoryId-arvosta (Kategoria, jolla on kategorian tunnus, on julkaistava ESS:ssä)

Kyselytiheyttä voidaan säätää 'EfecteTrackingConnector'-luokan 'updateFrequency'- ja 'errorUpdateFrequency'-ominaisuuksilla. Arvot ilmaistaan konfiguroitavissa yksiköissä.

Huom! 'updateQuerySlidingWindowTime'-arvoa tarvitsee muuttaa oletusarvosta hyvin harvoin. Kyselytiedot sisältävät aina kaikki datakortit, jotka on muutettu tietyn ajanjakson sisällä, ja pidemmällä ajanjaksolla samat tiketit palautetaan tulosjoukkoon yhä uudelleen. Tiketti päivitetään ESS:ssä jo ensimmäisellä kerralla. Tämän ikkunan leventäminen voi hidastaa sekä ESS:n että ESM:n toimintaa ilman lisähyötyä.

Kun liitin suoritetaan ensimmäistä kertaa, se hakee pyyntöjä ja tapahtumia viimeisen 24 tunnin ajalta. Tätä aikaa voidaan säätää määrittämällä ominaisuudet initialQuerySlidingWindowTime ja initialQuerySlidingWindowUnit.

Muita Efecte-seurantaliittimen oletusarvoja ovat:

Konfiguraatiosesimerkki:

<property name="efecteTrackingConnector">
     <bean class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
         <property name="updateQuerySlidingWindowTime" value="20"/>
         <property name="updateQuerySlidingWindowUnit" value="MINUTES"/>
         <property name="initialQuerySlidingWindowTime" value="1"/>
         <property name="initialQuerySlidingWindowUnit" value="DAYS"/>
         <property name="updateFrequency" value="10" />
         <property name="updateFrequencyUnit" value="MINUTES" />
         <property name="errorUpdateFrequency" value="10" />
         <property name="errorUpdateFrequencyUnit" value="MINUTES" />
         <property name="defaultIntegrationServiceItemId" value="DEFAULT_SERVICE_ITEM" />
         <property name="pollNewServiceRequestEnabled" value="false" />
         <property name="defaultIntegrationCategoryId" value="DEFAULT_EFECTE_CATEGORY"/>
         <property name="serviceRequestPollCondition" value="and $creator$ = 'WebAPI'"/>
         <property name="incidentPollCondition" value="and $creator$ = 'WebAPI'"/>
         <property name="pollNewIncidentEnabled" value="true" />
      </bean>
</property>

Jos 'updateQuerySlidingWindowTime'-ominaisuutta ei ole määritetty seurantaliittimessä, oletusarvoisena liukuvan ikkunan kokona käytetään 'pollingInterval'-arvoa kerrottuna kahdella (2).

Palautelomake

Palautelomaketta tuetaan oletusarvoisesti ESM-liittimessä. ESM-kenttien yhdistämiseen käytettävät ominaisuudet voidaan määrittää muuttamalla bean EfecteFeedbackFormConnector -luokan ominaisuuksia ja itse lomakkeessa järjestelmänvalvojan käyttöliittymän Palautteen hallinta -välilehden kautta. Seuraavia ominaisuuksia tuetaan:

Esimerkki EfecteFeedbackFormConnectorin konfiguroinnista EfecteConnectorin sisällä connector-efecte.xml-tiedostossa:

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
<property name="connectionConfiguration" ref="connectionConfiguration" />
<property name="feedbackFormConnector">
<bean class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
<property name="feedbackAttributes">
<bean class="com.efecte.integration.connector.configuration.FeedbackAttributes">
<property name="templateCode" value="feedback_management" />
<property name="folderCode" value="feedback" />
<property name="efecteIdAttribute" value="ticket_id" />
<property name="customerAttribute" value="customer" />
<property name="ratingAttribute" value="ticket_rating" />
</bean>
</property>
</bean>
 </property>
</bean>

Vinkkejä ja niksejä

Tämän ominaisuuden avulla voit tuoda Knowledge Base Efecte Service Management -järjestelmästä. Lisätietoja on ConfiguringTipsTricks- uid kokonaisvaltaista konfigurointia varten.

Integration Suiten määritys

Kaikki Integration Suiten määritystiedostot sijaitsevat hakemistossa /etc/integration-hub/ ja sen alihakemistoissa. Vuokralaiskohtaiset liittimet sijaitsevat tenant-configs/{tenant_name}-alihakemistoissa.

Jos haluat määrittää "Tips & Tricks" -tuen Integration Suitessa, muokkaa connector-efecte.xml-tiedostoa. Lisää "EfecteKnowledgeBaseConnector"-luokan bean ja anna sille ESM-yhteyden määritysbean.

<bean id="connectionConfiguration"
 class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
 <property name="url" value=" http://efecte.efecte.com/efecte " />
 <property name="user" value="webapi-user" />
 <property name="password" value="PASSWORD" />
</bean>

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>

Huom! Yhteyskonfiguraation jakaminen Efecte-liittimien välillä on hyvä käytäntö, joten seuraava koodi (yleisesti käytetty konfiguraatioissa) on hyvä käytäntö:

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
 <property name="connectionConfiguration">
<bean class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
<property name="url" value="http://efecte.company.com" />
<property name="user" value="webapi-user" />
<property name="password" value="PASSWORD" />
</bean>
 </property>
</bean>

voidaan korvata:

<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
</bean>

Tietokannan mallin parametrien määrittäminen

ESM:ssä käytettyjen attribuuttien nimien muuttamiseksi Knowledge Base tuen osalta malliparametreja voidaan määrittää lisäämällä knowledgeBaseAttributes-ominaisuus efecteKnowledgeBaseConnector-papuun. Muussa tapauksessa käytetään oletusasetuksia.

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="knowledgeBaseAttributes" >
<bean id="knowledgeBaseAttributes" class="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
<property name="templateCode" value="knowledge_base_article"/>
<property name="pollingFolderCode" value="knowledge_base"/>
<property name="updateReadStatsFallbackFolderCode" value="knowledge_base"/> 
<property name="ratingFallbackFolderCode" value="knowledge_base"/>
 <property name="publishedInEssAttr" value="published_in_self_service"/>
<property name="publishedInEssValue" value="Yes"/>
<property name="deletedAttr" value="deleted"/>
<property name="nameAttr" value="solution_name"/>
<property name="descriptionAttr" value="solution_description"/>
<property name="categoryAttr" value="category"/>
 <property name="adGroupsAttr" value="ad_groups"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="updatedAttr" value="updated"/>
<property name="ratingAttr" value="rating"/>
<property name="rankingAttr" value="rating"/>
<property name="readStatsAttr" value="read_count"/>
<property name="keywordsAttr" value="solution_keywords"/>
<property name="keywordsSeparator" value=","/> 
</bean>
</property>
</bean>

Seuraavia KnowledgeBaseAttributes-luokan bean-ominaisuuksia tuetaan:

publishedInEssAttr

published_in_self_service

publishedInEssValue

Yes

deletedAttr

deleted

nameAttr

solution_name

descriptionAttr

solution_description

categoryAttr

category

adGroupsAttr

ad_groups

efecteIdAttr

efecte_id

updatedAttr

updated

ratingAttr

rating

rankingAttr

rating

readStatsAttr

read_count

keywordsAttr

solution_keywords

keywordsSeparator

,

"Vinkkejä ja niksejä" -päivitystiheyden määrittäminen

Oletusarvoisesti, jos virheitä ei tapahdu, tietokanta päivitetään kahden tunnin välein. Jos virheitä ilmenee, päivitysaika muuttuu kahteen minuuttiin.

Ajoituksen aloitusviive (aika, jonka jälkeen liitin alkaa toimia mitattuna Integration Hubin käynnistyksestä) voidaan määrittää hub.xml-tiedostossa olevan connectorScheduler-paanin startUpDelay-ominaisuuden avulla.

Esimerkki hub.xml-tiedostosta:

<bean name="connectorScheduler" class="com.efecte.integration.container.ConnectorScheduler">
   <property name="taskScheduler" ref="taskScheduler"/>
    <property name="startUpDelay" value="20000"/>
</bean> 

Päivitys- ja virhepäivitysten tiheydet voidaan määrittää liittimen XML-määrityksissä (connector-efecte.xml). Käytä seuraavia ominaisuuksia:

Esimerkki tiedostosta connector-efecte.xml:

<bean id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
 <property name="connectionConfiguration" ref="connectionConfiguration"/>
 <property name="updateFrequency" value="30"/>
 <property name="updateFrequencyUnit" value="SECONDS"/>
</bean>

Tykkää ideastani

Tämän ominaisuuden avulla voit tarkastella ja kommentoida Efecte Service Management -järjestelmään tallennettuja ideoita.

Kaikki Integration Suiten määritystiedostot sijaitsevat hakemistossa /etc/integration-hub/ ja sen alihakemistoissa. Vuokralaiskohtaiset liittimet sijaitsevat tenant-configs/{tenant_name}-alihakemistoissa.

Jos haluat määrittää "Like My Idea" -tuen Integration Suitessa, muokkaa connector-efecte.xml-tiedostoa. Lisää " http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd "skeeman sijainnit pääkomponenttien määritelmään.

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">

Lisää "annotation-config"-elementti ja "EfecteLikeMyIdeaConnector"-luokan bean ja anna sille ESM-yhteyden määritysbean. Lisää myös yksi "EfecteConnectorContext"-tyyppinen bean.

<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector" autowire="constructor">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="likeMyIdeaAttributes" >
<bean id="likeMyIdeaAttributes" class="com.efecte.integration.connector.configuration.LikeMyIdeaAttributes">
<property name="nameAttr" value="demand_name"/>
<property name="ratingFallbackFolderCode" value="ideas"/>
<property name="descriptionAttr" value="demand_details"/>
<property name="efecteIdAttr" value="efecte_id"/>
<property name="createdAttr" value="created"/>
<property name="likesAttr" value="likes"/>
<property name="dislikesAttr" value="dislikes"/>
<property name="templateCode" value="ideas"/>
<property name="pollingFolderCode" value="ideas"/>
<property name="deletedAttr" value="deleted"/>
<property name="commentsAttr" value="comment"/>
<property name="publishedInEssAttr" value="publish_for_rating" />
<property name="publishedInEssValue" value="Yes" />
</bean>
</property>
</bean>

Seuraavia LikeMyIdeaAttributes-luokan bean-ominaisuuksia tuetaan:

publishedInEssAttr

publish_for_rating

publishedInEssValue

Yes

deletedAttr

deleted

created

created

nameAttr

demand_name

descriptionAttr

demand_details

efecteIdAttr

efecte_id

likesAttr

likes

dislikesAttr

dislikes

commentsAttr

comment

"Tykkää ideastani" -päivitystiheyden määrittäminen

Oletusarvoisesti "tykkää ideoistani" päivittyy kahden tunnin välein, jos virheitä ei tapahdu. Jos virhe ilmenee, päivitysaika muuttuu kahteen minuuttiin.

Ajoituksen aloitusviive (aika, jonka jälkeen liitin alkaa toimia mitattuna Integration Hubin käynnistyksestä) voidaan määrittää hub.xml-tiedoston connectorScheduler-paanin startUpDelay-ominaisuudella. Noudata Vinkkejä ja niksejä -osiossa olevia ohjeita.

Päivitys- ja virhepäivitysten tiheydet voidaan määrittää liittimen XML-määrityksissä (connector-efecte.xml). Käytä seuraavia ominaisuuksia:

Esimerkki tiedostosta connector-efecte.xml:

<bean id="efecteLikeMyIdeaConnector" class="com.efecte.integration.connector.efecte.EfecteLikeMyIdeaConnector">
<property name="connectionConfiguration" ref="connectionConfiguration"/>
<property name="updateFrequency" value="30"/>
<property name="updateFrequencyUnit" value="SECONDS"/>
</bean>

Palveluni

Omat palvelut on yleinen nimitys joukolle integraatiomekanismeja, joiden avulla ulkoiset järjestelmät voivat dynaamisesti muokata käyttäjille näkyvää luettelon sisältöä.

MyServices-kenttien määrittäminen

1. Siirry ESS:n hallintasivulle -> Integraatiot -> Ulkoiset tietokentät
2. Paina Lisää OmatPalvelut -kenttä -painiketta
3. Syötä kokoonpano
   • Kentän nimi - anna nimi, jota käytetään tämän MyServices-kentän aliaksena.
   • Data lähteestä - valitse Efecte Service Management -liitin
   • Efecte Service Managementin mallipohjan tiedot yhdistetty OmatPalvelut-kenttään (Kirjaudu Efecte Service Managementiin -> Hallinta -> Mallipohjat -> valitse mallipohja)
     • Kansiokoodi – valinnainen, rajoittaa noudettavat elementit määritettyyn kansioon
     • Mallipohjan koodi - täytä mallipohjan koodin käyttöarvolla
     • Nimiattribuutin koodi - nimenä käytetyn attribuutin koodi (tämä attribuutti voi olla käyttäjälle näkyvissä)
     • Tekninen tunnisteattribuuttikoodi - DataCard- tunnisteena käytetyn attribuutin koodi (tulisi merkitä ensisijaiseksi attribuutiksi ESM:ssä)

• Käyttäjäattribuuttikoodi - viittaus mallipohjaan, joka kuvaa tähän mallipohjaan liittyvää käyttäjää (kohdemallipohjalla on oltava sähköpostiosoiteattribuutti, jotta käyttäjäasettelut toimivat oikein)

1. Paina Päivitä -painiketta. Jos virheitä ei ole, MyServices-kenttäelementtitaulukossa pitäisi näkyä Efecte Service Managementin DataCard-korttien nimet.
   1. Voit varmistaa tämän katsomalla taulukkoa, jossa on ESM:ssä valittuun malliin liittyviä DataCard-kortteja .

Palveluni ja tarjousluetteloni

MyService-merkintä palvelukohteiden tunnisteiden lähteenä

1. Avaa hallintasivulla Palvelut-välilehti ja valitse Palvelutarjous-kohdasta Palvelukohde.

2. Avaa Kohteen ominaisuudet -kohdassa Ulkoinen tietolinkki -pudotusvalikko ja valitse Ulkoinen tietokenttä -kentän nimi.
3. Valitse tarvitsemasi elementti avattavasta 'Tuotetunnus'-valikosta.

Valitun elementin tunnusta käytetään tuotetunnuksena, kun käyttäjät tilaavat tiettyä tuotetta.

Käyttäjien ja DataCardien väliset yhteydet

Liitin ei ole vastuussa ainoastaan DataCard-tietojen hakemisesta, vaan myös seuraavista:

• DataCard-korttien ja käyttäjien välisten yhteyksien seuranta
• muuttamalla mainittuja yhdistyksiä

Tämän toiminnon käyttämiseksi:

1. Avaa hallintasivulla Palvelu ja valitse Palvelukohde

2. Avaa Palvelukohteen ominaisuudet -kohdassa Omat palvelut -linkki -pudotusvalikko ja valitse Omat palvelut -kentän nimi.

1. Valitse avattavasta alivalikosta :
   1. Käyttäjä käyttää - tässä tapauksessa käyttäjälle näytetään luettelo DataCardeista, joihin hän on liitetty
2. Käyttäjä ei käytä – tässä tapauksessa käyttäjälle näytetään luettelo DataCardeista, joihin hän ei ole liitetty

Palvelunimikkeen tilauksen lähettäminen johtaa

1. Poistaminen
2. Lisätään

yhteys käyttäjän tilauksen tekemisen ja DataCardin välillä

Luetteloiden tuotteet

Seuraavia ESM-attribuuttitietotyyppejä tuetaan luettelokohteiden konfiguroinnissa

Liittimen esimerkki

<beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd">
    <bean id="connectionConfiguration" class="com.efecte.integration.connector.configuration.ConnectionConfiguration">
         <property name="url" value="https://xxxxxxxxx.efectecloud.com/api/itsm" />
         <property name="user" value="WebAPI" />
         <property name="password" value="xxxxxxxxxxxxxxxxxxxxxxxxxx" />
         <property name="connectionRequestTimeout" value="300" />
         <property name="connectTimeout" value="300" />
         <property name="socketTimeout" value="300" />
         <!--property name="acceptSelfSignedCertificates" value="true"/>
         <property name="allowAllHostnamesInCertificate" value="true"/-->
     </bean>
<bean id="defaultConnectorEfecte" class="com.efecte.integration.connector.efecte.EfecteConnector">
         <property name="connectionConfiguration" ref="connectionConfiguration" />
        <!-- property name="generalConfiguration"> NOT RECOMMENDED TO BE CHANGED
             <bean class="com.efecte.integration.connector.configuration.GeneralConfiguration">
                 <property name="dateTimeFormat" value="yyyy-MM-dd HH:mm:ss z"/>
                 <property name="integrationIdAttribute" value="WebShopId"/>
                <property name="integrationCategoryAttribute" value="WebShopCategory"/>
             </bean>
         </property -->
        <!-- property name="serviceRequestAttributes">
           <bean class="com.efecte.integration.connector.configuration.ServiceRequestAttributes">
              <property name="templateCode" value="ServiceRequest"/>
              <property name="bundleTemplateCode" value="ServiceRequestBundle"/>
              <property name="folderCode" value="ServiceRequests"/>
              <property name="attachmentAttribute" value="RequestAttachments"/>
              <property name="statusAttribute" value="status"/>
              <property name="reopenReasonAttribute" value="reopen_reason"/> 
              <property name="creationDateAttribute" value="created"/>
              <property name="deadlineAttribute" value="deadline"/>
              <property name="updatedAttribute" value="updated"/>
              <property name="efecteIdAttribute" value="efecte_id"/>
              <property name="languageAttribute" value="Language"/>
              <property name="feedbackAttribute" value="rating"/>
              <ominaisuus nimi="resoluutioTextAttribute" arvo="resoluutio"/>
              <ominaisuus nimi="tukihenkilönOminaisuus" arvo="tukihenkilö"/>
              <ominaisuus name="palvelunTarjousNimiAttribuutti" value="Palvelutarjous"/>
              <ominaisuus nimi="palvelukohteenNimiAttribuutti" value="PalvelunKohteenNimi"/>
              <ominaisuus nimi="serviceItemExternalIdAttribute" value="Palvelunimike"/>
              <ominaisuus nimi="hintaAttribuutti" arvo="Hinta"/>
              <ominaisuus name="kuukausittaisentilauksenominaisuus" value="Kuukausitilaus"/>
              <ominaisuus nimi="pyydettyOminaisuus" value="Pyydetty"/>
              <ominaisuus nimi="kustannuskeskuksen_attribuutti" arvo="Kustannuskeskus"/>
              <ominaisuus name="toimitusosoitteenAttribuutti" arvo="Toimitusosoite"/>
              <ominaisuus nimi="järjestettyOminaisuudenBy" arvo="Järjestäjä"/>
              <ominaisuus nimi="lisätietojen_ominaisuus" arvo="Lisätietoja"/>
              <ominaisuus nimi="sivustonID-attribuutti" arvo="Sivustontunnus"/>
              <ominaisuus name="sivustonNimiAttribuutti" arvo="SivustonNimi"/>
              <ominaisuus nimi="pyyntöpaketinominaisuus" value="Pyyntöpaketti"/>
              <ominaisuus name="pyyntöpaketinNimiAttribuutti" value="PyyntöpaketinNimi"/>
              <ominaisuus nimi="tilattuSähköpostimääritteenmukaan" arvo="Tilaaja:sähköposti"/>
              <ominaisuus name="pyydettySähköpostiOminaisuus" value="Pyydetty:sähköpostiosoite"/>
              <ominaisuus nimi="kommenttiAttribuutti" arvo="ulkoiset_kommentit"/>
              <ominaisuus nimi="syyAttribuutti" arvo="käyttäjän_syy"/>
              <ominaisuus name="dedicatedApproverAttribute" value="Omahyväksyjä"/>
              <ominaisuus name="ylemmänhyväksyjänominaisuus" arvo="hyväksyvä_päällikkö"/>
              <ominaisuus nimi="kokonaishintaominaisuus" arvo="kokonaishinta"/>
              <ominaisuus nimi="määräAttribuutti" arvo="määrä"/>
              <ominaisuus name="totalMonthlySubscriptionAttribute" value="Kuukausitilaustenkokonaismäärä"/>
          </bean>
      </ominaisuus -->
     <!-- omaisuus nimi="hyväksynnänVastauksenOminaisuudet"> EI SUOSITELTAVA TOIMII OLLA MUUTETTU
          <papu luokka="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
              <ominaisuus nimi="mallikoodi" arvo="hyväksyntä"/>
              <ominaisuus nimi="kansionkoodi" arvo="hyväksynnät"/>
              <ominaisuus nimi="vaikutusId" arvo="tehosteen_tunnus"/>
              <ominaisuus nimi="todellinenHyväksyjä" arvo="Todellinenhyväksyjä"/>
              <ominaisuus nimi="hyväksymispäätös" value="Hyväksyntäpäätös"/>
              <ominaisuus nimi="syy" arvo="Syy"/>
              <ominaisuus nimi="esmHyväksyttyKoodi" arvo="hyväksytty"/>
              <ominaisuus nimi="esmHylättyKoodi" arvo="hylätty"/>
          </bean>
      </ominaisuus -->
     <!-- omaisuus name="efecteTrackingConnector">
          <papu class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
              <ominaisuus name="päivityskyselynliukuvanikkunanaika" arvo="20"/>
              <ominaisuus name="päivitäKyselyLiukuvaIkkunayksikkö" arvo="MINUUTTIA"/>
              <ominaisuus name="alkukyselynliukuvanikkunanaika" arvo="1"/>
              <ominaisuus name="alkukyselynliukuvanikkunanyksikkö" arvo="PÄIVÄÄ"/>
              <ominaisuus nimi="päivitystaajuus" arvo="10" />
              <ominaisuus nimi="päivitystaajuusyksikkö" arvo="MINUUTTIA" />
              <ominaisuus nimi="virhepäivitystaajuus" arvo="10" />
              <ominaisuus nimi="virhepäivitystaajuusyksikkö" arvo="MINUUTTIA" />
              <ominaisuus nimi="oletusintegraatiopalvelun_kohteen_tunnus" arvo="OLETUSPALVELUKOHDE" />
              <ominaisuus name="kyselyUusiPalveluPyyntöKäytössä" arvo="false" />
             <ominaisuus name="oletusintegraatioluokantunnus" arvo="OLETUSVAIKUTTEINEN_LUOKKA"/>
              <ominaisuus nimi="palvelupyyntökyselyehto" arvo="ja" $luoja$ = 'SefServicePortal'"/>
              <ominaisuus nimi="tapausPoll-ehto" arvo="ja" $luoja$ = Verkkokauppa
          </bean>
      </ominaisuus -->
     <!-- omaisuus name="feedbackFormConnector">
           <papu class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
              <ominaisuus name="feedbackAttributes">
                     <papu class="com.efecte.integration.connector.configuration.FeedbackAttributes">
                         <ominaisuus nimi="mallikoodi" arvo="palautehallinta" />
                         <ominaisuus nimi="kansionkoodi" arvo="palaute" />
                         <ominaisuus nimi="efektinIdAttribuutti" arvo="ticket_id" />
                         <ominaisuus nimi="asiakasOminaisuus" arvo="asiakas" />
                         <ominaisuus nimi="luokitusAttribuutti" arvo="lippujen_luokitus" />
                     </bean>
               </ominaisuus>
           </bean>
       </ominaisuus --> 
     </bean>
<papu id="tehostettuKnowledgeBaseConnector" luokka="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
    <ominaisuus nimi="yhteydenmääritys" ref="yhteydenMääritys"/>
    <ominaisuus name="tietokannanominaisuudet" >
           <papu id="tietokannanominaisuudet" luokka="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
                 <ominaisuus nimi="mallikoodi" arvo="tietokannan_artikkeli"/>
                 <ominaisuus nimi="kyselykansionkoodi" arvo="tietokanta"/>
                 <ominaisuus nimi="päivitäLueTilastotVarakansioKoodi" arvo="tietokanta"/>
                 <ominaisuus nimi="arviointiVarakansionKoodi" arvo="tietokanta"/>
                 <ominaisuus nimi="julkaistuEssAttr:ssä" arvo="julkaistu_itsepalvelussa"/>
                 <ominaisuus nimi="julkaistuEss-arvossa" arvo="Kyllä"/>
                 <ominaisuus nimi="poistettuAttr" arvo="poistettu"/>
                 <ominaisuus nimi="nimiAttr" arvo="ratkaisun_nimi"/>
                 <ominaisuus nimi="kuvausAttr" arvo="ratkaisun_kuvaus"/>
                 <ominaisuus nimi="kategoriaAttr" arvo="kategoria"/>
                 <ominaisuus nimi="efektintunnusAttr" arvo="tehosteen_tunnus"/>
                 <ominaisuus nimi="päivitettyAttr" arvo="päivitetty"/>
                 <ominaisuus nimi="luokitusAttr" arvo="luokitus"/>
                 <ominaisuus nimi="rankingAttr" arvo="luokitus"/>
                 <ominaisuus nimi="lueStatsAttr" arvo="lukumäärä"/>
                 <ominaisuus nimi="avainsanatAttr" arvo="ratkaisun_avainsanat"/>
                 <ominaisuus name="avainsanaerotin" arvo=","/>
             </bean>
       </ominaisuus>
    </bean>
</pavut>