Creating a Pre- or Post-procedure


  1. Click New and select Procedure.

    Response: A Procedure Element tab is opened.

  2. In the Data Sources tree, click on the database procedure you wish to use.

  3. Click Select.

    Response: The database procedure is added to the tab. Information Designer analyzes the database procedure and makes a guess as to whether it is a pre-update procedure or a query procedure (it never sets post-procedure by default).

    id_procedures_1.png

  4. Select the Procedure type: Pre-update procedure or Post-update procedure.

    Comment: Pre-update procedures are always executed first in an information link. Post-update procedures are always executed last in an information link.

  5. If the database procedure requires any Input Parameters, their name and type are displayed.
    id_procedure_element_tab_input_parameters.png

  6. Select whether the input parameter should receive a Default Value by typing a value (of the appropriate type) in the input field. If not, leave the field blank.

    Comment: Type ?param_name to use a parameter as the default value, where param_name is the name to identify the parameter by. Note: If you use a parameter for the default value, you must choose Prompt: None. See Parameterized Information Links for more information.

  7. Select whether you want the end user to be prompted for a single value, multiple values, or not at all, from the Prompt drop-down list.

    Comment: If you select multiple values, the end user will be allowed to enter several values. The procedure will run once for each of these values in an iterative loop. For more information, see Multiple Value Procedure Prompts.

  8. If you want to allow the input parameter to be Null, select the Permit Null check box.

    Example 1: Type a Default value and set prompt to None. This means that the specified default value will always be used as input parameter.
    Example 2: Leave Default value empty, select Permit Null and Single value prompt. This will cause the end user to be prompted for a value. If the end user does not enter a value in the prompt, Null will be used.
    Example 3: Leave Default value empty, leave Permit Null empty and Single value prompt. This will cause the end user to be prompted for a value. If the end user does not enter a value in the prompt, an error message will appear since Null is not allowed.
    Comment: You cannot select the combination: No Default value, Not allow Permit Null and No Prompt, since this is a paradox.

  9. In the Description field, type your own description of the procedure.

  10. Click Save.

    Response: The Save As dialog is displayed.

  11. Click to select the folder where you wish to save the procedure element.

  12. Click Save.

    Response: The procedure is saved in the selected folder, and will be denoted with the id_procedure_i.png icon. Note that the procedure object will be visible to the end user in the list of information links. You can also make larger, more complex information links using the procedure when creating an information link in Information Designer.

See also:

Procedures Overview.