OrgaMon-App
- Die OrgaMon-App ist der mobile Teil des OrgaMon. Aufträge, die sich im OrgaMon befinden, können auf Android fähige Mobil Geräte (Smartphones, Tablets) übertragen werden. Der Datenabgleich zwischen der OrgaMon-App und OrgaMon erfolgt durch cOrgaMon (Server-Prozess). Der Server ist an das Internet gekoppelt und somit weltweit sichtbar. Der OrgaMon ist über einen FTPS-Ablageplatz mit dem Internet gekoppelt. Der Datenabgleich erfolgt 2x täglich automatisiert (Tagwache & Tagesabschluss) oder auf manuelle Anforderung.
- Als Transportmittel OrgaMon-App<->cOrgaMon wird das Internet benutzt. Dabei wird ihr zugeteilter Firmen-ID (ab sofort immer firma genannt) mit der Domain orgamon.net zu firma.orgamon.net verbunden. Die Mobilgeräte können durch WLAN oder das mobile Datenfunknetz an das InterNet angekoppelt werden.
- Die OrgaMon-App ist abgesehen vom manuell angestossenen "Senden" nicht auf eine ständige Online-Verbindung angewiesen
MOB (OrgaMon-App-Bedienungsanleitung für Monteure)
LOB (OrgaMon-App-Bedienungsanleitung für Lageristen)
Protokolle Hinweise für die Gestaltung der Auftrags-Protokolle
Was ist neu? https://github.com/Andreas-Filsinger/OrgaMon/blob/main/rev/OrgaMon-App.rev.txt
Handys im Einsatz
Samsung Galaxy XCover 4s (Produktiv seit Oktober 2019) Android 9.0.0 API level 28 Android 10.0.0 API level 29 Android 11.0.0 API level 30 |
Datei:Samsung-Galaxy-xcover5.jpg Samsung Galaxy XCover 5 (Produktiv seit Juni 2021) Android 11.0.0 API level 30 Android 12.0.0 API level 31 |
- Beschreibung des Rollout MOB-Admin
Historie
- OrgaMon-App ist der Nachfolger von JonDa
- JonDa ist der Nachfolger von MonDa
MonDa (1. Generation)
- Turbo-Pascal-Entwicklung (i386 System unter MS-DOS)
- Transfer via der GSM-Modem Funktion von damaligen Handys
Falcon i386 MS-DOS Produktiv ab Juni 2002 |
JonDa (2. Generation)
- J2ME Entwicklung
- Transfer via Internet Verbindung der Handys
Siemens SX1 (Prototyp 2001) |
Nokia 6630 (bis 2007) |
Nokia N73 (ab 2007) Code 0541151 Version |
Nokia 2630 (Ableser) |
Nokia 6303 (ab 2009) |
Bedienungsanleitung für Monteure
Zertifizierung
JonDa.Setup Protokoll
Foto Medien
OrgaMon-App (3. Generation)
- interner Projektname war AmDa, "OrgaMon-MOB"
- Java am Android-API Entwicklung
- Daten-Transfers via Internet Verbindung des Smartphones
Samsung Galaxy 3 (Prototyp I ab 2011) |
Samsung Galaxy ACE (Prototyp II ab August 2011) |
Samsung Galaxy ACE Plus (Produktiv seit Januar 2012) | |
Samsung Galaxy ACE 2 (Produktiv seit Oktober 2012) |
Samsung XCover 2 (Produktiv seit Mai 2013) | ||
Samsung Galaxy ACE 3 (Fokusprobleme seit Oktober 2014) |
Samsung Galaxy ACE 4 (Produktiv seit Februar 2015) |
Samsung Galaxy XCover 3 (Produktiv seit Mai 2015) Android 5.1.1 API level 22 |
Samsung Galaxy XCover 3 VE (Produktiv seit Oktober 2016) Android 6.0.1 API level 23 |
Datei:XCover 4b.png Samsung Galaxy XCover 4 (Produktiv seit April 2019) Android 8.1.0 API level 27 Android 9.0.0 API level 28 |
Installation
Hilfsprogramme
- ->Android-Einstellungen (Zahnrad)->Anzeige->Bildschirm-Timeout->auf 30 Min
- Erklärung: OrgaMon-App benutzt einen Hintergrundprozess um die Fotos auf den Server hochzuladen. Seit Android 11 werden Hintergrund-Prozesse von Apps gestoppt wenn die Anwendung selbst nicht mehr im Vordergrund ist. Wenn Sie also das Handy weglegen und das Display deaktivieren (oder es deaktiviert sich durch einen Display-Timeout) bekommt OrgaMon-App nicht mehr genug Zeit um Bilder hochzuladen. Lassen Sie also "abends" die OrgaMon-App im Vordergrund, und lassen Sie das Display aktiv, damit in einem Zug die Bilder übertragen werden können. Spätestens nach 10 Minuten jedoch stoppt Android den Upload-Vorgang, danach müssen Sie wieder "Stop" und "Start" drücken. Eigentlich sollten Sie den von Android erzwungenen "Stop" durch einen "bösen" Ton signalisiert bekommen.
- Im Play-Store zusätzlich installieren
- Open Camera (Mark Harmann)
- ZXing Barcode Scanner
- Firefox
- X-plore File Manager (Lonely Cat Games)
- Im Play-Store alle Updates
- In den Einstellungen (Symbol Zahnrad)
- Software-Update (ziemlich weit unten) -> Herunterladen und installieren -> bis "Ihre Software ist auf dem neuesten Stand"
- In den Einstellungen Apps
- bei "Facebook", die Benachrichtigungen AUS
- Open Camera starten
->Zahnrad oben rechts drücken ->Mehr Kamera Einstellungen ->Benutze Storage Access Framework -> auf den blauen Ordner tippen -> Pictures -> DIESEN ORDNER VERWENDEN -> zulassen (zurück) ->Foto Einstellungen ->Kamera-Auflösung -> 1088x1088 -> Bildqualität -> 68 % (zurück) -> Standort Einstellungen -> Geotagging [v] aktivieren (zurück) -> Camera API -> Camera 2 API (zurück) (zurück) (Zulassen bei Benutzung der App)
- X-plore
- Interner Speicher->"Pictures" öffnen und das Programm "so" verlassen (Zurück, Zurück)
- ZXing
- Einstellungen, ganz unten 4 Kreuze raus, Foto LED an
OrgaMon-App
- Starten Sie den Firefox-Browser, tippen Sie auf das Eingabefeld "Suche oder Adresse", oberhalb erscheint nun "() Scannen", dies drücken
- Scannen Sie folgenden QR Code
- Sollte der Scan nicht möglich sein, kann man manuell die Internetadresse eingeben
https://cargobay.orgamon.org/OrgaMon-App-2049.apk
- [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
- Hier endet die Anleitung wenn Sie nur ein Update machen
- Einstellungen (Zahnrad) -> Apps -> Lupe: "org" eingeben -> OrgaMon wählen
- -> Berechtigungen -> "Kamera" zulassen, zurück, "Speicher" zulassen, zurück
- "Berechtigung für ungenutzte App entfernen" deaktivieren
- Zurück, Zurück
- Aus den Einstellungen (Symbol Zahnrad)->Telefoninfo (ziemlich weit unten)->lange auf IMEI (Steckplatz 1) drücken, bis es in der Zwischenablage ist
- OrgaMon-App: In Einstellungen die Geräte Nummer: 000 löschen und 2 Sekunden lang auf das Eingabefeld drücken dann loslassen, dann Einfügen wählen (die kopierte IMEI von eben), dann weiter, dann ok, "Speichern"
- Die IMEI verschwindet wieder
- Nun das 9 stellige Firmen-Passwort bei Geräte Nummer: eingeben (zuvor auch wieder die 000 rausmachen), dann weiter, dann ok, dann "Speichern"
- Das Passwort verschwindet wieder
- Nun keine oder mehrere 4 stelligen Firmen-Optionen eingeben, dann weiter, dann ok, dann "Speichern"
- Die Option verschwindet wieder
- Bei Firma:, ihr Firmenkürzel in Kleinbuchstaben eintippen, speichern
- Menü (Symbol "drei Punkte untereinander") -> Senden
- bei Aktualität: muss nun ein aktuelles Datum und Uhrzeit von eben stehen
Firmen Optionen
Option | Wirkung | Default |
---|---|---|
1000 | alle Optionen werden wieder auf Ihren Defaultwert gesetzt | |
1001 | Fotopfad ist "/mnt/sdcard/DCIM/Camera" | 1005 |
1002 | Fotopfad ist "/mnt/sdcard/DCIM/100ANDRO" | 1005 |
1003 | Fotopfad ist "/storage/extSdCard/DCIM/Camera" | 1005 |
1004 | Fotopfad ist "/storage/emulated/0/DCIM/Camera" | 1005 |
1005 | Fotopfad ist "/storage/emulated/0/Pictures" | JA |
1006 | FTP wird verwendet | FTPS wird verwendet |
1007 | FTP-Host ist "ftp.local" | FTP-Host ist firma.orgamon.net |
1008 | Fotos werden durch die Camera-App bestätigt | Fotos werden durch die OrgaMon-App bestätigt |
Mandant wechseln
- Die selbe OrgaMon-App kann mit verschiedenen Firmen-Kennungen betrieben werden
- Eine Neuinstallation der App ist für einen Wechsel nicht nötig
- "Senden" Sie ihre Daten um sicherzustellen dass alle Eingaben vom Server verarbeitet werden
- Stellen Sie sicher, dass ALLE Fotos übertragen sind (Stichwort "u"). (Das ist sehr wichtig da Restbilder, werden Sie erst nach der Umstellung übertragen, vom neuen Server nicht zugeordnet werden können, oder völlig falsch zugeordnet werden)
- Gehen Sie nun in die OrgaMon-App Einstellungen und ...
- Geben bei Geräte-ID "000" ein
- Nun nochmals "Senden", die Anzahl der Aufträge muss nun "0" sein
- Geben Sie die neue Firmen-ID ein
- Geben Sie ein Feld zurück und geben Sie bei Geräte-ID das zur Firma gehörige Passwort ein, danach "speichern"
- Geben Sie die Firmen-Optionen ein, danach wieder "speichern". Verwenden Sie keine Firmen-Optionen geben Sie dennoch 1000 ein, um alle etwaigen alten Optionen zu löschen
- Stellen Sie nun die Geräte-ID auf den richtigen neuen 3stelligen Wert, wieder "speichern"
- Nun nochmals "Senden", prüfen Sie abschließend die Anzahl der Aufträge
offene Probleme
Android 11
Camera MX läuft nichtstelle um auf OpenCamera (ab Rev. 2.044)Über das Intent kann man keine 3rd Party Camera App mehr startenLösung durch explizite Angabe "Open Camera" (ab Rev. 2.044)- Hintergrund Prozess für den Upload wird willkürlich von Android 11 gestoppt
- Android 11 stoppt grundsätzlich den Hintergrundprozess wenn der Vordergrundprozess pausiert oder beendet wird
- Workaround ist es zu versuchen dass OrgaMon-App möglichst immer im Vordergrund bleibt
- ->Einstellungen->Anzeige->Bildschirm-Timeout->auf 30 Min
Android Studio
falsches apk-Dateiformat
- ganzes "Build-Verzeichnis" leeren
- "Build"->"Clean Project" machen
- "Build Bundels/APK"->Build APK machen
- sicherstellen dass app\build\outputs\apk\debug\app-debug.apk die "richtige" Dateigrösse hat