| Multiexcerpt include macro | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
The Data Dictionary provides a method for documenting case properties by grouping them and adding descriptions and labels. By doing so, it is easier to visualize and contextualize the property within the context of the case.
...
| Table of Contents | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The Data Dictionary Administration Page
...
Firstly, this can be accomplished by adding new rows to the case export Excel file and then importing this file into the Data Dictionary.
The second option is to fill in the text box next to the "Add Case Property" button at the bottom of the page (see the below image), and then click "Add Case Property" to create a new entry. After creating all your case properties in this manner, click the button
.png?version=3&modificationDate=1688150190676&cacheVersion=1&api=v2&width=34)
to complete the process.
It is advised to create and save case properties in small batches.
If an error is made during the process, simply refresh the page and the unsaved changes will be removed.
...
Add Case Property Group
Case properties can be grouped using the Case Property Group. You can manage which case properties are associated with the Case Property Group by dragging and dropping them into or out of the group. Click the .png?version=3&modificationDate=1688150190676&cacheVersion=1&api=v2&width=45){kind=small}
button at the top right of the page to complete the process.
...
The Case Property Group can be used to group case properties. To manage which properties are associated with the Case Property Group, drag and drop case properties into or out of the group. To complete the process, click the button at the top right of the page.
Case Data integration with the Data Dictionary
...
The screenshot below displays an example of the case data page. In this example, the data dictionary was used to configure the way the case properties are presented. We can see different data sets represented in different tables, with the black "i" icon, that provides additional information about the case property when hovered over.
...
All properties in the data dictionary show up on CommCareHQ's Case Data page. The , whether they were saved in Case Management or otherwise. The "---" indicate that no value has been set. Blank means the property has been set to an empty string ("") - often when it's been cleared out deliberately by a user.
...
To edit the case data page through the data dictionary, navigate to Data Dictionary located under Data tab in CommCareHQ. Once the relevant dictionary is selected, you will see multiple options per case property, as displayed in the screenshot below.
...
From here, you can use the arrows on the left to rearrange the properties, assign properties to different Case Property Groups, which will group and tabulate them, and add relevant labels and descriptions. Case properties that exist but were not saved using Case Management will show up in an "Unrecognized" category until they're added to the Data Dictionary. The “Unrecognized” category will only show up if Case Property Groups exist in the Data Dictionary.
If Case Property groups exist, but a property isn't part of any group, it shows up in the "Uncategorized" category.
...
To edit the case data page through the data dictionary, navigate to Data Dictionary located under Data tab in CommCareHQ. Once the relevant dictionary is selected, you will see multiple options per case property, as displayed in the screenshot below.
...
From here, you can use the arrows on the left to rearrange the properties, assign properties to different Case Property Groups, which will group and tabulate them, and add relevant labels and descriptions.
Case Data Export integration with Data Dictionary
Data Dictionary is also integrated with Case Data Export. You can use Data Dictionary of a case type to create a new Case Data Export configuration for that case type. As per this functionality, you can see the option “Export Case Data“ on Data Dictionary of case type .
...
Upon clicking on this button, you will be redirected on to the Case Data Export configuration of the case type with prepopulated case properties defined on the data dictionary along with apps and other sources.
...
The newly created Case Data Export configuration contains a new tag for certain case properties. This tag specifies the name of the ‘Group’ of the case property which was defined on the Data Dictionary. If a case property is not associated with a case property group in Data Dictionary, then this tag will be empty for that case property.
You can make changes to this Case Export Configuration as per your requirements and save the configuration as needed.
Deprecating & Delete Case Types and Case Properties
...
Click on the "Data" menu item and then select "Data Dictionary" from the left pane
Then click on the case type to be deleted in list of available case types.
Finally, click on the button to delete the case type.
...
Please note, a case type cannot be deleted if there are cases that use this case type.
...
Click on the "Data" menu item and then select "Data Dictionary" from the left pane.
Then click on the case type that contains the case property you would like to delete.
Click on the bin icon next to the case property that should be deleted.
Finally, click on "Save".
...
Please note, a case property cannot be deleted if there are cases that use this case property.
Restoring a Deleted Case Property
...
You can deprecate case types or case properties using the Data Dictionary . This is useful for when you don't want to delete historical case types or case properties but you wish to hide them.
...
Deprecated case types are not shown by default when loading the Data Dictionary. You can show deprecated case types by clicking on the “Show Deprecated Case Types” button.
...
Deprecating a Case Type
You can deprecate a case type by following these steps:
Click on the "Data" menu item and then select "Data Dictionary" from the left pane
Then click on the case type to be deprecated in list of available case types.
...
When you select the deprecate option, you will be informed of how many modules use this case type and the impact of the deprecation.
...
Click on the confirm button to deprecate the case type, and it will be marked as deprecated, as shown in the below example.
...
Restoring a Case Type
To restore a case type once it has been deprecated, select the case type from the case type list in the Data dictionary
Then click on the "Restore Case Type" button
...
The case type will be restored and will no longer be tagged as deprecated.
...
The reports case type filter dropdown option will not include deprecated case types as available options.
It will not be possible to create a new case data export using a deprecated case type. Existing exports using deprecated case types will not be affected, but a deprecated tag will appear next to the export.
Users will not be able to import deprecated cases using Excel. If importing multiple cases in a single Excel file, only the cases belonging to case types that have not deprecated will be imported.
A new automatic rule cannot be created using a deprecated case type. Existing rules using deprecated case types will not be affected, but a deprecated tag will appear next to them.
A warning banner will be shown when building a new release on an application that uses one or more deprecated case types. The warning will not prevent a user from making a new build on the application.
A warning banner will be shown on the case details page for a case that has a deprecated case type.
...
You may deprecate case properties or case group properties by selecting the deprecate icon next to each of the definitions for the property.
...
You can view deprecated properties by clicking the "Show Deprecated" button.
...
Once the button has been clicked, the deprecated properties will be displayed. Upon activating the button, the option to restore You can restore the deprecated case property by clicking on “Restore” button.
...
Upon clicking the “Restore” button, the deprecated properties will be displayedactivated again.
...
Effects of Deprecating Case Properties
...
1. The first step is to initiate the import process. Select the Import from Excel option.kk
...
2. Prepare the file to import: CommCare will show a page for importing the Excel file, which includes the option for downloading the data dictionary definition since it is always a good idea to download the definition first. Here is an example of a file definition we are using for the same file that we downloaded from the export data definitions step. A new property will be added to the file definition by adding a new line.
...
3. Import the file: Select the file and select the "upload data dictionary" option. After the import is completed, CommCare will display a message about the import.
...
If an invalid case property name or case type name is included in the import spreadsheet, appropriate error messages will be displayed until all issues are resolved. You can refer to the screenshot below for an example.
4. Check the updated definitions: On the left menu, click the Data Dictionary option to view the updated definitions.
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
There are certain criterias to the name of case-types and case properties,
|
