Skip to main content

Uploaded Files Export Format

  • Updated

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"
}

Related to

Was this article helpful?