Ods Markup And Tagsets: A Tutorial

ODS Markup and Tagsets, A tutorial. Eric Gebhart

Proc Template. It is NOT what you think it is!

Tagsets are ODS Destinations ODS Markup tagset=HTML4 .... ODS Tagsets.HTML4 .... ODS HTML4 .... ODS HTML ....

ods tagsets.short_map file = "body.xml" frame = "frame.xml" contents = "contents.xml" pages = "pages.xml" code = "code.xml" data = "data.xml" stylesheet = "stylesheet.xml"; ods _all_ close; The ODS Markup Statement

Special, Named Destinations. HTML, PHTML, HTMLCSS, HTML4, CHTML CSV, CSVByline, CSVAll LaTeX, Troff XML, SASReport, DocBook IMode

What is Different ? One more output file. Stylesheet Behavior. More Options.

The same options as before. Ods html file='test.html' ( headtext ='<meta text=”my headtext”>', metatext ='text=”my meta text”, url =' http://www.sas.com/test.html ' ) newfile =table;

Multiple Stylesheet URL's! ODS html file = ”test.html” stylesheet = ”test.css” (url=” test.css corp.css corpnav.css ”);

Multiple Personality Disorder. Ods tagsets.myhtml file=”test.html” Alias=”NoNotes”;

Make up your own Options! ODS tagsets.test file=”test.txt” options ( embedded_titles = 'yes' Orientation = 'landscape' Doc = 'Help');

Options inside the tagset. define tagset tagsets.test; define event initialize; putvars $options _name_ ': ' _value_ nl; end; end;

The tagset Output. EMBEDDED_TITLES: yes ORIENTATION: landscape DOC: Help

One more method of control! ODS tagsets.htmlpanel file = ”test.html”; ODS tagsets.htmlpanel event = panel(start); ... ... ODS tagsets.htmlpanel event = panel(finish); ODS tagsets.htmlpanel close;

ODS Markup is like ODS HTML, PLUS!

Getting a list Proc template; list tagsets; Listing of: SASHELP.TMPLMST Path Filter is: Tagsets Sort by: PATH/ASCENDING Obs Path Type 1 Tagsets Dir 2 Tagsets.Chtml Tagset 3 Tagsets.Colorlatex Tagset 4 Tagsets.Csv Tagset

The HTML Family Phtml HtmlCss Html4 Chtml Imode (chtml)

PHTML, Plain HTML. Simple 12 element Stylesheet No class attributes. No Fancy features.

HTMLCSS. Full Stylesheet Fancy Features

HTML4 is ODS HTML Same as HtmlCSS More like Previous Releases

CHTML - Compact HTML. iSNo Subset of HTML. No Styles. Super Set of Imode.

Data Transport and Excel. CSV, CSVByline, CSVAll PYX MSOffice2K ExcelXP DDE http://support.sas.com/news/feature/04jul/excelsupport.html

CSV "Obs","Name","Sex","Age","Height","Weight" "1","Alfred","M",14,69.0,112.5 "2","Alice","F",13,56.5,84.0 "3","Barbara","F",13,65.3,98.0

PYX (data -Alfred Atype "string" Ajust "l" Acolcount "1" Acol "2" Asection "body" Aclass "Data" )data

Publications, Papers, PDF. LaTeX Troff DocBook

LaTeX Tagsets LaTeX SimpleLaTeX TablesOnlyLaTeX

Combined Slide Bars - PDF via LaTeX

Other Miscellaneous Tagsets. ODSStyle Style_Popup Style_Display NamedHTML MVSHTML

Tagsets are Collections of Events

Events Define Actions & Output. define event doc; start: put HTMLDOCTYPE nl; put “<html>” nl; finish: put "</html>" nl; end;

A very simple tagset. proc template; define tagset tagsets.plain ; define event data ; put “Data: “ value nl; end; define event header ; put “Header: “ value nl; end; end; run;

Header: Obs Header: Name Header: Sex Header: Age Header: Height Header: Weight Header: 1 Data: Alfred Data: M Data: 14 Data: 69.0 Data: 112.5 ods tagsets.plain file="plain.txt"; proc print data=sashelp.class;run; ods tagsets.plain close;

Label, Value Pairs Becomes this: <Table background="grey" foreground="blue" cellpadding="5"> Putq '<Table' ' background=' background; putq 'foreground=' foreground; putq 'cellpadding=' cellpadding; put '>' nl; With no attribute values, it becomes: <Table>

If Statements . Put 'Foreground is blue!' nl /if cmp ('blue', foreground); Put 'Foreground is not red!' nl /if ^ cmp ('red', foreground);

AND and OR, sort of... Put 'Some variables have a value.' nl /if any (background, foreground, cellpadding, value); Put 'All variables have a value.'' nl /if exists (background, foreground, cellpadding, value);

Contains a Substring . Set $myvar “this is random text”; put “myvar has ran” nl /if contains ($myvar, “ran”);

Simple if test, Where clauses . Set $myvar “this is random text”; Set $mytest “True”; put “myvar has length” nl /if $myvar; put “longer than 10” nl /if length($myvar) > 10 break /if $mytest;

Break, Breakif Break /if ^$options; Trigger alternate_event /if $do_something_else; Break /if $do_something_else; Trigger alternate_event /breakif $do_something_else;

A list of images. proc template; define tagset tagsets.gifs ; define event branch ; put label " "; end; define event image ; put url nl; end; end; run;

The Output Name=Alfred temp/gplot.gif Name=Alice temp/gplot1.gif Name=Barbara temp/gplot2.gif

A Prettier Report. proc template; define tagset tagsets.gifs2 ; define event branch ; set $name scan( label , 2, '='); end; define event image ; put url " " $name nl; end; end; run;

Nicer looking Output temp/gplot.gif Alfred temp/gplot1.gif Alice temp/gplot2.gif Barbara

The Set Statement. set $myvar “foreground is” forground ; Always creates a string. Variables always start with $.

The Eval Statement. Eval $count 0; Eval $count $count + 1; set $myvar “this is a test”; Eval $index index($myvar, 'test');

Data Step Functions. Can be used anywhere. Cannot be nested except in where clauses.

SQL ??? Create table CLASS (Name varchar(7), Sex varchar(1), Age float, Height float, Weight float); Insert into CLASS(Name, Sex, Age, Height, Weight) Values ('Alfred', 'M', 14, 69.0, 112.5); ... ...

Dictionaries define event type_translations; set $types['string'] 'varchar'; set $types['double'] 'float'; set $types['int'] 'integer'; end; /* column name translation */ define event name_translations; set $name_trans['desc'] 'description'; end;

The Initialize Event define event initialize; trigger type_translations; trigger name_translations; /* types that need widths */ set $types_with_widths['string'] "True"; /* types that need quotes */ set $types_with_quotes['string'] "True"; end;

Creating Lists define event colspec_entry; set $lowname lowcase(name); do /if $name_trans[$lowname]; set $names[] $name_trans[$lowname]; else; set $names[] $lowname; done;

define event table_body; put "Create table " $table_name "("; eval $i 1; unset $not_first; do /while $i <= $names; /* comma's only after the first name */ put ', ' /if $not_first; put $names[$i] " "; put $columns[$i]; eval $i $i+1; set $not_first "True"; done; put ");" nl; end;

Looping through A Dictionary iterate $types do /while _name_ ; put _name_ “: “ _value_ nl; next $types; done;

Streams . Designated by $$ Can hold large amounts of data Not limited by memory Can be opened, closed and flushed.

Streams by example open junk; put “This goes to junk.” nl; put “ More stuff.” nl; close; open trash; put $$junk 'This goes to trash.'; putstream junk; put “ This goes to trash too.”; open junk; put “ Even more stuff”; close; set $$junk “A completely new junk.”; set $$junk $$junk “ Appending to the end”; unset $$junk

Craeting Slide Bars. proc print data=sashelp.class; var name; var sex; var age; var height / style(data) = slider[just=center tagattr="slider-80"]; var weight / style(data) = slider[just=center tagattr="slider-150"]; run;

Tagset Inheritance . Define tagset tagsets.SSV ; parent = tagsets.csv ; define event header ; start: put ';' / if ^cmp( COLSTART , "1"); put '"'; put VALUE ; finish: put '"'; end; .....

Tagset Attributes Define tagset tagsets.mytags; map = '<>&'; mapsub = '/</>/&/'; nobreakspace = ' ' ; embedded_stylesheet = yes; output_type = html; lognote = “you are using my special tagset”;

Using Options define event options_set ; trigger setup_options; end; define event setup_options; trigger nls_numbers; trigger options_setup ; trigger documentation ; end; ODS tagsets.excelxp options(embedded_titles='yes');

Mvar embedded_titles; define event options_setup ; set $options['test'] "test" /if ^$options; do /if $options ['EMBEDDED_TITLES']; do /if cmp( $options ['EMBEDDED_TITLES'], "yes"); set $embedded_titles "true" ; else; unset $embedded_titles; done; else; do /if cmp(embedded_titles, "yes"); set $embedded_titles "true" ; else; unset $embedded_titles; done; done;

Creating Help and documentation. define event documentation; break /if ^$options; trigger quick_reference /if cmp($options['DOC'], 'quick'); trigger help /if cmp($options['DOC'], 'help'); end; define event help ; putlog "============================== “; putlog “The EXCELXP Tagset Help Text."; ... trigger quick_reference; end;

Extended Procedural Controls. Eval $count 10; do /while $count < 10; eval $count $count+1; stop /if $count = 9; continue /if $count = 3; put $count nl; else; put “Count was already > 10” nl; done;

Else If do /if $count < 10; put “count is < 10”; nl; else /if $count = 11; put “Count is11” nl; else /if $count = 12; put “Count is 12” nl; else; put “Count is > 12” nl; done;

A process for Tagset Creation Define the goal Identify an Event Locate the Event Code Explore the available variables.

Identify and Locate. Search the Output to be modified. Search the Tagset for the corresponding Event Search the Output of the Event_Map Tagset. Look for convienent events with short_map.

Finding & Exploring with Event Map. ods tagsets.event_map file="map.xml"; < image event_name =" image " trigger_name ="attr_out" output_name ="Gplot" output_label ="Plot of Weight * Height" index ="IDX" j ust ="c" url =" gplot.gif " />

Exploring Variables with Putvars. Put “Event variables” nl; Putvars Event _name_ ': ' _value_ nl; Put “Style variables” nl; Putvars Style _name_ ': ' _value_ nl; Put “Options” nl; Putvars $Options _name_ ': ' _value_ nl;

Finding Other Useful Events. Default_Event = putall; Define event putall; put '<' Event_name nl; Putvars Event _name_ ': ' _value_ nl; Putvars Style _name_ ': ' _value_ nl; Putvars Mem _name_ ': ' _value_ nl; put '>' Event_name nl; End;

Using a PutLog event. Define event putlog; putlog “Event:” event_name nl; Putlog “Name is” “:” name; Putlog “Count is” “:” $count; end;

Locating Alfred < branch event_name ="branch" trigger_name ="attr_out" class ="ByContentFolder" value ="Name=Alfred" name ="ByGroup1" label =" Name=Alfred " index ="IDX" just ="c" url ="junk.xml#IDX" hreftarget ="body">

A Solution. proc template; define tagset tagsets.gifs2; define event branch; set $name scan(label, 2, '='); end; define event image; put url " " $name nl; end; end; run;

Useful Links ODS Markup, New Tagsets, Howto's. http://support.sas.com/rnd/base/topics/odsmarkup/ Introduction to Tagsets. http://support.sas.com/rnd/base/topics/odsmarkup/tagsets.html The Template FAQ. http://support.sas.com/rnd/base/topics/templateFAQ/Template.html [email_address] [email_address]

Ods Markup And Tagsets: A Tutorial

More Related Content

Recently uploaded

Featured

Ods Markup And Tagsets: A Tutorial