Handleiding: BICS Lokaal installeren in testmodus

(Alleen voor ontwikkelaars)

Deze handleiding geeft instructies voor het installeren van BICS Lokaal in de testmodus op een Windows-systeem en het elektronisch melden van een reis in een testomgeving;

Let op: Het is niet mogelijk om zowel de reguliere (productie)versie van BICS Lokaal, als de testversie op hetzelfde apparaat te installeren en te gebruiken. Daarom wordt het aanbevolen om een afzonderlijk apparaat te gebruiken voor de testversie van BICS Lokaal. Bovendien dient u voor elk aangevraagd testaccount een aparte installatie van BICS Lokaal uit te voeren.

Inhoud

  1. Testaccounts aanvragen
  2. BICS-software downloaden
  3. De BICS-installer openen via de Opdrachtprompt
  4. BICS Lokaal openen en configureren
  5. BICS Lokaal gebruiken

1. Testaccount aanvragen

Om het gewenste aantal testaccounts aan te vragen, dient u een e-mail te sturen naar bics@rws.nl. Geef in het tekstveld van de e-mail de reden voor het aanvragen van de testaccounts en vermeld tevens alle namen van de gebruikers en de bedrijfsnaam.

Binnen enkele werkdagen ontvangt u de testaccountgegevens. Houd er rekening mee dat u vanaf stap 4 de gegevens van uw testaccount(s) nodig heeft. Daarnaast is het belangrijk om te weten dat voor elk aangevraagd account een afzonderlijke installatie van BICS Lokaal moet worden uitgevoerd.

2. BICS-software downloaden

Download hier de nieuwste versie van BICS Lokaal.

3. De BICS-installer openen via de Opdrachtprompt

Voordat u BICS Lokaal in de testmodus kunt installeren, dient u een extra stap uit te voeren. Om te beginnen moet u –DTEST=true aan de opdrachtregel toevoegen in de Opdrachtprompt. Volg hiervoor deze stappen:

  1. Open de Opdrachtprompt (ga naar het Startmenu, typ "cmd" en druk op enter).
  2. Voer de locatie van het gedownloade BICS-installatiebestand in, voeg daarachter een spatie toe en voeg daarna de tekst "-DTEST=true" toe, bijvoorbeeld: Downloads\BICS2-Install-6.2.0.20261102.exe -DTEST=true
  3. Druk vervolgens op enter.

De onderstaande afbeelding toont hoe de tekst in de Opdrachtprompt er uit zou moeten zien.
Nadat u op enter hebt gedrukt, kunt u beginnen met de installatie van BICS.

Loop vervolgens de stappen in de BICS-installer door en rond de installatie van BICS af.

4. BICS Lokaal openen en configureren

Zorg er eerst voor dat u alle gegevens van de aangevraagde testaccounts uit stap 1 bij de hand heeft.

Nadat de installatie van BICS Lokaal in testmodus is voltooid, kunt u de BICS-software opstarten met de snelkoppeling die op uw bureaublad is geplaatst. Als deze snelkoppeling ontbreekt, kunt u BICS Lokaal ook opstarten door http://localhost:80 te openen in uw browser.

  1. Wanneer BICS Lokaal is geopend, kunt u inloggen met de standaard inloggegevens: Gebruikersnaam bics2 en Wachtwoord bics2.
  2. U wordt vervolgens middels de “Wizard Eerste Gebruik” in 5 stappen begeleid bij het configureren van BICS Lokaal op uw computer.
    • Stap 1: Wachten op gegevens: BICS downloadt de nieuwste referentiedata. Deze stap voltooit zich automatisch.
    • Stap 2: Demo-modus: Kies of u BICS in demo modus wilt installeren. Voor testdoeleinden kiest u hier 'Nee'.
    • Stap 3: Importeren: Kies of u een back-up wilt importeren. Kies voor 'Overslaan' als u geen back-up wilt gebruiken.
    • Stap 4: Berichtendienstinstellingen: Klik op de knop 'Inloggen' en log in met uw Rijkswaterstaat scheepvaart testaccount. De benodigde gegevens van uw testaccount zijn na goedkeuring van uw aanvraag per mail toegestuurd:
      • Vul uw gebruikersnaam of uw e-mailadres en het wachtwoord van uw Rijkswaterstaat scheepvaart testaccount in en klik nogmaals op 'Inloggen'.
      • Selecteer vervolgens het juiste test-meld-ID uit de lijst en klik op 'Bevestigen'.
    • Stap 5: Adres afzender: Vul uw testadresgegevens in:
      • In het veld 'Organisatie / bedrijfsnaam' vult u de naam in van uw organisatie of bedrijf.
      • In het veld 'Identificatie' vult u een zelfgekozen 3-letterige code in, bijvoorbeeld uw initialen.
    • Stap 6: Casco's: Vul de gegevens van minstens Ă©Ă©n testschip in. Klik hiervoor op “+ Casco” en vul de gevraagde gegevens in.
  3. Klik vervolgens op “Afronden” om de Wizard Eerste Gebruik af te ronden. Uw BICS is nu gereed voor testdoeleinden.

Als u de installatie en configuratie succesvol uitgevoerd heeft, ziet u de onderstaande melding verschijnen in het hoofdscherm van BICS.

Een voorbeeld van de melding bij succesvolle installatie van BICS in testmodus

5. BICS Lokaal gebruiken

Na het succesvol doorlopen van alle voorgaande stappen, kunt u BICS Lokaal nu gebruiken om testreizen aan te melden. De aangemelde reizen komen terecht in de acceptatieomgeving (testomgeving), maar hun weergave is vergelijkbaar met reizen die in de productieomgeving worden gemeld. Via het informatiemenu in BICS heeft u toegang tot verschillende logbestanden, zoals het Communicatielog, Systeemlog en Updatelog.

Let op: BICS Lokaal maakt in testmodus gebruik van andere referentiedata dan die in de productieomgeving gebruikt wordt. Hierdoor kan het voorkomen dat u bijvoorbeeld in de testmodus andere locaties tegenkomt dan in de normale modus.

Voor eventuele vragen met betrekking tot de testmodus van BICS Lokaal kunt u contact opnemen via bics@rws.nl.