Informationsledens adaptertjänst
I den här artikeln får du information om Suomi.fi-informationsledens adaptertjänst och hur den genomförs.
Adaptertjänsten är en komponent mellan X-Roads anslutningsserver och det system som ska anslutas, och som anpassar tjänsterna som det anslutna systemet erbjuder så att de är förenliga med X-Road-dataöverföringsprotokollet.
SOAP
Det är enkelt att ansluta SOAP-baserade system till Informationsleden. I sin enklaste form innebär anslutningen av ett system till Informationsleden att anslutningsservern installeras och att adaptertjänsten genomförs för att lägga till nödvändiga SOAP-rubrikuppgifter. Dessutom ska adaptertjänsten tillhandahålla gränssnittsbeskrivningar av de tjänster som ska kopplas till leden (WSDL).
REST
Adaptertjänsten behöver inte längre genomföras efter version 6.21.0, eftersom X-Road nativt stöder REST.
X-Road fungerar som ett informationsförmedlingsskikt mellan de anslutna systemen. Det erbjuder ett säkert och standardiserat sätt att publicera och utnyttja elektroniska tjänster och gränssnitt. De tjänster som erbjuds av system som anslutit sig till X-Road publiceras som SOAP-gränssnitt. Serviceförfrågningar och svarsmeddelanden mellan systemen skickas som krypterade SOAP-meddelanden mellan anslutningsservrarna.
Anslutningen till Informationsleden förutsätter att det system som ska anslutas till leden kan skicka och ta emot SOAP-meddelanden i den form som X-Road förutsätter. I praktiken betyder det att SOAP-meddelanden ska innehålla vissa rubrikuppgifter som fastställts i X-Roads dataöverföringsprotokoll. I SOAP-meddelandets body-del ska fråge- och svarsparametrar ingå på det sätt som fastställts i X-Road-protokollet. Dessutom ska adaptertjänsten tillhandahålla gränssnittsbeskrivningar av de tjänster som ska kopplas till leden (WSDL).
Rubrikuppgifterna läggs till och andra nödvändiga åtgärder genomförs i den så kallade adaptertjänsten. Tjänsten i fråga kan genomföras antingen i ett system som ansluts direkt eller i en separat adaptertjänst som ligger mellan systemet och anslutningsservern. X-Road förutsätter att gränssnittsbeskrivningarna (WSDL) för de tjänster som publicerats via den finns tillgängliga via adaptertjänsten. Detta gäller endast system som tillhandahåller information i Informationsleden. De system som använder informationen behöver inte tillhandahålla sina gränssnittsbeskrivningar för X-Road.
Bild 1 visar genomförandet av adaptertjänsten som en separat tjänst.
Adaptertjänsten är inte en färdig komponent som följer med X-Road-lösningen, utan den ska genomföras separat för varje system som ansluts. Adaptertjänstens uppgifter är:
- Konvertering av meddelanden från det system som ska anslutas till ett format som är förenligt med X-Road-dataöverföringsprotokollet.
- Tillhandahållande av gränssnittsbeskrivningar (WSDL) för anslutningsservern för de tjänster som kopplats till X-Road.
Genomförandet i praktiken
Alternativen för genomförandet av adaptertjänsten presenteras i bild 2.
- Direkt till det system som ska anslutas
- Som en separat programvarukomponent som placeras på samma serverplattform som det system som ska anslutas
- Som en separat programvarukomponent som placeras på en egen serverplattform.
Adaptertjänsten behöver inte nödvändigtvis vara en ny programkomponent som utvecklats för Informationsleden. Den kan också vara en fast programvara som genomför de meddelandekonverteringar som X-Road kräver, till exempel en Enterprise Service Bus (ESB) -applikation. Alternativ 3 beskriver användningen av ESB-applikationen, eller någon annan fast programvara, i genomförandet av adaptertjänsten.
Beroende på hur adaptertjänsten genomförs kan flera datasystem som ansluts till X-Road använda samma adaptertjänst. I praktiken lönar det sig att planera adaptertjänsten så att samma adaptertjänst kan utnyttjas i genomförandet av X-Road-integrationen i flera system. Strukturen på SOAP-rubrikuppgifterna som X-Road förutsätter är densamma oberoende av vilket system som ska anslutas, så det lönar sig inte att utföra funktionerna för behandlingen av dessa uppgifter separat för varje system som ska anslutas. Genomförandet av en mångsidig adaptertjänst minskar avsevärt arbetet med underhåll, och i fortsättningen också arbetet med att ansluta nya system.
Användbart material
Nedan hittar du material om genomförandet av adaptertjänsten (på engelska):