OrgaMon-App: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
(55 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 12: Zeile 12:




== Handys im Einsatz ==
== Installation ==
 
=== Hilfsprogramme ===
{|
|style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]]<br>Samsung Galaxy XCover 4s<br>(Produktiv seit Oktober 2019)<br>Android 9.0.0<br>API level 28<br>Android 10.0.0<br>API level 29<br><b>Android 11.0.0</b><br>API level 30
|style="vertical-align:top;"|[[Bild:Samsung-Galaxy-xcover5.jpg|85px]]<br>Samsung Galaxy XCover 5<br>(Produktiv seit Juni 2021)<br>Android 11.0.0<br>API level 30<br><b>Android 12.0.0</b><br>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
 
{|
|[[Bild:6400.jpg|65px]]<br>Falcon i386 MS-DOS<br>Produktiv ab Juni 2002
|-
|}
 
=== JonDa (2. Generation) ===
 
* J2ME Entwicklung
* Transfer via Internet Verbindung der Handys
 
{|
|[[Bild:SX1_Front_a.jpg|65px]]<br>Siemens SX1 (Prototyp 2001)<br>
|[[Bild:6630.png]]<br>Nokia 6630 (bis 2007)
|[[Bild:NokiaN73-90x163.jpg]]<br>Nokia N73 (ab 2007)<br>Code 0541151<br>Version
|[[Bild:Nokia-2630.png|65px]]<br>Nokia 2630 (Ableser)<br>
|[[Bild:Nokia-6303.png|65px]]<br>Nokia 6303 (ab 2009)<br>
|-
|}
<br>
 
[[JonDa.Anwender|Bedienungsanleitung für Monteure]]<br>
[[JonDa.Zertifizierung|Zertifizierung]]<br>
[[JonDa.Setup Protokoll]]<br>
[[Foto]] [[Medien]]<br>
 
=== OrgaMon-App (3. Generation) ===
 
* interner Projektname war [[AmDa]], "OrgaMon-MOB"
* Java am Android-API Entwicklung
* Daten-Transfers via Internet Verbindung des Smartphones
 
{|
|[[Bild:Samsung-galaxy3_i5800.jpg|65px]]<br>Samsung Galaxy 3<br>(Prototyp I ab 2011)<br>
|[[Bild:Samsung-ace.jpg|75px]]<br>Samsung Galaxy ACE<br>(Prototyp II ab August 2011)
|[[Bild:Samsung-Galaxy-Ace-Plus.png|95px]]<br>Samsung Galaxy ACE Plus<br>(Produktiv seit Januar 2012)
|-
|[[Bild:Samsung-Galaxy-Ace-2.png|165px]]<br>Samsung Galaxy ACE 2<br>(Produktiv seit Oktober 2012)
|[[Bild:Samsung-galaxy-xcover-2.jpg|130px]]<br>Samsung XCover 2<br>(Produktiv seit Mai 2013)
|-
|[[Bild:ACE_3.png|95px]]<br>Samsung Galaxy ACE 3<br>(<u><b>Fokusprobleme</b></u> seit Oktober 2014)
|[[Bild:ACE_4.png|95px]]<br>Samsung Galaxy ACE 4<br>(Produktiv seit Februar 2015)
|[[Bild:XCover_3.png|95px]]<br>Samsung Galaxy XCover 3<br>(Produktiv seit Mai 2015)<br>Android 5.1.1<br>API level 22
|[[Bild:XCover_3.png|95px]]<br>Samsung Galaxy XCover 3 VE<br>(Produktiv seit Oktober 2016)<br>Android 6.0.1<br>API level 23
|-
|style="vertical-align:top;"|[[Bild:XCover_4b.png|85px]]<br>Samsung Galaxy XCover 4<br>(Produktiv seit April 2019)<br>Android 8.1.0<br>API level 27<br><b>Android 9.0.0</b><br>API level 28
|}
 
== Handy Setup ==


