Efecte Service Management -konnektori pähkinänkuoressa

Tämän konnektorin avulla Efecte Self-Service voi

• Luoda uusia häiriöitä ja palvelupyyntöjä Efecte Service Managementiin
• Hakea päivityksiä, kun häiriöitä tai palvelupyyntöjä muutetaan Efecte Service Managementissa (esimerkiksi kun pyynnön tila muuttuu)
• Hakea ja lähettää tietämyskannan artikkeleiden arviointitietoja Tips & Tricks -toimintoon liittyen
• Hakea ja lähettää arviointitietoja ja kommentteja uusista ideoista Like My Idea -toimintoon liittyen
• Hakea dynaamista käyttäjätietoa Efecte Service Managementista (MyServices)
• Hakea tietoa palvelutarjousten pitämiseksi ajan tasalla (Catalog items)
• Lähettää hyväksymispäätöksiä Visual Workflow Approvals -toiminnolle Efecte Service Managementissa
• Lähettää loppukäyttäjiltä kerättyä palautetta Efecte Service Managementiin

Suurin osa konnektorin toiminnallisuudesta toimii automaattisesti oletusarvoja käyttäen, joihin viitataan läpi tämän dokumentin.

Tässä artikkelissa kuvataan Efecte Service Management -konnektorin toiminta ESS-versiossa 2022.3 tai uudemmassa.

Tuetut mallit

Efecte-konnektori tukee oletusarvoisesti kahta mallia – palvelupyyntöä (ServiceRequest) ja häiriötä (incident). Jos tarvitaan tukea useammalle mallille, vuokralaiselle voidaan ottaa käyttöön useita ESM-konnektoreita, ja pyyntöjen kohde voi poiketa oletuksesta. Tällöin vain yhdessä konnektorissa saa olla määritetty tietämyskanta- ja like my idea -asetukset – jos useammassa konnektorissa on jompikumpi määritetty, etusivulla artikkeleiden näyttämiseen käytetään viimeksi Efecte Self-Serviceen haettua tulosjoukkoa, mikä saattaa aiheuttaa sekavan käyttökokemuksen erityisesti ESM:n sisäisiin eri lähteisiin viitattaessa.

Toisaalta yhden mallin käyttäminen voi olla kiinnostava vaihtoehto. Oikealla määrityksellä kaikki pyynnöt voidaan ohjata haluttuun malliin. Kiinnitä kuitenkin huomiota attribuuttikoodeihin, tila-arvoihin sekä eri pyyntötyyppien mahdollisiin erotteluihin, jotta vältetään virheellisistä määrityksistä johtuvien ylimääräisten lokimerkintöjen syntyminen.

ESM-viestien muoto

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

Huomautus: MyService-toiminnon monivalintakentät välitetään CSV-muodossa xml-tagien sisällä.

Yhteyden määritys

Määritä ESM:n yhteys käyttämällä luokan com.efecte.integration.connector.configuration.ConnectionConfiguration beania 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>

Huomautus! Kun käytetään useita konnektoreita ja osa niistä viittaa eri yhteysmääritykseen (esimerkiksi eri ympäristöön), niillä tulee olla yksilöllinen ID kutakin yhteysmääritystä kohden. Toisin sanoen varmista, ettei kahdella eri yhteysmäärityksellä ole samaa bean-ID:tä. Tämä koskee tilannetta, jossa yhdestä ESS:stä yhdistetään kahteen eri ESM-ympäristöön, joten ympäristön merkitseminen bean-ID:hen voi olla hyvä idea, esim.

bean id="connectionConfigurationEnvName”

Tämä bean tukee seuraavia ominaisuuksia:

Palvelupyynnön määritys

Palvelupyynnön attribuuttien kartoitukset voidaan määrittää connector-efecte.xml-tiedostossa. Esimerkkimääritys 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> 

Häiriöiden kartoitusta voidaan muokata vuokralaisen pääkäyttäjän käyttöliittymässä, tukikanavan määritysvälilehdellä. Uutta tukikanavaa luotaessa oletusarvot näkyvät määrityksessä.

Yksityiskohtaiset säännöt palvelupyynnön ominaisuuksien käsittelylle ovat seuraavat:

