SKLTP TAK - Användarmanual v3.0.0+

Hantera JSON-beställning

Sedan version 2.3.4 så finns möjligheten att skapa objekt via en JSON-fil. Klicka på JSON Beställning i huvudmenyn.
Antingen finns JSON-filen tillgänglig eller så kan den importeras via sitt ordernummer.

JSON-filen finns tillgänglig lokalt

Öppna filen med en bra editor (t.e.x. Notepad++), markera hela innehållet och copy/pasta i fältet "Beställning". Klicka på "Granska" så
kommerr du att få en sammanställning av de objekt som kommer att skapas/tas bort av filen. Eventuella felmeddelanden visas också så att
du kan backa och rätta fel. De objekt som kommer att läggas till/uppdateras finns under rubrik "Inkludera". De objekt som kommer att
tas bort finns under rubrik "Exkludera". Om allt stämmer så klicka "Spara" längst ner på sidan så genomförs beställningen.

JSON-filen ska importeras

Om JSON-filer regelbundet hämtas från samma leverantör så kan man konfigurera att filerna hämtas via sitt ordernummer.
Detta kräver att man dels har adressen (URL) till det ställe där filerna ligger samt att man har två certifikat (ett som identifierar sig själv
och ett som verifierar servern där filerna ligger). 
Hur konfigureringen går till kan man läsa här: Konfigurering under rubriken "2) För att kunna importera via ordningsnummer"
Om allt är rätt konfigurerat så kan man då se ett fält "Beställnings-nummer" där man kan skriva in numret.
Klicka sedan på "Hämta" så importeras filen och skrivs ut i fältet "Beställning".
Sedan fungerar det likadant som ovan: Klicka på "Granska", verifiera att beställningen är korrekt och klicka "Spara" längst ner på sidan.

Administrera RIV-TA-profiler

RIVTA-profil är ett nationellt standardiserade meddelandeformat, för mer information se http://rivta.se/

Skapa RIVTA-profil

Klicka på "Administrera RIV-TA-profiler" i huvudmenyn och sen "Skapa RivTaProfil".

• Namn: RIV-TA-profilens namn
• Beskrivning: RIV-TA-profilens beskrivning

Redigera RIVTA-profil

Klicka på "Administrera RIV-TA-profiler" i huvudmenyn och sen "Visa" för den RIV TA-profil man vill editera. Klicka sedan på "Redigera" för att ändra Namn eller Beskrivning.

Ta bort RIVTA-profil

Klicka på "Administrera RIV-TA-profiler" i huvudmenyn och sen "Visa" för den RIV TA-profil man vill ta bort. Klicka sedan på "Ta bort".
OBS! För att ta bort en RIV TA-profil måste alla anropsadresser kopplade till den RIV TA-profilen först tas bort eller flyttas till en annan RIV TA-profil.

Administrera tjänstekontrakt

Skapa Tjänstekontrakt

Klicka på "Administrera tjänstekontrakt" i huvudmenyn och sen "Skapa Tjänstekontrakt".

• Namnrymd: Tjänstekontraktets URN.
• Major version: Välj den majorversion som tjänstekontraktet har.
• Minor version: Välj den minorversion som tjänstekontraktet har.
• Beskrivning: Beskrivning av tjänstekontraktet, ex. "{Tjänstedomän} - {tjänstekontrakt}"

Redigera Tjänstekontrakt

Klicka på "Administrera tjänstekontrakt" i huvudmenyn och sen "Visa" för det tjänstekontrakt man vill redigera. Klicka sedan på "Redigera".

Ta bort Tjänstekontrakt

Klicka på "Administrera tjänstekontrakt" i huvudmenyn och sen "Visa" för det tjänstekontrakt man vill ta bort. Klicka sedan på "Ta bort"
OBS! För att ta bort ett tjänstekontrakt måste alla Anropsbehörigheter och Vägval kopplade till tjänstekontraktet först tas bort eller flyttas till ett annat tjänstekontrakt.

Administrera tjänstekomponenter (producenter/konsumenter)

Skapa Tjänstekomponent

Klicka på "Administrera Tjänstekomponenter (producenter/konsumenter)" i huvudmenyn och sen "Skapa Tjänstekomponent"

• HSA-Id: Detta fält måste vara ett riktigt HSA ID /  Klientcertifikatets SERIALNUMBER.
• Beskrivning: En beskrivning av tjänstekomponenten. Ett bra format kan vara tex "{Landsting} -- {System} -- {Övrigt}".

