diff --git a/src/_templates/search.html b/src/_templates/search.html index 6e33d4bf..e445b8fb 100644 --- a/src/_templates/search.html +++ b/src/_templates/search.html @@ -9,7 +9,7 @@ jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); }); {# this is used when loading the search index using $.ajax fails, - such as on Chrome for documents on localhost #} + such as on Chrome for documents on localhost #} {{ super() }} {% endblock %} diff --git a/src/getting-started-2-architect.rst b/src/getting-started-2-architect.rst index 1652e39f..4aa10e94 100644 --- a/src/getting-started-2-architect.rst +++ b/src/getting-started-2-architect.rst @@ -81,7 +81,22 @@ You should now see some JSON in the output window. Hit the :guilabel:`Save to Fi .. note:: - The :file:`definition.csv` and :file:`properties.csv` files are updated because the *form_id* is the same as the *table_id*. + **Manual Saving (When Automatic Saving Fails)** + + .. this instruction is needed when automatic saving fails. + + In case you encounter an error with the :guilabel:`Save to File System` button (e.g., "Something went wrong! Please save the file manually"), follow these steps to manually save the generated JSON: + + 1. Copy the JSON output displayed in the output window. + 2. Open a text editor (like Notepad, VSCode, or Sublime Text). + 3. Paste the JSON into a new file. + 4. Save the file with the name `formDef.json` in the same location as the `exampleForm.xlsx` file (typically :file:`app/config/tTables/exampleForm/forms/exampleForm`). + 5. Repeat this process for any other files that failed to save (e.g., :file:`definition.csv`, :file:`properties.csv`), if needed. + +.. note:: + + The :file:`definition.csv` and :file:`properties.csv` files are updated because the *form_id* is the same as the *table_id*. + On the :program:`Chrome` Browser, click on the :guilabel:`Preview` tab. Click on :guilabel:`Purge Database`. This will delete the earlier *Example Form* data table -- a necessary step because we are adding a :th:`Color` column to that data table. Select :guilabel:`exampleForm` if you do not already have that form open. @@ -185,4 +200,4 @@ We also provide guides for setting up your own ODK-X application for each of the However, the user guides for these tools are also useful for everyone. -Finally, to expand your knowledge of the more advanced features of the platform, such as data permission filters, read the :doc:`advanced-topics-architect`. +Finally, to expand your knowledge of the more advanced features of the platform, such as data permission filters, read the :doc:`advanced-topics-architect`. \ No newline at end of file