SAP CC Batch Agent for Batch Workflows

Configuration

Batch Workflow only.

Using the SAP CC Batch agent in a Batch workflow will allow the agent to send a call synchronously to the SAP server.

Connection Tab

The connection tab allows you to set the credentials required to connect to the SAP server.

SettingDescription
HostsIn this section, add the IP address/hostname and external charging port of at least one SAP Convergent Charging Core server Dispatcher Instance.
Enable Transaction Safe

Select this check box to enable transaction safety. This is a batch workflow feature.

SAP CC Batch agent Batch workflow functionality.

SAP CC does not support rollback on operations that has already been executed. In order to achieve transaction safety,  the agent will utilize a database to keep track of which record that has been processed. In a scenario where the workflow aborts, the agent will be able to refer to the database to determine which records were processed before the abort and prevent duplicated records from being processed.

Database

The database profile to commit the records to. Prior to running this workflow, a table needs to be created in the respective database.

Supported Databases

We support Oracle 9 and above and PostgreSQL 9 and above.


Database Schema

To create the schema in Oracle, follow the command below:

CREATE TABLE MZ_SAP_CC_BATCH_STATE
(
  WF_NAME VARCHAR2(128) NOT NULL
, NODE_NAME VARCHAR2(128) NOT NULL
, POSITION NUMBER NOT NULL
, ANSWER_UDR BLOB NOT NULL
, CONSTRAINT MZ_SAP_CC_BATCH_STATE_PK PRIMARY KEY
  (
    WF_NAME
  , NODE_NAME
  , POSITION
  )
  ENABLE
);

PostgreSQL Schema

To create the schema in PostgreSQL, follow the command below:

CREATE TABLE mz_sap_cc_batch_state (
wf_name        VARCHAR(128) NOT NULL,
node_name       VARCHAR(128)        NOT NULL,
position       NUMERIC(19)      NOT NULL,
answer_udr      bytea      NOT NULL,
PRIMARY KEY(wf_name, node_name, position)
);
DB Commit SizeThe size of the commit to be performed to the database.
Enable Authentication

Select this check box to enable charging API authentication.

Note!

Charging API Authentication is only available for SAP CC version 4.1 SP2 and later.

User NameSAP CC user id
PasswordThe password for the SAP CC user
TimeoutThe timeout (in milliseconds) to apply for each connection
Enable Secured ConnectionSelect to use SSL encrypted communication with Hosts.
Keystore PathThe path to the keystore on an Execution Container host. The path must be the same for all hosts.
Keystore PasswordThe password for the keystore.

Advanced Settings Tab

The Advanced Settings tab contains extended configuration options for the agent.

SettingDescription
Enable Debug EventsSelect this check box to enable debug mode. This option is useful for testing purposes.
Convert Bigdecimal Response to String

Select this check box to allow conversion of the BigDecimal data type from the SAP Convergent Charging response into string. By default, the check box is empty.

Note!

In terms of backwards compatibility, enabling this option prevents any compatibility issues with workflows that support the configurations from before the BigDecimal data type was introduced in version 8.0.5.0.

Input/Output

Input/Output defined here represents the type of data an agent expects and delivers.

Input

CCBatchCycleUDR (2.3)

BlankChargeUDR

ChargeUDR

AcquireUDR

Output

CCBatchCycleUDR (2.3)

Meta Information Model

For information about the Usage Engine MIM and a list of the general MIM parameters, see Administration and Management (2.3).

Publishes

The SAP CC Batch agent does not publish any MIM resources.

Accesses

The SAP CC Batch agent does not access any MIM resources.

Agent Message Events

There are no agent message events for this agent.

Debug Events

Debug messages are dispatched in debug mode. During execution, the messages are displayed in the Workflow Monitor.

You can configure Event Notifications that are triggered when a debug message is dispatched.

The agent produces the following debug events:

  • Input charging request in XML format
  • Invalid charging request in XML format
  • Successful charging answer in XML format
  • Charging error in XML format