FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Swedish
FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)
  • Log in
  • Home
  • Plattform
  • ESS

ESS: Efecte Service Management-anslutning

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Tjänstehantering
    Matrix42 Professional Lösning Matrix42 Core lösning Hantering av företagstjänster Matrix42 Intelligens
  • Identitetsstyrning och administration ( IGA )
    IGA översikt IGA lösningsbibliotek
  • Plattform
    ESM ESS2 ESS Efecte Chat för tjänstehantering Efecte-integrationer Tillägg
  • Versionsinformation för M42 Core & Pro , IGA , konversations-AI
    2025.3 2025.2 2025.1 2024.2 2024.1 2023.4 2023.3 2023.2 2023.1 2022.4 2022.3 Publiceringsinformation och policyer
  • Annat material
    Villkor och uid Tillgänglighetspolicyer
  • Tjänster
+ More
    • Tjänstehantering

    • Identitetsstyrning och administration ( IGA )

    • Plattform

    • Versionsinformation för M42 Core & Pro , IGA , konversations-AI

    • Annat material

    • Tjänster

ESS: Efecte Service Management-anslutning

Efecte Service Management-anslutning i ett nötskal

Med hjälp av denna kontakt kan Efecte Self-Service

  • Skapa nya incidenter och serviceförfrågningar i Efecte Service Management
  • Uppdateringar av omröstningar när incidenter och serviceförfrågningar ändras i Efecte Service Management (till exempel när förfrågningsstatus ändras)
  • Undersök och skicka betygsdata om kunskapsbasartiklar i samband med tips och tricks
  • Räkna med omröstningar och skicka in betygsdata och kommentarer om nya idéer i samband med Gilla min idé
  • Samla dynamiska användardata från Efecte Service Management (MyServices)
  • Polldata för att hålla serviceerbjudandensdata uppdaterade (katalogartiklar)
  • Skicka godkännandebeslut för visuella arbetsflödesgodkännanden i Efecte Service Management
  • Skicka feedback som samlats in från slutanvändare till Efecte Service Management

De flesta av funktionerna i kopplingen fungerar automatiskt med standardvärdena som hänvisas till i hela det här dokumentet.

Den här artikeln beskriver hur Efecte Service Management Connector beter sig i ESS version 2022.3 eller senare.

Notera

För två användningsfall skickar Efecte Service Management aktivt data till Efecte Self-Service. Dessa är tillkännagivanden om problem som påverkar många, och godkännanden för Visual Workflow Automation där beslutet förväntas fattas i Efecte Self-Service. För alla övriga är Efecte Self-Service den aktiva parten.

Mallar som stöds

Redan ur lådan stöds två mallar för Efecte-anslutningen – Service Request (ServiceRequest) och Incident (incident). Om det finns behov av att stödja flera mallar kan flera ESM-anslutningar distribueras för hyresgästen och destinationen för förfrågningar kan skilja sig från standardinställningen. I det här fallet kan endast en av anslutningarna inkludera kunskapsbasen och, som min idé, konfigurationen – om flera anslutningar har konfigurerats är resultatuppsättningen som används för att visa artiklar på hemsidan den som senast hämtades till Efecte Self-Service, vilket kan leda till förvirrande användarupplevelse, särskilt med pekare till olika källor i ESM.

Å andra sidan kan det vara intressant att använda en enda mall. Med korrekt konfiguration kan alla förfrågningar dirigeras till önskad mall. Var dock uppmärksam på attributkoder och statusvärden och sätt att eventuellt separera de olika förfrågetyperna för att undvika att överskottsloggar genereras genom att konfigurationerna inte matchar.

ESM-meddelandeformat

Formatet för meddelanden som utväxlas mellan ESS- och ESM-produkter är hårdkodat.

Obs: Flervärdesfält för MyService-funktionen skickas i CSV-format inuti XML-taggar.

Anslutningskonfiguration

För att konfigurera anslutning för ESM, använd en böna av klassen com.efecte.integration.connector.configuration.ConnectionConfiguration, som i följande exempel:

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

Obs! När flera anslutningar används, och vissa av dem refererar till olika anslutningskonfigurationer (t.ex. olika miljöer), bör de ha ett unikt ID per anslutningskonfiguration. Med andra ord, se till att du inte har samma bön-ID för två olika anslutningskonfigurationer. Denna konfiguration gäller när du ansluter till två olika ESM-miljöer från ett ESS, så det kan vara en bra idé att ange miljön i bön-ID:t, t.ex.

