INSTALLATIONSVEJLEDNING SONWIN SERVER NETSXML 1/11
VERSIONSHISTORIK Dato Version Forfatter Handling 2016-09-30 1.0 VIC Dokument oprettet. 2016-10-14 1.1 SRA Tilrettet Bygget med SonWin Server NetsXML 2.33.2629.908 INDHOLDSFORTEGNELSE 1 Formål og omfang 2 Forudsætninger 2.1 System 2.2 Kvalifikationer 2.3 Produktet 2.4 Betalingsservice medsend bilag (BS03 XML) 2.5 Postkasse 3 Produktet 3.1 Relationer 3.2 Systemanbefalinger 4 Installation 4.1 Opstart 4.2 Servicenavn 5 Konfiguration 5.1 nets.xml 5.1.1 netsaccount 5.2 config.xml 5.2.1 NumThreads 5.3 SonWin Server.exe.config 5.4 Uden NetsComm (for selskabet der ikke har licens) 6 Opdatering 7 Afinstallation 2/11
1 Formål og omfang Med denne vejledning bliver du i stand til at installere og konfigurere SonWin Server NetsXML (herefter benævnt SNEX). SNEX gør det muligt for SonWin at danne filer i formatet XML000 til Nets (Betalingsservice). Nets står for opkrævning af de fakturaer der medsendes i filerne. Vejledningen omhandler følgende: Installation af SonWin Server NetsXML Konfiguration af servicen Opsætning af SonWin-databasen Brugerhåndtering af SonWin Medsend Bilag (herefter benævnt MSB), herunder bestilling, godkendelse og overvågning af MSB pakker til Nets er beskrevet i F1-hjælpen i SonWin og er ikke omfattet af denne vejledning. 2 Forudsætninger 2.1 System Vejledningen forudsætter at du har gennemgået den generelle vejledning SonWin Server Installation. Denne kan hentes på kundeområdet. SNEX kræver ikke direkte en licens, men licens til MedsendBilag og PBSTotal skal haves. Du skal derfor have din licenskode parat når du installerer SNEX første gang. SNEX er designet til at arbejde i tråde for at kunne danne pakker så hurtigt som muligt. Det er normalt at CPU-forbruget ligger >90% ved anvendelse af præ-renderede fakturaer (SonWin Server Invoice Renderer). Hvis SNEX danner bilag, er ressourceforbruget mere I/O-baseret og belastningen ligger derfor mere ovre på SQL-serveren end på applikationsserveren. SNEX kan både danne faktura under kørsel eller finde faktura i databasen hvis produktet SonWin Server Invoice Renderer (SWIR) er implementeret. 2.2 Kvalifikationer For at gennemføre alle trin i denne vejledning skal du og/eller dit team have følgende kvalifikationer: Grundlæggende kendskab til Windows systemadministration Grundlæggende kendskab til SonWin INI-filer Grundlæggende kenskab til redigering af XML-filer Grundlæggende kendskab til SonWin Billing-databasen 2.3 Produktet Før leverancer til Nets kan foretages skal en række forudsætninger være på plads. Vigtigt er at der er en aftale med Nets og at afregntype, fakturatype, regningskanal og betalingskanal er opsat for at SNEX ved hvilke fakturatyper der skal medtages i en kørsel. Her skal Sonlinc kontaktes for en konvertering af disse i SonWin. 2.4 Betalingsservice medsend bilag (BS03 XML) 3/11
For at bilag kan afleveres hos Nets skal formularen BS03 XML udfyldes. Denne formular giver adgang til delsystemet BM5 som benyttes til behandlingen af bilag. 2.5 Postkasse Før data kan afleveres skal en dataleverandøraftale være på plads. Formularen DL01 kan erhverves ved henvendelse til Nets. I forbindelse med udfyldelsen af formularen angives bl.a. delsystem og datakommunikationsform. Delsystemet aftales med Nets i forbindelse med oprettelsen. Bemærk at datakommunikationsformen skal være SFTP såfremt SonWin Server NetsComm skal anvendes til integration mellem SonWin og Nets. Når aftalen er på plads skal en postkasse oprettes hos Nets. Dette gøres efter Nets vejledning med digital signatur. Ved bestilling af nøgle kan både DSA og RSA angives. Begge typer er understøttet af SNEX. Bemærk at PuTTY private keys (.ppk filer) ikke er understøttet af SNEX. Når en ny nøgle bestilles hos Nets, inaktiveres eksisterende nøgler. Vær derfor opmærksom på om andre systemer benytter nøglen inden en ny bestilles. 3 Produktet 3.1 Relationer SonWin Server NetsXML kan enten danne bilag (PDF) selv eller benytte præ-renderede bilag fra databasen. Hvis præ-renderede bilag skal anvendes, skal SonWin Server Invoice Renderer installeres. Kommunikation med Nets kan automatiseres med produktet SonWin Server NetsComm. Denne sørger for at udveksle filer med postkassen hos Nets via SFTP. 3.2 Systemanbefalinger For dimensionering af hardware henvises til konfigurationsguiden. Du kan finde konfigurationsguiden på kundeområdet. 4 Installation SNEX benytter en anden MSI-pakke end de normale SonWin Server-komponenter. Du skal derfor installere denne på en anden måde end normalt. 4/11
4.1 Opstart Installationen kræver fulde administrative rettigheder. Start derfor med at åbne en kommandoprompt som administrator. Dette gøres ved at søge efter cmd, højreklikke Command Prompt og vælge Run as administrator. Efterfølgende trykkes Yes til elevering af rettigheder og nu er prompten klar. Installationen startes ved at skrive navnet på installationspakken og trykke enter. Har du lagt installationspakken på skrivebordet gøres dette som illusteret. I ovenstående eksempel er brugernavnet sra. 4.2 Servicenavn Du vil under installationen blive bedt om at tage stilling til et servicenavn. Dette er navnet på den instans af SNEX som du installerer lige nu. 5/11
Sørg også for at installationsmappen ikke overskriver en allerede installeret instans. Du angiver installationsmappen i nedenstående skærmbillede. Hvis du ikke har installeret flere instanser af SNEX, kan du se bort fra denne advarsel. 6/11
5 Konfiguration Konfigurationen af SNEX foregår delvist via bchec og delvist via en XML-konfigurationsfil. Bchec-koderne skal opsættes i SonWin Billing inden servicen startes. XML-konfigurationen skal ligeledes opsættes inden servicen startes. I denne vejledning gennemgås de for produktet specifikke indstillinger. Du skal derfor have opsat de generelle indstillinger som angivet i den generelle vejledning SonWin Server Installation. 5.1 nets.xml Filen nets.xml er opbygget af en række sektioner: netsaccount database company Repræsenterer en postkasse hos Nets Repræsenterer en SonWin afregningsdatabase Repræsenterer et firmanummer i SonWin Man kan have flere netsaccount-sektioner i konfigurationen. Hver netsaccount-sektion kan have flere database-sektioner og hver database-sektion kan have flere company-sektioner. Hver sektion skal have et unikt ID tilknyttet og vi anbefaler at du benytter en fortløbende nummerserie. 5.1.1 netsaccount Sektionen omhandler en række mappe-typer: Inbox Outbox Error Other Filer der er downloadet fra postkassen hos Nets Filer der skal sendes til postkassen hos Nets Filer der er fejlet under indlæsning Filer der ikke kan håndteres automatisk Mapperne kan med fordel placeres på et netværksdrev, da både SNEX, Billing Client og brugerene skal have adgang til dem. De kan dog låses lidt forskelligt ned alt efter behov. 5.1.1.1 inbox Filer i inbox er filer som er modtaget fra Nets. Heri ligges kvitteringer fra Nets og brugeren skal derfor have skrive-adgang til mappen for at kunne kopiere filerne derind. Benyttes NetsComm automatiseres denne process og adgangen kan derfor begrænses til NetsComm og SNEX. 5.1.1.2 outbox Filer i outbox er filer som skal sendes til Nets. Heri kopieres filer fra Billing Client og brugeren skal derfor have skrive-adgang til mappen. Brugeren vil normalt slette filerne fra denne mappe, så snart de er afsendt til Nets. Benyttes NetsComm automatiseres denne process, men brugeren skal stadig have adgang, da Billing Client skal kunne skrive i mappen. 5.1.1.3 error Filer der ender i error er typisk filer hvor bundtnummeret ikke kan matches i nogen af de opsatte databaser. Mappen bør overvåges, da tilstedeværelsen af filer er et udtryk for datafejl i systemet. Brugere bør have adgang til at læse indholdet for at kunne fejlsøge. 5.1.1.4 other 7/11
Filer i other er filer som er downloadet fra Nets (via NetsComm), men som ikke kan håndteres automatisk af SNEX. Dette kan f.eks. være, men er ikke begrænset til, indbetalingsfiler (M602). Brugeren skal have læse- og skrive-adgang til mappen, da de skal flytte filerne ud og behandle dem manuelt. Overvågning af mappen er ikke direkte nødvendig, men backoffice bør overveje at indføre en rutinemæssig kontrol af indholdet. Mappen benyttes kun med integration via NetsComm, men skal være opsat i SNEX uagtet om NetsComm er installeret. 5.1.1.5 Arkiv Stien til arkivet er angivet i bchec EDI-PLAC/NETSXML, da hvert firma kan have sit eget arkiv. Brugeren skal have læse- og skrive-adgang til denne mappe, da den benyttes fra Billing Client. 5.1.1.6 Postkassen (SFTP) Indstillinger for SFTP-kontoen angives også her. pollinterval angiver det interval der synkroniseres til SFTP-kontoen med. Bemærk at NetsComm starter en synkronisering såfremt en fil lægges i udbakken uanset hvor lang tid der er tilbage på timeren. I database-sektionen angives én eller flere databaser. En database kan angives med reference til en INI-fil eller som en connection string. I company-sektionen angives de firmanumre som NetsComm og StatusUpdater skal kigge i. Det er desuden muligt at slå StatusUpdater fra pr. firmanummer. Dette gøres med parameteren movetooutbox. 5.1.1.7 Eksempel Nedenstående er et eksempel på en konfiguration. 8/11
Der kan indsætte mere end et ID. 5.2 config.xml 5.2.1 NumThreads Angiver antallet af tråde. For at finde den rette værdi, skrues op for antal tråde indtil CPU erne er belastet >90%. Vær dog opmærksom på om SQL-serveren kan følge med. Standardværdien er 0, hvilket angiver at SNEX skal starte et antal tråde svarende til antallet af logiske CPU er i maskinen. Som en tommelfingerregel bør man starte med dobbelt så mange tråde som antallet af virtuelle CPU er. Øvrige konfigurationsmuligheder skal kun ændres i samarbejde med Sonlinc. 5.3 SonWin Server.exe.config 9/11
I testmode kan StatusUpdater sættes i value. Det vil betyde at Snex-filer ikke flyttes til outbox. 5.4 Uden NetsComm (for selskabet der ikke har licens) Hvis NetsComm ikke benyttes er det væsentligt at kvitteringsfilerne dannes i en midlertidig mappe og derefter flyttes til indbakken efterfølgende (se evt. pkt. 5.1.1.1), da dette mindsker risikoen for at filerne åbnes for tidligt (og en timeout opstår). 6 Opdatering Sonlinc anbefaler at alle SNEX-servere lukkes ned inden opdatering påbegyndes. Der er yderst vigtigt at alle job er afviklet før SNEX stoppes. Ved opdatering startes installationspakken med eleverede rettigheder på samme måde som under en ny installation. Du skal nu vælge den instans som skal opgraderes. Dette vælger du ud fra den installationsmappe du valgte da du installerede produktet. 10/11
Herefter fortsættes opdateringen som normalt. 7 Afinstallation For at afinstallere produktet startes installationspakken som ved opdatering, dog med den variation at du start installationspakken til den allerede installerede version. Efter at du har valgt instansen, kommer nedenstående skærmbillede frem. Vælg Fjern og tryk Næste. Fortsæt de efterfølgende dialogbokse for at afinstallere produktet. 11/11