# Interactor Management - Brukerdokumentasjon

## Brukersteder

### Oversikt

Viser alle brukersteder som tilhører helseregionen med mulighet for søk, filtrering og sortering.

| Funksjon  | Beskrivelse                                                                          |
| --------- | ------------------------------------------------------------------------------------ |
| Søk       | Mulighet for å søke i oversikten på **Navn** eller **Brukersted-id**                 |
| Filter    | Mulighet for å filtrere oversikten på **EPJ-system** eller **Tjenestetilbudsgruppe** |
| Sortering | Mulighet for å sortere kolonner i oversikten                                         |

### Brukerstedsdetaljer

Gir informasjon om brukerstedet, hvilke tjenestetilbud det har, ordresammendrag, hendelseslogg og eventuelle funksjonsbrytere som er satt.<br>

<figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FIusv5oqndPgRx9su0BNP%2Fimage.png?alt=media&#x26;token=ef0e4c2e-c1e0-496a-a019-6ac4318b91d0" alt=""><figcaption></figcaption></figure>

<kbd>Rediger</kbd>  - Redigering/visning av følgende informasjon:&#x20;

* **Navn** - Brukerstedets navn.
* **Navn i adresseregisteret** - Brukerstedets navn slik det er oppført i adresseregisteret. Feltet er skrivebeskyttet.
* **HER-ID** - Brukerstedets HER-ID slik det er oppført i adresseregisteret. Feltet er skrivebeskyttet.
* **Organisasjonsnummer** - Brukerstedets organisasjonsnummer slik det er oppført i adresseregisteret. Feltet er skrivebeskyttet.
* **Sted** - Brukerstedets fysiske sted.
* **EPJ-system** - Type EPJ-system som brukerstedet har integrasjon mot Interactor.
* **Org.nr for dataansvarlig** - Organisasjonsnummer til dataansvarlig for brukerstedet. Brukes til HelseID-innlogging ved kall mot PTS- og FoRe-API.

<kbd>Hendelseslogg</kbd>  - Alle endringer gjort for brukerstedet i Interactor Management vises her. Det er mulig å søke i et gitt tidsrom med fra- og til-dato.

<kbd>Delegeringer</kbd>  - Viser hvilke delegeringer som er gjort for brukerstedet mot NHN sine API.

