Installatiehandleiding - Deel 2 DocTrails.NET Connector D Soft nv 28-8-2007
Inleiding 2 1 Inleiding De DocTrails.NET Connector laat u toe om berichten via het BlueRidge DocTrails platform naar uw handelspartners te sturen of om berichten te ontvangen. stap x verwijst naar de stappen in het verkorte online onboarding programma (https://www.doctrails.net/public/nl/onboarding.aspx ) De schermafbeeldingen in deze handleiding zijn gemaakt onder Windows Vista. Voor oudere Windows-versies wijken ze enigszins af, maar het principe blijft gelijk. 1.1 Systeemvereisten Windows 2000 SP4, Windows XP SP2, Windows Vista.NET Framework 2.0 of hoger 1.2 DocTrails.NET Connector downloaden stap 6 1 Download de DocTrails.NET Connector op http://www.doctrails.net/public/nl/download.aspx 2 Sla het installatieprogramma op
DocTrails.NET Connector installeren 3 2 DocTrails.NET Connector installeren 2.1 Standaardinstallatie stap 6 1 Start het DocTrails.NET Connector installatieprogramma 2 Volg de stappen op het scherm om de DocTrails.NET Connector te installeren. Er wordt u onder andere gevraagd om een locatie voor het programma op te geven. In de meeste gevallen kunt u de voorgestelde locatie gewoon aanvaarden. 3 Na enige ogenblikken is de installatie voltooid. Bij een succesvolle installatie staan: op het bureaublad 2 snelkoppelingen onder het Start-menu > Programma s > D Soft > BlueRidge DocTrails Connector gelijkaardige snelkoppelingen
DocTrails.NET Connector installeren 4 Er zijn 2 connectoren aangemaakt: BlueRidge DocTrails Connector Staging voor het testen van nieuwe berichtenstromen BlueRidge DocTrails Connector Production voor de eigenlijke berichten 2.2 Repareren en verwijderen Mocht u reeds eerder de DocTrails.NET Connector geïnstalleerd hebben, dan verschijnt bij het starten van het installatieprogramma het volgende scherm: U kunt uiteraard ook de standaard Windows deïnstallatieprocedure gebruiken als u DocTrails.NET Connector wilt verwijderen. Als u manueel een nieuwe versie van DocTrails.NET Connector gedownload heeft, dan moet u eerst de geïnstalleerde versie verwijderen alvorens de nieuwe te installeren. 2.3 Automatische updates DocTrails.NET Connector wordt automatisch geüpdatet als er een nieuwe versie beschikbaar komt. Dit gebeurt volledig transparant.
Configuratie van de testomgeving 5 3 Configuratie van de testomgeving 3.1 Inleiding Het BlueRidge DocTrails platform laat u toe om berichten met uw handelspartners uit te wisselen. Hiertoe moet eerst een berichtenstroom opgesteld worden die het binnenkomend formaat converteert naar het gewenste uitvoerformaat en waarbij verder bepaald wordt wie de verzender en ontvanger(s) van het bericht zijn. Een berichtenstroom wordt altijd eerst getest in een aparte omgeving, de zgn. stagingomgeving of testomgeving. Tijdens het testen kunnen zender en ontvanger de goede werking van de berichtenstroom nagaan. Pas als dit door alle partijen is goedgekeurd, wordt de berichtenstroom toegankelijk in de productie-omgeving. U moet dus na het aanmaken van elke nieuwe berichtenstroom eerst een aantal tests uitvoeren via de staging-omgeving. Hiervoor gebruikt u: BlueRidge DocTrails Connector Staging op een locale PC BlueRidge DocTrails Staging website (https://staging.doctrails.net ) Berichten die u via de Staging-omgeving verstuurt, hebben geen wettelijk bindend karakter. De berichten worden tevens automatisch na een bepaalde tijd verwijderd. 3.2 Basisconfiguratie DocTrails Connector Staging stap 6 1 start de BlueRidge DocTrails Connector Staging vanop het bureaublad of via het Windows Start-menu Gedurende enkele ogenblikken verschijnt een opstartscherm:
Configuratie van de testomgeving 6 Als u de DocTrails Connector voor het eerst wil gebruiken, dan ziet u in de Windows System Tray het icoon van een gestopte DocTrails Connector (rood kruis) met een foutmelding: In de titelbalk van het dialoogvenster ziet u duidelijk dat de connector gekoppeld is aan de Staging-omgeving. Als u een nieuwe berichtenstroom heeft aangevraagd, ziet u die voorlopig alleen in deze omgeving. 2 Onder het tabblad Settings selecteert u het GlobalSign PersonalSign certificaat dat u eerder heeft aangevraagd Dit certificaat moet hetzelfde zijn als wat u heeft gekoppeld aan uw account op de BlueRidge DocTrails portaal. Is dit niet het geval, dan ziet u onderstaande melding: Als uw persoonlijk certificaat niet zichtbaar is, zie Problemen oplossen en rapporteren.
Configuratie van de testomgeving 7 3 Bij ProcessInterval geeft u in hoe vaak, in seconden, de DocTrails Connector de geconfigureerde mappen (zie verder) moet controleren op nieuwe bestanden of connectie moet maken met het BlueRidge DocTrails platform. In de testfase kunt u een lage waarde gebruiken, maar later in de productie-omgeving houdt u die waarde best niet te laag om onnodige belasting van het systeem te vermijden. 4 Maakt u gewoonlijk gebruik van een proxy server om het internet op te gaan, dan kunt u die ook in de DocTrails Connector opgeven. Raadpleeg zonodig uw systeembeheerder voor de precieze instellingen. 5 Klik op de knop Save Configuration om de veranderingen te bewaren
Configuratie van de testomgeving 8 3.3 Een uitgaande berichtenstroom configureren stap 6, 7 1 Rechtsklik op het DocTrails Connector icoon in de System Tray en kies Configuration om opnieuw het DocTrails Connector configuratievenster te openen. 2 Als er nog geen berichtenstromen geconfigureerd zijn, krijgt u onderstaande melding: 3 In het tabblad Outgoing Flows krijgt u een overzicht van alle uitgaande berichtenstromen die voor uw gebruikersaccount geactiveerd zijn 4 Klik op de Browse knop naast de berichtenstroom die u wil instellen. Vervolgens bladert u naar de map waaruit alle berichten moeten opgepikt worden. Indien gewenst kunt u vooralsnog een nieuwe map aanmaken. In deze map plaatst uw boekhoudpakket of ERP systeem bijvoorbeeld de uitgaande facturen.
Configuratie van de testomgeving 9 5 Klik op het rode start/stop icoon om de uitgaande berichtenstroom te starten. Het icoon wordt groen om aan te geven dat de berichtenstroom wacht op berichten. 6 Klik op de knop Save Configuration om de veranderingen te bewaren 7 In de Windows System Tray ziet u het ikoon dat wijst op een correcte werking van de DocTrails Connector 8 Van zodra uitgaande berichten in de ingestelde map verschijnen, worden ze opgepikt door de DocTrails Connector (afhankelijk van de ProcessInterval waarde), versleuteld met uw persoonlijk certificaat en verzonden naar het BlueRidge DocTrails platform.
Configuratie van de testomgeving 10 9 U kunt de correcte verzending en conversie van de berichten controleren door aan te melden in de BlueRidge DocTrails portaal. Bij Verzonden berichten vindt u alle door DocTrails verwerkte berichten terug. selecteer de folder waar uw boekhoudpakket of ERP systeem de facturen heeft geplaatst. De DocTrails Staging Connector zal de bestanden in deze map oppikken en versturen naar uw bestemmeling.
Configuratie van de testomgeving 11 3.4 Een inkomende berichtenstroom configureren stap 6, 7 1 Rechtsklik op het DocTrails Connector icoon in de System Tray en kies Configuration om opnieuw het DocTrails Connector configuratievenster te openen. 2 In het tabblad Incoming Flows krijgt u een overzicht van alle uitgaande berichtenstromen die voor uw gebruikersaccount geactiveerd zijn 3 Klik op de Browse knop naast de berichtenstroom die u wil instellen. Vervolgens bladert u naar de map waarin de binnenkomende berichten moeten komen.
Configuratie van de testomgeving 12 4 Klik op het rode start/stop icoon om de uitgaande berichtenstroom te starten. Het icoon wordt groen om aan te geven dat de berichtenstroom wacht op berichten. 5 Klik op de knop Save Configuration om de veranderingen te bewaren 6 In de Windows System Tray ziet u het ikoon dat wijst op een correcte werking van de DocTrails Connector 7 Van zodra de DocTrails Connector voor u bestemde berichten aantreft op het BlueRidge DocTrails platform, worden ze gedownload en automatisch in de ingestelde map geplaatst berichten (afhankelijk van de ProcessInterval waarde).
Configuratie van de productie-omgeving 13 4 Configuratie van de productie-omgeving 4.1 Inleiding Nadat een berichtenstroom door alle partijen is goedgekeurd in de staging-omgeving wordt hij beschikbaar gesteld in de productie-omgeving. Van dan af gebruikt u: BlueRidge DocTrails Connector Production op een locale PC BlueRidge DocTrails website (https://www.doctrails.net ) Berichten die u via de productie-omgeving verstuurt, hebben een wettelijk bindend karakter. 4.2 Configuratie DocTrails Connector Production stap 8 De configuratie van de DocTrails Connector Production is volledig identiek aan de DocTrails Connector Staging. Ook hier dient u het zelfde persoonlijke certificaat te koppelen en de berichtenstromen te configureren. U krijgt alleen die berichtenstromen te zien die door u, uw handelspartner en D Soft zijn goedgekeurd. Eenmaal de DocTrails Connector is opgestart ziet u in de titelbalk met welke omgeving geconnecteerd wordt. Alle stappen zijn vervolgens identiek aan de configuratie van de DocTrails Connector Staging. Let wel: u ziet alleen de berichtenstromen die voor productie zijn goedgekeurd.
Berichtopvolging stap 7, 8 14 5 Berichtopvolging stap 7, 8 U kunt via de BlueRidge DocTrails websites de status van uw verzonden of ontvangen berichten volgen. Log aan op https://staging.doctrails.net (testomgeving)of https://www.doctrails.net (productieomgeving) U vindt de verzonden berichten terug onder Verzonden berichten Berichten die fout gegaan zijn bij de verwerking, zijn terug te vinden onder Foutberichten. Als de fout zich echter al situeert bij het versturen van het bericht met de DocTrails Connector, dan wordt de fout in de Windows Event Viewer gelogd (zie Problemen oplossen en rapporteren ). Binnenkomende berichten staan onder Postvak In Door op een bericht te klikken, krijgt u de details van het bericht te zien (bv. stappen in de verwerking)
Problemen oplossen en raporteren 15 6 Problemen oplossen en raporteren 6.1 U krijgt geen verbinding met het BlueRidge DocTrails platform Als u foutmeldingen zoals hieronder blijft krijgen, dan kan DocTrails Connector geen connectie maken met het BlueRidge DocTrails platform. 1 Probeer met Internet Explorer te surfen naar een willekeurig internetadres. Als dit lukt, heeft u vermoedelijk de proxy-instellingen in de DocTrails Connector verkeerd geconfigureerd 2 Start de DocTrails Connector en corrigeer de proxy-instellingen. Uw systeembeheerder kan u hierbij assisteren.
Problemen oplossen en raporteren 16 6.2 Uw persoonlijk certificaat is niet zichtbaar Als uw GlobalSign PersonalSign certificaat niet zichtbaar is, dan heeft u het misschien niet geïnstalleerd op de PC waarop u de DocTrails Connector wilt gebruiken. Op de PC waarop u het certificaat ontvangen heeft, dient u dit eerst te exporteren om het vervolgens te importeren op de DocTrails Connector PC. 1 Op de PC met het GlobalSign PersonalSign certificaat opent u Internet Explorer 2 Kies Tools > Internet Options en klik vervolgens in het tabblad Content op Certificates 3 Selecteer uw persoonlijk certificaat onder het tabblad Personal
Problemen oplossen en raporteren 17 4 Exporteer de private sleutel met onderstaande opties 5 Geef een paswoord in en kies een locatie voor het bestand 6 Na een succesvolle export staat nu een pfx-bestand op de gewenste locatie. Kopieer dit bestand nu naar de PC met de DocTrails Connector. 7 Op de PC met de DocTrails Connector opent u Internet Explorer
Problemen oplossen en raporteren 18 8 Kies Tools > Internet Options en klik vervolgens in het tabblad Content op Certificates 9 Selecteer Import en blader vervolgens naar het pfx-bestand dat u eerder geëxporteerd heeft 10 Geef het paswoord en onderstaande opties 11 Uw GlobalSign PersonalSign certificaat is nu geïnstalleerd en kunt nu de DocTrails Connector verder configureren.
Problemen oplossen en raporteren 19 6.3 Uw persoonlijk certificaat kan niet gebruikt worden Dit certificaat moet hetzelfde zijn als wat u heeft gekoppeld aan uw account op de BlueRidge DocTrails portaal. Is dit niet het geval, dan ziet u onderstaande melding: Om uw GlobalSign PersonalSign certificaat te koppelen volgt u volgende stappen: 1 Log aan op http://www.doctrails.net 2 Onder Aanmeldinstellingen kiest u in de lijst met beschikbare certificaten uw persoonlijk certificaat 3 Klik op Koppel geselecteerd certificaat 6.4 Er zijn geen berichtenstromen zichtbaar Bij het opstarten van de DocTrails Connector verschijnt onderstaande foutmelding én in de tabbladen Incoming Flows en Outgoing Flows ziet u geen berichtenstromen staan: De oorzaak hiervan kan zijn: Staging: u heeft nog geen berichtenstromen aangevraagd of uw aanvraag is nog in behandeling. Volg de procedure in de DocTrails Installatiehandleiding deel 1 om een berichtenstroom aan te vragen Production: uw berichtenstroom is wel actief in de staging-omgeving, maar nog niet in de productie-omgeving. Als u, uw handelspartner akkoord zijn over de goede verwerking van de berichten, kunt u het DocTrails team vragen uw berichtenstroom te activeren.
Problemen oplossen en raporteren 20 6.5 Probleemrapport opvragen en bewaren Alle acties van de DocTrails.NET Connector worden gelogd a.d.h.v. standaard Windows events. Als u door DocTrails medewerkers gevraagd wordt om een probleemrapport te bewaren, dan doet u dit als volgt: Onderstaande schermafbeeldingen zijn gemaakt onder Windows Vista. Voor oudere Windowsversies wijken ze enigszins af, maar het principe blijft gelijk. 1 In het Windows Start-menu kiest u Run 2 Typ eventvwr en klik op OK 3 In de Event Viewer ziet u een aparte log voor de Staging en voor de Production Connector. Klik op het Connector log dat u wilt bekijken. U krijgt een lijst met alle acties die door de DocTrails Connector zijn uitgevoerd. Rode uitroeptekens duiden op fouten. 4 Selecteer de events die op een probleem duiden en kies Action > Save Selected Events of kies File > Save log as om het volledige logbestand te bewaren.
Problemen oplossen en raporteren 21 5 Kies een naam en locatie voor het logbestand.