advoware mobile (Leitfäden)

Bitte bei Abstürzen den Punkt "Abstürze"!


Passwörter / Passwort vergessen

Passtwort der Kanzleikennung

advoware Kanzleisoftware → Aktenverwaltung → Systemfreischaltung → advoware online Akte → im Browser: "Kenntwort vergessen"

Dies erfordert die Änderung des Passwort im advoware Manager und im Freigabedienst, wenn der Kunde die entsprechenden Produkte nutzt. 

Passwort des Mitarbeiters

advoware Kanzleisoftware → Grundeinstellungen → Kanzleiorganisation → Mitarbeiter → Mitarbeiter auswählen → "Passwort online Akte" neu setzen → mit "Ok" bestätigen

Das neu gesetzte Passwort ist sofort gültig. 


Abstürze

Aktuell sind uns in der App einige Abstürze bekannt. Hauptsächlich betroffen ist das iOS-Betriebssystem. Zum einen liegt dies daran, dass das iOS-Betriebssystem unter unseren Kunden eine größere Beliebtheit genießt zum anderen, weil Apple sehr restriktiv ist. 

Die App sammelt bei einem Absturz oder bei einem fehlerhaften Verhalten Daten und übermittelt diese an uns. Im Falle von Abstürzen werden diese Absturzberichte erst NACH ERNEUTEM öffnen der App übertragen, sofern eine Internetverbindung vorhanden ist.

Was wir übermitteln

Wir übermitteln unter anderem

  • in welcher Methode der Fehler auftrat, z.B. beim Öffnen einer Datei oder beim Download einer Datei

  • gehashte Dateinamen (der eigentliche Dateiname ist NICHT ersichtlich!) → z.B. 12AB-35CE-58BA-49TE.pdf

  • in welchem Web-Zugriff/welcher Web-Aufruf durchgeführt wurde als das Problem auftrat

Was wir zukünftig übermitteln wollen

  • Kanzleikennung

  • Mitarbeiterkürzel

Das hilft uns im Falle einer Fehlermeldung die spezifische Fehlermeldung eines Kunden zu finden und eventuell genauere Informationen zu erhalten.

Was wir NICHT übermitteln

  • Passwörter

  • Konkrete Daten, z.B. Namen oder sonstige Inhalte einer Akte, Aktengeschichte oder von Beteiligten

Abstürze beim Öffnen von Dateien (Aktengeschichte)

Folgendes gilt zuerst zu prüfen:

  1. Handelt es sich um eine passwortgeschützte PDF-Datei → wenn ja, ist die advoware mobile auf Version 1.63 oder höher aktualisiert worden?

  2. Handelt es sich um eine PDF/A-Datei?

  3. Wie groß ist die PDF-Datei?

    1. ab ~100 MB pro Datei 

      1. ist dies auf iOS Geräten nach 2017 bisher scheinbar problemlos möglich (i.d.R. mindestens 2-3 GB Arbeitsspeicher)

    2. ab ~500 MB pro Datei muss das Gerät entsprechend mindestens mindestens

      1. 3 GB Arbeitsspeicher haben um überhaupt zu laufen (Abstürze möglich)

      2. 4 GB Arbeitsspeicher haben um zuverlässig zu laufen (Abstürze unwahrscheinlich)

Arbeitsspeicher prüfen

Bei Apple's iPads und iPhones wird die Menge des Arbeitsspeichers auf der offiziellen (deutschen) Seite nicht angegeben. Auf den englischen Wikipedia-Seiten zu "iPhone" und "iPad" bzw. "iPhone models" oder "iPad models" gibt es genaue Tabellen die alle technischen Daten sehr ausführlich enthalten.

Bei Android-Geräten wird dies in der Regel immer auf den technischen Spezifikationen zu den Geräten kommuniziert.

Wenn obiges ausgeschlossen werden kann, könnte das Caching/die Offline-Fähigkeit das Problem sein. Dazu folgendes probieren:

  1. Kurzfristigen Zugang erfragen, sodass man sich selber in der mobile App anmelden kann

  2. Probieren ob das Problem hier ebenso auftritt

    1. wenn ja → dann ist es ein generelles Problem und hat vermutlich nicht zwingend etwas mit dem Cache/der Offline-Fähigkeit zu tun

    2. wenn nein → dann ist es die Installation auf dem spezifischen Gerät. Eventuell ist etwas schiefgelaufen.

Wenn der Fall 2b Eintritt folgendes auf dem Gerät des KUNDEN testen:

  1. andere Dateien probiert: lassen sich alle Dateien nicht öffnen, lassen sich bestimmte Dateien nicht öffnen

  2. lassen sich immer wieder dieselben Dateien nicht öffnen oder wechselt dies (hier beim Testen Akte nicht löschen oder den Umstand verändern, also nicht die Internet-Konnektivität verändern oder ähnliches!)

  3. offline-fähige Akte löschen

  4. versuchen die problematische Datei erneut aufzurufen: hat dies funktioniert?
    Hier bitte beobachten ob kurz ein "BITTE WARTEN" angezeigt wird oder nicht. Ist die Akte gelöscht sollte sie erneut vom Server abgefragt werden, sofern sie nicht noch gecached wurde. 

  5. die Akte erneut offline-fähig gemacht

  6. erneut versuchen die problematische Datei aufzurufen: hat dies funktioniert?

Beachtet man die Reihenfolge und kann man

  • Punkt 4 und 6 mit ja beantworten → dann liegt es an einem Problem beim Download oder mit dem Cache/der Offline-Fähigkeit zusammen

  • Punkt 4 und 6 mit nein beantworten → dann sind entweder nicht alle Dateien durch die App bereinigt worden oder es besteht (auch) noch ein Problem mit dem advoware Dienstmanager (connector)

  • Punkt 4 mit ja und Punkt 6 mit nein beantworten → dann gibt es ein Problem während des Mechanismus "Akte herunterladen/offline verfügbar machen"


Leere Nachrichten-Seite / "Dieser Chat existiert bereits"

Es gab ein Problem, dass in advoware mobile die Nachrichten-Seite als leere Seite (weiße Seite) angezeigt wurde, also keine Konversationen sichtbar waren und ggf. wenn man einen neuen Chat starten wollte die Fehlermeldung kam "Dieser Chat existiert bereits". Das kann mehrere folgende Gründe haben:

  1. Die Datenbank ist veraltet und hat nicht die empfohlene Version 12.x.x

  2. Ein Mitarbeiter wurde gelöscht → dieses Problem ist in dem neuen advoware Dienstmanager Version x.xx behoben worden

  3. Ein leerer Chat → dieses Problem wird mit dem kommenden advoware mobile Update auf Version 1.63 behoben


"Das Dokument konnte nicht geladen werden."

Im Connector ist die Pfadersetzung korrekt eingetragen. Trotzdem kann das Dokument über advoware mobile nicht aufgerufen werden.

Wenn in der Datenbank der Schriftverkehr über einen UNC-Pfad eingefügt wird, muss beim advoware Manager Dienst unter Eigenschaften ein User eingetragen werden, der die Berechtigung zu den UNC Pfaden hat. (z.B. Administrator)


"Das Dokument konnte nicht geladen werden."

Dieser Fehler tritt in der Regel auf, wenn eine Akte früher einmal offline-fähig (also heruntergeladen) wurde mittlerweile aber teilweise oder vollständig vom Gerät gelöscht wurde. Die App denkt die Datei wäre lokal vorhanden und müsse nicht heruntergeladen werden. 

Hier hilft aktuell nur eine Neuinstallation der App. Wir arbeiten an einer Lösung mit dem nächsten Update. 


"Das Dokument konnte nicht geladen werden."

In der App können, nach Serverumzug, nicht alle Dokumente geöffnet werden.

