Inhaltsverzeichnis

Frequenzzähler-Einstellungen

Frequenzzähler-Einstellungen

Die Konfiguration der einzelnen Frequenzzähler erfolgt in der Datei MaxProFrequenzzaehler.conf des Programms. In den folgenden Beispielen sehen Sie jeweils nur einen Ausschnitt der Datei, ein vollständiges Beispiel befindet sich bei der Installation oder bei der allgemeines Beschreibung des Programms Frequenzzähler-Import.

WICHTIG! Wenn Sie in den Import-Schnittstelle eine Datei oder ein Verzeichnis angeben, das auf einem anderen Server liegt, sollten Sie hier immer mit UNC-Pfaden arbeiten und nicht mit Laufwerksbuchstaben! Während des automatischen Datenimports über Nacht sind diese Laufwerksbuchstaben in der Regel nicht verbunden, wenn niemand am Server angemeldet ist!

Allgemeines

Grundsätzlich ist das Format der Einträge immer weitgehend ähnlich, wie hier im Beispiel zu sehen.

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Kopier-Vorlage für Jobs</Beschreibung>
    <Typ>Unbekannt</Typ>
    <ImportDatei></ImportDatei>
    <ImportVerzeichnis></ImportVerzeichnis>
    <ImportUrl></ImportUrl>
    <ZaehlerName></ZaehlerName>
    <KameraName></KameraName>
    <DetektorName></DetektorName>
    <CompanyID></CompanyID>
    <StoreID></StoreID>
    <ZaehlerNummer>0</ZaehlerNummer>
    <NetzwerkMount></NetzwerkMount>
    <NetzwerkUsername></NetzwerkUsername>
    <NetzwerkPassword></NetzwerkPassword>
    <ZuordnungFiliale></ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Allgemein gültig für jeden Zähler (egal welchen Typs) sind die Werte:

Aktiv: Hiermit kann mittels true oder false ein Frequenzzähler aktiviert oder abgeschaltet werden, ohne diese Einstellung aus der Config-Datei löschen zu müssen. Ist also ein Zähler temporär nicht erreichbar (etwa wegen Umbau-Maßnahmen), so können Sie den Import hier abschalten um Fehlermeldungen im Logfile zu verhindern.
Beschreibung: Die Beschreibung ist einfach nur ein kurzer Name oder Hinweistext für Sie, damit Sie auch später noch wissen, um welchen Frequenzzähler es sich handelt.
Typ: Der Typ des Frequenzzählers, siehe die folgenden Kapitel.
NetzwerkMount: (optional) Angabe des UNC-Pfades, der vor dem Import gemountet/verbunden werden soll
NetzwerkUsername: (optional) Benutzername für den Zugriff auf die Datei
NetzwerkPassword: (optional) Kennwort für den Zugriff auf die Datei
ZuordnungFiliale: Hier muss die Filial-Nummer stehen, unter der der Frequenzzähler in den ManageMax eingelesen werden soll. Die Angabe der Filial-Nummer muss exakt so erfolgen, wie diese auch im ManageMax hinterlegt ist, etwa als „01“ (bei SHD MHS) oder „N001“ (bei Ametras MOEVE).
KorrekturFaktor: Auf Wunsch ein Korrektur-Faktor, mit dem alle Frequenzzähler-Werte umgerechnet werden, um beispielsweise die Kundengruppen zu bilden oder Eingang/Ausgang herauszurechnen

Beckhoff Automation

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Beckhoff</Beschreibung>
    <Typ>Beckhoff</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>Gesamt</ZaehlerName>
    <ZuordnungFiliale>01</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Beckhoff“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: Name der zu importierenden Spalte

Brickstream 3D Gen 2

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Brickstream 3D Gen 2</Beschreibung>
    <Typ>Brickstream3DGen2</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <CompanyID>*</CompanyID>
    <StoreID>*</StoreID>
    <ZaehlerName>*</ZaehlerName>
    <KameraName>Haupteingang</KameraName>
    <DetektorName>*</DetektorName>
    <ZaehlerNummer>1</ZaehlerNummer>
    <ZuordnungFiliale>01</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Brickstream3DGen2“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
CompanyID: Division-ID aus den IP-Settings des Zählers
StoreID: Site ID aus den IP-Settings des Zählers
ZaehlerName: Door ID (Zonen externe ID)
KameraName: Door Description (Zonenname)
DetektorName: IP-Adresse des Zählers
ZaehlerNummer: Die Zählernummer gibt die Richtung an, der Wert „1“ entspricht der Eingangsrichtung, „2“ der Ausgangsrichtung

Zur besseren Zuordnung, ein Beispieldatensatz aus der CSV-Datei des Frequenzzählers:

25|02|0002||Eingang-02-Haupthaus|2|07/30/2020 13:00:00|2|1|55|103|192.168.3.235|