böna-id="anslutningskonfigurationsmiljönamn"

Denna böna stöder följande egenskaper:

Namn Standardvärde Beskrivning
webbadress http://efecte.company.com URL för ESM API
användare webapi-användare användarnamn
lösenord ESM API lösenord
accepteraSjälvsigneradeCertifikat falsk Om "sanna" självsignerade certifikat accepteras
tillåtAllaVärdnamnICertifikat falsk Om "sant" inaktiveras verifiering av serverns värdnamn på certifikat. Detta bör alltid vara inställt på falskt i produktionssystem!
anslutningsbegäranTimeout 300 Returnerar timeouten i sekunder som används vid begäran av en anslutning från anslutningshanteraren. Ett timeout-värde på noll tolkas som en oändlig timeout. Ett timeout-värde på noll tolkas som en oändlig timeout. Ett negativt värde tolkas som odefinierat (systemstandard).
anslutningstidsgräns 300 Bestämmer timeouten i sekunder tills en anslutning upprättas. Ett timeout-värde på noll tolkas som en oändlig timeout. Ett negativt värde tolkas som odefinierat (systemstandard).
socketTimeout 300 Definierar socket-timeout (SO_TIMEOUT) i sekunder, vilket är timeouten för att vänta på data eller annorlunda uttryckt, en maximal period av inaktivitet mellan två på varandra följande datapaket. Ett timeout-värde på noll tolkas som en oändlig timeout. Ett negativt värde tolkas som odefinierat (systemstandard).

Konfiguration av serviceförfrågan

Attributmappningar för serviceförfrågningar kan definieras i filen connector-efecte.xml. Exempelkonfiguration av alla tillgängliga alternativ:

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

Mappning för incidenter kan justeras med hjälp av klientadministrationsgränssnittet, fliken konfiguration av supportkanal. När du skapar en ny supportkanal kan standardvärdena observeras i konfigurationen.

Detaljerade regler för behandling av egenskaper för serviceförfrågningar är följande:

Attributnamn Beskrivning
integrationIdAttribute Om sådan finns kommer en uppgradering av en befintlig serviceförfrågan att utföras (mappad i GeneralConfiguration-bönan, rekommenderas att inte ändras – standardvärdet är WebShopId)
efecteIdAttribute Om integrationIdAttribute är tomt och det inte finns någon begäran i ESS med angivet efecteIdAttribute-värde kommer en ny tjänstbegäran att skapas; om begäran med angivet efecteIdAttribute-värde finns i ESS kommer en uppdatering av en befintlig begäran att utföras.
begärtE-postAttribut En användare med den e-postadressen måste finnas i organisationsinformationen i ESS. Om den inte gör det kommer serviceförfrågan att avvisas med korrekt information i ESS-loggfilen (exempel på loggpost: Kunde inte matcha användaren med e-postadress ... till användaren. Serviceförfrågan skapades inte för id ...)
orderedByEmailAttribute En användare med matchande e-postadress måste finnas i organisationens informationsdata. Om den inte finns kommer serviceförfrågan att avvisas med korrekt information i ESS-loggfilen. Om värdet i fältet är tomt kommer requestedForEmailAttribute att användas istället.
serviceItemExternalIdAttribute Serviceartikeln med det artikel-ID:t måste finnas och vara giltig ( kontroller utförs även mot arbetskopian ). Om det villkoret inte är uppfyllt avvisas servicebegäran med korrekt information i ESS-loggfilen.
tjänstErbjudandenamnAttribut Om detta är angivet skapas serviceförfrågan med det namnet. Om attributet inte är angivet kopieras serviceerbjudandets namn från serviceerbjudandet som hittats baserat på serviceItemExternalIdAttribute.
itemNameAttribute Om det anges skapas serviceförfrågan med det namnet. Om attributet inte anges kopieras serviceobjektets namn från serviceobjektet som hittades baserat på serviceItemExternalIdAttribute.
prisAttribut / månadsprenumerationAttribut Om detta är angivet skapas serviceförfrågan med det priset/den månatliga prenumerationsavgiften. Om attributet inte är angivet kopieras attributen från serviceobjektet som hittats baserat på serviceItemExternalIdAttribute.
ytterligareInformationAttribut Om värdet för ESM:s attribut för ytterligare information börjar med "Beskrivning:", kommer kopplingen att ta text efter "Beskrivning:" upp till slutet av raden. Om fältet för att lägga till information inte börjar med prefixet "Beskrivning:" kommer allt innehåll i attributvärdet att bearbetas.
anledningAttribut Samlar in det värde som användaren har angett i fältet "Orsak" i orderbekräftelsefasen. Som standard mappas värdet till ESM-attributkoden "användarorsak".
requestBundleAttribute Värdet för detta attribut är unikt för varje buntbeställning i ESS-databasen. Värdet mappas till ESM-attributet "RequestBundle". Varje buntbeställning kan ha en eller flera serviceförfrågningar som var och en har ett eget unikt serviceItemExternalIdAttribute.
requestBundleNameAttribute Värdet för detta attribut är namnet på det uid erbjudandet. Värdet mappas till ESM-attributet "RequestBundleName".

Om "Artikelkvantitet aktiverad" är valt för tjänsteerbjudandet, bearbetas följande extra regler för serviceförfrågan:

Attributnamn Beskrivning

kvantitetAttribut

Kvantitetsinformationen från ordern i ESS skickas till ESM-attributet vars kod är kvantitet. Attributtypen i ESM ska vara antal.

totalPriceAttribute

Totalpriset för varje serviceartikelorder i ESS skickas till ESM-attributet vars kod är totalPrice. Attributtypen i ESM kan vara ett decimaltal.

totalMånatligPrenumerationAttribut

Det totala månatliga prenumerationspriset för varje serviceartikelorder i ESS skickas till ESM-attributet vars kod är TotalMonthlySubscription. Attributtypen i ESM kan vara ett decimaltal.

Obs! Attributen som anges ovan är standardvärdena. Om dessa behöver ändras ska motsvarande koder introduceras i kopplingsfilen.

PunchOut-funktionen gör det möjligt för Efecte Self-Service-användare att använda en extern webbutik för att samla in artiklar i sin serviceförfrågan. Följande attribut behövs i connectorn för PunchOut-funktionen. Se PunchOut- uid för mer information.

Attributnamn Beskrivning

totalPriceAttribute

Se ovan

utslagning

punchout-attributets punchOutOrderId-kod används som en orderidentifierare. Den måste ha ett värde innan en godkänd order skickas till PunchOut-tjänsteleverantören.

Spårningskoppling

Spårningsanslutningen utlöser en omröstning för uppdateringar från Efecte Service Management för både incidenter och serviceförfrågningar. Standarddomänmappning för incidenter som kommer från ESM till ESS och serviceobjektmappning för serviceförfrågningar kan konfigureras genom att ställa in följande egenskaper för EfecteTrackingConnector-bönan:

Namn Standardvärde Beskrivning
standardIntegrationskategori-ID STANDARDKATEGORI Standarddomänmappning för incidenter
standardIntegrationstjänstobjekt-ID STANDARDSERVICEARTIKEL Standardmappning av serviceartiklar för serviceförfrågningar
pollNewServiceRequestEnabled falsk Möjliggör avsökning av nya serviceförfrågningar från ESM
omröstningNyIncidentAktiverad sann Om den är satt till falskt hämtas inte incidenter med tomma uid (de som skapas i ESM och inte i ESS)

Obs! Som standard avsöks incidenter och inte serviceförfrågningar. För att även avsöka serviceförfrågningarna måste Efecte Tracking Connector introduceras i connectorfilen.

För att den nya avsökningen av tjänstförfrågningar ska fungera korrekt är följande attribut obligatoriska på ESM-sidan:

  • Begäranidentifierare som anges i efecteIdAttribute, standard 'efecte_id'
  • Status förmedlad i statusAttribute.default 'status'
  • Kund-ID som förmedlas i requestedForEmailAttribute-standardvärdet 'RequestedFor:email'
  • Artikel-ID som överförs i serviceItemExternalIdAttribute, standard 'ServiceItem' - om värdet för detta attribut är tomt kommer kopplingen att ta värdet från defaultIntegrationServiceItemId i spårningskopplingens konfiguration.

För att den nya incidentavsökningen ska fungera korrekt är följande attribut obligatoriska på ESM-sidan:

  • Incidentidentifierare som förmedlas i efecteIdAttribute, standard 'efecte_id'
  • Status som anges i statusAttribute.default 'status'
  • Kundidentifierare som anges i kundens e-postadress, standard kund:e-postadress
  • Kategori-ID som förmedlas i integrationCategoryAttribute, standard WebShopCategory - om värdet för detta attribut är tomt kommer kopplingen att ta värdet från defaultIntegrationCategoryId i spårningskopplingens konfiguration (en kategori med kategori-ID måste publiceras i ESS)

