Using the new Version 8 Template Procedure for Complete Control of SAS Output Style and Format David Ghan Technical Training Specialist SAS, Canada

Objective demonstrate the power of Proc Template to customize SAS output format outline the general framework for how this is done and introduce some key concepts for starting with Proc Template.

Output Delivery System (ODS)

ODS Destinations Report Destinations ListingHTML Printer Data Destination Output RTF

Output Listing HTML RTF Destination Output Object Data Component Template Components SAS Data Set Output Window HTML File RFT File Result ODS Output Production * Pre-defined templates provided, but can customize

Why Use ODS and Proc Template? form and appearance matter. automate the formatting process production jobs applications make results accessible to users in their preferred form. no post-production point-and-click.

Template Types Table column header footer Style Presentation Colors Fonts There are specific table template for each type of output object. A single style template affects the general look of all the output within a given document.

style template table template style elements attributes values table header footercolumn attributes values attributes values attributes values attributes values The general structure of templates

Objectives projected airfares on all flight routes in 3 seat classes over 4 years. a frequency report for number of employees in different job classes. Projected Ticket Rates Route First Class Business Economy First Class Business Economy Number Fare Year 1 Fare Year1 Fare Year1 Fare Year2 Fare Year2 Fare Year $1, $1, $ $1, $1, $ $1, $1, $ $1, $1, $ $1, $1, $ $2, $1, $ $1, $1, $ $2, $1, $ $ $ $58.00 $ $ $ $ $ $58.00 $ $ $ Counts by Job Code Job Code Job Cumulative Cumulative Code Frequency Percent Frequency Percent ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ BAGCLK BAGSUP CHKCLK CHKSUP FACCLK

Objectives (cont’d) standard templates Create the SAS output in HTML format and RTF (Rich Text Format) using standard templates supplied by SAS. heading text data formats order of columns banner image banner image (HTLM) background image background image (HTML) panels (RTF) page orientation (RTF) modified templates Create and use modified templates to produce the HTML and RTF output. font color traffic lighting

The Plan: Step 1 - create procedure output as text. Step 2 - create RTF and HTML output with “default” templates.

The Plan: Step 3 - Part A - modify style template to specify: font font size landscape layout (RFT) banner and background images (HTML). Part B - apply new style template to create output. Step 4 - Part A - modify table template for Proc Freq to specify: order and format of columns header text 2 panels per page (RTF) traffic lighting. Part B - apply new table template to create output.

Output Listing HTML RTF Destination Output Object Data Component Template Components SAS Data Set Output Window HTML File RTF File Result ODS Output Production proc report, proc freq style template, table template

Step 1 - create procedure output as text. proc report data=airline.rates(obs=50) nowd split=' '; title 'Projected Ticket Rates'; columns rte_id _numeric_; define rte_id / id; run; proc freq data=airline.employees; table JobCode; title 'Counts by Job Code'; run;

ODS RTF file=‘something.rtf’; ODS HTML file=‘something.html’; ODS RFT CLOSE; ODS HTML CLOSE; Step 2 - create RTF and HTML output with “default” templates.

Step 3 - Part A - modify style template to specify font, font size, landscape layout (RFT), and banner and background images (HTML). PROC TEMPLATE; DEFINE STYLE style-name; PARENT=parent; REPLACE element1 attribute1=value attribute2=value …; REPLACE element2 attribute1=value attribute2=value …; END; RUN; Element attribute value _ documentbackground imagesomething.gif column headerstext colorblue background colorwhite fontLucidia Console cell bordersthickness2 pixels colorblack

Step 3 - Part B - apply new style template to create output. ODS RTF file=‘something.rtf’ style=newstyle; ODS HTML file=‘something.html’ style=newstyle; ODS RFT CLOSE; ODS HTML CLOSE;

Step 4 - Part A - modify table template for Proc Freq to specify order and format of columns, header text, 2 panels per page (RTF), and traffic lighting. PROC TEMPLATE; EDIT TABLE template-name; MVAR; COLUMN column(s); DEFINE header; attribute1=value …; END; EDIT column; HEADER='label text'; FORMAT=format.; … other change statements… END; END; RUN; Attributes and values can be specified for: the entire table table headers and footers individual column headers and column values

Step 4 - Part B - apply new table template to create output. SAS matches up the data component of each output object with the template component by name. User modified table templates retain the same name as the originals, but they are stored in a different location. By default, SAS will find and use the user defined table templates first. No need to specify the new table template. An ODS PATH statement can be used to control which templates SAS is able to find and use.

Process: what do I want to change? what are the corresponding style elements of the style template? (and/or) what is the name of the table template and the names of the headers or columns within that I want to change? what particular attributes do I want to specify for these style elements, or for the tables, table headers, or table columns? what are valid values to set for these attributes? *Everything in red italics has a specific name

style template table template style elements attributes values table header footercolumn attributes values attributes values attributes values attributes values The general structure of templates This is the forest. Don’t get lost among the many trees

Template inheritance: within a style template, elements inherit attributes and their values from other elements. both style and table templates may also inherit elements and their attributes from other templates.

proc template; define style Styles.Default;.. style Container font = Fonts('DocFont') foreground = colors('docfg') background = colors('docbg'); style Index from Container foreground = colors('contentfg') background = colors('contentbg');.. proc template; define style Styles.Rtf; parent = styles.printer; style titleAndNoteContainer from titleAndNoteContainer / outputwidth = _undef_; replace cell from container / linkcolor = colors('link2'); Inheritance within a style template: Inheritance from another style template:

Inheritance from another table template: proc template; edit Base.Freq.OneWayFreqs;...

Help and documentation: SAS Online Doc - Guide to the Output Delivery System. includes syntax full lists of elements, attributes, and values. (hardcopy useful) Interactive Template Window and Template Browser Window. get to know the default templates you need to work with copy and paste required code. Classroom Training: Getting Started with the Output Delivery System.

Other references: URLs of Interest: odsxml/xml.pdf odsprinter/faq.html odscss/ odsfordata/ods.pdf style-template/style.html v6v8ods/index.html V7/V8 and ODS papers to download: