Prerequisites — Crystal Report Runtimes
The Run Crystal ReportThe Run Crystal Report tool automates the execution of SAP® Crystal Reports®. Recordsets and variables from other task steps can be consumed to dynamically populate the report at runtime. In addition, where the report requires access to a database, security credentials can be passed from in the Run Crystal Report step. tool does not require any global configuration. However, the following must be met before you can use the tool in a task:
|||Crystal Reports Runtime version 13.0.26 must be installed — use the ConfiguratorYou use the Configurator to install third-party software that may be required by available tools. Connection to required agents are also configured here. Note that you can only launch the Configurator if logged into the machine with Administrator rights. to download and install|
Note: BPA Platform must be licensed for Crystal Reports to be able to download the runtimes — refer to your account manager or business partner if you're unsure about your licensed features.
|||Reports created in Crystal Reports version 10, 11, 12, 2008, 2011, 2013, or 2016 are accepted|
- Launch the Configurator and navigate to the Tool Specific > Run Crystal Report > Prerequisites node.
- If Crystal Reports Runtime Detection has not found an installation of Crystal Reports, a is displayed. Click Install to download and install the runtimes.
- When complete, you can close the Configurator.
Adding a New Task Step
To add a new Run Crystal Report step to an existing task,
- Open the relevant task (if creating a new task, see How to Create a Basic Task).
|||Click and drag the Run Crystal Report icon from the Task Browser to the task Design area.|
|||From the task's Design tab, right-click on empty space and select New > Format > Run Crystal Report.|
- In the General tab, Name your task step and choose a data source.How Do I Do This?
The General tab is used to enter the following details for the step:
Name — Enter a meaningful name for the step
Tip: If this task instance makes use of two or more Run Crystal Report steps, ensure the Name used is unique for each individual step.
Description — If required, enter a description of this step Use a Recordset — Enable this parameter if recordset data from a previous task step is required to map to report parameters Input Recordset — Contains all available recordsets from steps previously created in the task
For more information, go to the main General tab topic.
- Go to the Report tab and select and configure the Crystal Report template for this task step.
How Do I Do This?
Click the image to view full size.
Click Import to import an existing Crystal Report template. The report properties — Title, Author, and so on — are displayed after a successful import. To make any changes to the report template, click Edit Report — the Crystal Reports Designer is launched. Note that any changes made in the Designer means that you must re-import the saved template. Use Export to create another copy of the imported report template.
When building Crystal Report templates, you can add placeholders (report parameters) for where BPA Platform data should appear. If your template makes use of such report parameters, you must map the relevant BPA Platform task data to it. From the Mapped Report Parameters panel, click Add.
Report Parameter displays those placeholders in the report template.
Choose the Mapping Type:
Discrete value maps what is specified in Value 1. If required, drag-and-drop recordset data, variables, or step properties to create a dynamic mapping based on task run-time data. Range maps the range between what is specified in Value 1 and Value 2. If required, drag-and-drop recordset data, variables, or step properties to create a dynamic mapping based on task run-time data.
The Run Crystal Report step cannot use the database connection from previous task steps to populate report fields. Instead, it relies on a its own isolated database connection, referenced in the Crystal Reports Designer. If this connection requires authentication, you must enter the security credentials here. All database connection in this report template are shown in the Database Tables Logon Information (Automated Running) panel. Highlight each connection in turn and click Edit to enter the relevant security credentials.
Should the report template have embedded sub-reports these are displayed in their own Report tab. You must complete the configuration for each sub-report (as above).
For more information, go to the main Report tab topic.
Go to the Options tab and select the relevant error handling options for this task step.How Do I Do This?
The Options tab allows you to define how errors in this step are handled at task runtime.
If the step is aborted, you can choose to Continue processing onto the next step in the task, or terminate the whole task immediately (Abort Task).
If the Run Crystal Report tool detects Crystal Reports Developer Edition 2008 or later installed locally, you can choose whether to Create bookmarks from group tree for PDF output. With this option enabled, the PDF file available in the PDFData task browser property creates bookmarks for each report template's group header.
For more information, go to the main Options tab topic.
Click to save the task step.