...
Notering om HSA-id: Personuppgiftstjänstens REST-tjänster kontrollerar vid begäran om filnedladdning att det är systemet med samma HSA-id som beställt filen. Om anropande konsument använder ett mellanlager i anslutning till NTjP, såsom en lokal tjänsteplattform, är det då viktigt för konsumenten att korrekt populera headern x-rivta-originalserviceconsumeroriginal-serviceconsumer-hsaid. Denna header skall ange det ursrungliga konsumerande systemets HSA-id, i enlighet med regel "Bevara ursprunglig avsändares identitet i http header" samt RIVTA Regel 23.
...
Personuppgiftstjänstens filhanteringstjänster är REST-tjänster som inte ingår i Inera NTjP. Behörighet för att använda dessa följer därför ett separat beställningsförfarande.
Beställning av behörighet till REST-tjänster görs genom att fylla i följande beställningsformulär, vilket skickas till Ineras kundtjänst på kundservice@inera.se. Ange i mailtexten att det gäller "Beställning Beställningen skickas som en bilaga i ett ärende till Inera. Välj att det gäller ”Personuppgiftstjänsten” och området ”Övrigt”. Ange i ärendetexten att det gäller ”Beställning av REST-tjänst för Personuppgiftstjänsten – se bilagabilaga”."
| View file | ||
|---|---|---|
|
...
Användningsfall 2 och delvis 3 följer flödet som beskrivs i ARK_0038 Refererad bilaga, medans detta inte är applicerbart i användningsfallen 1 och delvis 3 vid uppladdning av bilagor. Flöden för samtliga användningsfall specificeras i följande avsnitt.
Söka personuppgifter via fil: GetPersonsByFile/SearchPersonsByFile
...
Funktionerna finns endast som restricted-variant. Returnerar alltså inte adress m.m på sekretessmarkerade personposter.
...
Filen laddas upp via någon av REST-metoderna SearchPersonsByFile eller GetPersonsByFile, som vid lyckad uppladdning returnerar ett Order-Id. Detta Order-Id används som inparameter till tjänsten GetFilesForOrderId som returnerar ett svar om var den resulterande filen kan hämtas.
...
Resultatfilerna är ZIP:ade och innehåller en XML-fil med det urval som efterfrågats. Formatet som specificeras i TKB och XSD för strategicresourcemanagement:persons:person.
...
...
Begränsning i antal sökträffar: Av prestandaskäl begränsas sökningar via SearchPersonsForProfileByOrder(Unrestricted) till maximalt 250.000 sökträffar. -20231025-085835.png?version=1&modificationDate=1714398314169&cacheVersion=1&api=v2&width=570) |
|---|
Exempel
SearchPersonsForProfileByOrder
...
I personuppgiftstjänstens domänversion 4 kommer svarsfilerna som genereras av SearchPersonsByFile v2 samt SearchPersonsForProfileByOrder(Unrestricted) v4 att göra namespace-deklarationer på ett avvikande sätt, vilket kan göra att inläsning/parsning av dessa filer misslyckas. Detta kan hanteras genom search-and-replace i svarsfilerna enligt arbetsstegen som redovisas nedan, innan inläsning görs.
...