9. Producing HTML output. GIORGIO RUSSOLILLO - Cours de prépara+on à la cer+fica+on SAS «Base Programming» 207

Transcription

1 9. Producing HTML output 207

2 The Output Delivery System (ODS) With ODS, you can easily create output in a variety of formats including: - HyperText Markup Language (HTML) output - RTF output - PDF output - SAS LISTING output 208

3 What ODS does When you submit your ODS statement and run the SAS program that creates an output, the ODS: 1. Creates your output in the form of output objects, that: - Contains the results of a PROC or a DATA step (Data component) - Can also contain informa+on about how to render the results (Table defini+on) 2. Sends the output object to the ODS des+na+on(s) that you specify and creates the formabed output 3. Creates a link to each output object in the Result window 209

4 ODS Des+na+ons & Outputs - You use ODS statement to specify des+na+ons for your output. - Each des+na+on creates a specific type of formabed output 210

5 Open and close ODS des+na+ons PROC PRINT DATA=sasuser.admit; The above program creates HTML and LISTING outputs because HTML and LISTING des+na+ons are open In general, to open and close des+na+ons, you need the following statements: ODS des>na>on <op>ons>; ODS HTML; ODS LISTING; ODS des>na>on CLOSE; ODS LISTING CLOSE; You can close all the open des+na+ons using the _ALL_ keyword: ODS _ALL_ CLOSE; 211

6 Crea+ng HTML output: the ODS HTML stamenent file-specifica>on can be: ODS HTML BODY= file-specifica>on ; - A quoted string which contains the HTML filename - A quoted string which contains the complete directory path and the HTML filename - A fileref that has been previously assigned to an HTML file - A SAS catalog in the form name.html if the catalog libref.name is specified on the PATH= op+on N.B.: FILE= is an alias for BODY= 212

7 Crea+ng file readable by Adobe, Excel and Word ODS PDF FILE="\\psf\Home\Documents\My SAS Files\myoutputs\means_pdf.pdf"; ODS CSVALL FILE="\\psf\Home\Documents\My SAS Files\myoutputs\means_csv.csv"; ODS RTF FILE="\\psf\Home\Documents\My SAS Files\myoutputs\means_rv.rv"; PROC MEANS DATA=Lib9_3.sales ; VAR Salary; CLASS Gender Country; ODS PDF CLOSE ; ODS CSVALL CLOSE ; ODS RTF CLOSE ; From now we focus on HTML des+na+on 213

8 Example: Crea+ng an HTML file with output from one or mul+ple procedures ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\TableCountry.html'; PROC FREQ DATA=Lib9_3.sales; TABLES Country; ODS HTML; ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html'; PROC FREQ DATA=Lib9_3.sales; TABLES Country; PROC PRINT DATA=sasuser.admit; ODS HTML; 214

9 Crea+ng an HTML file with a table of contents A table of contents contains a numbered heading of each procedure that creates output ODS HTML BODY=file-specifica>on CONTENTS=contents-specifica>on FRAME=frame-specifica>on; - contents-specifica>on :Is the name of a HTML file that contains a table of contents with links to the procedure output - frame-specifica>on :Is the name of a HTML file that integrates the table of contents and the body file 215

10 Crea+ng the table of contents: An example ODS HTML BODY=file-specifica>on CONTENTS=contents-specifica>on FRAME=frame-specifica>on; ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html' CONTENTS='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\datatoc.html' FRAME='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\dataframe.html'; PROC FREQ DATA=Lib9_3.sales; TABLES Country; PROC PRINT DATA=sasuser.admit; To see the frame files, search them in the Explorer windows and open them 216

11 The URL op+on When ODS generates HTML files, it also generates links between the files using the filenames specified in the ODS HTML statement ODS HTML BODY=file-specifica>on CONTENTS=contents-specifica>on FRAME=frame-specifica>on; These links work if you view the files locally. If you want to place these files on a Web server, then the link needs to include the URL ( Uniform Resource Locator ) ODS HTML BODY=file-specifica>on (URL= url-specifica>on ) CONTENTS=contents-specifica>on (URL= url-specifica>on ) FRAME=frame-specifica>on; 217

