44 Logging Additional CSR Activity Details (Release 15.0.1 or later)

Learn how to enhance user activity tracking in Oracle Communications Billing Care by capturing and logging detailed customer service representative (CSR) information, including client IP address.

This chapter outlines how you can override additional CSR activity details in the Billing Care SDK.

Topics in this document:

About User Context Fields in the /user_activity Object

You can customize Billing Care to store user context information, such as the CSR's client machine IP address, in /user_activity object fields. You can override the following fields using the Billing Care SDK:

  • PIN_FLD_API_USER: Contains the Web Services Manager user.

  • PIN_FLD_EXTERNAL_USER: Contains the external CSR's login or ID. By default, it is set to the external login ID.

  • PIN_FLD_NAP_IP_ADDRESS: Contains the client machine's IP address. By default, Billing Care attempts to set it to the client machine's IP address by looking up the X-Forwarded-For header value. If it is not found, it is set to the Billing Care service's IP address.

  • PIN_FLD_CORRELATION_ID: Contains an ID to tag for collating an operation.

Overriding the Default User Context

Configure the Billing Care user context information to use the logic from your custom request module:

  1. Open the myproject/web/WEB-INF/classes/custom/customModule.properties file in a text editor, where myproject is the location of your NetBeans IDE Billing Care customizations project.

  2. Add the following entry to the file, where base_location is the package name where the module implementation class is placed, for example, myproject.com.rest.sdk:

    billingcare.rest.baseops.module = base_location.CustomPCMBaseOps
  3. Save and close the customModule.properties file.

  4. Create a CustomPCMBaseOps.java file in the location you entered into the customModule.properties file, for example, myproject/com/rest/sdk.

  5. In the file, override the addcontextInfo() method with your customizations to add one or more of the user context fields above.

    For a sample, see the SDK_home/samples/AddingContextInfo/src/java/com/rest/sdk/worker/CustomPCMBaseOps.java file, where SDK_home is the directory in which you installed the Billing Care SDK.

  6. Package and deploy your Billing Care SDK. See "Using an Exploded Archive during Customization" or "Packaging and Deploying Customizations".