Version vom 5. Oktober 2018, 15:20 Uhr

Installationsbeschreibung Smartphone Apps

Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme der ALEX Dienstplan/Personal Cockpit App. Für die Stundennachweis/Zeiterfassung App bitte hier weiterlesen.

Alex Konfiguration anpassen

Folgende DLL's müssen in der Konfiguration des ALEX-Dienstes eingetragen sein.

//- Für Dienstplan App keine Änderung notwendig

//- Für Personal Cockpit
"modelPlugins" :
{ "0" : "Bfx.Alex.SmartTimeSheet.Model.dll"
},
"serverDaemonPlugins" :
{ "0" : "Bfx.Alex.SmartTimeSheet.Model.dll"
}

Kommunikation ALEX Dienst / ALEX App

Web-Kunden

Für Web-Kunden sind hier keine weiteren Tätigkeiten notwendig, die Smartphones benötigen nur eine Internet-Verbindung. Die Anmeldung erfolgt mit dem Kundenkürzel(z.B.: "at.sr.kunde") und dem jeweiligen Benutzer

Kunden mit eigenem Server

Wenn der ALEX-Dienst auf einem eigenen Server betrieben wird, muss die Kommunikation zwischen ALEX Dienst und ALEX App ermöglicht werden.

Die ALEX-Apps verwenden eine TCP-Verbindung für die Kommunikation.
Im App-Login muss einmalig der Domainname(z.B.: alex.beispiel.at) eingetragen werden.
- kann auch statische IP sein(nicht empfohlen, schwer zu merken)
- der Port ist 4400, wenn der "Model Server Port" geändert wurde muss er beim App-Login miteingegeben werden - z.B.: alex.beispiel.at:5000
Die Verschlüsselung der Kommunikation ist möglich siehe Konfiguration / "certificate"
Für die Personal Cockpit App ist die Kommunikation des ALEX Servers mit der Amazon Web Services Cloud notwendig.
- Diese Kommunikation mit AWS kann über einen Proxy erfolgen, dieser muss in ALEX unter "Systemeinstellungen -> AWS Einstellungen" eingerichtet werden.

Beispiel Einrichtung Dienstplan + Personal Cockpit

Ausgangssituation

Ein ALEX Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben.

Der Domainname "alex.beispiel.at" ist vorhanden und zeigt auf die externe IP des Routers(oder Firewall).

Der eingestellte "modelServer->port" wurde nicht geändert in der Konfiguration.

Der Server hat bereits direkten Zugriff zur AWS-Cloud.

Notwendige Anpassungen

Im Router muss ein Portforward für den TCP-Port 4400 von extern zum ALEX Server "192.168.123.123" eingerichtet werden.

Anmeldung mit der App

Für Kunde muss beim App-Login dann "alex.beispiel.at" eingegeben werden. Benutzer und Password sind wie im ALEX Dienstplan voreingestellt einzugeben.

@@ Zeile 2: / Zeile 2: @@
-Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme der ALEX Apps.
+Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme der ALEX Dienstplan/Personal Cockpit App.
+Für die Stundennachweis/Zeiterfassung App bitte [[ALEX_App_Installation_Archiv|hier weiterlesen.]]
 = Alex Konfiguration anpassen =
+Folgende DLL's müssen in der [[ALEX-Config-File|Konfiguration]] des ALEX-Dienstes eingetragen sein.
+ //- Für Dienstplan App keine Änderung notwendig
-Folgende DLL's müssen in der Konfiguration des ALEX-Dienstes eingetragen sein.
+  //- Für Personal Cockpit
-  //- Für jede App
   "modelPlugins" :
-  { "0" : "Bfx.Alex.EmployeeEmailAddress.Model.dll"
+  { "0" : "Bfx.Alex.SmartTimeSheet.Model.dll"
- },
- "architectureuiPlugins" :
- { "0": "Bfx.Alex.Mobile.UI.Architecture.dll"
- },
- "httpServicePlugins" :
- { "0" : "Bfx.Alex.EmployeeCardID.Model.dll"
- , "1" : "Bfx.Alex.Model.dll"
   },
   "serverDaemonPlugins" :
-  { "0" : "Bfx.HTTP.Server.dll"
+  { "0" : "Bfx.Alex.SmartTimeSheet.Model.dll"
   }
- //- Für Zeiterfassung zusätzlich benötigt
- "httpServicePlugins" :
- { "0" : "Bfx.Alex.AttendanceRecorder.Interface.Model.dll"
- , "1" : "Bfx.Alex.AttendanceRecorder.Model.dll"
- }
 = Kommunikation ALEX Dienst / ALEX App =
@@ Zeile 34: / Zeile 25: @@
 Für Web-Kunden sind hier keine weiteren Tätigkeiten notwendig, die Smartphones benötigen nur eine Internet-Verbindung.
-Die TCP-Verbindung zu [[#Server Adresse|Host]] und [[#Server HTTP-Port|Port]], wie in der [[#Verbindungseinstellung|Verbindungseinstellung]] vorgegeben, muss erlaubt sein.
+Die Anmeldung erfolgt mit dem Kundenkürzel(z.B.: "at.sr.kunde") und dem jeweiligen Benutzer
 == Kunden mit eigenem Server ==
@@ Zeile 40: / Zeile 31: @@
 Wenn der ALEX-Dienst auf einem eigenen Server betrieben wird, muss die Kommunikation zwischen ALEX Dienst und ALEX App ermöglicht werden.
 * Die ALEX-Apps verwenden eine TCP-Verbindung für die Kommunikation.
-* Die Verbindung zum ALEX-Dienst wird für die ALEX-Apps in den [[#Verbindungseinstellung|Systemeinstellungen->"Mobile Apps"]] eingestellt.
+* Im App-Login muss einmalig der Domainname(z.B.: alex.beispiel.at) eingetragen werden.
-* Die [[#Server Adresse|"Server Adresse"]] ist die IP-Adresse (oder der Hostname), den die App's für die Verbindung verwenden sollen, die Voreinstellung dafür ist der "modelServer/host" Eintrag in der [[ALEX-Config-File|Konfiguration des ALEX-Dienstes ("Config-Datei")]].
+** kann auch statische IP sein(nicht empfohlen, schwer zu merken)
-* Der [[#Server HTTP-Port|"Server HTTP-Port"]] ist der Ziel-Port, den die App's für die Verbindung verwenden sollen, die Voreinstellung dafür ist der "httpServer/port" Eintrag (ohne Eintrag: "4480") in der [[ALEX-Config-File|Konfiguration des ALEX-Dienstes ("Config-Datei")]].
+** der Port ist 4400, wenn der [[ALEX-Ports#Ports_im_ALEX-Config-File|"Model Server Port"]] geändert wurde muss er beim App-Login miteingegeben werden - z.B.: alex.beispiel.at:5000
+* Die Verschlüsselung der Kommunikation ist möglich siehe [[ALEX-Config-File|Konfiguration / "certificate"]]
+* Für die Personal Cockpit App ist die Kommunikation des ALEX Servers mit der Amazon Web Services Cloud notwendig.
-<div align="center" style="border:1px solid black; margin:5px 5px 5px 5px; padding:5 5px 5px 5px; background-color:#F3F781">
+** Diese Kommunikation mit AWS kann über einen Proxy erfolgen, dieser muss in ALEX unter "Systemeinstellungen -> AWS Einstellungen" eingerichtet werden.
-Nach einer Änderung dieser Einstellungen muss die App-Konfiguration erneut an das Personal verschickt werden!
-</div>
-<div align="center" style="border:1px solid black; margin:5px 5px 5px 5px; padding:5 5px 5px 5px; background-color:#F3F781">
-Diese Verbindungseinstellungen wirken sich auch auf die Verbindung der iCal-Kalender aus!
-</div>
-[[Datei:ALEX App Installation Szenario1.png|thumb|rechts|Schema Beispiel 1]]
-=== Beispiel 1 - Verbindung über Kunden-WLAN ===
-Die Apps kommunizieren nur über WLAN beim Kunden.
-Die Kommunikation über Internet ist nicht möglich, die Verwendung der Apps außerhalb des WLAN ist nur [[ALEX_App_Betrieb_ohne_Verbindung|eingeschränkt]] möglich.
-In diesem Fall muss die Verbindung in Alex nicht geändert werden, die Voreinstellung ist ausreichend.
-[[Datei:ALEX App Installation Szenario2.png|thumb|rechts|Schema Beispiel 2]]
-=== Beispiel 2 - Verbindung nur über Internet ===
-Die Apps kommunizieren immer über das Internet.
-Die Verwendung der Apps ist uneingeschränkt möglich solange eine Internetverbindung besteht.
-In diesem Fall muss das [[ALEX-Config-File|Config-File]] entsprechend angepasst werden:
-  "modelServer" :
-  { "host" : "192.168.123.123"
-  ,"dnsName": "NAME.DES.SERVERS"
-  , "port" : "4400"
-  }
-  , "httpServer" :
-  { "port" : "4480"
-  }
-  '''Interner Hinweis:''' Darf für Web-Kunden '''NICHT''' angepasst werden.
-Unter modelServer wird bei host die statische IP des Servers eingetragen, wo Alex installiert ist.
-Unter modelServer muss bei dnsName der "Server Name" eingetragen werden, wie der Alex-Server von außen erreichbar ist. (zB alex.Kundenname.at)
-Der unter modelServer eingetragene [[ALEX-Ports|port]] muss in der Firewall an den ALEX Server weitergeleitet werden, falls die Dienstplan-App verwendet wird.
-Der unter httpServer eingetragene [[ALEX-Ports|"Server HTTP-Port"]] muss in der Firewall an den ALEX Server weitergeleitet werden, falls die [[Timesheet_und_Timestamp|Apps ALEX®-Stundennachweis oder ALEX®-Zeiterfassung]] verwendet werden.
-= DATENSCHUTZ: Jedem Dienstnehmer nur seine eigenen Daten zur Verfügung stellen =
-# Eine persönliche E-Mail-Adresse wird in den Personalstammdaten für jeden Mitarbeiter angelegt.
-# Dann wird für jeden Dienstnehmer ein eigener Code generiert und auf seine persönliche E-Mailadresse geschickt. Dieser Code ist eindeutig und mit einem sog. "checksum"-Algorithmus gesichert.
-Somit ist gewährleistet, dass jeder Dienstnehmer nur seine eigenen Daten auf dem Smartphone abrufen kann.
-= ALEX App Konfiguration an Personal versenden =
-Die Konfiguration für die ALEX Apps wird per E-Mail aus dem Dienstplan an das Personal verschickt.
-Die E-Mail Adresse für das Personal wird am Personal in "Allgemein->E-Mail Adresse" eingetragen.
-'''Achtung''': Es muss ausserdem eine Kartennummer (Personalnummer) beim Mitarbeiter hinterlegt sein, sonst können die Stempelungen nicht zugeordnet werden.
-<div align="center" style="border:1px solid black; margin:5px 5px 5px 5px; padding:5 5px 5px 5px; background-color:#F3F781">
-Nicht Web-Kunden müssen einen Postausgangs-Server konfigurieren([[Alex Konfiguration Postausgangsserver]]) damit der E-Mail Versand möglich ist.
-</div>
-Um die Konfiguration an das Personal zu senden gibt es die folgenden Möglichkeiten:
+=== Beispiel Einrichtung Dienstplan + Personal Cockpit ===
+==== Ausgangssituation ====
-* Versenden an einzelnes Personal: Kontext-Menü des Personals -> "App-Konfiguration als E-Mail versenden"
+Ein ALEX Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben.
-* Versenden an gesamtes Personal von Planungseinheit: Kontext-Menü der Planungseinheit -> "App-Konfiguration als E-Mail versenden"
-* Versenden an gewähltes Personal: Personal Suche öffnen -> Personal markieren -> Kontext-Menü öffnen -> "App-Konfiguration als E-Mail versenden"
-* Versenden an gewählte Planungseinheiten: Planungseinheit Suche öffnen -> Planungseinheiten markieren -> Kontext-Menü öffnen -> "App-Konfiguration als E-Mail versenden"
+Der Domainname "alex.beispiel.at" ist vorhanden und zeigt auf die externe IP des Routers(oder Firewall).
-[[Datei:ALEX App Konfiguration Email.PNG|thumb|rechts|Konfigurations E-Mail mit Anhang]]
+Der eingestellte "modelServer->port" wurde nicht geändert in der [[ALEX-Config-File|Konfiguration]].
-[[Datei:ALEX App Konfiguration Webpage.PNG|thumb|rechts|Seite mit Konfiguration-Links]]
-= ALEX App Installation auf Smartphone =
+Der Server hat bereits direkten Zugriff zur AWS-Cloud.
-# Gewünschte App von [[ALEX_App_Download|App-Store]] installieren
+==== Notwendige Anpassungen ====
-# Konfigurations-E-Mail öffnen
-# Website in Anhang mit Browser öffnen
-# Gewünschten Konfigurationslink wählen
-Die App öffnet sich und ist fertig konfiguriert
+Im Router muss ein Portforward für den TCP-Port 4400 von extern zum ALEX Server "192.168.123.123" eingerichtet werden.
+====  Anmeldung mit der App ====
-Link zu Handout/Inbetriebnahme der Apps:
+Für Kunde muss beim App-Login dann "alex.beispiel.at" eingegeben werden.
-[[Timesheet und Timestamp|Inbetriebnahme Apps]]
+Benutzer und Password sind wie im ALEX Dienstplan voreingestellt einzugeben.

ALEX App Installation: Unterschied zwischen den Versionen