Embed Size (px)
Citation preview
ww
w.j
Bill
ing.c
om
The Open Source Enterprise Billing System
Telecom Guide
Copyright
This document is Copyright © 2004-2010 Enterprise jBilling Software Ltd. All Rights Reserved. No part of this document may be reproduced, transmitted in any form or by any means -electronic, mechanical, photocopying, printing or otherwise- without the prior written permission of Enterprise jBilling Software Ltd.
jBilling is a registered trademark of Enterprise jBilling Software Ltd. All other brands and product names are trademarks of their respective owners.
AuthorEmiliano Conde and others
Revision number and software versionThis revision is 2.0, based on jBilling 2.1.0
Table of Contents
CHAPTER 1MEDIATION & RATING..........................................................................................8
About jBilling 'telco'.......................................................................................................................................9
Who should read this?.................................................................................................................................. 9
Requirements..............................................................................................................................................10
The need for mediation................................................................................................................................ 10
Rating events................................................................................................................................................. 11
Mediation and Rating with jBilling.............................................................................................................11
Updating orders.......................................................................................................................................... 14
CHAPTER 2THE MEDIATION PROCESS............................................................................... 17
Overview........................................................................................................................................................18
Deployment ...................................................................................................................................................18
Performance .............................................................................................................................................. 20
Batch size............................................................................................................................................... 20
Buffer size..............................................................................................................................................21
Rules optimization................................................................................................................................. 21
Scheduling..................................................................................................................................................... 24
The list of mediation processes.................................................................................................................... 24
CHAPTER 3THE MEDIATION CONFIGURATION...................................................................26
CHAPTER 4READERS.............................................................................................................28
The readers plug-ins................................................................................................................................... 29
The file reader plug-ins..........................................................................................................................29
The JDBC reader plug-ins..................................................................................................................... 30
Creating you own reader plug-in................................................................................................................31
Reader plug-in responsibilities.............................................................................................................. 33
Code re-use............................................................................................................................................ 35
CHAPTER 5THE RECORD FORMAT...................................................................................... 36
XML format description.............................................................................................................................. 37
The record key............................................................................................................................................37
Purging the keys table............................................................................................................................38
Example......................................................................................................................................................... 38
CHAPTER 6PROCESSING WITH RULES.............................................................................. 42
Overview........................................................................................................................................................43
Mediation rules...........................................................................................................................................43
Item management rules.............................................................................................................................. 43
Pricing rules................................................................................................................................................44
Steps............................................................................................................................................................... 44
The MediationResult object....................................................................................................................... 44
Step 1: Start................................................................................................................................................ 45
Input State.............................................................................................................................................. 45
Output state............................................................................................................................................ 45
Things to do........................................................................................................................................... 46
Step 2: After User.......................................................................................................................................47
Input State.............................................................................................................................................. 47
Output state............................................................................................................................................ 48
Things to do........................................................................................................................................... 48
Step 3: Current Order................................................................................................................................. 48
Input State.............................................................................................................................................. 49
Output state............................................................................................................................................ 49
Things to do........................................................................................................................................... 49
Step 4: Resolve Product (Item).................................................................................................................. 49
Input State.............................................................................................................................................. 50
Output state............................................................................................................................................ 50
Things to do........................................................................................................................................... 50
Step 5: Pricing............................................................................................................................................ 52
Input State.............................................................................................................................................. 52
Output state............................................................................................................................................ 52
Things to do........................................................................................................................................... 52
Step 6: Item Management.......................................................................................................................... 53
Input State.............................................................................................................................................. 53
Output state............................................................................................................................................ 53
Things to do........................................................................................................................................... 54
Step 7: Account update...............................................................................................................................55
Input State.............................................................................................................................................. 55
Output state............................................................................................................................................ 55
Things to do........................................................................................................................................... 55
Transforming the data..................................................................................................................................56
Record splitting.......................................................................................................................................... 56
Record grouping.........................................................................................................................................56
Padding and other field modifications....................................................................................................... 57
Extending the mediation module.................................................................................................................57
CHAPTER 7RATING.................................................................................................................58
Rating events................................................................................................................................................. 59
The pricing result....................................................................................................................................... 59
Executing pricing rules...............................................................................................................................60
Item relationship management plug-in.......................................................................................................60
Pricing with rules..........................................................................................................................................60
Dealing with large number of pricing rules................................................................................................62
CHAPTER 8MEDIATION ERRORS..........................................................................................63
The mediation results................................................................................................................................... 64
Done and billable....................................................................................................................................... 64
Done and not billable................................................................................................................................. 64
Error detected............................................................................................................................................. 64
Error declared.............................................................................................................................................65
Reprocessing records with errors................................................................................................................66
Saving the records with errors....................................................................................................................66
Fixing the errors......................................................................................................................................... 67
Reprocessing the records............................................................................................................................67
CHAPTER 9REAL-TIME MEDIATION..................................................................................... 68
The difference of real time processing........................................................................................................ 69
Processing an event in real time.................................................................................................................69
Validating an event before it happens........................................................................................................ 70
CHAPTER 10EXAMPLE SCENARIO.........................................................................................72
Our example plan......................................................................................................................................... 73
Initial configuration......................................................................................................................................73
Plug-ins.......................................................................................................................................................73
Mediation configuration.............................................................................................................................74
Items and customers................................................................................................................................... 74
Expressing the plan with rules.....................................................................................................................75
Mediation rules...........................................................................................................................................76
Defining the user....................................................................................................................................77
Defining the event date.......................................................................................................................... 77
Long distance calls.................................................................................................................................78
Weekend calls........................................................................................................................................ 78
Standard calls......................................................................................................................................... 79
Item management rules.............................................................................................................................. 80
Free weekends for subscribers only.......................................................................................................80
Minutes included in the plan..................................................................................................................80
Pricing long distance calls..........................................................................................................................81
Processing some events.................................................................................................................................82
CHAPTER 11PROVISIONING....................................................................................................84
Introduction...................................................................................................................................................85
Overview of the provisioning process in jBilling....................................................................................... 85
The advantage of JMS................................................................................................................................86
An Example................................................................................................................................................87
The internal provisioning module............................................................................................................... 87
The provisioning status of orders............................................................................................................... 87
Provisioning events and the provisioning plug-in......................................................................................88
Provisioning rules.......................................................................................................................................89
The provisioning queues............................................................................................................................ 91
The external provisioning module...............................................................................................................91
Configuration of the Message Mapping component.................................................................................. 92
The external provisioning plug-in.............................................................................................................. 95
Error handling........................................................................................................................................ 97
