Ändringar i gränssnittsanvändning av PxWeb-databaserna

Px-filernas struktur i statistikdatabaserna ändrades 8.6.2026. För att förfrågningar i API-gränssnittet ska fungera efter ändringen, ska korrigeringar göras i dem.

Ändringarna inverkar bl.a. på databasen StatFin samt på avgiftsbelagda databaser. Ändringarna gäller tabeller med en ID-beteckning på fyra tecken, t.ex. 12tg.

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.

1. 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:

	före ändringen	efter ändringen
filnamn	statfin_tyonv_pxt_12tg.px	12tg.px
TABLEID	TABLEID="statfin_tyonv_pxt_12tg”	TABLEID="12tg”
MATRIX	MATRIX="010_12tg_2026"	MATRIX="12tg"

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.

2. 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("Tiedot")="contentscode";

VARIABLECODE[sv]("Uppgifter")="contentscode";

VARIABLECODE[en]("Information")="contentscode";

Tidsvariabler

En VARIABLECODE enligt tidsvariabelns cykel läggs till tidsvariabeln.

T.ex. för årstabellerna timeperiod_y:

VARIABLECODE("Vuosi")="timeperiod_y";

VARIABLECODE[sv]("År")="timeperiod_y";

VARIABLECODE[en]("Year")="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 alue_23_20260101:

VARIABLECODE("Alue")="alue_23_20260101";

VARIABLECODE[sv]("Område")="alue_23_20260101";

VARIABLECODE[en]("Region")="alue_23_20260101";

3. 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.

Bekanta dig med en noggrannare anvisning

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.

Anvisningatna på finska Anvisningarna på engelska

Kontaktuppgifter

E-post

tietokannat@stat.fi