Adresseregisteret (AR)

Adresseregisteret er et verktøy for presis adressering av elektroniske meldinger og fysiske forsendelser i helse- og omsorgsektoren. Registeret inneholder adresseringsinformasjon for kommunikasjonsparter som er registrert i systemet. Dette kan være virksomheter eller enkeltpersoner. I AR finner man også funksjonalitet for elektronisk kommunikasjon gjennom CPPA (Collaboration Protocol Profile / Agreement).

På Websidene til plattformen finner man også administrative sider for AR. Her har man mulighet til å se og endre adresseinformasjon på enhetene i Adresseregisteret.

Datakvalitetstjenesten er en egen tjeneste relatert til AR. Fra denne tjenesten henter man ut aggregerte data og statistikk basert på Adresseregisteret, en funksjonalitet som er ønskelig for å opplyse om hvor mange enheter i Adresseregisteret følger de krav og forventninger som er satt mht. adresseoppføring. I Registerplattform Web finner man sider (her: /Statistics) som viser statistikk som baserer seg på data fra Datakvalitetstjenesten. Informasjon om metoder som kan brukes på Datakvalitetstjenesten finner man her IDataQualityService.

Forklaringer

  • Kommunikasjonspart (CommunicationParty) Abstrakt klasse som alle kommunikasjonsparter (mottakere/avsendere) arver fra. Denne inneholder all informasjon som trengs for å adressere kommunikasjonsparten (mottakeren).
  • Virksomhet (Organization) En virksomhet er en toppnode med eget organisasjonsnummer. Data er hentet enten fra Enhetsregisteret gjennom oppslag mot Brønnøysundregistrene eller fra Bedrifts- og Foretaksregisteret (BoF) gjennom oppslag i Norsk Helsenetts lokale kopi av dette.
  • Enhet (Department) Alle organisatoriske enheter (som f.eks. legekontor) som opererer uten eget organisasjonsnummer vil bli presentert som Department og vil ligge under en Organization.
  • Tjeneste (Service) En kommunikasjonspart som representerer et fagområde/tjenesteområde (en gruppe personer) i en bestemt virksomhet og som derfor har fått sitt navn hentet fra et tjenestekodeverk som den aktuelle virksomhetstypen benytter.
  • Person (OrganizationPerson) En kommunikasjonspart som representerer en enkelt person i en bestemt virksomhet, og som derfor har fått personens navn, med knytning til fødselsnummer og eventuelt informasjon som HPR har om denne personen. OBS: Informasjon om personen er lagret i helsepersonellregisteret (HPR), og vi garanterer ikke at HPR-informasjonen i AR er oppdatert. Oppdatert personinformasjon om helsepersonell bør hentes fra HPR .
  • Fysisk adresse (PhysicalAddress) Fysisk adresse, f.eks. besøks, post eller fakturaadresse.
  • Elektronisk adresse (ElectronicAddress) Elektronisk adresse, f.eks EDI, sertifikatpeker, telefonnummer, faxnummer, epost adresse.

Eksponerte tjenester

Søk og oppdatering i adresseregistret:

Statisikk over dataen i adresseregistret:

Eksport av kommunikasjonspartene:

Implementasjonsveiledning

Fritekst søk

Beskrivelse av fritekstsøk i Adresseregisteret.

Begrensninger

  • Minimum lengde på søkestreng er tre tegn. Ett unntak er dersom søkestrengen er ett eller to siffer, hvorpå den blir tolket som en HerId.
  • Hvis man skriver inn et tall som er ≤ 10000000, vil det tolkes som et søk etter HerId.
  • Hvis man skriver inn et tall som er > 10000000, vil det tolkes som et søk etter organisasjonsnummer eller telefonnummer.

Hva søkes etter i fritekstsøket?

For virksomheter:

  • HerId
  • Organisasjonsnummer
  • Organisasjonsnavn
  • Visningsnavn
  • Adresseinformasjon, inkludert postnummer/-sted og kommunenummer/-navn, epostadresse osv.

For personer:

  • HerId
  • Fornavn
  • Mellomnavn
  • Etternavn
  • HPR-nummer
  • Stillingstittel
  • Adresse
  • Postnummer/-sted
  • Bydelsnavn
  • Land

For tjenester:

  • HerId
  • Tjenestekode
  • Tjenestenavn
  • Annen stedsangivelse (bydel etc.)
  • Adresseinformasjon, inkludert postnummer/-sted og kommunenummer/-navn, epostadresse osv.
  • Organisasjonsnavn

Tjenesten vil returnere en liste med evt. treff i Adresseregisteret.

Eksempel

// Defined elsewhere
ICommunicationPartyService _service;

// Forbered parametere
var cps = new CommunicationPartySearch
{
    Page = 2,
    PageSize = 10
};
cps.AddConstraint(ConstraintKey.FullText, "lege ola");

// Utfør søk og bruk resultat
var searchResult = _service.Search(cps);
foreach (var result in searchResult.Results)
{
    Console.WriteLine($"{result.HerId}: {result.DisplayName ?? result.Name}");
}

Søket tar imot et søkeobjekt med informasjon om hva det skal søkes på og hvilke begrensninger søket skal legge på resultatet.

Direkte oppslag

For å utføre direkte oppslag kan følgende metode benyttes:

// Defined elsewhere
ICommunicationPartyService _service;

// Eksempel
var org = _service.GetCommunicationPartyDetails(59) as Organization;

Tjenesten returnerer en CommunicationParty som så kan kastes som Organization, Department eller Service.

Behandling av kommunikasjonsparter

En kan utføre følgende behandlinger av virksomheter:

  • Opprett virksomhet (CreateOrganization)
  • Rediger virksomhet (UpdateOrganization)

Tilsvarende for avdelinger, tjenester og personer:

  • Opprett enhet (CreateDepartment)
  • Rediger enhet (UpdateDepartment)
  • Opprett tjeneste (CreateService)
  • Rediger tjeneste (UpdateService)
  • Opprett person (CreateOrganizationPerson)
  • Rediger person (UpdateOrganizationPerson)

Informasjonsmodell

Adresseregisteret Modell