Das Output Delivery System

Transkript

1 ODS Das Output Delivery System Eine Einführung Grischa Pfister Systematics Integration GmbH Info Ware Waldhofer Straße 11/ Heidelberg

2 Der Referent 10 Grischa Pfister Seit 1993 SAS aktiv 1999 Info Ware Ab 04/ Arbeitsfelder Anwendungsentwicklung AF, IntrNet, Java Data Warehouse Balanced Scorecard Schulungen Base, AF, Java

3 Einleitung 10 Zeitrahmen 14:00 18:00 Uhr Pausen ca. 15:15 15:30 und 16:45 17:00 Uhr 10 Ablauf Vortrag Anwendungsbeispiele 10 Fragen Immer und jederzeit

4 Agenda 10 Das Konzept 10 Grundlegende Beispiele 10 Output Objekte 10 Der Output Kanal 10 Ods Destinations Printer / PDF / RTF 10 HTML Ausgabe 10 Ods und Graphiken 10 Ods Styles 10 Ods und Reporting Prozeduren 10 Table & Style Templates 10 Neues in V9

5 Literaturhinweise 10 Haworth, Lauren E. (2001): Output Delivery System: The Basics, Cary, NC. [Reihe Books by users] 10 SAS OnlineDoc Im Lieferumfang enthalten Auch online verfügbar (mit Registrierung) support.sas.com Communities -> Base SAS 10 SUGI-Proceedings

6 Das Konzept

7 SAS-Output vor ODS 10 Zwei Formen Listing im Output-Fenster Ausgabe-Tabellen 10 Nachteile Manche Prozeduren erzeugen keine Tabellen Nicht alle Informationen in Tabellen Statisch Keine Proportional-Schriftarten Keine echte Tabellenstruktur Übernahme in Textverarbeitung, Tabellenkalkulation, Graphikprogramme schwer oder gar nicht möglich Hoher Nachbearbeitungsaufwand

8 SAS-Output mit ODS 10 WYSIWYG Alles was im OUTPUT-Fenster erscheint steht im ODS zur Verfügung Alle Informationen aller Prozeduren 10 Parallelisierung des Output Ergebnisse werden an viele Kanäle gleichzeitig geliefert 10 Gliederung des Output Prozedur-Output wird in Objekte zerlegt Zugriff auf jedes einzelne Objekt möglich

9 ODS Ausgabe-Kanäle 10 Listing 10 Output 10 HTML 10 PDF 10 RTF 10 Printer 10 PS 10 Experimental LateX XML Markup... Output-Fenster SAS-Tabelle Dokument für WWW Dokument für Acrobat Reader Dokument für Textverarbeitung Systemdrucker Postscript

10 Funktionsweise des ODS Listing Daten- Komponente Kanal Listing Output Style SAS-Tabelle HTML Dokument Table Template Output-Objekt HTML RTF PDF PRINTER... Template RTF Dokument PDF Dokument Ausdruck...

11 ODS-Syntax 10 Globale Statements Voll batch-fähig 10 Schalterprinzip Kanal wird geöffnet Output von Prozeduren/Data Steps Kanal wird geschlossen Ergebnis ist betrachtbar

12 Öffnen und Schließen von ODS-Kanälen 10 Öffnen eines Kanals Ods Kanal; Ods Kanal File = pfad ; Ods Kanal output-objekt = SAS-Tabelle; 10 Schließen eines Kanals Ods Kanal Close; Ods _all_ Close; 10 Grundprinzip Es muss mindestens ein Kanal geöffnet sein Ansonsten Warning im LOG-Fenster

13 Grundlegende Beispiele

14 Ods Listing 10 Ein-/Ausschalten Ods Listing;... Ods Listing Close; 10 Beispiel01.sas

15 Ods Html 10 Ein-/Ausschalten Ods Html File = fileref pfad ;... Ods Html close; 10 Beispiel02.sas

16 Ods Pdf 10 Ein-/Ausschalten Ods Pdf File = fileref pfad ;... Ods Pdf Close; 10 Beispiel03.sas

17 Ods Rtf 10 Ein-/Ausschalten Ods Rtf File = fileref pfad... Ods Rtf Close; 10 Beispiel04.sas