Jos palvelutarjoukselle on valittu ”Item quantity enabled”, palvelupyynnölle käsitellään seuraavat lisäsäännöt:

Huomautus! Yllä luetellut attribuutit ovat oletusarvoja. Jos niitä on tarpeen muuttaa, vastaavat koodit tulee määrittää konnektoritiedostossa.

PunchOut-toiminto mahdollistaa sen, että Efecte Self-Servicen käyttäjät voivat käyttää ulkoista verkkokauppaa nimikkeiden keräämiseen palvelupyyntöönsä. PunchOut-toimintoa varten konnektorissa tarvitaan seuraavat attribuutit. Lisätietoja löytyy PunchOut-määritysoppaasta.

Seurantakonnektori (Tracking connector)

Seurantakonnektori käynnistää päivitysten haun Efecte Service Managementista sekä häiriöille että palvelupyynnöille. ESM:stä ESS:ään tulevien häiriöiden oletusaluekartoitus ja palvelupyyntöjen palvelunimikekartoitus voidaan määrittää asettamalla seuraavat EfecteTrackingConnector-beanin ominaisuudet:

Huomautus! Oletusarvoisesti haetaan häiriöitä, ei palvelupyyntöjä. Jotta myös palvelupyyntöjä haetaan, Efecte Tracking Connector tulee lisätä konnektoritiedostoon.

Jotta uusien palvelupyyntöjen haku toimisi oikein, seuraavat attribuutit ovat pakollisia ESM:n puolella:

• Pyynnön tunniste välitetään efecteIdAttribute-attribuutissa, oletusarvo ’efecte_id’
• Tila välitetään statusAttribute-attribuutissa, oletusarvo ’status’
• Asiakkaan tunniste välitetään requestedForEmailAttribute-attribuutissa, oletusarvo ’RequestedFor:email’
• Nimiketunnus (Item ID) välitetään serviceItemExternalIdAttribute-attribuutissa, oletusarvo ’ServiceItem’ - jos tämän attribuutin arvo on tyhjä, konnektori käyttää arvoa seurantakonnektorin määrityksen defaultIntegrationServiceItemId-kohdasta

Jotta uusien häiriöiden haku toimisi oikein, seuraavat attribuutit ovat pakollisia ESM:n puolella:

• Häiriön tunniste välitetään efecteIdAttribute-attribuutissa, oletusarvo ’efecte_id’
• Tila välitetään statusAttribute-attribuutissa, oletusarvo ’status’
• Asiakkaan tunniste välitetään customer email -attribuutissa, oletusarvo customer:email
• Kategoriatunnus (Category ID) välitetään integrationCategoryAttribute-attribuutissa, oletusarvo WebShopCategory - jos tämän attribuutin arvo on tyhjä, konnektori käyttää arvoa seurantakonnektorin määrityksen defaultIntegrationCategoryId-kohdasta (kyseisellä kategoriatunnuksella tulee olla julkaistu kategoria ESS:ssä)

Hakutiheyttä voidaan säätää luokan 'EfecteTrackingConnector' ominaisuuksilla 'updateFrequency' ja 'errorUpdateFrequency'. Arvot ilmaistaan määritettävissä olevina yksikköinä.

Huomautus! On hyvin harvinaista, että 'updateQuerySlidingWindowTime'-arvoa tarvitsee muuttaa oletuksesta. Haettu tieto sisältää aina kaikki ajanjakson aikana muuttuneet tietokortit, ja pidemmällä ajanjaksolla samat tiketit palautuvat tulosjoukkoon toistuvasti. Jo ensimmäisellä kerralla tiketti päivitetään ESS:ään. Tämän ikkunan laajentaminen saattaa hidastaa toimintaa sekä ESS:ssä että ESM:ssä ilman lisähyötyä.

Kun konnektori suoritetaan ensimmäistä kertaa, se hakee pyynnöt ja häiriöt viimeisen 24 tunnin ajalta. Tätä aikaa voidaan säätää määrittämällä ominaisuudet initialQuerySlidingWindowTime ja initialQuerySlidingWindowUnit.

Efecte Tracking Connectorin muut oletusarvot ovat:

Esimerkkimääritys:

 <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 seurantakonnektorissa, oletusliukuvan ikkunan kokona käytetään 'pollingInterval'-arvoa kerrottuna kahdella (2).

Palautelomake

Palautelomake on oletuksena tuettu ESM-konnektorissa. ESM-kenttiin kartoittamiseen käytettävät attribuutit voidaan määrittää säätämällä EfecteFeedbackFormConnector-luokan beanin ominaisuuksia sekä itse lomakkeella pääkäyttäjän käyttöliittymän Feedback management -välilehdellä. Seuraavia ominaisuuksia tuetaan:

Esimerkkimääritys EfecteFeedbackFormConnectorista 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>

Tips & Tricks

Tämä ominaisuus mahdollistaa tietämyskannan tuomisen Efecte Service Management -järjestelmästä. Lisätietoja täydellisestä määrityksestä löytyy ConfiguringTipsTricks-oppaasta.

Integration Suiten määritys

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

Määrittääksesi tuen "Tips & Tricks" -toiminnolle Integration Suitessa, muokkaa connector-efecte.xml-tiedostoa. Lisää luokan "EfecteKnowledgeBaseConnector" bean ja anna sille ESM-yhteyden määritys-bean.

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

Huomautus! On hyvä käytäntö jakaa yhteysmääritys Efecte-konnektoreiden kesken, joten seuraava koodi (yleisesti käytetty määrityksissä):

<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 seuraavalla:

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

Tietämyskannan mallin parametrien määrittäminen

Jos haluat muuttaa ESM:ssä Knowledge Base -tuelle käytettävien attribuuttien nimiä, mallin parametrit voidaan määrittää lisäämällä efecteKnowledgeBaseConnector-beaniin knowledgeBaseAttributes-ominaisuus. Muutoin 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>

KnowledgeBaseAttributes-luokan beanille tuetaan seuraavia ominaisuuksia:

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

,

"Tips & Tricks"-päivitystiheyden määrittäminen

Oletusarvoisesti, jos virhettä ei ilmene, tietämyskanta päivitetään joka 2. tunti. Jos virhe ilmenee, päivitysaika muutetaan 2 minuuttiin.

Ajastuksen aloitusviivettä (aika, jonka jälkeen konnektori alkaa toimia integraatiohubin käynnistymisestä laskettuna) voidaan määrittää connectorScheduler-beanin startUpDelay-ominaisuudella hub.xml-tiedostossa.

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äivitystiheydet voidaan määrittää konnektorin xml-määrityksessä (connector-efecte.xml). Käytä seuraavia ominaisuuksia:

Esimerkki connector-efecte.xml-tiedostosta:

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

Like My Idea

Tämä ominaisuus mahdollistaa Efecte Service Management -järjestelmään tallennettujen ideoiden näyttämisen ja kommentoinnin.

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

Määrittääksesi tuen "Like My Idea" -toiminnolle 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" schema-sijainnit pääbeans-määritykseen.

<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 sekä luokan "EfecteLikeMyIdeaConnector" bean ja anna sille ESM-yhteyden määritys-bean. 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> 

LikeMyIdeaAttributes-luokan beanille tuetaan seuraavia ominaisuuksia:

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

"Like My Idea"-päivitystiheyden määrittäminen

Oletusarvoisesti, jos virhettä ei ilmene, "like my ideas" päivitetään joka 2. tunti. Jos virhe ilmenee, päivitysaika muutetaan 2 minuuttiin.

Ajastuksen aloitusviivettä (aika, jonka jälkeen konnektori alkaa toimia integraatiohubin käynnistymisestä laskettuna) voidaan määrittää connectorScheduler-beanin startUpDelay-ominaisuudella hub.xml-tiedostossa. Katso ohjeet Tips & Tricks -osiosta.

Päivitys- ja virhepäivitystiheydet voidaan määrittää konnektorin xml-määrityksessä (connector-efecte.xml). Käytä seuraavia ominaisuuksia:

Esimerkki connector-efecte.xml-tiedostosta:

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

My Services

My Services on yleisnimitys joukolle integraatiomekanismeja, jotka mahdollistavat sen, että ulkoiset järjestelmät voivat dynaamisesti muokata käyttäjille näkyvän luettelon sisältöä.

