OpenCRVS
v1.2
Search
⌃K

3.2.3.1 Prepare source file for CRVS Office facilities

Prepare your crvs-facilities source file. This is a csv file for every civil registration office in your country. You can import and create csv files in Excel or Google Drive.
Using our Farajaland crvs-facilities.csv file as an example, update it with the CRVS Office information for your country. Our crvs-facilities.csv file looks like this:
id
name
partOf
code
2OKicPQMNI
HQ Office
Location/BxrIbNW7f3K
CRVS_OFFICE
JEhYJ82xRI
Isamba District Office
Location/HPGiE9Jjh2r
CRVS_OFFICE
JWMRGwDBXK
Ibombo District Office
Location/oEBf29y8JP8
CRVS_OFFICE
Each row will represent a unique "CRVS Office" in your country.
Do not change or re-format the header row as the import script requires these names to be precise in order to parse the csv. Do not use commas in any cell and do not have any empty rows.
The id column is a unique identifier for each office. This could be a unique identifier you already use or alternatively you could create unique identifiers programatically, using Excel or using an online UUID generator website for which there are many free ones available. It is important to note that the id must contain no spaces, special characters or commas
The name column contains the human readable name for the office. We do not currently support multilingual names for the office. It is important to note that the name must contain no commas
The partOf column shows that the office is part of a higher level administrative division. Notice how we use the levels admin<level>Pcode to set the office as a child of a particular parent level. For example HQ Office district is a child of Isamba district thanks to this partOf value. Perhaps you may also recognise that these form part of FHIR Reference URLs hence the requirement for them to be absent of spaces and special characters:
Location/HPGiE9Jjh2
  • The code column must be set to CRVS_OFFICE
This CSV is converted into JSON during the import process. It is very important that there are no empty extra lines in the csv document as the script will attempt to import empty states. Any commas are treated as separators between data. This is how a csv works. So there must be no commas in any data field.
​