Installation och hantering av Quinyx-integration

Inledning

Quinyx är en programvara för personalhantering och schemaläggning. Provet Cloud integreras med Quinyx så att personalens arbetspass kan hanteras i Quinyx. Integrationen hämtar arbetspassen från Quinyx till Provet Cloud, men hanteringen av arbetspassen fortsätter på Quinyx-sidan. HR Gateway Portal, ett tredje element som utvecklats av Provet Cloud-teamet, används för att kartlägga Quinyx- och Provet Cloud-skift med varandra och hantera integrationen.

Notera

Den här guiden förutsätter att du redan har slutfört installationen och implementeringen av ditt Quinyx-konto och att du använder systemet.

Inställningar för integration

1. Hämta Quinyx API-nyckel och inloggningsuppgifter till portalen.

  1. Kontakta Quinyx support och be om API-nyckeln för root unit för Provet Cloud-integration.

  2. Vidarebefordra nyckeln till din kontaktperson på Provet Cloud.

  3. Kontaktpersonen gör nödvändiga justeringar och återkommer till dig med adressen till HR Gateway Portal (URL) och inloggningsuppgifter. Du kommer att behöva dessa i nästa steg.

2. Ställ in antal anställda.

För att integrationen ska fungera måste du se till att Provet Clouds anställningsnummer matchar badgenumren i Quinyx.

För varje medarbetare som behöver involveras:

  1. Gå till sidan People i Quinyx.

  2. Hitta den önskade medarbetaren.

  3. Hitta Badge-nummer.

  4. Gå till Inställningar > Användare i Provet Cloud.

  5. Redigera motsvarande användare i Provet Cloud och lägg till badgenumret i fältet Employee number.

2022-03-25_12-02-37__1_.png

3. Be användarna att begränsa möten utanför skift (VALFRI).

När du redigerar eller tar bort skift från Quinyx kommer motsvarande skift på Provet Cloud-sidan också att uppdateras eller tas bort. Det skiftet kan redan ha några möten på det, och föräldralösa möten kan inträffa när detta inte är begränsat. Med begränsningen kommer ett motsvarande fel att visas på HR Gateway Portal Log -sidan (beskrivs nedan).

För denna begränsning måste användarna redigera sina profiler i Provet Cloud:

  1. Gå till din Användarprofil från menyn uppe till höger i Provet Cloud.

  2. Öppna profilen för redigering.

  3. Kryssa i alternativet Ingen schemaläggning utanför skift.

  4. Spara.

2022-03-25_13-06-40.png

4. Konfigurera organisationsinställningarna.

Från och med detta steg behöver du tillgång till HR Gateway Portal med den webbadress som nämns i steg 1. När du har loggat in bör du automatiskt komma till organisationsinställningarna. Om inte, navigera till Inställningar > Organisation i HR Gateway-portalen.

Screenshot_2022-03-27_at_16.44.04.png

Konfigurera följande inställningar. Observera att vissa kanske redan har konfigurerats av din Provet Cloud-kontakt - i så fall ska du låta dem vara kvar. Vissa av inställningarna kan också vara inställda på skrivskyddade, vilket är normalt.

Integration aktiverad: Detta måste vara markerat för att integrationen ska fungera.

E-postadresser för aviseringsmottagare: Välj e-postmeddelanden som ska få aviseringar om fel relaterade till möten och skift i Provet Cloud. Detta är organisationsspecifikt, vilket innebär att om det finns ett fel på någon av dina klinikplatser kommer mottagarna att få ett e-postmeddelande om detta.

OBS: Om ett fel inträffar kommer den relaterade åtgärden inte att utföras.

Tidszon: Tidszonen i Quinyx, HR Gateway Portal och Provet Cloud måste stämma överens.