Lösung: Es sind nicht alle Dokumente auf dem Server oder befinden sich an einem anderen Speicherplatz.


"Verbindung konnte nicht hergestellt werden."

Wenn der Manager kann sich durch mehrere Versuche (z.B. den gesamten Tag) mit unserem Server nicht verbinden kann, es vorher aber problemlos ging.

Ursache:

Der Server wird gehindert, sich mit unserem zentralen relay-Server zu verbinden, in der Regel durch eine Firewall.

Lösung:

Den Port 90 muss in Firewall freigegeben werden.

 


"Die Nachricht konnte nicht versendet werden."

Ein Grund für das auftreten dieses Fehlers ist, wenn die Datenbankstruktur nicht auf dem aktuellen Stand ist. Im connector-Log erscheint dann bei "postMessageToChat": 

CallFunction: Error: 00331 EXE NEV Not enough non-null values

Mit Stufe.exe die Datenbank zurücksetzen und durch advoware aktualisieren zu lassen kann das Problem beheben. Die richtige Versionsnummer für die Angabe bei Stufe.exe: ?noch eintragen!!


Anmeldung an der App nicht möglich

Eine nicht funktionierende Anmeldung an der App kann mehrere Ursachen haben. Einige Möglichkeiten, bitte möglichst in der Reihenfolge prüfen:

  1. Anmeldedaten prüfen

    1. Bei der Datenbank, Kanzleikennung und dem Kürzel ist die Groß-/Kleinschreibung von Bedeutung

    2. Nutzt der Kunde den Mitarbeiternamen oder das Mitarbeiterkürzel zur Anmeldung? Wir empfehlen IMMER das Kürzel!

    3. Das Passwort wird in advoware Kanzleisoftware unter "Passwort online Akte" gesetzt.

    4. Enthält das Passwort ggf. unübliche Sonderzeichen? 

  2. Ist der connector (ggf. advoware service) gestartet? → kann per Windows "Dienste" bzw. dem advoware Manager geprüft werden

  3. Ist der connector-Port freigegeben? → eine eingehende Ausnahme in der Windows-Firewall wird vom connector erstellt, ggf. läuft noch eine zusätzliche Firewall?

  4. Prüfen ob in dem Verzeichnis "%ProgramData%\Advo-web GmbH\Logs\" eine Log Datei namens "Connector-ZEITSTEMPEL.log" oder "KANZLEIKENNUNG-ZEITSTEMPEL.log" von heutigem Tag vorhanden ist

    1. wenn nein → connector läuft nicht mehr, Dienst muss neugestartet werden (siehe Nr. 5 in dieser Liste)

    2. wenn ja → connector läuft noch; andere Ursache, Liste weiter abarbeiten

  5. Ggf. den Dienst "advoware service" (bis 1.4.0) oder "advoware Manager" (ab 2.0.x) neustarten und nach ca. 30 Sekunden prüfen ob Anmeldung möglich ist

  6. Ist das Relay vom connector erreichbar? → andernfalls gibt es eine Meldung, dass der Host nicht erreicht werden konnte

  7. Log-Datei unter "%ProgramData%\Advo-web GmbH\Logs\" prüfen, Datei heißt "Connector-ZEITSTEMPEL.log" oder "KANZLEIKENNUNG-ZEITSTEMPEL.log"

  8. Taucht folgende Meldung oder eine ähnliche im connector-Log auf: "Fehler beim Initialisieren der Datenbank "ADVOWARE": "09841 PRS PKN Primary key not defined in parent table" → das bedeutet in den meisten Fällen, dass der connector aus irgend einem Grund die Chat-Tabellen nicht anlegen konnte. DIe Tabellen müssen manuell angelegt werden (Chat-Tabellen neu Anlegen). Allerdings führt dieser Fehler nicht zu der Meldung "Anmeldung an der App nicht möglich" und advoware mobile sollte trotzdem funktionieren (bis auf die Nachrichten).

  9. Klappt die Anmeldung nicht und es sind keine weiteren Fehlermeldungen vorhanden gibt es zwei weitere Möglichkeiten:

    1. Bei uns auf dem relay-Server im Log schauen, wenn man die Kanzleikennung weiß → www2.advo-net.org (Pfad: "D:\Renowin\Logs\Relay"), dort die aktuelle "Relay-ZEITSTEMPEL_NR.log" suchen und nach Kanzleikennung suchen

    2. Die Konfiguration des connectors beim Kunden ändern:

      1. Öffnen der Datei: %ProgramData%\Advo-web GmbH\Connector\configs\default\appsettings.json (default heißt ggf. anders, z.B. Kanzleikennung)

      2. In der Datei unter "MinimumLevel → Default" den Wert von "Information" auf "Debug" setzen + unter "WriteTo → Args → restrictedToMinimumLevel" den Wert von "Information" auf "Verbose" setzen (siehe Grafik unten).

      3. Danach den Dienst "advoware Manager" oder "advoware service" neustarten → ca. 15 Sekunden warten

      4. Anmeldung in der mobile App erneut versuchen

      5. Nun erneut in die Log-Datei schauen und nach Fehlern suchen

      6. Nicht vergessen: die beiden geänderten Werte zurück auf "Information" zu setzen, da ansonsten große Logs beim Kunden generiert werden → Dienst neustarten!


09841 PRS PKN Primary key not defined in parent table

Wichtig:

Der Kunde benötigt eine Datenbankversion 12.x.x damit diese Funktionalitäten laufen!!! Ansonsten braucht man die Tabellen NICHT versuchen anzulegen!

Es gibt Probleme bei den Chat-Tabellen die neu angelegt werden müssen. Indizes bezüglich Performance nicht vergessen. Dieses Problem sorgt allerdings NUR dafür, dass NACHRICHTEN nicht genutzt werden können in advoware mobile. advoware mobile an sich funktioniert trotz dieses Fehlers!

Chat-Tabellen neu Anlegen

Warum dieses Problem bei manchen Kunden auftritt und bei anderen nicht, ist derzeit nicht bekannt. 


AW Mobile zeigt nur eine Datei an, egal was ausgewählt ist.

Neuinstallation der Anwendung auf dem Mobilgerät.

 


Kalender

Der Kalender in advoware mobile ist lediglich eine Verlinkung zum betriebssystemeigenen Kalender und hat nichts mit mobile zu tun. Hier ist das Stichwort: smartphoneKalender. 

 


Anmeldung fehlgeschlagen - "Value cannot be null. (Parameter 'key')"

in der Tabelle “Referate“ oder “Mitarbeiter” gibt es einen Eintrag, bei dem das Kürzel nicht eingetragen ist und leer bleibt.

um die Tabelle zu identifizieren:

select * from referate where kuerzel is null; select * from mitarbeiter where kuerzel is null;

Dann sollte dieser Eintrag per SQL-Talk entfernt (falls nicht verwendet) oder aktualisiert werden.

 


"Die Akte kann nicht angezeigt werden, bitte überprüfen sie die Internetverbindung"

Einloggen in die advoware mobile ist nicht möglich.

Lösung:

select * from referate where kuerzel is null;

Wenn der Wert größer 0 ist. Muss folgenden eingegeben werden.

delete from referate where kuerzel is null; commit;

Es ist notwendig sich mit SQL-Talk und dem Datenbankpasswort einzuloggen. Dies ist nur über die Hotline möglich.

 


“…Aktengeschichte Eintrag … existiert nicht”

Diese Meldung kann diverse Ursachen haben bedeutet aber es ist etwas mit den Pfaden. Dies kann mehrere Ursachen haben:

  1. Pfadersetzung ist falsch eingerichtet, zeigt auf einen falschen Ordner

  2. Hat der Kunde mehrere Standorte fehlt ein Eintrag in der Systemtabelle

  3. Weitere Gründe