7 Task Management

This chapter explains how to configure BPL tasks.

This chapter contains the following topics.

Task Management Module

Business Process Logic

BPL Response Mapping

Response Mappings and Control Plans

Task Management Module

The Task Management screen lets you configure Business Process Logic tasks. BPL tasks can be used to execute tasks specified in control plans.

The Task Management screen contains these tabs:

• Business Process Logic, and

• BPL Response Mapping.

Configuring BPL tasks overview

CCS enables you to configure complex actions which can be triggered from the Edit Subscriber screen using the Business Process Logic (BPL) task buttons. A BPL task executes a set of pre-configured actions which are defined in an associated control plan.

To configure a BPL task, complete following steps:

1. Configure the background building blocks required to set up the BPL's control plan, for example:

   • Profile fields

   • Notifications

   • Named events

   • Balance types

2. Using the CPE, build the control plan the BPL task will run. Note, the control plan defines the BPL logic. Feature nodes which require interaction cannot be used in BPL task control plans.

   For more information about the CPE, see CPE User's Guide.

3. On the Business Process Logic tab, define the BPL task (including mapping the control plan to the BPL).

4. On the BPL Response Mapping tab, configure the BPL Responses that translate the success and failure responses returned by the control plan into messages for the user who triggers the BPL task.

5. Using the Subscriber Profile Manager, configure the BPL task to appear on the Edit Subscriber screen from where it can be triggered.

   For more information about the Subscriber Profile Manager, see SPM User's Guide.

Accessing the Task Management screen

Follow these steps to open the Task Management screen.

1. Select the Services menu from the SMS main screen.

2. Select Prepaid Charging > Task Management.

   Result: You see the Task Management screen.

Business Process Logic

The Business Process Logic tab lets you configure the business processes that may be executed either through the Edit Subscriber screens or through the PI.

Adding business process logic tasks

Follow these steps to add a new business process logic (BPL) task.

1. In the Task Management screen, select the Service Provider from the drop down box.

2. On the Business Process Logic tab, click New.

   Result: You see the New Business Process Logic screen.

3. In the Short Name field, enter a unique name for the BPL task. This can be up to 16 characters long. The short name is used to identify the BPL task in BPL execution requests to the smsTrigDaemon.

   Note: It is also used by the PI when initiating a BPL request using the CCSBPL=EXE command.

4. In the Full Name field, enter a unique full name for the BPL task. It can be up to 64 characters long.

   The full name appears in the Edit Subscriber screen on the label of the button associated with the BPL task.

5. From the Control Plan drop down list, select the control plan to be executed by the BPL task.

   The drop down list displays all the control plans a subscriber can use.

   Tip: This list can be shortened by using the Search By field and then Search.

6. In the Description field, enter a description for the BPL task.

7. In the Service Handle field, enter the BPL service application name on the SLC.

   Warning: This field is required. It should be set to 'CCS_BPL' unless you are using a non-default configuration. In this case additional configuration of xmlTrigDaemon, SLEE and slee_acs is required. Refer to XML TCAP Interface Technical Guide for details.

8. In the PI Security Level field, enter the PI security level number. Valid values are in the range 0 to 99.

   Note: The PI security level is used to limit which users may execute the BPL task through the PI. Users who have a PI security level that is lower than the PI security level for the BPL task will not be able to execute it.

   For more information about the PI, see PI User's Guide.

9. Select the Wallet Selection check box if you want to be able to select the wallet the BPL task applies to, when the BPL task is executed through the screens.

10. Add any BPL parameters that may be required during execution of the BPL task. You can add up to six parameters.

    These parameters are filled out by the user on the Confirm Execute BPL prompt when the BPL is executed. For details see Adding a BPL parameter.

    Warning: BPLparameters must correspond to the extension parameters (4 to 9) defined in the acs.conf configuration file. For more information about the acs.conf, see ACS Technical Guide.

11. Click Save.

Related topic

Business Process Logic

Editing business process logic tasks

Follow these steps to edit an existing business process logic task.

1. In the Task Management screen, select the Service Provider from the drop down box.

