Web Reporting by Combining the Best of HTML and SAS

Transcription

1 Web Reporting by Combining the Best of HTML and SAS Jason Chen, Kaiser Permanente, San Diego, CA Kim Phan, Kaiser Permanente, San Diego, CA Yuexin Cindy Chen, Kaiser Permanente, San Diego, CA ABSTRACT In most publications, the dominant approach for web reporting has been using ODS HTML and PROC REPORT, which is extremely powerful with very impressive results Regrettably the layout of the report is limited to a tabular format, which hinders the creativity of the SAS users when they are trying to deliver the exact type of report that the end users requested This paper will focus on a different approach that may provide greater flexibility to users who intend to produce highly customized reports First, an HTML report template can be developed to one's heart's content, then SAS will populate the content using one observation in a SAS dataset Using this method, SAS users can take advantage all the great features that HTML has to offer to supplement what is already accomplished in SAS Tools such as Javascript and CSS can be applied directly in the HTML report template to enhance the web report instead of trying different workarounds to integrate them With superior data management capability of Base SAS and other SAS products such as SAS Stored Processes and SAS Information Delivery Portal, a web application can be developed that allows end users to surface eye-dazzling web reports On-Demand Basic knowledge of HTML tags and SAS Stored Processes are recommended for this reading This paper hopefully will broaden the horizon of web reporting thru SAS INTRODUCTION After years of outputting reports using the SAS Output Delivery System (ODS), every SAS programmer must have acquired a mountain of tricks to work with HTML tags, Javascript, and Cascading Style Sheets (CSS) to meet the needs of customers Ever wonder, wouldn t it be nice if the report can be designed in HTML first, and let SAS do her magic to populate the values and distribute it? The technique described in this paper should give SAS users the edge to take advantage of any fancy web report that one can build with HTML and allow SAS to manage its content and distribution This technique can benefit from a join collaboration between a web designer and a SAS programmer It might also be a great alternative for folks who are HTML experts, but new to SAS BASIC CONCEPT For demonstration, this hypothetical observation in a SAS dataset will be used It captures a patient s medical record number (MRN) with diagnosis (DX) and procedure (PX) information after a total knee replacement: Data WORKProcedures; PRINT_DT=put(today(),mmddyy10); MRN =" "; Age=509; Gender="Female"; Race="Alien"; Height=65; Weight=123; OpSite="Knee"; OpSide="Left"; DX01="71536"; Desc01="LOC OSTEOARTHROS NOT SPEC PRIM/SEC LOWER LEG"; DX02="4589"; Desc02="UNSPECIFIED HYPOTENSION"; DX03="5853"; Desc03="CHRONIC KIDNEY DISEASE STAGE 3"; DX04="33394"; Desc04="RESTLESS LEGS"; PX=" TOTAL KNEE REPLACEMENT"; OPDATE="JAN2015"; SurgeonNm="AAA, BBB MD"; Location="San Diego, CA"; 1

2 Here is a screenshot of the web report template that the end users requested (Figure 1): Figure 1 Requested Layout of the Web Report Here is a small part of the code used to generate the HTML template shown above (See Appendix for the full code) <!-- Patient Characteristics--> <td class="lbl">gender: &GENDER <td class="lbl">current Age: &AGE <td class="lbl">height (inch): &HEIGHT <td class="lbl">surgical Site: &OPSITE <td class="lbl">surgical Side: &OPSIDE <td class="lbl"> Please note that there are a few simple rules to follow: 1 Every value in HTML that needs to be replaced by the SAS dataset should be coded in the same way as a SAS macro variable (see yellow highlighted texts above: start with & and end with ) 2 Be sure that the macro variable name used in HTML is the same as the column name in the SAS dataset 3 Be sure that each line has only one macro variable By following these 3 simple rules, the template itself becomes a documentation for SAS users to reference the variables used to populate this HTML template 2

