Configuring Service Locator Operations
Service Locator is a routing integration pattern used to route the respective API request from OPERA Cloud to the selected Outbound System or OPERA Cloud internal services. Service Locator configuration allows you to map an outbound code for each OPERA Cloud REST API operation at chain, hub or property level. Whenever users perform any business operation in OPERA Cloud, if the particular operation is configured with an Outbound Code, the request is routed to the outbound system based on the user context and service locator configuration. If there is no outbound code configured for the user operation, then the request is made to the respective OPERA Cloud REST web service.
For example, you have developed your own ContactCenter application using OPERA Cloud REST APIs, with business specific extended functionality for the call center team and whenever your operations team creates or updates a profile in OPERA Cloud, you wish to create and update profiles in the ContactCenter application instead of OPERA Cloud. You need to configure an Outbound Code for the ContactCenter and configure the Outbound Code for the profile APIs in Service Locator for your chain.
Service Locator requires Outbound System configuration for the Service Locator Generic type to be completed first.
Service Locator configuration at:
-
Global (chain) level context is used for the transactions performed by the users at property-level and hub-level context. In this case, create an outbound code at the chain-level as prerequisite.
-
Hub level context is used for the transactions performed by the users at hub-level context. In this case, create an outbound code at property level for one of the hub properties as prerequisite.
-
Property level context is used for the transactions performed by the users at the same property-level context. In this case, create an outbound code at the property level as prerequisite.
The same routing logic is applied for the inbound requests received from partner systems via the Oracle Hospitality Integration Platform (OHIP) to OPERA Cloud web services.
It is recommended to configure outbound code and service locator at global (chain) context if all properties of the chain reference the same outbound system, else configure specifics for a property or hub.
Note:
To use this routing integration pattern, the outbound system should accept and implement the solution by adopting the OPERA Cloud REST APIs specifications.Editing Service Locators
-
From the Toolbox menu, select System Setup, and then select Service Locator.
-
Select the context: Global (Chain), Hub or Property, select a Module, enter any additional search criteria, then click Search.
-
Click Edit then update the details for each operation.
-
Outbound Code: Select an outbound code from the list to route the request to the outbound system.
-
Reroute to OPERA Cloud: Select check box to redirect the operation to OPERA Cloud web services when the outbound system is unreachable.
-
Click Save.
-
Copying Service Locators
To copy the setup of one operation to many other operations.
-
From the Toolbox menu, select System Setup, and then select Service Locator.
-
Select the context: Global (Chain), Hub or Property, select a Module, enter any additional search criteria, then click Search.
-
Click Edit.
-
Select the operation to copy, then click the vertical ellipsis Actions menu and select Copy.
-
Select the destination operations then click Apply.
-
Related Topics
Parent topic: System Setup