BergOp ROM koppeling

BergOp ROM koppeling

BergOp ROM koppeling

Het scherm is te benaderen via het menu Functioneel beheer- Beheer - Externe koppelingen - BergOp ROM koppeling.

BergOp is een webbased programma voor routine outcome monitoring en praktijkgestuurd effectonderzoek. In het programma zijn meer dan 20 veel gebruikte meetinstrumenten opgenomen, zoals de Strengths and Difficulties Questionnaire(SDQ), de Nijmeegse OuderlijkeStress Index (NOSI), de C-toets en de GGZ Thermometers.

Met de software kunnen via het internet vragenlijsten afgenomen worden bij patiënten. Door herhaaldelijk te meten kan over de loop van de behandeling de afname van klachten gevolgd worden. De resultaten van een meting zijn onmiddellijk beschikbaar voor de behandelaar, zodat er directe terugkoppeling is over het behandelresultaat bij hun patiënt.Voor de instelling komen gegevens beschikbaar over de effectiviteit van de behandeling van grote groepen patiënten.

BergOp is ontwikkeld door Praktikon. Praktikon ondersteunt instellingen en beleidsmakers bij het evalueren en verbeteren van de kwaliteit van de zorg. De samenwerking van Praktikon met de Radboud Universiteit Nijmegen garandeert het gebruik van wetenschappelijk onderbouwde meetinstrumenten en statistisch verantwoorde analyses.

Beschrijving van het proces/werkwijze
Indien cliëntdossier nog niet aanwezig is in BergOp, dan wordt het cliëntdossier vanuit USER aangemaakt. Gegevens worden dan vanuit USER gekopieerd naar BergOp. Indien het cliëntdossier al wel aanwezig is in BergOp, dan kan dat dossier vanuit USER geopend worden.

Reeds bestaande cliëntdossiers in BergOp moeten initieel gekoppeld worden aan de reeds bestaande cliënten in USER. Het koppelen van de cliënten vindt plaats in BergOp.

De communicatie tussen USER® en BergOp bestaat (in eerste instantie) uit 1-weg verkeer vanuit USER naar BergOp. Deze communicatie kan opgesplitst worden in 2 gedeelten:
  1. Aanroep van BergOP vanuit het EPD van USER® en communicatie van stamgegevens (cliëntgegevens)
  2. Communicatie over inrichting

BergOp is als module aan te roepen vanuit het elektronische dossier. Tijdens deze aanroep wordt ook gecommuniceerd over de stamgegevens van de cliënt en worden wijzigingen, die in USER zijn doorgevoerd, meegenomen.

Inrichting

Default waarden
In het scherm default waarden moet bij standaard_rom_type worden aangegeven, dat dit BERGOP is.

Wallet
Voor een beveiligde verbinding is een wallet noodzakelijk.
  1. Open de URL van bergop in Explorer en klik op het beveiligingsrapport (slotje)
  2. Open de URL van bergop in Chrome en klik op het beveiligingsrapport (slotje)
  3. Klik op ‘Certificaatgegevens’ op het tabblad ‘Verbinding’ en ga naar het tabblad Details.
  4. Klik op ‘Kopiëren naar bestand...’
  5. Vervolgens kiezen voor 'Volgende'.
  6. Alles standaard laten, alleen de volgende wijziging aanbrengen:
    1. Sla het bestand op.
  7. Herhaal nu deze stappen ook voor het 2e (middelste) en 1e (hoogste niveau)  certificaat.
  8. Sluit alles af

Open het programma Portecle.
  1. Kies voor File-->new keystore en maak de keuze voor PKCS#12 en klik op OK.
  2. Kies nu voor Tools-->Import Trusted Certificate
    1. En importeer de certificaten welke je zojuist hebt opgeslagen (beide dus!):
  3. Geef nu de wallet een wachtwoord en sla deze op.
  4. File-->Save keystore as-->
    1. Vul hier een wachtwoord in, onthoud dit wachtwoord goed want dit zal je ook in USER® moeten gebruiken.
  5. Geef in het scherm dat volgt de wallet de naam: ewallet.p12 en sla de wallet op:
  6. Sla nu dit bestand op de bekende share op welke bereikbaar is via het webservices account.
    1. \\ip-adres database server\webservices\[database]\wallet\bergop
    2. (eventueel moet deze laatste map nog worden aangemaakt, dit kun je onder het webservices account zelf doen via de share).
  7. Plaatst in deze map nu het bestand (ewallet.p12)
