Información Exports De Opera - Pms
La configuración de Exports es un proceso que se ejcuta desde el front desk (Desde la Api solo pueden listarse) de Opera Pms justo como lo indica la documentación directa de opera https://docs.oracle.com/cd/F18689_01/doc.193/f38312/ch_exports.htm#OCSUH-Exports-86715163 y https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/ch_exports.htm , en las siguientes imágenes haré una guía gráfica de como llegar al panel donde se pueden apreciar la lista de exports previamente configurados y donde se podrán crear alguno nuevo.
Como se puede apreciar, para ingresar a la lista de exports hay que ingresar desde el menú principal, desde la sección de Micellaneous, en el menu desplegable de la opción Exports hay que seleccionar General, inmediatamente se mostrará la siguiente página.
Desde aquí se puede apreciar la lista de Exports que ya están configurados.
Crear un nuevo Export:
Para la configuración y creación de un nuevo Export hay 2 formas de hacerlo basándonos en una plantilla pre configurada por Opera o partir de los GENERAL_VIEW, la diferencia entre estos 2 es básicamente que las plantillas ya creadas tienen unas consultas predefinidas y toda una estructura creada solo para que operemos a partir de los parámetros de búsqueda de la data que deseamos plasmar allí, es decir, ya la estructura está definida y lo que nos toca trabajar es sobre qué tipo de filtro usaremos para la data como fecha de inicio y fin de la consulta o que cumplan con alguna u otra condición; sin embargo, están limitados únicamente a los campos previamente definidos que se puedan obtener, por otra parte, los GENERAL_VIEW son mucho más amplios en lo que refieren a la data a extraer pueden traer todos los campos asociados a alguna entidad tomando como ejemplo la RESERVATION_GENERAL_VIEW tiene asociados 543 campos todos relacionados con la entidad de Booking de Opera a la cual se pueden acceder, pero la configuración debe hacerse desde 0.
Export a partir de plantilla
En las siguientes imágenes mostraré ejemplos de cómo configurar una Responsys_Resv_Day que es un Export que se genera de una plantilla como lo indica la documentación de Opera, esta plantilla es para la exportación de información de reservas https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/t_exports_responsys_general_reservation_exports.htm .
Como se puede apreciar en la siguiente imagen, a la derecha sobre la tabla existen 2 opciones New y New From Template en este momento escogeremos la sección de New From Template y se desplegará un modal como este.
En la cual se debe dar click sobre el input de template para escoger uno (Además de cargar los demás inputs) se mostrará una lista como la siguiente.
Al culminar la selección encontrarás una vista cómo está en la cual podrás ver la configuración del Export creado.
Para cambiar los parámetros se debe clickear sobre el input Parameter Form
Al hacer esto, se mostrará la lista de tipos de parámetros que se pueden aplicar, como la que se muestra a continuación.
Es importante acotar que no todos los tipos de parámetros aplican para todos los Exports la asociación y correspondencia son empírica.
En la lista de los Exports podremos apreciar el nuestro ya creado. Para poder probarlo, debemos darle click en la fila al final en los 3 puntos para desplegar el menú desplegable de opciones.
Al hacer esto, se desplegará un menú desplegable donde se deberán ejecutar 2 acciones cuando el Export está recién creado o modificado. 1) Clickar sobre Export Data 2) clickar sobre View Exports y si ya está creado y sin modificaciones solo se clickea sobre View Exports .
Al ejecutar estos pasos, llegarás a una vista como la siguiente (Importante: si la lista continuación está vacía, es porque no se le dio click a la opción Export Data en el paso anterior).
Ya en este punto se debe dar click en los 3 puntos para desplegar las opciones como se muestra a continuación, en la cual se debe dar click sobre la opción Generate File
Esto desplegará un último modal para escoger el nombre del archivo y el formato del mismo se le da click al botón Generate File por último debes darle click de nuevo en los 3 puntos cuando ya se genere el archivo y te dará la opción Download y con esto descargará el archivo.
Anexo links sobre documentación de algunas plantillas de Opera:
- Para Huespedes: https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/t_exports_responsys_general_profile_exports.htm
- Para Reservas: https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/t_exports_responsys_general_reservation_exports.htm
- Para Transacciones: https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/t_exports_responsys_general_transaction_exports.htm
Export sin plantilla
En las siguientes imágenes mostraré ejemplos de cómo configurar sin plantillas un Export .
Como se puede apreciar en la siguiente imagen, a la derecha sobre la tabla existen 2 opciones New y New From Template en este momento escogeremos la sección de New con esto se redirigirá a una página como esta.
Como se puede apreciar a diferencia de los generados a partir de plantilla hay que configurar cada uno de los campos de manera manual, para efectos de esta documentación se muestra como fue cargado los datos para un export enfocado en reservas y esto a partir de la selección del Data Source Name de RESERVATION_GENERAL_VIEW esto en resumen de lo que se enfoca de buscar todos los campos relacionados con alguna entidad principal en este caso reserva.
Para gestionar los campos que se agregarán al archivo Export se utiliza este editor integrado en el sistema que te permite agregar, remover y ordenar los campos que se exportarán.
Para cambiar los parámetros se debe clickear sobre el input Parameter Form
Al hacer esto, se mostrará la lista de tipos de parámetros que se pueden aplicar, como la que se muestra a continuación.
Es importante acotar que no todos los tipos de parámetros aplican para todos los Exports la asociación y correspondencia son empírica.
En la lista de los Exports podremos apreciar el nuestro ya creado. Para poder probarlo, debemos darle click en la fila al final en los 3 puntos para desplegar el menú desplegable de opciones.
Al hacer esto, se desplegará un menú desplegable donde se deberán ejecutar 2 acciones cuando el Export está recién creado o modificado. 1) Clickar sobre Export Data 2) clickar sobre View Exports y si ya está creado y sin modificaciones solo se clickea sobre View Exports .
Al ejecutar estos pasos, llegarás a una vista como la siguiente (Importante: si la lista continuación está vacía, es porque no se le dio click a la opción Export Data en el paso anterior).
Ya en este punto se debe dar click en los 3 puntos para desplegar las opciones como se muestra a continuación, en la cual se debe dar click sobre la opción Generate File
Esto desplegará un último modal para escoger el nombre del archivo y el formato del mismo se le da click al botón Generate File por último debes darle click de nuevo en los 3 puntos cuando ya se genere el archivo y te dará la opción Download y con esto descargará el archivo.
Proceso de configuración de export para Reservas
Para la configuracion se debe crear un export sin plantilla como se ha indicado anteriormente y en selección del Data Source Name se debe escoger RESERVATION_GENERAL_VIEW, y se debe definir los parametros de la siguiente forma, comencemos con las General Configurations, se debe hacer check Always Export Header and Footer, check en Compress Data, en el selector de Column Separator se debe seleccionar a Semi Colon, y por ultimo hacer check en Add Newline.
Pasemos a la configuracion del Header, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Data, el proceso para agregar los valores es el siguiente:
La lista de valores que deben ser registrados en el Header son los siguientes:
confirmation_no
trx_code
trx_type
trx_type_description
transaction_action_id
transaction_description
reservation_id
guest_id
net_amount
gross_amount
posted_amount
non_revuene_amount
currency
market_code
product
quantity
price_per_unit
billing_no
Pasemos a la configuracion del Data, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Header, el proceso para agregar los valores es el siguiente:
Inmediatamente en el selector Column Data Type, se debe dejar la opcion Data, y posteriormente al selector Column Type se debe cambiar a la opcion Database Column, por consiguiente falta asignar que colunma de la base de datos y esto se realiza con el selector Column Name, adjunto imagen de ejemplo
La lista de valores que deben ser registrados en el DATA son los siguientes:
CONFIRMATION_NO
TRX_CODE
TRX_TYPE
TRX_TYPE_DESCRIPTION
TRAN_ACTION_ID
TRANSACTION_DESCRIPTION
RESV_NAME_ID
NAME_ID
NET_AMOUNT
GROSS_AMOUNT
POSTED_AMOUNT
NON_REVENUE_AMOUNT
CURRENCY
MARKET_CODE
PRODUCT
QUANTITY
PRICE_PER_UNIT
BILL_NO
Proceso de configuración de export para Perfiles
Para la configuracion se debe crear un export sin plantilla como se ha indicado anteriormente y en selección del Data Source Name se debe escoger Name_View, y se debe definir los parametros de la siguiente forma, comencemos con las General Configurations, se debe hacer check Always Export Header and Footer, check en Compress Data, en el selector de Column Separator se debe seleccionar a Semi Colon, y por ultimo hacer check en Add Newline.
Pasemos a la configuracion del Header, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Data, el proceso para agregar los valores es el siguiente:
La lista de valores que deben ser registrados en el Header son los siguientes:
guest_id
firts_name
last_name
email_id
email
address_id
address_line_1
address_line_2
address_line_3
city
country
zip_code
birthdate
document_identity_id
document_identity_effective_date
document_identity_expiration_date
document_identity_value
document_identity_type
gender
language
nationality
phone_id
phone_country_code
phone_area_code
phone
Pasemos a la configuracion del Data, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Header, el proceso para agregar los valores es el siguiente:
Inmediatamente en el selector Column Data Type, se debe dejar la opcion Data, y posteriormente al selector Column Type se debe cambiar a la opcion Database Column, por consiguiente falta asignar que colunma de la base de datos y esto se realiza con el selector Column Name, adjunto imagen de ejemplo
La lista de valores que deben ser registrados en el DATA son los siguientes:
NAME_ID
FIRST
NAME
EMAIL_ID
EMAIL
ADDRESS_ID
ADDRESS1
ADDRESS2
ADDRESS3
CITY
STATE
COUNTRY
ZIP_CODE
BIRTH_DATE
ID_DOCUMENT_ATTACH_ID
ID_DATE
ID_EXPIRATION_DATE
ID_NUMBER
ID_TYPE
GENDER
LANGUAGE
NATIONALITY
PHONE_ID
PHONE_COUNTRY_CODE
PHONE_EXTENSION
PHONE_NO
Proceso de configuración de export para Transacciones
Para la configuracion se debe crear un export con plantilla como se ha indicado anteriormente y en selección del Template se debe escoger EXP_TRANSACTIONS, y se debe definir los parametros de la siguiente forma, comencemos con las General Configurations, se debe hacer check Always Export Header and Footer, check en Compress Data, en el selector de Column Separator se debe seleccionar a Semi Colon, y por ultimo hacer check en Add Newline.
Pasemos a la configuracion del Header, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Data, el proceso para agregar los valores es el siguiente:
La lista de valores que deben ser registrados en el Header son los siguientes:
confirmation_no
trx_code
trx_type
trx_type_description
transaction_action_id
transaction_description
reservation_id
guest_id
net_amount
gross_amount
posted_amount
non_revuene_amount
currency
market_code
product
quantity
price_per_unit
billing_no
Pasemos a la configuracion del Data, se debe respetar el orden y los nombres debido a que estan relacionados con los valores que se ejecutaran en el Header, el proceso para agregar los valores es el siguiente:
Inmediatamente en el selector Column Data Type, se debe dejar la opcion Data, y posteriormente al selector Column Type se debe cambiar a la opcion Database Column, por consiguiente falta asignar que colunma de la base de datos y esto se realiza con el selector Column Name, adjunto imagen de ejemplo
La lista de valores que deben ser registrados en el DATA son los siguientes:
CONFIRMATION_NO
TRX_CODE
TRX_TYPE
TRX_TYPE_DESCRIPTION
TRAN_ACTION_ID
TRANSACTION_DESCRIPTION
RESV_NAME_ID
NAME_ID
NET_AMOUNT
GROSS_AMOUNT
POSTED_AMOUNT
NON_REVENUE_AMOUNT
CURRENCY
MARKET_CODE
PRODUCT
QUANTITY
PRICE_PER_UNIT
BILL_NO
Configuración de los Delivery Configuration
Con respecto a la configuración de envío de estos exports hay una sección de documentación dedicada a ello: https://docs.oracle.com/en/industries/hospitality/opera-cloud/23.5/ocsuh/t_exports_managing_export_file_delivery_configuration.htm en las siguientes imágenes mostraremos cómo se configura.
En la lista de los Exports debemos darle click en la fila al final en los 3 puntos para desplegar el menú desplegable de opciones.
Al hacer esto, veremos una página como está en la cual para configurar debemos dar click en la opción Edit para poder configurar la opción de envío que deseemos.
Podemos apreciar que tenemos 3 opciones: SFTP, HTTPS y File System
Con respecto al envío por medio de SFTP existen consideraciones que se abordan en este fragmento de la documentación https://docs.oracle.com/cd/F18689_01/doc.193/f38312/t_exports_sftp_delivery_method_configuration.htm#OCSUH-SFTPDeliveryMethodConfiguration-434729C0 y es importante resaltar esta nota en la documentación.
