Fetch Business Events from OPERA Cloud

To fetch business events from OPERA Cloud using the Oracle Hospitality Adapter, you have two options:

• Use the Connectivity Agent to Poll Business Events from OHIP
• Create an Orchestrated Integration Triggered by a Schedule

Use the Connectivity Agent to Poll Business Events from OHIP

1. Create an agent group under Home > Integrations > Agents.
2. Configure a connection for the Oracle Hospitality Adapter and select the agent group.
3. Create an application-driven, orchestration integration.
4. Drag the Oracle Hospitality Adapter to the trigger position.
5. Configure the Oracle Hospitality Adapter accordingly.
   1. On the Basic Info page, specify a name and optional description.
   2. On the Business Events page, specify the hotel ID, external system ID, polling interval (in seconds), polling option, and event limits.
      
      
      
      
   3. On the Request page, provide the JSON request payload. Check your Oracle Hospitality Integration Platform (OHIP) customer portal to get the JSON sample of the request.
   4. View your selections on the Summary page.
   When configured as a trigger connection, the Oracle Hospitality Adapter triggers new integration instances under certain conditions:

   • If OHIP returns an HTTP 204 response, which means there are no business events to process, no integration instances are triggered. Because there are no business events to process, there's no need to generate an instance that doesn't have any content. This way, you avoid having the Tracking page show instances that don't have any business events. Also, no messages are counted for billing purposes.
   • If OHIP returns an HTTP 5xx response, which means a server error occurred, the adapter only triggers an instance if, after a period of one hour, HTTP 5xx errors are received. This prevents excessive failed instances in which the error is related to OHIP or OPERA Cloud. This also keeps the billing messages at a normal level of consumption. If, after a period of one hour, the adapter has only received HTTP 5xx errors, one instance is triggered to provide visibility that a server error exists.

   Note:

   OPERA Cloud business events consumption (trigger role) is only supported with use of the connectivity agent.

Create an Orchestrated Integration Triggered by a Schedule

1. Configure a connection for the Oracle Hospitality Adapter (no agent group is required).
2. Create a scheduled orchestration integration.
3. Drag the Oracle Hospitality Adapter to the first location. This adds the Oracle Hospitality Adapter as an invoke connection that receives business events.
4. Configure the Oracle Hospitality Adapter accordingly.
   • Check your OHIP customer portal to get the JSON sample of the request and the relative URI.
   • Use the OPERA Cloud Integration Processor APIs, which are APIs used to receive business events from OPERA Cloud.
   • Check your OHIP customer portal for details on these APIs.