NovaXport

NOVAX(R) e-conomic(R)

Installation

NOVAX

Kun NOVAX har administratorrettighed til serveren, der afvikler NOVAX-systemet. Det skal derfor aftales med NOVAX’ support, at de gør følgende:

Eksempler på den fysiske mappe på serveren, hvor fakturafilerne bliver gemt:

E-conomic

Der er ikke noget, der kan installeres i e-conomic, da den er web-baseret, men der er en række punkter, der skal konfigureres korrekt af en bruger med administratorrettigheder.

Disse er beskrevet i: Konfiguration.

Netværk

Serveren, der afvikler NOVAX-systemet, er typisk installeret i et lukket netværk, der hører til NOVAX, og som kun NOVAX har adgang til, og som NOVAX administrerer. Det er blandt andet derfor, at brugeren betjener NOVAX-systemet via Fjernskrivebord.

For at give NovaXport adgang til serveren, er der tre muligheder:

Ingen af de tre muligheder kan realiseres uden en aftale med NOVAX.

Den første mulighed kan være kostbar. Den sidste vil NOVAX formentlig ikke tillade, fordi de har ansvaret for maskinens drift. Den nemmeste og mest sandsynlige mulighed er derfor VPN-forbindelsen, som kan etableres ved en aftale mellem klinikkens IT-folk og NOVAX. Når den er oprettet, kan en Windows-maskine under klinikkens kontrol og administration sættes op, og NovaXport installeres på den.

En fjerde mulighed er, at klinikkens lokalnet allerede er forbundet til NOVAX’ hosting-net. I så fald skal maskinen blot forbindes til lokalnettet på samme måde som klinikkens øvrige maskiner.

VPN-forbindelse

Vælges denne løsning, skal SMBv3-protokollen kunne passere firewallen. Derfor skal denne port være åben:

TCP 445

Maskine

Der er ingen særlige krav til maskinen, der skal afvikle NovaXport ud over, hvad Windows kræver. Da maskinen i det daglige vil passe sig selv, kan følgende krav formuleres:

Krav til maskine

Krav til Windows-version

Opdatering, sikkerhedskopiering og vedligeholdelse bør som minimum følge samme procedurer som for klinikkens øvrige maskiner.

NovaXport

Filer

Der er ikke nogen installationsrutine til NovaXport. De nødvendig filer leveres i en zip-fil og en kommandofil, der kan bruges til at pakke zip-filen ud:

De kan med fordel kopieres til brugernes fællesmappe Delte filer (typisk C:\Users\Public).

Herefter kan filerne installeres enten manuelt eller halvautomatisk:

1. Manuel installation

Zip-filen indeholder disse to mapper:

Efter login på maskinen med en administratorkonto kan filerne herfra kopieres ind i de tilsvarende Windows systemmapper:

som typisk vil være disse fysiske mapper:

Det kan gøres enten manuelt eller med Stifinder.

2. Halvautomatisk installation

Åbn med administratorrettigheder et Terminal-vindue i mappen med filerne og kald kommandofilen således:

.\NovaXport_Unpack

Kontrol af installation

Herefter skal der i de to mapper som minimum være disse fire filer:

Der vil i programmappen også være to undermapper, Command og Desktop Shortcuts, med disse hjælpefiler:

Desuden er der undermapper med hjælpeprogrammer til visning af databasen og logbogen:

Brugen af disse omtales under Konfiguration og Kontrol og vedligeholdelse.

Genvejene fra undermappen Desktop Shortcuts kan med fordel kopieres til Skrivebord, da man så har stort set alt for hånden til pasning af NovaXport.

TIP: Genvejene kan også kaldes med PowerShell fx under Windows Server Core Edition, blot skal det fulde filnavn angives, fx:

start "NovaXport Service Prompt.lnk"

Tjenesten

De fem kommando-filer indeholder de nødvendige kommandoer til - hvad deres navne siger - at:

NB: Alle kommandofiler skal køres fra en Kommandoprompt åbnet med administratorrettigheder.

Derfor er der også (se ovenfor) inkluderet en genvej, NovaXport Service Prompt, der åbner cmd.exe med administratorrettigheder. Den kan umiddelbart kopieres til Skrivebord.

Den første kommandofil er den kritiske, for det er den, der ved gentagne kald af sc.exe registrerer NovaXport.exe som en tjeneste med den korrekte konfiguration. Den ser således ud:

: Command file for registering NovaXport as a service.
: V 1.0.1
: 2023-10-15. Gustav Brock, Cactus Data ApS, CPH.

@echo off

: Variables.
setlocal
set novaxport=NovaXport
set displayname=Novax eksport
set description=Novax fakturaeksport til e-conomic