* ->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
* Im Play-Store zusätzlich installieren
** Whatsapp
** Slack
** Camera MX
** Open Camera (Mark Harmann)
** ZXing Barcode Scanner
** ZXing Barcode Scanner (Firefox öffnen - als Standard-Browser auswählen - QR-Code scannen - zulassen - herunterladen - öffnen - Einstellungen - aus dieser Quelle zulassen auswählen - installieren)
*** [[Datei:BarcodeScanner-4.7.8.png|150px]]
** Firefox
** Firefox
** x plore
** Das Örtliche-App
** Wetter.com
 
* Im Play-Store alle Updates
* Im Play-Store alle Updates
* In den Einstellungen  
* In den Einstellungen (Symbol Zahnrad)
** Softwareupdate bis "auf dem neuesten Stand"
** Software-Update (ziemlich weit unten) -> Herunterladen und installieren -> bis "Ihre Software ist auf dem neuesten Stand"
* In den Einstellungen Apps
* In den Einstellungen Apps
** bei "Facebook", die Benachrichtigungen AUS
** bei "Facebook", die Benachrichtigungen AUS
** bei "Bixbi", die Benachrichtigungen AUS
* Open Camera starten
** bei "OrgaMon", die Zugriffsrechte
 
* Gmail starten
->Zahnrad oben rechts drücken
* Maps starten
->Mehr Kamera Einstellungen
** Offlinekarten AUS
  ->Benutze Storage Access Framework
* Open Camera
  -> Pictures
** Auflösung 1080x1080
  -> DIESEN ORDNER VERWENDEN
** Qualität 73 %
  -> zulassen
** "Pictures" via Storage API
(zurück)
** Camera 2 API
->Foto Einstellungen
** Standort speichern
  ->Kamera-Auflösung
* OrgaMon-App
  -> 1088x1088
** "senden"
  -> Bildqualität
* X-plore
  -> 68 %
** Pictures öffnen
(zurück)
-> Standort Einstellungen
  -> Geotagging [v] aktivieren
(zurück)
-> Camera API
  -> Camera 2 APIn ( ist automatisch ausgewählt)
  (zurück)
(zurück)
(Zulassen bei Benutzung der App)
 
* ZXing
* ZXing
** Einstellungen, ganz unten 4 Kreuze raus, Foto LED an
**Alle Berechtigungen akzeptieren
* Im Netzumbau-OrgaMon
** Einstellungen, ganz unten 4 Kreuze raus (kein kontinuierlicher Fokus, keine Belichtungsmessung, keine Dosierung, kein Barcode-Szene-Modus), Foto LED an
** Handy im Artikel anlegen,  
** Schalter setzen
** IMEI rauskopieren und in die ->Person->Lohn->Versicherungsnummer eintragen
** Tagwache, Einzeltest vorbereiten, Kreuzchen raus bei Tagwache OLAP ausführen
 
== Installation OrgaMon-App ==


=== OrgaMon-App ===


