Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Gliffy
imageAttachmentIdatt1205076094
macroIdaa40c3e2-29df-4359-8ba0-f0ced995afe7
baseUrlhttps://helsenorge.atlassian.net/wiki
nameskjemaløsning
diagramAttachmentIdatt1204551784
containerId1208614915
timestamp16165902895491617691648782
  1. En aktør kan sende inn en skjemaoppgave. Her benyttes FHIR ressurs Task (Detaljert dokumentasjon av hvordan Task skal benyttes finnes her: FHIR Task - Oppgave )

  2. Innbygger får varsel om mottatt skjemaoppgave og vil logge seg på Helsenorge. Der vil innbygger se oppgaven samt kunne gå til utfylling av skjema.

  3. Innbygger kan også søke opp skjemaer, eller starte skjemautfylling via dyplenker, og fylle ut disse uten at en aktør har sendt inn en skjemaoppgave.

  4. Når skjema er fylt ut av innbygger (enten som resultat av en innsendt skjemaoppgave eller at innbygger selv har valgt et skjema), vil Helsenorge sende resultatet tilbake til aktør som skal ha skjemasvaret (se detaljert dokumentasjon av skjemasvar fra Helsenorge her: FHIR Ressurser benyttet for Digitale Skjema )

    1. Mottager(e) av skjemasvar kan være angitt i Skjemaoppgaven.

    2. Mottager(e) kan være fast definert på skjemaer som ligger i Helsenorge Skjemakatalog

    3. Noen skjema tilbyr innbygger å velge mottager.

  5. Noen eksterne skjemautfyllere sender selv utfylt skjemasvar til mottager uavhengig av Helsenorge.

  6. En ekstern skjemautfyller skal alltid sende en lesbar (PDF) kopi av utfylt skjema til helsenorge slik at innbygger har en kopi av dette. (Se detaljert spesifikasjon av innhold her: FHIR Ressurser benyttet for Digitale Skjema )

  7. Dersom Helsenorge skjemautfyller benyttes, aktiveres denne fra forretninglogikken på Helsenorge. Denne Skjemautfyller sender både strukturert skjemasvar (QuestionnaireRespons) og PDF-versjon tilbake til Helsenorge.

  8. Dersom skjemaoppgaven peker til en eksterne skjemautfyller aktiveres denne når innbygger velger å fylle ut skjema fra Skjemaoppgaven.

  9. Dersom et skjema som skal fylles ut ligger i Helsenorge skjemakatalog, hentes skjemadefinisjonen ned og sendes med til skjemautfyller.

  10. Noen eksterne skjemautfyllere er ikke laget for (har hjemmel til) å lagre pasientopplysninger. For å understøtte et slikt scenarie scenario tilbyr Helsenorge at en ekstern skjemautfyller kan mellomlagre- og hente ut igjen, et delvis utfylt skjema på Helsenorge.

...

Grensesnitt 10 over (mellomlagring av delvis utfylt skjema på Helsenorge) støttes kun synkront (dvs. gjennom API)

API’er

Alle FHIR API’er på Helsenorge støtter et subset av den fulle spesifikasjonen: http://hl7.org/fhir/http.html

  • Det skal benyttes HTTPS

  • Det støttes ikke versjonering av FHIR-ressurser

  • Klienter kan ikke velge hvilken respons som ønskes ved å benytte “Prefer Header for HTTP”. Avhengig av hvilken HTTP operasjon som benyttes, returneres enten hele FHIR-ressursen eller kun resultatet av operasjonen (se under).

Update - HTTP PUT

Klienter kan benytte “Update” for å kreere en ny ressurs på Helsenorge med en ressurs ID bestemt av klienten. Ressurs-ID’en skal være den samme i URL’en og i FHIR-ressursen. ID’en skal være globalt unik (dvs. en GUID). Ressursen kan siden aksesseres i API’er ved angi Type og Id.

Støttede FHIR-ressurs typer:

  • Task

  • DocumentReference

Request/response:

  • HTTP-request: PUT [base]/[type]/[id]

  • HTTP-body: En FHIR ressurs av type [type]- Ressursens-ID skal være satt og være global unik.

  • HTTP respons:

Create - HTTP POST

Klienter kan benytte “Create” for å kreere en ny ressurs på Helsenorge. Det er Helsenorge som bestemmer ressurs-ID’en.

Støttede FHR-ressurs typer:

  • Task

  • DocumentReference

Request/response:

  • HTTP-request: POST [base]/[type]

  • HTTP-body: En FHIR ressurs av type [type] (Dersom ressursen har en ressurs-ID fra før, vil denne endres)

  • HTTP respons:

    • OK: 201 - created. Ved suksessfull opprettelse av ressursen og påfølgende respons SKAL Location headeren være satt inneholdende logisk id , i tillegg returneres den opprettede ressursen i sin helhet.

    • Feil: 400 - error + FHIR OperationOutcome

Transaction - HTTP POST

Støttede FHR-ressurs typer:

  • Bundle (med Bundle.type = “transaction”)

    • Task

    • Questionnaire

    • QuestionnaireResponse

    • DocumentReference

Request/response:

  • HTTP-request: POST [base]

  • HTTP-body: En FHIR ressurs av type Bundle (Dersom Bundle har en ressurs-ID fra før, vil denne endres)

  • HTTP respons:

Meldingsbasert integrasjon

...