Creating a view by using custom containers

When you create a view to visualize the engineering artifacts for your project, you can use empty containers, and customize them to fit your project needs. When you create custom containers, you can add text elements, or images to the container. You can also drag more than one container onto a container, and each container can run a unique query.

Before you begin

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

About this task

The editor is an easy way to control the data in the view, and the view layout. Learn about the editor by hovering over the small question mark next to Page Properties and Properties.


  1. Create a view that is called Custom Sample. In the main menu, go to Views > Create View.
  2. In the Create a view dialog box, set up the view.
    1. Give the view a name of Custom Sample.
    2. Save the view in My Views.

      Save the view in your private views folder until you thoroughly test the view, and are satisfied with the results. After your testing is completed, share the view with your team, if appropriate.

    3. Set the kind of view to be created. This view is empty, so do not change the Create empty view setting.
    4. If multiple data sources are configured in the Report Builder, select the right data source for your view.
      • Automatic: Use the data source that corresponds to what is selected in the Current Configuration menu.
        • If it is All Data, the data source is LQE.
        • If it is a configuration, the data source is LQE scoped by a configuration.
      • Lifecycle Query Engine: Shows all data from configurations and from projects that do not use configurations.
      • Lifecycle Query Engine scoped by a Configuration: Show data from the selected configuration.

      If the project teams use configurations within or across project areas, team members can select a configuration to work in. Only artifacts that pertain to the selected configuration context are shown in the view.

    5. Click Next.
    6. To ensure that all the artifacts from all the project areas that you have access to can be included in the view, do not select any of the projects that are listed on the Limit the scope of the view page.
    7. Click Finish, and Custom Sample opens.
  3. Drag an empty container onto the view canvas.

    Go to Palette > Containers, and drag a container onto the canvas.

    You can also drag more than one container onto a container, and each container can run a unique query.

  4. Populate the container by setting a query.
    1. Right-click the empty container, and click Edit Query to open the query editor.
    2. Edit the SPARQL query.
  5. Add connecting lines to view relationships between artifacts.

    Click the view background. On the Properties tab, go to Page Properties > Connections, and click Add. Configure the link type in the Connections dialog box.

  6. Drag Text and Image containers onto the view canvas.

    On the Palette tab, go to Containers, and drag a Text and an Image element onto the canvas.

    Tip: You can also type in the search field to filter the palette item without expanding the list.
  7. Arrange your containers on the view canvas.

    When you rearrange containers on the canvas, you can undo (Ctrl+Z) or redo (Ctrl+Y) a change, until the canvas is arranged.

  8. Add text to the text container.

    Click the new text node. On the Properties tab, go to Properties > Text, click the value to the right of Text, and edit the value.

  9. Add an image to the image container.

    Click the new image node. On the Properties tab, go to Properties > Image Source, click the field to the right of Image Source, and enter the URL for the image.

    Note: Image files are susceptible to malware attack. To prevent the attack, you must add the domains of the images to the whitelist. For more information, see Managing the whitelist for uploading images.
  10. Save the view.

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