In USER
Geef het wachtwoord op dat voor de wallet is aangemaakt.

USER inrichting overzetten naar BergOp
Er is een scherm dat ingericht moet worden. Zie menu: Beheer > Inrichten externe koppelingen > BergOp ROM koppeling.

Vul in het scherm de gegevens in waarmee in BergOp kan worden ingelogd. De instellingscode waaronder de instelling bekend is in BergOp moet ingevuld worden in het veld Instellingscode.

Nadat de juiste gegevens voor het inloggen aan BergOp zijn ingevoerd, kan met de knop Synchroniseer de inrichting vanuit USER® worden overgezet naar BergOp.

Tijdens het synchroniseren van de inrichting worden onderstaande regels in acht genomen.
  1. Voor de locaties in BergOp worden alle actieve afdelingen in USER® geselecteerd.
  2. Voor de modules in BergOp worden alle actieve behandelprogramma’s in USER® geselecteerd.
  3. Voor de teams in BergOp worden alle actieve afdeling/groepen geselecteerd.
  4. Om de benodigde hoeveelheid inrichting te reduceren, is ervoor gekozen om geen medewerkers te versturen, maar alleen eindwaardes die gekoppeld zijn aan functies.

Alert
Let op:

Indien het veld ‘Check op behandeling niet afgesloten’ wel is aangevinkt dan wil dat zeggen dat de gebruikers alleen met cliënten met een gestarte behandeling naar de Bergop applicatie kunnen.

Indien het veld  ‘Check op behandeling niet afgesloten’ niet is aangevinkt dan wil dat zeggen dat de gebruikers alleen met cliënten naar de Bergop applicatie kunnen met een gestarte behandeling (actueel), niet gestarte behandeling (nog niet actueel) en/of beëindigde behandeling (niet meer actueel).

Hier kun je dan de Locaties, Modules, Teams en Hulpverleners koppelen.

Om de ROM vanuit USER aan te kunnen roepen moet je ook in BergOp ‘Gebruikers’ aanmaken. De koppeling van medewerkers op basis van de functie vindt plaats in de generieke conversietabel van USER. Dit staat beschreven in paragraaf 4.4.
Aandachtspunt
USER houdt bij welke wijzigingen allemaal gesynchroniseerd zijn. USER kan echter niet checken of de gegevens ook goed zijn ingelezen in Bergop.

Als USER® aangeeft dat er niets te synchroniseren valt, terwijl u zeker weet dat dit wel het geval is, dan moet er een wijziging plaatsvinden in de tabel BERGOP_API_SETTINGS.

Indien er maar 1 rij in deze tabel staat, dan kan de kolom boas_scn_checksum leeggemaakt worden. Hiervoor kan contact opgenomen worden met IMPULSE.

Wanneer gedrukt wordt op de 'Bekijk log' kan per synchronisatie actie bekeken worden wat er precies gesynchroniseerd is. Per onderdeel (Locaties, Teams, Hulpverleners en Modules) kunnen twee acties gelogd worden, afhankelijk van of de synchronisatie voor alle onderdelen in één keer gebeurt of dat de verschillende onderdelen apart gesynchroniseerd worden. Er wordt altijd gelogd wanneer er is gestart met de synchronisatie door middel van de tekst 'Job begin en eind'. Vervolgens wordt er voor het betreffende onderdeel gelogd of er wijzigingen zijn gesynchroniseerd.  

Gebruikers aanmaken in BergOp
De medewerkers moeten bekend zijn in Bergop en de koppeling wordt gelegd op basis van User functies.
Indien er geen koppeling is, dan is er ook geen toegang tot BergOp.
In de generieke conversietabel in USER® wordt aan een USER® functie een BergOp gebruiker gekoppeld. Iedereen die de betreffende functie heeft, kan dan inloggen in BergOp als de BergOp gebruiker die aan die betreffende functie gekoppeld is.
Indien een medewerker meerdere functies heeft, wordt de hoofdfunctie gepakt.
Indien een medewerker niet is gekoppeld aan een functie, verschijnt de volgende melding in USER (bij het aanroepen van BergOp):
  1. “De functie ‘….’ van medewerker ‘….’ Is niet gekoppeld in Bergop”.