Hierbei entspricht:

25 = Event Type, immer „25“
02 = Division ID (aus den Einstellungen der Box)
0002 = Store ID (aus den Einstellungen der Box)
(leer) = Door ID (aus den Einstellungen der Box)
Eingang-02-Haupthaus = Door Description (aus den Einstellungen der Box)
2 = Door Type, immer „2“
07/30/2020 13:00:00 = Datum und Uhrzeit
2 = Eingangszähler
1 = Ausgangszähler
55 = Eingangszähler (kumuliert)
103 = Ausgangszähler (kumuliert)
192.168.3.235 = IP-Adresse der Box

CEM Zähler

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>CEM Zähler</Beschreibung>
    <Typ>CemZaehler</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>Gesamt</ZaehlerName>
    <ZuordnungFiliale>01</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „CemZaehler“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: Name der zu importierenden Spalte

Cognimatics TrueView People Counter

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Cognimatics</Beschreibung>
    <Typ>Cognimatics</Typ>
    <ImportUrl>http://192.168.10.25/local/people-counter/.api?export-csv&date=all&res=15m</ImportUrl>
    <ZaehlerName>EINGANG</ZaehlerName>
    <KameraName>Eingang</KameraName>
    <NetzwerkUsername>admin</NetzwerkUsername>
    <NetzwerkPassword>password</NetzwerkPassword>
    <ZuordnungFiliale>02</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Cognimatics“ sein
ImportUrl: Die URL zum Datenabruf, etwa http://192.168.10.25/local/people-counter/.api?export-csv&date=all&res=15m
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung
KameraName: Der Name der Kamera, wie in der Weboberfläche zu sehen
NetzwerkUsername: Benutzername für die Weboberfläche
NetzwerkPassword: Kennwort für die Weboberfläche

crosscan GmbH

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Crosscan</Beschreibung>
    <Typ>Crosscan</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>EINGANG</ZaehlerName>
    <KameraName>1</KameraName>
    <CompanyID>011</CompanyID>
    <StoreID>0000</StoreID>
    <ZuordnungFiliale>03</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Crosscan“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: Der Name des Zählers, wie in der Datei angegeben
KameraName: Die Nummer der Kamera (Spalte 3 der CSV-Datei)
CompanyID: Die Firmen-Nummer (Spalte 1 der CSV-Datei)
StoreID: Die Filial-Nummer (Spalte 2 der CSV-Datei)

EAS Zähldaten

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>EAS-Zaehldaten</Beschreibung>
    <Typ>EasZaehldaten</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>1</ZaehlerName>
    <ZaehlerNummer>1</ZaehlerNummer>
    <ZuordnungFiliale>04</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „EasZaehldaten“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: Der Name des Zählers (Spalte 1 der CSV-Datei)
ZaehlerNummer: Die Nummer des Zählers (Spalte 2 der CSV-Datei)

Krüger Alarmsysteme

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Krueger</Beschreibung>
    <Typ>Krueger</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>A</ZaehlerName>
    <ZuordnungFiliale>05</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Krueger“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: Der Name des Zählers, „A“, „B“, „C“ oder „D“

LASE PeCo PeopleCounter

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>LasePeCo</Beschreibung>
    <Typ>LasePeCo</Typ>
    <ImportDatei>C:\PeCo_local\PeCo_Data\PeCo_local_V20.mdb</ImportDatei>
    <ZaehlerName>EINGANG</ZaehlerName>
    <DetektorName>Küchencenter</DetektorName>
    <ZuordnungFiliale>05</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „LasePeCo“ sein
ImportDatei: Der Pfad und Dateiname der „PeCo_local_V20.mdb“ Datenbankdatei des Zählers
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung
DetektorName: Der Name des Zählers in der PeCo-Software

LevelOne IP CamSecure

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>LevelOneIpCamSecure</Beschreibung>
    <Typ>LevelOneIpCamSecure</Typ>
    <ImportDatei>e:\temp\EventLog.db</ImportDatei>
    <ZaehlerName>EINGANG</ZaehlerName>
    <ZaehlerNummer>10000</ZaehlerNummer>
    <ZuordnungFiliale>06</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „LevelOneIpCamSecure“ sein
ImportDatei: Der Pfad und Dateiname der „EventLog.db“ Datenbankdatei des Zählers
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung
ZaehlerNummer: Die ID-Nummer des Zählers (i.d.R. ab 10.000 aufwärts)

Nedap Retail

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>NedapRetail</Beschreibung>
    <Typ>NedapRetail</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>EINGANG</ZaehlerName>
    <KameraName>Ausgang</KameraName>
    <ZuordnungFiliale>07</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „NedapRetail“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung
KameraName: Der Name der Kamera

