You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
You are viewing the article in preview mode. It is not live at the moment.
IMPORTANT: Upcoming Changes in CAREWare > Learn More
Home > Importing and Exporting Data > Transitioning to current import and export options in CAREWare
Transitioning to current import and export options in CAREWare
print icon

 


Purpose

Help providers and administrators transition from MDB imports/exports to the current CAREWare options in the 2025 RSR build.

Who should do this

CAREWare administrators, data managers, report writers, interface staff, and support staff who manage imports, exports, or client matching settings.

Use this guide when you need to

Choose a replacement for MDB, update import settings, move old DTM workflows into CAREWare, use SQL PDI/PDE or CSV, or save export settings.

Main warning

MDB formatted imports and exports are no longer supported. Use the current DTM, CSV template, SQL PDI/PDE, FHIR, HL7, or custom report CSV options instead.

Related help

For CAREWare FHIR Interface setup, contact Steve Overman at [email protected] or contact the CAREWare Help Desk.

Before you begin

This guide applies to CAREWare 2025 RSR build import, export, DTM, SQL PDI/PDE, CSV template, FHIR, HL7, and client matching changes.

You need access to Administrative Options and Data Import and Export Features. Some actions require Central Administration or provider-level permissions.

Important

Do not continue using MDB formatted import or export workflows. Rebuild those workflows using the current DTM, SQL PDI/PDE, CAREWare CSV template, FHIR, HL7, or custom report CSV options.

What changed in the 2025 RSR build

  • CAREWare now includes a CAREWare FHIR Interface for supported EHR, EMR, and lab connections using the FHIR API standard.
  • MDB formatted imports and exports are no longer supported.
  • URN is calculated using the first and third letters of first name, first and third letters of last name, DOB, sex at birth, and a suffix. U is the default suffix and changes only when two or more clients would have the same URN.
  • eURN has been removed.
  • eUCI used for client matching and HRSA reports now uses sex at birth.
  • Legacy eUCI remains available for old reports and for matching clients to the eUCI calculated by the older method.
  • SQL PDI was updated and expanded with more data elements, including provider setup information. It uses the same general schema and primary key/foreign key logic that MDB users relied on.
  • The built-in CAREWare Data Translation Module (DTM) replaces the old external DTM application. It uploads CSV files directly instead of creating MDB files.
  • Sex at Birth is required for URN logic. If it is missing, CAREWare sets the value to Unknown so the import can continue, however that can cause issues with .
  • Export settings can now be saved and reused.

Current import and export options

 

Choose the replacement for the old MDB workflow

Option

Use it when

CAREWare FHIR Interface

Use when you can query labs or an EHR/EMR through a FHIR API. The main use is to regularly pull RSR-related data, improve completeness, and reduce double data entry. Because FHIR is a common standard, it can be implemented quickly for many new interface projects.

CAREWare DTM

Best transition for users who previously used the external DTM to turn CSV files into MDB files. The new DTM is built into CAREWare, does not require a separate desktop application, and saves the mapping as a CAREWare setting.

SQL PDI

Best transition for teams that created MDB files from Access queries, SAS, SQL databases, or other systems. If those systems can connect to the CAREWare SQL Server Database Instance, load data directly into the cw_pdi holding database that CAREWare monitors.

SQL PDE

Use for SQL-based exports from CAREWare when replacing MDB export processes.

CAREWare CSV Template

Use when your source can produce CSV or Excel-like files. Include every template column as a header, provide a primary key for each record, and populate only required fields plus the fields needed for matching and the data being imported.

Custom report CSV

Use when you need report-style exports in CSV format rather than a full template or SQL export.

 

Move old DTM work into the current DTM

Old DTM users can usually keep the same spreadsheets and move the mapping into CAREWare.

Workflow

How it works

Old external DTM

Create a CSV with client URN fields, service name, and service date; map columns to the CAREWare MDB template table and column; save settings; place the file in a processing folder; create an MDB; upload the MDB to CAREWare.

Current built-in DTM

Create the same CSV; map columns to the CAREWare CSV template table and column inside CAREWare; save the setting; upload the CSV with New Import.

 

Result: after setup, the current DTM has fewer steps and keeps the setting permanently so users can upload future files without managing a separate application.

Use SQL PDI and SQL PDE instead of MDB

Use SQL PDI when systems that previously created MDB files can connect over the network to the CAREWare SQL Server Database Instance.

  • Load import data into the CAREWare cw_pdi database. CAREWare monitors this holding tank for imports and exports.
  • SQL PDI keeps the MDB-style primary key/foreign key matching process. A client record is stored in exp_client and referenced by client-level tables through fields such as srv_cln_fk in exp_service.
  • The updated SQL PDI template includes setup information such as contracts and custom fields, which supports synchronization between systems.
  • Use SQL PDE when replacing MDB-style exports with SQL-based exports.

Use the CAREWare CSV template correctly

The DTM and SQL PDI options are usually the closest MDB replacements. The CAREWare CSV template is also a supported path, especially for reports, CSV files, Excel files, or data that was previously prepared for the old DTM.

CSV template rule

Include all columns from the template as column headers. Only required fields and the fields needed for matching or the data being imported must contain values. Each record also needs a primary key, such as 1, 2, 3, and so on.

 

