Working with the ITRM Gallery Task

Access and Navigate the ITRM Gallery Task

To access the ITRM Gallery task, perform the following steps:
  1. Open or create a SAS Enterprise Guide project that includes one or more report tasks, custom tasks, or program nodes.
  2. Select Toolsthen selectAdd-Inthen select ITRM Gallery.
To navigate through the pages of the ITRM Gallery task, use the following buttons:
Back
displays the previous window in the ITRM Gallery task.
Next
displays the next window in the ITRM Gallery task.
Save
saves the current specifications set in the ITRM Gallery task and creates an ITRM Gallery task object in the process flow diagram of the SAS Enterprise Guide project. The save option does not create a report definition. It simply saves the ITRM Gallery task object that you can use to create a report definition.
CAUTION:
When working with SAS Enterprise Guide, you must always save your projects frequently to keep updates to the tasks in the project.
If you select Save in the ITRM Gallery task, then the specifications for the ITRM Gallery task are saved for the current instance of the project. However, if you do not also save the SAS Enterprise Guide project, then the updates are lost when the project is re-opened.
Finish
performs the same functions as Save and creates a report definition that is stored on the SAS Metadata Server.
Note: You must click Finish to create a report definition. The save option alone does not create a report definition.
Cancel
abandons changes that were made since the last save and closes the current page.
Help
displays a Help topic for the current page. For information about each field on the ITRM Gallery task pages, see the Help.

Create Report Definitions Using the ITRM Gallery Task