<kbd>Funksjonsbrytere</kbd>  - Viser eventuelle funksjonsbrytere som er satt for brukerstedet via en eller flere [grupper](#grupper).

<kbd>Ordreoversikt</kbd>  - Viser nøkkelinformasjon om ordrer som er sendt for en periode på opp til 14 dager. Eksempel:

<figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2F37FDZnH1QtRpx3i4ABwc%2Fimage.png?alt=media&#x26;token=2c2fe59e-7d06-4cf7-a62b-1f5f1fddee64" alt=""><figcaption></figcaption></figure>

## Tjenestetilbud

### Liste

Viser alle tjenestetilbud som er lastet opp for helseregionen, antall tjenestetilbudsgrupper det er med i, hvilken versjon som er i bruk og når gjeldende versjon ble lagt til.

<kbd>Last opp</kbd> - Funksjon for å laste opp tjenestetilbudspakke som er publisert fra **Interactor Publisher**. Det kan være et nytt tilbud eller en ny versjon av et eksisterende tilbud. Ved suksesfull opplastning er det mulig å aktivere tilbudet med en gang, og det vil da normalt være tilgjengelig for brukerne i løpet av 1 til 5 minutter.

{% hint style="info" %}
Bruk funksjonen "Oppdater tidspunkt" for å sjekke når tjenestekatalogen sist har blitt oppdatert. Dersom tidspunktet er senere enn aktivering av tilbud så skal det være tilgjengelig for brukerne av Interactor
{% endhint %}

<div align="center"><figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FwAbwnS3eyy5CMXGCvlam%2Fimage.png?alt=media&#x26;token=7acdfb41-0ac2-496b-b4da-a70eae083af2" alt=""><figcaption></figcaption></figure></div>

#### Tjenestetilbudsdetaljer

Viser alle versjoner av tjenestetilbud som har blitt lastet opp og hvilke tjenestetilbudsgrupper det tilhører.

| Funksjon | Beskrivelse                                                                                                                                                                                                                                                    |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Versjon  | Versjonsnummer for publiseringspakke fra **Interactor Publisher**. Gjeldende versjon er markert med en grønn 'V'                                                                                                                                               |
| Navn     | Navn på publiseringspakke fra **Interactor Publisher**                                                                                                                                                                                                         |
| Lagt til | Tidspunkt for når publiseringspakken ble lastet opp                                                                                                                                                                                                            |
| Aktivert | Tidspunkt for når tjenestetilbud ble aktivt i tjenestekatalog                                                                                                                                                                                                  |
| Status   | <p><strong>Aktiv</strong> - Den aktive versjonen som brukere av Interactor har tilgjengelig<br><strong>Aktivert</strong> - Versjon som er aktivert, men fortsatt ikke tilgjengelig for brukere av Interactor<br><strong>Aktiver</strong> - Inaktiv versjon</p> |
| Last ned | Funksjon for å laste ned publiseringspakken til PC                                                                                                                                                                                                             |
| Slett    | Sletter versjonen med tilhørende publiseringspakke. Kan ikke utføres på aktiv versjon som har en eller flere tilhørende tjenestetilbudsgrupper                                                                                                                 |

### Tjenestetilbudsgrupper

En tjenestetilbudsgruppe består av brukersteder og tjenestetilbud. Et brukersted kan kun være med i én gruppe, og det er denne som styrer hvilke tilbud brukerstedet skal ha tilgang på i **Interactor**.&#x20;

<kbd>Ny gruppe</kbd>  - Oppretter en ny tjenestetilbudsgruppe

<kbd>Rediger</kbd>  - Redigerer en eksisterende tjenestetilbudsgruppe

Lagring av endringer vil normalt være tilgjengelig for brukerne i løpet av 1 til 5 minutter.

{% hint style="info" %}
Bruk funksjonen "Oppdater tidspunkt" for å sjekke når gruppeendringer sist har blitt oppdatert. Dersom tidspunktet er senere enn lagring av endringer så skal de være tilgjengelig for brukerne av Interactor
{% endhint %}

#### Velge tjenestetilbud

Alle tjenestetilbud for regionen er tilgjengelig for valg, også de som er brukt i andre grupper. Dersom et eller flere av tilbudene får aktivert nye versjoner vil de oppdateres automatisk i alle gruppene de er med i. Rekkefølgen tilbudene ligger i under **Valgte tjenestetilbud** styrer rekkefølgen de vises i **Interactor**.

#### Velge brukersteder

Alle brukersteder for regionen er tilgjengelig for valg, men et brukersted kan bare være med i en gruppe. Dersom man velger et brukersted som finnes i en annen gruppe vil den bli flyttet til gruppen man redigerer.

#### Forhåndsvalg

Forhåndsvalg gjør det mulig å styre hvilken aktør (HER-id) som skal velges som standard ved bestilling av radiologisk tjeneste. Dette vil overstyre den vanlige "vektingen" som finnes i **Interactor**, og valg som gjøres her vil gjelde for alle brukerstedene i tjenestetilbudsgruppen.

Eksempel der det er en foretrukket aktør for alle modaliteter:

* Aktøren slik den er definert i tjenestetilbud

  <div align="left"><figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FNAhmkbqsrj6Iw57y7jo5%2Fimage.png?alt=media&#x26;token=7d5a97fa-5c0e-4427-b36a-fa5b8c08b2b7" alt=""><figcaption></figcaption></figure></div>
* Oppsett i **Forhåndsvalg**

  <figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FXXmQw7nstKuY5zLqMylm%2Fimage.png?alt=media&#x26;token=2f8de007-047f-4bc0-accd-acb3d714d964" alt=""><figcaption></figcaption></figure>
* Forhåndsvalgt aktør ved bestilling i **Interactor**

  <div align="left"><figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FsowFKw3qSF5UHAl5d5Ew%2Fimage.png?alt=media&#x26;token=6e143aa6-3ff6-462f-8c6f-84c71c5dfc8d" alt=""><figcaption></figcaption></figure></div>

Det er mulig å legge inn flere aktører i en kommaseparert liste. Det kan være nyttig dersom det finnes flere tjenestetilbud med radiologiske undersøkelser der det er forskjellige aktører, eller dersom det skal velges en annen aktør hvis den primære ikke finnes for den valgte tjenesten.

Det er også mulig å overstyre/spesifisere forhåndsvalgt aktør per modalitet. Eksempel der overstyring kun gjelder for tjenester med disiplin av typen RTG eller UL (settes på tjenestetilbud i Interactor Publisher):<br>

<figure><img src="https://2156924334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOSec0cDDU3vl4d8BdBIO%2Fuploads%2FddcomaNWNM2zJtdPUAvx%2Fimage.png?alt=media&#x26;token=af708d62-e6cc-41f4-b68b-9a6b7db84ab6" alt=""><figcaption></figcaption></figure>

## Programvare

Denne funksjonaliteten er ikke i bruk i Interactor Management, men av historiske årsaker må man ha et innslag her for å kunne lage et [Oppsett](#oppsett)

## Oppsett

Et oppsett består av et programvareoppsett (ikke i bruk) og en tjenestetilbudsgruppe, og brukes i forbindelse med registrering av nye brukersteder.

## Meldinger

Funksjon for å sende ut meldinger til brukere av Interactor. Oversikten viser planlagte, aktive og historiske meldinger.

<kbd>Ny melding</kbd>  - Opprette ny melding

| Funksjon            | Beskrivelse                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------------------- |
| Fra-dato            | Fra og med denne datoen får brukere meldingen ved åpning av Interactor                               |
| Til-dato            | Siste dag meldingen skal vises for brukere som ikke allerede har lest meldingen                      |
| Send til alle       | Meldingen sendes til alle brukere i regionen                                                         |
| Velg gruppe(r)      | Meldingen sendes til alle brukere for de brukerstedene som tilhører i valgt(e) [gruppe](#grupper)(r) |
| Velg brukersted(er) | Meldingen sendes til alle brukere som tilhører valgt(e) brukersted(er)                               |
| Overskrift          | Meldingens overskrift. Støtter lenker – se format nedenfor                                           |
| Innhold             | Meldingens innhold med støtte for avsnitt og lenker  – se format nedenfor                            |

**Lenker i overskrift og innhold**

Lenker blir automatisk klikkbare når det skrives inn en full URL direkte i teksten. For å sette en lenke på et bestemt ord eller en setning, brukes følgende format:

```
[ordlyd](https://url.no)
```

Eksempler:

| Hva som skrives i Management    | Hva brukeren ser i melding    |
| ------------------------------- | ----------------------------- |
| `https://www.dips.com/`         | <https://www.dips.com/>       |
| `[DIPS](https://www.dips.com/)` | [DIPS](https://www.dips.com/) |

<kbd>Rediger</kbd>  - Mulighet for å endre innhold, tidsintervall og mottakere av melding. **Viktig:** Brukere som allerede har mottatt og lest melding vil ikke få en ny melding selv om innholdet endres. &#x20;

## Grupper

En gruppe er en samling av brukersteder. Alle brukersteder i regionen er tilgjengelig for valg, og et brukersted kan være medlem av flere grupper. Grupper brukes til:

* **Meldinger** - Sende melding til brukere for alle valgte brukersteder i gruppen. I denne konteksten benyttes ikke funksjonaliteten "Aktiv i gruppen fra", dvs. meldinger sendt til gruppe vil inkludere alle valgte, også de som ikke har status "Aktiv".
* **Spesifikk brukerfunksjonalitet** - Gi brukersteder tilgang til funksjonalitet som ikke er tilgjengelig for alle og som ligger bak funksjonsbryter(e). Hvilken funksjonalitet det gjelder styres av systemleverandør og må derfor planlegges nøye i samarbeid med dem. Det er mulig å legge til brukersted som skal aktiveres frem i tid, dette styres av datofeltet "Aktiv i gruppen fra".