CSV topic

Guidance

Client data relationship

MDB client-level tables matched through exp_client. CSV tables carry matching values in each table, so a service import can use exp_service alone when it includes the needed matching fields.

match_id

Each CSV table has match_id for eUCI, Client ID, a custom field, or another configured matching value. It can avoid PII, and exp_client can be excluded.

Definition codes and names

CSV accepts names or source-system text instead of CAREWare codes. srv_cs_1_def_code is text up to 2000 characters, so long source names can map to CAREWare names.

Multiple services on one day

Use the numbered pattern, such as srv_cs_2_def_code, to import another service for the same client on the same day.

Metadata tables

MTD metadata tables remain related. Include all related MTD tables when importing setup information such as contracts into another CAREWare instance.

Custom fields

Custom field columns are appended where the field is active. For example, Case Manager in exp_service is imported as cst_case_manager.

 

Update client matching settings

In Import Settings, client matching options changed to support the new 2025 RSR eUCI calculation while still supporting legacy matching.

Client matching option

How to use it

Client eUCI (Updated/Legacy)

Uses the current eUCI calculation for 2025 RSR reporting and the Legacy eUCI calculation for 2024 or earlier reporting. CAREWare can match the exact eUCI/Legacy eUCI in match_id or calculate the appropriate version from URN fields in the import.

Client ID

Unchanged.

Custom Field

Unchanged.

State No (eHARS)

Unchanged.

Legacy URN Elements

Matches clients using the older URN calculation method.

 

Understand eUCI, Legacy eUCI, and missing values

  • For the 2025 RSR, eUCI uses first name, last name, DOB, and sex at birth.
  • For 2024 and earlier RSR reporting, Legacy eUCI uses first name, last name, DOB, and gender.
  • HRSA EHB needs the correct eUCI for the correct report year, so CAREWare retains both the current eUCI and Legacy eUCI.
  • Sex at birth and gender are required values for URN/eUCI logic, but missing values do not stop the import. CAREWare assumes Unknown and inserts a code so the client can be processed.
  • If sex at birth is missing, CAREWare inserts 4 into the current URN calculation. If gender is missing for the legacy calculation, CAREWare inserts 9 into the Legacy URN calculation.
  • In the old MDB template, DOB and gender were required unless the requirement was removed from both the import file and CAREWare Business Tier template. In the 2025 RSR build, complete URN fields are no longer required to complete the import because CAREWare assumes Unknown where needed.
  • The default client matching settings place no weight on sex at birth. When using eUCI matching options, CAREWare can still consider the client a 100% match even if sex at birth is missing from the import but populated in the existing client record.
  • match_id columns require an exact match. If the import uses only an eUCI value in match_id and does not include URN fields, the client may not match an existing record when the existing record has sex at birth populated and the imported eUCI was created with sex at birth missing.

Example

A service import for First Name Last, Last Name Testing, DOB 02/02/2020, and missing sex at birth creates a current URN with 4 for missing sex at birth and a Legacy URN with 9 for missing gender.

 

Example value

Result

Current URN with missing sex at birth

LSTS0103204U

Legacy URN with missing gender

LSTS0203209U

eUCI with sex at birth blank

214509364B385F10504A61D106BEB128E013715AU

eUCI with sex at birth set as male

D0DA2F94C8FBB025D07EED9D3A315F92C7AF705BU

 

Save export settings for reuse

In the 2025 RSR build, users can save Provider Data Export settings in Central Administration or inside a provider.

  • Save settings for reports, state coordination, RSR exports to SQL, RSR exports as CSV files, custom fields, custom subforms, or form designer records.
  • Name each saved configuration for its purpose so it can be reopened and run later without recreating the selections.
  • Example: save one Provider Data Export setting for each quarter and one for the full annual RSR date span. The next year, update the year in the date span rather than rebuilding the settings.

How to confirm it worked

  1. Run the import or export using the new option.
  2. Confirm imported client records match as expected. If a possible match appears, use the client match scoring system to select the existing client record when appropriate.
  3. Confirm required CSV headers are present, required fields are populated, and match_id values are exact when used.
  4. For saved exports, reopen the saved configuration and confirm the date span, tables, custom fields, custom subforms, and form designer selections are still correct.

Troubleshooting and common questions

Question

Answer

Can I still use MDB?

No. MDB formatted imports and exports are no longer supported in the 2025 RSR build.

Which option is closest to MDB?

Use the current DTM if the old workflow started with CSV files. Use SQL PDI if another database or application can load data into CAREWare SQL Server.

Do all CSV columns need data?

No. Include every template column as a header, but populate only required fields plus matching and data fields needed for the import.

Why did an eUCI not match?

match_id requires an exact value. Use Client eUCI (Updated/Legacy) with the correct eUCI version or include populated URN fields so CAREWare can calculate the appropriate match.

What if sex at birth or gender is blank?

CAREWare assumes Unknown, inserts the required missing-value code, and continues the import. Manual client matching may still be needed.

Where do I get FHIR setup help?

Contact Steve Overman at [email protected] or contact the CAREWare Help Desk.

Feedback
0 out of 0 found this helpful

Attachments

Transitioning_to_current_import_and_export_options_in_CAREWare.pdf
scroll to top icon