To name and define report definitions for a SAS Enterprise Guide project, perform the following steps:
  1. Open or create a SAS Enterprise Guide project that includes one or more report tasks, custom tasks, or program nodes.
  2. Select Toolsthen selectAdd-Inthen selectITRM Gallery from the task list in SAS Enterprise Guide to display the Name page of the ITRM Gallery task.
    ITRM Gallery Task Name and Description Page
  3. In the Name field, enter the name of the ITRM Gallery task. This is the name that the ITRM Gallery task assigns to the report definition that it creates. The name must be unique for the current metadata path, or the new ITRM Gallery task will overwrite the report definition that has the same name.
    Note: SAS IT Resource Management supplies sample projects that name ITRM Gallery task objects and report definitions by using descriptive words that indicate the following: the measures that are reported, the filters that are used, and the time period that is reported. For example, SystemCpuHighUsagePlotIntervalsForTheDay. For best results, use this naming convention or your own to create consistent names that are easy to understand and locate in the SAS Metadata Server.
  4. In the Description field, enter a description of the ITRM Gallery task. Entering a description in this field is optional but recommended.
  5. In the Specify path for report definition field, specify a metadata path where you want to save the report definition. Click Browse to select the folder that you want to contain the report definition for the reports that are included in the ITRM Gallery task.
    The metadata folder that you select resides in the SAS Metadata Repository and is available from the SAS IT Resource Management client. The folder that you select will contain the report definitions for the reports that are included in the ITRM Gallery task.
    For best results, save your report definitions in /Shared Data/SAS IT Resource Management/<SAS IT Resource Management version number> IT Report Definitions/<adapter>/<domain category>/User Defined/<time period>.
    CAUTION:
    Do not save your user-defined report definitions in the folder that is named Supplied in the preceding path.
    The Adapter Setup wizard uses the report definitions in the Supplied folder when generating reporting jobs. If you add or modify report definitions in the Supplied folder, then the associated Adapter Setup wizard jobs might lose the IT intelligence that SAS IT Resource Management provides. Your modified report definitions might also be overwritten when you install any software updates for SAS IT Resource Management.
  6. Use the Include data path in report definition option to enable or disable the storing of the current data path in the report definition. The default and recommended value is No because it provides greater flexibility and portability of report definitions. In this case, the data path value in the report definition is left blank, and the Gallery transformation that uses the report definition will search for the data within the corresponding folder for the given job.
    The Yes value indicates that the report definition explicitly specifies the data path as the current data path that was used when the report definition was created. Select Yes only if your data path is unique, unchanging, and outside the job folder for the report definition. The Gallery transformation that uses the report definition will then search for the data within the same data path that was used when the report definition was created.
    For more information, see Specifying a Data Source Location.
  7. Click Next to access the Options page.
    ITRM Gallery Task Options Page
  8. On the Options page, you must select one or more reports from the list of report tasks that are in the current process flow. All of the reports that you select will use the same specifications and report filter settings.
    Note: If you want to assign different settings to various reports, you must create a separate ITRM Gallery task. For example, line plots use the graph format of ActiveX for dynamic features while tile charts are most useful when Java is used. If you have a project that includes both line plots and tile charts, then you perform the following steps:
    • Create at least one ITRM Gallery task for the line plots that use ActiveX.
    • Create one ITRM Gallery task for the tile charts that use Java.
  9. In the Specifications box, specify the following options:
    Graph Format
    determines the type of graph that you want to generate (ActiveX, Java, or PNG) for the report definition. The default value is ActiveX.
    Note: List reports that are included in your ITRM Gallery task ignore this option.
    Expire Reports After N Days
    calculates the expiration date, relative to the system date at the time that the report is generated. If a report is expired and its report job is run again, the expired report is deleted and replaced with the new report. If a report is not expired and its report job is run again, the previous report remains in the system with the new report that is generated. You can specify an expiration range from 1 to 9999 days. The default value is 1. In this case, reports that are older than one day are deleted when the report job is run.
    Note: This parameter calculates expiration by number of days. When setting the expiration for reports that are run on a schedule other than daily, account for the number of days within the time period in which the reports are run. For example, the expiration value for a weekly report should be some multiple of seven because there are seven days in a week.
  10. In the Report Filters box, specify the filter values that you want to use when viewing reports in the Gallery Manager. These values do not appear on the report. However, they do appear as filter options in the Gallery Manager.
    The options for each filter type can include supplied values and user-defined values. To create, delete, save, or share user-defined values for the filter types, click Manage User-Defined Settings. For more information about managing user-defined values, see Managing User-Defined Settings for Report Filters.
    CAUTION:
    Carefully select the appropriate filters for your reports and ensure that you use correct spellings for user-defined values.
    Assigning an incorrect or misspelled filter to a report does not affect the data or the accuracy of the report content. However, an incorrect filter makes the corresponding report difficult to locate when filtering subsets of reports in the Gallery Manager.
    Domain Category
    specifies the adapter and domain category that you assign to the reports for filtering in the Gallery Manager. The options for this field include the values for the adapters that the Adapter Setup wizard supports as well as any user-defined values. The values are sorted alphabetically in this list. For best results, do not leave this field blank.
    Domain Subcategory
    specifies the report category, a subset of the domain category that you selected. The options for this field include only the subcategories for the domain category that you selected as well as any user-defined values. If the Domain Category value is blank or if the supplied domain category does not include supplied subcategories, then only the user-defined values for domain subcategory are available.
    Job Schedule Frequency
    indicates when the corresponding reports should be scheduled to run and specifies the time period that you assign to the reports for filtering in the Gallery Manager. The options for this field include daily, weekly, monthly, quarterly, yearly, and any user-defined values.
    Note: This value is a report filter in metadata only. It does not schedule report jobs. You can use this value as an indicator to include this report definition in report jobs that are scheduled to run on an interval that corresponds with this value. This value is also used as a filter in Gallery Manager.
    Keywords Available
    lists the keywords that you can assign to reports for filtering in the Gallery Manager. This list includes supplied and user-defined keywords. To add keywords to reports, select one or more keywords from the Keywords Available list and then click Right Arrow. The keywords are added to the Selected Keywords list. To remove keywords from the Selected Keywords list, select one or more variables from the Selected Keywords list and click Left Arrow.
  11. Click Finish. All values are saved in the ITRM Gallery task object, a report definition is created on the metadata server, and an ITRM Gallery task object appears in the process flow diagram with a link to all of the selected reports tasks and program nodes. A message box notifies you when the report definition is created successfully.
    CAUTION:
    Running a SAS Enterprise Guide process flow or project does not automatically run the ITRM Gallery task and create a report definition.
    You must open the ITRM Gallery task separately and click Finish to create and publish a report definition.
    When a report definition is created successfully, it does not appear as a separate object in the process flow or in a format that is viewable from SAS Enterprise Guide. SAS Enterprise Guide manages the ITRM Gallery tasks that create report definitions but it does not manage the report definitions. You can use SAS IT Resource Management and SAS Management Console to view and access the report definitions that the ITRM Gallery tasks create.
    The following display shows two ITRM Gallery task objects, boxed in red, in a SAS Enterprise Guide process flow.
    ITRM Gallery Task Objects in a Process Flow
    ITRM Gallery Task Objects in a Process Flow
  12. Save the SAS Enterprise Guide project.
CAUTION:
Do not create multiple ITRM Gallery tasks in a single process flow and then use the report definitions that they create in multiple report jobs that are run in parallel.
Report jobs save reports in root folders of the SAS Content Server that are named according to the corresponding project name and process flow name. If separate jobs attempt to update the same root level folders at the same time, then a conflict can occur. For example, do not create daily and weekly report definitions in a single process flow and then create daily and weekly report jobs that run in parallel.

