# e-Tinglysning - WSDL for Frasekatalog

## Frasekatalog

Denne web service udstilles af e-TL, og omfatter operationer, som har med fraser at gøre.
Fraser giver mulighed for, at aktører kan oprette egne tekster, der kan anvendes i brugerformularer. Teksterne kan da genbruges på tværs af de brugerformularer aktøren opretter.
Når man indsender en frase tildeles frasen en FraseIdentifikator, som senere anvendes som reference i de felter i brugerformularen, hvor der er behov for fraseteksten.
Professionelle brugere kan her hente en FraseIdentifikator for en frase, fx forud for oprettelse af en brugerformular. FraseIdentifikatoren er en UUID, som alle efterfølgende kan bruge til at hente frasen med, for så vidt de kender UUID'en.
FraseIdentifikatoren vil altid henvise til den oprindelige tekst. Selv de mindste ændringer kræver en ny UUID.
Der er ikke umiddelbart anden søgemulighed end UUID'en og den komplette tekst. Det betyder at ingen kan fremsøge og dermed lure i andres tekster før de er offentlige, fx via anvendelse i en offentliggjort anmeldelse.
Fraser kan kun indeholde tekst evt. opdelt i en overskrift og et eller flere afsnit (se efterfølgende XML-eksempel).
Der ligger ingen form for godkendelse fra Tinglysningsrettens side i de lagrede fraser. Fraser vurderes kun i forbindelse med prøvelsen eller i forbindelse med godkendelse af en brugerformlar.
Frasetekster må maksimalt være på 15.000 tegn, eksl XML-tags.

### Roller

Responsible: | Tinglysningsrettens' udviklingsleverandør
Accountable: | Tinglysningsretten
Consulted: | System-til-System brugere, Tinglysningsrettens portal udviklingsteam
Informed: | OIO

## Targetnamespace

http://rep.oio.dk/tinglysning.dk/service/interface/administration/1/

## Inkluderer

- ../../../message/administration/1/FraseHent.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/FraseIdentifikatorHent.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/FraseHentSvar.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/
- ../../../message/administration/1/FraseOpret.xsd - http://rep.oio.dk/tinglysning.dk/service/message/administration/1/

## Beskeder

- FraseHentRequest - admmsg:FraseHent
- FraseHentResponse - admmsg:FraseHentSvar
- FraseIdentifikatorHentRequest - admmsg:FraseIdentifikatorHent
- FraseIdentifikatorHentResponse - admmsg:FraseHentSvar
- FraseOpretRequest - admmsg:FraseOpret
- FraseOpretResponse - admmsg:FraseHentSvar

## Operationer

PortType: Frasekatalog

### Operation FraseHent

Beskrivelse | Mulighed for at få FraseIdentifikator(er) for en FraseTekst (FraseTekst'er). e-TL returnerer altid samme FraseIdentifikator for samme FraseTekst (og samme FraseTekst for samme FraseIdentifikator). Det vil sige, findes den eksakt samme frasetekst i frasekataloget returneres dens uuid, ellers oprettes den nye tekst i kataloget. e-TL's signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator fremover svarer præcist til FraseTekst.
Input | admifc:FraseHentRequest
Output | admifc:FraseHentResponse
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på SOAP over HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar

### Operation FraseIdentifikatorHent

Beskrivelse | Mulighed for at få en Frase for en eller flere FraseIdentifikatorer. e-TL returnerer altid samme FraseTekst for samme FraseIdentifikator (og samme FraseIdentifikator for samme FraseTekst). e-TL's signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator svarer præcist til FraseTekst.
Input | admifc:FraseIdentifikatorHentRequest
Output | admifc:FraseIdentifikatorHentResponse
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på SOAP over HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar

### Operation FraseOpret

Beskrivelse | Mulighed for at oprette Fraser. e-TL returnerer FraseIdentifikator(er) for de oprettede frasetekster. e-TL's signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator svarer præcist til FraseTekst.
Input | admifc:FraseOpretRequest
Output | admifc:FraseOpretResponse
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på SOAP over HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar