...
Arkitekturella krav på ett engagemangsindex finns på övergripande nivå i den nationella tekniska arkitekturen (T-boken, REV B) i from form av styrande principer samt på tjänstekontraktsnivå i den nationella tjänstekontraktsbeskrivningen för Engagemangsindex.
Övergripande arkitekturella mål
...
Implementationen ska också stödja användning inom ramen för avgränsingar avgränsningar och anvisningar:
- För E-tjänster med verksamhetsintegration finns tjänstekontrakt som specificerar kraven på meddelandeutbyte mellan e-tjänsten och verksamhetssystemen. Oftast ställer dessa tjänstekontrakt även krav på uppdatering av engagemangsindex. Det beskrivs i så fall i respektive tjänstedomäns tjänstekontraktsbeskrivning. Några exempel är tidbokning och remisstatusföljaren. För att vara producent av t.ex. tjänstekontrakten för tidbokning måste vårdsystemen alltså uppdatera engagemangsindex enligt de instruktioner som finns i tjänstekontraktsbeskrivningen för tidbokningsdomänen.
- Det är endast genom att källsystemen synkroniserar index-information till Engagemangsindex som invånartjänster i Mina vårdkontakter kan fungera fullt ut. Det är inte bara Mina vårdkontakter som är beroende av informationen i engagemangsindex för sin funktion. Har man väl integrerat källsystemet med engagemangsindex kommer patienterna automatiskt att få tillgång till en mängd tjänster. Det gäller även vårdpersonal som använder olika ombudsfunktioner för t.ex. tidbokning.
- E-tjänster som behöver konsumera information i engagemangsindex ska i första hand göra detta indirekt via en s.k. aggregerande tjänst. Det krävs särskilt godkännande för att integrera direkt med engagemangsindex. Ett exempel på en aggregerande tjänst är ”Mina bokade tider”. Det är en RIV TA-tjänst på Tjänsteplattformen som internt använder Engagemangsindex för att sammanställa alla bokade tider patienten har tvärs alla anslutna system i Sverige. Genom att den aggregerande tjänsten finns, blir kopplingen mot engagemangsindex återanvändbar. Utan aggregerande tjänst behöver varje tillämpning investera i integration med Engagemangsindex (som konsument), ev. cache-funktioner etc.
...
Icke funktionella krav
Detta stycke kopletterar kompletterar de icke funktionella krav som finns fastställda i tjänstekontraktet för engagemangsindex samt i T-bokens styrande principer.
...
Implementationen av SKLTPs Engagemangsindex skall returnera standardiserade felmeddelanden enligt följande.
Referens till regel | Felscenario | Felkod | Feltext | Exempel på SOAP Fault |
---|---|---|---|---|
§ 6.4 Statusrapportering | Vid ett tekniskt fel levereras ett generellt undantag (SOAP-Exception). |
EI000 | A technical error has occurred, error message: <technical details> |
| ||||||||
TBD | TBD | EI001 | The payload does not follow the XML Schema, error messge: <error> |
§7.5 Update-R1 | Element i inkommande request till Update måste vara sinsemellan unika. | EI002 | EngagementTransaction <position1> and <position2> have the same key. That is not allowed. See rule for Update-R1 in service contract |
| ||||||||
§7.5 Update-R7 | Logisk adress i request till Update måste vara identisk med Engagemangsindexets |
ownerid. | EI003 | Invalid routing. Logical address is |
<logical address> but the owner is |
<owner>. They must be the same. See rule for Update-R7 in service contract |
| |||||||||||
§7.4 Update / §10.4 ProcessNotification | När engagemang saknar någon av de fält som enligt tjänstekontraktet är obligatoriska. | EI004 | The payload does not validate, error message: <details about the validation error> |
|
Felkoder per tjänst
Nedan anges för vilka tjänster ovanstående felkoder förekommer, samt om eventuella specialiseringar förekommer.
Tjänst | Felkod | Orsak |
---|---|---|
update-service | EI000 | För många engagemang i samma begäran. Denna information skickas i <technical details>. |
update-service | EI002 | När begäran innehåller dubbletter av engagemang |
update-service | EI003 | Returneras när begäran innehåller felaktig logisk adress jämfört med ownerid för engagemangsindex. |
update-service | EI004 | När någon av de obligatoriska fälten börjar eller slutar med ett White space. |
update-service | EI004 | När begäran innehåller ett engagemang utan någon av de i tjänstekontraktet definierade obligatoriska fälten |
find-content-service | EI000 | När någon av de obligatoriska fälten registeredResidentIdentification eller serviceDomain saknas i begäran. . Denna information skickas i <technical details>. |
notification-service | EI000 | För många engagemang i samma begäran |
notification-service | EI002 | När begäran innehåller dubbletter av engagemang |
notification-service | EI004 | När begäran innehåller ett engagemang utan någon av de i tjänstekontraktet definierade obligatoriska fälten |
Fältlängder
Då data sparas i en relationsdatabas så finns begränsningar på fältlängder. Fältlängderna finns definierade i SKLTP EI SAD - Implementationsvy under avsnittet 'Mappning till tabell'.
En validering ska göras att fältlängderna i payload ej överskrider längden på motsvarande kolumner i databasen. För kolumner av typen TIMESTAMP ska antalet tecken i payload vara 14.