[[TOC(heading=NOAH)]]
[[TOC(heading=OpenAC3, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/OpenAC3/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= NOAH =

 - De FENAC heeft een contract met HIMSA voor NOAH WSI services. OpenAC is het software product dat FENAC levert waar de HIMSA NOAH WSI licentie bij zit.
 - We hebben drie user accounts bij HIMSA; die mogen alle drie bij de HIMSA SDK en dergelijke (TODO: die van Adriaan uitzetten)
 - Op 21 april ontvangen we een WSI license file van HIMSA
 - https://www.himsa.com/Members/WebServiceIntegration/tabid/2305/language/en-US/Default.aspx voor WSI documentatie
  - Zie vooral Web Service Integration test setup guide
  - In de developers guide wordt gewezen op de noodzaak om:
    - Eerst de license te installeren (dus die leveren we uit naar onze gebruikers, een keer per kalenderjaar)
    - Dan de WSI installer te draaien (hoeft maar een keer) om de WSI componenten aan te zetten; dit gaat vanaf NOAH 4.4
    - Dan de WSI configuratie aan te passen
  - Voor een hele simpele test kunnen we ook de Back-End Simulator gebruiken
  - We hebben ook een Developer license voor NOAH server, dus we kunnen in Utrecht een NOAH server neerzetten en verdere tests ook daar uitvoeren.

== License Installeren ==

 - Draai de license executable (is verstrekt door FENAC)
 - Draai de WSI components executable (is ook verstrekt door FENAC) en voer zomogelijk configuratie informatie voor de WSI connectie in
 - Herstart de machine waar NOAH op draait (echt, een reboot is nodig, maar dat gaat '''ook''' op de client computers moeten gebeuren)

== Noah WSI configuratie ==
 - Start op de server NOAHBSIntegServerTool.exe in C:\Program Files (x86)\HIMSA\NOAH 4 op.
 - Klik op menu 'File -> Enable Web Integration' aan.
 - Open 'Web Server Settings' via Window -> Configuration - Web Server Settings

   [[Image(noah_webservice_settings.png)]] 

 - Volgende configuratie variabelen instellen: - !BackEndWebServiceName, dat is de naam van de server waarop de OpenAC3 server draait. Name,  dat is een vrij te kiezen naam voor WSI-setup. !NoahSiteIdentification, hier de servernaam invullen waarop de Noah-server is geïnstalleerd. !NoahWebServiceId, je kunt hier het IP-adres invullen als de Noah-webservice op een andere IP moet draaien. !NoahWebServicePort, poortnummer voor Noah-webservice.
 - Noah moet weten naar welke http-poort OpenAC luistert. Hiertoe moet het configuratiebestand {{{ProgramData\HIMSA\Noah\ConfigFiles\NoahWebIntegration.dll.config}}} worden aangepast. Aan het eind van dit configuratiebestand staat een endpoint configuratie met een adres eindigend op {{{/NoahBSOtherEnd}}}. De standaardwaarde is {{{http://localhost:8001/NoahBSOtherEnd}}}. Verander hier {{{8001}}} in de poort waarnaar OpenAC luistert volgens onderstaand voorbeeld. Standaard is dat poort {{{5000}}}
{{{#!xml
        <client>
            <endpoint address="http://localhost:5000/NoahBSOtherEnd" binding="basicHttpBinding"
                bindingConfiguration="BasicHttpBinding_INoahBusinessIntegrationWebOtherSideInterface"
                contract="NoahBusinessSystemSide.INoahBusinessIntegrationWebOtherSideInterface"
                name="BasicHttpBinding_INoahBusinessIntegrationWebOtherSideInterface" />
        </client>
}}}
 - Herstart het systeem (of herstart de Noah windows services).


== OpenAC3 configuratie ==
 - Als het niet mogelijk is om de poort van endpoint {{{/NoahBSOtherEnd}}} aan te passen zoals beschreven in de voorgaande paragraaf dan moet de configuratie van OpenAC worden aangepast zodat OpenAC luistert naar de poort die Noah verwacht. Hiervoor moet {{{!ProgramData\OpenACWeb\hosting.json}}} worden gewijzigd zodat het poortnummer overeenkomt met het poortnummer voor endpoint {{{/NoahBSOtherEnd}}}. Standaard is dat poort {{{8001}}}. Start hierna OpenAC 3 opnieuw op.
 - Aanpassen\toevoegen !NoahServerPoort. De waarde van dit veld moet gelijk zijn aan !NoahWebServicePort van Noah WSI-configuratie. Zie hieronder een fragment van die instelling:
{{{
  "Agb": {
    "Serieprefix": {
      "patient": {
        "F": "AM3",
        "U": "AM7",
        "H": "AM9",
        "S": "AM0",
        "A": "AM0",
        "Q": "H{jaar2}-",
        "default": "OA"
      }
    },
    "AgbLocaties": [
      {
        "Code": "19001234",
        "LocatieNaam": "Utrecht",
        "LocatieLetter": "U",
        "Bestandsmap": "C:\\Users\\ugur\\Documents",
        "NoahServerPoort": "8000",
        "NoahHost": "localhost"
      },

      {
        "Code": "94056905",
        "LocatieNaam": "Amsterdam",
        "LocatieLetter": "A",
        "Bestandsmap": "C:\\Users\\ugur\\Documents",
        "NoahServerPoort": "8000",
        "NoahHost": "localhost"
      },

      {
        "Code": "99999999",
        "LocatieNaam": "Rotterdam",
        "LocatieLetter": "R",
        "Bestandsmap": "C:\\Users\\ugur\\Documents",
        "NoahServerPoort": "8000",
        "NoahHost": "localhost"
      }

    ]
  },
}}}

== OpenAC2 configuratie ==
OpenAC2 moet geconfigureerd worden zodat de opgeslagen patiëntgegevens via de Noah-server in de Noah-database opgeslagen worden.
 - Activeren Noah-module in modules.ini van de adaptatie:
{{{
kern.s080_noah = True
}}}
 - Instellen van de hostname en het poortnummer van Noah WSI.

   [[Image(instellingen_voor_noah.png)]]