Redigera Tjänstekomponent

Klicka på "Administrera Tjänstekomponenter (producenter/konsumenter)" i huvudmenyn och sen "Visa" för den tjänstekomponent man vill redigera. Klicka sedan på "Redigera".

Ta bort Tjänstekomponent

Klicka på "Administrera Tjänstekomponenter (producenter/konsumenter)" i huvudmenyn och sen "Visa" för den tjänstekomponent man vill ta bort. Klicka sedan på "Ta bort"
OBS! För att ta bort en tjänstekomponent måste alla Anropsbehörigheter och Anropsadresser kopplade till tjänstekomponenten först tas bort eller flyttas till en annan tjänstekomponent.

Administrera logiska adresser

Logisk adress (informationsägande verksamhet) är en adress som representerar en verksamhet eller en organisation som exponerar sina tjänster via sin tjänsteproducent.

I varje meddelande som skickas via Tjänsteplattformen adresserar Tjänstekonsumenten med en viss logisk adress. I själva meddelandet är logisk adress presenterad som ett <TO> eller <Logical address>- element.

Skapa Logisk adress

Klicka på "Administrera logiska adresser" i huvudmenyn och sen "Skapa Logisk adress".

• HSA-Id: Oftast adresseras en tjänst med ett HSA ID på en vårdgivare eller vårdenhet som finns presenterade i HSA-katalogen. Så är, dock, inte alltid fallet. Varje tjänstedomän bestämmer på vilket sätt som tjänsterna skall adresseras vilket innebär att den logiska adressen ibland kan vara ett organisationsnummer eller liknande.
• Beskrivning: Beskrivning på den logiska adresser, ex. VG: {Organisation} - {namn på vårdgivaren}

Redigera Logisk adress

Klicka på "Administrera logiska adresser" i huvudmenyn och sen "Visa" för den logiska adress man vill redigera. Klicka sedan på "Redigera".

Ta bort Logisk adress

Klicka på "Administrera logiska adresser" i huvudmenyn och sen "Visa" för den logiska adress man vill ta bort. Klicka sedan på "Ta bort"
OBS! För att ta bort en logisk adress måste alla Anropsbehörigheter och Vägval kopplade till den logiska adressen först tas bort eller flyttas till en annan logisk adress.

Administrera anropsadresser

Anropsadress är den url som tjänsteplattformen anropar hos en tjänsteproducent.

Skapa Anropsadress

Klicka på "Administrera anropsadresser" i huvudmenyn och sen "Skapa Anropsadress".

• Adress: Här fylls URL:en till tjänsten hos producenten i.
• Tjanstekomponent: Här väljer man den tjänstekomponent som adressen tillhör.
• Riv Ta Profil: RIV TA Profil som används hos producenten.

Redigera Anropsadress

Klicka på "Administrera anropsadresser" i huvudmenyn och sen "Visa" för den anropsadress man vill redigera. Klicka sedan på "Redigera".

Ta bort Anropsadress

Klicka på "Administrera anropsadresser" i huvudmenyn och sen "Visa" för den anropsadress man vill ta bort. Klicka sedan på "Ta bort".
OBS! För att ta bort en anropsadress måste alla Vägval kopplade till anropsadressen först tas bort eller flyttas till en annan anropsadress.

Ta bort Anropsadresser i bulk

Klicka på "Bulk ta bort anropsadresser" i huvudmenyn och markera sedan i kryssrutorna till vänster de Anropsadresser du vill ta bort. Klicka sedan på "Ta bort".
Du får nu se en lista med de du valt. Om de Anropsadresser du markerat ingår i några Vägval, så får du även se dessa. I så fall kan du inte ta bort de
valda Anropsadresserna. Men om de inte är bundna till några Vägval så kan du kontrollera och sedan klicka "Ta bort" och bekräfta i dialogen som kommer upp. 
OBS! För att ta bort en anropsadress måste alla Vägval kopplade till anropsadressen först tas bort eller flyttas till en annan anropsadress.

Administrera vägval

Vägval är routinginformation som används av Tjänsteplattformen för att kunna vidarebefodra ett meddelande till rätt producent och till en verklig adress.

Ett vägval är unikt identifierbart med ett tjänstekontrakt, en anropsadress, en logisk adress och en giltighetstid.

Skapa Vägval

Klicka på "Administrera vägval" i huvudmenyn och sen "Skapa Vägval".

• Tjänstekontrakt: Det tjänstekontrakt som vägvalet gäller.
• Logisk adress: Den logiska adress som vägvalet ska gälla.
• Anropsadress: Den adress som vi vill anropa hos en producent.
• Fr.o.m tidpunkt: Från vilket datum vägvalet ska börja gälla.
• T.o.m tidpunkt: Från vilket datum vägvalet ska sluta gälla.

Redigera Vägval

Klicka på "Administrera vägval" i huvudmenyn och sen "Visa" för det vägval man vill redigera. Klicka sedan på "Redigera".

Skapa Vägval (Bulk)

Klicka på "Administrera vägval" i huvudmenyn och sen "Skapa från beställning".

• Fr.o.m tidpunkt: Från vilket datum vägvalet ska börja gälla.
• T.o.m tidpunkt: Från vilket datum vägvalet ska sluta gälla.
• Tjänstekontrakt: Det tjänstekontrakt som vägvalet gäller.
• Anropsadress: Den adress som vi vill anropa hos en producent.
• Klistra in logisk adresser: Dom logiska adresser som vägvalet ska gälla. (Logiska adresser kan man lägga in i kolumn alternativt i en rad med ett mellanslag i mellan varje adress.)

Validera: Status för huruvida beställningen går att genomföra, är beställningen korrekt kan man trycka på Skapa i nästa fönster.

Ta bort Vägval

Klicka på "Administrera vägval" i huvudmenyn och sen "Visa" för det vägval man vill ta bort. Klicka sedan på "Ta bort".

Ta bort Vägval i bulk

Klicka på "Bulk ta bort vägval" i huvudmenyn och markera de vägval du vill ta bort. Klicka sedan på "Ta bort", så får du en lista med de markerade Vägvalen.
Kontrollera, och klicka "Ta bort", och bekräfta i dialogen som visas.

Administrera anropsbehörigheter

Anropsbehörighet är behörighet som ges en tjänstekonsument uttryckt av en kombination av: integrationsavtal, tjänstekontrakt, logisk adress, tjänstekonsument och en giltighetstid.

Skapa Anropsbehörighet

Klicka på "Administrera anropsbehörighet" i huvudmenyn och sen "Skapa Anropsbehörighet".

• Integrationsavtal: Namn på det avtal som en tjänstekonsument ingått med tjänsteproducenten.
• Tjänstekonsument: Motsvarar det HSA ID som angetts i Tjänstekomponent för en tjänstekonsument.
• Tjänstekontrakt: Det tjänstekontrakt som aktuell tjänstekonsument ska få anropa.
• Logisk adress: Den logiska adress som aktuell tjänstekonsument har rätt att anropa.
• Fr.o.m tidpunkt: Från vilket datum anropsbehörigheten ska börja gälla.
• T.o.m tidpunkt: Från vilket datum anropsbehörigheten ska sluta gälla.

Redigera Anropsbehörighet

Klicka på "Administrera anropsbehörighet" och sen "Visa" för den anropsbehörighet man vill redigera. Klicka sedan på "Redigera".

Ta bort Anropsbehörigheter

Klicka på "Administrera anropsbehörighet" i huvudmenyn och sen "Visa" för den anropsbehörighet man vill ta bort. Klicka sedan på "Ta bort".

Ta bort Anropsbehörigheter i bulk

Klicka på "Bulk ta bort anropsbehörigheter" i huvudmenyn och markera de Anropsbehörigheter du vill ta bort. Klicka sedan på "Ta bort",
så får du en lista med de markerade Anropsbehörigheterna. Kontrollera, och klicka sedan på "Ta bort", och bekräfta i dialogen som visas.

Skapa ny Anropsbehörighet (Bulk)

Klicka på "Administrera anropsbehörighet"och klicka på "Skapa från beställning".

Integrationsavtal: Namn på det avtal som en tjänstekonsument ingått med tjänsteproducenten.

Fr.o.m tidpunkt: Från vilket datum anropsbehörigheten ska börja gälla.

T.o.m tidpunkt: Från vilket datum anropsbehörigheten ska sluta gälla.

Tjänstekonsument: Motsvarar det HSA ID som angetts i Tjänstekomponent för en tjänstekonsument.

Tjänstekontrakt: Det tjänstekontrakt som aktuell tjänstekonsument ska få anropa.