De medewerkers die in USER® toegang moeten krijgen tot BergOp moeten ook de rol ROM_AANROEP krijgen in USER®.

Om de ROM vanuit USER aan te kunnen roepen moet je per functie van USER® medewerkers (die in BergOp mogen aanloggen) in BergOp een ‘Gebruiker’ aanmaken.

Er moet ook een wachtwoord worden in gevuld. Om de nieuwe gebruiker te activeren moet je namelijk ook via de URL op een ‘normale’ manier inloggen!
Het veld ID EPD wordt gebruikt voor de koppeling. De waarde die daar staat opgegeven, moet in USER® worden opgegeven in de generieke conversietabel.

Alert
LET OP: Om het veld ID EPD zichtbaar te krijgen moet deze geactiveerd worden. De klant dient hiertoe opdracht te geven via Praktikon. Axtion activeert dan dit veld in BergOp.

BergOp aanroepen vanuit USER
Vanuit het Elektronisch Dossier in USER®, kan BergOp aangeroepen worden via de moduleknop ‘ROM aanroep’.
Vervolgens wordt BergOp geopend met de gegevens van de betreffende cliënt op het scherm.

Autorisatie
De autorisatie van de BergOp wordt geregeld door de rol:
  1. ROM_AANROEP

Aanroep vanuit ADF (Alta)
Om de BergOp ROM koppeling in ADF (Alta) te kunnen gebruiken, moet deze in een dashboard c.q. workflow zijn ingericht. De inrichting hiervoor wordt momenteel nog vanuit FORMS gedaan.
Voor de inrichting worden de volgende schermen gebruikt:
  1. Basis – Basisgegevens dossierregistratie – ADF Dashboard inrichting en ADF Workflow inrichting

In de workflow-item-level moet het volgende aanwezig zijn:

Workflow item level

Bergop

Soort

Module

Module

148 (call external application)

Voor module 148 gelden de parameters:

Bron kolom

Doel kolom

Bron soort

bergop

P_APPL

Parameter (vast)

Technisch informatie aanroep
De koppeling verloopt via SOAP (Simple Open Access Protocol) en data zelf wordt verstuurd als XML (Extensible Markup Language).

De USER inrichting wordt met de beschikbare functies van de Soap Service in BergOp geëxporteerd naar BergOp. Binnen BergOp wordt vervolgens de koppeling gelegd tussen de USER® inrichting en de BergOp inrichting. De volgende inrichtingspunten worden vanuit USER naar BergOp geëxporteerd:
  1. Locatie – Afdeling in USER
  2. Module - Behandelprogramma in USER
  3. Team – Groep in USER
  4. Hulpverlener – Medewerker in USER

Via het scherm “Beheer > Inrichten externe koppelingen > BergOp ROM koppeling”, kan de data worden verstuurd naar BergOp via de web service.

In dit hoofdstuk staat de koppeling beschreven tussen de USER® inrichting en de BergOp inrichting. Meer informatie over de Soap Service in BergOp staat in het document Informatie BergOp Koppeling (Aangepast) V0.0.1.doc

In BergOp zit een SOAP API die beschikt over allerlei functies die benaderd kunnen worden door USER:

Functie in BergOp

Omschrijving

StartClient

Met deze functie kan van Bergop een inloglink worden aangevraagd om automatisch in te loggen in BergOp en naar het overzicht van vragenlijsten van een bepaalde cliënt te gaan. Tevens wordt de cliënt aangemaakt of bijgewerkt.

BijwerkenClient

Hiermee kunnen de gegevens van een bestaande cliënt worden bijgewerkt.

OphalenVragenlijsten

Met deze functie kunnen alle vragenlijsten die zijn ingevuld door een cliënt worden opgehaald.

OphalenBestand

Hiermee kan een bestand worden opgehaald dat bij een bepaalde vragenlijst hoort

VersturenLocaties

Hiermee kunnen locaties vanuit registratiesysteem worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

VersturenModules

Hiermee kunnen modules vanuit registratiesysteem worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

VersturenTeams

Hiermee kunnen teams vanuit registratiesysteem worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

VersturenZorgaanspraken

Hiermee kunnen teams vanuit zorgaanspraken worden verstuurd naar BergOp. In BergOp kunnen beheerders van praktikon deze koppelen.

VersturenHulpverleners

Hiermee kunnen hulpverleners vanuit registratiesysteem worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

