Designing the Procedure Logic › Build Procedures › Build Designer-Added Procedures

Build Designer-Added Procedures

Designer-added procedures are implementation-specific procedures that improve or simplify some characteristic of the overall implementation.

Designer-added procedures should not alter the results of analysis. To avoid compromising the results of analysis, designer-added procedures should never modify business information.

Note: Do not use the entity actions CREATE, UPDATE, or DELETE, except for design entity types.

Such a requirement identified during Design generally points out a deficiency in analysis that should be corrected by adding or modifying a process.

There is another class of designer-added procedure that is less frequently used. This class of designer-added procedure is responsible for displaying and maintaining design entity types. Imagine that you should determine the failure rate of each user who adds customers using the Maintain Customer procedure step. This involves:

• Adding a design entity type that has attributes of Terminal ID (to identify the user), number of executions of Add Customer, and number of failures of Add Customer
• Modifying the Maintain Customer action diagram to add to the number of executions each time Add Customer is invoked and to add to the number of failures each time it fails

The mechanism for displaying this information on a terminal is a designer-added procedure. The following illustration is a designer-added procedure that supports this example.

Procedure Action Diagram for Designer-Added Procedure

DISPLAY_FAILURE_RATE

     IMPORTS:        Entity View inbound add_customer_failure
Procedure Step:      DISPLAY FAILURE RATE
     EXPORTS:        Work View outbound Composer_supplied
                     Entity View outbound add_customer_failure
     ENTITY ACTIONS: Entity View add_customer_failure

EXIT STATE IS requested_operation_complete
     READ add_customer_failure
          WHERE DESIRED add_customer_failure terminal_id
          IS EQUAL TO inbound add_customer_failure_terminal_id
     WHEN successful
     MOVE add_customer_failure TO outbound_add_customer_failure
     SET outbound_Composer_supplied percentage TO (add_customer_failure
          number_of_failure/add_customer_failure
          number_of_attempts - add_customer_failure
          number of attempts) 100
     SET outbound Composer_supplied total_integer TO add_customer_failure
          number_of_attempts - add_customer_failure                      
          number_of_failures
WHEN not found
EXIT STATE IS terminal_id_not_found

This example references two views of the work attribute set supplied by CA Gen.

Percentage is used to show the percentage of failures to attempts. Total Integer shows the user's total number of successes, calculated as the number of attempts less the number of failures.

More information:

Preparing for Design