Colouring Nodes by a specific property

A common request is how to configure orgvue so that the Nodes in a tree view are coloured with specific colours to reflect a property of that Node, say the Node's Department so that the end result is this : -  

This worked example will explain how to assign a specific colour to the Nodes in a tree view to indicate the Node's Department value.

1  Create a spreadsheet

Create a new spreadsheet listing the Department values and the colour you assign to each. The spreadsheet should have only two columns, and they must be 'id' and 'color' : -

Note that you can use either hex codes or the name of the colour. (Click on this sentence to see the full list of available named colours.)

2  Create a new dataset and set it to be a lookup

• From the orgvue Homescreen select 'Settings' from the three line menu top left - a new browser window will open 

• From Settings select the datasets icon top left and then click on the '+ Dataset' button at top right : -

• Click 'Click here' and choose the spreadsheet you created in step 1 above and click the 'Next' button bottom right of the screen when it has loaded : -

• For step 2, the worksheet name defaults into the 'Dataset Name' field (you can change this to what you want).
• Check the 'Worksheet' field to ensure it refers to the correct worksheet in your source file.
• Set the 'Dataset Type' field to 'Lookups'.
• Ensure the 'ID' field is set to "id" and that the 'Node Relationship' is flat.
• Validate that the content shown in the two thirds of the screen to the right matches what you expect.
• Click the 'Next' button bottom right of the screen.

• At step 3 ensure that the 'id' property has a type of text and then click the ''Upload' button at bottom right of the screen : -

• You should see this to confirm that you have been successful. Click 'Back to Datasets' : -

3  Set the 'Department' Property to point at the new Lookup Dataset 

• Identify the Dataset you wish to apply this lookup to and then click on the three dots to the right of 'Edit' and finally 'Manage properties' : - 

• Select the 'Department' property and then click 'Edit', top right : -

• Check in the 'General' tab that the 'Property Type' is set to 'Text : -
  • • In the Lookups tab set the 'Lookup Type' to be 'Dataset' and from the 'Target Dataset' field select the lookup dataset you created in step 2 above from the drop down list : -
• Finally, click the 'Apply' button bottom right of this side panel and then 'Close'.

4  Select the Colour by Property in the Homescreen

• Return to the Homescreen's browser tab and select the relevant Dataset and Pack, open the Colour control and select 'Multi', set the 'Color by property' to 'Department' and finally select any colour palette and then  Apply' : -

• This will colour the nodes in a categorical manner using the colour palette you selected, so you should now click on the 'Reload Datasets' button top right of the screen : -

• This should result in the nodes being coloured according to the relationships established in the spreadsheet you started with, and by clicking on the 'Legend' button top right you can display the Colour > Department relationship : -