Collect will need to stop using /sdcard/odk for files

I had a great conversation with @Batkinson about this and a number of topics of common interest. After Wednesday's TSC call, the plan is to wait at least until Collect v.1.27 before releasing an API so that we can learn more about the needs of real users with integrations. @Batkinson found that reasonable. In the mean time, he and I will discuss any tentative plans we may have for the replacement API and try to make sure that the solution will be reusable for all.

Thanks, @Batkinson!

The migration implementation is now in beta. Learn more and try it out at ODK Collect v1.26 Beta 1: scoped storage migration.


Hi @ln,

Sorry for not replying, it seems my notifications are off & I'm late to the changes to getodk :smiley:

Ona is about to start adapting some of our apps, WHO Steps app, to using scoped storage & ensuring that the integrations to ODK Collect are updated. I found some code that generates a CSV used for the pulldata function in the form. We were solving the CSV media file hackily by adding it to the ODK form media folder. It seems that this is the only feature that does not use the ContentProvider or the activity hooks.

Do you have any ideas off the top of your head? If not, I can get back with several options later & we can see what would be good.

I don't have this in my brain anymore so definitely take my thoughts here with a grain of salt.

I think the general approach would be for external apps to hand Collect URI(s) to form definition and/or media files with permissions through an intent extra. I vaguely remember giving some thought to where this should go and I think my conclusion was that it should be a new, dedicated activity that takes whatever URI(s), copies the files into the Collect directory, registers them in the database and generally gets them ready for use.

Even though you're only looking to register media files (in this case a CSV) with Collect, I think the solution design should also include registering a form definition. Those are tightly related and we'd want to make sure that they're handled coherently. Additionally, whatever we come up with, we should then later be able to add something symmetrical for handing submissions to Collect.

Would be great to see some of your ideas.

This is a much more well thought out & it makes clear sense. Let me collect my thoughts and see what I can come up with

1 Like

@Kigamba, here is the release timeline we're looking at:

  • v1.28 released ~mid August with message that v1.29 will force the migration
  • v1.29 released ~mid October that forces the migration on first app launch

You can read more in the Collect issue to change the banner text.

That means if you do still want to add support for external applications handing form definitions and media files to Collect, there should be a proposed approach by mid-August at the latest (in time for v1.29 planning). A PR in mid-September would be ideal so there's plenty of time to go through quality assurance. The last chance to get a PR in would probably be the last week of September.


is that why I have been unable to submit my data since yesterday? (9/07/2020)

@LN Thanks for the update. I'm working on getting resources allocated so that I can start on this. I think that the September deadline is considerate enough. The August timeline for proposing an approach also sounds good. Sorry for the silence on my end. I'll communicate in due time. Thanks again for the update

1 Like

Hi @Agumash
I can assure you it's not related. Maybe there is something wrong with your server. Please create a separate topic if you can't solve your problem by yourself.

BTW welcome to the forum! Please introduce yourself here!

Welcome to the community @Agumash

@LN :disappointed: I couldn't get the resources to work on it now. We'll reach out when the situation changes & I get a go-ahead

:smiley: We also discovered that the files are accessible for some android versions inside the /data folder. However, they are private on Android 9. The support team & some users tend to copy over the failed submissions for sending with ODK Briefcast on a computer

Did you use the documented path and adb? What precisely do you see when you attempt access?

Thanks for that. I can access the submissions now both through the file manager and ADB. :man_facepalming: It seems that I had forgotten to perform the migration on the Android 9 device while testing on the devices. Sorry for that :pray:. Thanks again

1 Like