Page Comparison

...

• A grid widget (App) that displays the data needed for the input parameters must be created in Studio.
• The grid widget and the column need to be specified for the input parameter during the report configuration in Sigma Studio.

For example, the following Sigma Application screen shot shows the drop-down values for the Currency input parameter in a report:


Let's see how to configure drop-downs for stored procedure input parameters in reports.

To fetch the grid widget data for the stored procedure input parameters in reports, perform the following steps in Sigma Studio:

1. On the home page of Sigma Studio, click the Data Source  icon on an existing database connection.

   Note
   It is necessary that you create separate data sources for the grid widget and the report. In the given example here, the data source for the grid widget is a DB table data source (SP DS), whereas the data source for the report is a DB stored procedure (SP DS 6).

   
   

2. Create the DB table data source for the grid widget. For example, SP DS.
   
   
3. Create the DB stored procedure data source for the report. For example, SP DS 6.
   
   
4. Access App Designer and create a grid widget with the DB table data source (SP DS).
   
   1. Click Proceed to configure the grid widget.
      
      
      
5. Drag and drop the required data columns to the design area and click the Save () icon to save the widget (e.g. ACCOUNTS).
   
   
6. Create a report with the DB stored procedure data source (SP DS 6) and provide the necessary configuration details as per your needs and requirements.
   
   

7. Click the Parameters Configuration () icon to configure the applied procedure parameters for the report.
   
   
   In the Params Configuration screen, the applied procedure parameters of ACCOUNT_NO, AVAI_BALANCE, FD, TD and CURRENCY appear.

   Note

   In this example, the DB stored procedure data source has following five input parameters: ACCOUNT_NO (Account Number) AVAI_BALANCE (Available Balance) FD (From Date) TD (To Date) CURRENCY (Currency) Among these five parameters, the values for the ACCOUNT_NO, AVAI_BALANCE, and CURRENCY parameters must be fetched from the grid widget , (ACCOUNTS), whereas the FD and TD parameters should must be provided with the custom date values in accordance with the data sets. The parameters can be made mandatory by making use of using the Is Mandatory option and the Equals filter criteria is applied as the Mandatory Filter Operator for the listed procedure parameters. However, both the Is Mandatory and Mandatory Filter Operator are optional fields.

   
   

8. Click the ACCOUNT_NO parameter and select the appropriate grid widget (e.g. ACCOUNTS) from the Load data from Widget lookup field and choose the appropriate key and description columns from the Key Column and Description Column lookup fields. Proceed to click Update to update the parameter configurations.
   
   
   

   1. Click the AVAI_BALANCE parameter and select the appropriate grid widget (e.g. ACCOUNTS) from the Load data from Widget lookup field and choose the appropriate key and description columns from the Key Column and Description Column lookup fields. Proceed to click Update to update the parameter configurations.
      
      

   2. Click the FD (From Date) parameter and select Custom from the Source drop-down list to provide the relevant date of your choice. In the Parameter Value field, select the relevant date, e.g. 02/02/2022. Proceed to click Update to update the parameter configurations.
      

      Note

      You can configure the minimum and maximum ranges for date columns in the Min Value Expression and Max Value Expression fields respectively. For example, let’s assume the current date is 01 July 2022. For allowing dates within a month period as minimum and maximum, the Min Value Expression and Max Value Expression fields can be set as -1m and +1m respectively. In this case, end-users of Sigma Application can specify the minimum date as 01 June 2022 and the maximum date as 31 July 2022. Both the Min Value Expression and Max Value Expression fields are optional.

      
      

      Note

      On using a couple of date parameters in a stored procedure When a stored procedure with date input parameters is used as a datasource for a report, the Dependency Field, Validation and Dependency Range fields appear, which . These fields can be used to assign the dependencies and validations for the date parameters. In the provided given example, the TD ( The 'To Date ) ' parameter is selected as a dependent parameter dependent on the 'From Date', so for the FD (From Date) parameter, the TD (To Date) parameter is selected as a dependent from the Dependency Field drop-down list. Only the date parameters will get listed in the Dependency drop-down list. The Less Than The 'From Date' must be less than the 'To Date' in all cases, so the Less than condition is selected from the Validation Condition drop-down list , indicating that the FD parameter should always be lesser than the TD parameter value and in all cases, the TD parameter value must be greater than the FD parameter value. The .  The Dependency Range is an optional field. If required, you can assign the dependency date range for the FD (From Date) parameter so as to select the enforce date only selection within the specified date range. For instance, if the current date, fetched from the app or widget (DETAILS_APP) is 01 July 2022 (01/07/2022) and if the Dependency Range is set as 1m, then the FD  parameter cannot be selected beyond the period of one month  (From Date) parameter must be within one month range, which is 31 July 2022 . So, on making use of the Dependency Range field, the selected date cannot exceed the specified date range period .

      
      
      

   3. Click the TD (To Date) parameter and select Custom from the Source drop-down list to provide the relevant date of your choice. In the Parameter Value field, select the relevant date, e.g. 04/02/2022. Proceed to click Update to update the parameter configurations.
      
      

      Note

      On using a couple of date parameters in a stored procedure When a stored procedure with date input parameters is used as a datasource for a report, the Dependency Field, Validation and Dependency Range fields appear, which . These fields can be used to assign the dependencies and validations for the date parameters. In the provided given example, the FD ( The 'From Date ) ' parameter is selected as a dependent parameter dependent on the 'To Date', so for the TD (To Date) parameter, the FD (From Date) parameter is selected as a dependent from the Dependency Field drop-down list. Only the date parameters will get listed in the Dependency drop-down list. The Greater Than The 'To Date' must be greater than the 'From Date' in all cases, so the Greater than condition is selected from the Validation Condition drop-down list , indicating that the TD parameter should always be greater than the FD parameter value and in all cases, the FD parameter value cannot be greater than the TD parameter value. If .  The Dependency Range is an optional field. If required, you can assign the dependency date range for the TD (To Date) parameter so as to select the enforce date only selection within the specified date range. For instance, if the current date, fetched from the app or widget (DETAILS_APP) is 01 July 2022 (01/07/2022) and if the Dependency Range is set as 1m, then the TD  parameter cannot be selected beyond the period of one month  (To Date) parameter must be within one month range, which is 31 July 2022. So, on making use of the Dependency Range field, the selected date cannot exceed the specified date range period.

      
      

   4. Click the CURRENCY parameter and select the appropriate grid widget (e.g. ACCOUNTS) from the Load data from Widget lookup field and choose the appropriate key and description columns from the Key Column and Description Column lookup fields. Proceed to click Update to update the parameter configurations.
      
      
      

   5. Click the Save () icon to save the configured procedure parameters.
      
      

      

      
      
      

      Info
      If suppose any of the input parameter is an Integer datatype and you want to specify a minimum and maximum range for the parameter value, you can achieve by specifying the range of values as shown in the following screen shot: Image Added

      
      
      Once you apply the procedure parameter configurations, a toast message appears, indicating a successful save of the applied procedure parameter configurations.
      
      

      
      

9. Click Save to save the report.Image Removed
   Access the relevant report (e.g. REPORT) in the Sigma Application.
   Image Removed
   The FD and TD parameters display the custom date values, which can even be changed by the end-user, whereas the other three parameters display drop-downs from which the end-user can select the values.
   Image Removed
   For the Account No procedure parameter, click the parameter value drop-down list and select an account number, e.g. 5500000848.
   Image Removed
   For the Balance procedure parameter, click the parameter value drop-down list and select the balance amount, e.g. 15476.00.
   Image Removed
   For the Currency procedure parameter, click the parameter value drop-down list and select a currency value, e.g. INR.
   Image Removed
   After you provide the relevant parameter values for the applied procedure parameters, you can proceed to click Run to generate the report.
   Image Removed
   Access the Generated Reports tab and then download the generated report.
   Image Removed
   The fetched data of the report, with the relevant data values provided to the applied procedure parameters, is displayed in the PDF file, as shown in the following screen shot:
   Image Removed

Refer the following page:

• Generating Reports with Mandatory Input Parameters