: Header block.
echo Opret %novaxport% tjenesten.
echo V 1.0.
echo 2023-10-15. Gustav Brock, Cactus Data ApS, CPH.
echo ----------------------------------------------
echo.

: Register the service.
echo Opretter %novaxport% som tjeneste ...
echo.
sc.exe create %novaxport% binpath="%ProgramFiles%\Novax Export\NovaXport.exe"

: Configure the names of the service and specify delayed auto start.
sc.exe config %novaxport% displayname="%displayname%"
sc.exe config %novaxport% start=delayed-auto
: Add the description to the service.
sc.exe description %novaxport% "%description%"
echo.

: Display the result.
sc.exe queryex %novaxport%
echo.

: Clean up and await a key press.
endlocal
echo Et tastetryk afslutter.
pause > nul

: EOF

Køres den, registreres NovaXport som en tjeneste, og det vises således:

C:\Program Files\Novax Export>NovaXport_Create
Opret NovaXport tjenesten.
V 1.0.
2023-10-15. Gustav Brock, Cactus Data ApS, CPH.
----------------------------------------------

Opretter NovaXport som tjeneste ...

[SC] CreateService SUCCESS
[SC] ChangeServiceConfig SUCCESS
[SC] ChangeServiceConfig SUCCESS
[SC] ChangeServiceConfig2 SUCCESS


SERVICE_NAME: NovaXport
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 1  STOPPED
        WIN32_EXIT_CODE    : 1077  (0x435)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0
        PID                : 0
        FLAGS              :

Et tastetryk afslutter.

Bemærk, at tjenesten ikke vil være startet, da den øvrige konfigurationen måske ikke er klar, og det derfor ikke vil give mening, at starte tjenesten inden da.

Den korrekte installationen af NovaXport bør verificeres ved at vise Windows’ liste over installerede Windows Tjenester:

NovaXport Service

Yderligere bør NovaXport egenskaber verificeres.

Disse skal vise de to navne, dens beskrivelse, om den kører, og at den startes med forsinkelse:

NovaXport Service Properties

De fire sidste kommandofiler er trivielle. De bruges til at starte, stoppe eller fjerne tjenesten eller få vist dens status.

Fx kan tjenesten startes med NovaXport_Start.cmd, og det vil give dette output:

C:\Program Files\Novax Export>NovaXport_Start.cmd
Start NovaXport tjenesten.
V 1.0.1
2023-10-15. Gustav Brock, Cactus Data ApS, CPH.
----------------------------------------------

Kalder start af NovaXport ...

Tjenesten Novax eksport starter.
Tjenesten Novax eksport er startet.


SERVICE_NAME: NovaXport
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 4  RUNNING
                                (STOPPABLE, NOT_PAUSABLE, ACCEPTS_SHUTDOWN)
        WIN32_EXIT_CODE    : 0  (0x0)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

Et tastetryk afslutter.

På tilsvarende måde kan tjenesten stoppes, fjernes eller få vist sin status.

Database-manager

Endelig skal DB Browser (SQLite) installeres, da den skal bruges til at opsætte NovaXports database, vedligeholde den og justere NovaXports funktion (se Konfiguration og Kontrol og vedligeholdelse).

Installationsfilen hertil, DB.Browser.for.SQLite.msi ligger i undermappen SQLiteBrowser.

Installationen kan gennemføres med standardindstillinger og -valg. Herefter kan genvejen NovaXport Database (se ovenfor) bruges til at åbne NovaXports database direkte.

Bruger man genvejen, åbnes DB Browser for SQLite straks og viser tabellen Company, og de øvrige tabeller kan man uden videre vælge også at få vist ved at vælge dem i kombinationsboksen Table:

NovaxData Company

Log

Det medfølgende program Nirsoft FullEventLogView er til visning af Windows logbog, som NovaXport skriver til ved hver kørsel.

Det er et selvstændigt program, som ikke kræver installation, men bør åbnes direkte med genvejen NovaXport Log, som er omtalt ovenfor.

API for ydernumre

Fakturafilerne oprettet af NOVAX-systemet indeholder klinikkens EAN/GLN-nummer, men ikke klinikkens ydernummer, som normalt kræves oplyst på fakturaen.

Før eksport til e-conomic skal ydernummeret, der hører til EAN-nummeret, derfor først findes, og det sker ved at kald til dette API:

https://api.cactusdata.dk

Det er nemt at kontrollere, at API’et er aktivt, og at computeren har adgang til det:

URL’en ovenfor åbnes med Edge, og API’et skal straks svare:

Healthy

Kontakt Cactus Data, hvis det ikke er tilfældet, for NovaXport vil ikke eksportere fakturaer uden denne forbindelse.

NB: Hvis API’er er aktivt, men ydernummeret ikke kan slås op, anvendes et “standard” ydernummer: 10000

Tilbage til forsiden