18 Ods Printer/PS 10 Ein-/Ausschalten Ods Printer <Display>; Ods Ps File = fileref pfad ;... Ods Printer/Ps Close; 10 Beispiel05.sas

19 Mehrere Kanäle gleichzeitig verwenden 10 Unterschiedliche Kanäle Ods Pdf File = fileref pfad ; Ods Html File = fileref pfad ;... Ods _all_ Close; 10 Beispiel06.sas

20 Mehrere Kanäle gleichzeitig verwenden 10 Gleiche Kanäle Ods Html (id=1) File = fileref pfad ; Ods Html (id=2) File = fileref pfad ;... Ods Html (1) Close;... Ods Html (2) Close 10 Beispiel07.sas

21 Ods Grundeinstellungen 10 Tools -> Options -> Preferences 10 Tabber Results Ods Listing Ergebnisse als HTML Style = default Web-Browser ❿ Umstellen unter Tabber Web Direkte Anzeige der Ergebnisse

22 Output Objekte

23 10 Ods teilt Prozedur-Output in Objekte ein Jedes Objekt ist identifizierbar Jedes Objekt ist einzeln ansprechbar 10 Anzahl der Output Objekte ist abhängig von Prozedur Prozedur-Optionen By-Gruppen

24 10 Identifizieren von Output Objekten Ods Trace On;... Ods Trace Off; 10 Inhalt des Trace-Satzes Name des Output Objektes Label des Output Objektes Name des verwendeten Table Templates Pfad des Output Objekts 10 Beispiel08.sas 10 Results-Fenster zeigt Output Objekte an

25 Auswahl von Output Objekten 10 Select-/Exclude-Liste Enthält Auswahl von Output Objekten Eine globale Liste Eine Liste für jeden aktiven Kanal 10 Anzeigen der Select-/Exclude-Liste Ods <Kanal> Show; Dabei muss der Kanal muss aktiv sein 10 Beispiel09.sas

26 10 Auswahl von Output Objekten Ods <Kanal> Select ods-objekt <ods-objekt...>; Ods <Kanal> Exclude ods-objekt <ods-objekt...>; Ods <Kanal> (Select Exclude) (All None); Dabei kann ods-objekt sein ❿ Name aus Trace-Satz ❿ Pfad aus Trace-Satz ❿ Label aus Trace-Satz ❿ Mischung aus Label und Pfad 10 Beispiel10.sas

27 Voreinstellungen der Auswahllisten 10 Globale Select-/Exclude-Liste Select All 10 Alle Bericht-Kanäle Select All 10 Output-Kanal Exclude All 10 Beispiel11.sas

28 10 Gültigkeitsdauer der Auswahl Nachfolgende Prozedur 10 Option Persist macht Auswahl eines Objektes dauerhaft muss mit neuem Statement überschrieben werden Ods <Kanal> (Select Exclude) ods-objekt(persist);... Ods <Kanal> Select All; 10 Beispiel12.sas

29 Output Kanal

30 Ods Output 10 Ein-/Ausschalten Ods Output ods-objekt = SAS-Tabelle...;... Ods Output Close; 10 Beispiel13.sas

31 10 Verarbeitung von By-Gruppen Standardverhalten: alle By-Gruppen in eine Tabelle Match_all-Option: Ods Output ods-objekt(match_all<=mvar>)= SAS-Tabelle; jede By-Gruppe in eigene Tabelle automatische Benennung mvar enthält Namen der erzeugten Tabellen 10 Beispiel14.sas

32 10 Verarbeiten mehrerer Prozeduren Match_all + Persist-Option Ods Output ods-objekt(match_all<=mvar <Persist=run proc>>) = SAS-Tabelle;... Ods Output Close; Erhält Benennungsschema 10 Beispiel14a.sas

33 ODS Destinations Printer / PDF / RTF

34 Seitenkontrolle 10 Grundeinstellung Jede Prozedur beginnt neue Seite Innerhalb der Prozedur selbst keine Eingriffsmöglichkeit 10 Seitenumbrüche steuern Startpage-Anweisung Ods Kanal Startpage = off; Schaltet automatischen Seitenumbruch nach Prozedur aus Ods Kanal Startpage = on; Schaltet automatischen Seitenumbruch nach Prozedur ein Ods Kanal Startpage = now; In Verbindung mit Ods Startpage off erzwingt Seitenumbruch an bestimmter Stelle 10 Beispiel15.sas

