Skip to content

Commit 5bcd3c4

Browse files
committed
Explanations of NULL/NIL replacement in README
1 parent cf1089d commit 5bcd3c4

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ A Node.js framework for extracting mCODE FHIR resources. All resources are profi
2020
- [Extraction Date Range](#extraction-date-range)
2121
- [CLI From-Date and To-Date (NOT recommended use)](#cli-from-date-and-to-date-not-recommended-use)
2222
- [Troubleshooting](#troubleshooting)
23+
- [NULL/NIL values found and replaced with empty-strings](#nullnil-values-found-and-replaced-with-empty-strings)
2324
- [Byte Order Markers in CSV Files](#byte-order-markers-in-csv-files)
2425
- [Terminology and Architecture](#terminology-and-architecture)
2526
- [Glossary](#glossary)
@@ -165,6 +166,10 @@ npm start -- --entries-filter --from-date <YYYY-MM-DD> --to-date <YYYY-MM-DD> --
165166

166167
### Troubleshooting
167168

169+
#### NULL/NIL values found and replaced with empty-strings
170+
171+
When CSV files are provided containing NULL/NIL values, those values are treated as empty values and are translated into ''. Each Extractor, however, defines a set of `unalterableColumns` which will be immune from this NULL/NIL correction. All values that are corrected will produce a `debug`-level message, and can be seen by running the extractor with the debug flag set.
172+
168173
#### Byte Order Markers in CSV Files
169174

170175
The extraction client has built-in handling of byte order markers for CSV files in UTF-8 and UTF-16LE encodings. When using CSV files in other encodings, if you experience unexpected errors be sure to check for a byte order marker at the beginning of the file. One way to check is to run the following command from the command line:

0 commit comments

Comments
 (0)