Nor1 - OXI Install
Nor1 - OXI Install
Services
OXI Installation and Configuration Guide
Release 21.1
F40572-04
February 2022
Oracle Hospitality Nor1 Cloud Services OXI Installation and Configuration Guide, Release 21.1
F40572-04
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software" or "commercial computer software documentation" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use,
reproduction, duplication, release, display, disclosure, modification, preparation of derivative works, and/or
adaptation of i) Oracle programs (including any operating system, integrated software, any programs
embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle
computer documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the
license contained in the applicable contract. The terms governing the U.S. Government’s use of Oracle cloud
services are defined by the applicable contract for such services. No other rights are granted to the U.S.
Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
Preface
1 Manual Configuration
Introduction 1-1
Prerequisites 1-1
Manual Installation Steps 1-2
Installation Confirmation 1-2
2 PMS Configuration
NOR1 Department Code 2-1
Alerts Configuration 2-1
Configuring Alert Messages 2-1
Configuring Business Events 2-1
External System Cross-subscriptions 2-3
3 OXI Configuration
Interface Setup 3-1
Conversion Codes 3-2
OXI Interface Parameters 3-2
OXI Interface Defaults 3-5
COMM Methods 3-6
Automatic Transmission Schedule (ATS) 3-8
OXI Alert Configuration 3-10
UDF Column Conversion 3-12
NLS Lang 3-13
Reserved IP Addresses for OXI 3-14
iii
Preface
Preface
This document is intended to help installers with the manual configuration of the
Oracle Hospitality OPERA Exchange Interface (OXI).
Purpose
This document provides information for implementing Oracle Hospitality Nor1 Cloud
Services products.
Customer Support
The following support options are available:
• Live Chat is provided for Nor1 CheckIn Merchandising customers directly in the
application.
• Nor1 eStandby Upgrade support is provided by email at support@nor1.com and
web form 24x7 at the Nor1 Help Center.
• Customers can contact their Account Relationship team or Account Revenue
Manager directly.
Documentation
Oracle Hospitality product documentation is available on the Oracle Help Center at
http://docs.oracle.com/en/industries/hospitality/.
Revision History
iv
1
Manual Configuration
Introduction
This document is intended to help Oracle Hospitality OPERA Exchange Interface (OXI)
installers with manual configuration of the Nor1 OXI interface in cases where script
installation is not possible. Additionally, it can serve as a guide to confirm configuration
success when using the Nor1 OXI install script.
Prerequisites
The following prerequisites are required for the installation of the Nor1 OXI:
• The Nor1 OXI license code (OPX_NOR1).
• OXI schema user login credentials.
• Nor1 requires the public-facing IP address of the OXI server:
– Open a web browser and navigate to whatismyip.com.
– In the upper left-hand corner of the browser window, provide the value for “My Public
IPv4: XXX.XXX.XXX.XXX.”
• Windows Administrator login credentials to the OPERA Application Server or OXI server
where the Nor1 interface will be installed.
• Web access to the property if the OXI machine is firewall controlled and traffic is open
and ready for Nor1.
• Confirmed web access for NOR1 by pointing to the following URLs in Internet Explorer on
the OPERA Application Server or where the OXI services will be installed:
– https://integration.nor1solutions.com/opera/get&propertyName=ABCDEF
– https://oxi.integration.nor1.com/opera/get&propertyName=ABCDEF
Note:
Replace ABCDEF with the actual property code. The property code is not
necessarily the default OPERA Resort Code. Nor1 has a specialized
naming structure for the property code. Contact Nor1 and provide the
default OPERA Resort Code, and Nor1 will provide the unique Nor1
property code.
• If the script cannot run, reference the project email containing the installation script for the
External System Property Code and the User Defined Fields (UDF) conversion
information.
1-1
Chapter 1
Manual Installation Steps
Installation Confirmation
To confirm the installation, send a zip file to nor1-integrations_grp@oracle.com with
the following items:
1. The Message Status screen captures the “Message to External Systems” with
message traffic filter search criteria only with OPERA Property = Property and
Interface ID = Nor1.
2. Send the NOR1 OXI log. A copy of the log can be found at C:\Program
Files\Micros-Fidelio\OXChange\OXA\Logs. Log Naming Convention:
NOR1YYYYMMDD.log.xml.
3. A screen capture of the configured ATS (Automatic Transmission Schedule).
4. A screen capture of the external systems and the Nor1 subscription to all external
systems.
5. A screen capture of the Nor1 OXI processors with the processors running.
6. A screen capture of any conversion codes entered into OXI (conversion codes will
be determined on a property by property basis as needed).
7. A screen capture of the OXI XML version for Reservations.
8. A screen capture of the OXI registry setting to use UTF8 for NLS_LANG.
Upon receipt of the above items, Nor1 will confirm by email whether all settings are
correct.
1-2
2
PMS Configuration
Alerts Configuration
Confirm the application setting for Alerts is active.
1. In OPERA PMS, select Setup.
2. Select Application Settings.
3. Select Reservations.
4. Confirm that the Alerts function is active.
2-1
Chapter 2
Configuring Business Events
2-2
Chapter 2
External System Cross-subscriptions
2-3
3
OXI Configuration
Interface Setup
Configure the interface with the XML values shown in the table below. The following screen
shows an External System Property value example of 8:MOMA, where 8 = VNor1Chain value
indicated within the declaration section of the Nor1 install script, and MOMA = the PMS resort
code.
OXI XML Versions (Set the XML setting as follows, if not available set to the highest value):
ACTIVITY V4 NADAILYSTAT V1
ALLOTMENT V5 OWNERCONTRACT V4
BLKSTAT V1 PACKAGES V3
CALENDAR V1 PROFILE V5
CATERINGREVENUE V1 RATE V1
CATEVENT V4 RATE V1
COMMENT V1 RAVL V1
CONFIGURATION V3 RAVR V1
DAILYTARGET V1 RELATIONSHIP V3
DATAMART V1 RESERVATION V5
ECERTIFICATE V1 RESERVATIONREGRET V1
FINDAILYSTAT V1 RESTRICTION V4
FINTRX V4 RESULT V3
3-1
Chapter 3
Conversion Codes
ACTIVITY V4 NADAILYSTAT V1
HURDLE V1 RESVDAILYSTAT V1
HURDLEC V3 RESVSUMMARY V1
INVENTORY V1 ROOMSNAPSHOT V1
INVENTORYQUERY V1 RTAV V4
INVENTORYSUMMARY V1 SALESCEILING V1
ITTEMAVAILABILITY V1 SCBOOKPROD V1
LISTRESPONSE V3 SCHEMAVERSION V2
MANAGERSREPORT V1 STAY V2
MEMBERAWARD V1 UDF V1
MEMBERSHIP V1 UDFDEFINITION V1
MESSAGEREQUEST V3
Conversion Codes
Conversion codes are not required as Nor1 returns reservation codes as received by
OPERA PMS. However, there might be a unique circumstance where a property
requires a conversion code. In this instance, the conversion codes required will be
listed in the project email.
OXI_GENERIC
3-2
Chapter 3
OXI Interface Parameters
OXI_INVENTORY
OXI_MESSAGES
OXI_PROFILES
3-3
Chapter 3
OXI Interface Parameters
OXI_RATES
OXI_RESERVATIONS
3-4
Chapter 3
OXI Interface Defaults
Additionally, you must update the following three parameters in OPERA SQL:
Note:
Update xxxxxxx to OPERA PMS resort code.
3-5
Chapter 3
COMM Methods
Note:
You might need to create Nor1 as a Department from Setup > User
Configuration > Departments within the OPERA PMS.
COMM Methods
Nor1 supports two separate domains for the comm methods. The reason for this is to
maintain backwards compatibility for servers that cannot support TLS 1.2 and higher.
The domains are:
• https://integration.nor1solutions.com – a legacy domain that supports less secure
TLS protocols.
• https://oxi.integration.nor1.com – a strict domain that only supports TLS 1.2 and
1.3 protocols with secure ciphers.
Nor1 recommends you use the strict domain for the comm methods. Each domain has
two endpoints, one for each comm method.
The legacy endpoints are:
• External System to OPERA: https://integration.nor1solutions.com/opera/get.
• OPERA to External System: https://integration.nor1solutions.com/opera/post.
The strict endpoints are:
• External System to OPERA: https://oxi.integration.nor1.com/opera/get.
3-6
Chapter 3
COMM Methods
3-7
Chapter 3
Automatic Transmission Schedule (ATS)
Interface: Nor1
Property: Resort Code
Module: Block
Frequency: 1
Active and Delta: Checked
ATS for Inventory (at 4 a.m.)
3-8
Chapter 3
Automatic Transmission Schedule (ATS)
Interface: Nor1
Property: Resort Code
Module: Inventory
Frequency: D
When to Run: 4 (04:00)
Range: 30
Future: 0
Active: Checked
ATS for Inventory (at 6 a.m.)
Interface: Nor1
3-9
Chapter 3
OXI Alert Configuration
Interface: Nor1
Property: Resort Code
Module: Inventory
Frequency: W
When to Run: 1, 5
Range: 150
Future: 30
Active: Checked
3-10
Chapter 3
OXI Alert Configuration
The following shows you the configuration for Alert If: Interface machine or OXI service is
down.
The following shows you the configuration for Alert if: One or more Interface threads are
down.
3-11
Chapter 3
UDF Column Conversion
Note:
Nor1 uses UDFC38 for tracking the offers. This UDF column might already
be in use. Contact nor1-integrations_grp@oracle.com to use another UDF
column.
3-12
Chapter 3
NLS Lang
NLS Lang
Set the NLS_LANG registry value to prevent string encoding issues that can break Nor1
parsing of the OXI XML.
1. Start > Run > REGEDIT > (HKEY_LOCAL_MACHINE\SOFTWARE\Micros-
Fidelio\OPERA Interface for Nor1.
2. Edit > New > String Value.
3. Value name: = NLS_LANG.
4. Value data: = AMERICAN_AMERICA.UTF8.
3-13
Chapter 3
Reserved IP Addresses for OXI
3-14