35 Allgemeines Layout 10 Optionen für die Seitengestaltung Title Titel Footnote Fußnoten [no]center linksbündig [no]number keine Seitenzahlen [no]date kein Datum Orientation = portrait landscape Hochformat Querformat papersize = Iso A4 (x,y) Seitengröße [left right top bottom]margin = n Randeinstellungen Funktionieren aber nicht immer mit allen Kanälen Beispiel16.sas

36 Titel und Fußnoten 10 Title & Footnote Ähnlich SAS/GRAPH verwendbar ❿ Font = Schriftart ❿ Height = Schriftgröße ❿ Color = Farbe ❿ Justification = Ausrichtung 10 Beispiel17.sas

37 Inline-Formatierung 10 Ods Escapechar = Zeichen ; Definiert Zeichen als Beginn einer Escape-Sequenz 10 Standard Escape-Sequenzen [arg]n [arg] Leerzeilen einfügen S={} Style-Attribute {super text} hochgestellt {sub text} tiefgestellt [M Markierung (nur Printer) -2n Einzug auf letzte Markierung] R/[RTF PDF HTML] Roh-Text für eine Destination 10 InlineFormatierung01.sas

38 PDF Spezifika 10 Notoc 10 NoPdfNote Kein Inhaltsverzeichnis Keine Annotations Style-Attribut flyover wird in PDF Note umgewandelt 10 Columns = n Ausgabe in mehrere Spalten 10 Text = Einfügen von Text 10 V9 Compress = [0 9]

39 RTF Spezifika 10 BodyTitle 10 Author = 10 Title = Titel im Text (buggy) Angabe des Autors Angabe des Titels 10 RTF-spezifische Felder verwenden Title/Footnote beginnt mit {, endet mit } R/RTF Anweisung {Seite \field{\*\fldinst PAGE }} 10 templatefaq/template_rtf.html 10 Nach rtf specification suchen 10 InlineFormatierung02.sas

40 10 V9 odsprinter/new9.html Ods Layout Image Scaling Weitere Inline-Formatierungen ❿ Z.B. freie Seitenumbruch-Steuerung

41 HTML Ausgabe

42 10 Erstellen ganzer Web-Sites im Batch Statische Reports als HTML Automatische Erzeugung von Framesets Verwendung von Cascading Style Sheets Verlinken verschiedener Seiten Interaktive Graphiken Graphiken mit Hyperlinks Aufsplitten der Ergebnisse auf mehrere Dateien

43 10 Was ist ein Frameset? Konzept in HTML Zeigt gleichzeitig mehrere HTML-Dateien an Unterteilt die Anzeige in verschiedene Bereiche (Frames) 10 Mit Ods möglich Inhaltsverzeichnis Seitenverzeichnis Hauptseite

44 10 Erstellen eines Frameset mit ODS Ods Html Path = verzeichnis (Url = none) Body = name1.html Contents = name2.html Page = name3.html Frame = name4.html ; Path: Pfad unter dem alle Dateien angelegt werden (Url = none): Hyperlinks werden relativ angelegt Body: Hauptseite Contents: Inhaltsverzeichnis Page: Seitenverzeichnis Frame: Html-Seite, die den Frameset enthält 10 Beispiel18.sas

45 Unterstützung von Cascading Style Sheets 10 Hintergrund HTML: tag-gesteuerte Layoutanweisungen, ASCII Dateien sollen möglichst klein sein Wie wird Layout definiert? ❿ Für jedes Element einzeln ❿ Definition von Klassen (Cascading Style Sheet) 10 Verschiedene Möglichkeiten CSS zu verwenden Ods Html... Css; eingebettetes Stylesheet Ods Html... Stylesheet = name.css ; CSS wird erstellt Ods Html... Stylesheet = (Url= ); vorhandenes Stylesheet wird benutzt 10 Beispiel19.sas

46 10 Aufsplitten des Output HTML-Dateien sollten möglichst klein sein Grundeinstellung: aller Prozedur-Output landet in einer Datei 10 NewFile-Option Ods Html... NewFile = Output Page Proc; Erstellt neue Dateien für ❿ Jedes Output Objekt ❿ Jede logische Seite ❿ Jede Prozedurausgabe 10 Beispiel20.sas