Publicount

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Publicount</Beschreibung>
    <Typ>Publicount</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>Haupteingang Möbelhaus</ZaehlerName>
    <ZuordnungFiliale>08</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Publicount“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die XLS-Dateien liegen
ZaehlerName: Der Name des Zählers, wie in der Spalte 1 der Datei angegeben

Visapix

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Visapix</Beschreibung>
    <Typ>Visapix</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>EINGANG</ZaehlerName>
    <KameraName>AXIS:10</KameraName>
    <DetektorName>AXIS_IN</DetektorName>
    <ZuordnungFiliale>11</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Visapix“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die CSV-Dateien liegen
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung
KameraName: Der Name der Kamera, wie in Zeile 1 der Datei angegeben
DetektorName: Der Name des Detektors, wie in Zeile 2 der Datei angegeben

Scanmarketing WinLog

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Winlog</Beschreibung>
    <Typ>Winlog</Typ>
    <ImportDatei>e:\temp\H_GEH.015</ImportDatei>
    <ZuordnungFiliale>10</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Winlog“ sein
ImportDatei: Der Name und Pfad der Importdatei

Scanmarketing W&T DataLogger

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>WuTDataLogger</Beschreibung>
    <Typ>WuTDataLogger</Typ>
    <ImportDatei>e:\temp\Frequenzzaehler.csv</ImportDatei>
    <ZaehlerNummer>1</ZaehlerNummer>
    <ZuordnungFiliale>12</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „WuTDataLogger“ sein
ImportDatei: Der Name und Pfad der Importdatei
ZaehlerNummer: Die Nummer des Input-Kontakts

Der W&T DataLogger erlaubt leider keinen Zugriff von außen auf die Datenbank der Zählerwerte. Allerdings kann der Zähler die Werte an einen FTP-Server übermitteln und so auf einem Netzwerklaufwerk zur Verfügung stellen.

Hinweis: Der W&T DataLogger stellt keinen FTP-Server zur Verfügung, sondern lediglich einen FTP-Client. Man kann also auch via FTP nicht von Außen auf das Gerät zugreifen, man kann das Gerät nur anweisen, in regelmäßigen Abständen die Daten auf einen FTP-Server zu schicken.

Damit Sie diese Funktion nutzen können, benötigen Sie also einen geeigneten FTP-Server im Netzwerk. Falls bereits ein FTP-Server vorhanden ist, kann dieser natürlich gerne mitgenutzt werden. Alternativ können Sie einen eigenen FTP-Server einrichten:

Internet Information Server mit FTP Server installieren und einrichten (Windows Server 2003)

Internet Information Server mit FTP Server installieren und einrichten (Windows Server 2012)

Filezilla FTP Server installieren und einrichten

Sobald der FTP-Server läuft, kann der W&T DataLogger eingerichtet werden:

Datentransfer im W&T DataLogger einrichten

Scanmarketing W&T Motherbox 2 CB

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>WuTMotherbox2CB</Beschreibung>
    <Typ>WuTMotherbox2Cb</Typ>
    <ImportUrl>192.168.1.100</ImportUrl>
    <ZaehlerName>Grün</ZaehlerName>
    <ZuordnungFiliale>13</ZuordnungFiliale>
    <NetzwerkUsername>admin</NetzwerkUsername>
    <NetzwerkPassword>password</NetzwerkPassword>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „WuTMotherbox2Cb“ sein
ImportDatei: Die IP-Adresse der W&T Motherbox
ZaehlerName: Der Name des Zählers innerhalb der W&T Motherbox
NetzwerkUsername: Der Benutzername für die Weboberfläche (Groß-/Kleinschreibung beachten)
NetzwerkPassword: Das Kennwort für die Weboberfläche (Groß-/Kleinschreibung beachten)

Vitracom SiteView ECO

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>Siteview</Beschreibung>
    <Typ>Siteview</Typ>
    <ImportVerzeichnis>e:\temp\</ImportVerzeichnis>
    <ZaehlerName>EINGANG</ZaehlerName>
    <KameraName>cam0</KameraName>
    <ZuordnungFiliale>09</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „Siteview“ sein
ImportVerzeichnis: Das Verzeichnis, in dem die counter-Dateien liegen (hier das Verzeichnis, in dem die weiteren Unterverzeichnisse „cam0“, „cam1“, etc. existieren)
KameraName: Der Name der Kamera, also der Name des Unterverzeichnisses („cam0“, „cam1“, etc.)
ZaehlerName: „EINGANG“ oder „AUSGANG“ für die Zählrichtung

Frei definierbares CSV-Format

