Ändringar i gränssnittsanvändning av PxWeb-databaserna 8.6 – ändra gränssnittsförfrågningar enligt anvisningen

Ändringarna gäller tabeller med en ID-beteckning på fyra tecken, t.ex. 12tg. Ändringarna inverkar bl.a. på databasen StatFin samt på avgiftsbelagda databaser. Tills vidare görs inga ändringar i StatFins arkivdatabas.

Med ändringarna strävar vi efter att göra det lättare att hitta och förstå tabellernas innehåll i PxWeb användargränssnittet, i sökmotoranvändningen och vid användning av artificiell intelligens. Ändringen hjälper till att förbättra enhetligheten i tabellernas metadata, hanteringen av ändringssituationer och tabellernas livscykel samt kommunikationen om dessa.

Vilka ändringar görs i tabellerna?

Det görs tre ändringar: 

1.  Filnamnet, TABLEID- och MATRIX-beteckningen förkortas. Detta gäller alla aktiva databaser.

2. En variabelkod har lagts till för alla variabler. Tidigare fungerade variabelns namn i API-användningen som identifierare för variabeln, men i fortsättningen ersätts denna med en
variabelkod.

3.  I vissa fall måste ett prefix läggas till för analysvariabelns värdekoder. Denna ändring gäller alla aktiva databaser, men inte alla variabler.

Förkortning av beteckningar

Ändringen innebär att uppgifter i fälten TABLEID och MATRIX förkortas till enbart en ID-beteckning. Efter ändringen kommer filnamnet, TABLEID och MATRIX att vara identiska.

Till exempel i arbetsförmedlingsstatistikens tabell ändras filnamnet, TABLEID och MATRIX enligt följande:

I vissa fall förkortas inte bara filnamnet, utan efter ID läggs dessutom till en preciserande versionsbeteckning. Denna ändring gäller närmast gamla arkivtabeller i avgiftsbelagda databaser. I StatFin-tabellerna får filnamnen inga tillägg. I StatFins arkivdatabas finns sådana, men filnamnen i StatFins arkivdatabas ändras eller förkortas tills vidare inte.

Variabelkod

Varje variabel i tabellen får en kod på variabelnivå som efter ändringen fungerar som
variabelidentifierare i api-förfrågningar i stället för det nuvarande variabelnamnet. Nedan finns en förteckning över variabelkoder som läggs till för olika variabler.

Innehållsvariabler

VARIABELCODE contentscode läggs till innehållsvariabeln ”Uppgifter”:

VARIABLECODE(”Uppgifter”)=”contentscode”.

Tidsvariabler

En VARIABLECODE enligt tidsvariabelns cykel läggs till tidsvariabeln. T.ex. för
årstabellerna timeperiod_y:

VARIABLECODE(”År”)= timeperiod_y”.

Klassificerande variabler

För klassificerande variabler läggs en VARIABLECODE till, som är identifieraren för
kodsystemet på den aktuella klassificeringens värdenivå. T.ex. för områdesvariabeln ofta alue_23_20260101:

VARIABLECODE(”Område”)=”alue_23_20260101”.

Prefix för en analysvariabel

I vissa fall läggs ett prefix till för analysvariabelns värdekoder. Med analysvariabel avses variabeln ”Uppgifter”.

Till exempel i StatFin-tabellen 111e, som gäller vägtrafikolyckor, ändras uppgiftsvariabeln ”kuol” till ”ton-kuol”.

Dessa ändringar gäller inte alla tabeller.

Preciserande anvisning

Bekanta dig med en noggrannare anvisning (på finska)

I anvisningarna finns bifogade detaljerade före- och efterlistor på fil- och variabelnivå över ändringarna samt exempel på ändringar i px-filen och i gränssnittsförfrågningar.

Kontaktinformation

Kim Huuhko
⁠⁠Webbtjänstexpert
⁠⁠029 551 2354