47 10 Eingriffsmöglichkeiten in das Inhaltsverzeichnis Ods Proclabel text ; Ändert die Hauptüberschrift Option Contents = text bei den Prozeduren Print, Report und Tabulate (hier auch als Option im Table- Statement) Ändert die Unterüberschrift(en) Ods Noptitle; Unterdrückt den Prozedurspezifischen Titel 10 Beispiel21.sas

48 10 HTML direkt verwenden Titel und Fußnoten dürfen HTML-Code enthalten 1. Zeichen muss < sein!! 10 Beispiel22.sas 10 Corporate Design nutzen Notop Keine HTML-Startsequenz Nobot Keine HTML-Schlusssequenz 10 Beispiel23.sas

49 Ods und Graphiken

50 10 Rtf Scheint momentan nicht korrekt zu funktionieren -> Installationsproblem? TTFs gehen verloren -> Graphiken getrennt erstellen Devices wmf, emf, sasemf 10 Beispiel24.sas 10 Pdf Vortrag von Heinrich Stürzel auf der KSFE 2002

51 10 HTML Pixel-Graphiken in GIF- bzw. JPEG-Format Werden als Referenz in Seite integriert (<Img src= >) Ods Html Gpath = verzeichnis (Url=none); setzt das Verzeichnis, in dem Graphiken gespeichert werden 10 SAS/GRAPH Treiber JPEG GIF ❿ Goptions xpixels = n ypixels = n [no]transparency 10 Beispiel25.sas

52 10 Spezielle SAS/GRAPH Treiber ActiveX Java Interaktive Graphiken mit diversen Möglichkeiten wie ❿ Anzeige von Werten ❿ Rotieren Strg + LMB ❿ Verschieben Alt + LMB ❿ Zoomen Shift + LMB ❿ Selektion Strg + Shift + LMB ❿ Umstellen des Graphiktyps Kontextmenü ❿ Beispiel26.sas

53 ODS Html & SAS/GRAPH 10 Erweiterung der Graphik-Prozeduren Graphiken mit Hyperlinks versehen Option Html = variable in den verschiedenen Statements 10 Schritte zum Erstellen von gelinkten Graphiken 1. Tabelle mit Drillvariable erzeugen variable = href = name.html ; 2. Graphik erzeugen 3. Die Seiten erzeugen, auf die verwiesen wird 10 Beispiel27.sas

54 ODS Styles

55 10 Abstrakte Beschreibung von ODS-Elementen Dokument Inhaltsverzeichnis Seitenverzeichnis 10 Layoutangaben Farben Schriftarten (Größe, Gestaltung) Tabellengestaltung (Abstände, Ränder) Beschriftung (z.b. des Inhaltsverzeichnisses) 10 Werden immer verwendet HTML -> default RTF -> rtf PDF -> printer PRINTER/PS -> printer

56 10 Mitgelieferte Styles Default D3d Brick statdoc Minimal sasweb barrettsblue... Tools -> Options -> Preferences -> Results Tabber 10 Verwendung von Styles Ods Kanal Style = name; 10 Beispiel28.sas

57 ODS und Reporting Prozeduren Proc Print, Proc Report, Proc Tabulate

58 10 Neue Style-Option Style = {style-anweisung...}; Style(element) = {style-anweisung...}; Überschreibt Layoutanweisungen des gewählten Styles 10 Style Anweisungen (Auswahl) Background = Farbe Foreground = Farbe bordercolor = Farbe Schriftart spezifisch ❿ Font_face= Schriftart ❿ Font_size= Schriftgröße ❿ Font_weight= Schrift-Gewichtung (normal/fett) ❿ Font_style= Darstellung (italic=kursiv)

59 Zellenlayout ❿ Cellheight= ❿ Cellwidth= ❿ Cellpadding= ❿ Cellspacing= ❿ Just= ❿ Vjust= Graphische Elemente ❿ BackgroundImage= ❿ PreImage= ❿ PostImage= Zellenhöhe Zellenbreite Randabstand innerhalb Zelle Abstand zwischen Zellen horizontale Ausrichtung vertikale Ausrichtung Hintergrundbild Bild vor Objekt Bild nach Objekt HTML spezifisch ❿ PreHtml= ❿ PostHtml= ❿ Url= ❿ Flyover=

60 10 ODS & Proc Print Output in Elemente unterteilt Jedes Element kann einzeln formatiert werden Style-Angaben für ❿ Gesamt-Tabelle ❿ Spaltenüberschriften ❿ Obs-Spalte ❿ Datenbereich ❿ Einzelne Spalte ❿ Einzelne Zelle (Ampel-Funktion) Achtung bei Formaten: ODS verarbeitet formatierte Werte!!! 10 Beispiel29.sas

61 10 ODS & Proc Report Globale Angaben als Optionen in Prozeduraufruf ❿ Header ❿ Column Spaltenbezogene Angaben als Optionen im Define-Block ❿ Header ❿ Column 10 Beispiel30.sas

62 10 ODS & Proc Tabulate Verwenden der Style-Option in verschiedenen Statements Class Classlev Var Keyword Box-Option Table-Statement 10 Beispiel31.sas

63 Table & Style Templates

64 10 Table Template Grund-Layout Aufteilung in Spalten Spaltenbeschriftung Zahlenformatierung Kann auch Style-Anweisungen enthalten 10 Style Template Layout der Elemente Abhängig vom Kanal

65 10 Objekt-orientierter Ansatz Default Printer PDF RTF [...]Printer RTF Statdoc D3d,...

66 10 Verwaltung von Table & Style Templates Ods Template Viewer ❿ Kommando OdsTemplate ❿ Results-Fenster Hierarchische Organisation in MT itemstore ❿ Defaults: Sashelp.Tmplmst (schreibgeschützt) 10 Eigene: Sasuser.Templat Anlegen eigener itemstores mit Proc Template Ods Suchpfad ❿ Ods Path Show; ❿ Ods Path libref.itemstore(modus)...; modus = read update write

67 10 Table Templates verändern Beispiel Proc Univariate: Extreme Observations Beschriftung eindeutschen Wird in Sasuser.Templat gespeichert 10 Beispiel32.sas

68 10 Style Templates anpassen Neuen Style ableiten Gewünschte Änderungen vornehmen 10 Aufbau des Styles Default Definition von Schriftarten Definition von Farben Definition der einzelnen Elemente Hierarchie in OnlineDoc beschrieben Base SAS Software -> Guide to the SAS Output Delivery System -> Reference -> The TEMPLATE Procedure -> Concepts 10 Beispiel33.sas

69 10 Data Step Reporting & Table Templates Mit Table Templates Schablonen entwerfen ❿ Spaltenlayout ❿ Beschriftung ❿ Style-Anweisungen ❿ Ampelfunktion mit Hilfe von ❶ ❶ ❶ Cellstyle-Anweisung Style-Anweisung + Expression-Funktion Style-Anweisung + Format ❿ Berechnete Spalten ❿ Verändern von Werten 10 Beispiel34.sas Beispiel38.sas

70 Neues in V9

71 Ods Markup 10 Neue Destination 10 Stellt Event-Modell zur Verfügung

72 10 Event = Ereignis Start & finish ODER stateless Mit Trigger event können eigene Events aufgerufen werden 10 Verhalten in Tagsets zusammengefasst 10 Z.B. Tagset Csv 10 Tagsets01.sas

73 Tagsets als Informationsquelle 10 Informationen über Style-Elemente anzeigen Style_popup Style_display namedhtml 10 Informationen über Events anzeigen Event_map 10 Volle Freiheit für Benutzer aber hohe Komplexität Eric Gebhart: MARKUP: The Power of Choice and Change. Sugi 27, Advanced Tutorials 10 Tagsets02.sas

74 Ods Document Experimentell in V8.2, produktiv in V9 10 Speichern und Wiedergeben von Output-Objekten 10 Z.B. Ändern der Reihenfolge 10 Wird als Membertype Itemstore gespeichert 10 Ods Document Name = <Lib.>Itemstore(mode);

75 Proc Document 10 Proc Document Name= <Lib.>Itemstore; List / Levels = all; Replay <object <, object>; Make directory; Setlabel directory text ; Dir directory ^^; Copy object To ^;... Run; Quit; ^ Dieses Verzeichnis (.) ^^ Ein Verzeichnis hoch (..) 10 OdsDocument01.sas

76 Noch Fragen? Weitere Fragen oder Anregungen? Ab