* Auf dem Handy im Firefox-Browser, tippen Sie auf das Eingabefeld "Suche oder Adresse", oberhalb erscheint nun "() Scannen", dies drücken
* 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
* Scannen Sie folgenden QR Code
** [[Datei:OrgaMon-App-2047.png|200px]]
** [[Datei:OrgaMon-App-2050.png|200px]]
** Sollte der Scan nicht möglich sein kann man manuell die Internetadresse eingeben
** Sollte der Scan nicht möglich sein, kann man manuell die Internetadresse eingeben
** <code>https://cargobay.orgamon.org/OrgaMon-App-2047.apk</code>
** <code>https://cargobay.orgamon.org/OrgaMon-App-2050.apk</code>
* [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
* [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
* Wenn man nur ein Update durchgeführt hat ist man an diesem Punkt fertig
* <i>Hier endet die Anleitung wenn Sie nur ein Update machen</i>
* Bei einer Neuinstallation muss noch mehr gemacht werden:
 
=== Einstellungen ===


* Einstellungen -> Apps -> Lupe: "org" eingeben -> <b>OrgaMon</b> wählen -> Berechtigungen -> "Kamera" zulassen, zurück, "Speicher" zulassen, zurück
* Aus den Einstellungen (Symbol Zahnrad)->Telefoninfo->lange auf <b>IMEI (Steckplatz 1)</b> drücken, bis es in der Zwischenablage ist


=== erstmals Starten ===
* Einstellungen (Zahnrad) -> Apps -> Lupe: "org" eingeben -> <b>OrgaMon</b> wählen
 
** -> Berechtigungen -> "Kamera" zulassen, zurück, "Speicher" zulassen, zurück
* In den OrgaMon Einstellungen die <b>Geräte Nummer:</b> 000 löschen und 2 Sekunden lang auf das Eingabefeld drücken dann loslassen, dann <b>Einfügen</b> wählen (die kopierte IMEI von eben), dann weiter, dann ok, "Speichern"
** "Berechtigung für ungenutzte App entfernen" deaktivieren
** Zurück, Zurück
* Aus den Einstellungen (Symbol Zahnrad)->Telefoninfo (ziemlich weit unten)->lange auf <b>IMEI (Steckplatz 1)</b> drücken, bis es in der Zwischenablage ist
* OrgaMon-App: In Einstellungen die <b>Geräte Nummer:</b> 000 löschen und 2 Sekunden lang auf das Eingabefeld drücken dann loslassen, dann <b>Einfügen</b> wählen (die kopierte IMEI von eben), dann weiter, dann ok, "Speichern"
** Die IMEI verschwindet wieder
** Die IMEI verschwindet wieder
* Nun das 9 stellige Firmen-Passwort bei <b>Geräte Nummer:</b> eingeben (zuvor auch wieder die 000 rausmachen), dann weiter, dann ok, dann "Speichern"
* Nun das 9 stellige Firmen-Passwort bei <b>Geräte Nummer:</b> eingeben (zuvor auch wieder die 000 rausmachen), dann weiter, dann ok, dann "Speichern"
** Das Passwort verschwindet wieder
** Das Passwort verschwindet wieder
* Nun keine oder mehrere 4 stelligen Firmen-Optionen eingeben, dann weiter, dann ok, dann "Speichern"
** Die Option verschwindet wieder
* Bei <b>Firma:</b>, ihr Firmenkürzel in Kleinbuchstaben eintippen, speichern
* Bei <b>Firma:</b>, ihr Firmenkürzel in Kleinbuchstaben eintippen, speichern
* Menü (Symbol "drei Punkte untereinander") -> Senden
* Menü (Symbol "drei Punkte untereinander") -> Senden
** bei <b>Aktualität:</b> muss nun ein aktuelles Datum und Uhrzeit von eben stehen
** bei <b>Aktualität:</b> muss nun ein aktuelles Datum und Uhrzeit von eben stehen


=== Optionen ===
== Firmen Optionen ==


{|class="wikitable"
{|class="wikitable"
Zeile 189: Zeile 131:
  |}
  |}


==Tauschhandy aktivieren==
== Mandant wechseln ==
 
* OrgaMon-App kann mit dem selben Handy unter verschiedenen Firmen-Kennungen betrieben werden
* Eine Neuinstallation der App ist für einen Wechsel nicht nötig, in den Einstellungen können alle notwendigen Parameter verändert werden
* Die IMEI wird dabei nicht verändert, ein intern Wert (SALT) identifiziert die Installation gegenüber dem Server
* Monteure mit eigenen Geräte Nummern und IMEI müssen vertraglich im OrgaMon angelegt werden
* Die Lizenzdateien (IMEI.csv, IMEI-OK.csv) müssen ausgespielt werden, und der cOrgaMon-Dienst muss neu gestartet werden
<br>
* "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 <code>Geräte Nummer</code> <b>000</b> ein
* Nun nochmals im Menü <code>Senden</code>, die Anzahl der Aufträge muss nun "0" sein
<br>
* Geben Sie bei <code>Firma:</code>die Firmen-ID des gewünschten neuen Mandanten ein, <speichern>
* Tätigen Sie nun Eingaben immer im Feld <code>Geräte Nummer:</code>
** das zur Firma gehörige Passwort, danach <speichern>
** <b>1000</b>, danach <speichern>
** gegebenenfalls Firmen-Optionen, danach <speichern>
** Stellen Sie nun die Geräte-ID auf den richtigen, zum Monteur passenden 3stelligen Wert, wieder <speichern>
<br>
* Nun nochmals <code>Senden</code>, prüfen Sie abschließend die Anzahl der Aufträge
 
== offene Probleme ==
 
=== Android 11 ===
 
* <s>Camera MX läuft nicht</s> stelle um auf OpenCamera (ab Rev. 2.044)
* <s>Über das Intent kann man keine 3rd Party Camera App mehr starten</s> Lö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 13 ===
 
* ZXING Barcode Scanner wird nicht mehr angeboten (Lösung: Hosting auf cargobay)
 
=== Android Studio ===
 
* Samsung Android Developer UBS Treiber benutzen
* auf dem Handy "MIDI" ankreuzen
 
==== falsches apk-Dateiformat ====


Das neue Handy erst mit einem WLAN verbinden, ist keines vorhanden kann mit dem "alten" Handy (falls noch bedienbar) per "Tethering" ein WLAN aufgespannt werden. Das "neue" Handy muss dann mit diesem WLAN verbunden werden.
* ganzes "Build-Verzeichnis" komplett leeren (.\app\build\*)
* "Build"->"Clean Project" machen
* "Build"->"Build Bundels/APK"->Build APK machen
* sicherstellen dass app\build\outputs\apk\debug\app-debug.apk die "richtige" Dateigrösse hat


* das bisherige Google-Konto auf das neue Handy umziehen, Schritte auf dem neuen Handy:
=== Geblockte Fotos / Ausstehende Fotos ===
**Einstellungen (Zahnrad)
**Konten
**Konto hinzufügen
**Google
**Eingabe bei E-Mail oder Tel Nr. den Kontonamen z.B. hans.firma
**öffnen
**Passwort eingeben (haben Sie zusammen mit dem neuen Handy erhalten)
**öffnen
**Nutzungsbedingungen auf "Ja ich stimme zu" drücken
**Geschäftsbedingungen auf "stimme zu"
**Zahlungsdetails einrichten auf "nein danke"
**Liste der Kontoarten jetzt auf den Zurückknopf drücken
**es erscheint die Googleschaltfläche sowie die Schaltfläche "Konto hinzufügen" hier auf Google drücken
**beide Konten werden aufgelistet, auf das erste Konto drücken
**den Menueknopf drücken (3 Punkte rechts oben)
**Konto entfernen
**nochmal Konto entfernen
**Handy ausschalten und SIM-Karte aus dem defekten Handy in das neue Handy einlegen


== Update ==
* Der Fehler zeigt sich dadurch dass Foto-Dateien zwar von der OrgaMon-App gesehen - aber nicht umbenannt werden können
** dadurch werden sie NICHT per FTP übertragen und verbleiben auf dem Handy
** in älteren OrgaMon-App Versionen führte es dazu, dass diese Datei endlos übertragen wurde
** Es gibt einzelne Geblockte Fotos, danach wieder Zeiten wo es funktioniert, es sind immer nur 1 oder 2 Dateien gestört
*** z.B. 8.12, 12.01, 15.06, 20.06., 22.06, 15.05, 26.06., 28.06


=== Xcover 4s auf Android 11 ===
* neue OrgaMon-App Versionen machen eine Test-Umbenennung in t<alter Dateiname> kurios: Es gibt fälle da gelingt die "t" Umbenennung noch, die "Rückumbenennung" nicht mehr!
* Aktuelle Vermutung: Eine Cloud oder Backup-App könnte die Dateien ev. sperren, Gründe hierfür sind spekulativ


* <b>Update der OrgaMon-App nach einem Update des Handy auf Android 11</b>
* "Senden" Sie nochmal und stellen Sie sicher dass alle Fotos übertragen sind
* Starten Sie den Firefox-Browser (Symbol Orangener Fuchs), tippen Sie in das graue Eingabefeld "Suche oder Adresse", oberhalb erscheint nun "() Scannen", dies drücken
* Scannen Sie folgenden QR Code
** [[Datei:OrgaMon-App-2046.png|200px]]
** Sollte der Scan nicht möglich sein kann man manuell die Internetadresse eingeben
** <code>https://cargobay.orgamon.org/OrgaMon-App-2046.apk</code>
* [Erlauben, Zulassen, Zulassen] Herunterladen -> [Einstellungen, Aus dieser Quelle zulassen, Zurück] Installieren, Öffnen
* In den Einstellungen der OrgaMon-App muss nun oben "OrgaMon-App Rev. 2046" stehen!


* <b>IMEI eintragen</b>
Aktuelle Lösung:
* Gehen Sie auf die Einstellungen Ihres Handies, das ist das Symbol Zahnrad
*Wenn das Foto mit WLAN und Ladekabel nicht übertragen werden kann, mit *A* in MonteurInfo kennzeichen und entsprechend deklarieren
** Ziemlich weit unten auf "Telefoninfo" drücken
*Monteur RID zukommen lassen, dass er das Foto auf dem Handy sucht
** lange auf IMEI (Steckplatz 1) gedrückt halten, bis es heisst "in Zwischenablage kopiert"
*Monteur muss Foto per Mail zusenden und unter "J:\OrgaMon\Handy-Server\ftp" hinterlegen --> Orgamon wird simuliert, dass das Foto auf herkömmlichen Weg übertragen wurde --> Foto verschwindet bei den ausstehendes Fotos im App-Server-Dashboard
* Starten Sie die OrgaMon-App und gehen Sie in "Einstellungen"
*Bild wird automatisch der zugehörigen Internetablage zugeordnen - Foto über Transaktion LU1 auf J transferieren - Überprüfung mit Doppelklick im Protokollfeld, ob das Foto da ist - Datenmeldung auslösen
** Löschen Sie ihre 3 stellige <u>Geräte Nummer:</u> raus und tippen Sie schnell 2x auf das nun leere Eingabefeld
*Überprüfung vom Monteur durch erneutes senden und start, ob das Foto noch auf dem Handy ist --> wenn das Foto noch auf dem Handy ist, muss dieses gelöscht werden!!!
** Wählen Sie <b>Einfügen</b>, dann <b>Weiter</b>, dann <b>OK</b>, dann <b>SPEICHERN</b>
**Orgamon versucht ansonsten, immer wieder das Foto zu übertragen
** Nun steht wieder die 3 stellige <u>Geräte Nummer:</u> im Eingabefeld


* <b>Firmenpasswort eintragen</b>
=== Foto wird immer wieder übertragen ===
* Löschen Sie ihre 3 stellige <u>Geräte Nummer:</u> wieder raus und geben das 9 stellige Firmenpasswort ein
*Wenn ein Foto X-Mal übertragen wird und immer wieder auf der Interablage der STW ist, muss der Monteur das Foto auf dem Handy löschen. Dadurch wird die Bildübertragung gestoppt.
* dann <b>Weiter</b>, dann <b>OK</b>, dann <b>SPEICHERN</b>
*in der Datei "J:\OrgaMon\Handy-Server\log\FotoService-Transaktionen.log.txt" (über Notepad öffnen) kann über die Suchfunktion - zählen nach dem RID gesucht und gezählt werden, wie oft das Foto schon übertragen wurde
* Nun steht wieder die 3 stellige <u>Geräte Nummer:</u> im Eingabefeld


* <b>Firmenoptionen eintragen</b>
== Historie ==
* ev. müssen noch 4 stellige Firmenoptionen in die <u>Geräte Nummer:</u> eingetragen werden


* <b>dyndns.org bei <u>Firma:</u> weglöschen</b>
* OrgaMon-App ist der Nachfolger von JonDa
* Geben Sie den Firmennamen in Kleinbuchstaben im Eingabefeld <u>Firma:</u> ein, ohne wie früher das ".dyndns.org", als Beispiel einfach nur <code>firma</code>
* JonDa ist der Nachfolger von MonDa
* prüfen Sie jetzt, ob "senden" klappt


* <b>Open Camera</b>
=== Handys im Einsatz ===
* Installation Sie "Open Camera (Mark Harmann)" aus dem Play-Store
* Starten Sie Open-Camera und machen Sie folgende Einstellungen:


->Zahnrad oben rechts drücken
{|
  ->Mehr Kamera Einstellungen
  |style="vertical-align:top;"|[[Bild:XCover-4s.jpg|85px]]<br>Samsung Galaxy XCover 4s<br>(Produktiv seit Oktober 2019)<br>Android 9.0.0<br>API level 28<br>Android 10.0.0<br>API level 29<br><b>Android 11.0.0</b><br>API level 30
  ->Benutze Storage Access Framework
  |style="vertical-align:top;"|[[Bild:Samsung-Galaxy-xcover5.jpg|85px]]<br>Samsung Galaxy XCover 5<br>(Produktiv seit Juni 2021)<br>Android 11.0.0<br>API level 30<br>Android 12.0.0<br>API level 31<br><b>Android 13</b><br>API level 32
  -> 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)
* Deinstallieren Sie "Camera MX", diese Anwendung wird nicht mehr verwendet
* Fertig


== Anwendung installieren ==
=== MonDa (1. Generation) ===


* https://cargobay.orgamon.org/OrgaMon-App-2045.apk
* Turbo-Pascal-Entwicklung (i386 System unter MS-DOS)
* Transfer via der GSM-Modem Funktion von damaligen Handys


=== Berechtigungen setzen ===
{|
|[[Bild:6400.jpg|65px]]<br>Falcon i386 MS-DOS<br>Produktiv ab Juni 2002
|-
|}


<code>Einstellungen (Zahnrad) -> Apps -> OrgaMon -> Berechtigungen</code>
=== JonDa (2. Generation) ===


* alle zwei Berechtigungen "Kamera" und "Speicher" müssen aktiv sein
* J2ME Entwicklung
* Transfer via Internet Verbindung der Handys


=== OrgaMon-App Vordergrundzeit erhöhen ===
{|
|[[Bild:SX1_Front_a.jpg|65px]]<br>Siemens SX1 (Prototyp 2001)<br>
|[[Bild:6630.png]]<br>Nokia 6630 (bis 2007)
|[[Bild:NokiaN73-90x163.jpg]]<br>Nokia N73 (ab 2007)<br>Code 0541151<br>Version
|[[Bild:Nokia-2630.png|65px]]<br>Nokia 2630 (Ableser)<br>
|[[Bild:Nokia-6303.png|65px]]<br>Nokia 6303 (ab 2009)<br>
|-
|}
<br>


* ->Android-Einstellungen (Zahnrad)->Anzeige->Bildschirm-Timeout->auf 30 Min
[[JonDa.Anwender|Bedienungsanleitung für Monteure]]<br>
* 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.
[[JonDa.Zertifizierung|Zertifizierung]]<br>
[[JonDa.Setup Protokoll]]<br>
[[Foto]] [[Medien]]<br>


== offene Probleme ==
=== OrgaMon-App (3. Generation) ===


=== Android 11 ===
* interner Projektname war [[AmDa]], "OrgaMon-MOB"
* Java am Android-API Entwicklung
* Daten-Transfers via Internet Verbindung des Smartphones


* <s>Camera MX läuft nicht</s> stelle um auf OpenCamera (ab Rev. 2.044)
{|
* <s>Über das Intent kann man keine 3rd Party Camera App mehr starten</s> Lösung durch explizite Angabe "Open Camera" (ab Rev. 2.044)
|[[Bild:Samsung-galaxy3_i5800.jpg|65px]]<br>Samsung Galaxy 3<br>(Prototyp I ab 2011)<br>
* Hintergrund Prozess für den Upload wird willkürlich von Android 11 gestoppt
|[[Bild:Samsung-ace.jpg|75px]]<br>Samsung Galaxy ACE<br>(Prototyp II ab August 2011)
** Android 11 stoppt grundsätzlich den Hintergrundprozess wenn der Vordergrundprozess pausiert oder beendet wird
|[[Bild:Samsung-Galaxy-Ace-Plus.png|95px]]<br>Samsung Galaxy ACE Plus<br>(Produktiv seit Januar 2012)
** Workaround ist es zu versuchen dass OrgaMon-App möglichst immer im Vordergrund bleibt
|-
** ->Einstellungen->Anzeige->Bildschirm-Timeout->auf 30 Min
|[[Bild:Samsung-Galaxy-Ace-2.png|165px]]<br>Samsung Galaxy ACE 2<br>(Produktiv seit Oktober 2012)
|[[Bild:Samsung-galaxy-xcover-2.jpg|130px]]<br>Samsung XCover 2<br>(Produktiv seit Mai 2013)
|-
|[[Bild:ACE_3.png|95px]]<br>Samsung Galaxy ACE 3<br>(<u><b>Fokusprobleme</b></u> seit Oktober 2014)
|[[Bild:ACE_4.png|95px]]<br>Samsung Galaxy ACE 4<br>(Produktiv seit Februar 2015)
|[[Bild:XCover_3.png|95px]]<br>Samsung Galaxy XCover 3<br>(Produktiv seit Mai 2015)<br>Android 5.1.1<br>API level 22
|[[Bild:XCover_3.png|95px]]<br>Samsung Galaxy XCover 3 VE<br>(Produktiv seit Oktober 2016)<br>Android 6.0.1<br>API level 23
|-
|style="vertical-align:top;"|[[Bild:XCover_4b.png|85px]]<br>Samsung Galaxy XCover 4<br>(Produktiv seit April 2019)<br>Android 8.1.0<br>API level 27<br><b>Android 9.0.0</b><br>API level 28
|}


== Verbesserungsvorschläge ==
== Verbesserungsvorschläge ==
Zeile 315: Zeile 282:
* <s>ZZ=N soll wieder gelb werden</s>
* <s>ZZ=N soll wieder gelb werden</s>
* <s>Telefonnummer aus den Infos rauskopierbar</s>
* <s>Telefonnummer aus den Infos rauskopierbar</s>
* Zählerinfos vergrössern
* <s>Zählerinfos vergrössern</s>
* Zählernummer vergrössern
* Anzahl der ungesendeten Fotos in der Notification Number des Desktop Symbols
* BarCode umstellen auf
** https://developers.google.com/ml-kit/vision/barcode-scanning/android?hl=de
** https://developers.google.com/ml-kit/vision/barcode-scanning/code-scanner?hl=de
}}
}}

