(Update with the copy of version: 8.5.1DRAFT)
m (1 révision importée)
Ligne 1 : Ligne 1 :
 
= Metrics Library=
 
= Metrics Library=
  
A library serves as a shortcut to select a list of metrics. You can create Metrics Libraries from the '''Libraries''' tab on the '''Column Chooser'''. Only metrics to which you have access are displayed on the dashboard (see [[Access|Role-Based Access and Permissions]]).
+
A ''metrics library'' is a shortcut method for selecting the list of metrics to display on your dashboard. You can create metrics libraries in the '''Column Chooser'''. Only metrics to which you have access are displayed in the '''Column Chooser''' (see [[Access|Role-Based Access and Permissions]]).
  
The Metrics Library enables you to:
+
A metrics library enables you to:
  
* Create reusable lists of metrics to display on the dashboard. For example, you could create a set of metrics that might be required for a specific management task, such as a set of non-voice metrics.
+
* Create reusable lists of metrics to display on the dashboard. For example, you could create a set of metrics that might be required for a specific management task, such as a set of non-voice metrics.
 
* Maintain those lists.
 
* Maintain those lists.
  
The library drop-down list contains a list of the libraries that you have created in addition to the default library. The default library is simply the default list of metrics displayed as configured in the Administration module. If no libraries have been created, there are only two entries in the library drop-down list:
+
Once you have created personal metrics libraries, you can quickly switch the list of metrics that displays on your dashboard by choosing from the list of libraries in the '''Select''' drop-down list at the top of the '''Column Chooser''' window.
  
* Default
+
If no new libraries have been created, there are only two entries in the '''Select''' drop-down list:
* From Dashboard: Retrieves the metrics exactly as displayed on the dashboard.
+
 
 +
* Default: The default list of metrics to display on the dashboard. An administrator configures this list of metrics.
 +
* From dashboard: Retrieves the metrics exactly as displayed on the dashboard.
  
 
==Creating a New Library==
 
==Creating a New Library==
 +
As you create libraries, they are added to the '''Select''' drop-down list of libraries. When you select a library, the description of that library is displayed next to the drop-down list, and the '''Selected Metrics''' pane is cleared and populated with the list of metrics that make up the library.
 +
 +
To create a new metrics library:
 +
# Choose an existing library from the '''Select''' drop-down list. For example, if you have not yet created any metrics libraries, you might select '''From dashboard''' to get started. If you previously created a metrics library, and you want to use that library as the basis for a new library, then select that library.
 +
# Click '''Save as New Library'''. If you selected a library that you previously created, and you want to copy it as the basis for a new library, then click the clone ([[File:pma_ccadv-wa_clone-button_cc_852.png|20px|link=]]) button.
 +
# Enter a name for the library. The library name cannot be changed after the library is saved, so be sure to carefully consider what you will enter for the library name.
 +
# Enter a description (optional). If you create multiple libraries, the description can help you to remember the specific purpose of the library. The '''Description''' field is editable, so you can always change it later if you decide it could be improved.
 +
# Add your personal selection of metrics to the '''Selected Metrics''' pane. See [[MetsColumns#selectmetrics|Selecting Metrics for Dashboard Display]] for information about working with the '''Available Metrics''' and '''Selected Metrics''' panes.
 +
# Click '''Save''' (or '''Cancel''', if you decide to discard this library without ever saving it).
 +
 +
 +
===Editing a Library===
 +
You might decide that one of your metrics libraries is missing a key metric, or it might have a few more metrics than you need. You cannot change the name of a metrics library after it has been saved,  but you can add or remove metrics. You can also change the library description.
 +
 +
To edit a saved metrics library:
 +
# Choose an existing library from the '''Select''' drop-down list.
 +
# Make your changes to the library.
 +
# Click '''Save'''. If you decide, after you have made changes, but before you click '''Save''', that you do not want to make these library changes after all, then do not click '''Save'''. Instead, choose a different library from the '''Select''' drop-down list. This cancels the update to the library; the library reverts to its previous state.
 +
 +
If you ever make unwanted changes to a saved library, navigate away from the library using the '''Select''' drop-down list. When you return to the library, it will be restored to the previous, unaltered state.
 +
 +
==Deleting a Library==
 +
You cannot delete the '''Default''' or '''From dashboard''' libraries, but you can delete a metrics library that you created. To delete a metrics library:
  