Pollingfrekvensen kan justeras med hjälp av egenskaperna 'updateFrequency' och 'errorUpdateFrequency' i klassen 'EfecteTrackingConnector'. Värden uttrycks i konfigurerbara enheter.

Obs! Det är mycket sällan nödvändigt att ändra 'updateQuerySlidingWindowTime' från standardinställningen. Pollingdata kommer alltid att inkludera alla datakort som ändras inom tidsperioden, och under den längre tidsperioden returneras samma ärenden gång på gång till resultatmängden. Redan vid första försöket kommer ärendet att uppdateras i ESS. Att göra detta fönster brett kan potentiellt sakta ner driften i både ESS och ESM utan att det ger någon extra fördel.

Namn Standardvärde Beskrivning
uppdateringsfrekvens 10 Uppdateringsperiod när data hämtades
uppdateringsfrekvensenhet MINUTER Frekvensenhet för uppdateringsperiod (lyckad)
felUppdateringsfrekvens 10 Uppdateringsperiod när datahämtning har misslyckats
felUppdateringsfrekvensenhet MINUTER Frekvensenhet för uppdateringsperiod (fel)

När kopplingen körs för första gången hämtar den förfrågningar och incidenter sedan de senaste 24 timmarna. Denna tid kan justeras genom att konfigurera egenskaperna initialQuerySlidingWindowTime och initialQuerySlidingWindowUnit.

Andra standardvärden för Efecte-spårningsanslutningen är:

Namn Standardvärde Beskrivning
uppdateraFrågaGlidandeFönsterTid 20 Från vilken period data hämtas, jämfört med ESM:s senaste uppdateringstid (t.ex. från de senaste 20 minuterna)
uppdateraFrågeGlidandeFönsterEnhet MINUTER Frekvensenhet för uppdateringsperiod (lyckad)
initialQuerySlidingFönsterTid 1 Från vilken period data hämtas i första körningen, jämfört med ESM:s senaste uppdateringstid (t.ex. från de senaste 24 timmarna)
initialQuerySlidingWindowUnit DAGAR Frekvensenhet för uppdateringsperiod (fel)
serviceRequestPollCondition Standardvillkoret för uppdateringar av begäranden om avsökningstjänster
incidentEnkätvillkor Standardvillkoret för uppdateringar av omröstningsincidenter

Konfigurationsexempel:

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

Om egenskapen 'updateQuerySlidingWindowTime' inte är konfigurerad i spårningsanslutningen, kommer värdet 'pollingInterval' multiplicerat med två (2) att användas som standardstorlek för glidande fönster.

Feedbackformulär

Feedbackformulär stöds som standard i ESM-anslutningen. Attribut som används för mappning till ESM-fält kan konfigureras genom att justera egenskaperna för bönans EfecteFeedbackFormConnector-klassen och i det faktiska formuläret via administratörsgränssnittet, fliken Feedbackhantering. Följande egenskaper stöds:

Namn Standardvärde Beskrivning
mallkod feedbackhantering Kod för mall för feedbackformulär
mappkod feed-back Mapp för feedbackformulär
efecteIdAttribute biljett-id Namn på attribut som innehåller ärende-ID
kundattribut kund Namn på attribut som innehåller kundreferens
betygsattribut biljettbetyg Namn på attribut som innehåller numerisk betyg

Exempelkonfiguration av EfecteFeedbackFormConnector inuti EfecteConnector i connector-efecte.xml:

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

Notera

För att ge feedback på ärenden som först registreras i Efectes servicehanteringsverktyg, se till att ärenden först rapporteras till Efectes självbetjäningsportal via spårningsanslutningen. ESS måste ha ärendet i sin databas innan feedback kan ges.

Tips och tricks

Den här funktionen möjliggör import av Knowledge Base från Efecte Service Management-systemet. För mer information, se ConfiguringTipsTricks- uid för komplett konfiguration.

Konfiguration av integrationssviten

Alla konfigurationsfiler för Integration Suite finns i katalogen /etc/integration-hub/ och dess underkataloger. Hyresgästspecifika kopplingar finns under underkatalogerna tenant-configs/{tenant_name}.

För att konfigurera stöd för "Tips & Tricks" i Integration Suite, vänligen redigera filen connector-efecte.xml. Lägg till bönan av klassen "EfecteKnowledgeBaseConnector" och förse den med ESM-anslutningskonfigurationsbönan.

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

Obs! Det är en bra idé att dela anslutningskonfigurationen mellan Efecte-kontakter, så använd följande kod (vanligtvis använd i konfigurationer):

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

kan ersättas med:

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

Konfigurera parametrar för kunskapsbasmall

För att justera namnen på attribut som används i ESM för Knowledge Base kan mallparametrar konfigureras genom att lägga till egenskapen knowledgeBaseAttributes till efecteKnowledgeBaseConnector-bönan. Annars används standardinställningarna.

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

Följande egenskaper för KnowledgeBaseAttributes-klassen böna stöds:

Namn Standardvärde Beskrivning
mallkod kunskapsbasartikel Kod Knowledge Base
pollingMappkod Om pollingFolderCode är definierad hämtas artiklar endast från den här mappen.
Om pollingFolderCode INTE är definierad pollas artiklar utan mappbegränsning.
betygReservmappkod kunskapsbas Namn på reservmappskod som används vid sparning av röst.
uppdateraLässtatistikReservmappkod kunskapsbas Namn på reservmappskod som används vid uppdatering av lässtatistik.
publishedInEssAttr
published_in_self_service
Namn på attribut, som anger om artikeln ska hämtas till ESS
publishedInEssValue
Yes
Värde för attributet som namnges i publishedInEssAttr som anger att artikeln ska hämtas.
deletedAttr
deleted
Namn på attribut, som anger om KB-artikeln är borttagen
nameAttr
solution_name
Namn på attribut som innehåller namnet på KB-artikeln
descriptionAttr
solution_description
Namn på attribut som innehåller innehållet från KB-artikeln
categoryAttr
category
Namn på attribut som innehåller kategorin för KB-artikeln
adGroupsAttr
ad_groups
ESM-attribut som används för Tips & Tricks-filtrering baserat på EIM-rollen för den inloggade användaren
efecteIdAttr
efecte_id
Namn på attribut som innehåller effekt-ID för KB-artikeln
updatedAttr
updated
Namn på attribut som innehåller det senaste uppdateringsdatumet för KB-artikeln
ratingAttr
rating
Namn på attribut, som anger var kunskapsbasfeedback ska lagras
rankingAttr
rating
Namn på attributet, som anger var kunskapsbasrankningen lagras
readStatsAttr
read_count
Namn på attribut som innehåller lässtatistik för KB-artikeln
keywordsAttr
solution_keywords
Namn på attributet som innehåller nyckelorden i en KB-artikel
keywordsSeparator
,
Om en KB-artikel har flera nyckelord måste denna nyckelordsavgränsare användas.

Konfigurera uppdateringsfrekvensen för "Tips och tricks"

Som standard uppdateras kunskapsdatabasen varannan timme om inget fel uppstår. Om ett fel uppstår ändras uppdateringstiden till 2 minuter.

Schemaläggningens startfördröjning (tiden efter vilken connectorn börjar fungera, mätt sedan integrationshubbens start) kan konfigureras med hjälp av egenskapen startUpDelay för connectorScheduler-bönan i hub.xml-filen.

Namn Standardvärde Beskrivning
startfördröjning 20000 Tid (i millisekunder) efter vilken första hämtningen är klar (standard: 20 sekunder)

Exempel från hub.xml:

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

Uppdaterings- och feluppdateringsfrekvenser kan konfigureras i konfigurationen för connector-xml (connector-efecte.xml). Använd följande egenskaper:

Namn Standardvärde Beskrivning
uppdateringsfrekvens 2 Uppdateringsperiod när kunskapsdatabasen hämtades med framgång (standard: 2 timmar)
uppdateringsfrekvensenhet TIMMAR Enhet för uppdateringsperiodfrekvens (lyckad)
felUppdateringsfrekvens 2 Uppdateringsperiod när hämtning av kunskapsbas misslyckas (standard: 2 minuter)
felUppdateringsfrekvensenhet MINUTER Frekvensenhet för uppdateringsperiod (fel)

Exempel från 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>

Gilla min idé

Den här funktionen gör det möjligt att visa och kommentera idéer som lagrats i Efectes servicehanteringssystem.

Alla konfigurationsfiler för Integration Suite finns i katalogen /etc/integration-hub/ och dess underkataloger. Hyresgästspecifika kopplingar finns under underkatalogerna tenant-configs/{tenant_name}.

För att konfigurera stöd för "Like My Idea" i Integration Suite, vänligen redigera filen connector-efecte.xml. Lägg till " http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd " schemaplatser till definitionen av huvudbönor.

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