3 The next step is to simply save the HTML code in the Appendix to a file (eg WebRpthtml on the Desktop), and let SAS to read it in: %*Step 1: Import HTML Template; %let File_Dir= C:\XXXXXXXXXXX\Desktop; %*for demonstration, pick Desktop; data WORKHTML_IN; length row_order 8 HTML $250 HTMLVarName VarName $30; infile "&File_Dir\WebRpthtml" missover dsd dlm=" "; input HTML $; if index(html,"&")>0 and index(html,"")>0 then do; HTMLVarName=substr(HTML,index(HTML,"&"),index(HTML,"")-index(HTML,"&")+1); end; else do; HTMLVarName=""; end; Varname=strip(upcase(compress(HTMLVarName,"&"))); row_order=_n_; Now that the HTML template is in a SAS dataset WORKHTML_IN, the goal is simple: to populate the values needed in HTML with the values in the SAS dataset WORKProcedures Here is one way to do it: %let MRN= ; %*for parameter driven reporting; %*Step 2: Transpose one MRN in dataset Procedures, add it to HTML_in; proc transpose data= WORKProcedures (where=(mrn="&mrn")) out=px_trans; var _ALL_; Proc SQL; Create table HTML_out as Select HTML*, PX_NAME_ as SAS_NAME, Strip(PXCOL1) as SAS_Value from HTML_in as HTML left join PX_Trans as PX on (Strip(upcase(HTMLVarname)) = Strip(upcase(PX_NAME_))) order by HTMLrow_order; quit; Next, create a new variable HTML2 by replacing the macro variables in HTML with their SAS_Value %*Step 3: populate values needed in HTML with values in SAS; data HTML_out; set HTML_out; by row_order; if SAS_NAME>"" then HTML2=tranwrd(strip(HTML),strip(HTMLVarName),Strip(SAS_Value)); else HTML2=HTML; Finally, simply output variable HTML2 in SAS dataset WORKHTML_out into a file (eg WebRpt_ html) %*Step 4: Output a static new HTML; data _null_ ; set HTML_out; FILE "&File_Dir\WebRpt_&MRNhtml"; PUT HTML2; 3

4 Here is how WebRpt_ html looks after its creation! (Figure 2) Figure 2 Completed Web Report for a selected patient ADVANCED ENHANCEMENT 1 OUTPUT THE SAME REPORT FOR MULTIPLE OBSERVATIONS Assuming there are multiple MRNs in the dataset WORKProcedures displayed earlier, a macro %DoLoop shown below can be used to produce this report for multiple observations: %macro Gen_Rpt(MRN); %*<Please place Step 2, Step 3, and Step 4 in here>; %mend Gen_Rpt; %macro DoLoop; Data _NULL_; set WORKProcedures; i=strip(put(_n_,8)); call symput ("REC" i, strip(mrn)); call symput ("REC_cnt", strip(i)); %DO i=1 %to &REC_cnt; %Gen_Rpt(&&REC&i); %end; %mend DoLoop; %DoLoop; 2 GO DYNAMIC WITH SAS STORED PROCESSES AND SAS INFORMATION DELIVERY PORTAL Converting the macro above into a SAS Stored Processes, and adding that to the SAS Information Delivery Portal would make underlying data highly transparent in an organization A well designed report can utilize the power of SAS to combine data elements from multiple data sources into a single observation and feed into this type of HTML template End users can log on to the SAS Portal anytime and retrieve such report for a desired observation by simply provide one parameter (eg MRN) In the authors affiliated department, any authorized staff can simply log on to the SAS Portal (Figure 3), enter the MRN of a specific patient, and retrieve clinical details from various sources into a single web page This makes a labor intensive chart review extremely simple for an end user who knows nothing of SAS Since it s just an HTML file, the staff person can simply it for distribution, and other users can view it easily in a web browser 4

5 Figure 3 Snapshot of the SAS Stored Process prompt in the SAS Information Delivery Portal When converting this example into a stored process, a SAS user can first copy Step 1 to Step 4 into the code that will be used for the stored process, remove the %let MRN= statement, then change FILE statement to _webout: %*Step 41: Output using SAS Stored Process thru SAS Portal; data _null_ ; set HTML_out; %*FILE "&File_Dir\WebRpt_&MRNhtml"; FILE _webout; PUT HTML2; At last, create a prompt for macro variable MRN when building the stored process Once the stored process is created, add it to the SAS Portal 3 MANAGE THE STYLE OF THE FINAL REPORT IN HTML WITH CSS OR STYLE DIRECTLY For high level settings, CSS can be specified in the <head> section Here is an example how it is managed: <html lang="en" xmlns=" <head> <style type="text/css"> body {font-family: Arial; font-size: 15px; } table {width:900px; } head_main { background-color: #0f1fd5; color:white; font-family: Arial; font-size: 28px; font-weight: bold; text-align: center; } </style> </head> <body> <!-- Header --> <tr class="head_main"> </body> </html> Total Joint Replacement Operative Form Notice that the styles are defined in the head_main { } inside of the <head> section In the <body> section, these styles can be referenced inside the tag with class="head_main", to apply the styles to this row 5

6 P and P diagnosis Web Reporting by Combining the Best of HTML and SAS, continued For a particular setting in one cell only, the style attribute can do the trick and overwrite existing styles: <html lang="en" xmlns=" <head> <meta charset="utf-8" /> <title>total Joint Replacement Operative Form</title> <style type="text/css"> body {font-family: Arial; font-size: 15px; } table {width:600px; } </style> </head> <body> Date Form Printed: &PRINT_DT <td style="font-size:20px; color:red; font-weight:bold; text-align:right;"> &MRN </body> </html> Quick note on used above: This non-breaking space is common in HTML, but it also has the & commonly used in SAS It is best to keep it in a separate line from a macro variable (eg &PRINT_DT) that needs to be populated 4 MANAGE HTML IN SECTIONS BY RETAINING COMMENT TAGS <!-- --> Please refer to the full HTML code in the Appendix The comment tags can be used to identify sections of HTML code if RETAIN statement is used in Step 1: data HTML_in; set HTML_in; length Section $50; retain Section; if substr(html,1,2)="<!" then Section=strip(HTML); If for some reason, a section needs to be removed for some observations, a code like this can be used to replace Step 4: %*Step 42: This example removes the Diagnosis section completely; data _null_ ; set HTML_out (where=( Section ne "<!-- Diagnosis-->")); FILE "&File_Dir\WebRpt_&MRNhtml" ; PUT HTML2; Managing HTML in sections becomes necessary when the report is long and sometimes conditional statements are needed to control report layout for different populations 5 TAKE ADVANTAGE OF HTML'S FLEXIBILITY AND HIGH ERROR TOLERANCE In this example, please replace the original dataset WORKProcedures with the following one: This observation does not have rd th 3P 4P (values in DX03, Desc03, DX04, and Desc04 are all blank) 6

7 P and Web Reporting by Combining the Best of HTML and SAS, continued Data WORKProcedures; PRINT_DT=put(today(),mmddyy10); MRN =" "; Age=509; Gender="Female"; Race="Alien"; Height=65; Weight=123; OpSite="Knee"; OpSide="Left"; DX01="71536"; Desc01="LOC OSTEOARTHROS NOT SPEC PRIM/SEC LOWER LEG"; DX02="4589"; Desc02="UNSPECIFIED HYPOTENSION"; DX03=""; Desc03=""; DX04=""; Desc04=""; PX=" TOTAL KNEE REPLACEMENT"; OPDATE="JAN2015"; SurgeonNm="AAA, BBB MD"; Location="San Diego, CA"; This is the output after rerunning Step 1 thru 4 for this observation, (Figure 4) Figure 4 Completed Web Report for a selected patient without 3P rd th 4P P diagnosis Notice that the row for the rd 3P P and th 4P P diagnosis conveniently disappeared instead of displaying blank rows After examining the actual HTML produced below, it is clear that HTML ignores blank spaces, and when nothing other than the tags is specified in the tag, the entire row is ignored Knowing how HTML behaves will help designer optimize outputs <tr class="data_odd"> LOC OSTEOARTHROS NOT SPEC PRIM/SEC LOWER LEG <tr class="data_even"> 4589 UNSPECIFIED HYPOTENSION <tr class="data_odd"> <tr class="data_even"> 7

