@canimmunize/cvc-tools v0.4.25

CVC-Tools

Summary

Tools for building and managing the Canadian Vaccine Catalogue.

Usage

You must have a google drive access token which gets you access to the CVC directory. TODO: Instructions for how to get this

Building the CanadianVaccineCatalogue.xlsx

npm run excel - Builds the dev version of the excel file. npm run excel:open - Builds the excel file and opens it. npm run excel:release - Builds the release version of the excel file.

Debugging

To use the debugger, use VS Code. Configuration for debugger is in .vscode/launch.json.

Point the program property in launch.json to the js (in lib) script you want invoked by the debugger.

Google Drive Integration

The files that are maintained by the CANImmunize team are stored on Google Drive: /Ottawa mHealth/Programs/Digital Health/Projects - Active/CanadianVaccineCatalogue.

TODO: Migrate these to the new CANImmunize drive

Google drive is used because of how MS Excel treats utf-8 encoded CSVs. (It converts field values to scientific notation when a csv is opened with excel, and then a subsequent save of the file stores the scientific notation to disk instead of the original value. It also corrupts the encoding of special characters.)

Building a New CVC Version

1. Check whether there has been a new release of the Pan-Canadian Immunization Reference Sets
   • TODO: More detail on what this means
   • Download the new json files and put into the project in the config data folder for the new version
2. Ensure that CVC extension terminology has been created for any new concepts in the updated Immunization Reference Sets
3. Check for error messages:
   • No relation found for tradename: xxx
   • Error: No corresponding CVCGenericConcept for CVCConcept:
   • Warning: No corresponding CVCConcept for CVCTradename:
   • Note that there will be warnings for 9841000087102, 9821000087106, 20851000087103 because these are special cases
4. Make sure new lots get added to the cvc-lot_data spreadsheet
5. Publish to the API using yarn fhir:publish
6. Use mailchimp to send out an email to the CVC Subscribers