This page covers Step 3 below
This page covers case properties mapping for two different scenarios 1. Creating Cases with Excel Importer and 2. Updating Cases with Excel Importer
You should now be on a page with the following interface
Map Excel Headers to Case Properties
The next step is to map the columns in your Excel document to case properties that you want to create: you basically want to tell CommCare HQ what name to give to the new case property or match the Excel column header to an existing case property. Understand in which situation you are following the table below and then complete the steps specified
|IF||AND||THEN DO THIS|
|You're updating existing cases||your application already has case properties||you can choose these for each Excel column. (Note that the tool will only show case properties that have been submitted. If you have not created a case yet, it will not show any case properties).|
|You're updating existing cases||your application doesn't have a case property||you can choose to create a new one for the appropriate Excel column. The Auto Fill button will automatically match your excel headers to the existing case properties name.|
|You are creating new cases,|
Choose each Excel column you want to import and the case property you want to create or update. If you want to create a new case property, check "Create a new property instead" and type in the name of the case property.
Once you've mapped all of your Excel columns, click on the Confirm Import button.
NOTE: If you're creating a new case property. following the above steps will only create the case property for the cases. It will not automatically create a case property under case management in the form builder.
Check for details in Recent Uploads
Upon starting an import, you will be be returned to the landing page and a new row will appear at the top of Recent Uploads, letting you view the progress of your import. Upon completion of the import, the following information will appear under details (messages only appear if the # isn't 0):
- # rows matched and updated (corresponds to the number of cases updated for the Excel fields that you matched to case properties in the application)
- # rows did not match any existing cases and had new cases created for them. If case_id's were used, these were ignored. (if you selected the option to create new cases, this indicates the number of new cases that were created where there were no matching Excel fields/case properties)
- # rows matched more than one case at the same time (you may have multiple cases in your system with the same case_id, in which case the system will not update anything as it will not know to which case the new data corresponds)