DIMA Flat File Extraction Guide
1Up uses a tool called DIMA (Data Ingestion & Mapping Administration) - to help manage FHIR mappings and data ingestions. The tool contains file extract specifications to aid in standardizing data sets so that your data can be effectively mapped to FHIR resources. You can access the DIMA flat file extracts here: https://data-admin.centralit.1up.health/validate/file

Name
Description
Column Name
Each value in this column identifies the name of a corresponding column in the final file. Please ensure that all provided values match one of these column values.
Required
If a column is required, the column must always have a value where recorded in any extract generated for the corresponding resource type. Note: This means that if a column is required and nullable it must be populated wherever possible, but it is not required for a valid FHIR resource. So if the value is not recorded for the given resource, the field can be null to reflect that.
Nullable
If there is not a value present for the corresponding row in the final file, this column can have null values. Note: A null value communicates that a value cannot be provided, because a relevant value cannot be derived from the source data. This is NOT the same as "false", "unknown" or "N/A"
Allowed Values
If allowed values is populated, all values within that column must be coded as one of the allowed values unless an alternative is offered within the description of the field. If the allowed values don't make any sense within the context of the data and there is not a clear alternative provided in the description, please reach out to 1UpHealth to determine the best path forwards.
Description
A plaintext description of the data that should be provided in a column. The description sometimes contains additional information or clarification that couldn't be provided elsewhere.
Type
A specific data type (string) or format (YYYY-MM-DD) that all values within the column in the final file should follow.

When creating a file in accordance with the flat file extracts please include all columns listed, whether they are required or not. This will aid with consistency on our end. If you have no data to provide for a given column, it can be left as null for all rows. In addition, the file should be formatted as a CSV withe either pipe or comma delimiters, and follow all other file format guidelines from the data ingestion guide.
Copy link
On this page
Column Meanings and Uses
File Format