Skip to content
Contact us
  • There are no suggestions because the search field is empty.

Uploaded Files Export Format

Files from participants can be uploaded to MyDataHelps using the File Upload Answer Format as well as the Javascript SDK. These files are included in the data export.

Individual files are contained in folders by Participant Identifier and either SurveyResultKey if uploaded via the File Upload answer format or category if uploaded via SDK. The last modified timestamp is directly appended to each filename. For example:

/UploadedFiles/MDH-5826-3273/surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116/2024-08-25T21:47:50.431Z_image.png
/UploadedFiles/MDH-5826-3273/diagnosis/2024-09-30T20:03:14.456Z_testresults.pdf
/UploadedFiles/MDH-6392-8549/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-02T13:05:27.804Z_video.mp4


There is also a summary file containing metadata about all of the included uploaded files.

UploadedFiles_[startdate]-[enddate].csv

Data Fields

Field Description
FileName The name of the uploaded file.
FileKey A primary key used to identify the file.
ParticipantIdentifier The identifier of the associated participant. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Category The category assigned to the file when uploaded. If uploaded via file upload answer format, this is the SurveyResultKey.
ExportFilePath The path where the file is found in the export.
ModifiedDate The timestamp for when the file was last modified in MyDataHelps, in ISO 8601 format. It is always in UTC.
UploadedDate The timestamp for when the file was uploaded to MyDataHelps, in ISO 8601 format. It is always in UTC.

Sample CSV Export

FileName,FileKey,ParticipantIdentifier,ParticipantID,Category,ExportFilePath,ModifiedDate,UploadedDate
image.png,ba9c19c4-9938-420f-aba6-d6d6c88c6417/surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116/2024-08-25T21:47:50.431Z_image.png,MDH-5826-3273,ba9c19c4-9938-420f-aba6-d6d6c88c6417,surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116,UploadedFiles/MDH-5826-3273/surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116/2024-08-25T21:47:50.431Z_image.png,2024-08-25T21:47:50.431Z,2024-08-25T21:47:50.431Z
restresults.pdf,008233d5-baa7-4b71-8d1d-be3062b8905a/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-30T19:53:29.632Z_504_Sample_Plan_Printable_ENG_D4.pdf,MDH-5826-3273,ba9c19c4-9938-420f-aba6-d6d6c88c6417,diagnosis,UploadedFiles/MDH-5826-3273/diagnosis/2024-09-30T20:03:14.456Z_testresults.pdf,2024-09-30T20:03:14.456Z,2024-09-30T20:03:14.456Z
video.mp4,820c2f2d-43fc-47d2-a6a9-08886f5818ba/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-02T13:05:27.804Z_video.mp4,MDH-6392-8549,820c2f2d-43fc-47d2-a6a9-08886f5818ba,surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad,UploadedFiles/MDH-6392-8549/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-02T13:05:27.804Z_video.mp4,2024-09-02T13:05:27.804Z,2024-09-02T13:05:27.804Z

Sample JSON Export

{
  "FileName": "image.png",
  "FileKey": "ba9c19c4-9938-420f-aba6-d6d6c88c6417/surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116/2024-08-25T21:47:50.431Z_image.png",
  "ParticipantIdentifier": "MDH-5826-3273",
  "ParticipantID": "ba9c19c4-9938-420f-aba6-d6d6c88c6417",
  "Category": "surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116",
  "ExportFilePath": "UploadedFiles/MDH-5826-3273/surveyresult_9ada96e5-e9d9-e711-815b-b9576bf93116/2024-08-25T21:47:50.431Z_image.png",
  "ModifiedDate": "2024-08-25T21:47:50.431Z",
  "UploadedDate": "2024-08-25T21:47:50.431Z"
}
{
  "FileName": "restresults.pdf",
  "FileKey": "008233d5-baa7-4b71-8d1d-be3062b8905a/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-30T19:53:29.632Z_504_Sample_Plan_Printable_ENG_D4.pdf",
  "ParticipantIdentifier": "MDH-5826-3273",
  "ParticipantID": "ba9c19c4-9938-420f-aba6-d6d6c88c6417",
  "Category": "diagnosis",
  "ExportFilePath": "UploadedFiles/MDH-5826-3273/diagnosis/2024-09-30T20:03:14.456Z_testresults.pdf",
  "ModifiedDate": "2024-09-30T20:03:14.456Z",
  "UploadedDate": "2024-09-30T20:03:14.456Z"
}
{
  "FileName": "video.mp4",
  "FileKey": "820c2f2d-43fc-47d2-a6a9-08886f5818ba/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-02T13:05:27.804Z_video.mp4",
  "ParticipantIdentifier": "MDH-6392-8549",
  "ParticipantID": "820c2f2d-43fc-47d2-a6a9-08886f5818ba",
  "Category": "surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad",
  "ExportFilePath": "UploadedFiles/MDH-6392-8549/surveyresult_f5f7bda6-657f-ef11-baf9-0affe8024cad/2024-09-02T13:05:27.804Z_video.mp4",
  "ModifiedDate": "2024-09-02T13:05:27.804Z",
  "UploadedDate": "2024-09-02T13:05:27.804Z"
}