Public Holidays Splitter

Note: You can use the Splitter components in a price plan, in a pricing macro, or in a refill plan (refill logic) but not in a charging plan.

The Public Holidays Splitter compares a time slot D with a reference time slot R and divides D into two time slots:

Time slot I, which is inside the public holidays R
Time slot O, which is outside the public holidays R

The reference time slot R is made up of public holidays. You can choose dates by selecting one or more countries or choose one or more dates by selecting individual holidays. The reference time can then be a discontinuous period or just one day.

The illustration below shows different cases you can meet when using a Public Holidays Splitter. The time slots are represented as follow:

Time slot D, represented by [D1-D2]
Time slot R, represented by [R1-R2]
Time slot I, represented by [I1-I2]
Time slot O, represented by [O1-O2]

Notes:

If the time slot D is completely inside R, then part O = 0 (Case 1 in the previous illustration).
If the time slot D is completely outside R, then part I = 0 (Case 2 in the previous illustration).
In all cases, D = I + O (Refer to the previous illustration).
If time slot D extends beyond the reference time slot R on either side of R, the time slot results are coherent: I = R, and O represents the sum of the two time slots that extend outside of either end of R (Cases 3, 4 and 5 in the previous illustration).

Use

When you insert it in the decision tree, the Public Holidays Splitter component divides the time slot D into two time slots and creates:

Two separate branches in the decision tree:

The first branch “During Public Holidays” represents the time slot I
The second branch “Not During Public Holidays” represents the time slot O

Two date properties which are the start date and the end date of the time slots I and O:

The start date takes two values I1 and O1 in succession, depending on the branch
The end date takes two values I2 and O2 in succession, depending on the branch

When the component is executed, the two branches are activated and provide two amounts which are added up to compute the final amount. If I = 0 or O = 0, the corresponding branch is not activated.

Warning: If D = 0, (case of D1 = D2), no branch is activated and no transaction is generated (like with a Free Function).

If the Public Holidays Splitter component processes "case 5" in the previous illustration, it does the following in this order:

Process of the first time slot [O1 - O2] with Start Date (out of the slot) = O1 and End Date (out of the slot) = O2.
Process of the time slot [I1 - I2] with Start Date (in the slot) = I1 and End Date (in the slot) = I2.
Process of the last time slot [O1 - O2] with Start Date (out of the slot) = O1 and End Date (out of the slot) = O2.

Example

Note: In a price plan, you may need to apply prices that vary according to a public holidays time slot or not. The Public Holidays Splitter component is often used to calculate the cost of a telephone call, the price of which varies according to the cases that are shown in the following table:

If the call takes place	You must apply the price	During
During a public holidays time slot	“Public Holidays”	The entire call duration
Not during a public holidays time slot	“Not Public Holidays”	The entire call duration
Partly during and partly not during a public holidays time slot	“Public Holidays”	The duration of the call that is during public holidays time slot
	“Not Public Holidays”	The duration of the call that is outside the public holidays time slot

A customer has a telephone service that includes a reduced price of $0.02 per minute if the call takes place during a public holiday; otherwise, the call costs $0.04 per minute. To calculate the cost of a call, you need to do the following:

Compare the call time slot with the reference time slot of public holidays.
Divide the call time slot into two time slots, “During Public Holidays“ and “Not During Public Holidays.”
Calculate the duration of the two time slots and apply the corresponding price.

The following table presents the information that is needed to set up the Public Holidays Splitter component in the price plan:

Data	Settings
Time slot D	Start date of the phone call (D1). Stop date of the phone call (D2).
Reference time slot R	All USA public holidays
Generated property	Start Date and End Date (in the slot): [I1 - I2] Start Date and End Date (out of the slot): [O1 - O2]
Pricing rules	Duration of each time slot: Difference between the two generated properties Start Date and End Date for each time slot. Price that is applied to the “During Public Holidays” branch: $0.02 per minute. Price that is applied to the “Not During Public Holidays” branch: $0.04 per minute.

Identification area

Name: Type the name of the component (mandatory).

Description: Allows you to type the description of the component (optional).

Definition tab

Start Date Name: Provides the list of date properties. Select the date property that represents the value D1 of the [D1-D2] time slot.

End Date Name: Provides the list of date properties. Select the date property that represents the value D2 of the [D1-D2] time slot.

Public Holidays: Allows you to set up the reference time slot [R1-R2] that represents one or more Public Holidays.

Group: Select an item in the list (*), and then click to select the item-related public holidays. Repeat this action for others items if necessary. To clear all the selected public holidays, click .

(*): An item can be a region, a country or anything else. The list of public holidays is created by your Administrator. See your administrator, or consult the Configuration Guide for more information. Refer to Help resources.

Note: Do not pay attention to the public holidays that appear dimmed (unavailable) in the list because they are not longer recognized by the server SAP Convergent Charging and are not longer active in the charges where they are used. For more information, consult the important note in the topic describing how to import public holidays. For more information on the import and export functions, refer to the online Help of SAP CC Core Tool (in the chapter Tools, consult the subchapter Public Holidays).

Names of Computed Properties: Allows you to type the names of the new date properties that retrieve the resulting time slots. These properties can be reused in a Duration Operator component to calculate a duration.

Start Date (in the slot): Allows you to type the name of the new date property that retrieves the start date of the resulting time slot [I1 - I2]. You can reuse this computed property in the branch "During Public Holidays" of the decision tree.
End Date (in the slot): Allows you to type the name of the new date property that retrieves the end date of the resulting time slot [I1 - I2]. You can reuse this computed property in the branch "During Public Holidays" of the decision tree.
Start Date (out of the slot): Allows you to type the name of the new date property that retrieves the start date of the resulting time slot [O1 - O2]. You can reuse this computed property in the branch "Not During Public Holidays" of the decision tree.
End Date (out of the slot): Allows you to type the name of the new date property that retrieves the end date of the resulting time slot [O1 - O2]. You can reuse this computed property in the branch "Not During Public Holidays" of the decision tree.