# Select '''Create New''' from the '''Library''' drop-down list.
+
# Select the library in the '''Select''' drop-down list.
#:The '''Save As,''' '''Reset,''' and '''Delete''' buttons are disabled at this point.
+
# Click the trash can ([[File:pma_ccadv-wa_trash-button_cc_852.png|15px|link=]]) button.
# Add a name for the library.
 
# Enter a description (optional).
 
# Add metrics to the library.
 
# Click '''Save.''' When the library is saved, the remaining buttons on the page are enabled.
 
  
As you create libraries, they are added to the Libraries drop-down list. When you select a library, the description of that library is displayed next to the drop-down list, and the Selected Metrics pane is cleared and populated with the list of metrics that make up the library. Metrics that are not included in that list are displayed on the '''Available Metrics''' pane.  
+
The library is permanently deleted.
  
You can either add more metrics to the '''Selected Metrics''' pane by selecting them on the '''Available Metrics''' pane or remove metrics from the '''Selected Metrics''' pane.  However, if you select a different library from the drop-down list, all the metrics on the '''Selected Metrics''' pane are replaced with the list of metrics that are part of the newly selected library.
 
  
 
[[Category:V:PMA:DRAFT]]
 
[[Category:V:PMA:DRAFT]]

Version du octobre 3, 2017 à 17:59

Metrics Library

A metrics library is a shortcut method for selecting the list of metrics to display on your dashboard. You can create metrics libraries in the Column Chooser. Only metrics to which you have access are displayed in the Column Chooser (see Role-Based Access and Permissions).

A metrics library enables you to:

  • Create reusable lists of metrics to display on the dashboard. For example, you could create a set of metrics that might be required for a specific management task, such as a set of non-voice metrics.
  • Maintain those lists.

Once you have created personal metrics libraries, you can quickly switch the list of metrics that displays on your dashboard by choosing from the list of libraries in the Select drop-down list at the top of the Column Chooser window.

If no new libraries have been created, there are only two entries in the Select drop-down list:

  • Default: The default list of metrics to display on the dashboard. An administrator configures this list of metrics.
  • From dashboard: Retrieves the metrics exactly as displayed on the dashboard.

Creating a New Library

As you create libraries, they are added to the Select drop-down list of libraries. When you select a library, the description of that library is displayed next to the drop-down list, and the Selected Metrics pane is cleared and populated with the list of metrics that make up the library.

To create a new metrics library:

  1. Choose an existing library from the Select drop-down list. For example, if you have not yet created any metrics libraries, you might select From dashboard to get started. If you previously created a metrics library, and you want to use that library as the basis for a new library, then select that library.
  2. Click Save as New Library. If you selected a library that you previously created, and you want to copy it as the basis for a new library, then click the clone (Pma ccadv-wa clone-button cc 852.png) button.
  3. Enter a name for the library. The library name cannot be changed after the library is saved, so be sure to carefully consider what you will enter for the library name.
  4. Enter a description (optional). If you create multiple libraries, the description can help you to remember the specific purpose of the library. The Description field is editable, so you can always change it later if you decide it could be improved.
  5. Add your personal selection of metrics to the Selected Metrics pane. See Selecting Metrics for Dashboard Display for information about working with the Available Metrics and Selected Metrics panes.
  6. Click Save (or Cancel, if you decide to discard this library without ever saving it).


Editing a Library

You might decide that one of your metrics libraries is missing a key metric, or it might have a few more metrics than you need. You cannot change the name of a metrics library after it has been saved, but you can add or remove metrics. You can also change the library description.

To edit a saved metrics library:

  1. Choose an existing library from the Select drop-down list.
  2. Make your changes to the library.
  3. Click Save. If you decide, after you have made changes, but before you click Save, that you do not want to make these library changes after all, then do not click Save. Instead, choose a different library from the Select drop-down list. This cancels the update to the library; the library reverts to its previous state.

If you ever make unwanted changes to a saved library, navigate away from the library using the Select drop-down list. When you return to the library, it will be restored to the previous, unaltered state.

Deleting a Library

You cannot delete the Default or From dashboard libraries, but you can delete a metrics library that you created. To delete a metrics library:

  1. Select the library in the Select drop-down list.
  2. Click the trash can (Pma ccadv-wa trash-button cc 852.png) button.

The library is permanently deleted.

Comments or questions about this documentation? Contact us for support!