Introductie

Welkom bij de B-logicx handleiding voor de Reactions- software

Dit programma biedt de mogelijkheid om acties van en naar de bus te sturen of te ontvangen.

Bij een bepaalde actie (bv openen van een poort) kan je een e-mail sturen.

Voor de communicatie met externe systemen (ERP,...)  kunnen we gebruik maken van eenvoudige tekstboodschappen.

Dit programma wordt meestal gebruikt in combinatie met de serversoftware.

Starten

- Systeemvereisten

- Installatie

- Gebruikers interface

- Verbinding

- Statusweergave

- Extra functies

Systeemvereisten

Vereist voor dit programma:

WindowsXP, Windows7 of Windows8 computer

Dit programma draait op de achtergrond.
Er wordt geen knop in de statusbalk weergegeven.

Het programma is te bereiken via de Tray (Rechtsonder)

Installatie

Het programma is te downloaden van de website www.B-logicx.be

Tijdens de installatie  wordt voorzien dat deze software automatisch start, bij het opstarten van de computer.

Na de eerste installatie, moet je dit programma via het installatieprogramma (of later manueel) opstarten.

Het programma vraagt onmiddellijk naar de locatie van de projectmap. Duid deze aan.

Bij een normale opstart, zal de gebruikersinterface zichtbaar zijn voor 4 seconden. Daarna verdwijnt het scherm op de achtergrond (zie gebruikersinterface)

Bestandslocaties

C:\BLSXE: programmamap

- BLSXEServerReactions.exe: programmabestand

- BLReactions.ini: configuratie bestand voor de instellingen

C:\BLSXE\Files\uwProjectMap\Serverdata: de projectmap

Gebruikers interface

Open het gebruikers scherm door in de tray op het programma icoon te klikken.

Je ziet dan volgend scherm:

1. Geef de code (1) in om een instelling te kunnen maken. De standaardcode is 1234. Zolang de code niet is ingegeven, kan je geen enkele aanpassing maken.

2. Als je de correcte code ingeeft, zie je dit bericht.

3. Maak een onderscheid in de berichten tussen:

- Berichten versturen

- Berichten ontvangen

4. Selecteer een bericht.

5. De e-mail gegevens  waar het bericht naar toe gestuurd moet worden
(Enkel zichtbaar bij 'berichten versturen'

6. Inhoud van het tekstbericht.
Geldt zowel bij 'bericht versturen' als bij 'bericht verzenden'

7. Weergave van de status van de verbinding.
Blauwe schermen: verbonden
Zwarte schermen: niet verbonden

8. Geef aan of automatisch moet geprobeerd worden om te verbinden (standaard aan)

9. Verstreken periode (in sec) sinds de laatste actie op de bus.

10. Busmonitor. Je ziet online de gegevens die over de bus lopen.

11. Het programma blijft in de achtergrond draaien, maar de gebruikersinterface wordt verbonden

12. Het helpbestand vind je steeds terug door op het icoon te klikken

Verbinding

Deze software wordt meestal gebruikt in combinatie met de B-Logicx Server Software.

Bij de installatie geef je dus het IP adres en de communicatiepoort van de server op.

(Als je niet over een de serversoftware beschikt, kan je ook steeds rechtstreeks verbinding maken met de netwerkmodule.)

In normale omstandigheden zal er continu een verbinding met de server zijn, waardoor alle gegevens die over de bus komen, gevolgd kunnen worden.

Bij het opstarten van de computer, bijgevolg dus ook het opstarten van deze software, zal de timer starten, en na de ingestelde tijd, automatisch de verbinding tot stand brengen.

Als de verbinding verbroken wordt door de server (voor onderhoud) of door de router, of door manipulatie van de kabels, wordt er uiteraard geen gegevens meer doorgegeven.

Mocht je enkel met een netwerkmodule communiceren, is het onmogelijk om vast te stellen wanneer een verbinding terug tot stand kan komen.

Daarom zorgt de server, op gezette tijden, zelf voor het herstel van de verbinding.

Alle fouten, voortvloeiend uit netwerkproblemen, worden door de software onderdrukt.

Statusweergave

Op het moment dat de software verbreekt, wordt volgende boodschap weergegeven.

Op het moment dat de software verbindt, wordt volgende boodschap weergegeven:

Afsluiten

Omdat het niet de bedoeling is om het programma af te sluiten, maken we dit omslachtiger dan gewoonlijk.

Je moet eerst een geldige code ingegeven hebben (bij het opstarten van de gebruikers interface).

Dan moet in in de tray, rechts klikken op het programma icoon om te kunnen afsluiten.

Als je geen geldige code ingegeven hebt, zal de software melden dat je onvoldoende rechten hebt om te kunnen afsluiten.

Als de software zichzelf moet afsluiten (bij het afsluiten van de computer) zal je dit bericht ook zien, maar het zal genegeerd worden;

Instellingen

Via het menu 'Bestand' kan je naar het 'Instellingen' scherm

Projectlocatie

Bij de eerste opstart wordt gevraagd waar de projectgegevens zich bevinden.

Indien nodig kan je ze hier aanpassen.

Netwerkverbinding

De verbinding met de bus moet hier ingegeven worden.

E-mail instellingen

1. E-Mail instellingen:

Maak een (bij voorkeur gmail) e-mail account aan.

Om te testen kan je onze gegevens gebruiken, maar eens je het programma echt aan het werk hebt, kan je best je eigen account voorzien.

Je kan eventueel ook via een andere provider werken, maar zorg dan zeker voor dezelfde instellingen als gebruikt door gmail.

Een gmail account is gratis en kan je aanmaken via www.gmail.com

2.Om je e-mail instellingen te testen kan je onderstaande velden en knop gebruiken.

Verzenden/Ontvangen

Deze software is bedoeld om de bus in het oog te houden en, afhankelijk van jouw wensen, te communiceren met derden.

Op deze manier maken we verbinding met oa ERP systemen,...

Het gegevens uitwisselen kunnen we in 2 richtingen:

Verzenden: versturen van een e-mail of tekstbestand bij een bepaalde actie op de bus

Ontvangen: een actie op de bus kan gestart worden bij het ontvangen van een bepaald tekstcommando.

Verzenden

- e-mail

- één of meerdere ontvangers aanduiden.

- een onderwerp geven (200 karakters)

- een boodschap geven (200 karakters)

- tekstbestanden

- een tekstbestand zal aangemaakt worden. Je kan er 200 karakters in kwijt

- het bestand wordt in de projectmap gezet, in de map 'OutMsg'

- het bestand heet OutMsg, gevolgd door het uur, dan minuten, dan seconden

- het verwijderen van de bestanden gebeurt niet automatisch

Ontvangen

Logging

Weergave

Gebeurtenissen worden weergegeven in de 'Events'-lijst.

In onderstaand voorbeeld zie je wanneer

- het programma is opgestart.

- de verbinding tot stand is gekomen

- een verzonden e-mail, veroorzaakt door 'Set 2.1'

- een verzonden tekstbericht, veroorzaakt door 'Set 2.1'

- een ontvangen bericht, waardoor actie 'Toggle 2.4' op de bus is gezet.

Knoppen

EraseList:

Maakt de lijst leeg. Een event wordt hiervoor aangemaakt.

Refresh:

Terwijl het 'Events' scherm open staat, worden de events niet automatisch bijgeschreven.

Als er ondertussen een nieuw event bijkomt, kan het het ophalen met deze knop

SaveList:

De lijst manueel opslaan.

De bestandsnaam kan je onderaan het scherm zien.

Opslaan.

De Events lijst wordt elke dag automatisch opgeslagen en vernieuwd.

Er wordt telkens een tekst bestand aangemaakt met de datum in de naam. (YYYYMMDD).

Alle bestanden worden automatisch in de projectmap gezet, in de map die 'ServerData' heet.

Als die nog niet bestond, wordt deze automatisch aangemaakt.

Deze locatie is niet aanpasbaar.

Glossary

Verklarende woordenlijst voor specifieke benamingen

WOL: Wake-on-Lan: het inschakelen van computers over het netwerk.

Table of Contents

Introductie

Starten

Systeemvereisten

Installatie

Bestandslocaties

Gebruikers interface

Verbinding

Statusweergave

Afsluiten

Instellingen

Projectlocatie

Netwerkverbinding

E-mail instellingen

Verzenden/Ontvangen

Verzenden

Ontvangen

Logging

Glossary