Managing User-Defined Settings for Report Filters

About the Manage User-Defined Settings Window

When planning to filter and subset your reports, you might need to create domain categories and keyword values that are unique to your business. The ITRM Gallery task enables you to create and manage your own unique filter values that you can assign to report definitions and use later in the Gallery Manager when viewing and searching for reports. You can also share these user-defined filters with other clients that might want to filter reports in a similar way.
The Manage User-Defined Settings window of the ITRM Gallery task enables you to share, add, and delete user-defined values for report filters. The user-defined values that you specify on this window are then available from the Gallery Manager and for report definitions that are created with an ITRM Gallery task in SAS Enterprise Guide.

Create User-Defined Values

To create user-defined values, perform the following steps:
  1. Open an ITRM Gallery task in a SAS Enterprise Guide project.
  2. Click Next to navigate to the Options page.
  3. Click Manage User-Defined Settings.
    Manage User-Defined Settings Option on the Options Page
    Manage User-Defined Settings Option on the Options Page
    The Manage User-Defined Settings window appears.
  4. From the list on the left of the pane, select the type of filter (for example, Domain Category, Domain Subcategory, Job Schedule Frequency, or Keywords) for which you want to add a value.
    Manage User-Defined Settings Page for Domain Categories
  5. Enter the new filter value in the field at the top of the window. This field accepts only letters, numbers, hyphens, and underscores.
    Note: Misspellings, typing errors, and differences in capitalization standards can create inconsistencies in this field. An error in the value can make the associated reports difficult to find when using the Gallery Manager to filter your reports. Inconsistencies can also lead to multiple filter values that mean the same thing but are listed separately.
  6. Click Add to create the filter value.
  7. Click Save to add the user-defined value to the list of available filters in the ITRM Gallery task. New filter values appear in the Gallery Manager after they are used in a report definition that is part of a run report job.
  8. Save the SAS Enterprise Guide project.

Delete User-Defined Values

When you delete a user-defined value, the value is removed from the list of available filters in an ITRM Gallery task. If an ITRM Gallery task uses the deleted value, then the setting is replaced with a blank value the next time you open the ITRM Gallery task. However, the deleted value will still be available for selection in the Gallery Manager until all of the reports that include the deleted value are purged from the SAS Content Server. It will also still be in the metadata of report definitions and report output that were generated before the change.
To delete a user-defined value, perform the following steps:
  1. From the Manage User-Defined Settings window of the ITRM Gallery task, select the type of filter (for example, Domain Category, Domain Subcategory, Job Schedule Frequency, or Keywords) for which you want to delete a value.
  2. Select the value that you want to delete.
  3. Click Delete.
  4. Click Save to delete the user-defined value from the list of available filters in the ITRM Gallery task and the Gallery Manager.

Share User-Defined Values between Clients

To share user-defined values between clients, perform the following steps:
  1. From the Manage User-Defined Settings window of the ITRM Gallery task, select General. The General window enables you to import user-defined values from another user and to save or export your user-defined values in a physical file for another user.
    Manage User-Defined Settings Page for Import and Export Settings
  2. Specify how you want to share the user-defined values:
    • Click Import Settings to add a set of user-defined values from a shared settings file. An Open File window appears, enabling you to navigate to and select a shared settings file that includes the user-defined values that you want to use.
    • Click Export Settings to save your user-defined values in a physical file that you can share with other clients. A Save File window appears, enabling you to save your user-defined values in a physical file and folder location.
      Note: You can also use the Export Settings feature to simply save and back up your settings.
  3. Click Save.

Modify Report Definitions Using the ITRM Gallery Task

You can use the ITRM Gallery task to modify a SAS IT Resource Management report definition. The ITRM Gallery task must be run manually (as described in this topic) to create or modify a report definition. Simply running a project, process flow, or a branch in SAS Enterprise Guide does not update the report definitions.
To modify report definitions using the ITRM Gallery task, perform the following steps:
  1. Open the appropriate SAS Enterprise Guide project and right-click the corresponding ITRM Gallery task object for the report definition that you want to change.
  2. Select Modify <ITRM Gallery Task Name>.
  3. Navigate the ITRM Gallery task pages and modify the settings as needed.
  4. Click Finish. A message box notifies you when the report definition is created successfully. All new values are saved in the ITRM Gallery task object, and the report definition is updated on the metadata server. You must then run the corresponding report job to see updates in the report output.
    Note: Save does not create a report definition. It simply saves the ITRM Gallery task object that you can use to create a report definition later.
  5. Save the SAS Enterprise Guide project to save the ITRM Gallery task update.