BergOp aanroepen vanuit cliëntdossier in USER
Om vanuit USER BergOp te kunnen aanroepen zal gebruik gemaakt worden van de functie StartClient.

USER

BergOp

<inloggegevens>

Beveiliging

Mede_lognaam

gebruikersnaam

Gebruikersnaam voor de koppeling

<???>

wachtwoord

Wachtwoord voor de koppeling

bergop_api_settings. boas_organisatiecode

organisatieNummer

Unieke identificatie van de organisatie in het externe systeem

klnt_nummer

organisatiePersoonsnummer

Unieke identificatie van de cliënt van de betreffende organisatie

Eindwaarde die via generieke conversietabel aan functie gekoppeld is.

medewerkerNummer

Identiteit van medewerker in externe systeem

klnt_sofinummer

Bsn

Cliënt burger service nummer

klnt_voornamen

voornaam

Cliënt voornaam

klnt_voorvoegsels

tussenvoegsel

Cliënt tussenvoegsel

klnt_naam

achternaam

Cliënt achternaam

klnt_geboortedatum

geboortedatum

Cliënt geboortedatum

klnt_geboortedatum wel/niet ingevuld

heeftGeboorteDatum

Cliënt geboortedatum meegestuurd? (boolean: true/false)

klnt_geslacht (1,2)

Geslacht (Man/Vrouw)

Cliënt geslacht (Man/Vrouw)

<Alle Behandelingen die gestart zijn>

zorgpakket

zorgpakketNummer

Beha_dat_start

Startdatum

Startdatum van zorgpakketmodule

Beha_dat_eind

Einddatum

Einddatum van zorgpakketmodule

Beha_dat_eind

heeftEinddatum

Heeft de zorgpakketmodule een einddatum (boolean: true/false)

Beha_afd

Id_locatie

Beha_progbeh

Id_module

beha_groep

Id_team

‘behandelaar’

Id_hulpverlener

-

zorgaanspraken

Locatie – Afdeling in USER
Met de functie VersturenLocaties kunnen locaties vanuit registratiesysteem USER worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

In onderstaande tabel staat de specificatie van de BergOp SOAP functie VersturenLocatie. In de eerste kolom staat aangegeven waar de gegevens uit USER vandaan gehaald moeten worden.

USER

 

Request

Veld

Type

Omschrijving

Beveiliging

object

Beveiliging object

Medewerker.

mede_lognaam

gebruikersnaam

string

Gebruikersnaam voor de koppeling

wachtwoord

string

Wachtwoord voor de koppeling

bergop_api_settings. boas_organisatiecode

organisatieNummer

string

Unieke identificatie van de organisatie in het externe systeem

Locatie

array

Lijst van Locatie objecten

Afdeling.

afde_nummer

Id

string

Locatie id

Afdeling.

afde_omschrijving

Naam

string

Locatie naam

Response

Veld

Type

Omschrijving

ResponseStatus

object

ResponseStatus object

Code

string

Status code

omschrijving

string

Status omschrijving

BijwerkenLocatiesResult

boolean

Succesvol bijgewerkt of niet

Module - Behandelprogramma in USER
Met de functie VersturenModules kunnen behandelprogramma’s vanuit registratiesysteem USER worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

In onderstaande tabel staat de specificatie van de BergOp SOAP functie VersturenModules. In de eerste kolom staat aangegeven waar de gegevens uit USER vandaan gehaald moeten worden.

USER

 

Request

Veld

Type

Omschrijving

Beveiliging

object

Beveiliging object

Medewerker.

mede_lognaam

gebruikersnaam

string

Gebruikersnaam voor de koppeling

wachtwoord

string

Wachtwoord voor de koppeling

bergop_api_settings. boas_organisatiecode

organisatieNummer

string

Unieke identificatie van de organisatie in het externe systeem

module

array

Lijst van Module objecten

progbeh.

prbh_nummer

id

string

Module id

progbeh.

prbh_omschrijving

naam

string

Module naam

Response

Veld

Type

Omschrijving

ResponseStatus

object

ResponseStatus object

code

string

Status code

omschrijving

string

Status omschrijving

BijwerkenModulesResult

boolean

Succesvol bijgewerkt of niet

Team – Groep in USER

Met de functie VersturenTeams kunnen afdelingen vanuit registratiesysteem USER® worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

