To import trial, session, subject, and intervention metadata, you can upload a configuration file named "moveshelf_config_import.json". This can be used, for example, when uploading a gait analysis session from before Shriners started using the gait workflow on Moveshelf.

This file supports the import of:

• "trialSideSelection": to define whether a trial should be used for left/right/both/none.
• "trialInvalidData": to indicate whether a data type needs to be ignored for that trial (e.g. kinetics for left).
• "representativeTrials": to indicate whether a trial should be considered representative in a condition to be used for plotting EMG in the Word export.
• "conditionDefinition": to define what trials should go in which condition.
• "subjectMetadata": subject metadata that will be written in the subject info tab.
• "interventionMetadata": intervention metadata that will be written in the intervention metadata tab.
• "sessionMetadata": session metadata that will be written in the session metadata tabs. The format for this entry, as well as "subjectMetadata" and "interventionMetadata" is defined by the metadata configuration, which can be found in the Moveshelf <> Shriners shared GitHub for both the Gait and the Sportsmedicine workflow.

You can upload the configuration file either as part of a directory or separately:

• Directory upload: the configuration file can be uploaded as part of a directory. An example directory including metadata import can be found in the Moveshelf <> Shriners SharePoint.
• Separate upload: The configuration file can also be uploaded separately. To do this, drag and drop only the moveshelf_config_import.json file into the session upload box.  

Please note, that:

• The moveshelf_config_import.json is meant as an example, and does not contain the complete session metadata list.
• During the upload process:
• Warnings are displayed to inform the user which fields will be overwritten and which fields will remain unchanged.
• If the configuration file contains incorrectly formatted data, error messages will specify why the values are invalid. The upload process cannot proceed until these formatting issues are resolved. Refer to the formatting guide below for details on correct field formats.

Formatting fields in the configuration file

Below is a guide on how to format the different datafields in the moveshelf_config_import.json file for importing subject and session metadata into Moveshelf. The table outlines the supported syntax for each field type, along with examples to help you format your data correctly.

Variable Type on Moveshelf	Format in .json	Example in the .json file
Short text	"Text"	"subject-first-name"
Short text - with left/right context	[   {"value": "Text", "context": "left"},   {"value": "Text", "context": "right"} ]	"vicon-leg-length"
Long text	"Text"	"surgery-dictation"
Dropdown	"Dropdown option"	"sessioninfo-site"
Dropdown - with left/right context	[   {    "value": "Dropdown option",    "context": "left"   },   {    "value": "Dropdown option",    "context": "right"   } ]	"supine-galeazzi"
Multi-select dropdown	{   "value": [    "Dropdown option1",    "Dropdown option2"],   "multiselect": true }	"sessioninfo-data-collected"
Multi-select dropdown - with left/right context	[   {    "value": [     "Dropdown option1",     "Dropdown option2"],    "context": "left",    "multiselect": true   },   {    "value": [     "Dropdown option1",     "Dropdown option2"],    "context": "right",    "multiselect": true   } ]	"prone-nonwb-forefoot"
Date	"yyyy-mm-dd"	"subject-date-of-birth"