ALEX App Installation: Unterschied zwischen den Versionen

VisuellWikitext
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
Zeile 12: Zeile 12:
Für Kunden, bei denen Alex durch Bit Factory auf Amazon-Warehouse-Server zur Verfügung gestellt wird, sind hier keine weiteren Tätigkeiten notwendig. Die Smartphones benötigen lediglich eine Internet-Verbindung.
Für Kunden, bei denen Alex durch Bit Factory auf Amazon-Warehouse-Server zur Verfügung gestellt wird, sind hier keine weiteren Tätigkeiten notwendig. Die Smartphones benötigen lediglich eine Internet-Verbindung.


Die Anmeldung erfolgt mit dem Kundenkürzel (z.B.: "at.sr.kunde") und dem jeweiligen Benutzer.
Die Anmeldung erfolgt mit der Kundenkennung (z.B.: "at.sr.kunde") und dem jeweiligen Benutzer.
 
{{AlexBild|Dienstplan App Anmeldung|[[Datei:Login Dienstplan App.png|300px]]|}}


==Hosting auf Kundenserver==
==Hosting auf Kundenserver==
Zeile 18: Zeile 20:


*Die {{Alex}}-Apps verwenden eine TCP-Verbindung für die Kommunikation.
*Die {{Alex}}-Apps verwenden eine TCP-Verbindung für die Kommunikation.
*Im App-Login muss einmalig der Domain-Name (Bsp.: alex.kunde.at) eingetragen werden.
*Im App-Login muss einmalig der Domain-Name (z.B.: alex.kunde.at) eingetragen werden.
**Man könnte auch eine statische IP-Adresse eintragen (empfohlen wird aber ein Domain-Name)
**Man könnte auch eine statische IP-Adresse eintragen (empfohlen wird aber ein Domain-Name)
**Standard-Port ist 4400. Wird der [[ALEX-Ports#Ports_im_ALEX-Config-File|"Model Server Port"]] geändert, so ist dieser beim App-Login mit einzugeben  (Bsp.: alex.kunde.at:5000)
**Standard-Port ist 4400. Wird der [[ALEX-Ports#Ports_im_ALEX-Config-File|"Model Server Port"]] geändert, so ist dieser beim App-Login mit einzugeben  (z.B.: alex.kunde.at:5000)
*Die Verschlüsselung der Kommunikation ist möglich - siehe [[ALEX-Config-File|Konfiguration / "certificate"]]
*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 [[ALEX_App_Installation#Beispiel_2_-_Reverse_Proxy|Beispiel 2]]
*Die {{Alex}}-Apps können über einen Reverse-Proxy betrieben werden (ab v2019.20) - für Einrichtung siehe [[ALEX_App_Installation#Beispiel_2_-_Reverse_Proxy|Beispiel 2]]
Zeile 36: Zeile 38:
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 "alex.beispiel.at" ist vorhanden und zeigt auf die externe IP des Routers(oder Firewall).
Der Domain-Name "alex.kunde.at" ist vorhanden und zeigt auf die externe IP des Routers (oder Firewall).


Der eingestellte "modelServer->port" wurde nicht geändert in der [[ALEX-Config-File|Konfiguration]].
Der eingestellte [[ALEX-Ports#Ports im ALEX-Config-File|"Model Server Port"]] wurde in der [[ALEX-Config-File|Konfiguration]] nicht geändert.


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 ist eine Portweiterleitung (Port forwarding) für den TCP-Port 4400 von extern zum {{Alex}} Server "192.168.123.123" einzurichten.


====Anmeldung mit der App====
====Anmeldung mit der App====
Für Kunde muss beim App-Login dann "alex.beispiel.at" eingegeben werden.
Im Feld "Kunde" muss beim App-Login der Domain-Name (alex.kunde.at) eingegeben werden.
Benutzer und Passwort sind wie im {{Alex}} Dienstplan voreingestellt einzugeben.
 
Benutzer und Passwort sind wie im {{Alex}} Dienstplan einzugeben.


===Beispiel 2 - Reverse Proxy===
{{AlexBild|Dienstplan App Anmeldung|[[Datei:Login Dienstplan App.png|300px]]|}}
===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 eingestellte "modelServer->port" wurde nicht geändert in der [[ALEX-Config-File|Konfiguration]].
Der Domain-Name "proxy.beispiel.at" ist vorhanden und zeigt auf einen vorhanden Reverse-Proxy.
 
Der eingestellte [[ALEX-Ports#Ports im ALEX-Config-File|"Model Server Port"]] wurde in der [[ALEX-Config-File|Konfiguration]] nicht geändert.


Der Server hat bereits direkten Zugriff zur AWS-Cloud.
Der Server hat bereits direkten Zugriff zur AWS-Cloud.
Zeile 60: Zeile 66:
====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.
 
Wenn die Weiterleitung korrekt funktioniert kommt die Antwort "ALEX Server OK" im Browser.
Die Weiterleitung lässt sich im Web-Browser über die Eingabe "http(s)://proxy.beispiel.at/ModelServer" testen.
 
Funktioniert die Weiterleitung im Web-Browser, so erscheint die Meldung "ALEX Server OK".


====Anmeldung mit der App====
====Anmeldung mit der App====
Für Kunde muss beim App-Login dann "http(s)://proxy.beispiel.at" eingegeben werden.
Im Feld "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 Passwort sind wie im {{Alex}} Dienstplan einzugeben.


=Parametrierung im {{Alex}}=
=Parametrierung im {{Alex}}=

Version vom 10. November 2021, 14:54 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

Hosting durch Bit Factory

Für Kunden, bei denen Alex durch Bit Factory auf Amazon-Warehouse-Server zur Verfügung gestellt wird, sind hier keine weiteren Tätigkeiten notwendig. Die Smartphones benötigen lediglich eine Internet-Verbindung.

Die Anmeldung erfolgt mit der Kundenkennung (z.B.: "at.sr.kunde") und dem jeweiligen Benutzer.

Dienstplan App Anmeldung
Login Dienstplan App.png

Hosting auf Kundenserver

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 Domain-Name (z.B.: alex.kunde.at) eingetragen werden.
    • Man könnte auch eine statische IP-Adresse eintragen (empfohlen wird aber ein Domain-Name)
    • Standard-Port ist 4400. Wird der "Model Server Port" geändert, so ist dieser beim App-Login mit einzugeben (z.B.: alex.kunde.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.

Für Alex®-Web-Instanzen auf dem Kundenserver 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.

Beispiel 1 - Direkte Verbindung

Ausgangssituation

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

Der Domain-Name "alex.kunde.at" ist vorhanden und zeigt auf die externe IP des Routers (oder Firewall).

Der eingestellte "Model Server Port" wurde in der Konfiguration nicht geändert.

Der Server hat bereits direkten Zugriff zur AWS-Cloud.

Notwendige Anpassungen

Im Router ist eine Portweiterleitung (Port forwarding) für den TCP-Port 4400 von extern zum Alex® Server "192.168.123.123" einzurichten.

Anmeldung mit der App

Im Feld "Kunde" muss beim App-Login der Domain-Name (alex.kunde.at) eingegeben werden.

Benutzer und Passwort sind wie im Alex® Dienstplan einzugeben.

Beispiel 2 - Reverse Proxy

Dienstplan App Anmeldung
Login Dienstplan App.png

Beispiel 2 - Reverse Proxy

Ausgangssituation

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

Der Domain-Name "proxy.beispiel.at" ist vorhanden und zeigt auf einen vorhanden Reverse-Proxy.

Der eingestellte "Model Server Port" wurde in der Konfiguration nicht geändert.

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 Weiterleitung lässt sich im Web-Browser über die Eingabe "http(s)://proxy.beispiel.at/ModelServer" testen.

Funktioniert die Weiterleitung im Web-Browser, so erscheint die Meldung "ALEX Server OK".

Anmeldung mit der App

Im Feld "Kunde" muss beim App-Login dann "http(s)://proxy.beispiel.at" eingegeben werden.

Benutzer und Passwort sind wie im Alex® Dienstplan 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
Intelligenter Stundennachweis Systemeinstellungen.png

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
Stundennachweis Cockpit erst ab status ist.png

Benutzer anlegen

Es müssen Selbstbedienungsbenutzer angelegt werden, dabei müssen zwei grundsätzliche Fragen geklärt werden:

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
Alex Benutzer.png

Definition der Summenspalten

Cockpitübersicht
ALEX MA Cockpit 01 bis 04.png

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
PersCockpit Summenspalten.png


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
WEB Mobile Apps Systemeinstellungen.png
  • 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.


Bit Factory interne Zusatzinfos

Aktivierung

Abgerufen von „https://alexwiki.bitfactory.at/w/index.php?title=ALEX_App_Installation&oldid=59256“