CUD UI simple searching
The interface for simple searching provides a list of queries which have been previously run and saved.
Access the simple searching interface
To access the Simple Searching interface:
- Navigate to the Core User Directory User Interface (CUD UI)
- Select Simple Searching
- Log in with your Oxford username and Single Sign-On (SSO) password
Create a new query
Click the New Query button to create a new query.
A new query is built in a query builder screen which offers tools to set criteria for a commonly used subset of data stored in CUD.
- Click on the Edit button (resembles a pen icon) to enable the Criteria for editing.
- Criteria can be set on attributes selected from a drop-down list (see Appendix A) and an equals or not equals operator selected.
- You will need to select an attribute from the Attribute drop down list (see Appendix A) and include a search Value here.
- Once you have populated the criteria, click the Tick icon button to confirm and include the line in the query.
- For values for filtering on students' SITS attributes, see CUD Attributes - SITS
- For values for filtering on people's affiliations, see CUD affiliations - values. You should filter on the short-name values rather than the full Unit description.
- For other filters' values, see CUD attributes for examples.
- Additional criteria can be added using the AND or OR operator (please note that you should also use parentheses when using the OR operator).
The Max results value refers to the number of results to be displayed in the page.
When all criteria are set, click the Search button to execute the search.
Results are displayed further down the page and are useful to view a subset, or even a small results set, to check that values are as expected. It does not need to be the full results sets; and indeed, to download the full results set it is recommended to use the csv, xml or json buttons provided with the results, then save from the provided hyperlink.
Providing a Query Name allows you to save the query so it can be run again. A saved query is also assigned a reference which enables you and others to reference this query when using the web services interface.
The Simple Searching home page lists your saved query to be edited or run to explore the formats in which data is available, these being CSV, XML or JSON.
A tickbox to Use structured data format is available for the XML or JSON buttons. When you open the resultant hyperlinked document you will see that there is extra information contained: the dates that attributes were added and last updated, previous values, the sources of the attributes, etc. This is useful when you wish to see the dates that certain attributes were added or updated. Previous values are also visible in this structured data format.
Appendix B provides more information on data structures and formats.