Managing SAS Enterprise Guide Projects for SAS IT Resource Management

About SAS Enterprise Guide Projects for SAS IT Resource Management

The reports that are available from Gallery Manager and used for the purposes of performance management and capacity planning have their beginnings in SAS Enterprise Guide projects. These projects and their tasks produce reports that must be managed to ensure the integrity of the operational reporting environment for SAS IT Resource Management.

SAS makes the following recommendations as best practices for managing the SAS Enterprise Guide projects that SAS IT Resource Management provides at installation. These best practices assume that the SAS Enterprise Guide projects are maintained by several people referred to as “report developers” in this appendix.

The best practices described here provide suggestions for managing the following two sources of SAS Enterprise Guide projects:

supplied projects

Supplied projects, also called supplied SAS Enterprise Guide projects, are delivered with the SAS IT Resource Management solution. These projects are installed on each client machine to which SAS Enterprise Guide is deployed during the installation of SAS IT Resource Management.

The projects can be accessed by navigating to the location where you installed SAS IT Resource Management. The projects are located at SASITResourceManagementSASEnterpriseGuideComponents\3.3. For example, if you installed SAS IT Resource Management on a 64-bit machine, the projects might be located at

C:\Program
                                 Files\SASHome\x86\SASITResourceManagementSASEnterpriseGuideComponents\3.3

Supplied projects are assumed to be owned and managed by SAS. When updates to the SAS IT Resource Management solution are released, the entire contents of this folder might be overwritten to deliver product enhancements.

user projects

User projects are those SAS Enterprise Guide projects that are created by users of the SAS IT Resource Management solution and stored in a location other than that of the supplied projects. A suggested location is in a folder called User that is located under the folder where the supplied projects are stored. For example, you might store your user-created projects at C:\Program Files\SASHome\x86\SASITResourceManagementSASEnterpriseGuideComponents\3.3\User.

The report definitions that are created by these SAS Enterprise Guide projects differ in the following ways:

Supplied report definitions that are delivered with the SAS IT Resource Management solution are written to the SAS Metadata Server and are stored in folders such as Shared Data/SAS IT Resource Management/3.3 IT Report Definitions/<Adapter Name>/Supplied/<Time Period>.
User report definitions that a generated from user projects should be written to a location other than that of the supplied report definitions. A suggested location is /Shared Data/SAS IT Resource Management/3.3 IT Report Definitions/<Adapter Name>/User Defined/<Time Period>.

Note: As SAS releases updates to supplied SAS Enterprise Guide projects and corresponding report definitions, you can run the jobs that the Adapter Setup wizard generates and view the report output in Gallery Manager. Any updates that SAS delivers can be incorporated into your production reporting jobs by executing the best practices that are described in the following topic.

Add, Update, or Delete Report Definitions

The following steps enable you to add, update, or delete report definitions that SAS IT Resource Management uses:

In SAS Enterprise Guide, you can use the ITRM Gallery task to add or update report definitions. You can also delete an ITRM Gallery task.
In the SAS IT Resource Management client, you can add, update, or delete report definitions that are in your report jobs.

Locate the SAS Enterprise Guide projects that are used to produce reports from the operational SAS IT Resource Management System.
Make copies of the supplied SAS Enterprise Guide projects and establish a set of master SAS Enterprise Guide projects for your site. Store these master copies of the projects in a location that is accessible by all report developers.
Use the Migration Wizard for SAS Enterprise Guide to update the mapping to the information map or SAS table that serves as the source data for the report. For more information, see Preparing to Work with SAS Enterprise Guide.
Use any method of version control to manage a set of master SAS Enterprise Guide projects. All report developers can use the master copies to make their own copies of the projects and publish their results after they have implemented and promoted changes to the report definitions that they produce.
Report developers perform the following steps when working with a SAS Enterprise Guide project:
1. Check out a copy of a master SAS Enterprise Guide project.
2. In SAS Enterprise Guide, select FileNewNotes to create a version notes file of the project. If a notes file already exists, then open the existing file.
3. Add the following entries to this notes file:
  
  Project Updated By
  
  Date of Changes
  
  Tasks Modified
You can perform these actions:
- use the ITRM Gallery task to create new or update existing report definitions
- delete an ITRM Gallery task or a report
  
  Note: Deleting the ITRM Gallery task does not delete the corresponding report definition.
After you implement your changes, validate them.
If you added or modified ITRM Gallery tasks, publish the corresponding report definitions to the SAS Metadata Server. To do so, perform the following steps:

Note: The suggested path for new report definitions is /Shared Data/SAS IT Resource Management/3.3 IT Report Definitions/<Adapter Name>/User Defined/<Time Period>.
1. Right-click an ITRM Gallery task and select Modify <ITRM Gallery task name>.
2. Click Next to navigate to page 2 of the ITRM Gallery task wizard.
3. Click Finish. The new report definition is created and published to the SAS Metadata Server.
Note: This step is not needed if you deleted an ITRM Gallery task.
Save and close the SAS Enterprise Guide project.

Note: If your site uses a method of version control to manage a set of master SAS Enterprise Guide projects, make sure that you check in the project.
Open the SAS IT Resource Management client.
Use the IT Data Marts tree to navigate to the report job in the appropriate IT data mart, adapter, and domain category folders. This location should be where you want to perform one of the following actions:
- select a new report definition in the report job
- deselect a report definition in the report job
Open the report job.

Right-click the Gallery transformation and select Properties.
- If you are selecting a new report definition, select the Report Definitions tab and add the report definition as needed.
- If you are deselecting a report definition, select the Report Definitions tab and delete the report definition as needed.
Select the Notes tab and add the following entries to the notes:
- Transformation Updated By
- Date of Changes
- Report Definition Changes (such as Added: <report definition name>, Updated: <report definition name>or Deleted: <report definition name>
Save and close the Gallery transformation.
Deploy the new report job.
Close the SAS IT Resource Management client.