2. In the table on the Business Process Logic tab, select the task to edit.

3. Click Edit.

   Result: You see the Edit Business Process Logic screen.

4. Edit the details as described in Adding business process logic tasks.

5. Click Save.

Related topic

Business Process Logic

Deleting business process logic tasks

Follow these steps to delete an existing business process logic task.

1. In the Task Management screen, select the Service Provider from the drop down box.

2. In the table on the Business Process Logic tab, select the task to delete.

3. Click Delete.

   Result: You see the Delete Confirmation prompt.

4. Click OK.

   Result: The BPL task and any associated BPL parameters are deleted from the database, and you see the Delete Successful prompt.

5. Click OK.

Related topic

Business Process Logic

Adding BPL parameters

Follow these steps to add a new parameter to a BPL task.

Warning: This parameter must correspond to an INAP extension parameter configured in acs.conf. For more information about this configuration, see ACS Technical Guide.

1. In the New or the Edit Business Process Logic screen, click New.

   Result: You see the New BPL Parameter screen.

2. In the Display Name field enter the parameter's name. This will be displayed next to a data entry box on the Confirm Execute BPL prompt when you execute the BPL task.

   For more information about executing BPL tasks, see CCS User's Guide.

3. If a value must be supplied for this parameter in order to execute this BPL task, select the Mandatory check box.

4. Click Ok.

   Result: The new parameter appears in the BPL Parameters table.

5. To change the order in which the parameter appears in the table, select it in the table and then:

   • Click Up to move the parameter up one row.

   • Click Down to move it down one row.

   Tip: The order in which the parameters appear in the table determines which INAP extension parameter they correspond to. The parameter in the first row corresponds to extension parameter 4. The parameter in the next row corresponds to extension parameter 5, and so on.

6. Click Save.

   Result: The changes are saved to the database.

Related topic

Business Process Logic

Editing a BPL parameter

Follow these steps to edit an existing BPL parameter.

1. In the New or the Edit Business Process Logic screen, select the record to edit in the BPL Parameters table.

2. Click Edit.

   Result: You see the Edit BPL Parameter screen.

3. In the Display Name field enter a new name for the parameter, if required.

4. Select or deselect the Mandatory check box as required.

   Warning: You must supply a value for this parameter at run time if this field is selected.

5. Click Ok.

6. To change the order in which the parameter appears in the table, use the Up and Down buttons:

   • Click Up to move the parameter up one row.

   • Click Down to move it down one row.

7. Tip: The order in which the parameters appear in the table determines which INAP extension parameter they correspond to. The parameter in the first row corresponds to extension parameter 4. The parameter in the next row corresponds to extension parameter 5, and so on.

8. Click Save.

   Result: The changes are saved to the database.

Related topic

Business Process Logic

Deleting BPL parameters

Follow these steps to delete an existing BPL parameter.

1. In the BPL Parameters table on the New or the Edit Business Process Logic screen, select the BPL parameter to delete.

2. Click Delete.

3. Click Save.

   Result: The record is deleted from the database.

   Tip: The record is not deleted from the database until you click Save. Prior to this point you can reverse any changes by clicking Cancel.

Related topic

Business Process Logic

BPL Response Mapping

The BPL Response Mapping tab lets you map user friendly messages and their translations to the responses received from the SLC when a BPL task is executed.

Topics:

Adding BPL responses

Editing BPL responses

Deleting BPL responses

Adding translations for BPL responses

Editing translations for BPL responses

Deleting translations for BPL responses

Adding BPL responses

Follow these steps to add a new BPL response.

1. In the Task Management screen, select the Service Provider from the drop down box.

2. Select the BPL Response Mapping tab.

3. From the BPL drop down box, select the BPL task for which to configure a new response, and click New Response.

   Result: You see the New BPL Response screen.

4. From the Response Template drop down list, select the BPL response to configure.

5. If the Response Number field is available, enter the response number.

   Tip: This field is only available where the response template contains the '%d' variable. The '%d' is replaced by the response number when you save the response.

6. Click Save.

Related topic

BPL Response Mapping

Editing BPL responses

