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.

1. Create a view from the main menu, go to Views > Create view.
2. In the Create a view dialog box, set up the view.
   1. Name the view as Custom Sample.
   2. Save the view.

      The view is shown in the My views page.

      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. Optional: 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. On the Limit the scope of the view page, select the required project area.
      Important: To include all the artifacts from all the accessible project areas in the view, do not select any of the projects on the Limit the scope of the view page.
   7. Click Finish. The Custom Sample view 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 View properties > Relationships, and click Add. Configure the link type in the Relationships 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 allowlist.
10. Save the view.