Um die Kommunikation zwischen VenDoc und ALEX und robust abzuhandeln, werden klare organisatorische Abläufe und funktionelle Zuständigkeiten festgelegt. Darauf aufbauend ist die die technische Umsetzung beschrieben.
Organisationskonzept
Stammdatenverwaltung
Personaldatenpflege
Die systemübergreifende Identifikation der Personalstammdaten erfolgt über eine von ALEX vergebene eindeutige Nummer. Das Personal wird in ALEX angelegt.
VenDoc holt sich die verwendbaren Eigenschaften (Vor- Zuname, Geb. Datum, Ein/Austritt...) von ALEX.
Es wird immer der gesamte Personalstamm zurück gegeben.
Kunden, Aufträge, Tätigkeiten, Material und Lohnarten
Diese Daten werden an ALEX übergeben, und hier nur lesend verwendet.
Die Übergabe der Daten erfolgt inkrementell: nur die Änderungen seit der letztmaligem Übergabe sind in der Schnittstelle vorhanden. Zur Sicherstellung der Konsistenz verwenden wir ein vereinfachtes 'two phase commit' Protokoll: Die Übergabe wird von VenDoc angestoßen und läuft wie folgt ab:
- Abfrage 'Zeitpunkt der Änderungsmenge' letzter erfolgreicher Import von ALEX -> Zeitpunkt (Beim ersten Mal 1.1.1 0:0 )
- VenDoc erzeugt Änderungsmenge
- Vendoc übergibt Änderungsmenge mit 'Zeitpunkt der Änderungsmenge' an Alex
Die Übergabe kann automatisch (periodisch,getriggert) implementiert werden.
In ALEX werden keine Daten gelöscht, sondern nur auf 'Abgelaufen' gesetzt.
Verrechnung der erfassten Zeiten
In ALEX gibt es verschiedene Möglichkeiten, Arbeitszeiten eines Mitarbeiters auf Aufträge und Tätigkeiten zuzuordnen:
- An/Abmeldung über Stempeluhr
- Buchung über App
- Manuelle Erfassung/Nachbearbeitung durch
- Selbstbedienung
- Verantwortlichen
Diese Daten sind in ALEX vom Verantwortlichen zu überprüfen. Dabei helfen ihm Werkzeuge wie Standeskontrolle und Besetzungs-Report. Ist die Datenlage geprüft und für richtig befunden, ist der Tag für die Zeiterfassung in ALEX abzuschließen (siehe Supervisorenschulung_WEB). Nur Tage, die so markiert wurden, sind in der Schnittstelle sichtbar und können daher in VenDoc importiert und dort weiter verarbeitet werden. Zum Beispiel:
- manuelle Änderung des Stundensatzes
- Verrechnung
Daher darf VenDoc die Zeitstempel von ALEX nicht ohne vorherige Stornierung dieser Änderungen mehrfach importieren.
Materialbuchungen
Die Materialbuchungen werden in ALEX nur erfasst und nicht geändert. Korrekturen werden sind als Minus in einer neuen Buchungen mit neuem Zeitstempel zu erfassen. Materialbuchungen können jederzeit von VenDoc für einen beliebigen Zeitraum abgefragt werden.
Infobuchungen
Die Infobuchungen werden in ALEX nur erfasst und nicht geändert. Sie können jederzeit von VenDoc für einen beliebigen Zeitraum abgefragt werden.
Technische Beschreibung
Allgemeines
Je ALEX Installation steht ein Webservice zur Verfügung.
Der Port des Webservice ist via - https://k5.alexweb.io/CustomerPort ersichtlich.
Kommunikation erfolgt über HTTP Protokoll. An Alex via "POST", von ALEX via "GET".
Die Daten selbst werden in JSON dargestellt.
Allgemeine Stammdaten von VenDoc an ALEX
- Auftrag (in ALEX -> 'Kundenplan')
- VenDoc Primärschlüssel
- Kunde * VenDoc Primärschlüssel
- Betreff
- Status (0 = Offen, 2 = Erledigt)
- Belegnummer
- Mitarbeiter Zuordnung (ALEX Primärschlüssel)
- Tätigkeiten (in ALEX -> Farbmarkierung)
- VenDoc Primärschlüssel
- Code
- Name
- Material (in ALEX 'Material')
- VenDoc Primärschlüssel
- Artikelnummer
- Bezeichnung
- Einheit
- EAN Nummer
- Warengruppe (VenDoc Primärschlüssel)
- Lager (in ALEX 'Lager')
- VenDoc Primärschlüssel
- Code
- Name
- Warengruppe (in ALEX 'Warengruppe')
- VenDoc Primärschlüssel
- Code
- Name
- Kunde (in ALEX 'Kundenstamm')
- VenDoc Primärschlüssel
- Firmenname
- Inaktiv
- Lohnart (In Alex 'VenDoc Lohnart', kann auf Planungscode zugeordnet werden)
- VenDoc Primärschlüssel
- Code
- Name
Ergebnisse von ALEX an VenDoc
Angestoßen von VenDoc, optional nur kontrollierte! Ab letzte Aänderung in ALEX oder Abfragezeitpunkt
- Zeitbuchungen
- Personal (ALEX Primärschlüssel)
- Beginn
- Ende
- Auftrag (VenDoc Primärschlüssel)
- Tätigkeit (VenDoc Primärschlüssel)
- Lohnart (VenDoc Primärschlüssel)
- Text
- Material/Gerätebuchungen
- ALEX Primärschlüssel der Buchung
- Personal (VenDoc Primärschlüssel)
- Zeitpunkt
- Auftrag (VenDoc Primärschlüssel)
- Menge
- Artikel (VenDoc Primärschlüssel)
- Lager (VenDoc Primärschlüssel)
- Text
- Infobuchungen
- ALEX Primärschlüssel der Buchung
- Personal (VenDoc Primärschlüssel)
- Datum
- Auftrag (VenDoc Primärschlüssel)
- Titel
- Text
- Bild
Personalstammdaten von ALEX an VenDoc
- Personal
- Personalnummer
- Vorname / Nachname
- Geburtstag
- Eintritt / Austritt
- Anschrift
- Alex Primärschlüssel
Konfikuration (*.bfx_CONFIG)
, "modelPlugins" :
{
....
,"n" : "Bfx.Alex.Logistics.Interface.Model.dll"
....
}
