Dictionaries are a tool in Ambra that can be used to automatically fix up data as it is coming in. If, for example, you have studies sent into Ambra with a set patient id and you want to add the word AMBRA in front of all the patient ids in your organization, this can be done using a Dictionary.
Dictionaries can be set up by navigating to the Administration tab, going to the more dropdown tab and selecting Dictionaries.
NOTE: If you do not see the Dictionaries option, be sure that the Dictionary permissions are turned on in your role settings.
To create a Dictionary, you will first need to name it and then select the object you want to apply the Dictionary to. In the object dropdown menu, if you select “Study”, then your Dictionary will apply to studies that are uploaded into your account.
Next you can choose what namespace you would like to apply your Dictionary to. You can do this under the “Attach” by selecting “Add namespace.”
Next you will need to fill out the “Lookup” section. The “*Lookup field names” points the Dictionary to the information that will be changed. If you were looking for Study patient id, then the lookup field could be set to [“patientid”]. The “*Replace field names” tells the Dictionary what is ultimately going to be changed by the Dictionary. If you would like to change the Study patient id, then you would also put [“patientid”] in this field as well.
The last section is the “Entries” section. This is where you specify the change you want to make. For example, if you wanted to add AMBRA to the start of every patient id, then your “*Entry lookup field” may search for all Studies coming into your organization and your “*Entry replace field” will specify that you would like to add AMBRA to the start of your patient id.
This section can be written in regular expression. For the example of adding AMBRA to the patient id it would look like this:
This is just one example of how studies can be automatically formatted using Ambra Dictionaries.
If you have any questions about Dictionaries, please feel free to reach out to Ambra Support at firstname.lastname@example.org. We are happy to assist!