Create PFT Data File for Import

This document explains how to import your pulmonary function testing data into WebChart .

What you will need:

  • Spreadsheet software (Microsoft Excel or Google Sheets)
  • PFT Data CSV File Example

WebChart end user with administrative rights

Create PFT Data CSV File

  1. The following table provides optional or required Field Names and Descriptions, as indicated by the Requirement column. Items marked as Best Practice or Optional are not required and may be left blank, or omitted entirely. Employee ID must be the first column in the CSV file. The order of the remaining fields does not matter.
**Field Name** **Description** **Requirement** Data File Column Header
Employee ID Employee Identifier. This field will be used for looking up the chart in WebChart , to insert or update. **Required** documents.pat_id
External ID This is a unique identifier typically populated by third-party interfaces from which the document originated. **Required** documents.ext_doc_id
Test Datetime When (datetime) the PFT was performed. Must be formatted as YYYY-MM-DD HH:MM:SS **Required** pft.test_datetime
PFT Maneuver Datetime Datetime of PFT maneuver. Must be formatted as YYYY-MM-DD HH:MM:SS **Required** pft_maneuver.meneuver_datetime
FVC Records the forced vital capacity (FVC) , the total volume expelled from lungs. Enter volume in milliliters (mL). **Required** pft_maneuver.fvc
FVC Predicted Records the predicted value for FVC. Enter volume in milliliters (mL). Optional pft_maneuver.fvc_predicted
FEV1 Records the forced expiratory volume (FEV). Enter volume in milliliters (mL). Optional pft_maneuver.fev1
FEV1 Predicted Records the predicted value for the FEV for the first second of the test. Enter volume in milliliters (mL). Optional pft_maneuver.fev1_predicted
FEF25%-75% Records the forced expiratory flow (FEF) from 25% to 75% of test, or the middle 50% of test. Enter volume in milliliters (mL). Optional pft_maneuver.fef25_75
FEF25%-75% Predicted Records the predicted value for FEF from 25% to 75% of test. Enter volume in milliliters (mL). Optional pft_maneuver.fef25_75_predicted
FEV1/FVC Records the lower limit of normal for the first second of FEV over the FVC. Optional pft_maneuver.fev1_fvc
FEV1/FVC Predicted Records the predicted value for the first second of FEV over the FVC. Optional pft_maneuver.fev1_fvc_predicted
PEF Records the lower limit of normal for PEF. Enter volume in milliliters (mL). Optional pft_maneuver.pef
PEF Predicted Records the predicted value for PEF. Enter volume in milliliters (mL). Optional pft_maneuver.pef_predicted
Spirometer Model of spirometer. Optional pft.spirometer
Interpretation Interpretation of a test (by device). Optional pft_maneuver.interpretation
Comment Free text comment for PFT. This field may be repeated in the CSV file. Comments would be handled in-order and separated by a newline. Optional pft.comment
Tip
*For a more comprehensive list of supported fields, please refer to the *PFT Data CSV API Specification
  1. Using the table, above, determine the data to be imported. Starting with the Employee ID field, enter all required and desired data, verifying required data is present. Note that each row represents a pulmonary function test record. Below is a screenshot of the PFT Data CSV File Example for guidance.

  1. Save the file as CSV format.

Upload PFT Data CSV File

  1. Login as a user with administrator rights.
  2. Navigate to the Control Panel from the side menu.

  1. Select the Data Import tab.

  1. Select PFT Data CSV API from the drop-down menu and click Go.

  1. Select the PFT Data CSV File and click Upload.
Tip
For extra information on what happens during the import, click the Verbose checkbox.

Resources

Troubleshooting

Ensure that all of the fields marked as Required have valid content. The file uploaded must be saved as a CSV formatted file. In case of any errors, contact Technical Support.

WebChart Documentation
Last Build: Wed, 08 Sep 2021 00:25:59 EDT Legacy Documentation