Keine Bearbeitungszusammenfassung Markierung: 2017-Quelltext-Bearbeitung |
Keine Bearbeitungszusammenfassung |
||
Zeile 1: | Zeile 1: | ||
'''Installationsbeschreibung Smartphone Apps''' | '''Installationsbeschreibung Smartphone Apps''' | ||
Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme | Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme folgender Apps: | ||
* {{Alex}}[[Dienstplan APP|Dienstplan App]] | |||
* [[Personal_Cockpit|Personal Cockpit App]] <br /> | |||
Für die Stundennachweis- oder Zeiterfassungs-Apps bitte [[ALEX_App_Installation_Archiv|hier weiterlesen.]] Diese beiden Apps werden jedoch nicht mehr neu in Betrieb genommen. | Für die Stundennachweis- oder Zeiterfassungs-Apps bitte [[ALEX_App_Installation_Archiv|hier weiterlesen.]] Diese beiden Apps werden jedoch nicht mehr neu in Betrieb genommen. | ||
=Kommunikation {{Alex}} Dienst / {{Alex}} App= | |||
==Web-Kunden== | |||
== Web-Kunden == | |||
Für Web-Kunden sind hier keine weiteren Tätigkeiten notwendig, die Smartphones benötigen nur eine Internet-Verbindung. | 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. | Die Anmeldung erfolgt mit dem Kundenkürzel(z.B.: "at.sr.kunde") und dem jeweiligen Benutzer. | ||
Zeile 30: | Zeile 17: | ||
Der Benutzer muss als Selbstbedienungsbenutzer angelegt sein. | Der Benutzer muss als Selbstbedienungsbenutzer angelegt sein. | ||
== Kunden mit eigenem Server == | ==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. | Wenn der {{Alex}}-Dienst auf einem eigenen Server betrieben wird, muss die Kommunikation zwischen {{Alex}} Dienst und {{Alex}} App ermöglicht werden. | ||
=== Beispiel 1 - Direkte Verbindung === | *Die {{Alex}}-Apps verwenden eine TCP-Verbindung für die Kommunikation. | ||
==== Ausgangssituation ==== | *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 [[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"]] | |||
*Die {{Alex}}-Apps können über einen Reverse-Proxy betrieben werden(ab v2019.20) - für Einrichtung siehe Beispiel 2 | |||
*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 1 - Direkte Verbindung=== | |||
====Ausgangssituation==== | |||
Ein {{Alex}} Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben. | Ein {{Alex}} Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben. | ||
Zeile 51: | Zeile 39: | ||
Der Server hat bereits direkten Zugriff zur AWS-Cloud. | Der Server hat bereits direkten Zugriff zur AWS-Cloud. | ||
==== Notwendige Anpassungen ==== | ====Notwendige Anpassungen==== | ||
Im Router muss ein Portforward für den TCP-Port 4400 von extern zum {{Alex}} Server "192.168.123.123" eingerichtet werden. | 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. | Für Kunde muss beim App-Login dann "alex.beispiel.at" eingegeben werden. | ||
Benutzer und Passwort sind wie im {{Alex}} Dienstplan voreingestellt einzugeben. | Benutzer und Passwort sind wie im {{Alex}} Dienstplan voreingestellt einzugeben. | ||
=== Beispiel 2 - Reverse Proxy === | ===Beispiel 2 - Reverse Proxy=== | ||
==== Ausgangssituation ==== | ====Ausgangssituation==== | ||
Ein {{Alex}} Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben. | Ein {{Alex}} Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben. | ||
Der Domainname "proxy.beispiel.at" ist vorhanden und zeigt auf einen vorhanden Reverse-Proxy. | Der Domainname "proxy.beispiel.at" ist vorhanden und zeigt auf einen vorhanden Reverse-Proxy. | ||
Zeile 67: | Zeile 55: | ||
Der Server hat bereits direkten Zugriff zur AWS-Cloud. | Der Server hat bereits direkten Zugriff zur AWS-Cloud. | ||
==== Notwendige Anpassungen ==== | ====Notwendige Anpassungen==== | ||
Am Reverse-Proxy müssen alle Anfragen mit dem Pfad "/ModelServer" an den den TCP-Port 4400 des ALEX Servers "192.168.123.123" weitergeleitet werden. | Am Reverse-Proxy müssen alle Anfragen mit dem Pfad "/ModelServer" an den den TCP-Port 4400 des ALEX Servers "192.168.123.123" weitergeleitet werden. | ||
Die korrekte Weiterleitung kann im Browser über die Eingabe "http(s)://proxy.beispiel.at/ModelServer" getestet werden. | Die korrekte Weiterleitung kann im Browser über die Eingabe "http(s)://proxy.beispiel.at/ModelServer" getestet werden. | ||
Wenn die Weiterleitung korrekt funktioniert kommt die Antwort "ALEX Server OK" im Browser. | Wenn die Weiterleitung korrekt funktioniert kommt die Antwort "ALEX Server OK" im Browser. | ||
==== | ====Anmeldung mit der App==== | ||
Für Kunde muss beim App-Login dann "http(s)://proxy.beispiel.at" eingegeben werden. | Für Kunde muss beim App-Login dann "http(s)://proxy.beispiel.at" eingegeben werden. | ||
Benutzer und Password sind wie im ALEX Dienstplan voreingestellt einzugeben. | Benutzer und Password sind wie im ALEX Dienstplan voreingestellt einzugeben. | ||
= Parametrierung im {{Alex}} = | =Parametrierung im {{Alex}}= | ||
== Systemeinstellungen == | ==Systemeinstellungen== | ||
Damit die Änderungen in der Übersicht angezeigt werden, muss in den Systemeinstellungen unter "Intelligenter Stundennachweis" ausgewählt werden, für welchen Status man die Änderungen anzeigen möchte: | Damit die Änderungen in der Übersicht angezeigt werden, muss in den Systemeinstellungen unter "Intelligenter Stundennachweis" ausgewählt werden, für welchen Status man die Änderungen anzeigen möchte: | ||
Zeile 87: | Zeile 75: | ||
{{AlexBild|Statusoptimierung hinterlegen|[[Datei:Stundennachweis Cockpit erst ab status ist.png]]|}} | {{AlexBild|Statusoptimierung hinterlegen|[[Datei:Stundennachweis Cockpit erst ab status ist.png]]|}} | ||
== Benutzer anlegen == | ==Benutzer anlegen== | ||
Es müssen [[Selbstbedienungsbenutzer]] angelegt werden, dabei müssen zwei grundsätzliche Fragen geklärt werden: | Es müssen [[Selbstbedienungsbenutzer]] angelegt werden, dabei müssen zwei grundsätzliche Fragen geklärt werden: | ||
* dürfen die Mitarbeiter im Cockpit stempeln? ([[Selbstbedienungsbenutzer#Erlaubnis_zum_Stempeln_im_Personal_Cockpit|Beschreibung der notwendigen Einstellung falls ja]] | |||
* dürfen die Mitarbeiter im Cockpit nur lesen oder auch Änderungen erfassen? | *dürfen die Mitarbeiter im Cockpit stempeln? ([[Selbstbedienungsbenutzer#Erlaubnis_zum_Stempeln_im_Personal_Cockpit|Beschreibung der notwendigen Einstellung falls ja]] | ||
*dürfen die Mitarbeiter im Cockpit nur lesen oder auch Änderungen erfassen? | |||
Hinweis: die Anlage von Selbstbedienungsbenutzern kann auch [[Selbstbedienungsbenutzer#Automatische_Anlage_aller_SB-Benutzer|automatisch]] erfolgen. | Hinweis: die Anlage von Selbstbedienungsbenutzern kann auch [[Selbstbedienungsbenutzer#Automatische_Anlage_aller_SB-Benutzer|automatisch]] erfolgen. | ||
== Benutzer sperren == | ==Benutzer sperren== | ||
Ab der Version 2019.22 können Benutzer auch von den Apps gesperrt werden. Die Einstellung ist in den Stammdaten des einzelnen Benutzers zu treffen: | Ab der Version 2019.22 können Benutzer auch von den Apps gesperrt werden. Die Einstellung ist in den Stammdaten des einzelnen Benutzers zu treffen: | ||
Zeile 101: | Zeile 90: | ||
{{AlexBild|Benutzersperre|[[Datei:Alex Benutzer.png]]|}} | {{AlexBild|Benutzersperre|[[Datei:Alex Benutzer.png]]|}} | ||
== Definition der Summenspalten == | ==Definition der Summenspalten== | ||
{{AlexBild|Cockpitübersicht|[[Datei:ALEX_MA_Cockpit_01_bis_04.png|center]]||}} | {{AlexBild|Cockpitübersicht|[[Datei:ALEX_MA_Cockpit_01_bis_04.png|center]]||}} | ||
Zeile 107: | Zeile 96: | ||
Die Summenansicht ist entweder am System bzw am Bereich/Planungseinheit/Benutzer unter Allgemein zu hinterlegen: | Die Summenansicht ist entweder am System bzw am Bereich/Planungseinheit/Benutzer unter Allgemein zu hinterlegen: | ||
* Summenspalten in der Tagesansicht = Parameter "Tages-Summenspaltenansicht für Stundennachweis" | *Summenspalten in der Tagesansicht = Parameter "Tages-Summenspaltenansicht für Stundennachweis" | ||
* Summenspalten in der Wochenansicht = Parameter "Wochen-Summenspaltenansicht für Stundennachweis" | *Summenspalten in der Wochenansicht = Parameter "Wochen-Summenspaltenansicht für Stundennachweis" | ||
* Summenspalten in der Monatsansicht = Parameter "Monats-Summenspaltenansicht für Stundennachweis" | *Summenspalten in der Monatsansicht = Parameter "Monats-Summenspaltenansicht für Stundennachweis" | ||
{{AlexBild|Summenspalten einstellen|[[Datei:PersCockpit Summenspalten.png]]|}} | {{AlexBild|Summenspalten einstellen|[[Datei:PersCockpit Summenspalten.png]]|}} | ||
<br> | <br> | ||
== Einstellungen Startseite | ==Einstellungen Startseite== | ||
Die Summen von der Startseite für Saldo und Urlaubsrest können am System bzw. am Bereich/Planungseinheit/Personal unter Mobile Apps definiert werden: | Die Summen von der Startseite für Saldo und Urlaubsrest können am System bzw. am Bereich/Planungseinheit/Personal unter Mobile Apps definiert werden: | ||
Zeile 120: | Zeile 109: | ||
{{AlexBild|Systemeinstellungen vornehmen|[[Datei:WEB Mobile Apps Systemeinstellungen.png]]|}} | {{AlexBild|Systemeinstellungen vornehmen|[[Datei:WEB Mobile Apps Systemeinstellungen.png]]|}} | ||
* '''Personal Cockpit App: Saldo Konto:''' Hier wird das gewünschte Konto für die Saldovorschau eingestellt | *'''Personal Cockpit App: Saldo Konto:''' Hier wird das gewünschte Konto für die Saldovorschau eingestellt | ||
* '''Personal Cockpit App: DRZ-Art:''' Auswahlmöglichkeit zwischen Monat und Woche - wird ein Wochen-DRZ verwendet, muss hier Woche eingestellt werden, damit der Saldo richtig angezeigt werden kann (bei Monats-DRZ stellt man Monat ein) | *'''Personal Cockpit App: DRZ-Art:''' Auswahlmöglichkeit zwischen Monat und Woche - wird ein Wochen-DRZ verwendet, muss hier Woche eingestellt werden, damit der Saldo richtig angezeigt werden kann (bei Monats-DRZ stellt man Monat ein) | ||
* '''Personal Cockpit App: DRZ-Ende Konto:''' Wird hier das Konto für das DRZ Ende hinterlegt, so wird der Saldo vom Monat bzw. von der Woche, wo das Ende des DRZ ist, angezeigt.<br> | *'''Personal Cockpit App: DRZ-Ende Konto:''' Wird hier das Konto für das DRZ Ende hinterlegt, so wird der Saldo vom Monat bzw. von der Woche, wo das Ende des DRZ ist, angezeigt.<br> | ||
Möchte man den Saldo vom aktuellen Monat bzw. der aktuellen Woche sehen, so erreicht man dies, indem man ein Konto hinterlegt, welches jede Woche/jedes Monat größer 1 ist (z.B. Info Wochensoll). | Möchte man den Saldo vom aktuellen Monat bzw. der aktuellen Woche sehen, so erreicht man dies, indem man ein Konto hinterlegt, welches jede Woche/jedes Monat größer 1 ist (z.B. Info Wochensoll). | ||
* '''Personal Cockpit App: Urlaubs Rest Ende Konto:''' Stellt man das Konto "Urlaub in Stunden Rest Ende" ein, so wird der Urlaubsrest zum Ende des Anspruchsjahres angezeigt (z.B. per Ende Dezember, wenn im Jänner der neue Urlaub zugebucht wird). | |||
*'''Personal Cockpit App: Urlaubs Rest Ende Konto:''' Stellt man das Konto "Urlaub in Stunden Rest Ende" ein, so wird der Urlaubsrest zum Ende des Anspruchsjahres angezeigt (z.B. per Ende Dezember, wenn im Jänner der neue Urlaub zugebucht wird). | |||
Würde man das Konto "Urlaub in Stunden Rest" hinterlegen, so würde man den Urlaubsrest per Ende des aktuellen Monats sehen. | Würde man das Konto "Urlaub in Stunden Rest" hinterlegen, so würde man den Urlaubsrest per Ende des aktuellen Monats sehen. | ||
Zeile 131: | Zeile 123: | ||
Eine inhaltliche Beschreibung des Personal Cockpits finden Sie [[Personal_Cockpit|hier]]. | Eine inhaltliche Beschreibung des Personal Cockpits finden Sie [[Personal_Cockpit|hier]]. | ||
<br /> | |||
== Bit Factory interne Zusatzinfos == | |||
[[ALEX App Installation Aktivierung|Aktivierung]] | |||
[[Kategorie:Technik]] | [[Kategorie:Technik]] | ||
[[Kategorie:Christoph - Dokumentation nicht fertig]] | [[Kategorie:Christoph - Dokumentation nicht fertig]] | ||
[[Kategorie:Dokumentation nicht fertig]] | [[Kategorie:Dokumentation nicht fertig]] |
Version vom 10. November 2021, 11:10 Uhr
Installationsbeschreibung Smartphone Apps
Diese Beschreibung erklärt die notwendigen Schritte zur Inbetriebnahme folgender Apps:
Für die Stundennachweis- oder Zeiterfassungs-Apps bitte hier weiterlesen. Diese beiden Apps werden jedoch nicht mehr neu in Betrieb genommen.
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.
Für selbstgehostete Alex®-Web-Instanzen in fremden Domains erfolgt die Anmeldung über "<domain>/<kunde>" (z.B.: "alex.example.at/at.sr.kunde") und dem jeweiligen Benutzer.
Der Benutzer muss als Selbstbedienungsbenutzer angelegt sein.
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"
- Die Alex®-Apps können über einen Reverse-Proxy betrieben werden(ab v2019.20) - für Einrichtung siehe Beispiel 2
- 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 1 - Direkte Verbindung
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 Passwort sind wie im Alex® Dienstplan voreingestellt einzugeben.
Beispiel 2 - Reverse Proxy
Ausgangssituation
Ein Alex® Dienst wird bereits auf einem Server mit der internen IP-Adresse "192.168.123.123" betrieben. Der Domainname "proxy.beispiel.at" ist vorhanden und zeigt auf einen vorhanden Reverse-Proxy.
Der eingestellte "modelServer->port" wurde nicht geändert in der Konfiguration.
Der Server hat bereits direkten Zugriff zur AWS-Cloud.
Notwendige Anpassungen
Am Reverse-Proxy müssen alle Anfragen mit dem Pfad "/ModelServer" an den den TCP-Port 4400 des ALEX Servers "192.168.123.123" weitergeleitet werden. Die korrekte Weiterleitung kann im Browser über die Eingabe "http(s)://proxy.beispiel.at/ModelServer" getestet werden. Wenn die Weiterleitung korrekt funktioniert kommt die Antwort "ALEX Server OK" im Browser.
Anmeldung mit der App
Für Kunde muss beim App-Login dann "http(s)://proxy.beispiel.at" eingegeben werden. Benutzer und Password sind wie im ALEX Dienstplan voreingestellt einzugeben.
Parametrierung im Alex®
Systemeinstellungen
Damit die Änderungen in der Übersicht angezeigt werden, muss in den Systemeinstellungen unter "Intelligenter Stundennachweis" ausgewählt werden, für welchen Status man die Änderungen anzeigen möchte:
Systemeinstellungen |
Weiters kann man ab Version 2019.14 einstellen, ob die Mitarbeiter erst ab dem Status Ist die Daten in der App einsehen dürfen, oder ob die Mitarbeiter uneingeschränkt auch alle zukünftigen Daten sehen dürfen (gilt für Personal Cockpit und Dienstplan App):
Statusoptimierung hinterlegen |
Benutzer anlegen
Es müssen Selbstbedienungsbenutzer angelegt werden, dabei müssen zwei grundsätzliche Fragen geklärt werden:
- dürfen die Mitarbeiter im Cockpit stempeln? (Beschreibung der notwendigen Einstellung falls ja
- dürfen die Mitarbeiter im Cockpit nur lesen oder auch Änderungen erfassen?
Hinweis: die Anlage von Selbstbedienungsbenutzern kann auch automatisch erfolgen.
Benutzer sperren
Ab der Version 2019.22 können Benutzer auch von den Apps gesperrt werden. Die Einstellung ist in den Stammdaten des einzelnen Benutzers zu treffen:
Benutzersperre |
Definition der Summenspalten
Cockpitübersicht |
Die Summenansicht ist entweder am System bzw am Bereich/Planungseinheit/Benutzer unter Allgemein zu hinterlegen:
- Summenspalten in der Tagesansicht = Parameter "Tages-Summenspaltenansicht für Stundennachweis"
- Summenspalten in der Wochenansicht = Parameter "Wochen-Summenspaltenansicht für Stundennachweis"
- Summenspalten in der Monatsansicht = Parameter "Monats-Summenspaltenansicht für Stundennachweis"
Summenspalten einstellen |
Einstellungen Startseite
Die Summen von der Startseite für Saldo und Urlaubsrest können am System bzw. am Bereich/Planungseinheit/Personal unter Mobile Apps definiert werden:
Systemeinstellungen vornehmen |
- Personal Cockpit App: Saldo Konto: Hier wird das gewünschte Konto für die Saldovorschau eingestellt
- Personal Cockpit App: DRZ-Art: Auswahlmöglichkeit zwischen Monat und Woche - wird ein Wochen-DRZ verwendet, muss hier Woche eingestellt werden, damit der Saldo richtig angezeigt werden kann (bei Monats-DRZ stellt man Monat ein)
- Personal Cockpit App: DRZ-Ende Konto: Wird hier das Konto für das DRZ Ende hinterlegt, so wird der Saldo vom Monat bzw. von der Woche, wo das Ende des DRZ ist, angezeigt.
Möchte man den Saldo vom aktuellen Monat bzw. der aktuellen Woche sehen, so erreicht man dies, indem man ein Konto hinterlegt, welches jede Woche/jedes Monat größer 1 ist (z.B. Info Wochensoll).
- Personal Cockpit App: Urlaubs Rest Ende Konto: Stellt man das Konto "Urlaub in Stunden Rest Ende" ein, so wird der Urlaubsrest zum Ende des Anspruchsjahres angezeigt (z.B. per Ende Dezember, wenn im Jänner der neue Urlaub zugebucht wird).
Würde man das Konto "Urlaub in Stunden Rest" hinterlegen, so würde man den Urlaubsrest per Ende des aktuellen Monats sehen.
Eine inhaltliche Beschreibung des Personal Cockpits finden Sie hier.