Importintervall: Ställ in frekvensen för automatisk import av skift per dag. Den föreslagna standardinställningen är "Varje 24 timmar", vilket innebär att importen körs automatiskt en gång per dag runt midnatt. Alternativet "Manuell" finns också tillgängligt. Importen är då inte automatiserad utan måste göras manuellt från inställningarna för klinikplatsen i HR Gateway Portal.

URL för inmatningssystem: Obligatoriskt, konfigureras vanligtvis av din Provet Cloud-kontakt.

Ange systemets API-nyckel: Obligatoriskt, konfigureras vanligtvis av din Provet Cloud-kontakt.

URL för utdatasystem: Obligatoriskt, konfigureras vanligtvis av din Provet Cloud-kontakt.

API-nyckel för utdatasystem: Obligatoriskt, konfigureras vanligtvis av din Provet Cloud-kontakt.

För att slutföra:

  1. Välj Spara inställningar.

  2. Välj Synkronisera alla data.

Notera

Synkroniseringsknappen kommer inte att visas om inte alla obligatoriska fält är ifyllda.

5. Konfigurera inställningarna för klinikens placering.

Screenshot_2022-03-27_at_17.01.58.png

Efter synkroniseringen bör dina klinikplatser visas i menyn till vänster. Välj en klinikplats i menyn till vänster och konfigurera följande nödvändiga inställningar. Observera: Konfigurera alla nödvändiga inställningar innan du aktiverar integrationen.

  1. Quinyx klinikplatser: Välj den klinikplats i Quinyx som du vill kartlägga med den valda Provet Cloud-klinikplatsen.

  2. Välj Spara huvudinställningar.

  3. Mappning av skifttyp: Mappa Quinyx-skift till Provet Cloud-skifttyperna som visas till vänster. Namnen på växlarna i Quinyx och Provet Cloud behöver inte vara identiska.

    • Om skiftet ska tillåta onlinebokning, kartlägg det med hjälp av kolumnen "Skifttyp för onlinebokning".

    • Om skiftet är ett vanligt skift, kartlägg det med hjälp av kolumnen "Quinyx skifttyp".

  4. Välj Spara underinställningar längst ner på sidan.

  5. Importera periodtyp: Välj mellan fasta datum och fast längd.

    • Fasta datum - Arbetspass från det valda datumintervallet importeras. När du gör inledande tester (beskrivs nedan) rekommenderar vi att du använder det här alternativet med en dag som datumintervall. Båda dagarna inkluderas. Observera att importen endast kommer att göras för framtida datum.

    • Fast längd - Definiera en varaktighet som börjar från dagens datum. De skift som ligger inom denna tidsperiod kommer att importeras.

  6. Integration aktiverad: Aktivera integrationen genom att markera respektive inställning högst upp på sidan.

  7. Välj Spara huvudinställningar.

Översikt över andra inställningar för klinikens placering

E-postadresser för aviseringsmottagare: I likhet med inställningen för organisation gör den här inställningen det möjligt att skicka felmeddelanden till utvalda e-postmeddelanden, men i det här fallet endast om fel som inträffar på den utvalda klinikplatsen.

Avdelningar och team aktiverade: Tillåter mappning och import av avdelnings- och teaminformation och aktiverar alternativen Mappning av avdelningar och Mappning av team.

Varaktighet för en slot som används: Gör det möjligt att dela upp skift i mindre, lika stora block när de importeras till Provet Cloud. Har samma effekt som kryssrutan "Varaktighet för en lucka" i Provet Clouds kalender. Observera att slottiderna också måste mappas längst ner på inställningssidan, om de används.

Kalenderfackets storlek: Används tillsammans med inställningen för varaktighet som nämns ovan.

Importera endast publicerade skift: Aktiverad som standard och rekommenderas. Om det är aktiverat kommer opublicerade (utkast) skift inte att importeras från Quinyx.

Notera

När alla nödvändiga inställningar för klinikens plats har konfigurerats väljer du Save main settings och Save subsettings. Integrationen är nu redo för testning.

6. Testa integrationen.

Ett enkelt arbetsflöde för testning föreslås här. Observera att det verkliga installationsscenariot vanligtvis innebär en bredare datumperiod för importören, så se till att konfigurera om innan den verkliga användningen.

  1. Skapa en testanvändare i både Provet Cloud och Quinyx och koppla dem till badgenumret enligt beskrivningen ovan.

  2. I HR Gateway Portal ställer du in klinikplatsen Importperiodtyp till "Fasta datum" och ställer in start- och slutdatum till att vara samma dag, en fritt vald dag i framtiden. Kom ihåg att Spara huvudinställningarna.

  3. Planera ett arbetspass för testanvändaren i Quinyx för det valda datumet. Skiftstrukturen måste följa de krav som nämns nedan.

  4. Publicera testanvändarens schema i Quinyx. OBS: När du publicerar kan du ställa in publiceringsdatumet - det ska aldrig läggas till det förflutna.

  5. I portalen väljer du Manuellt importera skift från klinikens platsinställningar. En kort laddningsprocess kommer att äga rum.

  6. Det importerade skiftet bör nu visas i Provet Cloud. Kontrollera att skifttypen är korrekt för att verifiera att mappningen gjordes på rätt sätt.

Notera

Vid utgivning av skift i Quinyx ska utgivningsdatum aldrig läggas i det förflutna.

Screenshot_2022-03-27_at_21.07.03.png

Om det inledande testet är framgångsrikt rekommenderas att man gradvis ökar testkomplexiteten för att lösa eventuella problem och komma fram till det verkliga användningsfallet:

  1. Testa alla skifttyper med testanvändaren.

  2. Testa med riktiga användare, med ett verkligt scenario, men med en dags installation som i det första testet.

  3. Öka perioden till en vecka och testa igen.

  4. Byt till fullständig installation och automatisering. Se till att planera övergången i god tid och kommunicera med all nödvändig personal.

Lämplig testning bör utföras efter alla ändringar av integrationsuppsättningen.

Notera

En fellogg kan ses på HR Gateway Portalens Log-sida, i den övre menyraden, bredvid inställningarna. Se avsnittet fellogg nedan.

Inställning av skift i Quinyx

De skift som kommer in i Provet Cloud genom integrationen är faktiskt Tasks under skiften i Quinyx.

I bilden nedan skulle de uppgifter som är markerade med grön och röd färg importeras till Provet Cloud som skift, om Quinyx-skiftet är korrekt mappat. Om Quinyx-skiftet lämnas "tomt" utan några uppgifter importeras ingenting till Provet Cloud.

Det rekommenderas att de relevanta skifttyperna utformas i Quinyx så att de redan har de uppgifter som behövs.

Screenshot_2022-03-27_at_21.54.04.png

Efter importen ser de resulterande skiften ut enligt nedan. Observera att skiftet "Lunch break" inte skapades eftersom det inte var mappat.

Screenshot_2022-03-28_at_09.46.22.png

Kontroll av alternativet för onlinebokning

Importerat skift som har aktiverat onlinebokning

Om du behöver en skifttyp där Provet Clouds onlinebokningsfunktionalitet är aktiverad, följ dessa steg:

  1. I Provet Cloud ska du se till att du har ställt in skifttypen med aktiverad onlinebokning.

  2. Skapa motsvarande skifttyp i Quinyx.

  3. Gå till HR Gateway Portal och öppna inställningarna för klinikens placering.

  4. Mappa skifttyperna till varandra med hjälp av kolumnen Skifttyp för onlinebokning.

  5. Välj Spara underinställningar längst ner på sidan.

Importerat skift som ibland har onlinebokning aktiverad

