About Gallery Transformations :: SAS(R) IT Resource Management 3.21: Reporting Guide

What Is a Gallery Transformation?

Gallery transformations are among the final components of the batch reporting process. These transformations are part of report jobs, and they identify one or more of the report definitions that a report job uses to create report output. This process enables you to run report jobs and their report definitions in batch mode.

Although report definitions provide a majority of the specifications for report output, the Gallery transformation enables you to specify (and in some cases, override) a few additional parameters for all of the reports that the corresponding report job creates. A Gallery transformation enables you to specify the following values for all of the reports that the corresponding report job creates:

SAS Content Server where the corresponding reports will be stored
style sheet and location
graph format (overrides the graph format that is specified in the report definition)
report definitions
the purging criteria for a report (overrides the expiration date that is specified in the report definition)

The Gallery transformation compiles the specified values and generates the SAS program that will be run as scheduled in the report job. In the following example, a Gallery transformation named System Monthly is in the System Monthly Reporting job for the DT Perf Sentry adapter and the Server System domain category.

A Gallery Transformation in a Report Job

For more information, see About Report Jobs.

Properties of Gallery Transformations

To access the Gallery transformation properties, right-click a Gallery transformation in a report job and select Properties. A Properties dialog box appears and enables you to view properties and specifications for the SAS Content Server, report parameters, and report definitions.

Gallery Transformation Properties Dialog Box

The Properties dialog box contains the following tabs:

The General tab displays information that identifies the Gallery transformation such as name and description.
The Server tab enables you to specify the name and location of the SAS Content Server for the Gallery transformation and the advanced URL filename parameters.
The Report Parameters tab enables you to view or modify the parameters that apply to the reports that the transformation generates.
The Report Definitions tab enables you to identify the report definitions that you want to use.
The Options tab displays information about how to further customize and generate the code.
The Code tab enables you to manage the code that is generated by the transformation.

Note: This tab should not be used to modify the code that is generated by the Gallery transformation. Changes that you make can result in code that is error prone and is out of alignment with the report definition that was created by SAS Enterprise Guide.
The Precode and Postcode tab enables you to specify that user-written code should be inserted at the beginning or end of the current transformation.
The Notes tab displays any notes or documents that are associated with the transformation.
The Extended Attributes tab displays the custom properties that are available for the transformation.

For more information about the tabs that are available from the Properties dialog box, see the Help for SAS IT Resource Management.

Gallery Transformations Created by the Adapter Setup Wizard

The Adapter Setup wizard creates Gallery transformations for several of the adapters and domain categories that SAS IT Resource Management supports. Gallery transformations are saved as components of the reporting jobs that are stored in the IT data mart folders that the Adapter Setup wizard creates. These Gallery transformations reference supplied report definitions that provide extensive domain intelligence about IT resources for the supported adapters. For more information, see the “Adapter Setup Wizard” chapter in the SAS IT Resource Management: Administrator's Guide.

Using the Adapter Setup wizard is the most convenient way to create Gallery transformations and report jobs for selected adapters. However, you might choose to create your own Gallery transformations or modify those that the Adapter Setup wizard creates. For more information, see Working with Gallery Transformations.

For more information about the Gallery transformations and report jobs that the Adapter Setup wizard creates, see Report Jobs Created by the Adapter Setup Wizard. For more information about the specific adapters and domain categories for which the Adapter Setup wizard creates reporting jobs, see the “Jobs That the Adapter Setup Wizard Creates for Domain Categories” appendix in the SAS IT Resource Management: Administrator's Guide.