12 URL sub-op+on specifica+on (URL=url-specifica>on) This op+on is useful for building HTML files that may be moved from one loca+on to another. The URL subop+on can specify: - Only the HTML filename (rela+ve URL). The links will work as long as the files are all in the same loca+on - A complete (absolute) URL. The links will work even if the files are stored in different loca+ons ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html (URL= mydata.html ) CONTENTS='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\datatoc.html (URL= datatoc.html ) FRAME='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\dataframe.html ; N.B.: You cannot use the URL= subop+on in FRAME= op+on because no ODS file references the frame file 218

13 URL specifica+ons: Examples RelaIve URL : it contains only the HTML filename ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html (URL= mydata.html ) CONTENTS='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\datatoc.html (URL= datatoc.html ) FRAME='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\dataframe.html ; Absolute URL : it specifies the complete URL using the Hypertext Transfer Protocol (HTTP) ODS HTML BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html (URL= hbp://mysite.com/myreports/mydata.html ) CONTENTS='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\datatoc.html (URL= hbp://mysite.com/mytocs/datatoc.html ) FRAME='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\dataframe.html ; 219

14 The PATH= op+on The PATH= op+ons in the ODS HTML stratements specifies the loca+on where you want to store your HTML output PATH= file-path <URL=NONE URL-specifica>on > - If you do not use the URL= subop+on, informa+on from the PATH= op+on is added to links and references in the BODY and CONTENTS files that are created - The URL= subop+on provides an URL for links in the HTML files that ODS generates - The URL=NONE subop+on prevents ODS from using the pathname in any links that it creates in your files 220

15 PATH= op+on without URL= subop+on : Example ODS HTML PATH='\\psf\Home\Documents\My SAS Files\myHTMLoutputs BODY='mydata.html' CONTENTS='datatoc.html' FRAME='dataframe.html'; PROC FREQ DATA=Lib9_3.sales; TABLES Country; PROC PRINT DATA=sasuser.admit; PATH= op+on without URL= subop+on: The links from the FRAME file to BODY and CONTENTS files contain the complete filenames '\\psf\home\documents\my SAS Files\myHTMLoutputs\mydata.html and '\\psf\home\documents\my SAS Files\myHTMLoutputs\datatoc.html 221

16 PATH=op+on + URL=NONE : Example ODS HTML PATH='\\psf\Home\Documents\My SAS Files\myHTMLoutputs' URL=NONE BODY='mydata.html' CONTENTS='datatoc.html' FRAME='dataframe.html'; PROC FREQ DATA=Lib9_3.sales; TABLES Country; PROC PRINT DATA=sasuser.admit; PATH=op+on + URL=NONE (useful if you intend to move your HTML files): The links from the FRAME file to BODY and CONTENTS files contain only mydata.html and datatoc.html 222

17 PATH= op+on + a specified URL : Example ODS HTML PATH='\\psf\Home\Documents\My SAS Files\myHTMLoutputs (URL= hbp://mysite.com/myreports ) BODY= mydata.html CONTENTS= datatoc.html FRAME= dataframe.html ; PROC FREQ DATA=Lib9_3.sales; TABLES Country; PROC PRINT DATA=sasuser.admit; PATH= op+on + a specified URL: The links from the frame file to body and content files contain the specified URL hbp://mysite.com/myreports/mydata.html and hbp://mysite.com/myreports/datatoc.html respec+vely 223

18 Changing the appearance of HTML Output You can specify a pre-determined style using the STYLE= op+on in the ODS HTML statement: ODS HTML STYLE= style-name BODY= file-specifica>on (URL= url-specifica>on ) CONTENTS= contents-specifica>on (URL= url-specifica>on ) FRAME= frame-specifica>on ; Style defini+ons: - Banker - BarrebsBlue - Default - HTMLblue - Minimal - Sta+s+cal ODS HTML STYLE=Minimal BODY='\\psf\Home\Documents\My SAS Files\myHTMLoutputs\mydata.html' ; PROC FREQ DATA=Lib9_3.sales; TABLES Country; ODS HTML STYLE=htmlblue ; You can costumize the output of tables, columns, headers,.., using the TEMPLATE procedure 224