Klistra in logisk adresser: Dom logiska adresser som aktuell tjänstekonsument har rätt att anropa. (Logiska adresser kan man lägga in i kolumn alternativt i en rad med ett mellanslag i mellan varje adress.)

Validera: Status för huruvida beställningen går att genomföra, är beställningen korrekt kan man trycka på Skapa i nästa fönster.

Administrera filter

Filter används för att ge möjlighet att filtrera vilka engagemangsindex uppdateringar som en producent får. Detta anges på en anropsbehörighet och filtreringen sker på tjänstedomännivå.

Skapa Filter

Klicka på "Administrera filter" i huvudmenyn och sen "Skapa Filter".

• Servicedomain: Tjänstedomän på det vis som det står angivet i tjänstekontraktsbeskrivning.

Redigera Filter

Klicka på "Administrera filter" i huvudmenyn och sen "Visa" för det filtret man vill redigera. Klicka sedan på "Redigera".

Ta bort Filter

Klicka på "Administrera filter" i huvudmenyn och sen "Visa" för det filtret man vill ta bort. Klicka sedan på "Ta bort"
OBS! För att ta bort ett filter måste Filtercategorization kopplad till filtret först tas bort eller flyttas till ett annat filter.

Administrera filtercategorizations

Filtercategorization används som ytterligare möjlighet att begränsa vilka engagemangsindex uppdateringar som en producent får. Detta anges på ett filter och filtreringen sker på tjänstekontraktsnivå.

Skapa Filtercategorizations

Klicka på "Administrera filtercategorizations" och sen "Skapa Filtercategorization". 

• Filter: Välj relevant filter
• Category: Värdet för den tjänst man vill filtrera på, vilket motsvarar värdet "categorization" i engagemangsindex.

Redigera Filtercategorizations

Klicka på "Administrera filtercategorizations" och sen "Visa" för den filtercategorization man vill redigera. Klicka sedan på "Redigera".

Ta bort Filtercategorizations

Klicka på "Administrera filtercategorizations" och sen "Visa" för den filtercategorization man vill ta bort. Klicka sedan på "Ta bort".

Publicering

Publicerade versioner

Under "Publicerade versioner" hittar man information om samtliga publiceringar som genomförts.

• PV: Publiceringens versionsnummer
• Kommentar: Information om publiceringen i fritext
• Skapad den: Datum då publiceringen genomförts
• Utförare: Användarnamnet för den användare som genomfört publiceringen
• Storlek: Visar storleken av publiceringen i Kilobyte (komprimerad)
• Ladda ner: Ladda ner en publicerad version
  OBS! Den nedladdade filen är i formatet .gzip vilken måste ändras till .zip om man använder Windows för att kunna extrahera filen.

Granska publicering

Under "Granska publicering" skapar man nya publiceringar och finner även en sammanställning av allting som kommer att Skapas, tas bort eller uppdateras vid nästa publiceringen.

Skapa publicering

Klicka på "Granska publicering" och gå igenom alla ändringar. Fyll i en kommentar och klicka sen på 'Publicera'.
OBS! Efter en publicering måste man först rensa TAK-Cache och sen VP-Cache för att ändringarna ska börja gälla.

Rensa cache

Öppna en webbläsare och gå till nedanstående sidor för att rensa respektive cache.

• TAK: http://<HOST>:<PORT>/tak-services/reset/pv
• VP: http://<HOST>:<PORT>/resetcache

Administrera användare av tjänstekatalogen

För att hantera/skapa Användare måste man ha rollen Administratör.

Skapa användare

Klicka på "Administrera användare av tjänstekatalogen" och sen "Skapa användare". Glöm ej att bocka för rutan "Administratör" om användaren skall ha möjlighet att skapa/ändra användare.

Ändra användare

Klicka på "Administrera användare av tjänstekatalogen" och ändra uppgifter genom att klicka på användaren du vill editera och sedan på "Redigera".

Ta bort användare

Klicka på "Administrera användare av tjänstekatalogen" och sen på användarnamnet för den användare man vill ta bort och sedan på "Ta bort"

Administrera TAK inställningar

För att hantera/skapa Användare måste man ha rollen Administratör.

Dessa inställningar gäller mail som TAK skickar.

Ändra inställning

Klika på 'Administrera TAK inställningar' och ändra uppgifter genom att klicka på setting du vill editera och sedan på "Redigera".

Delete i vy:en