I vissa fall kanske du regelbundet vill bestämma på Quinyx-sidan om skiftet har aktiverat onlinebokning eller inte. I så fall kan du ställa in mappningen så att Provet Cloud-passet mappas till två liknande Quinyx-pass beroende på valet av onlinebokning.

  1. I Provet Cloud ska du se till att du har ställt in skifttypen med aktiverad onlinebokning.

  2. I Quinyx skapar du två liknande skift och namnger dem så att du kan känna igen vilket som är avsett för onlinebokning. Till exempel:

    • Workday ingen onlinebokning

    • Arbetsdag

  3. Gå till HR Gateway Portal och öppna inställningarna för klinikens placering.

  4. Kartlägg Quinyx-skiftena till Provet Cloud-skiftena:

    • Arbetsdag ingen onlinebokning - Quinyx Skifttyp kolumn

    • Workday - Skifttyp för onlinebokning kolumn

  5. Välj Spara underinställningar längst ner på sidan.

Efter installationen, när du bokar skift i Quinyx, väljer du lämplig typ för att fatta beslutet. Beroende på valet kommer skiftet att ha onlinebokning aktiverad i Provet Cloud eller inte.

OBS: Lämplig testning bör utföras efter alla ändringar av integrationsuppsättningen.

Screenshot_2022-03-28_at_10.37.26.png

Avdelningar och team

Om klinikplatsen använder team och/eller avdelningar kan integrationen användas för att välja dem för Provet Cloud-skift som importeras. Avdelningar kan användas oberoende av varandra, men team kräver att avdelningar används eftersom de är en underenhet till en avdelning.

1. Aktivera avdelningar och team från portalen.

  1. Gå till HR Gateway Portal och öppna inställningarna för klinikens placering.

  2. Aktivera Avdelningar och lag aktiverade. Detta kan också göras under den första installationen.

  3. Bestäm källan för avdelningsinformation i Quinyx med hjälp av menyn Ward source. Det rekommenderade alternativet är "Main shift's section field".

  4. Bestäm informationskällan för teamet i Quinyx med hjälp av menyn Team source. Det rekommenderade alternativet är "Huvudskiftets kategorifält (skifttyp)".

  5. Välj Spara huvudinställningar.

Screenshot_2022-03-28_at_10.55.52.png

2. Konfigurera källorna i Quinyx.

De källor som valdes i steg 1 måste skapas och/eller konfigureras i Quinyx.

För att konfigurera ett huvudskifts sektionsfält (för avdelningskällan ):

  1. Gå till Kontoinställningar från den personliga menyn i Quinyx.

  2. Välj Group management från den vänstra menypanelen.

  3. Välj önskad enhet från mitten. En konfigurationspanel öppnas.

  4. Välj Lägg till avsnitt från panelen.

  5. Fyll i sektionsfälten med information om avdelningen.

  6. Välj Ok för att spara.

När avdelningar har skapats som sektioner visas de som alternativ under huvudskiftets fält Section (bilden nedan).

Så här konfigurerar du skifttypen för ett huvudskift (för teamkälla):

  1. Gå till Kontoinställningar från den personliga menyn i Quinyx.

  2. Gå till Skifttyper från den vänstra menypanelen.

  3. Välj Lägg till längst upp till höger.

  4. Skapa teamet som en skifttyp genom att fylla i fältet Namn och se till att varaktigheten täcker (start- och sluttid) den normala tidsramen för skiften.

  5. Välj Spara.

3. Kartlägg avdelningar och team i HR Gateway Portal.

Detta steg förutsätter att du redan har avdelningar och team som är konfigurerade i Provet Cloud efter behov.

Kartläggning av avdelningar:

  1. Gå till HR Gateway Portal och öppna inställningarna för klinikens placering.

  2. Bläddra ner till avsnittet Wards mapping.

  3. För varje Provet Cloud-avdelning, kartlägg en Quinyx-avdelning.

Kartläggning av team.

  1. Bläddra till avsnittet Teams mapping i portalens inställningar för klinikens plats.

  2. För varje Provet Cloud-team, kartlägg en Quinyx Shift-typ (kategori).

För att slutföra, välj Spara delinställningar längst ner på sidan.

