4.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 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:

idnamepartOflocationType

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 seeding process 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, no rich texts or commas

This Excel / Google Sheets formula creates a random unique ID:

=DEC2HEX(RANDBETWEEN(0, 4294967295), 8)

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 locationType column must be set to CRVS_OFFICE