Lägg till elementet "annotation-config" och en böna av klassen "EfecteLikeMyIdeaConnector" och förse den med en ESM-anslutningskonfigurationsböna. Lägg även till en böna av typen "EfecteConnectorContext".

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

Följande egenskaper för LikeMyIdeaAttributes-klassen stöds:

Namn Standardvärde Beskrivning
mallkod efterfrågehantering_svenska Mallkod för Gilla min idé
pollingMappkod idéer Om pollingFolderCode är definierad hämtas idéer endast från den här mappen. Om pollingFolderCode INTE är definierad hämtas idéer utan mappbegränsning.
betygReservmappkod idéer Namn på reservmappskod som används vid sparning av röst.
publishedInEssAttr
publish_for_rating
Namn på attribut, som anger om artikeln ska hämtas till ESS
publishedInEssValue
Yes
Värde för attributet som namnges i publishedInEssAttr som anger att artikeln ska hämtas.
deletedAttr
deleted
Namn på attribut, som anger om idén är borttagen
created
created
Namn på attribut som innehåller skapandedatum
nameAttr
demand_name
Namn på attribut som innehåller idéns namn
descriptionAttr
demand_details
Namn på attribut som innehåller idéinnehåll
efecteIdAttr
efecte_id
Namn på attribut som innehåller idéns effekt-ID
likesAttr
likes
Namn på attribut som innehåller antalet gilla-markeringar
dislikesAttr
dislikes
Namn på attribut som innehåller antalet ogillade
commentsAttr
comment
Namn på attribut som innehåller kommentarer

Konfigurera uppdateringsfrekvensen för "Gilla min idé"

Som standard uppdateras "gillar mina idéer" varannan timme om inget fel uppstår. Om ett fel uppstår ändras uppdateringstiden till 2 minuter.

Schemaläggningens startfördröjning (tiden efter vilken connectorn börjar fungera mätt sedan integrationshubben startade) kan konfigureras med hjälp av egenskapen startUpDelay för connectorScheduler-bönan i hub.xml-filen. Följ instruktionerna i avsnittet Tips och tricks.

Uppdaterings- och feluppdateringsfrekvenser kan konfigureras i konfigurationen för connector-xml (connector-efecte.xml). Använd följande egenskaper:

Namn Standardvärde Beskrivning
uppdateringsfrekvens 2 Uppdateringsperiod när idéer hämtades med framgång (standard: 2 timmar)
uppdateringsfrekvensenhet TIMMAR Frekvensenhet för uppdateringsperiod (lyckad)
felUppdateringsfrekvens 2 Uppdateringsperiod när idéhämtning misslyckas (standard: 2 minuter)
felUppdateringsfrekvensenhet MINUTER Frekvensenhet för uppdateringsperiod (fel)

Exempel från 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>

Mina tjänster

Mina tjänster är ett vanligt namn för en uppsättning integrationsmekanismer som gör det möjligt för externa system att dynamiskt modifiera innehållet i en katalog som är synlig för användare.

Definiera MinaTjänster-fält

  1. Gå till ESS administratörssida -> Integrationer -> Externa datafält
  2. Tryck på knappen Lägg till MinaTjänster i fältet
  3. Ange konfiguration
    • Fältnamn - ange namnet som ska användas som alias för detta MinaTjänster-fält
    • Data från - välj Efecte Service Management-anslutning
    • Malldata från Efecte Service Management mappad till fältet MinaTjänster (Logga in på Efecte Service Management -> Administration -> Mallar -> välj mall)
      • Mappkod – valfritt, begränsar elementen som ska hämtas till en definierad mapp
      • Mallkod - fyll i med användningsvärde från mallkod
      • Namnattributkod - kod för attributet som används som namn (detta attribut kan vara synligt för användaren)
      • Attributkod för tekniskt ID - kod för attribut som används som DataCard- identifierare (ska markeras som primärt attribut i ESM)
  • Användarattributkod - referens till mall som beskriver användaren som är associerad med denna mall (målmallen måste ha ett e-postattribut för att användarassociationer ska fungera korrekt)
  1. Tryck på knappen Uppdatera – om det inte finns några fel, bör du i tabellen MyServices-fältelement se namnen på DataCards från Efecte Service Management.
    1. Du kan verifiera detta genom att titta på en tabell med DataCards associerade med vald mall i ESM.

Min tjänstekatalog och erbjudande

