Efecte Service Management - Efecte självbetjäningsanslutning
Efecte Service Management - Efecte självbetjäningsanslutning
Skapa serviceförfrågningar från ESS till ESM
För att Efecte Self-Service ska kunna skapa nya eller hämta nya serviceförfrågningar korrekt måste följande attribut och attributkoder finnas och ha ett värde:
- Effekt effekt_id
- statusAttribut - status
- begärtE-postattribut – BegärtFör
- serviceItemExternalIdAttribute – ServiceItem. Om värdet för detta attribut är tomt använder ESS värdet från defaultIntegrationServiceItemId som definierats i Efecte Service Management-anslutningen för ESS.
Om något av de ovan angivna obligatoriska fälten är tomma kommer serviceförfrågan inte att skapas.
Detaljerade regler för behandling av serviceförfrågningar är följande:
- WebShopId - om sådant finns, kommer en uppgradering av en befintlig serviceförfrågan att utföras
- efecte_id - om WebShopId är tomt och det inte finns någon förfrågan i ESS med angivet efecte_id, skapas en ny serviceförfrågan. Om en förfrågan med angivet efecte_id finns i ESS, utförs en uppdatering av den befintliga.
- RequestedFor – en användare med en matchande e-postadress måste finnas i organisationsinformationen i ESS. Om så inte är fallet kommer serviceförfrågan inte att skapas.
- OrderedBy – en användare med en matchande e-postadress måste finnas i organisationsinformationen. Om så inte är fallet kommer serviceförfrågan inte att skapas. Om värdet i fältet är tomt kommer e-postadressen RequestedFor att användas istället.
- ServiceItem - en serviceartikel med exakt samma artikel-ID måste finnas och vara giltig (kontroller utförs även mot arbetskopian i Efecte Self Service). Om det villkoret inte är uppfyllt skapas inte serviceförfrågan i ESS.
- ServiceOffering - om angivet skapas serviceförfrågan med det angivna namnet. Om attributet inte anges kopieras serviceerbjudandets namn från serviceerbjudandet som hittats baserat på ServiceItem i ESS.
- ServiceItemName – om angivet skapas serviceförfrågan med det namnet. Om attributet inte anges kopieras servicenamnet från serviceartikeln som hittats baserat på ServiceItem i ESS.
- Pris / Månadsabonnemang - om det är angivet skapas serviceförfrågan med motsvarande data. Om attributet inte är angivet kopieras attributen från serviceobjektet som hittats baserat på ServiceItem.
- Ytterligare information - om värdet för attributet ytterligare information börjar med "Beskrivning:", kommer kopplingen att ta text efter "Beskrivning:" upp till slutet av raden. Om fältet "Lägg till information" inte börjar med prefixet "Beskrivning:" kommer allt innehåll i attributvärdet att bearbetas.
Ta emot betyg Knowledge Base från ESS till ESM
Användare kan betygsätta kunskapsbasartiklar i ESS om funktionen är aktiverad på ESS. För att aktivera betygsättning av kunskapsbasartiklar på ESM måste följande steg utföras:
- Lägg till attributet "Betyg" i mallen för Knowledge Base
- Sätt AverageHandler till attributet.
- Inga metadata behövs, men om du vill kan du ställa in maxvärdet Pro : 1 och Pro Bar-läge: värde. Dessa inställningar visar värdet som en förloppsindikator.
- Datatyp: Decimaltal. (Genom att ställa in hanteraren ändras datatypen automatiskt av hanteraren)
- Ställ in synlighet: Visa endast i vy
- Spara attributet
- Gå till klassen som attributet finns i
- Bekräfta att attributet har en kod (ska anges automatiskt)
- Konfigurera behörigheterna för attributet
- Se till att betyget är mappat till detta attribut i ESS-konfigurationen.
- Skapa vyer som använder attributet Rating för att visa genomsnittliga betyg för Knowledge Base
Pro
När den är korrekt konfigurerad visas förloppsindikatorn i listvyn och datakortvyn. Den syns även i listvyerna i mobilgränssnittet.

Den har följande inställningar:
- Decimalt utmatningsmönster.
- Maximalt värde.
- Attributkod för maximalt värde i förloppsindikatorn.
- Pro -skala
- Två lägen stöds:
- Värde
- Procentsats
Administratörsinställningar för förloppsindikator (visas för decimaltal):

Publicera servicemeddelanden från ESM till ESS
Publicering av meddelanden från ESM till ESS implementeras med hjälp av följande funktioner:
- Lyssnare, som skickar meddelanden från ESM till ESS med SendDataCardXmlToHttpAction
- En lyssnare, som anger att meddelandet ska upphöra att gälla
- En händelse som utlöser en datakortssparning när meddelandets giltighetstid har löpt ut. Datakortssparningen utlöser den ovan nämnda lyssnaren.

