PeopleTools 8.4: SQR for PeopleSoft Developer's Guide PeopleTools 8.4: SQR for PeopleSoft Developer's Guide SKU Tr84SQR-B 0302 PeopleBooks Contributors: Teams from PeopleSoft Product Documentation and Development. Copyright © 2002 PeopleSoft, Inc. All rights reserved. Printed in the United States. All material contained in this documentation is proprietary and confidential to PeopleSoft, Inc. ("PeopleSoft"), protected by copyright laws and subject to the nondisclosure provisions of the applicable PeopleSoft agreement. No part of this documentation may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, including, but not limited to, electronic, graphic, mechanical, photocopying, recording, or otherwise without the prior written permission of PeopleSoft. This documentation is subject to change without notice, and PeopleSoft does not warrant that the material contained in this documentation is free of errors. Any errors found in this document should be reported to PeopleSoft in writing. The copyrighted software that accompanies this document is licensed for use only in strict accordance with the applicable license agreement which should be read carefully as it governs the terms of use of the software and this document, including the disclosure thereof. PeopleSoft, the PeopleSoft logo, PeopleTools, PS/nVision, PeopleCode, PeopleBooks, PeopleTalk, and Vantive are registered trademarks, and "People power the internet." and Pure Internet Architecture are trademarks of PeopleSoft, Inc. All other company and product names may be trademarks of their respective owners. The information contained herein is subject to change without notice. Contents SQR for PeopleSoft Developer’s Guide Preface About This PeopleBook..................................................................................................... xi Before You Begin.............................................................................................................. xi PeopleSoft Application Fundamentals ............................................................................. xii Related Documentation .................................................................................................... xii Hard-copy Documentation........................................................................................ xiii PeopleBooks Standard Field Definitions......................................................................... xiii Typographical Conventions and Visual Cues....................................................................xv Page and Panel Introductory Table.................................................................................. xvi Comments and Suggestions............................................................................................. xvi Chapter 1 Simple SQR Program Working with the SQR for PeopleSoft Developer’s Guide............................................. 1-1 Audience ................................................................................................................... 1-2 How to Use the SQR for PeopleSoft Developer’ s Guide ........................................ 1-2 Related Documents ................................................................................................... 1-3 Syntax Conventions .................................................................................................. 1-3 Setting Up the Sample Database............................................................................... 1-3 Sample Program - Printing a Text String.................................................................. 1-4 Creating and Running an SQR Program.......................................................................... 1-4 SQR Output ..................................................................................................................... 1-5 Understanding the SQR Commands ......................................................................... 1-6 Chapter 2 Headings and Footings Understanding the Page in SQR ...................................................................................... 2-1 Sample Program - Adding the Heading and Footing....................................................... 2-2 Creating Page Headings and Footings............................................................................. 2-2 Page Heading ............................................................................................................ 2-2 Page Footing ............................................................................................................. 2-3 Order of Execution.................................................................................................... 2-3 P EOPLES OFT P ROPRIETARY AND C ONFIDENTIAL C ONTENTS iii SQR FOR P EOPLES OFT D EVELOPER' S G UIDE Chapter 3 Selecting Data From the Database Sample Program - Listing and Printing Data...................................................................3-1 Understanding the SQR Program..............................................................................3-2 SQR SELECT Statement.................................................................................................3-3 Syntax of the SELECT Statement.............................................................................3-3 Positioning Data........................................................................................................3-4 Chapter 4 Column Variables Using a Column Variable in a Condition.........................................................................4-1 Changing the Column Variable Name.............................................................................4-2 Chapter 5 Using Break Logic Understanding Break Logic.............................................................................................5-1 Using ON-BREAK ..........................................................................................................5-3 Skipping Lines Between Groups .....................................................................................5-4 Arranging Multiple Break Columns ................................................................................5-5 Using Break Processing Enhancements...........................................................................5-7 Handling Page Breaks .............................................................................................5-11 Printing the Date......................................................................................................5-11 Obtaining Totals......................................................................................................5-12 Hyphens and Underscores.......................................................................................5-12 Setting Break Procedures With BEFORE and AFTER .................................................5-13 Understanding the Order of Events.........................................................................5-13 Controlling Page Breaks With Multiple ON-BREAK Columns ...................................5-19 Saving a Value When a Break Occurs...........................................................................5-19 Using ON-BREAK on a Hidden Column......................................................................5-20 Restrictions and Limitations of ON-BREAK ................................................................5-22 Chapter 6 SETUP Section Understanding the SETUP Section..................................................................................6-1 Creating the SETUP Section............................................................................................6-1 Using DECLARE-LAYOUT...........................................................................................6-2 Sample SETUP Program...........................................................................................6-2 SQR Page Layout......................................................................................................6-2 Overriding the Default Settings .......................................................................................6-3 Declaring the Page Orientation........................................................................................6-4 C ONTENTS iv P EOPLES OFT P ROPRIETARY AND C ONFIDENTIAL SQR FOR P EOPLES OFT D EVELOPER' S G UIDE Chapter 7 Master/Detail Reports Understanding Master/Detail Reports ............................................................................. 7-1 Creating a Master/Detail Report...................................................................................... 7-1 Sample Program - Master/Detail Report ......................................................................... 7-2 Correlating Subqueries .................................................................................................... 7-3 Sample Program Output............................................................................................ 7-4 Chapter 8 Cross-Tabular Reports Understanding Cross-Tabular Reports ............................................................................ 8-1 Understanding Arrays...................................................................................................... 8-2 Creating the Array ........................................................................................................... 8-4 Grouping by Category ....................................................................................................