<ConfigData>
    <Aktiv>true</Aktiv>
    <Beschreibung>CSV Format</Beschreibung>
    <Typ>CsvFormat</Typ>
    <ImportDatei>e:\temp\import.csv</ImportDatei>
    <CsvFormat>trennzeichen=; | datumsformat=dd.MM.yyyy HH:mm | spalte-datum=1 | spalte-frequenzwert=2</CsvFormat>
    <ZaehlerName>EINGANG</ZaehlerName>
    <ZaehlerNummer>1</ZaehlerNummer>
    <KameraName></KameraName>
    <DetektorName></DetektorName>
    <ZuordnungFiliale>11</ZuordnungFiliale>
    <KorrekturFaktor>2.3</KorrekturFaktor>
</ConfigData>

Typ: muss „CsvFormat“ sein
ImportDatei oder ImportUrl: Die zu importierende Datei, oder alternativ auch eine URL, wo die Daten heruntergeladen werden sollen
CsvFormat: (siehe unten)
ZaehlerName: Der Name des Zählers, oder „*“ für alle
ZaehlerNummer: Die Nummer des Zählers, oder „0“ für alle
KameraName: Der Name der Kamera, oder „*“ für alle
DetektorName: Der Name des Detektors, oder „*“ für alle

Da CSV-Dateien beliebig formatiert sein können, kann bzw. muss man im CsvFormat eine genauere Beschreibung der einzulesenden Datei definieren. Hierzu gibt es verschiedene benannte Parameter, die hier als getrennte Liste hinterlegt werden. Als Trennzeichen dient hier entweder das & (in der XML-Datei als & zu schreiben), oder das Zeichen |.

Wichtig: Auch bei Dateinamen und URLs müssen Sonderzeichen korrekt escapiert werden! Wenn in der URL oder Webadresse etwa ein kaufmännisches Und & vorkommt, muss dieses durch & ersetzt werden.

Ein falsch kodiertes Sonderzeichen wird im Logfile als XML-Fehler ausgegeben, beispielsweise:

2018-08-06 12:49:47,160 - FATAL - MaxProFrequenzzaehler.Program - Fehler beim Einlesen der Konfiguration
System.InvalidOperationException: Fehler im XML-Dokument (33,79). ---> System.Xml.XmlException: Beim Analysieren von 'EntityName' ist ein Fehler aufgetreten. Zeile 33, Position 79.

Definiert werden muss hier:

trennzeichen=; - das Trennzeichen für die Datei, also etwa „,“, „;“ oder die Kombination „\t“ für einen Tabulator
datumsformat=dd.MM.yyyy HH:mm:ss - Das Datumsformat in beliebiger Zusammensetzung, wobei gilt:
- dd = Tag
- MM = Monat
- yy oder yyyy = Jahr (zweistellig oder vierstellig)
- HH = Stunden
- mm = Minuten
- ss = Sekunden
- zum Beispiel: dd.MM.yyyy = Deutsches Datumsformat
- zum Beispiel: MM/dd/yyyy = Englisches Datumsformat
- nicht benutzte Werte (etwa die Sekunden) können auch weggelassen werden
spalte-datum=1 - In welcher Spalte steht das Datum?
- Wenn sich Datum und Uhrzeit auf mehrere Spalten verteilen, können diese hier mit „+“ angegeben werden, also etwa spalte-datum=1+2.
spalte-frequenzwert=2 - In welcher Spalte steht die Kundenfrequenz?

Ein Beispielformat würde damit also etwa lauten:

trennzeichen=; | datumsformat=dd.MM.yyyy HH:mm | spalte-datum=1 | spalte-frequenzwert=2

Hinweis: Die Leerzeichen können bei Bedarf beliebig weggelassen oder hinzugefügt werden zur besseren Übersichtlichkeit. Lediglich innerhalb des Datumsformats sind die Leerzeichen wichtig zu beachten!

Zusätzlich können auch noch optional folgende Parameter definiert werden:

spalte-zaehlername=3 - In welcher Spalte steht der Zählername? (nur wichtig, wenn danach auch im Import gefiltert werden soll)
spalte-zaehlernummer=4 - In welcher Spalte steht die Zählernummer? (nur wichtig, wenn danach auch im Import gefiltert werden soll)
spalte-kameraname=5 - In welcher Spalte steht der Kameraname? (nur wichtig, wenn danach auch im Import gefiltert werden soll)
spalte-detektorname=6 - In welcher Spalte steht der Detektorname? (nur wichtig, wenn danach auch im Import gefiltert werden soll)
kopfzeilen=1 - Wenn es in der Importdatei Kopfzeilen gibt, die übersprungen werden sollen, kann hier die Anzahl festgelegt werden
anfuehrungszeichen-entfernen=1 - Wenn die CSV-Datei einfache oder doppelte Anführungszeichen enthält, können diese entfernt werden, wenn diese Option auf „1“ oder „y“ (yes) gesetzt wird