Aktivera servicemeddelanden i en befintlig ESM-ESS-miljö
Importera konfigurationspaketet
Ett konfigurationspaket (efecte-configuration_ESS_ANNOUNCEMENTS.xml), som innehåller mallen för servicemeddelanden och de flesta konfigurationerna, finns tillgängligt. Filerna som nämns nedan finns också tillgängliga som separata filer. Import av konfigurationspaketet ställer automatiskt in de flesta inställningarna och minskar arbetet som krävs för att utföra stegen nedan. Importera konfigurationspaketet via funktionen Importera konfigurationer i underhållsvyn.
Paketet innehåller:
- Mallen för servicemeddelanden.
- Lyssnare.
- Förifyllda plattformsinställningar som måste redigeras efter import.
- Meddelandeköuppgiften.
- Händelsen som utlöser utgångsdatum för meddelande.
Om du importerar paketet kan du hoppa över följande delar:
- Importera mallen för servicemeddelanden och lyssnarna.
- Konfigurera en händelse i mallen för självbetjäningsmeddelanden.
- En del av konfigurationen av MessageQueue-uppgiften. Schemaläggningsinställningar måste ställas in.
Efter en lyckad konfigurationsimport bör du få följande rapport:
Skapade mallar: 1
Skapade datakortlyssnare: 3
Skapade mappar: 0
Skapade roller: 0
Skapade användare: 0
Skapade rapporter: 0
Skapade Dashboard : 0
Schemaläggbara uppgifter skapade: 1
Mallhändelser skapade: 1
Skapade behörigheter: 0
Plattformsinställningar skapade: 3
Skapade layouter: 0
Du kan använda följande avsnitt för att dubbelkolla att alla konfigurationer är korrekta och för att fylla i de delar som behöver konfigureras manuellt efter konfigurationsimporten.
Importera mallen för tjänstemeddelanden och lyssnarna
- Importera mallen för servicemeddelanden till din ESM med hjälp av mallimporten.
- ESM_Mall_ESS_Meddelande_2015_4.xml
- Kontrollera mallens behörigheter och välj vilka roller som har åtkomst till mallen.
- Skapa en mapp "Servicemeddelanden", där mallens datakort kan skapas. Tillåt skapande av servicemeddelandedatakort till den här mappen.
- Importera dessa lyssnare till mallen för självbetjäningsmeddelanden:
- Den första anger ett hjälpvärde för sista åtgärden: 1_presave.set_Last_Action_For_ESS_Announcement.xml
- 2:a skickar meddelandet till ESS: 2_postsave.1.POST_ESS_Announcement_To_ESS.xml
- 3:e raderar meddelandet från ESS: 3_postsave.2.DELETE_ESS_Announcement_From_ESS.xml
Infoga ESS API token i ESM-plattformsinställningarna
- Om din miljö finns i molnet, kontakta servicedesk@efecte.com Efecte Service Desk så kan de leverera ESS API token till dig, som behövs i ESM-ESS-kommunikationen.
- Om din miljö är lokal, gå till ESS global admin och generera API token där.
- Skapa en ny plattformsinställning 'ess.token'.
- Ange värdet för den här inställningen genom att kopiera och klistra in API tokenet i den.
- Det är möjligt att konfigurera namnet på inställningen, men i standardlyssnaren är namnet på inställningen 'ess.token'. Om du ändrar namnet, uppdatera både plattformsinställningen och lyssnaren.
Infoga ESS-hyresgästinställningarna i dina plattformsinställningar
- Skapa en ny plattformsinställning 'ess.tenant'.
- Ange ditt ESS-hyresgästnamn som värdet för den här inställningen, t.ex. mittföretag.
Infoga ESS-URL:en i plattformsinställningarna
- Skapa en ny plattformsinställning 'ess.announcement.url'.
- On-premise: Ange din ESS-URL som värdet för denna inställning, t.ex. https://mycompany.testefecte.com:55443/announcement
- I molnet: Ange din ESS-URL som värdet för denna inställning, t.ex. https://mycompany.efectecloud-dev.com/api/ssc/announcement
- Porten och tjänstnamnet/meddelandet förblir desamma för alla ESS-miljöer.
- Det är möjligt att konfigurera namnet på inställningen, men i standardlyssnaren är namnet på inställningen 'ess.announcement.url'. Om du ändrar namnet, uppdatera både plattformsinställningen och lyssnaren.
Aktivera meddelanden från ESS
- Ställ in "Meddelanden aktiverade" i ESS hyresgästadministration - Inställningar
Konfigurera en händelse i mallen för självbetjäningsmeddelanden

Kontrollera och konfigurera schemalagda uppgifter
- EventTask måste konfigureras för att utlösa händelsen. I de flesta miljöer finns detta och inga ändringar behövs.
- MessageQueueTask måste konfigureras för att rensa och bearbeta om objektet i kön. Standardinställningen är att den körs var 5:e minut.
Kontrollera och konfigurera nätverksinställningar
Se till att meddelandeporten är tillgänglig och att det inte finns några brandväggar etc. som blockerar anslutningar från ESM till ESS-miljön.