Create PFT Data File for Import
Covered by this topic
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
- 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
- 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.
- Save the file as CSV format.
Upload PFT Data CSV File
- Login as a user with administrator rights.
- Navigate to the Control Panel from the side menu.
- Select the Data Import tab.
- Select PFT Data CSV API from the drop-down menu and click Go.
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 Updated:
Last Build:
Thu, 05 Dec 2024 18:17:23 UTC
WikiGDrive Version: 2aacb51f060d0354a678419290943a99bd16aad1