= Overview = It's not enough that bxp stores data records but making them easily accessible is just as important. In each of the form based modules you have a lookup capability. The appearance, settings and capabilities of these search tools are customisable. This article looks at how to customise the tools. = Lookup in modules = * Inbound Contact [[File:009.png]] ** My Data - Admin View > Lookup an entry** My Data > Lookup an entry - For Edit** My Data > Lookup an entry - For Listing** My Data > Lookup an entry - Dynamically * Outbound Contact [[File:012.png]] ** My Data > Lookup a record (Campaign Specific) * Case Management [[File:024.png]] ** My Cases > Look up a Case * Quality Assurance [[File:030.png]] ** Approach 1 - Perform an Assessment > Lookup an assessment** Approach 2 - Provide an Assessment > Lookup an assessment = Setup = == Default Setting == In bxp, it is possible to look up records on a form and specify what fields are displayed as part of the search results and when you're searching. For all our examples we'll use the following tool ''Main Menu > Inbound Contact [[File:009.png]] > My Data > Lookup an entry - For Edit > Choose your form'' By default, when you look up a record on a form, you can search on any field and the results will display the ID.
[[File:SearchFields-IDonly.png|800px]]
This alone makes it difficult to pick out the correct record from the search results. There are a few different options on the search values page that allow a user to specify what fields users should be able to search on and what values are displayed in the results.
The first option allows a user to change the default search result field from ID to any other field in the form.
== Changing the settings == ''Main Menu > Form Management [[File:038.png]] > Form - Primary Management > Form - Displayed Search Fields > Choose your Form > '' There are a few different options on the search values page that allow a user to specify what fields users should be able to search on and what values are displayed in the results. The "Current status" column shows the settings as they were when you entered the form. The first column of options "New Status" allows an administrator to change the default search result field from ID to any other field or fields in the form. Just setting items in the first column to True will result in that field being displayed in the search results. The second column "Show on Lookup" allows the administrator to restrict what fields are searched by. This is then very handy for limiting down the fields on a list big form with lots of question with options next fields, to each onejust the main fields of searching.
[[File:SearchFields-MainPage.png|800px]]
The current status field will be false if the field doesn't display it's value in the search results and true if it does. The new status field can be used to change this. For example, if a user changes the status of the field "Name" from false to true, then the value of the Name field will be displayed when user look up records on this form.
[[File:SearchFieldsID&Name.png|800px]]
The show on lookup field determines if a field will be visible on the look up screen. If for example, you only want users to be able to search by Name and ID then you could set everything apart from Name to false and when a user looks up a record, they can only use ID or Name to find the record they're looking for.
[[File:SearchFields-Namesearch.png|800px]]
[[Category:Module Specific:Form Management]]