Transactions en attente en JMap Survey / Pending transactions in JMap Survey

Owned by Gabriela Orzanco
Last updated: Jun 08, 2020
5 min read

 

Produit concerné / Related product

JMap Survey

Versions

7

 

Jump to English version


Différentes situations peuvent provoquer que les transactions effectuées en JMap Survey demeurent en attente de transfert à JMap Server.

Deux situations sont fréquentes :

  • Vous travaillez en mode connecté en JMap Survey mais à un moment donné la connexion à JMap Server est interrompue (faible signal, perte de signal, etc.).
    Les transactions que vous effectuez pendant que la connexion est coupée ne peuvent pas avoir lieu.
    Lorsque la connexion est rétablie vous ne connaissez pas en détail les transactions qui ont été transférées et les transactions qui ont été perdues.
    Vous avez une perte de données sans information sur les données perdues.

  • Une raison inconnue fait que les transactions demeurent en attente même si la création et modification d’objects cartographiques s’effectue sans message d’erreur.
    Parfois les caractéristiques des champs des formulaires JMap entrent en conflit avec les caractéristiques du champ correspondant dans la base de données dans laquelle les données sont stockées. Des différences de précision ou de longueur de caractères peuvent être en cause. Par exemple, un champ texte dans le formulaire de JMap Survey permet 255 caractères mais ce champ dans la base de données permet 50 caractères. Les valeurs que vous entrez dans le formulaire peuvent dépasser les 50 caractères et produite un conflit qui entraine la mise en attente de la transaction.
    Une fois qu’une transaction est en attente, les transactions suivantes ne peuvent être traitées et transférées de JMap Survey à JMap Server.

Cet article décrit la procédure pour accéder aux données de toutes les transactions effectuées avec JMap Survey, lesquelles sont stockées dans votre téléphone intelligent.

Guide étape par étape

Si vous travaillez avec un appareil iOS

  1. Ouvrez l'appareil avec iExplorer (https://macroplant.com/iexplorer).

  2. Trouvez le répertoire Backup Explorer/App/jmapsurvey/Library/Application Support.

  3. Sur le fichier Jmap.sqlite, faites un clic droit et sélectionnez Export Jmap.sqlite to PC.

  4. Ouvrez le fichier Jmap.sqlite.  Vous pouvez utiliser Sqlite Browser (https://sqlitebrowser.org/dl/).

Si vous travaillez avec un appareil Android

Note: À partir de la version 1.0.18,  JMap Survey pour les appareils Android inclut une nouvelle fonctionnalité, Inspecteur des modifications en attente. Cette fonctionnalité permet à l'utilisateur d'identifier les objets de la carte qui causent des problèmes, de les localiser dans la carte et de modifier leurs valeurs pour les rendre valides et pouvoir ainsi enregistrer leurs données dans la base de données de leurs respectives source de données.

Deux scénarios sont possibles :

Scénario 1 : Appareil Android avec permission ROOT

  1. Installez une application de gestion de fichiers (e.x. ES File Explorer).

  2. Accédez au système de fichiers et accédez à /data/data.

  3. Recherchez le dossier de l'application JMap Survey dans le dossier nommé en tant que package contenant l'activité Android par défaut com.k2geospatial.jmap.

  4. Entrez dans le dossier des bases de données databases.

  5. Copiez le fichier map_cache.db sur la carte mémoire.

  6. Connectez l'appareil à l'ordinateur et copiez le fichier au bureau.

  7. Ouvrez le fichier sqlite Jmap, vous pouvez utiliser le navigateur Sqlite (https://sqlitebrowser.org/dl/).

 

Scenario 2 : Appareil Android sans permission ROOT

  1. Installez ADB ou AndroidStudio. ADB est un outil de gestion des appareils Android et des émulateurs connectés ou en cours d'exécution sur l'ordinateur.

  2. Connectez l'appareil et activez le débogage USB.

  3. Ouvrez un terminal MS-DOS et tapez adb devices. Si l'appareil est correctement connecté, il doit avoir le nom de l'appareil dans le terminal.

  4. Tapez adb shell pour ouvrir un terminal sur l'appareil.

  5. Tapez su pour avoir des autorisations ROOT sur l'appareil.

  6. Accédez au dossier /data/data avec la commande cd /data/data.

  7. Cherchez le dossier d'application. JMap Survey se trouve dans le dossier nommé en tant que package contenant l'activité Android par défaut com.k2geospatial.jmap.

  8. Entrez directement dans le package puis dans le dossier des bases de données cd com.k2geospatial.jmap/databases.

  9. Listez le contenu de ce dossier avec ls. Vous devriez trouver un fichier appelé map_cache.db.

  10. Copiez ce fichier à la racine de la carte mémoire de votre appareil avec cp map_cache.db /sdcard/map_cache.db.

  11. Quittez ADB avec Ctrl + C.

  12. Copiez le fichier sur votre bureau avec adb pull /sdcard/map_cache.db.

  13. Pour ouvrir le fichier sqlite Jmap, vous pouvez utiliser le navigateur Sqlite (https://sqlitebrowser.org/dl/).

 

English version

Different situations can cause transactions made in JMap Survey to remain pending transfer to JMap Server.

Two situations are frequent:

  • You work in connected mode in JMap Survey but at some point the connection to JMap Server is interrupted (weak signal, loss of signal, etc.).
    Transactions you make while the connection is down cannot take place.
    When the connection is restored you do not know in detail the transactions which have been transferred and the transactions which have been lost.
    You have data loss without information about the lost data.

  • There is an unknown reason that the transactions remain pending even if the creation and modification of cartographic objects is carried out without error message.
    Sometimes the characteristics of the fields in JMap forms conflict with the characteristics of the corresponding field in the database in which the data is stored. Differences in precision or character length may be involved. For example, a text field in the JMap Survey form allows 255 characters but this field in the database allows 50 characters. The values ​​that you enter in the form can exceed 50 characters and produce a conflict which causes the transaction to be put on hold.
    Once a transaction is pending, the following transactions cannot be processed and transferred from JMap Survey to JMap Server.

This article describes how to access data from all transactions made with JMap Survey, which are stored on your smartphone.

Step by step guide:

If your work with an iOS device

  1. Open the device with iExplorer (https://macroplant.com/iexplorer).

  2. Find the folder Backup Explorer/App/jmapsurvey/Library/Application Support.

  3. Right click the Jmap.sqlite file and select Export Jmap.sqlite to PC.

  4. Open the Jmap.sqlite file. You can use Sqlite Browser (https://sqlitebrowser.org/dl/).

If you work with an Android device

Note: After JMap Survey version 1.0.18, a new feature called Pending Changes Inspector is included. This feature allows the user to see what are the JMap elements that are causing problems, locate them in the map and modify their values to make them valid and be able to save their data in the datasource's database.

Two scenarios are possible:

Scenario 1: Android device with Root permission

  1. Install a file management application (e.x. ES File Explorer)

  2. In the Fyle System section enter the folder /data/data.

  3. Search for the JMap Survey's application folder. It is located in a folder named after the package that contains the default Activity, com.k2geospatial.jmap.

  4. Enter into the databases folder

  5. Copy the file map_cache.db to the sdcard

  6. Connect the device to the computer and copy the file to your desktop 

  7. To open the SQLite file, you can use SQLite Browser (https://sqlitebrowser.org/dl/)

 

Scenario 2: Android device without Root permission

  1. Install ADB or AndroidStudio, ADB is a tool to manage devices or emulators that are running or connected to the computer.

  2. Connect the device to the computer and enable USB Debugging.

  3. Open a MS-Dos Terminal and write adb devices. If the device is correctly installed, you should see the name of the device in the Terminal console.

  4. Type adb shell to open a linux terminal in the device.

  5. Type su to gain ROOT access to the device.

  6. Access to the folder /data/data with the command cd /data/data.

  7. Search for the JMap Survey's application folder. It is located in a folder named after the package that contains the default Activity, com.k2geospatial.jmap.

  8. Enter directly into the package and the databases folder cd com.k2geospatial.jmap/databases.

  9. List the content of the folder with ls. You should see a file named map_cache.db.

  10. Copy this file to the root of the sdcard cp map_cache.db /sdcard/map_cache.db.

  11. Quit ADB with Ctrl + C.

  12. Copy the file to your Desktop with the command adb pull /sdcard/map_cache.db.

  13. To open the SQLite file, you can use SQLite Browser (https://sqlitebrowser.org/dl/).