Using Stored Procedure

A stored procedure is a set of precompiled and preoptimized SQL statements that performs some database operation. Stored procedures reside where the database resides, and you can access them as needed.

Defining data using a stored procedure

You can specify a stored procedure as the data source for a report if your DBMS supports stored procedures.

For information on support for stored procedures, see your database documentation.

NoteIf the Stored Procedure icon is not displayed The icon for the Stored Procedure data source displays in the Choose Data Source dialog box in the report wizards only if the database to which you are connected supports stored procedures.

StepsTo define the data using Stored Procedure:

  1. Select Stored Procedure in the Choose Data Source dialog box in the wizard and click Next.

    The Select Stored Procedure dialog box displays a list of the stored procedures in the current database.

  2. Select a stored procedure from the list.

    To list system procedures, select the System Procedure check box.

    The syntax of the selected stored procedure displays below the list of stored procedures.

  3. Specify how you want the result set description built:

    • To build the result set description automatically, clear the Manual Result Set check box and click Next.

      InfoMaker executes the stored procedure and builds the result set description for you.

    • To define the result set description manually, select the Manual Result Set check box and click Next.

      In the Define Stored Procedure Result Set dialog box:

      • Enter the name and type of the first column in the result set.

      • To add additional columns, click Add.

  4. Continue in the Report wizard as needed for the presentation style you are using.

    When you have finished interacting with the wizard, you go to the Report painter with the columns specified in the result set placed in the report.

    For information about defining retrieval arguments for reports, see Chapter 6, “Enhancing Reports.”

Editing a result set description

After you create a result set that uses a stored procedure, you can edit the result set description from the Report painter.

StepsTo edit the result set description:

  1. Select Design>Data Source from the menu bar.

    This displays the Column Specification view if it is not already displayed.

  2. Select Stored Procedure from the Column Specification view’s pop-up menu.

    The Modify Stored Procedure dialog box displays.

  3. Edit the Execute statement, select another stored procedure, or add arguments.

    The syntax is:

    execute sp_procname;num arg1 = :arg1, arg2 = :arg2..., argn =:argn
    

    where sp_procname is the name of the stored procedure, num is the stored procedure group suffix, and arg1, arg2, and argn are the stored procedure’s arguments.

    The group suffix is an optional integer used in some DBMSs to group procedures of the same name so that they can be dropped together with a single DROP PROCEDURE statement. For other DBMSs the number is ignored.

  4. When you have defined the entire result set, click OK.

    You return to the Report painter with the columns specified in the result set placed in the report.

    For information about defining retrieval arguments for reports, see Chapter 6, “Enhancing Reports.”