Dependent Lookup

The dependent lookups feature enables the creation of dropdown selection boxes where the options presented in the dropdown are based on the option selected in another dropdown

An example application could be a location table with countries, states or counties, cities and currencies

Selecting a country from the first dropdown would then restrict the cities presented in the next dropdown to only those in the selected country

Loading a dependent lookup dataset

The data to be loaded should contain an Id property with a unique identifier for each row and the properties loaded in order of dependence

Ensure that your table does not contain any blank cells in dependent levels

Example Dataset

Creating a dependent lookup requires the lookup dataset to be loaded via Settings with the following details

Edit Details Screen

1. Dataset type should be either be set to Lookup or if another dataset type is selected then it should be tagged lookup
2. The lookup dataset must contain a unique identifier property for each row in the dataset, in addition to properties that will be used as dropdowns, this identifier property must be selected as the auto ID when loading the dataset
3. The label property may be set to any property in the lookup dataset as it will not be used in this process
4. Node relationship should be set to Flat
5. Enable any users to access dependent lookups within main dataset by applying at least Read Only permission

Configure Properties Screen

1. When configuring properties for the lookup, there are no specific property key requirements for the auto ID property however all lookup dataset property keys must be an exact match for property keys in the dataset that will reference them
2. Properties should be loaded in descending order of levels e.g. Country , County / State then City
3. Properties to be used as lookups should be checked as Dependent

Setting Up A Dependent Lookup

To make the dependent lookup values loaded in the lookup dataset available for use with the target dataset e.g. PEOPLE or POSITIONS the lookup relationship needs to be set up via the property manager of the target dataset

To do this open the property manager for the target dataset either in Workspace Property Manager or Settings Property Manager

The target dataset must contain an empty text property that can be linked to the Lookup dataset id property. This property will be set as Read Only as part of the setup process and property values will be populated once selections are made from the dependent lookups

While the setup process will allow the use of any property key and display name for the empty property it is recommended to use lookupid or similar to help identify this property as being used for the dependent lookup process in the future

1. Select the empty property to be linked to the lookup
2. Select the Values tab
3. Select the Provide users with a set of values option
4. Select Provide values from a Lookup Dataset (Manual) the Auto option may be selected if the Lookup Dataset name matches the selected Property Key
5. If using the Manual option select the Lookup Dataset from the list
6. Select Save to complete the lookup

Orgvue will then match the remaining dependent property keys from the Lookup dataset to the corresponding property keys in the target dataset to complete the setup process

Selecting any of the other dependent properties in the property manager after this matching process will show the options on the values tab greyed out with a message to show the property cannot be edited

Dependent Lookup In Use

Once set up, adding the properties to a worksheet will allow you to select the required value from the dropdown for one property and dropdown options that are then available in other properties will be focused to valid dependent values

Dependent Lookup Buckets

When viewing buckets for dependent lookup properties, additional detail is shown in brackets to indicate parent dependency

Dependent Lookup Bulk Edits

It is possible to apply dependent lookup values to multiple cells at the same time by holding down the CTRL key (CMD on a Mac) while selecting the cells and the required option in the dependent dropdown

Bulk editing via drag and drop within filter buckets is also possible

If your modifications necessitate reselecting lower dependencies the modal will alert you and guide you through the process