In onderstaande tabel staat de specificatie van de BergOp SOAP functie VersturenTeams. In de eerste kolom staat aangegeven waar de gegevens uit USER vandaan gehaald moeten worden.

USER

 

Request

Veld

Type

Omschrijving

Beveiliging

object

Beveiliging object

Medewerker.

mede_lognaam

gebruikersnaam

string

Gebruikersnaam voor de koppeling

wachtwoord

string

Wachtwoord voor de koppeling

bergop_api_settings. boas_organisatiecode

organisatieNummer

string

Unieke identificatie van de organisatie in het externe systeem

team

array

Lijst van Team objecten

afd_groep.

afgr_afdeling||’/’||

afgr_groep

id

string

Team id

afd_groep.

afgr_omschrijving

naam

string

Team naam

Response

Veld

Type

Omschrijving

ResponseStatus

object

ResponseStatus object

code

string

Status code

omschrijving

string

Status omschrijving

BijwerkenTeamsResult

boolean

Succesvol bijgewerkt of niet

Hulpverlener – Medewerker in USER

Met de functie VersturenHulpverleners kunnen afdelingen vanuit registratiesysteem USER® worden verstuurd naar BergOp. In BergOp kunnen beheerders van een instelling deze koppelen.

In onderstaande tabel staat de specificatie van de BergOp SOAP functie VersturenHulpverleners. In de eerste kolom staat aangegeven waar de gegevens uit USER vandaan gehaald moeten worden.

USER

 

Request

Veld

Type

Omschrijving

Beveiliging

object

Beveiliging object

Eindwaarde die via generieke conversietabel aan functie gekoppeld is.

gebruikersnaam

string

Gebruikersnaam voor de koppeling

wachtwoord

string

Wachtwoord voor de koppeling

bergop_api_settings. boas_organisatiecode

organisatieNummer

string

Unieke identificatie van de organisatie in het externe systeem

hulpverlener

array

Lijst van Hulpverlener objecten

Eindwaarde die via generieke conversietabel aan functie gekoppeld is.

Id

string

Hulpverlener id

Medewerker. Mede_voornaam

voornaam

string

Hulpverlener voornaam

Medewerker. mede_voorvoegsels

tussenvoegsel

string

Hulpverlener tussenvoegsel

Medewerker. Mede_naam

achternaam

string

Hulpverlener achternaam

Response

Veld

Type

Omschrijving

ResponseStatus

object

ResponseStatus object

Code

string

Status code

Omschrijving

string

Status omschrijving

BijwerkenHulpverlenersResult

boolean

Succesvol bijgewerkt of niet

Alleen medewerkers die beschikken over de rol ROM_AANROEP(_LEES) worden via dit bericht verstuurd.

Conversie
Reeds bestaande cliëntdossiers in BergOp moeten initieel gekoppeld kunnen worden aan de reeds bestaande cliënten in USER.

    • Related Articles

    • Agenda koppeling voorkeuren

      Agenda koppeling voorkeuren Het scherm is te benaderen via het menu Functioneel beheer - Beheer - Externe koppelingen - Agenda koppeling voorkeuren Om vanuit Outlook taken of overige afspraken aan te kunnen maken, moeten er voorkeuren worden ...
    • Cliëntdashboard

      Cliëntdashboard Bij het openen van het cliëntdashboard opent er eerst een zoekscherm waarmee het dossier van een cliënt kan worden opgezocht. Dit zoekscherm bestaat uit een 'eenvoudige' stand en een 'uitgebreide' stand: Eenvoudig zoeken Zoekscherm in ...
    • Meetinstrument mailen naar een relatie

      Meetinstrument mailen naar een relatie Dit scherm is te benaderen via de ROM-module. Het is hier mogelijk om meetinstrumenten aan te bieden aan de relatie(s) uit het sociale netwerk. Beschrijving proces Er zijn meetinstrumenten die door personen uit ...
    • Default waarden

      Default waarden Het scherm is te benaderen via de tegel Inrichting - Organisatie - Default waarden. In dit scherm kunnen de default waarden voor velden worden ingevuld. De velden waarvoor default waarden kunnen worden vastgelegd zijn door de ...
    • Meetinstrument (algemeen)

      Meetinstrument Een formulier hangt altijd onder een formulier groep (te vergelijken met de categorieën bij de vragenlijsten). Binnen een formulier groep kunnen meerdere formulieren bestaan. Is dat het geval, dan zal het eerste formulier als initieel ...