Package de.aeb.xnsg.simplerouting.bf
Interface IRoutingBF
@BusinessFacade
public interface IRoutingBF
Routing related business facade methods.
Supports direct routing and in later version path routing will be supported.
-
Method Summary
Modifier and TypeMethodDescriptionCreates a new routing task and returns a unique task id.
In case of successful creation, the response will contain the unique taskId of the created routing task.Creates a new supplement task and returns a unique task id.
In case of successful creation, the response will contain the unique taskId of the created supplement task.getAllCarriers
(GetAllCarriersRequestDTO request) Returns all carriers available for the target client.
This call might help to find the correct identCode of a carrier and service as well as the value-added services belonging to that carrier, which shall be added to the supplement task by usingcreateSupplementTask(CreateSupplementTaskRequestDTO)
.Returns all handover points available for the target client.
Handover points are master file data.Returns all rating profiles available for the target client.
This call might help to find the correct identCode of a rating profile, which shall be added to the routing task by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.Returns a sorted list of the rejected proposals for the provided task id and its current calculation state.
The rejected proposals are those proposals which were filtered out according to the settings in the rating profile.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.Returns all requirements and requirement types available for the target client.
This call might help to find the correct identCode of a requirement, which shall be added to the routing task by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.Returns a sorted list of proposals for the provided task id and its current calculation state.
The final list of proposals is ranked according to a rating profile.Returns an intermediate result of calculated supplements for the provided task id and its current calculation state.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.Waits for the task calculation to finish and returns a sorted list of proposals for the provided task id and its current calculation state.
If the calculation takes longer than the set waiting time limit, the list of proposals will be returned in its current unfinished calculation state as soon as the limit is reached.
The final list of proposals is ranked according to a rating profile.
-
Method Details
-
waitForRoutingTaskResult
WaitForRoutingTaskResultResponseDTO waitForRoutingTaskResult(WaitForRoutingTaskResultRequestDTO request) Waits for the task calculation to finish and returns a sorted list of proposals for the provided task id and its current calculation state.
If the calculation takes longer than the set waiting time limit, the list of proposals will be returned in its current unfinished calculation state as soon as the limit is reached.
The final list of proposals is ranked according to a rating profile. A rating profile uses supplements for score calculation and ranking.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.
- RANKED: ordering and entries fixed, at least one supplement missing.
- COMPLETE: ordering and entries fixed, all supplements are calculated.
A new routing task can be created by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.- Parameters:
request
-WaitForRoutingTaskResultRequestDTO
- Returns:
WaitForRoutingTaskResultResponseDTO
-
createRoutingTask
Creates a new routing task and returns a unique task id.
In case of successful creation, the response will contain the unique taskId of the created routing task. The respective routing task can be found by this task id. Proposal calculation starts in an asynchronous process. The current state of calculation can be requested by handing over the provided task id via the call ofgetRoutingTaskResult(GetRoutingTaskResultRequestDTO)
orwaitForRoutingTaskResult(WaitForRoutingTaskResultRequestDTO)
.- Parameters:
request
-CreateRoutingTaskRequestDTO
- Returns:
CreateRoutingTaskResponseDTO
-
getRoutingTaskResult
Returns a sorted list of proposals for the provided task id and its current calculation state.
The final list of proposals is ranked according to a rating profile. A rating profile uses supplements for score calculation and ranking.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.
- RANKED: ordering and entries fixed, at least one supplement missing.
- COMPLETE: ordering and entries fixed, all supplements are calculated.
A new routing task can be created by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.- Parameters:
request
-GetRoutingTaskResultRequestDTO
- Returns:
GetRoutingTaskResultResponseDTO
-
getRejectedRoutingTaskResult
GetRoutingTaskResultResponseDTO getRejectedRoutingTaskResult(GetRoutingTaskResultRequestDTO request) Returns a sorted list of the rejected proposals for the provided task id and its current calculation state.
The rejected proposals are those proposals which were filtered out according to the settings in the rating profile.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.
- RANKED: ordering and entries fixed, at least one supplement missing.
- COMPLETE: ordering and entries fixed, all supplements are calculated.
A new routing task can be created by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.- Parameters:
request
-GetRoutingTaskResultRequestDTO
- Returns:
GetRoutingTaskResultResponseDTO
-
createSupplementTask
Creates a new supplement task and returns a unique task id.
In case of successful creation, the response will contain the unique taskId of the created supplement task. The respective supplement task can be found by this task id. Supplement calculation starts in an asynchronous process. The current state of calculation can be request by handing over the provided task id via the call ofgetSupplementTaskResult(GetSupplementTaskResultRequestDTO)
.- Parameters:
request
-CreateSupplementTaskRequestDTO
- Returns:
CreateSupplementTaskResponseDTO
-
getSupplementTaskResult
GetSupplementTaskResultResponseDTO getSupplementTaskResult(GetSupplementTaskResultRequestDTO request) Returns an intermediate result of calculated supplements for the provided task id and its current calculation state.
Possible states of calculation are:
- INPROGRESS: entries (and ordering) might change in future calls.
- COMPLETE: ordering and entries fixed, all supplements are calculated.
A new supplement task can be created by usingcreateSupplementTask(CreateSupplementTaskRequestDTO)
.- Parameters:
request
-GetSupplementTaskResultRequestDTO
- Returns:
GetSupplementTaskResultResponseDTO
-
getRoutingRequirementTypes
GetRoutingRequirementTypesResponseDTO getRoutingRequirementTypes(GetRoutingRequirementTypesRequestDTO request) Returns all requirements and requirement types available for the target client.
This call might help to find the correct identCode of a requirement, which shall be added to the routing task by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
.- Parameters:
request
-GetRoutingRequirementTypesRequestDTO
- Returns:
GetRoutingRequirementTypesResponseDTO
-
getRatingProfiles
Returns all rating profiles available for the target client.
This call might help to find the correct identCode of a rating profile, which shall be added to the routing task by usingcreateRoutingTask(CreateRoutingTaskRequestDTO)
. This becomes more important, if a rating profile other than the default profile shall be used for proposal calculation.- Parameters:
request
-GetRatingProfilesRequestDTO
- Returns:
GetRatingProfilesResponseDTO
-
getHandoverPoints
Returns all handover points available for the target client.
Handover points are master file data. This call can be used to choose a handover point from a drop down application. It is not intended that this call is used for master data maintenance or master data synchronization.
The address is not included in the response.- Parameters:
request
-GetHandoverPointsRequestDTO
- Returns:
GetHandoverPointsResponseDTO
-
getAllCarriers
Returns all carriers available for the target client.
This call might help to find the correct identCode of a carrier and service as well as the value-added services belonging to that carrier, which shall be added to the supplement task by usingcreateSupplementTask(CreateSupplementTaskRequestDTO)
.- Parameters:
request
-GetAllCarriersRequestDTO
- Returns:
GetAllCarriersResponseDTO
-