Changing how nodes display in views

When you edit views, you can change the appearance of the nodes in the view containers. For example, you can modify the node title, or highlight artifacts that meet specific conditions.

Before you begin

By default, only administrators can create or edit shared views. To request permission to create or edit views, contact your administrator.

About this task

In the following steps, you use the node editor to change the node layout.


  1. Create a view named Sample.
  2. In the editor, drag a Story artifact onto the view canvas.
  3. Open the node editor. Right-click an artifact in the view, and click Edit Node.
  4. Change the size of the node to show longer node descriptions. On the UI Type page, change the width value to 300.
  5. Change the node description.
    1. From the UI Type list, select baseResourceNode.
    2. Click the pencil icon to edit the parameter for title.
      Change the description of the node
    3. In the Parameter window, from the Default Value list, select an attribute that you want to display as the description of the node. For example, in the following example, Id is selected for display.
    4. Click OK.
      Flowchart to change the description of the node

    In the above example, the description of the Story node shows the ID on the first line and the title on the second line.

  6. Create a new UI type. To create a new UI type, click the pencil icon next to the UI Type list.
    Changing the UI type for view nodes by using the node editor
    • To create a new blank UI type, click Add, enter a UI type ID, and configure the parameters.
    • To make a copy of a UI type from the list, select the UI type, and click Duplicate. Enter a UI type ID, and configure the parameters.
    For UI types marked with (System), you cannot modify the parameter values.
  7. Use conditional parameters to change the appearance of the nodes when the represented artifacts meet specific conditions that you define.
    For example, configure the node color to change if the status of an artifact meets specific conditions:
    • If the story status is New, the node color is blue.
    • If the story status is Done, the node color is green.

    To set the story node color in the view based on these conditions, follow these steps:

    1. Click the Edit Parameter icon near the Fill UI parameter.
      Set conditional parameters to change nodes based on artifact attributes
    2. In the Parameter: fill window, click Add Conditional Parameter.
      Adding a conditional parameter.
      A blank line is added for the new conditional parameter.
    3. Click the pencil icon in the new line to edit the condition.
      In the Conditions window, click Add. Configure your condition on the Set Condition page.
      1. Select a property name from the list of attributes.
      2. Select an operator.
      3. Select the appropriate property value to define your condition.
      4. Click OK in the Set Conditions window.
        How to edit conditions for setting conditional parameters in views.
      5. Click OK in the Set Condition window.
      6. In the Conditions window, you can add other properties. Click OK when you are ready to save your conditions.
    4. Click the pencil icon to edit the parameter value.
      Selecting a parameter value.
      Select a color from the list.
    5. Repeat steps b, c, and d to add conditions.
    6. Select a color as default value. Nodes that do not fulfill the configured conditions, will have the default color.
    7. Click OK to save your settings.
      Example of configured conditional parameters.
      Note: You can also set the Fill Type parameter to Pattern in the Fill property dialog box and set the Image URL to display an image as node background.
      Set the Image URL to display an image as node background.
      However, image files are susceptible to malware attack. To prevent the attack, you must add the domains of the images in the whitelist. See Managing the whitelist for uploading images.
    Based on the defined conditional parameters, if the status of a story is New, the node color is blue. If the status of a story is Done, it is highlighted in green. When the status of an artifact changes in the original lifecycle management application, the color of the node in the view changes according to the conditional parameters that you defined for the nodes.
    Example of node color that is defined with conditional parameters


  • The story nodes in your view display the story number and the artifact title, as defined by the taskNode UI type.
  • Because your view uses conditional parameters to highlight the artifact status, every time your team members run the view, the nodes colors change according to the conditions that you configured, reflecting the latest status of the project.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki