crystal enterprise sap edition - users' guide.pdf

Upload: sanjay69uk

Post on 13-Apr-2018

242 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    1/51

    Crystal Enterprise SAPEditionUsers Guide

    Crystal Decisions, Inc.895 Emerson St.

    Palo AltoCalifornia, USA 94301

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    2/51

    Copyright 2002 Crystal Decisions, Inc., 895 Emerson St., Palo Alto, California,USA 94301. All rights reserved.

    Issue 1.

    No part of this documentation may be stored in a retrieval system, transmitted orreproduced in any way, except in accordance with the terms of the applicablesoftware license agreement. This documentation contains proprietary informationof Crystal Decisions, Inc., and/or its suppliers.

    Trademark Acknowledgements

    2002 Crystal Decisions, Inc. All rights reserved. Crystal Decisions, Crystal,Crystal Reports, Crystal Enterprise, Seagate Info, Seagate Software, Seagate, andthe Seagate and Crystal logos are trademarks or registered trademarks of CrystalDecisions, Inc. and/or Seagate Technology, Inc. All other trademarks referencedare the property of their respective owner.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    3/51

    Crystal EnterpriseSAP Edition Users Guide i

    Contents

    Chapter 1: Welcome to Crystal EnterpriseSAP Edition

    What is Crystal EnterpriseSAP Edition? ........................................... 2

    Who should use this guide? ............................................................... 2

    Chapter contents ................................................................................................... 2

    Crystal Care technical support .......................................................... 3

    Crystal Training ................................................................................. 3

    Crystal Consulting ............................................................................. 3

    Document conventions ..................................................................... 4

    Chapter 2: Reporting off BW queries

    Formatted reporting overview .......................................................... 6

    Commands and connection settings in Crystal Reports .......................................... 6

    Creating new queries for reports ...................................................... 9

    Selecting existing queries for reports .............................................. 11

    Saving reports to BW ...................................................................... 13Using your own reports as templates .............................................. 14

    Building your first report off the SAP DemoCube ........................... 15

    Chapter 3: Reporting off InfoSets and ABAP Queries

    Connecting to SAP with the driver .................................................. 24

    Using the Report Experts ..................................................................................... 24

    Using the Log On Server command ..................................................................... 25Logging on to the SAP server ............................................................................... 25

    Selecting an ABAP query or an InfoSet ........................................... 26

    Configuration options ..................................................................... 29

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    4/51

    ii Crystal EnterpriseSAP Edition Users Guide

    Chapter 4: Designing and Translating Reports

    Designing and formatting Crystal reports ....................................... 32

    Using the Report Expert to build a report ............................................................. 32

    Modifying predefined Crystal reports ............................................. 33

    Incorporating data from multiple data sources ............................... 35

    Designing reports for translation .................................................... 36

    Preparing reports for translation ........................................................................... 36

    Conditional formatting with the LanguageCode% formula ................................... 38

    Chapter 5: Publishing and Viewing Reports

    Publishing predefined reports to Crystal Enterprise ........................ 42Batch publishing reports from BW ....................................................................... 42

    Viewing reports ............................................................................... 42

    Index .................................................................................45

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    5/51

    Crystal EnterpriseSAP Edition Users Guide 1

    Welcome to Crystal EnterpriseSAP Edition 1

    This chapter briefly describes Crystal EnterpriseSAPEdition and outlines the contents and the intendedaudience of this guide. It also includes a brief description ofthe document conventions used within this guide.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    6/51

    What is Crystal EnterpriseSAP Edition?

    2 Crystal EnterpriseSAP Edition Users Guide

    What is Crystal EnterpriseSAP Edition?Crystal EnterpriseSAP Edition provides you, the SAP user, with the ability toextract the business intelligence contained within SAP Business InformationWarehouse (BW). By generating Crystal reports from SAP BW queries, ABAPqueries, and InfoSets, you can organize, format, and share your SAP data. SAPePortfolio allows you to share your reports over the Web, and SAP Authenticationenables Single Sign On between your SAP system and Crystal Enterprise.

    Crystal EnterpriseSAP Edition consists of two main components: Crystal Reportsis the report-design tool that allows you to report off your SAP data, and CrystalEnterprise provides the framework for managing, scheduling, and distributingreports over the Web. This guide documents the report-design features specific toCrystal ReportsSAP Edition, and shows how to publish and view these reports ina Crystal Enterprise environment.

    Who should use this guide?This guide is intended for SAP users who want to use the power of Crystal Reportsto design professional reports based on their SAP data. Familiarity with yourInfoProviders (BW queries, InfoSets, and so on), with the Business Explorer (BEx)Query Designer, and with your standard translation workflow is beneficial, butnot required.

    For details on installing Crystal ReportsSAP Edition, see theCrystal EnterpriseSAP Edition Installation Guide(installguide.pdf), located in the sapdocs directoryof the product CDs.

    Chapter contentsThe following is a short description of each of the remaining chapters in this guide.

    Chapter 2: Reporting off BW queries

    This chapter introduces you to Crystal ReportsSAP Edition and the integratedfeatures of the SAP Tools toolbar. It shows how to create and select queries forreports, and how to save reports to BW. It concludes with a tutorial that guides youthrough the creation of a report based on the SAP DemoCube.

    Chapter 3: Reporting off InfoSets and ABAP Queries

    This chapter shows how to connect to SAP with the InfoSet driver in order to selectan InfoSet or an ABAP query as a data source for a Crystal report.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    7/51

    1 Welcome to Crystal Enterprise SAP Edition

    Crystal EnterpriseSAP Edition Users Guide 3

    Chapter 4: Designing and Translating Reports

    This chapter introduces you to the Report Experts in Crystal Reports and providessome reporting details that are relevant within SAP environments. In addition, thechapter shows how to prepare reports for translation, and how to conditionally

    modify the reports design based on the users logon language.

    Chapter 5: Publishing and Viewing Reports

    This chapter describes how to publish Crystal reports to Crystal Enterprise andsubsequently view those reports from various applications including SAP ePortfolio.

    Crystal Care technical supportYour standard SAP service agreement may include technical support. If yourequire assistance when integrating Crystal EnterpriseSAP Edition with yourSAP system, it is recommended that you first check your SAP service agreement

    and follow your usual SAP support procedures.To find out about the Crystal Care technical support programs that are available:

    Go to our support web site at:http://support.crystaldecisions.com/crystalcare/

    Contact your regional office. For details, go to:http://www.crystaldecisions.com/contact/offices.asp

    Crystal TrainingWhether youre a developer, information technology professional, or businessuser, we offer a wide range of Crystal EnterpriseSAP Edition training coursesdesigned to build or enhance your existing skills. Courses are available online, atcertified training centers, or at your own site:

    For a complete list of training courses and special offers, visit:http://www.crystaldecisions.com/training/

    Or contact your regional office. For details, go to:http://www.crystaldecisions.com/offices/

    Crystal ConsultingOur global team of certified consultants and consulting partners can guide you

    through a corporate-wide solutionincluding strategy, design, integration anddeploymentfor the fastest results, maximum performance, and increasedproductivity.

    To learn more, visit:http://www.crystaldecisions.com/consulting/

    Or contact your regional office. For details, go to:http://www.crystaldecisions.com/offices/

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    8/51

    Document conventions

    4 Crystal EnterpriseSAP Edition Users Guide

    Document conventionsThis guide uses the following conventions:

    Commands and buttons

    For easy recognition within procedures, User Interface (UI) features appear inbold type. For example: On the Filemenu, clickNew.

    Keyboard shortcuts

    Delete means the Delete key, or the Del key on your numeric keypad. Entermeans the Enter, Return, or CR key, depending on which of these keys appearson your keyboard.

    Key combinations

    CTRL+KEY, SHIFT+KEY, and ALT+KEY are examples of key combinations.Hold down the first key in the combination and, at the same time, press thesecond key in the combination (designated above as KEY). For example:CTRL+C means hold the Control key down and press the letter C on your

    keyboard (CTRL+C is the Windows Copy command). Key terms are italicized when first defined.

    Monospaced font indicates data that you enter using your keyboard. Forexample: In the Formula Editor, type If Sales > 1000 Then crRed

    Monospaced, italicized font indicates variable data that you must replace withdata appropriate to your current settings, environment, or task. For example,in the following URL, you would replacewebserverhttp://webserver/crystal/enterprise/

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    9/51

    Crystal EnterpriseSAP Edition Users Guide 5

    Reporting off BW queries 2

    This chapter introduces you to Crystal ReportsSAPEdition and the integrated features of the SAP Toolstoolbar. It shows how to create and select queries forreports, and how to save reports to BW. It concludes with atutorial that guides you through the creation of a reportbased on the SAP DemoCube.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    10/51

    Formatted reporting overview

    6 Crystal EnterpriseSAP Edition Users Guide

    Formatted reporting overviewWith the BW Query driver, you can design formatted Crystal reports based on thedata stored in SAP Business Information Warehouse (BW). You base these reports onthe queries that you create with SAPs Business Explorer (BEx) Query Designer. Onceyou have designed your Crystal reports, you can save them to BW and, if required,target them for translation so theyre available to users in multiple languages.

    This chapter briefly shows how to start SAPs BEx Query Designer from withinCrystal Reports, but focuses primarily on Crystal ReportsSAP Edition and yourtask of selecting BW queries as data sources for Crystal reports. This chapterconcludes with a step-by-step tutorial that guides you through the creation of asales report that displays data from the SAP DemoCube.

    Crystal Enterprise allows you to share Crystal reports over the Web, so that allusers can view your formatted content. For details on publishing reports to CrystalEnterprise, seePublishing predefined reports to Crystal Enterprise on page 42.

    Tip: For more information on formatted reporting, see the SAP Library > BusinessInformation Warehouse > Business Explorer > Formatted Reporting: CrystalReports Integration.

    Commands and connection settings in Crystal Reports

    Crystal ReportsSAP Edition includes several integrated tools that allow you toreport off your BW data. You can access many of these tools from two locations:click the appropriate button on the SAP Tools toolbar, or click the correspondingcommand on the SAP menu. This section details the available commands andshows how to change the related settings in Crystal Reports.

    Tip: To show/hide the SAP Tools toolbar in Crystal Reports, click Toolbars on theView menu. Select the SAP Tools check box, and click OK. Commands withouticons are available only on the SAP menu.

    Button Command Function

    Create New Report froma Query

    Create a new report based on aquery that is already defined in BW.

    Open Report Open a Crystal report that hasalready been saved in BW.

    Save Report Save the currently opened report toBW. You have the option to preparethe report for translation and topublish it to Crystal Enterprise.

    Save Report As Save the report to BW with adifferent description and/or in adifferent role.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    11/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 7

    To change your connection settings

    1 On theSAPmenu in Crystal Reports, clickSettings.

    Tip:You can also click the corresponding button on the toolbar.

    The Settings dialog box appears.

    2 Select from the available options to customize the behavior of Crystal Reports:

    Default template

    In this field, you can specify a report (an .rpt file) that you want to use as atemplate for all new reports that you create from BW queries. For details,seeUsing your own reports as templates on page 14.

    Prepare reports for translation on serverIf you select this option, the reports that you save in BW are prepared fortranslation on the SAP system. For details, seePreparing reports fortranslation on page 36.

    Start BW Query Designer Launch the BW Query Designer tocreate a new query, or to modify aquery that is already defined in BW.

    Disconnect Disconnect from SAP BW.

    Settings Change your connection settings.

    SAP mode Change a predefined SAP reportinto a regular Crystal report.For details, seeModifyingpredefined Crystal reports onpage 33.

    Button Command Function

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    12/51

    Formatted reporting overview

    8 Crystal EnterpriseSAP Edition Users Guide

    Automatically publish to Crystal Enterprise

    If you select this option, the report is automatically published to CrystalEnterprise when you save it in BW. You can view published reports inseveral ways, such as from the SAP Easy Access Menu, the SAP BusinessExplorer Browser, or SAP ePortfolio. For details, seeChapter 5: Publishingand Viewing Reports.

    Suppress save dialog

    If you select this option, you are not prompted every time you save reportsto BW, and the settings that you specify here are used for all reports.

    To show field descriptions and technical field names

    1 On theFilemenu, clickOptions.

    The Options dialog box appears, with the Layout tab active.

    2 Click theDatabasetab.

    3 In the List Tables and Fields by area, clickBoth.

    When you select this option, the program identifies tables and fields using boththe name and the description assigned in the SAP system.

    4 ClickOK.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    13/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 9

    Creating new queries for reportsIf you have not already defined one or more queries within BW, you can startSAPs BEx Query Designer from within Crystal Reports. The query that you defineis automatically selected as the data source for a new Crystal report.

    Tip:When you define a query, you specify the subset of data that you want toretrieve from a particular InfoProvider that is stored in BW. Consequently, youmust be able to access at least one InfoProvider on your BW system.

    To create a new query for a report

    1 On theSAPmenu in Crystal Reports, clickStart BW Query Designer.

    Tip:You can also click the corresponding button on the toolbar.

    The SAP Logon dialog box appears.

    2 On theSystem tab, select your BW system; then clickOK.Note:If your system is not displayed, click the Group or Server tab andprovide the valid BW system information. Contact your administrator if youare unsure of the entries that need to be made.

    The next SAP Logon dialog box prompts you for User Data.

    3 Type your usual SAP user credentials in theClient,User, Password, andLanguagefields; then clickOK.

    The Query Designer appears.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    14/51

    Creating new queries for reports

    10 Crystal EnterpriseSAP Edition Users Guide

    4 On the Query Designers toolbar, clickNew Query.

    The New Query: Select InfoProvider dialog box displays the InfoAreas andInfoProviders that are available on your system.

    5 Select the InfoProvider whose data you want to base your query on; then click OK.

    The Query Designer automatically displays the InfoProvider in TabularDisplay mode, which is required when designing Crystal reports. For detailsabout Tabular Display mode, see the SAP Library > Business InformationWarehouse > Business Explorer.

    6 Define your query by selecting measures and characteristics from the KeyFigure and Dimensions lists and dragging them to the Columns area.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    15/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 11

    Note:For complete information about using the Query Designer, see the SAPLibrary > Business Information Warehouse > Business Explorer > QueryDesign: BEx Query Designer.

    7 ClickSave Query.

    8 In the Save Query dialog box, click Roles and select the role where you want tosave the query.

    9 Type aDescriptionand aTechnical Namefor the query; then click Save.

    The Technical Name must uniquely identify the query, meaning that the namecan appear only once across all InfoProviders in BW. The Technical Name canbe up to 30 characters long and must begin with a letter.

    10ClickQuit and Use Query.

    Crystal Reports generates a report that uses your query as its data source. Thereport opens in the Design tab of Crystal Reports. You can now add fields, titles,charts, and other objects to the report. For details, seeDesigning and

    formatting Crystal reports on page 32.

    Selecting existing queries for reportsIf you or someone else in your organization has already defined one or morequeries for reporting purposes within BW, you can select those queries as datasources for new Crystal reports.

    Note:The Data Explorer also provides an SAP BW Query node (in its More DataSources folder), which can be used to connect to and select a BW query for areport. However, it is recommended that you follow the procedure below whenyou base Crystal reports on your BW queries.

    To select an existing query for a report

    1 On theSAPmenu in Crystal Reports, clickCreate New Report from a Query.

    Tip:You can also click the corresponding button on the toolbar.

    The SAP Logon dialog box appears.

    2 On theSystem tab, select your BW system; then clickOK.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    16/51

    Selecting existing queries for reports

    12 Crystal EnterpriseSAP Edition Users Guide

    Note:If your system is not displayed, click the Group or Server tab andprovide the valid BW system information. Contact your administrator if youare unsure of the entries that need to be made.

    The next SAP Logon dialog box prompts you for User Data.

    3 Type your usual SAP user credentials in theClient,User, Password, andLanguage fields; then clickOK.

    The Select Query for your Crystal Report dialog box displays the queries thatare available through your Favorites, Roles, and InfoAreas in BW.

    4 Select the query whose data you want to report off; then clickOK.

    Crystal Reports generates a report that uses your query as its data source. Thereport opens in the Design tabof Crystal Reports. You can now add fields, titles,

    charts, and other objects to the report. For details, see Designing andformatting Crystal reports on page 32.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    17/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 13

    Saving reports to BWAfter designing a report based on a query, you can save the report to a role in BW.At the same time, you can prepare the report for translation, automatically publishit to Crystal Enterprise, or save it as an iView.

    Before saving your report, check the reports title by clicking Summary Info on theFile menu. The title that appears here is displayed for users in Crystal Enterprise.The technical name of the query is used as the default title, but you can replace itwith a descriptive title that is more meaningful to SAP users.

    Tip: Use the Save or Save As command on the File menu to save the report to disk.

    To save a report to BW

    1 On theSAPmenu, clickSave Report.

    Tip:You can also click the corresponding button on the toolbar.

    2 In the Save a Crystal Report to BW dialog box, select the role where youwant to save the new Crystal report.

    3 Type aDescriptionfor the report; then clickSave.

    Depending on your connection settings, the Save to BW options dialog boxmay appear.

    4 Select from the available options:

    Prepare this report for translation

    When you select this option, the strings in your report are extracted andmade available for translation within SAP. For details, seeDesigningreports for translation on page 36.

    Automatically publish to Crystal Enterprise

    For more information on publishing reports, seePublishing predefinedreports to Crystal Enterprise on page 42.

    If you are unable to publish your report to Crystal Enterprise, you mayneed to consult with your administrator about upgrading to CrystalEnterpriseEnhanced SAP Edition.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    18/51

    Using your own reports as templates

    14 Crystal EnterpriseSAP Edition Users Guide

    Dont show this dialog again

    If you select this option now, you can modify your default settings later byclicking Settings on the SAP menu. For details, seeCommands andconnection settings in Crystal Reports on page 6.

    Save report as iViewSelect this option to save the report as an iView in the SAP system, so thereport is available for integration with your SAP Portals Enterprise Portal.You will be prompted to specify the role where you want to save the iView.

    Export iView definition to .ivu file

    Select this option to export the iView to .ivu format, so you can transfer theiView to any SAP Portals Enterprise Portal. The resultant .ivu file containsall the settings and parameters for the iView. You will be prompted tospecify a name and location for the .ivu file on your local hard drive.

    5 ClickOK.

    Using your own reports as templatesBy creating customized reports that serve as templates, you can speed up theprocess of designing and formatting the reports that you generate from BWqueries. You can, for instance, create reports that include customized titles,corporate logos, or contact details in the Report Header. Or, you can placecopyright information along with page numbers in the Page Footer. You can thenselect one of these reports as the default template, which Crystal Reports will usewhenever you generate reports from BW queries.

    To create a report to use as a template

    1 Using Crystal Reports, create a blank report without specifying a data source.

    2 Add the elements that you want included in the template (text objects,graphics, hyperlinks, Special Fields, and so on).

    Note:

    You may add objects to the Report Header, Page Header, Report Footer,and Page Footer sections only, for these are the sections that are mergedinto the final report.

    When adding graphics to a template, you can insert them as pictures or asOLE objects (static, embedded, or linked).

    You can add Special Fields to your report template, so long as the field is in

    no way dependent upon your SAP data. Predefined Special Fields areavailable from the Field Explorer in Crystal Reports.

    3 When you have finished designing the template, save your work.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    19/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 15

    To specify a default template

    1 On theSAPmenu in Crystal Reports, clickSettings.

    Tip:You can also click the corresponding button on the toolbar.

    The Settings dialog box appears.

    2 In theDefault templatefield, specify the report (.rpt file) that you want to useas a template for all new reports that you create from BW queries.

    3 ClickOK.

    Note:If you subsequently rename, move, or delete your report template, CrystalReports prompts you with an error message when you attempt to create a newreport from a BW query. You must specify a new report template (or none at all)before you can create the new report.

    Building your first report off the SAP DemoCubeThis tutorial provides an introduction to Crystal Reports as you design a salesreport with the Report Expert. You begin by creating a query, which is selected asthe reports data source. You then use a Report Expert to:

    Insert and move database fields.

    Group and sort data.

    Summarize data.

    Add a title and a predefined style.

    To create a new query for a report

    1 On theSAPmenu in Crystal Reports, clickStart BW Query Designer.

    Tip:You can also click the corresponding button on the toolbar.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    20/51

    Building your first report off the SAP DemoCube

    16 Crystal EnterpriseSAP Edition Users Guide

    The SAP Logon dialog box appears.

    2 On theSystemtab, select your BW system; then click OK.

    The next SAP Logon dialog box prompts you for User Data.

    3 Type your usual SAP user credentials in theClient,User, Password, andLanguage fields; then clickOK.

    The Query Designer appears.

    4 On the Query Designers toolbar, clickNew Query.

    The New Query: Select InfoProvider dialog box displays the InfoAreas andInfoProviders that are available on your system.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    21/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 17

    5 Select theSAP DemoCube; then clickOK.

    The Query Designer automatically displays the InfoProvider in TabularDisplay mode, which is required when designing Crystal reports. For detailsabout Tabular Display mode, see the SAP Library > Business Information

    Warehouse > Business Explorer.6 Select the following characteristics from the Dimensions list, and drag them to

    the Columns area:

    Country

    Sales employee

    Material

    Material group

    7 Select the following measures from the Key Figure list, and drag them to theColumns area:

    Net value

    Tax Amount in Doc. Costs (SAP Demo)

    The Columns area should now appear as follows:

    Note:For complete information about using the Query Designer, see the SAPLibrary > Business Information Warehouse > Business Explorer > Query Design:BEx Query Designer.

    To save the query in BW

    1 ClickSave Query.

    2 In the Save Query dialog box, click Roles and select the role where you want tosave the query.

    3 Type an appropriateDescription, such as My sample sales query

    4 Type an appropriateTechnical Name, such as SALES_DEMO_QUERYThe Technical Name must uniquely identify the query, meaning that the namecan appear only once across all InfoProviders in BW. The Technical Name canbe up to 30 characters long and must begin with a letter.

    5 ClickSave.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    22/51

    Building your first report off the SAP DemoCube

    18 Crystal EnterpriseSAP Edition Users Guide

    To create a new report based on the query

    1 ClickQuit and Use Query.

    Crystal Reports generates a report that uses your query as its data source. Thereport opens in the Design tabof Crystal Reports. You can now add fields, titles,

    charts, and other objects to the report.

    Tip:To ensure that Crystal Reports displays technical names and/ordescriptions for SAP tables and fields, click Options on the File menu. Click theDatabase tab, and make your selection in the List Tables and Fields by area.

    2 On theReportmenu, clickReport Expert.

    3 When you are prompted to confirm the command, clickYes.

    The Create Report Expert displays its Data tab. You have already selectedyour BW query as the data source for the report, so it appears automatically inthe Tables available for report area.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    23/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 19

    4 ClickNext to proceed to the Fields tab.

    To select fields for the report

    1 In the Available Fields area, double-click the following fields to add them to

    the Fields to Display area: Sales employee Text

    Material Text

    Costs (SAP Demo)

    Net value

    Tax Amount in Doc.

    Tip: The fields in the Fields to Display area appear in the same order, from topto bottom, as they are displayed in the report, from left to right. You can reorderthem now using the up and down arrow keys.

    2 In the Fields to Display area, clickCosts (SAP Demo).

    3 In theColumn Heading field, delete the default textwhich is Costs (SAPDemo)and type Costs in its place.

    This changes the default column heading that is displayed in the report.4 ClickNext to proceed to the Group tab.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    24/51

    Building your first report off the SAP DemoCube

    20 Crystal EnterpriseSAP Edition Users Guide

    To group and sort the reports data

    1 In the Available Fields area, double-click the following fields to add them tothe Group By area:

    Country

    Material Text

    2 In the Group By area, select theMaterial Textfield.

    3 Click theSort Orderlist and selectin original order.

    When you view this report, the records are first grouped according to thevalues in the Country field. The resultant groups are then displayed in thereport in ascending alphabetical order. The records in each Country group arefurther divided into secondary groups based on the values in the Material Textfield. The resultant groups are displayed in their original order.

    4 ClickNext to proceed to the Total tab.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    25/51

    2 Reporting off BW queries

    Crystal EnterpriseSAP Edition Users Guide 21

    To summarize the data

    1 In the Available Fields area, double-click the following fields to add them tothe Summarized Fields area:

    Costs (SAP Demo Value)

    Net value Tax Amount in Doc.

    2 In the Summarized Fields area, select each field and ensure thatsum isselected in theSummary Type list and that Add Grand Totalsis selected.

    When you view the report, the Costs, Net value, and Tax Amount values aresummarized for each Country group.

    3 ClickNext to proceed to the Style tab.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    26/51

    Building your first report off the SAP DemoCube

    22 Crystal EnterpriseSAP Edition Users Guide

    To select a style for your report

    1 In theTitlefield, type the text you want to display as the title of the report,such as Sales grouped by country and material

    This title is inserted into the Page Header when you preview the report.

    2 In theStyle list, click one of the available styles.

    A preview of the selected style is displayed next to the Style area.

    3 ClickFinish.

    Crystal Reports refreshes the report against the query in BW and displays yournewly designed report in the Preview tab.

    4 Before making further modifications to the report, clickSave Report on theSAPmenu and save the report to a role in BW. For details, seeSaving reportsto BW on page 13.

    You may want to resize or reposition report elements, or further modify thereports design. You can, for instance, select and drag the borders of columns andcolumn headings in order to resize them in the Preview tab; or, you can quicklydisplay only a subset of the data by filtering the records with the Select Expert.

    Tip: The Crystal Reports Online Helpprovides extensive conceptual and proceduralinformation, tutorials, and examples to help you use Crystal Reports to its fullestpotential. Access the help by pressing F1 anywhere within Crystal Reports.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    27/51

    Crystal EnterpriseSAP Edition Users Guide 23

    Reporting off InfoSets and ABAP Queries3

    This chapter shows how to connect to SAP with the InfoSetdriver in order to select an InfoSet or an ABAP query as adata source for a Crystal report.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    28/51

    Connecting to SAP with the driver

    24 Crystal EnterpriseSAP Edition Users Guide

    Connecting to SAP with the driverBefore you can select an InfoSet or an ABAP query for your report, you mustconnect to SAP with the InfoSet driver. There are two ways to select a driver inCrystal Reports: use one of the Report Experts, or select Log On Server from theFile or Database menu. Both methods are described below.

    Using the Report Experts

    1 On theFilemenu, clickNew.

    The Crystal Report Gallery appears.

    2 If its not already selected, clickUsing the Report Expert.

    3 In theChoose an Expert list, clickStandard; then clickOK.

    Tip:To create a specific type of report, select the appropriate Expert.

    4 On the Report ExpertsDatatab, clickDatabase.

    The Data Explorer appears.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    29/51

    3 Reporting off InfoSets and ABAP Queries

    Crystal EnterpriseSAP Edition Users Guide 25

    5 ExpandMore Data Sources; then expandSAP R/3 Info Sets.

    The SAP R/3 Logon dialog box appears. For more details, seeLogging on tothe SAP server on page 25.

    Tip:If the SAP R/3 Logon dialog box does not appear, double-click Make

    New Connection, or close and re-open the SAP R/3 Info Sets node.

    Using the Log On Server command

    1 On theFilemenu (orDatabasemenu, if a report is already open), clickLogOn/Off Server.

    The Data Explorer appears.

    2 ExpandMore Data Sources; then expandSAP R/3 Info Sets.

    The SAP R/3 Logon dialog box appears. For more details, seeLogging on tothe SAP server on page 25.

    Tip:If the SAP R/3 Logon dialog box does not appear, double-click Make

    New Connection, or close and re-open the SAP R/3 Info Sets node.

    Logging on to the SAP server

    Regardless of the driver you select, you must specify the SAP system that you wantto report off and then provide valid user credentials for that system. Each driverprompts you for this logon information before it allows you to select the elementsthat you want to include in the report. Your user credentials are also requestedwhen you run any existing reports built off SAP data sources.

    To logon to the SAP server

    1 Once youve selected a data source and a driver, the SAP R/3 Logon dialogbox appears.

    2 On theR/3 Systemtab, select the SAP system that you want to report off.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    30/51

    Selecting an ABAP query or an InfoSet

    26 Crystal EnterpriseSAP Edition Users Guide

    Note:If your SAP administrator has not configured SAP Logon, your SAPsystem will not appear on the R/3 System tab. In this case, click the Group orServer tab and provide the valid SAP system information. Contact your SAPadministrator if you are unsure of the entries that need to be made.

    3 ClickOK.The next SAP R/3 Logon dialog box prompts you for User Data.

    4 Type your usual SAP user credentials in theClient,User, Password, andLanguage fields.

    5 ClickOK.

    Crystal Reports logs you onto the SAP system and displays the Allow ReportingOn dialog box. Use this dialog box to filter the data that is returned from the SAPsystem. For details, seeSelecting an ABAP query or an InfoSet on page 26.

    Note:If you can log on to your SAP system but the Allow Reporting On dialogbox does not appear, check your configuration options. For details, seeConfiguration options on page 29.

    Selecting an ABAP query or an InfoSetThe combined InfoSet/ABAP Query driver allows you to use an existing ABAPquery or InfoSet (also known as a Functional Area) as a source of data for a Crystalreport. The main advantage of this driver is that the ABAP query or InfoSet is builtwithin SAP by a content expert, who then makes the data set available to thebusiness user. The user can then design multiple reports by quickly referencing thesame query or InfoSet.

    Another advantage is that an InfoSet can be built on top of the logical databases inSAP. This allows the InfoSet to inherit all of the business logic and security that is

    programmed into the logical database. The disadvantage of using this driver isthat reports can contain only as much data as the ABAP query or InfoSet has beendesigned to retrieve.

    Reports based on ABAP queries and InfoSets behave similarly to reports based onstored procedures in mainstream databases. You can include only one query orInfoSet per report; however, you can insert subreports based on different queriesor InfoSets into the main report.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    31/51

    3 Reporting off InfoSets and ABAP Queries

    Crystal EnterpriseSAP Edition Users Guide 27

    Your ABAP queries and InfoSets may contain parameters that you can use to limitthe data returned from the SAP system. For example, you might specify a daterange to get data for only a certain period. If parameters are included in the ABAPquery or InfoSet, Crystal Reports prompts you to specify the values that you wantto include in the query.

    For information on designing ABAP queries and InfoSets, refer to your SAPdocumentation.

    To select an ABAP query or an InfoSet

    1 Connect to SAP with Crystal Reports, select the combined InfoSet/ABAPQuery driver, and provide your user credentials. (For details, seeConnectingto SAP with the driver on page 24.)

    The Allow Reporting On dialog box appears.

    Note:If you log on to the SAP system but the Allow Reporting On dialog boxdoes not appear, check your Crystal Reports configuration options. For details,seeConfiguration options on page 29.

    2 In the Data Source area, select eitherSAP Info Set orSAP ABAP Query.

    3 In the Work Space area, specify whether you want to search in the Global area,theLocal area, or both.

    4 In the Name Filters area, use the appropriate text field to specify the datasources that you want to make available to the report.

    Use the following techniques when selecting queries or InfoSets:

    Type full or partial names of queries or InfoSets.

    Separate distinct names with commas.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    32/51

    Selecting an ABAP query or an InfoSet

    28 Crystal EnterpriseSAP Edition Users Guide

    Add wildcards to select multiple queries or InfoSets: use a percentage sign(%) to denote any number of characters; use an underscore (_) to denote asingle character. (The % and _ wildcards correspond respectively to the *and ? wildcards used within Windows.)

    Clear the filter field and click OK to proceed without filtering. Note,

    however, that there is a limit to the number of objects that can be displayedin the Data Explorer. If the number of queries or InfoSets in SAP exceedsthis limit (which is by default 8000), you may receive an Out of Memoryerror or a blank Data Explorer.

    5 When you have specified the data sources that you want to see, clickOK.

    The Data Explorer displays the selected queries or InfoSets, along with thedescriptions defined by the SAP administrator.

    Tip:The name of an InfoProvider may have a prefix (IG, IL, QG, or QL) thatindicates its type andlocation. The first letter (I or Q) denotes the type as InfoSetor ABAP Query. The second letter (G or L) indicates whether the InfoProvideris in the global or local area. (It is possible to have two InfoProviders with thesame nameone in each area.) To view additional information, right-click anyquery or InfoSet and, on the shortcut menu, click Properties.

    6 Double-click the query or InfoSet that you want to add to the report.

    If the query or InfoSet contains parameters, the Enter Parameter Values dialogbox prompts you for information. Use the dialog box to specify the data thatyou want to include, and then click OK.

    7 When you are returned to the Data Explorer, clickClose.

    You can now add fields and continue to design your report in the usual manner.For details, seeDesigning and formatting Crystal reports on page 32.

    Tip: For additional information on parameters and on general report design topics,see theCrystal Reports Online Help.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    33/51

    3 Reporting off InfoSets and ABAP Queries

    Crystal EnterpriseSAP Edition Users Guide 29

    Configuration optionsWhen you install Crystal ReportsSAP Edition, you may need to change yourglobal reporting options to improve the experience of reporting off SAP. The stepsin this section show how to configure Crystal Reports to list tables and fields byboth name and description, and to prompt you for information whenever youaccess a database table. Your SAP system may contain thousands of tables, eachwith a predefined, non-descriptive name. These options ensure that you can selectspecific tables for a report without having to search through an immense list.

    If you are reporting off data sources other than SAP, you may prefer not to beprompted for information every time you connect to the database. If so, clear theReprompt user when connecting option.

    Note:If you are unable to connect to certain SAP tables, or if you cannot viewtable or field names or descriptions, ensure that these recommended optionsremain selected.

    To change configuration options

    1 Start Crystal Reports.

    2 On theFilemenu, clickOptions.

    3 Click theDatabasetab.

    4 In the Explorer Options area, selectReprompt user when connecting.

    5 In the List Tables and Fields by area, selectBoth.

    6 ClickOK.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    34/51

    Configuration options

    30 Crystal EnterpriseSAP Edition Users Guide

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    35/51

    Crystal EnterpriseSAP Edition Users Guide 31

    Designing and Translating Reports 4

    This chapter introduces you to the Report Experts inCrystal Reports and provides some reporting details thatare relevant within SAP environments. In addition, thechapter shows how to prepare reports for translation, andhow to conditionally modify the reports design based onthe users logon language.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    36/51

    Designing and formatting Crystal reports

    32 Crystal EnterpriseSAP Edition Users Guide

    Designing and formatting Crystal reportsOnce you open a report in the Design tab of Crystal Reports, you can proceed withdesigning and formatting your report. In general, the report-design processconsists of these main tasks:

    Selecting the information that you want to display in the report.

    Grouping related data and sorting the records in a useful way.

    Summarizing grouped data to calculate a particular sum, average, variance,standard deviation, and so on.

    Incorporating graphical representations of data, such as charts, maps, andcross-tabs.

    Formatting report elements with predefined styles or customized formatting rules.

    To accomplish these tasks, you can use a Report Expert to guide you through thecreation of a particular type of report, or you can use the diverse and powerfuldesign tools in Crystal Reports to customize your report. This chapter introduces

    the Standard Report Expert but focuses primarily on reporting activities that areparticular to Crystal ReportsSAP Edition:

    Modifying predefined Crystal reports

    Incorporating data from multiple data sources

    In an SAP environment that supports users in various languages, translation is also animportant aspectof report design. Crystal ReportsSAP Edition allows youto preparereports for translation, so you can design reports in one language and subsequentlytranslate them in SAP into any number of languages. Once you publish these reportsto Crystal Enterprise, each user is presented with reports in his or her usual logonlanguage. For details, seeDesigning reports for translation on page 36.

    If you are already familiar with Crystal Reports, or if you prefer not to use the ReportExpert, use the Field Explorer to begin adding query fields to your report, creatingformulas, and so on. To access the Field Explorer, click Field Object on the Insert menu.

    Tip: The Crystal Reports Online Helpprovides extensive conceptual and proceduralinformation, tutorials, and examples to help you use Crystal Reports to its fullestpotential. Access the help by pressing F1 anywhere within Crystal Reports.

    Using the Report Expert to build a report

    The ReportExpert consists of a series oftabsthat guideyouthrough thesteps involvedin building your Crystal report. On any of the tabs,you can click the following buttons

    to preview your report quickly, without returning all of the report data: Design Report

    Crystal Reports designs the layout of the report, generates the report usingplaceholders, and displays the report in the Design tab. Crystal Reports doesnot actually retrieve data from the database. To view the report with data, clickRefresh to activate the Preview tab.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    37/51

    4 Designing and Translating Reports

    Crystal EnterpriseSAP Edition Users Guide 33

    Preview Sample

    Crystal Reports designs the layout of the report in the Design tab. The PreviewSample dialog box opens, enabling you to choose how many database recordsyou want to display on your report. Crystal Reports then retrieves the limitedrecord set from the database.

    CrystalReports retrieves all of the reportsdata when you click Finish in the ReportExpert, or when you refresh a previewed report.

    To start the Report Expert

    1 On theReportmenu, clickReport Expert.

    2 When you are prompted to confirm the command, clickYes.

    The Create Report Expert displays its Data tab:

    If you have already selected a BW query for the report, it appearsautomatically in the Tables available for report area.

    If you havent yet selected a data source, click Database to start the DataExplorer. (The BW Query driver and the InfoSet driver appear in the MoreData Sources folder.)

    3 ClickNext to proceed through the Experts remaining tabs.

    For a complete tutorial that guides you through the creation of a report with theReport Expert, see Building your first report off the SAP DemoCube on page 15.

    Modifying predefined Crystal reportsA number of predefined Crystal reports may have been supplied with BW and/or

    Crystal EnterpriseSAP Edition. These predefined reports are marked internally,so Crystal Enterprise can recognize them as valid SAP content.

    When you first open a predefined report in Crystal Reports, a number of standardprogram features are disabled, thereby restricting the ways in which you canmodify the report. For instance, you cannot edit the record selection formula tomodify the data retrieved by the report, nor can you change the grouping orsorting of the reports records. You can, however, insert, modify, and format staticobjects, which include text objects, pictures, OLE objects, lines, and boxes. Inaddition, you can set the location of the reports data source, so it reports off thedata in your own SAP system. (You cannot, however, convert the database driver,or add a database to the report.)

    If you restrict yourself to the editing features that are immediately available to youwhen you open a predefined report, then the reports internal marker remainsintact when you save your changes. Consequently, you can customize theformatting and presentation of these predefined reports and retain the ability topublish them back to Crystal Enterprise.

    If you need to make additional modifications to the predefined reports, you canenable all Crystal Reports features by clicking SAP Mode on the SAP menu. (This

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    38/51

    Modifying predefined Crystal reports

    34 Crystal EnterpriseSAP Edition Users Guide

    command is available only when you open an SAP report in Crystal ReportsSAPEdition.) This command, however, removes the reports internal marker, and CrystalEnterprise can no longer recognize the report as valid SAP content. As a result, youmust be running Crystal EnterpriseEnhanced SAP Edition before you can publishthe newly modified Crystal report back to your production Crystal Enterprise system.

    Note: Consult with your administrator if you are unsure of the Crystal Enterpriselicensing model that has been implemented with your BW system.

    To modify a predefined report

    1 Open the report in Crystal Reports.

    Tip:If the report is already saved in BW, click the Open report from BWbutton on the toolbar. Log on to BW and browse your roles for the report youwant to open.

    2 Click the programs menus (Edit, View, Insert, and so on) to see the featuresthat are immediately available to you. Or, right-click the reports static objects(text objects, pictures, OLE objects, lines, and boxes) to view a shortcut menuof related commands.

    If you restrict yourself to these editing features, the reports internal markerremains intact. For a full description of any particular command, press F1 toaccess theCrystal Reports Online Help.

    3 To remove the reports internal marker and enable full product functionality,clickSAP Modeon theSAPmenu.

    Note:If the SAP Mode command is unavailable, then the report you haveopened is a regular Crystal report (or a predefined report whose internalmarker has already been removed).

    A confirmation dialog box appears (unless youve already selected the Dontshow again option).

    4 ClickOK.

    All of the programs features are now available to you, and you can modify all

    aspects of the report.5 When you have finished editing the report, save it to BW and publish it to

    Crystal Enterprise. For details, seeSaving reports to BW on page 13.

    Note:If you are unable to publish the modified report to Crystal Enterprise, youmay need to consult with your administrator about upgrading to CrystalEnterpriseEnhanced SAP Edition.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    39/51

    4 Designing and Translating Reports

    Crystal EnterpriseSAP Edition Users Guide 35

    Incorporating data from multiple data sourcesReports based on queries and InfoSets behave similarly to reports based on storedprocedures in mainstream databases. You can include only one data source perprimary report; however, you can insert subreports based on different datasources into the primary report.

    A subreport is a report within a report. With subreports, you can coordinate datathat otherwise cannot be linked and present different views of the same data in asingle report. As such, subreports enable you to incorporate data from multiplequeries and InfoSets.

    To report off two different SAP data sources

    1 Using Crystal ReportsSAP Edition, create two different reports, and baseeach report on a different BW query.

    For procedural details on creating reports based on a BW query, seeSelecting

    existing queries for reports on page 11.

    2 Save both reports on your local drive.

    3 Open the report that you want to use as the primary report, and ensure thatyou are on the Design tab.

    4 On theInsert menu, clickSubreport.

    The Insert Subreport dialog box appears.

    5 ClickChoose a report.

    The Create a subreport option allows you to create a new subreport thatretrievesdata from anydata sourcethat is accessible through the Data Explorer.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    40/51

    Designing reports for translation

    36 Crystal EnterpriseSAP Edition Users Guide

    Because you have already created two reports with the SAP Tools toolbar, youdont need to create a new subreport now.

    6 In theReport File namefield, type the path to the second report (.rpt file) thatyou created, or clickBrowseto locate the report on your local drive.

    7 ChooseOn-demand subreportto have the ability to retrieve the data on thesubreport when needed. Otherwise, all the subreport data will appear with thereport.

    An on-demand subreport appears as a hyperlink in the primary report. Whenyou open the primary report, no data is retrieved from the on-demandsubreport until you drill down on the hyperlink.

    8 ClickOK.

    The program displays an object frame.

    9 Move the frame where you want the subreport to appear in the report, andclick once to place it.

    The program creates a Subreport Design tab, which is labeled with thesubreport name. To edit the subreport, click the Design tab and make yourmodifications.

    10Click thePreviewtab to view the primary report with the inserted subreport.

    For complete details about subreports, see the Crystal Reports Online Help.

    Designing reports for translationIf your BW system supports users in multiple languages, you may want to prepareyour reports for translation within BW. Once you publish the translated reports to

    Crystal Enterprise, SAP users can view reports that correspond to their logonlanguage. This section describes how to prepare your report for translation, andhow to use a reports LanguageCode% formula to make language-specificmodifications to reports.

    Preparing reports for translation

    When you save a report to BW, you are given the option to prepare the report fortranslation. When you select this option, Crystal Reports extracts the stringcontents from all the text objects that you have inserted into the report (andreplaces the original strings with placeholders in the .rpt file). Crystal Reports then

    passes the original strings to a BW function (RSCR_SAVE_DOCUMENTATION) that isresponsible for inserting the strings into a language table in BW.

    Use the standard translation transactions within BW to access the language tablethat contains the original strings, and to translate them into all the languages thatyou require. Once you finish this process, the translated strings can be insertedback into the report when you publish to Crystal Enterprise.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    41/51

    4 Designing and Translating Reports

    Crystal EnterpriseSAP Edition Users Guide 37

    When you publish a translated report from BW to Crystal Enterprise, the BWReport Publisher receives a single .rpt file, the original report strings, a list ofdestination languages, and all the translated report strings from BW. For eachlanguage, the BW Report Publisher copies the original .rpt file and replaces theplaceholders with the corresponding report strings. In addition, the BW ReportPublisher marks each report with a language code (for details, see Conditionalformatting with the LanguageCode% formula on page 38). The BW ReportPublisher thus generates multiple .rpt files (one for each language), and finallypublishes each of these objects to Crystal Enterprise.

    Tip: When users refresh or schedule translated reports, new data is retrieved fromBW, but the report strings are not refreshed. To update the translations of yourreport strings, publish the reports again from BW to Crystal Enterprise.

    Note:Your SAP administrator is responsible for the translation of the actual SAPdata that is available to the report. For instance, fields containing string values(such as a Product Description field) are typically translated within SAP. When a

    user refreshes a Crystal report that displays those string values, the SAP systemautomatically returns data that corresponds to the users logon language.

    To prepare all reports for translation

    1 On theSAPmenu, clickSettings.

    Tip:You can also click the corresponding button on the toolbar.

    The Settings dialog box appears.

    2 Ensure thatPrepare reports for translation on serveris selected.

    This option changes your default settings, so reports are always prepared for

    translation on the server.If you prefer to select this option for individual reports, clear the Suppresssave dialog option. You are then prompted with a Prepare this report fortranslation option every time you save a report to BW.

    3 ClickOK.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    42/51

    Designing reports for translation

    38 Crystal EnterpriseSAP Edition Users Guide

    4 On theSAP menu, clickSave Reportand proceed as usual. For details, seeSaving reports to BW on page 13.

    Conditional formatting with the LanguageCode% formula

    When you initially create a report based on a BW query, Crystal Reportsautomatically generates a formula named LanguageCode%. You can find thisformula in the Field Explorer. Rather than performing a calculation, this formulaconsists of a string valuea single letterthat serves to associate the report witha particular logon language.

    When you first create and design your report, the formula contains the code foryour current logon language (E for English, D for German, and so on). This isthe reports master language. When you prepare reports for translation andsubsequently publish them to Crystal Enterprise, the BW Report Publishermodifies the LanguageCode% formula in each translated report. When an SAPuser views a Crystal report or logs on to SAP ePortfolio, a Crystal ServerPage (CSPfile) filters the available reports: if a translated report is available in the users logonlanguage, it is displayed for the user; if a translated report is unavailable, the reportappears in its master language.

    The LanguageCode% formula is intended to provide you, the report designer,with a tool for conditionally formatting reports in ways that accommodate forusers with different logon languages. For example, suppose that your reportdisplays values from a Product Category field, whose string values are translatedwithin SAP. As a report designer, your problem is that the German strings arelonger than the equivalent English strings.

    To solve this problem, you could use the LanguageCode% to conditionally reduce

    the font size forthe translated version of the report (as demonstrated in the followingsteps). Alternatively, you could insert two Details sectionseach containing thesame database fieldsand increase the width of the fields in the second section toaccommodate for the longer German strings. Your conditional formatting formulawould then show/hide the Details sections according to the reports language.

    Note:For complete instruction on conditionally formatting fields and using theFormat Formula Editor, see theCrystal Reports Online Help.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    43/51

    4 Designing and Translating Reports

    Crystal EnterpriseSAP Edition Users Guide 39

    To reduce a fields font size conditionally

    1 Open the report in theDesigntab of Crystal Reports.

    2 In the Details section of the report, right-click the field whose font you want toconditionally format.

    3 On the shortcut menu, clickFont.

    The Format Editor dialog box appears with the Font tab open.

    4 Click theFormulabutton that corresponds to the Size field.

    The Format Formula Editor opens a new formula and names it Font_Size.

    5 In the text area, type this formula (which uses Crystal Syntax):

    if {@LanguageCode%} = "D"

    then 10

    else 12

    This formula ensures that the currently selected fields font size is reduced from12 pts to 10 pts when the users logon language is German (or when the userschedules a German instance of the report).

    6 ClickSave and close.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    44/51

    Designing reports for translation

    40 Crystal EnterpriseSAP Edition Users Guide

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    45/51

    Crystal EnterpriseSAP Edition Users Guide 41

    Publishing and Viewing Reports 5

    This chapter describes how to publish Crystal reports toCrystal Enterprise and subsequently view those reportsfrom various applications including SAP ePortfolio.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    46/51

    Publishing predefined reports to Crystal Enterprise

    42 Crystal EnterpriseSAP Edition Users Guide

    Publishing predefined reports to Crystal EnterpriseA number of predefined Crystal reports may have been supplied with BW and/orCrystal EnterpriseSAP Edition. These predefined reports are marked internally,so Crystal Enterprise can recognize them as valid SAP content.

    You can publish valid Crystal report files to Crystal Enterprise in several ways:

    When you open a report in Crystal Reports, you can simultaneously save it toBW and publish it to Crystal Enterprise. For details, seeSaving reports toBW on page 13.

    If you have already added a number of reports to BW, you can publish them inbatches to Crystal Enterprise. For details, seeBatch publishing reports fromBW on page 42.

    For information about predefined reports and the ways in which you can modifythem, seeModifying predefined Crystal reports on page 33.

    Tip:Upgrading to Crystal EnterpriseEnhanced SAP Edition allows you topublish your own, customized reports to Crystal Enterprise.

    Batch publishing reports from BW

    To publish large numbers of Crystal reports from within BW, you can execute theprogram RSCR_ADMIN_REPORTS. In addition to having permission to execute thisprogram within BW, youmust alsohave publishing rights in Crystal Enterprise. Thesepublishing rights are described in theCrystal EnterpriseSAP Edition InstallationGuide(installguide.pdf), located in the sapdocs directory of the product CDs.

    For details on using the RSCR_ADMIN_REPORTS program in BW, see the SAP Library >

    Business Information Warehouse > System Administration Tasks >Administrating Crystal Reports.

    Note:In each of the reports that you publish in this manner, the BW ReportPublisher updates the database information in accordance with your installationparameters. This ensures that the reports are set to use the correct data source. Fordetails, see the Crystal EnterpriseSAP Edition Installation Guide(installguide.pdf),located in the sapdocs directory of the product CDs.

    Viewing reportsYou can view Crystal reports from a number of applications depending upon how

    Crystal Enterprise has been integrated with your BW system. For instance, you canlaunch reports in a web browser from within the SAP Easy Access interface, or youcan log on to the SAP ePortfolio web desktop with your usual SAP credentials.

    Tip:You can also save reports as iViews and include them in your SAP PortalsEnterprise Portal. For details, seeSaving reports to BW on page 13.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    47/51

    5 Publishing and Viewing Reports

    Crystal EnterpriseSAP Edition Users Guide 43

    To view a published report through SAP Easy Access

    1 Log on to SAP Easy Access.

    2 Browse your roles to locate the reports that have been saved to BW.

    Tip:Look for the Crystal report icon that is used in BW.

    3 Double-click the report.

    The report is displayed in your web browser. You may be prompted to log on tothe SAP Web Application Server and/or Crystal Enterprise. If so, provide yourusual SAP user name and password.

    To view a published report through SAP ePortfolio

    1 Go to the SAP ePortfolio main page:

    http://webserver/crystal/enterprise/sapbw/eportfolio/

    Replace webserverwith the name of the web server that is set up for Crystal

    Enterprise. You may need to check with your administrator for the web servername or exact URL to enter.

    The Log On page appears.

    Tip:If you are logged on automatically with the default Guest account, clickLog On in the top-right section of the title bar.

    2 In theSAP SystemIDfield, type the three-character System ID (SID) for yourSAP system.

    Contact your administrator if you are unsure of the appropriate SID.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    48/51

    Viewing reports

    44 Crystal EnterpriseSAP Edition Users Guide

    3 In theSAP Client field, type your usual three-digit SAP client number.

    4 Type your usual SAP logon credentials in the User Name andPassword fields.

    5 In theAuthenticationlist, ensure thatSAP Authenticationis selected.

    6 In theLanguage field, type your usual SAP language code.If reports are available on your system in multiple languages, their titles anddescriptions are displayed in the language that you specify here. In addition,on-demand reports will display headings, titles, and other information in theappropriate language, so long as the report was designed to accommodate formultiple languages.

    7 ClickLog On.

    The home page appears and you are logged on with your own account.

    8 Click theMy Rolesbutton on the title bar for quick access to all of the Crystalreporting content that has been saved in your various SAP roles and publishedto Crystal Enterprise.

    Tip: For more information about using SAP ePortfolio, click Help to access theSAP ePortfolio Users Guide.

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    49/51

    Crystal EnterpriseSAP Edition Users Guide 45

    Index

    AABAP queries............................................................ 24

    and parameters ..................................................27and subreports ................................................... 26prefixes in names ............................................... 28selecting for reports.. .......................................... 26

    Allow Reporting On dialog box ................................ 27configuration options ......................................... 29

    areas, global and local.............................................. 28audience, intended .....................................................2Automatically publish to Crystal Enterprise................. 8

    Bbatch publishing ....................................................... 42Business Explorer (BEx) Query Designer .....................6BW queries................................................................. 6

    connection settings ..............................................6creating for reports ............................................... 9default report title............................................... 13selecting for reports.. .......................................... 11

    BW Query driver ........................................................6connection settings ..............................................6

    Ccommands, in Crystal Reports.....................................6conditional formatting .............................................. 38configuration options............................................ 6, 29connecting

    with the BW Query driver .................................. 11with the InfoSet driver ........................................ 24

    connection settings..................................................... 6consulting................................................................... 3conventions, used in this guide................................... 4Create New Report from a Query command............... 6creating

    queries ................................................................. 9reports to use as templates ................................. 14

    Crystal Enterprise........................................................2publishing reports to .......................................... 42viewing reports through ..................................... 42

    Crystal Reports............................................................2

    DData Explorer ........................................................... 11data sources

    ABAP queries..................................................... 26BW queries.......................................................... 6creating queries ................................................... 9InfoSets.............................................................. 26reporting off multiple......................................... 35selecting

    ABAP queries................................................ 26BW queries ................................................... 11

    InfoSets ......................................................... 26data, from multiple sources ...................................... 35databases, logical..................................................... 26default templates...................................................... 14designing reports...................................................... 32Disconnect command ................................................ 7Display database field by, configuration options ...... 29document conventions............................................... 4drivers

    BW Query ........................................................... 6combined InfoSet/ABAP Query driver................ 26InfoSet ............................................................... 24

    Ffield descriptions........................................................ 8formatted reporting..................................................... 6formatting

    reports ............................................................... 32translated reports ............................................... 38with the LanguageCode% formula..................... 38

    formulas, LanguageCode%....................................... 38Functional Area driver, see InfoSet driver

    Gglobal area ............................................................... 28

    H

    help, technical support............................................... 3

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    50/51

    46 Crystal EnterpriseSAP Edition Users Guide

    IInfoSet driver ............................................................26

    connecting to SAP ..............................................24selecting data sources.........................................27

    InfoSets .....................................................................24

    and parameters...................................................27and subreports....................................................26prefixes...............................................................28selecting for reports ............................................27

    inserting, subreports..................................................35installation ..................................................................2iViews, saving reports as...........................................13

    LLanguageCode% formula..........................................38languages

    translated reports ................................................36viewing reports in...............................................42

    List tables and fields by, configuration options ..........29

    local area..................................................................28logical databases.......................................................26

    Mmodifying predefined reports ....................................33

    Nnaming, report titles..................................................13

    OOpen Report command ..............................................6options, configuring Crystal Reports......................6, 29

    Pparametersand ABAP queries...............................................27and InfoSets........................................................27

    predefined reportsmodifying ...........................................................33publishing ..........................................................42

    Prepare reports for translation on server ......................7Prepare this report for translation ..............................13preparing reports for translation ................................36Prompt on every table, configuration options............29publishing.................................................................42

    in batches...........................................................42

    Qqueries

    creating ................................................................9in SAP BW............................................................6selecting for reports ......................................11, 26

    RReport Experts...........................................................32

    tutorial ............................................................... 15report templates........................................................ 14reporting..................................................................... 6

    off ABAP queries and InfoSets ............................ 26off BW queries ..................................................... 6reports ...................................................................... 32

    designing and formatting ....................................32multiple data sources ......................................... 35predefined.......................................................... 33publishing .......................................................... 42saving to BW......................................................13selecting queries for ...........................................11selecting the InfoSet driver .................................24titles ................................................................... 13translating .......................................................... 36tutorial on creating ............................................. 15viewing .............................................................. 42

    Reprompt user when connectingconfiguration options ...........................................29RSCR_ADMIN_REPORTS ......................................... 42

    SSAP BW...................................................................... 6

    connection settings ..............................................6publishing reports from ......................................42saving reports to .................................................13

    SAP DemoCube, reporting off................................... 15SAP Easy Access ....................................................... 42SAP ePortfolio........................................................... 42SAP mode................................................................. 33SAP mode command .................................................. 7

    SAP Tools toolbar .......................................................6Save Report As command ........................................... 6Save Report command ................................................6saving reports to BW.................................................13selecting

    ABAP queries .....................................................27BW queries ........................................................ 11InfoSets .............................................................. 27reports as templates............................................ 14

    Settings command ...................................................... 7settings, for connecting to BW .................................... 6Standard Report Expert, tutorial ................................ 15Start BW Query Designer command ........................... 7subreports ........................................................... 26, 35

    supporttechnical .............................................................. 3web site ...............................................................3

    Suppress save dialog ...................................................8

  • 7/25/2019 Crystal Enterprise SAP Edition - Users' guide.pdf

    51/51

    Ttechnical field names ................................................. 8technical support........................................................ 3templates.................................................................. 14titles, of reports......................................................... 13

    toolbar ....................................................................... 6training....................................................................... 3translated reports...................................................... 36

    formatting .......................................................... 38preparing ........................................................... 36viewing. ............................................................. 42

    troubleshooting, configuration options ................. 6,29tutorial ..................................................................... 15

    Vviewing reports......................................................... 42

    Wweb sites

    consulting ............................................................ 3training ................................................................ 3