OpenFIT Import Template (new)

Created by Enda Madden, Modified on Fri, 20 Feb at 12:08 PM by Enda Madden

Overview

OpenFIT supports multiple import templates depending on the type of data you need to load. You do not need to include session or survey data if you simply want to import providers, clients, and cases.

 

OpenFIT automatically detects which template you are using based on the columns present in your file. Simply include the columns relevant to your import and OpenFIT will handle the rest.

 

For detailed information on importing ORS and SRS survey scores, including validation rules and skip flags, see Importing Data into OpenFIT.


Choosing the Right Template

 

I want to import…Template
Providers, clients and cases onlyTemplate 1 — Provider / Client / Case
Providers, clients, cases and collateral ratersTemplate 2 — With Collateral Raters
Providers, clients, cases and sessions (no survey scores)Template 3 — With Sessions
Providers, clients, cases, sessions and collateral ratersTemplate 4 — With Sessions & Collateral Raters
Everything including ORS/SRS survey scoresTemplate 5 — Full Import

 


Field Reference

 

Provider Fields

ColumnRequiredDescription
Service_LocationYesName of the provider location. Must match an existing location in OpenFIT.
Provider_EmailYesEmail address (unique). Used as the OpenFIT username. If the user does not exist, OpenFIT will create one with a default Clinician role.
Provider_FirstNameYesFirst name of the clinician.
Provider_LastNameYesLast name of the clinician.
Provider_IDNoOptional external identifier for the provider.

 

Client Fields

ColumnRequiredDescription
Client_IDYesUnique identifier for the client.
Client_FirstNameYesClient's first name.
Client_LastNameYesClient's last name.
Client_GenderYesOne of: Male, Female, Transfeminine, Transmasculine, GenderExpansiveNonBinary, TwoSpirit, Questioning, DeclinedToState, AdditionalCategory
Client_GroupYesClient group classification (e.g. Adult, Child, Couple, Family, Group).
Client_AgeYesClient's age at the time of the case.
Client_StatusYesClient status (e.g. Active, Inactive).
Client_LanguageNoClient's preferred language.
Client_TagsNoOptional tags for the client record.

 

Case Fields

ColumnRequiredDescription
Case_IDYesIdentifier used to group sessions for a client.
Case_DateNoStart date of the case. Format: yyyy-MM-dd
Case_TagsNoOptional tags for the case record.
NotesNoSaved when the case (episode) is created.

 

Session Fields

Only required when importing session data (Templates 3, 4 and 5).

 

ColumnRequiredDescription
Session_IDYesSequential integer within the case (1, 2, 3…), where 1 represents the earliest session by date.
Session_DateYesDate of the session. Format: yyyy-MM-dd
Session_KeyNoOptional external key for the session.

 

Collateral Rater Fields

Only required when importing collateral rater data (Templates 2, 4 and 5).

 

ColumnRequiredDescription
ColRater_IDYesUnique identifier for the collateral rater.
ColRater_TypeYesType of collateral rater (e.g. parent, guardian, teacher).
ColRater_FirstNameYesFirst name of the collateral rater.
ColRater_LastNameYesLast name of the collateral rater.
ColRater_GenderNoGender of the collateral rater. Uses the same values as Client_Gender.
ColRater_LanguageNoPreferred language of the collateral rater.

 

ORS/SRS Survey Fields

Only required for the Full Import (Template 5). For detailed validation rules, see Importing Data into OpenFIT.

 

ColumnRequiredDescription
ORS_SkipYesY if the ORS was not completed, N if it was.
ORSQ1ORSQ4ConditionalORS subscores. Required when ORS_Skip = N and Total_ORS is blank.
Total_ORSConditionalTotal ORS score. Required when ORS_Skip = N and subscores are blank.
SRS_SkipYesY if the SRS was not completed, N if it was.
SRSQ1SRSQ4ConditionalSRS subscores. Required when SRS_Skip = N and Total_SRS is blank.
Total_SRSConditionalTotal SRS score. Required when SRS_Skip = N and subscores are blank.

 


Templates

 

Template 1 — Provider / Client / Case Only

Use this template when you want to set up providers, clients and cases in OpenFIT without any session or survey data.

 

Columns:

Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,Notes

 

Example:

