ODK Survey 2.0 Back button issue with linked tables

Have developed a tables app that uses linked tables in the survey for repeat groups. When using the back button sometimes it will bring up a list of choices to go back to as opposed to going back to the previous screen.

Is this a known bug or a maybe bug in my application?

Has anyone else seen a similar issue.

It seems to happen mostly when in a linked table in the survey and then trying to go back to a previous screen that is not in the linked table/survey.

Any help is appreciated.

Thanks,
tom

The back button is problematic in ODK Survey. I have the same thing, using
a very large and complex survey with many linked tables.
The good news is that ODKS is very good about saving data to the database
as you go along, and so even if you pop out of the section you are in, you
will not lose any data.
The key is to make a good table of contents with meaningful labels so that
users can navigate between sections, make this kind of navigation a part of
your training so that users learn to move between sections.
~Neil

☞§※☼:airplane::open_umbrella::slight_smile:
~Neil

··· On Thu, Jun 4, 2015 at 9:55 PM, <7shriner@gmail.com> wrote:

Have developed a tables app that uses linked tables in the survey for
repeat groups. When using the back button sometimes it will bring up a
list of choices to go back to as opposed to going back to the previous
screen.

Is this a known bug or a maybe bug in my application?

Has anyone else seen a similar issue.

It seems to happen mostly when in a linked table in the survey and then
trying to go back to a previous screen that is not in the linked
table/survey.

Any help is appreciated.

Thanks,
tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

"The key is to make a good table of contents with meaningful labels ..."

Can you describe how this is done in a nutshell? Where / how can the table of contents and labels be enhanced this way. That sounds like the exact solution that would make it less confusing tho the end user.

Thanks for the response.

I will get a screenshot (ASAP) and attach to the thread.

Thanks again,
tom

Yes, it does seem to go back to the Contents screen.

Is specifying a content branch label documented or does one of the examples show how to modify the contents as you indicate?

When you say "screen" what is the definition of "screen"? Do I add a _contents label in the form's XLS?

Thanks much- I have included a screen shot - but I believe it is doing as you have indicated and going back to the contents screen.

The behavior seems inconsistent - sometimes it goes back to the previous screen and sometime the Contents screen. Is the reason for that a known issue?

tom

Thanks Mitch. I looked at the references you provided and tried various things using hideInContents, and the hideInBackHistory columns.

What is the syntax for the sheet if using the _contents ? What column / syntax is used for the "screen"?

E.G. if I want the contents to list n screens what would the _contents look like for SCREENJ,SCREENK..SCREENN?

Can screen names be used globally or are they local to a sheet?

Does the _contents override the hideincontents or do they interact?

Sorry for all the questions, I don't think the XLSConverter docs cover all these things - is there any other doc or examples where they might be covered ?

Thanks again,
tom

Thanks! These answers solved all the issues.
tom

··· On Thursday, June 4, 2015 at 8:55:43 PM UTC-5, 7shr...@gmail.com wrote: > Have developed a tables app that uses linked tables in the survey for repeat groups. When using the back button sometimes it will bring up a list of choices to go back to as opposed to going back to the previous screen. > > Is this a known bug or a maybe bug in my application? > > Has anyone else seen a similar issue. > > It seems to happen mostly when in a linked table in the survey and then trying to go back to a previous screen that is not in the linked table/survey. > > Any help is appreciated. > > Thanks, > tom

If you could send a screen shot of that screen, it would be helpful.

You might be getting the checkpoint resolution screen.

··· On Fri, Jun 5, 2015 at 6:47 AM, Neil Hendrick wrote:

The back button is problematic in ODK Survey. I have the same thing, using
a very large and complex survey with many linked tables.
The good news is that ODKS is very good about saving data to the database
as you go along, and so even if you pop out of the section you are in, you
will not lose any data.
The key is to make a good table of contents with meaningful labels so that
users can navigate between sections, make this kind of navigation a part of
your training so that users learn to move between sections.
~Neil

☞§※☼:airplane::open_umbrella::slight_smile:
~Neil

On Thu, Jun 4, 2015 at 9:55 PM, 7shriner@gmail.com wrote:

Have developed a tables app that uses linked tables in the survey for
repeat groups. When using the back button sometimes it will bring up a
list of choices to go back to as opposed to going back to the previous
screen.

Is this a known bug or a maybe bug in my application?

Has anyone else seen a similar issue.

It seems to happen mostly when in a linked table in the survey and then
trying to go back to a previous screen that is not in the linked
table/survey.

Any help is appreciated.

Thanks,
tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

Within each section, you can override the Contents menu and supply your own
screen (or even a navigation of screens) by specifying a "_contents" branch
label.

The screen at that label is the screen that will be displayed when the user
selects Contents.

By default, that screen is a single prompt of type 'contents' that renders
all the questions and values in the section (and all sub-sections).

··· On Fri, Jun 5, 2015 at 4:43 PM, <7shriner@gmail.com> wrote:

"The key is to make a good table of contents with meaningful labels ..."

Can you describe how this is done in a nutshell? Where / how can the
table of contents and labels be enhanced this way. That sounds like the
exact solution that would make it less confusing tho the end user.

Thanks for the response.

I will get a screenshot (ASAP) and attach to the thread.

Thanks again,
tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

By 'screen', I mean the collection of prompts that are displayed together
on a single page. e.g., bracketed by begin screen ... end screen
directives (the replacement for the field-list groups of ODK 1.0). See
https://opendatakit.org/use/2_0_tools/odk-application-designer-2-0-rev126/odk-xlsxconverter-2-0-rev126/#creatingASimpleSurveyForm

The 'back' button is not a 'go to previous question' button. It remembers
your navigation path through the form and backs you up through that path.
If you got somewhere via the contents screen, when you back up, you will be
returned to the contents screen. You can hide a screen from the back
history by placing TRUE in a column called 'hideInBackHistory' for a "begin
screen" clause, or in a column called 'screen.hideInBackHistory' for a
prompt not contained within a screen.

The _contents label would be added in the XLS sheet for each section that
you wanted to customize. This would be in the column titled
'branch_label' see
https://opendatakit.org/use/2_0_tools/odk-application-designer-2-0-rev126/odk-xlsxconverter-2-0-rev126/#survey

··· On Fri, Jun 5, 2015 at 6:12 PM, <7shriner@gmail.com> wrote:

Yes, it does seem to go back to the Contents screen.

Is specifying a content branch label documented or does one of the
examples show how to modify the contents as you indicate?

When you say "screen" what is the definition of "screen"? Do I add a
_contents label in the form's XLS?

Thanks much- I have included a screen shot - but I believe it is doing as
you have indicated and going back to the contents screen.

The behavior seems inconsistent - sometimes it goes back to the previous
screen and sometime the Contents screen. Is the reason for that a known
issue?

tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

Sorry for the confusion.

Attached is a version of the section_test XLSX file illustrating the custom
contents screen and navigations possible using it.

The standard implementation is for the contents screen to just contain one
prompt of type 'contents'

section_test.xlsx (14 KB)

··· On Tue, Jun 9, 2015 at 3:45 AM, <7shriner@gmail.com> wrote:

Thanks Mitch. I looked at the references you provided and tried various
things using hideInContents, and the hideInBackHistory columns.

What is the syntax for the sheet if using the _contents ? What column /
syntax is used for the "screen"?

E.G. if I want the contents to list n screens what would the _contents
look like for SCREENJ,SCREENK..SCREENN?

Can screen names be used globally or are they local to a sheet?

Does the _contents override the hideincontents or do they interact?

Sorry for all the questions, I don't think the XLSConverter docs cover all
these things - is there any other doc or examples where they might be
covered ?

Thanks again,
tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

Answers to your other questions:

The _contents branch label (and screen) is specific to each section. It is
not global. You can define a custom contents screen for any or all
sections. If you don't define one (via an explicit _contents branch label),
then the default one will be provided.

The 'hideInContents' setting is only applicable if you are using the
'contents' prompt type. If you are writing your own custom _contents
implementation, you wouldn't be using that prompt type, so it would have no
effect.

The branch labels must be unique within a section; the same names can be
re-used across sections (there is no way to jump across sections, so this
does not introduce any confusion in the form processing).

If you are using the naming comment ( // screen_name ) for a screen or
if-then-else clause (an example of this is in the exampleForm), it is only
used to confirm that the begin and end constructs match:

begin screen // foo
end screen // foo

You could reuse the "// foo" elsewhere within the same section, though that
is likely an error on your part.

··· On Tue, Jun 9, 2015 at 1:20 PM, Mitch Sundt wrote:

Sorry for the confusion.

Attached is a version of the section_test XLSX file illustrating the
custom contents screen and navigations possible using it.

The standard implementation is for the contents screen to just contain one
prompt of type 'contents'

On Tue, Jun 9, 2015 at 3:45 AM, 7shriner@gmail.com wrote:

Thanks Mitch. I looked at the references you provided and tried various
things using hideInContents, and the hideInBackHistory columns.

What is the syntax for the sheet if using the _contents ? What column /
syntax is used for the "screen"?

E.G. if I want the contents to list n screens what would the _contents
look like for SCREENJ,SCREENK..SCREENN?

Can screen names be used globally or are they local to a sheet?

Does the _contents override the hideincontents or do they interact?

Sorry for all the questions, I don't think the XLSConverter docs cover
all these things - is there any other doc or examples where they might be
covered ?

Thanks again,
tom

--
You received this message because you are subscribed to the Google Groups
"ODK Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an
email to opendatakit-developers+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com

--
Mitch Sundt
Software Engineer
University of Washington
mitchellsundt@gmail.com