Version vom 10. Oktober 2023, 12:51 Uhr

  • 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

Infrastruktur


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
    • Slack
    • Open Camera (Mark Harmann)
    • ZXing Barcode Scanner (Firefox öffnen - als Standard-Browser auswählen - QR-Code scannen - zulassen - herunterladen - öffnen - Einstellungen - aus dieser Quelle zulassen auswählen - installieren)
    • Firefox
    • Das Örtliche-App
    • Wetter.com
  • 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
  -> 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 APIn ( ist automatisch ausgewählt)
 (zurück)
(zurück)
(Zulassen bei Benutzung der App)
  • ZXing
    • Alle Berechtigungen akzeptieren
    • Einstellungen, ganz unten 4 Kreuze raus (kein kontinuierlicher Fokus, keine Belichtungsmessung, keine Dosierung, kein Barcode-Szene-Modus), 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
  • [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

  • OrgaMon-App kann mit dem selben Handy unter verschiedenen Firmen-Kennungen betrieben werden
  • Eine Neuinstallation der App ist für einen Wechsel nicht nötig, in den Einstellungen können alle notwendigen Parameter verändert werden
  • Die IMEI wird dabei nicht verändert, ein intern Wert (SALT) identifiziert die Installation gegenüber dem Server
  • Monteure mit eigenen Geräte Nummern und IMEI müssen vertraglich im OrgaMon angelegt werden
  • Die Lizenzdateien (IMEI.csv, IMEI-OK.csv) müssen ausgespielt werden, und der cOrgaMon-Dienst muss neu gestartet werden


  • "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 Nummer 000 ein
  • Nun nochmals im Menü Senden, die Anzahl der Aufträge muss nun "0" sein


  • Geben Sie bei Firma:die Firmen-ID des gewünschten neuen Mandanten ein, <speichern>
  • Tätigen Sie nun Eingaben immer im Feld Geräte Nummer:
    • das zur Firma gehörige Passwort, danach <speichern>
    • 1000, danach <speichern>
    • gegebenenfalls Firmen-Optionen, danach <speichern>
    • Stellen Sie nun die Geräte-ID auf den richtigen, zum Monteur passenden 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 nicht stelle um auf OpenCamera (ab Rev. 2.044)
  • Über das Intent kann man keine 3rd Party Camera App mehr starten Lö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 13

  • ZXING Barcode Scanner wird nicht mehr angeboten (Lösung: Hosting auf cargobay)

Android Studio

  • Samsung Android Developer UBS Treiber benutzen
  • auf dem Handy "MIDI" ankreuzen

falsches apk-Dateiformat

  • ganzes "Build-Verzeichnis" komplett leeren (.\app\build\*)
  • "Build"->"Clean Project" machen
  • "Build"->"Build Bundels/APK"->Build APK machen
  • sicherstellen dass app\build\outputs\apk\debug\app-debug.apk die "richtige" Dateigrösse hat

Geblockte Fotos / Ausstehende Fotos

  • Der Fehler zeigt sich dadurch dass Foto-Dateien zwar von der OrgaMon-App gesehen - aber nicht umbenannt werden können
    • dadurch werden sie NICHT per FTP übertragen und verbleiben auf dem Handy
    • in älteren OrgaMon-App Versionen führte es dazu, dass diese Datei endlos übertragen wurde
    • Es gibt einzelne Geblockte Fotos, danach wieder Zeiten wo es funktioniert, es sind immer nur 1 oder 2 Dateien gestört
      • z.B. 8.12, 12.01, 15.06, 20.06., 22.06, 15.05, 26.06., 28.06
  • neue OrgaMon-App Versionen machen eine Test-Umbenennung in t<alter Dateiname> kurios: Es gibt fälle da gelingt die "t" Umbenennung noch, die "Rückumbenennung" nicht mehr!
  • Aktuelle Vermutung: Eine Cloud oder Backup-App könnte die Dateien ev. sperren, Gründe hierfür sind spekulativ


Aktuelle Lösung:

  • Wenn das Foto mit WLAN und Ladekabel nicht übertragen werden kann, mit *A* in MonteurInfo kennzeichen und entsprechend deklarieren
  • Monteur RID zukommen lassen, dass er das Foto auf dem Handy sucht
  • Monteur muss Foto per Mail zusenden und unter "J:\OrgaMon\Handy-Server\ftp" hinterlegen --> Orgamon wird simuliert, dass das Foto auf herkömmlichen Weg übertragen wurde --> Foto verschwindet bei den ausstehendes Fotos im App-Server-Dashboard
  • Bild wird automatisch der zugehörigen Internetablage zugeordnen - Foto über Transaktion LU1 auf J transferieren - Überprüfung mit Doppelklick im Protokollfeld, ob das Foto da ist - Datenmeldung auslösen
  • Überprüfung vom Monteur durch erneutes senden und start, ob das Foto noch auf dem Handy ist --> wenn das Foto noch auf dem Handy ist, muss dieses gelöscht werden!!!
    • Orgamon versucht ansonsten, immer wieder das Foto zu übertragen

Foto wird immer wieder übertragen

  • Wenn ein Foto X-Mal übertragen wird und immer wieder auf der Interablage der STW ist, muss der Monteur das Foto auf dem Handy löschen. Dadurch wird die Bildübertragung gestoppt.
  • in der Datei "J:\OrgaMon\Handy-Server\log\FotoService-Transaktionen.log.txt" (über Notepad öffnen) kann über die Suchfunktion - zählen nach dem RID gesucht und gezählt werden, wie oft das Foto schon übertragen wurde

Historie

  • OrgaMon-App ist der Nachfolger von JonDa
  • JonDa ist der Nachfolger von MonDa

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
Android 13
API level 32

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

Verbesserungsvorschläge