Follow these steps to edit an existing BPL response.

1. In the Task Management screen, select the service provider from the Service Provider list.

2. Select the BPL Response Mapping tab.

3. From the BPL list, select the BPL task for which the response is configured.

4. From the Response list, select the response to edit and click Edit Response.

   Result: You see the Edit BPL Response screen.

5. If required, select a different Response Template.

6. If required, specify a different Response Number.

7. Click Save.

Related topic

BPL Response Mapping

Deleting BPL responses

Follow these steps to delete an existing BPL response and any related message mappings.

1. In the Task Management screen, select the Service Provider from the drop down box.

2. Select the BPL Response Mapping tab.

3. From the BPL drop down list, select the BPL task which has the error to delete.

   From the Response drop down list, select the response you want to delete.

4. Click Delete Response.

   Result: You see the Delete Confirmation prompt.

5. Click OK.

   Result: You see the BPL Responses delete success prompt.

6. Click OK.

   Result: The BPL response and any related message translations are deleted from the database.

Related topic

BPL Response Mapping

Adding translations for BPL responses

Follow these steps to add a new translation for a BPL response.

1. On the BPL Response Mapping tab in the Task Management screen, select the BPL from the drop down box.

2. From the Response drop down list, select the response for which to map a new message translation.

3. Click New Message.

   Result: You see the New BPL Response Message screen.

4. From the Language drop down box, select the language for the response message.

   Tip: The language to use is configured in the ACS Tools screen, Language tab. During execution, the configured screens runtime language will determine which message is shown. If a language is not specifically configured then the default screens language is used. This will be either the default language for the service provider, or the global default language (as configured in the ACS Tools screen). For more information about setting languages, see ACS User's Guide.

5. In the Display Message field, enter the message text.

6. Click Save.

Related topic

BPL Response Mapping

Editing translations for BPL responses

Follow these steps to edit a translation for a BPL response message.

1. On the BPL Response Mapping tab in the Task Management screen, select the BPL from the drop down box.

2. From the Response drop down list, select the response.

3. In the table, select the message translation to edit and click Edit Message.

   Result: You see the Edit BPL Response Message screen.

4. From the Language drop down box, select a different language if required.

5. Edit the Display Message as required.

6. Click Save.

Related topic

BPL Response Mapping

Deleting translations for BPL responses

Follow these steps to delete message mapping for a BPL response.

1. On the BPL Response Mapping tab in the Task Management screen, select the BPL from the drop down box.

2. From the drop down list, select the Response you want.

3. Select the row in the table for the message mapping to delete and click Delete Message.

   Result: You see the Delete Confirmation prompt.

4. Click OK.

   Result: You see the BPL Response Mapping prompt.

5. Click OK.

   Result: The record is deleted from the database.

Related topic

BPL Response Mapping

Response Mappings and Control Plans

This section shows an example BPL control plan for a periodic charge subscription. It explains how to correctly set up the nodes in the control plan in conjunction with the response mappings configured in the Task Management screen.

Success response mapping

In the example, the Success branch of the Periodic Charge Subscription node connects to a Terminate Unchanged feature node. When the control plan executes successfully a '200 OK' message will be returned to the triggering daemon. This is reported as a simple Success response for which no mapping is required.

Note: An alternative is to use a Found response to convey a particular message for success scenarios. This is triggered by the Unconditional Termination feature node entering your Connect To number (Termination Number), which will be used in the Found mapping.

Disconnect call response mappings

In the example, a Disconnect Call node is connected to each of the other exits from the Periodic Charge Subscription node:

• Not supported

• Unsubscribed

• Failure

• Error

When a Disconnect node exit is taken, this results in a '406 Not Acceptable' response with the configured Cause value. This means that the configured Cause value must be mapped to a Not Acceptable response mapping.

Note: You should not set the Cause value to 31 as this has a special meaning. It is interpreted as '404 Not Found' by the triggering daemon, which means that either the subscriber or the control plan has not been found. If you use this code then you will not be able to determine whether the error means one of the following:

• There has been an unexpected control plan error.

• The subscriber has not been found.