Integration - Lifecare

Med vår standardiserade integration mot Lifecare hämtas avvikelsestatistik automatiskt in till Stratsys.

Artikeln består av följande delar:

Lösningsbeskrivning

Förutsättningar

Inför uppstart

Uppsättningsguide

Loggning

Förvaltning och underhåll

Felsökning

---

Lösningsbeskrivning

Integrationen hämtar avvikelsedata från Lifecare. Den aggregerar antalet avvikelser per organisationsenhet med månadsperiodicitet. Resultatet landar som ett utfall i ett nyckeltal i Stratsys. Integrationens baseras på er egen uppsättning av avvikelsetyper i Lifecare.

Integrationen hämtar data från Lifecare varje natt, och hämtar då data för innevarande månad samt tre månader bakåt i tiden.

Vid behov finns möjligheten att manuellt sätta igång en körning av integrationen. Du kan med den manuella körningen även hämta data från längre bak i tiden

Avvikelserna summeras utifrån avvikelsetyp. En unik avvikelsetyp i Stratsys består av en kombination av en rapporttyp och en avvikelsetyp i Lifecare. Det innebär att lösningen har stöd för att särskilja statistik för avvikelsetyper med samma namn, men som ligger under olika rapporttyper.

Så här går det till

När Integrationen är aktiverad så har ni möjlighet att välja in avvikelser från Lifecare baserat på avvikelsetyperna ni använder i Lifecare. Avvikelserna skapas upp som måttnoder i Stratsys dit integrationen hämtar in er avvikelsedata .

Måttlistan från Lifecare baseras på avvikelsetyperna som ni använder i er instans av Lifecare.

När kopplingen är gjord kommer det hämtas in statistik till avvikelsen i Stratsys. Integrationen uppdateras varje natt och uppdatering oftare än så är möjlig genom att manuellt sätta igång integrationen i Stratsys plattform center.

Förutsättningar

Följande förutsättningar behöver vara uppfyllda för att kunna integrera mot Lifecare:

• Ni har en API-nyckel för Lifecares API "API Avvikelsehantering Grunddata" som kan användas av Stratsys. Notera att API-nyckeln från Lifecare bara kan användas av ett system vilket innebär att ni behöver beställa en ny nyckel för integrationen mot Stratsys. Är ni osäkra på om ni har en nyckel, kontakta er kundansvarige på TietoEvry.
• Lifecare-API:et behöver vara exponerat publikt (på internet) och vara nåbart från Stratsys publika IP-adresser som används för utgående anrop för Stratsys tjänster.  

Inför uppstart

• Beställ API-nyckel för Lifecares API "API Avvikelsehantering Grunddata" av TietoEvry. Vid beställning hos TietoEvry, var tydlig med att det är Avvikelsehanterings-API:t (Deviation API WESE.Deviation.API.Deviation) vi ska ha åtkomst till.
• Stratsys klientcertifikat ska skickas av kund till TietoEvry på we.api@tietoevry.com. Ni får mer information av er Stratsyskonsult när projektbeställning har lagts.

Uppsättningsguide i Stratsys

1. Konfigurera koppling mot Lifecare

När integrationen har aktiverats i plattformen av oss på Stratsys visas upp en Lifecare-meny under "Integrationer" i plattformen. 

 

1. Klicka på Lifecare-menyn under Integrationer i vänstermenyn och välj fliken Inställningar
2. Aktivera integrationen genom att slå på toggeln Aktiverad
3. Ange inställningar för integrationen. Följande inställningar har ni fått av TietoEvry vid beställning av API-nyckel:
   1. Host-adress (anges som "API-URL")
   2. API-nyckel 
   3. Domän
4. Ange namnet på er Stratsys-databas  i fältet "Integrera mot specifik Stratsys-databas". Namnet är den första delen av den url som visas när ni är inloggade i Stratsys; i bildexemplet nedan "allproducts".
   
   
5. Ange en e-postadress till en eller flera kontaktpersoner. Den eller dessa får information om integrationen vid behov av åtgärder.
   

2. Mappa organisationen med enhetskoder från Lifecare

För att data ska hamna på rätt enheter i Stratsys så behöver en mappning göras mellan enheterna i Stratsys organisationsträd och enheterna i Lifecare. Inläsning av data kommer endast ske för mappade enheter. 

1. I plattformsadministrationen för Lifecare, välj fliken Enheter
2. Klicka på enheten i Stratsys organisationsträd som ska mappas
3. I fältet "Enhetskod" som visas till höge anges namnet på motsvarande enhet i Lifecare. Det går att ange flera enhetskoder från Lifecare för en och samma Stratsysenhet. Välj i så fall "Lägg till" för att skapa en ny rad. I detta fall kommer data summeras till enheten i Stratsys

3. Skapa integration i Stratsys

1. Gå till administrationen i Stratsys genom att klicka på kugghjulet längst upp i högra hörnet.

2. Välj Källsystem och externa koder i vänstermenyn

3. Klicka på lägg till längst ner på sidan och ange namnet för ditt källsystem - förslagsvis Lifecare. Lägg till en beskrivning om du önskar, exempelvis "Automatisk inläsning av avvikelsestatistik från Lifecare". Spara.

4. Välj sedan Lägg till under Integrationer

