Views give teams insight into data from various development lifecycle management
applications, and show relationships among artifacts. The artifacts can be requirements, test plans,
test cases, change requests, work items, or other indexed information. Use artifacts as building
blocks to create the views that you need and custom artifact elements to include design models in
your views.
Before you begin
By default, only administrators 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 a 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 View properties and
Properties.
You can create a view from scratch, or from an existing view. In the following steps, you create
a view that is called Sample.
You can use two types of elements to create views:
- Artifacts are organized by type, and are retrieved directly from the
index. You use the same artifacts when you build your reports in Report
Builder.
- Custom artifact elements contain artifacts that are gathered from the
index by a SPARQL query. If you do not see the custom artifact elements on the
Palette tab, ask your administrator to deploy the content packages that are
available on the application administration Contents page.
Use artifacts as building blocks to visualize the data you need to track. Instructions for
building a view with artifact are available in the view editor, on the view canvas. The online
directions are displayed after you create a view ().
After you complete the steps, the view looks like this image, but it contains your data. You can
hover over each container to see more details.
To learn more, see the "Building views with "
video.
Procedure
- From the menu, click Views.
- Under Create, click View.
- In the Create a view dialog box, set up the view.
-
In the View name field, specify a name for the view, such as
Sample.
-
Save the view in the default My views folder.
You can save the view in your private views folder after you test the view and is satisfied with
the test results. You can share the view with your team after the testing is complete.
- Set the kind of view to be created. Select the default Create empty
view setting as this view is empty.
- To apply existing formatting to the view, in the Style name
list, select a style from the list.
-
Select the data source for your view. The list of data sources is displayed as configured in
the Report
Builder
- Automatic: This option uses the data source as 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: This option shows all data from configurations and from projects that do not use
configurations.
- Lifecycle Query
Engine scoped by
a Configuration: This option shows data from the selected configuration.
If the project teams use the local or global configurations, team members select a configuration to work in when
they run a view. Only artifacts that pertain to the selected configuration context are shown in the
view.
- In the Configuration context field, click the pencil icon to
select the configuration. For more information, see Selecting a configuration for a view.
-
Click Next.
- To limit the scope of view, select the projects whose artifacts you want to show in
the view.
- If you do not select any project area, the view that you are editing includes all the project
areas that you can access.
- If you select all projects, the view includes only the selected projects. If a new project is
created later, its data is not automatically included when you run the view.
When you update the data source, the project areas are also updated and the corresponding
artifacts load under the Palette tab.
-
Click Finish. The view opens in the view editor.
-
Configure how users select nodes in a view.
On the
Properties tab, set the node selection mode.
- Disabled: View users cannot select nodes in this view.
- Single node: View users can select only one node in this view.
- Multiple nodes: View users can select multiple nodes in this view. If you
create a new view, Multiple nodes is the default setting. If you create a
view by modifying an existing view, the node selection mode of the new view has the same setting as
the original view.
-
Follow the steps in the Quick view setup assistance to create the
Sample view.
Use artifacts to build your view. To show related artifacts, right-click an artifact container,
and select a relationship type or an artifact type that you want to explore.
If you make an incorrect change, use the Undo icon to remove the change.
If the view shows many artifacts and takes a long time to load the artifacts after each change,
click the Stop loading icon. Then, arrange your view and load the artifacts
when you are ready.
Resize a container by dragging the container border. For more information, see Lesson 2: Populate a view with artifacts.
- Edit properties, such as background, user interface types, and artifact nodes by using
the View properties editor. For more information about setting background
color, see Changing the view background color.
When you hover over any of the containers onto the view canvas, you can see the
colors that are specified for the container border, nodes, selected node, and modified node. You can
change these colors and restore the previous color value by using the
Container border
color section in the
View properties editor. For more
information, see
changing container border
manually.
- Edit the relationships to make them visually unique.
-
Right-click the dashed arrow between containers, and select Edit
relationship.
-
In the Relationships dialog box, change the
relationship arrows by setting the UI type to
Round relationship
.
-
Change the relationship color in UI parameter by
changing the value of stroke to orange.
-
Save your changes by clicking Ok.
-
Save the view.
-
If you want to edit the view, but you do not want to overwrite the original view you created,
select Save copy. Give the view a unique name, and continue making any
necessary changes.
- If you are satisfied that the view results are valid, share the view.
-
In the My views screen, hover over the Sample view,
and click the Move or Copy selected views icon.
-
Choose to copy the view into a folder in Shared views, and then click
Ok.
-
The view is available to other team members in the Shared views
folder.