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.

Procedure

  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. In the UI Type drop-down list, select what template to use for the nodes. For example, select taskNode for your story nodes.
    Changing the UI type for view nodes by using the node editor
    If you want to create a new UI type, click the pencil icon. For UI types marked with (System), you cannot modify the parameter values.
    • 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.
  6. 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 Condition window.
        How to edit conditions for setting conditional parameters in views.
      5. 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

Results

  • 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

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki