build

build copied to clipboard

Download as XML and import into ODK Central works pretty nicely so far, so this is a nice to have - import a form to ODK Central via menu would simply be a nice shortcut.

a totally reasonable request!

Implementation

Menu File > Upload Form to Central should open a modal dialogue:

• Central project URL
• Central username
• Central password
• Button: Upload form
• Checkbox (default yes): open form after upload in new tab?

When "Upload form" is clicked:

• Get the form list.
• If the form ID does not yet exist in the form list: create new form. This should create a draft for the new form.
• The form ID does exist in the form list: create draft for the existing form ID. This should create a draft for the existing form.
• If selected, open the URL in a new tab. The user will want to test and publish the form, possibly also upload form media.

Considerations

• Central base URL or project URL? I think project URL is better, as it's easier for users to navigate to the project they want the form to live under than to guess what a "base URL" is. Also, it will save a round trip to choose from available projects.
• Which errors can happen? How should these be logged and handled?
• Are the above scenarios complete? Which use case have we missed?

Edge cases

Maybe best explained in the Build docs:

• The user wants to hand-edit the XML before upload: Export to XML > Edit > Manual upload to Central.
• The user wants to export the XLSForm and hand-edit that before upload: Export to XLSForm > Edit > Manual upload to Central.