MyServices-kenttien määrittäminen

1. Siirry ESS:n pääkäyttäjäsivulle -> Integrations -> External data fields
2. Paina Add MyServices field -painiketta
3. Enter configuration
   • Field name - anna nimi, jota käytetään tämän MyServices-kentän aliaksena
   • Data from - valitse Efecte Service Management -konnektori
   • Efecte Service Managementista tuleva mallin data kartoitettuna MyServices-kenttään (kirjaudu Efecte Service Managementiin -> Administration -> Templates -> valitse malli)
     • Folder code – valinnainen, rajaa haettavat elementit määriteltyyn kansioon
     • Template code - täytä Template code -arvolla
     • Name attribute code - nimenä käytettävän attribuutin koodi (tämä attribuutti saattaa näkyä käyttäjälle)
     • Technical ID attribute code - DataCard-tunnisteena käytettävän attribuutin koodi (tulisi merkitä ESM:ssä Primary-attribuutiksi)

• User attribute code - viittaus malliin, joka kuvaa tähän malliin liitettyä käyttäjää (kohdemallilla tulee olla sähköpostiattribuutti, jotta käyttäjäliitokset toimivat oikein)

1. Paina Update-painiketta - jos virheitä ei ilmene, MyServices field elements -taulukossa tulisi näkyä DataCards-korttien nimet Efecte Service Managementista
   1. Voit varmistaa tämän tarkastelemalla taulukkoa, jossa näkyvät valittuun malliin liitetyt DataCards-kortit ESM:ssä

My Services ja tarjousluettelo

MyService-tietue palvelunimiketunnusten (Service Item ID) lähteenä

1. Avaa pääkäyttäjäsivulla Services-välilehti ja valitse Service Item palvelutarjouksesta

2. Avaa nimikkeen ominaisuuksissa External Data Link -pudotusvalikko ja valitse External Data -kentän nimi
3. Valitse 'Item ID'-pudotusvalikosta tarvitsemasi elementti.

Valitun elementin tunnusta käytetään ItemID-arvona, kun käyttäjät tilaavat kyseistä nimikettä.

Käyttäjien ja DataCards-korttien väliset liitokset

Konnektori ei vastaa ainoastaan DataCards-tietojen hakemisesta, vaan myös:

• DataCards-korttien ja käyttäjien välisten liitosten seurannasta
• näiden liitosten muuttamisesta

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

1. Avaa pääkäyttäjäsivulla Service ja valitse Service Item

2. Avaa palvelunimikkeen ominaisuuksissa MyServices Link -pudotusvalikko ja valitse MyServices-kentän nimi

1. Valitse Sub-items-pudotusvalikosta:
   1. User using - tässä tapauksessa käyttäjälle näytetään lista DataCards-korteista, joihin hänet on liitetty
2. User not using - tässä tapauksessa käyttäjälle näytetään lista DataCards-korteista, joihin häntä ei ole liitetty

Palvelunimikkeen tilauksen lähettäminen johtaa seuraavaan:

1. Poistamiseen
2. Lisäämiseen

liitos tilauksen tekevän käyttäjän ja DataCard-kortin välillä

Luettelon nimikkeet (Catalog items)

Seuraavat ESM-attribuuttien tietotyypit ovat tuettuja luettelon nimikkeitä määritettäessä

Konnektoriesimerkki

<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"/>
              <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"/>
          </bean>
      </property -->
     <!-- property name="approvalResponseAttributes"> NOT RECOMMENDED TO BE CHANGED
          <bean class="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
              <property name="templateCode" value="approval"/>
              <property name="folderCode" value="approvals"/>
              <property name="efecteId" value="efecte_id"/>
              <property name="actualApprover" value="ActualApprover"/>
              <property name="approvalDecision" value="ApprovalDecision"/>
              <property name="reason" value="Reason"/>
              <property name="esmApprovedCode" value="approved"/>
              <property name="esmRejectedCode" value="rejected"/>
          </bean>
      </property -->
     <!-- 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$ = 'SefServicePortal'"/>
              <property name="incidentPollCondition" value="and $creator$ = 'Webshop'"/>
          </bean>
      </property -->
     <!-- 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>
<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="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>
</beans>