5. Välj alternativet måttkolumndata i drop-down menyn och spara. Inga ytterligare uppgifter behöver fyllas i här.

4. Skapa avvikelser i Stratsys och koppla ihop dem med Lifecare

Börja med att gå till vyn i Stratsys där ni ska skapa upp avvikelserna.

1. Klicka på + för att skapa upp en ny nod
2. Klicka på Välj in från Lifecare. 
3. Klicka på + Välj in. Här dyker alla avvikelser som ni har registrerat avvikelser på Lifecare, observera att den kan skilja sig från den i bilden då listan utgår från avvikelserna som finns i er instans av Lifecare.

4. Välj vilken måttmall som måttet ska skapas upp med. Under införandeprojekt skapas en måttmall för avvikelserna som ska hämtas från Lifecare. Klicka på Skapa.

5. Välj vilken måttdatakolumn som data från Lifecare ska läsas in i i den vänstra rullistan. I den högra rullistan kommer det endast finnas ett alternativ, Utfall, så där behöver inte val göras. Klicka sedan på Skapa.
6. Fördela måttet till enheterna som data ska läsas in till.

5. Integrationen är klar - när kommer data?

Nu är allt konfigurerat. Antingen triggar ni igång integrationen manuellt för att se utfallen direkt, eller så inväntar ni den nattliga körningen. Skapar ni upp ett nytt avvikelsemått efter att integrationen redan har varit aktiverad sedan tidigare så dyker data upp direkt då måttet skapas. Integrationen körs automatiskt klockan 02:00 varje natt. 

 

Manuell körning av integrationen

Har ni behov av att uppdatera data omedelbart, eller om ni har behov av att uppdatera data längre bak i tiden än tre månader, så går det att uppdatera data manuellt.

1. I plattformsadministrationen för Lifecare, gå till fliken "Körning för specifika månader"
2. Markera de månader som ni vill uppdatera data för.
3. Klicka på Kör integration, måtten uppdateras då automatiskt för de månader du valt

Loggning av integration

Varje uppdatering av data från Lifecare loggas i Stratsys plattform center, oavsett om den görs automatiskt eller sätts igång manuellt. 

Är bilden för liten? Öppna upp den i ett nytt fönster genom att högerklicka på den och välja "öppna i ny flik".

1. Gå till Stratsys Plattform Center och klicka på Lifecare under Integrationer i vänstermenyn.

2. Välj fliken Loggar. Här ser du varje körning som en egen rad med information om:

• Det är en manuell eller automatisk uppdatering
• Datum och tidpunkt för uppdateringen
• Antal uppdaterade enheter: Hur många enheter som uppdaterats med ny data
• Från och till datum: Vilket intervall som data uppdaterats för
• Åtgärd krävs: Visar en symbol ifall någon åtgärds krävs för att all data som hämtats från Lifecare skall kunna läsas in till Stratsys

3. För att få mer information om en specifik uppdatering så kan du klicka på aktuell loggrad. Då öppnas loggdetaljer till höger. Här kan du också se detaljer för de eventuella åtgärder som behöver utföras för att all data skall hamna på rätt plats. Notera att denna information inte skickas ut som e-post.

Förvaltning och underhåll

Primär kontaktperson och mejlnotiser

Primär kontaktperson skall sättas för att ansvarig person hos er ska få nödvändig information.

E-post kommer skickas:

• Vid problem som innebär att integrationen inte har kunnat genomföras
• När nya avvikelsedata finns att hämta från Lifecare, se nedan.
• När data för enheter som inte är mappade upptäckts, se nedan.

Hämta data för nya avvikelsetyper

När det finns en ny avvikelsetyp att hämta in data för så kommer personen som är satt som Primär kontaktperson att få ett e-post-meddelande om detta.

Notisen om ny avvikelsetyp kommer endast skickas en gång, vilket är vid första tillfället då en ny avvikelsetyp upptäcks. För att möjliggöra inläsning av de nya avvikelserna, följ instruktionen här.

Mappning av organisationsträdet

Vid organisationsförändringar som innebär att det tillkommer nya enheter antingen i Stratsys, i Lifecare eller båda systemen som det ska hämtas in avvikelsedata för så behöver detta kompletteras med i organisationsmappningen i Stratsys plattform center.

När det finns en ny enhet i Lifecare att hämta in data för så kommer personen som är satt som Primär kontaktperson att få ett e-post-meddelande om detta. Notisen om ny enhet kommer endast skickas en gång, vilket är vid första tillfället då en ny enhet upptäcks. För att möjliggöra inläsning av data för de nya enheterna, följ instruktionen här.

Felsökning

Data stämmer inte, vad gör jag?

1. Kontrollera om det finns någon åtgärd som krävs i Loggarna i Stratsys plattform center.
   Om du missat att mappa någon enhet så läses inte data in där och kan leda till differenser mellan Lifecare och Stratsys.
   
   
2. Finns det någon Åtgärd krävs som indikerar på att det tillkommit någon ny enhet som behöver mappas (samt att du vill få in data för denna enhet) följ instruktionen:

   Mappa organisationen med enhetskoder från Lifecare

 

3. Visas det mer data i Stratsys än i Lifecare så kan ni behöva se över vilka filter som används i Lifecare så att avvikelser oavsett status visas. Integrationen läser in samtliga avvikelser som är registrerade.