ESS: Efecte Service Management-anslutning
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. |
|
|
Namn på attribut, som anger om artikeln ska hämtas till ESS |
|
|
Värde för attributet som namnges i publishedInEssAttr som anger att artikeln ska hämtas. |
|
|
Namn på attribut, som anger om KB-artikeln är borttagen |
|
|
Namn på attribut som innehåller namnet på KB-artikeln |
|
|
Namn på attribut som innehåller innehållet från KB-artikeln |
|
|
Namn på attribut som innehåller kategorin för KB-artikeln |
|
|
ESM-attribut som används för Tips & Tricks-filtrering baserat på EIM-rollen för den inloggade användaren |
|
|
Namn på attribut som innehåller effekt-ID för KB-artikeln |
|
|
Namn på attribut som innehåller det senaste uppdateringsdatumet för KB-artikeln |
|
|
Namn på attribut, som anger var kunskapsbasfeedback ska lagras |
|
|
Namn på attributet, som anger var kunskapsbasrankningen lagras |
|
|
Namn på attribut som innehåller lässtatistik för KB-artikeln |
|
|
Namn på attributet som innehåller nyckelorden i en KB-artikel |
|
|
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. |
|
|
Namn på attribut, som anger om artikeln ska hämtas till ESS |
|
|
Värde för attributet som namnges i publishedInEssAttr som anger att artikeln ska hämtas. |
|
|
Namn på attribut, som anger om idén är borttagen |
|
|
Namn på attribut som innehåller skapandedatum |
|
|
Namn på attribut som innehåller idéns namn |
|
|
Namn på attribut som innehåller idéinnehåll |
|
|
Namn på attribut som innehåller idéns effekt-ID |
|
|
Namn på attribut som innehåller antalet gilla-markeringar |
|
|
Namn på attribut som innehåller antalet ogillade |
|
|
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
- Gå till ESS administratörssida -> Integrationer -> Externa datafält
- Tryck på knappen Lägg till MinaTjänster i fältet
- 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)
- 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.
- 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
- På administratörssidan öppnar du fliken Tjänster och väljer Tjänsteobjekt i ett tjänsteerbjudande
- I objektegenskaper öppnar du rullgardinsmenyn Extern datalänk och väljer namnet på fältet Externa data
- 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:
- På administratörssidan, öppna Tjänst och välj Tjänstobjekt
- I egenskaperna för tjänsteobjektet öppnar du rullgardinsmenyn Mina tjänster -länk och väljer namnet på fältet Mina tjänster.
- Från rullgardinsmenyn Underobjekt väljer du:
- Användare som använder - i det här fallet kommer användaren att visas en lista över DataCards som hen är associerad med
- 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
- Tar bort
- 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>