MinTjänst-post som källa för tjänsteartikel-ID:n

  1. På administratörssidan öppnar du fliken Tjänster och väljer Tjänsteobjekt i ett tjänsteerbjudande
  1. I objektegenskaper öppnar du rullgardinsmenyn Extern datalänk och väljer namnet på fältet Externa data
  2. Från rullgardinsmenyn "Artikel-ID" väljer du det element du behöver.

ID för valt element kommer att användas som artikel-ID när användare gör beställningar för den givna artikeln.

Kopplingar mellan användare och datakort

Connector ansvarar inte bara för att hämta DataCards-information, utan även för:

  • spåra kopplingar mellan DataCards och användare
  • ändra nämnda associationer

För att använda den här funktionen:

  1. På administratörssidan, öppna Tjänst och välj Tjänstobjekt
  1. I egenskaperna för tjänsteobjektet öppnar du rullgardinsmenyn Mina tjänster -länk och väljer namnet på fältet Mina tjänster.
  1. Från rullgardinsmenyn Underobjekt väljer du:
    1. Användare som använder - i det här fallet kommer användaren att visas en lista över DataCards som hen är associerad med
  2. Användaren använder inte - i det här fallet kommer användaren att visas en lista över DataCards som han inte är associerad med

Att skicka en beställning för en serviceartikel kommer att resultera i

  1. Tar bort
  2. Lägger till

koppling mellan användarens beställning och DataCard

Katalogartiklar

Följande ESM-attributdatatyper stöds vid konfigurering av katalogartiklar

Fältnamn ESM-attributtyp
Tekniskt ID Sträng
Namn Sträng
Modell Sträng
Informationssida Sträng
Pris Decimaltal
Månadsprenumeration Decimaltal

Kontaktexempel

<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"/>
              <egendom namn="upplösningstextattribut" värde="upplösning"/>
              <egendom namn="supportPersonAttribut" värde="stödperson"/>
              <egendom namn="tjänsteErbjudandeNamnAttribut" värde="Tjänsterbjudande"/>
              <egendom namn="tjänstElementnamnAttribut" värde="Tjänstobjektnamn"/>
              <egendom namn="serviceItemExternalIdAttribute" värde="Tjänstartikel"/>
              <egendom namn="prisattribut" värde="Pris"/>
              <egendom namn="månadsprenumerationAttribut" värde="Månadsprenumeration"/>
              <egendom namn="begärtförattribut" värde="BegärtFör"/>
              <egendom namn="kostnadsCenterAttribut" värde="Kostnadscenter"/>
              <egendom namn="leveransadressattribut" värde="Leveransadress"/>
              <egendom namn="ordnadAvAttribut" värde="Beställdav"/>
              <egendom namn="ytterligareInformationAttribut" värde="Ytterligareinformation"/>
              <egendom namn="siteIDAttribute" värde="Webbplats-ID"/>
              <egendom namn="webbplatsnamnattribut" värde="Webbplatsnamn"/>
              <egendom namn="requestBundleAttribute" värde="RequestBundle"/>
              <egendom namn="requestBundleNameAttribute" värde="Namnpåbegäran/paket"/>
              <egendom namn="orderedByEmailAttribute" värde="Beställdav:e-post"/>
              <egendom namn="begärtföre-postattribut" värde="Begärtför:e-post"/>
              <egendom namn="kommentarattribut" värde="externa_kommentarer"/>
              <egendom namn="orsakAttribut" värde="användarorsak"/>
              <egendom namn="dedikeradGodkännarattribut" värde="DedikeradGodkännare"/>
              <egendom namn="överlägsenGodkännandeattribut" värde="godkännande_chef"/>
              <egendom namn="totalprisattribut" värde="totalpris"/>
              <egendom namn="kvantitetAttribut" värde="kvantitet"/>
              <egendom namn="totalMånadsprenumerationAttribut" värde="TotalMånadsprenumeration"/>
          </böna>
      </egendom -->
     <!-- egendom namn="godkännandesvarsattribut"> INTE REKOMMENDERAD TILL VARA ÄNDRAD
          <böna class="com.efecte.integration.connector.configuration.ApprovalResponseAttributes">
              <egendom namn="mallkod" värde="godkännande"/>
              <egendom namn="mappkod" värde="godkännanden"/>
              <egendom namn="effekt-ID" värde="efekt_id"/>
              <egendom namn="verkligGodkännare" värde="Faktiskgodkännare"/>
              <egendom namn="godkännandebeslut" värde="Godkännandebeslut"/>
              <egendom namn="orsak" värde="Orsak"/>
              <egendom namn="esmGodkändKod" värde="godkänd"/>
              <egendom namn="esmAvvisadKod" värde="avvisad"/>
          </böna>
      </egendom -->
     <!-- egendom name="efecteTrackingConnector">
          <böna class="com.efecte.integration.connector.efecte.EfecteTrackingConnector">
              <egendom namn="uppdateringsfrågaGlidandefönstertid" värde="20"/>
              <egendom namn="uppdateringsfrågaGlidandeFönsterEnhet" värde="MINUTER"/>
              <egendom namn="initialQuerySlidingWindowTime" värde="1"/>
              <egendom namn="initialQuerySlidingWindowUnit" värde="DAGAR"/>
              <egendom namn="uppdateringsfrekvens" värde="10" />
              <egendom namn="uppdateringsfrekvensenhet" värde="MINUTER" />
              <egendom namn="feluppdateringsfrekvens" värde="10" />
              <egendom namn="felUppdateringsfrekvensenhet" värde="MINUTER" />
              <egendom namn="standardIntegrationstjänstobjekt-ID" värde="STANDARD_SERVICE_ITEM" />
              <egendom namn="pollNyTjänstförfråganAktiverad" värde="falskt" />
             <egendom namn="standardintegrationskategori-ID" värde="STANDARD_EFFEKT_KATEGORI"/>
              <egendom namn="tjänsteförfråganPollvillkor" värde="och $skapare$ = "SefServicePortal"/>
              <egendom namn="incidentPollCondition" värde="och $skapare$ = Webbutik
          </böna>
      </egendom -->
     <!-- egendom namn="feedbackFormConnector">
           <böna class="com.efecte.integration.connector.efecte.EfecteFeedbackFormConnector">
              <egendom namn="feedbackAttributes">
                     <böna class="com.efecte.integration.connector.configuration.FeedbackAttributes">
                         <egendom namn="mallkod" värde="feedbackhantering" />
                         <egendom namn="mappkod" värde="återkoppling" />
                         <egendom namn="efekt-ID-attribut" värde="biljett-id" />
                         <egendom namn="kundattribut" värde="kund" />
                         <egendom namn="betygsattribut" värde="biljettbetyg" />
                     </böna>
               </egendom>
           </böna>
       </egendom --> 
     </böna>
