How to use Enketo off-line on Android phones?

[QLands Software]

Hello,

I have an Enketo 2.X running and I am able to use a WebForm from my Android browser but if I am offline and try to go to the link the browser indicates No Internet. I tried to download the form locally but when I open it offline I cannot type anything or select anything, its like read only.

I saw the blog https://enketo.org/faq/#offline-use  about an icon in the top left of the page, but such icon does not appear.

Is there any documentation on how to achieve offline mode?

Thanks.

[Martijn van de Rijdt]

Hi QLands,

Enketo offers different views of the same webform some online-only and some offline-capable. It's up to the data/form server that integrates with Enketo to decide which of these they expose to users (and how to make this clear to users). So e.g. KoBoToolbox.org and Ona.io have used these since the beginning, but e.g ODK Central has not yet done this (though to be added soon maybe?). ODK Aggregate can be configured to use either online-only or offline-capable views.

If you're using ODK Aggregate use /api/v1 instead of /api/v2 in the Enketo settings in Aggregate.

I hope this helps,

Cheers,

Martijn

--
You received this message because you are subscribed to the Google Groups "enketo-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to enketo-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/enketo-users/32a2c25d-c4b5-4091-9628-feec15566716n%40googlegroups.com.

--

Pushing data since 2012.

Enketo    |    LinkedIn    |    GitHub    |    Twitter    |    Blog

-- 

Revolutionizing data collection since 2012.

Enketo    |    LinkedIn    |    GitHub    |    Twitter    |    Blog

[QLands Software]

Hi Martin,

Thank you for your reply. 

I am integrating Enketo with a FormShare server (https://github.com/qlands/FormShare). I already developed the basic integration but not the off-line. Do you have any documentation on how to integrate Enketo for off-line usage? I can see offlineWebform controller in the technical docs and a message in the code "Offline functionality has not been enabled for this application" but I really don't know the routes for the offline access or how to make a form off-line capable.

Many thanks for any help.

[Martijn van de Rijdt]

Absolutely! Here are all the different webform views you could expose: https://apidocs.enketo.org/v2

For offline-capable multi-submission views use: https://apidocs.enketo.org/v2#/post-survey-offline

Good luck!

To view this discussion on the web visit https://groups.google.com/d/msgid/enketo-users/f1756aad-984a-4192-a3b1-3c484cec61f5n%40googlegroups.com.

[QLands Software]

Excellent. We updated our integration and now the off-line mode works fine.

Many thanks.

[Saad Omer]

Hi Martin,

I have an ODK server running and integrated to Enketo standalone installation. The forms work fine from web browsers (enketo pulls form from ODK, and submissions reach to ODK aggregate successfully), however I do not see the OFFLINE WORKING icon on the top left in the browser. Is there any special settings I have to do in ODK Aggregate (or the form coding) to enable offline storage? I am using latest aggregate version (v2.0.5) and using /api/v1 in ODK aggregate enketo configration as well. Can you suggest what step is missing?

Many thanks,
Saad

[Martijn van de Rijdt]

Hi Saad,

Are you running a recent version of Enketo Express? If not, the issue is described here: https://blog.enketo.org/Enketo-Express-mar-2020-update/.

To rule out any issues with the browser you can test this form: https://enke.to/x/widgets

To view this discussion on the web visit https://groups.google.com/d/msgid/enketo-users/5b8c93b2-c873-4267-ab91-e27902c5f44cn%40googlegroups.com.

[Saad Omer]

Hi Martin,

Yes, I am running the latest enketo express version (version: 2.6.3-1-g947dbce), installed fresh yesterday.

All the browsers which I used to check my own installation, are working fine with your given URL; meaning that I can see the OFFLINE STORE orange icon at top-left. But still unable to see it on my installation. Can you have a look at http://13.244.220.67:8005/x/xVkyUZDm please? Thanks!

The few differences I can highlight, are that I am not using SSL as well as domain name (for now, only. Will assign later). Is either of these things related to the error?

Thanks,

Saad 

[Saad Omer]

I just checked details. I see 2 errors in developer console:

>enketo-webform-bundle.min.js:104 Service workers not supported on this http URL (insecure)

>locales/build/so/translation-combined.json:1 Failed to load resource: the server responded with a status of 404 (Not Found)

I guess the first one is causing the issue for being non-SSL, is it?

[Martijn van de Rijdt]

Hi Saad,

Yes, the issue is with SSL. Offline capability is using Service Workers: https://developers.google.com/web/fundamentals/primers/service-workers#you_need_https. 

You can however, test your site's offline-capability on http://localhost as well.

The 404 is from a missing Somali translation and I think this can be ignored. Somali would be very welcome though! => https://www.transifex.com/enketo/enketo-express/

[Saad Omer]

Hi Martijn,

So I installed the SSL certificate for the enketo installation. My enketo domain on the main page shows https connection. However, the form page on port 8005 is still on http:// connection, and does not work if I enter https:// (meaning, still no offine working capability). Can you give an idea about where to make this config to make it work?

Thanks,

Saad

[Martijn van de Rijdt]

Hi Saad,

This is a generic web server (NGINX or Apache) technique that is not related to Enketo in particular. However, please find an example here (using NGINX): https://blog.enketo.org/install-enketo-production-ubuntu/.

Good luck,

Martijn

To view this discussion on the web visit https://groups.google.com/d/msgid/enketo-users/36b8a7a4-5826-4311-9d4d-ce9b8b801f43n%40googlegroups.com.