Service_LocationProvider_FirstNameProvider_LastNameProvider_EmailCase_IDCase_DateClient_IDClient_FirstNameClient_LastNameClient_GenderClient_GroupClient_AgeClient_Status
Main ClinicJaneSmithjsmith@example.orgCASE-0012025-01-15CL-1001AlexJohnsonMaleAdult34Active
Main ClinicJaneSmithjsmith@example.orgCASE-0022025-02-01CL-1002SamLeeFemaleAdult28Active
Outreach OfficeMarkTorresmtorres@example.orgCASE-0032025-02-10CL-1003JordanParkGenderExpansiveNonBinaryChild14Active

 


Template 2 — With Collateral Raters

Use this template when you also need to import collateral raters (e.g. parents, guardians, or teachers) linked to a client's case.

 

Columns:

Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ColRater_ID,ColRater_Type,ColRater_FirstName,ColRater_LastName,Notes

 

Example:

Service_LocationProvider_FirstNameProvider_LastNameProvider_EmailCase_IDClient_IDClient_FirstNameClient_LastNameClient_GenderClient_GroupClient_AgeClient_StatusColRater_IDColRater_TypeColRater_FirstNameColRater_LastName
Outreach OfficeMarkTorresmtorres@example.orgCASE-003CL-1003JordanParkGenderExpansiveNonBinaryChild14ActiveCR-2001ParentLisaPark

 


Template 3 — With Sessions

Use this template when you want to import session records but do not need to include ORS/SRS survey scores.

 

Columns:

Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,Notes

 

Example:

Service_LocationProvider_FirstNameProvider_LastNameProvider_EmailCase_IDCase_DateSession_IDSession_DateClient_IDClient_FirstNameClient_LastNameClient_GenderClient_GroupClient_AgeClient_Status
Main ClinicJaneSmithjsmith@example.orgCASE-0012025-01-1512025-01-15CL-1001AlexJohnsonMaleAdult34Active
Main ClinicJaneSmithjsmith@example.orgCASE-0012025-01-1522025-01-22CL-1001AlexJohnsonMaleAdult34Active

 


Template 4 — With Sessions & Collateral Raters

Use this template when you need to import sessions together with collateral rater information.

 

Columns:

Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ColRater_ID,ColRater_Type,ColRater_FirstName,ColRater_LastName,Notes

 


Template 5 — Full Import (with ORS/SRS Scores)

Use this template when you want to import everything including ORS and SRS survey scores. For full details on score validation rules, see Importing Data into OpenFIT.

 

Columns:

Service_Location,Provider_FirstName,Provider_LastName,Provider_Email,Case_ID,Case_Date,Session_ID,Session_Date,Client_ID,Client_FirstName,Client_LastName,Client_Gender,Client_Group,Client_Age,Client_Status,ORS_Skip,ORSQ1,ORSQ2,ORSQ3,ORSQ4,Total_ORS,SRS_Skip,SRSQ1,SRSQ2,SRSQ3,SRSQ4,Total_SRS,Notes

 

Example — Session with ORS subscores, SRS skipped:

Session_IDSession_DateORS_SkipORSQ1ORSQ2ORSQ3ORSQ4Total_ORSSRS_SkipSRSQ1SRSQ2SRSQ3SRSQ4Total_SRS
12025-01-15N6.57.25.86.0Y
22025-01-22N25.5N8.17.59.08.4

 

Note: The example above shows only the session and score columns for clarity. The full template includes all provider, client and case columns as well.

 


Custom Fields

All templates support custom fields. To include a custom field, add a column to your file using the naming convention:

 

{EntityName}_{FieldName}

 

Where {EntityName} is typically Episode or Client. The column values must match the visible values shown in the OpenFIT UI — do not use GUIDs or internal IDs.

 

Example: An Episode-level custom field called "Treatment Settings" would appear as the column Episode_TreatmentSettings with values such as Outpatient, Inpatient, Residential, or Other.

 

If you need help identifying the correct field name, you can inspect the data-translate attribute in browser DevTools or contact support@openfit.care.

 


Important Notes

 

  • Column order does not matter — OpenFIT reads columns by name, not position.
  •  
  • Auto-detection — OpenFIT automatically determines the import type based on which columns are present in your file. There is no need to specify the template type manually.
  •  
  • Optional columns can be omitted entirely — you do not need to include blank optional columns.
  •  
  • Large imports and ETL migrations — for initial data loads or migrations from another outcome measurement system, please contact us during the planning phase. We can support validation and testing in a Sandbox environment before importing into Production.

 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article