<böna id="efecteKnowledgeBaseConnector" class="com.efecte.integration.connector.efecte.EfecteKnowledgeBaseConnector">
    <egendom namn="anslutningskonfiguration" ref="anslutningskonfiguration"/>
    <egendom namn="kunskapsbasattribut" >
           <böna id="kunskapsbasattribut" class="com.efecte.integration.connector.configuration.KnowledgeBaseAttributes">
                 <egendom namn="mallkod" värde="kunskapsbasartikel"/>
                 <egendom namn="omröstningsmappkod" värde="kunskapsbas"/>
                 <egendom namn="uppdateraLässtatistikFallbackmappkod" värde="kunskapsbas"/>
                 <egendom namn="betygsalternativmappkod" värde="kunskapsbas"/>
                 <egendom namn="publiceradIEssAttr" värde="publicerad_i_självbetjäning"/>
                 <egendom namn="publiceradIEssVärde" värde="Ja"/>
                 <egendom namn="borttagenAttr" värde="raderad"/>
                 <egendom namn="namnAttr" värde="lösningsnamn"/>
                 <egendom namn="beskrivningAttr" värde="lösningsbeskrivning"/>
                 <egendom namn="kategoriAttr" värde="kategori"/>
                 <egendom namn="efektIdAttr" värde="efekt_id"/>
                 <egendom namn="uppdateradAttr" värde="uppdaterad"/>
                 <egendom namn="ratingAttr" värde="betyg"/>
                 <egendom namn="rankingAttr" värde="betyg"/>
                 <egendom namn="läsStatsAttr" värde="läsantal"/>
                 <egendom namn="nyckelordAttr" värde="lösningsnyckelord"/>
                 <egendom namn="nyckelordsavgränsare" värde=","/>
             </böna>
       </egendom>
    </böna>
</bönor>

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • ESS: Konfigurera feedbackhantering
  • ESS: Konfigureringstips och tricks
  • ESS: Efecte Identity Management Connector

Copyright 2026 – Matrix42 Professional.

Matrix42 homepage


Knowledge Base Software powered by Helpjuice

0
0
Expand