Testning och användning

Om de konfigureras enligt beskrivningen ovan kan avdelningarna och teamen nu anges när du skapar skift i Quinyx.

Se till att testa installationen med testanvändaren enligt beskrivningen ovan.

Sammanfattningsvis:

  1. Själva informationen shift kommer från Tasks.

  2. Informationen på avdelningen kommer från Avsnitt.

  3. Informationen i team kommer från Shift typ.

2022-03-28_12-16-37.png

Markera en frånvaro

Ibland har en medarbetares arbetspass redan planerats och importerats till Provet Cloud, men på grund av medarbetarens frånvaro måste arbetspassen uppdateras (tas bort).

För att markera en frånvaro:

  1. Se till att relaterade möten i Provet Cloud-kalendern har flyttats eller tagits bort först.

  2. Gå till Schema i Quinyx.

  3. Leta reda på skiftet och markera det.

  4. Välj Fler alternativ.

  5. Längst ner i dialogen väljer du Lägg till frånvaro.

  6. Fyll i frånvaroblanketten och välj Spara. Arbetspasset flyttas till avsnittet "Ej tilldelade arbetspass".

  7. Ta bort arbetspasset från avsnittet "Ej tilldelade arbetspass". Detta är viktigt eftersom arbetspasset annars inte kommer att tas bort från Provet Cloud, vilket kommer att ske vid automatisk eller manuell import.

Screenshot_2022-03-28_at_12.44.36.png

Synkronisering och sparande

När konfigurationsändringar görs i Provet Cloud eller Quinyx som påverkar skift, avdelningar eller team måste ändringarna synkroniseras i HR Gateway Portal.

  1. Gå till Organisationsinställningar i HR Gateway Portal.

  2. Välj Synkronisera alla data.

Exempel på fall där synkronisering krävs:

  • En skifttyp skapas eller redigeras i Provet Cloud.

  • En klinikplats skapas i Provet Cloud.

  • En avdelning skapas eller redigeras i Provet Cloud.

  • En skifttyp skapas eller redigeras i Quinyx.

  • En enhet skapas i Quinyx.

  • Ett avsnitt skapas eller redigeras i Quinyx.

När ändringar görs i HR Gateway Portal ska ändringarna alltid sparas med Spara inställningar, Spara huvudinställningar och Spara underinställningar på respektive sida.

När ändringar görs i mappningarna i portalen bör de testas enligt beskrivningen ovan. Testning kan spara mycket arbete, eftersom felaktigt importerade skift måste tas bort manuellt.

2022-03-28_13-03-28__1_.png

Fel loggar

I HR Gateway Portal finns en flik Log i den övre menyraden som ger detaljerad information om in- och utmatningsfel. Loggavsnitten är organisationsövergripande, vilket innebär att fel från alla klinikplatser listas i dem.

Inmatningsfel - Fel relaterade till problem med att ansluta till Quinyx. Inmatningsfel är sällsynta och de kräver vanligtvis hjälp från Provet Cloud-support.

Utdatafel - Fel relaterade till import av skift till Provet Cloud. Dessa är vanligare, relaterade till felaktiga mappningar, saknade anställningsnummer och liknande.

När personer får felmeddelanden via e-post, enligt beskrivningen ovan, är det lämpligt att först kontrollera felloggarna, särskilt utmatningsfelen.

Sökfältet i loggen kan användas för att filtrera poster efter:

  • Enhetens namn

  • ID för databasskift

  • Quinyx skift ID

  • Felkod

  • Person-ID/anställningsnummer

Om du vill se detaljerad information om ett fel väljer du Visa felmeddelande.

Screenshot_2022-03-28_at_13.22.26.png

Se även

Felsökning

Uppdaterad

Var denna artikel till hjälp?

0 av 0 tyckte detta var till hjälp

Har du fler frågor? Skicka en förfrågan

Kommentarer

0 kommentarer

logga in för att lämna en kommentar.