8 CONCLUSION The flexibility of HTML and the power of SAS are nicely joined together in this technique of web reporting When this technique is used to mass produce reports, it is worth mentioning that the speed of producing the report is much quicker than an equivalent PROC REPORT In addition, each file s size is likely to be much smaller since the styles defined by PROC TEMPLATE tend to automatically produce a long CSS <style> tag There are limitations, however, as this type of reporting is best suited for surfacing detail data on one subject rather than providing a summary Some knowledge of HTML tags is also necessary to unleash its full potential APPENDIX Full HTML code used to generate the web report template shown in Figure 1: <!DOCTYPE html> <html lang="en" xmlns=" <head> <meta charset="utf-8" /> <title>total Joint Replacement Operative Form</title> <style type="text/css"> body {font-family: Arial; font-size: 15px; } table {width:900px; } head_main { background-color: #0f1fd5; color:white; font-family: Arial; font-size: 28px; font-weight: bold; text-align: center; } head_sec { background-color: #67b2fa; color: black; font-family: Arial; font-size: 15px; font-weight: bold; text-align: left; } lbl { font-family: Arial; font-size: 15px; font-weight: bold; text-align: left; } data_odd { background-color: #feffb0; } data_even { background-color: #b6e9ff; } </style> </head> <body> <!-- Header --> <tr class="head_main"> Total Joint Replacement Operative Form Date Form Printed: &PRINT_DT <td style="font-size:20px;color:red;text-align:right">&mrn <!-- Patient Characteristics--> <td class="head_sec">patient Characteristics 8

9 <td class="lbl">gender: &GENDER <td class="lbl">current Age: &AGE <td class="lbl">height (inch):&height <td class="lbl">race: &RACE <td class="lbl"> <td class="lbl">weight (lbs): &WEIGHT <td class="lbl">surgical Site:&OPSITE <td class="lbl">surgical Side:&OPSIDE <td class="lbl"> <!-- Diagnosis--> <td class="head_sec">diagnosis <table border="0" cellpadding="0" cellpsacking="0"> <tr class="head_sec" style="color:white"> <th width="100">code </th> <th>description <tr class="data_odd"> &DX01 &DESC01 <tr class="data_even"> &DX02 &DESC02 <tr class="data_odd"> &DX03 &DESC03 <tr class="data_even"> &DX04 &DESC04 </th> <!-- Surgery --> <td class="head_sec">implantation Surgery <td class="lbl" width="250">procedure: &PX 9

10 <td class="lbl">month/year: &OPDATE <td class="lbl">implantation Surgeon: </body> </html> <td class="lbl">implantation Location: &SURGEONNM &LOCATION REFERENCES Gilbert, Jeffery D (2005), Web Reporting Using the ODS SUGI 30 Paper Available from: www2sascom/proceedings/sugi30/095-30pdf [Accessed 14th July 2015] Haworth, Lauren (2001), HTML for the SAS Programmer, SUGI 26 Paper Available from: Uwww2sascom/proceedings/sugi26/p185-26pdfU [Accessed 14th July 2015] Smith, Kevin D (2013), Cascading Style Sheets: Breaking Out of the Box of ODS Styles, Paper Available from: Uhttp://supportsascom/resources/papers/proceedings13/ pdfU [Accessed 14th July 2015] CONTACT INFORMATION Your comments and questions are valued and encouraged Contact the author at: Name: Yuexin Cindy Chen Enterprise: Kaiser Permanente, Surgical Outcomes and Analysis Address: 8954 Rio San Diego Drive, Ste 406 City, State ZIP: San Diego, CA Work Phone: 858 / Fax: 858 / yuexinxchen@kporg Web: 2 6T Uhttp://implantregistrieskporgU26 T SAS and all other SAS Institute Inc product or service names are registered trademarks or trademarks of SAS Institute Inc in the USA and other countries indicates USA registration Other brand and product names are trademarks of their respective companies 10