Så här tar du i bruk IN-gränssnittet
Integration från ett annat system till SDL förutsätter att man ansöker om användningstillstånd.
Om du håller på att göra en helt ny IN-integration i SDL, följ de Grundläggande anvisningarna för ibruktagning av IN-integration.
Om du håller på att ta i bruk en IT-leverantörs färdiga IN-integration i SDL (t.ex. Pinmeto eller Fonecta Connect), ska du följa anvisningen IN-integration från en IT-leverantörs system till SDL.
Om du upprätthåller din organisations idrottsplatsinformation i LIPAS-systemet och vill importera uppgifterna till SDL, följ anvisningen om IN-integration från LIPAS.fi till SDL.
Om du inte vet vilken anvisning du ska följa, kontakta ptv-tuki@dvv.fi.
Säkerställ förutsättningarna för att ta i bruk IN-gränssnittet
Din organisation kan genomföra IN-integrationen i SDL endast om den har ett eget system där datan är
- aktuell
- kundorienterat beskriven
- och strukturellt kompatibel med SDL-datamodellen.
Om systemen är mycket olika eller källsystemets data inte underhålls regelbundet, ska IN-integrationen inte genomföras. Sådana integrationer är dyra, svåra att underhålla och leder till ett betydande antal tekniska felutredningar som sysselsätter både kunden och MDB.
Gör en datamodellkartläggning
I början av integrationsgenomförandet ska din organisation göra en datamodellkartläggning mellan källsystemet och SDL för att säkerställa datakompatibilitet. Läs mer om SDL:s datamodell.
Det lönar sig att använda tillräckligt med tid och resurser för detta skede för att integrationen ska fungera och för att undvika onödiga störningar i produktionsfasen samt data av dålig kvalitet som inte kan utnyttjas vidare. Vänligen involvera de personer som ansvarar för SDL-datakvalitet och kundorientering i din organisation i kartläggning.
Var beredd på att utveckla källsystemet
Om data i din organisations källsystem inte till alla delar motsvarar SDL:s datamodell eller kvalitetskrav, men man ändå vill genomföra IN-integrationen, ska din organisation förbereda sig på att utveckla sitt system eller förbättra datakvaliteten så att den blir kompatibel med SDL innan integrationen genomförs. Till exempel ska obligatoriska datafält som saknas läggas till i systemet och posterna ändras till samma format som i SDL.
Ett annat alternativ är att producera data från vissa textfält som saknas maskinellt. Om man gör på detta sätt ska din organisation se till att den data som produceras är kundorienterad.
Ansök om användningstillstånd
Ansök om användningstillstånd på sidan Så här ansöker du om användningstillstånd enligt anvisningarna.
Om er organisation redan har tagit i bruk Suomi.fi-servicedatalagret och endast behöver användningstillstånd för IN-integrationen, kan ni ansöka om detta genom att logga in med stark autentisering på sidan Suomi.fi-serviceadministration och klicka på Ansök om användarlicens under rubriken Servicedatalager.
Säkerställ överföringen av aktuell data
Integrationen ska genomföras så att ändringar som ska göras i datan i källsystemet regelbundet förs in i SDL. Kvaliteten på och aktualiteten hos alla tjänster och servicekanaler ska dessutom kontrolleras regelbundet i källsystemet, dock minst en gång om året.
Introduktion till dem som underhåller data
Det är viktigt att innehållsproducenterna i källsystemet förstår att det innehåll de beskriver när integrationen är klar också överförs till SDL och måste vara kompatibelt med SDL. Din organisations användare ska utbildas och era interna anvisningar ska uppdateras.
Genomför och testa integrationen
Anvisningar för genomförande och testning av IN-integrationen finns på sidan Teknisk dokumentation för den som genomför integrationen.
När integrationen har genomförts ska din organisation testa dess tekniska kapacitet och skicka en testrapport till MDB.
Kontrollera datans sakinnehåll och kvalitet
Din organisations SDL-huvudanvändare ska kontrollera sakinnehållet i den data som skickats via gränssnittet, korrigera eventuella fel i källsystemet och skicka en testrapport till MDB.
Läs mer på sidan Innehållsproduktion via IN-gränssnittet
Gör eventuella korrigeringar och produktionsinstallation
MDB bedömer utifrån testrapporterna om din organisation kan beviljas produktionsbehörigheter för IN-gränssnittet. Detta kan kräva flera iterationsrundor.
När MDB har godkänt testrapporterna skickar de API-användarrättigheter för SDL:s produktionsmiljö till er organisation eller programleverantör till den adress som specificerats i ansökan om användningstillstånd. Därefter kan ni genomföra produktionsinstallationen.
Dessa anvisningar är avsedda för organisationer som via IN-gränssnittet tar i bruk ett system som redan har integrerats med SDL, till exempel ett kontakthanteringssystem (t.ex. Fonectas Kontakti Pro eller PinMeTo).
Gå till ansökan om användningstillstånd för IN-gränssnittet
Om er organisation ännu inte har tagit i bruk Suomi.fi-servicedatalagret ska ni börja med att ansöka om användningstillstånd enligt anvisningarna på sidan Så här gör du ansökan om SDL-användningstillståndÖppnas i ett nytt fönster..
Om er organisation redan har tagit i bruk Suomi.fi-servicedatalagret och endast behöver användningstillstånd för IN-integrationen, kan ni ansöka om detta genom att logga in med stark autentisering på sidan Suomi.fi-serviceadministration och klicka på Ansök om användarlicens under rubriken Servicedatalager.
Fyll i ansökan om användningstillstånd
Ansökan om användningstillstånd består av fem steg:
- Basuppgifter om organisationen (namn, FO-nummer och adress)
- Kontaktpersoner i organisationen
- Uppgifter om SDL:s IN-gränssnitt och uppgifter om det datasystem som ska anslutas
Ange i punkten ”Uppgifter om det datasystem som ska anslutas” genom vilket system er organisation ska implementera IN-integrationen och vilken underleverantör (IT-leverantör) som har gjort integrationen.
Ange även underleverantörens API-kod och kontaktuppgifterna till innehavaren av API-koden.
4. Godkännande av användarvillkor
5. Granska och skicka in ansökan om användningstillstånd
Beviljande av användningstillstånd och information om användningstillstånd
Behandlingen av ansökan om användningstillstånd tar 1–2 veckor beroende på rådande kösituation. När användningstillståndet har beviljats visas det på organisationens konto på sidan Serviceadministration. MDB:s användningstillståndsteam skickar också ett meddelande till både de kontaktpersoner som angetts i ansökan och till organisationen. Meddelandet innehåller anvisningar om kvalitetskontroll av data som importeras till SDL via integrationen. Ni får de egentliga API-nyckeln för produktionen när det innehåll som importeras via integrationen har granskats.
Beviljande av huvudanvändarrättigheter för SDL
Därefter ger SDL-supporten er kontaktperson huvudanvändarrättigheter för SDL och informerar kontaktpersonen om detta per e-post.
Granskning och korrigering av innehåll i källsystemet
Kom överens med IT-leverantören om hur er organisations innehåll ska produceras i det system som integreras i SDL Om er organisation redan har beskrivit innehåll i SDL:s användargränssnitt är ett alternativ att hämta det befintliga innehållet via SDL:s OUT-gränssnitt och uppdatera detta.
När huvudanvändaren av SDL eller IT-leverantörens representant har producerat innehåll i ett system som integrerats i SDL, ska de kontrollera att innehållet är förenligt med SDL:s datamodellÖppnas i ett nytt fönster. och innehållsanvisningarnaÖppnas i ett nytt fönster.. Felaktiga uppgifter ska korrigeras i källsystemet.
Alla som upprätthåller uppgifter i det system som integrerats i SDL ska också kunna producera och uppdatera information i det format som SDL:s datamodell och innehållsanvisningar kräver.
Skicka innehållsrapporten för granskning
När innehållet är heltäckande och uppdaterat ska er IT-leverantör föra in data i SDL:s kundtestmiljö, ta ut en Excel-rapport över det och skicka den till Myndigheten för digitalisering och befolkningsdata för granskning på adressen ptv-tuki@dvv.fi.
Granskning av innehållet
MDB granskar att all data är av hög kvalitet och är förenligt med datamodellen. Var beredda på att göra eventuella ändringar efter granskningen.
Leverans av API-nyckel
När de nödvändiga ändringarna i innehållet har gjorts, kommer Myndigheten för digitalisering och befolkningsdata att skapa en produktions-API-nyckel för er organisation. Nyckeln skickas till er IT-leverantör och möjliggör import av uppgifter till SDL. Därefter kan ni göra en produktionsinstallation.
Anslutning av servicekanaler och tjänster som importeras till SDL
I Suomi.fi-servicedatalagret ska varje servicekanal vara ansluten till de tjänster som erbjuds i servicekanalen. Tjänster i anslutning till de servicekanaler som importeras från SDL:s integrerade system ska i god tid beskrivas i SDL:s användargränssnitt, förutsatt att de inte har beskrivits tidigare. När integrationen är under produktion ska servicekanalerna anslutas till tjänsterna i användargränssnittet. Varje servicekanal ska vara ansluten till minst en tjänst.
Om du vill ta i bruk integrationen mellan LIPAS-registret över motionsplatser och SDL ska du ansöka om användningstillstånd för SDL:s IN-gränssnitt på Serviceadministrationens webbplatsÖppnas i ett nytt fönster..
Om din organisation redan har tagit i bruk Suomi.fi-servicedatalagret ska du ansöka om användningstillstånd för IN-gränssnittet som inloggad användare på fliken Ansök om användningstillstånd på Serviceadministrationens webbplats.
Hur du fyller i tillståndsansökan
Ansökan om användningstillstånd består av tre delar:
- Uppgifter om organisationen och kontaktpersonerna
- Uppgifter om det datasystem som ska integreras med SDL via IN-gränssnittet samt en redogörelse för skyddet av uppgifterna
- Förbindelser som organisationen ger (bland annat godkännande av användarvillkoren).
I avsnittet Teknisk kontaktperson fyller du i kontaktuppgifterna till kontaktpersonen vid Jyväskylä universitet (tapani.j.laakso@jyu.fi och lipasinfo@jyu.fi). Ange också i ansökan under Underleverantör att ni använder Jyväskylä universitets API-nyckel API@jyu.fi och ange Jyväskylas universitets organisationsnummer 0245894-7.
Beviljande av användningstillstånd och information om användningstillstånd
Behandlingen av ansökan om användningstillstånd tar 1–2 veckor beroende på kösituationen. När användningstillståndet har beviljats visas det på er organisations konto i Serviceadministrationen.
Beviljande av användarrättigheter
När användningstillståndet har beviljats kontrollerar SDL-stödet vilka som är er organisations SDL-huvudanvändare, ger den administrativa kontaktperson som anges i ansökan SDL-huvudanvändarrättigheter och kopplar er organisation till Jyväskylä universitets API-nyckel.
När SDL-stödet har genomfört dessa åtgärder informerar stödet de kontaktpersoner som anges i ansökan och er organisations SDL-huvudanvändare per e-post.
Dessutom skickar SDL-stödet till Jyväskylä universitet den organisationskod (organisations-ID) som har skapats för er organisation på Serviceadministrationens webbplats och som universitetet behöver för att kunna föra in uppgifter i Suomi.fi-servicedatalagret.
Kontroll och publicering av innehåll i Suomi.fi-servicedatalagret
Börja så snart som möjligt kontrollera och komplettera er organisations beskrivningar i LIPAS-systemet, även om användningstillståndet ännu inte har beviljats. Vi ber er skicka frågor om detta till lipasinfo@jyu.fi.
När ni har uppdaterat uppgifterna i LIPAS-systemet kan ni publicera tjänsterna och serviceställena i Suomi.fi-servicedatalagret med funktionen Exportera till servicedatalagret. Detta beskrivs närmare i den anvisning om ibruktagande av LIPAS–SDL-integrationen som har tagits fram av Jyväskylä universitet.
Anvisning för ibruktagande av LIPAS–SDL-integrationen | Jyväskylä universitet (länk kommer senare)
Granskning av datakvaliteten
När ni har publicerat LIPAS-tjänsterna och serviceställena och de har överförts till Suomi.fi-servicedatalagret ska ni meddela detta till Myndigheten för digitalisering och befolkningsdata per e-post på adressen ptv-tuki@dvv.fi. MDB granskar att all data är av hög kvalitet och förenlig med datamodellen. Var beredda på att göra eventuella ändringar efter granskningen.