Oracle® Cloud

Modelado de datos empresariales en Oracle

Analytics Cloud

F32715-12
Enero de 2023
Oracle Cloud Modelado de datos empresariales en Oracle Analytics Cloud,

F32715-12

Copyright © 2020, 2023, Oracle y/o sus filiales.

Autor principal: Rosie Harvey

Autores colaboradores: Suzanne Gill, Pete Brownbridge, Stefanie Rhone, Hemala Vivek, Padma Rao

Colaboradores: Oracle Analytics development, product management, and quality assurance teams

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, software documentation, data (as defined in the Federal Acquisition Regulation), 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," "commercial computer software documentation," or "limited rights
data" 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.
Tabla de contenidos
Prefacio
Destinatarios xiii
Accesibilidad a la documentación xiii
Diversidad e inclusión xiii
Documentos relacionados xiv
Convenciones xiv

Parte I Introducción al modelado de datos empresariales

1 Acerca del modelado de datos empresariales

Tipos de modelos 1-1
Herramientas de modelado de datos 1-1

Parte II Uso de Data Modeler para crear modelos semánticos

2 Introducción a Data Modeler

Flujo de trabajo típico para modelar datos 2-1
Apertura de Data Modeler 2-2
Tareas principales para Data Modeler 2-2

3 Descripción del modelado de datos

Acerca del modelado de datos con Data Modeler 3-1
Planificación de un modelo semántico 3-2
Descripción de los requisitos del modelo semántico 3-2
Componentes de un modelo semántico 3-3
Acerca del modelado de objetos de origen con relaciones de estrella 3-4
Acerca del modelado de objetos de origen con relaciones de copo de nieve 3-4
Acerca del modelado de orígenes desnormalizados 3-5

iii
 Acerca del modelado de orígenes normalizados 3-5

4 Cómo empezar a crear el modelo semántico

Uso de Data Modeler 4-1
Creación de un modelo semántico 4-2
Uso del panel izquierdo de Data Modeler 4-2
Uso del panel derecho de Data Modeler 4-3
Uso de los menús de acción 4-4
Bloqueo de un modelo semántico 4-5
Validación de un modelo semántico 4-5
Refrescamiento y sincronización de objetos de origen y objetos de modelo semántico 4-5
Publicación de cambios en el modelo semántico 4-7
Borrado de datos almacenados en caché 4-8
Cambio de nombre de un modelo semántico 4-9
Conexión de un modelo a una base de datos distinta 4-9
Exportación de un modelo semántico 4-10
Importación de un modelo semántico 4-10
Supresión de un modelo semántico 4-11
Revisión de tablas y datos de origen 4-11
Visualización de objetos de origen 4-12
Vista previa de los datos en objetos de origen 4-12
Creación de vistas de origen 4-13
Acerca de las vistas de origen 4-13
Agregación de vistas de origen propias 4-14
Definición de filtros para vistas de origen 4-16
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico 4-17
Acerca de las tablas de hechos y de dimensiones 4-17
Creación de tablas de hechos y dimensiones desde una vista o tabla única 4-17
Creación de tablas de hechos individuales 4-20
Creación de tablas de dimensiones individualmente 4-21
Edición de tablas de hechos y tablas de dimensiones 4-22
Adición de más columnas a tablas de hechos y de dimensiones 4-23
Adición de columnas de otro origen a una tabla de dimensiones 4-24
Unión de tablas en un modelo semántico 4-24
Acerca de las uniones 4-25
Unión de tablas de hechos y dimensiones 4-25
Creación de una dimensión de tiempo 4-25
Adición de medidas y atributos al modelo semántico 4-27
Edición de medidas y atributos 4-27
Especificación de agregación para medidas en tablas de hechos 4-29

iv
 Creación de medidas calculadas 4-31
Acerca de la creación de medidas calculadas 4-32
Creación de atributos derivados 4-34
Creación de expresiones en el editor de expresiones 4-34
Acerca del editor de expresiones 4-34
Creación de una expresión 4-35
Copia de medidas y atributos 4-36
Copia de objetos del modelo 4-37

5 Definición de jerarquías y niveles para obtención de detalles y

agregación
Flujo de trabajo típico para definir jerarquías y niveles 5-1
Acerca de las jerarquías y los niveles 5-1
Edición de jerarquías y niveles 5-2
Definición de propiedades de la tabla de dimensiones para jerarquías 5-3
Definición de niveles de agregación para medidas 5-3
Acerca de la definición de niveles de agregación para las medidas 5-4

6 Protección del modelo semántico

Flujo de trabajo típico para proteger datos de modelos 6-1
Creación de variables para su uso en expresiones 6-1
Acerca de las variables 6-2
Definición de variables 6-2
Protección del acceso a los objetos del modelo 6-3
Acerca de la herencia de permisos 6-4
Protección del acceso a los datos 6-5

Parte III Creación de modelos de datos para informes de visualización

perfecta

7 Introducción al modelado de datos para informes de visualización

perfecta
Flujo de trabajo típico para modelar datos para informes de visualización perfecta 7-1
Inicio del editor de modelo de datos 7-2
Principales tareas para el modelado de datos para informes de visualización perfecta 7-2

v
8 Uso del editor de modelo de datos
Componentes de un modelo de datos 8-1
Acerca de las opciones de origen de datos 8-2
Funciones del editor del modelo de datos 8-3
Acerca de la barra de herramientas del editor del modelo de datos 8-4
Acerca de la interfaz 8-5
Propiedades de modelo de datos 8-8
Opciones de salida XML 8-11
Fragmentación de datos XML 8-12
Adición de anexos al modelo de datos 8-13
Cómo adjuntar datos de muestra 8-13
Cómo adjuntar un esquema 8-13
Archivos de datos 8-13
Gestión de orígenes de datos privados 8-14

9 Creación de juegos de datos

Creación de un juego de datos 9-1
Creación de juegos de datos utilizando consultas SQL 9-1
Introducción de consultas SQL 9-2
Uso de SQL Query Builder 9-2
Visión general del generador de consultas 9-3
Creación de una consulta mediante Query Builder 9-3
Tipos de columna soportados 9-4
Adición de objetos al panel de diseño 9-4
Eliminación u ocultación de objetos en el panel de diseño 9-5
Condiciones de consulta 9-5
Creación de relaciones entre objetos 9-5
Guardar una consulta 9-7
Edición de una consulta guardada 9-7
Adición de una variable de enlace a una consulta 9-8
Adición de una variable de enlace mediante un editor de texto 9-8
Adición de referencias léxicas a consultas SQL 9-9
Acerca de la definición de consultas SQL de Oracle BI Server 9-11
Definición de consultas SQL de Oracle BI Server 9-12
Creación de un juego de datos con una consulta de MDX con respecto a un origen de
datos de OLAP 9-13
Creación de un juego de datos con una consulta de MDX 9-13
Uso del generador de consultas MDX 9-14
Descripción del proceso de generación de consultas MDX 9-14
Uso del cuadro de diálogo Seleccionar cubo 9-15

vi
 Selección de dimensiones y medidas 9-15
Adición de miembros de dimensión en el eje Divisor/Punto de vista 9-16
Realización de acciones de consulta MDX 9-16
Aplicación de filtros de consulta MDX 9-17
Selección de opciones de consulta MDX y guardado de consultas MDX 9-17
Creación de un juego de datos mediante un análisis 9-18
Notas adicionales sobre juegos de datos de análisis 9-19
Uso de análisis de autoservicio 9-19
Creación de un juego de datos mediante un juego de datos de autoservicio 9-19
Creación de un juego de datos mediante un flujo de datos de autoservicio 9-20
Creación de un juego de datos mediante un servicio web 9-20
Opciones de origen de datos de servicio web 9-20
Creación de un juego de datos mediante un servicio web simple 9-21
Creación de un juego de datos mediante un servicio web complejo 9-21
Información adicional en los juegos de datos de servicio web 9-22
Creación de un juego de datos mediante un archivo XML 9-22
Acerca de los archivos XML soportados 9-22
Carga de un archivo XML almacenado localmente 9-22
Refrescamiento y supresión de un archivo XML cargado 9-23
Creación de un juego de datos mediante Content Server 9-23
Creación de un juego de datos con un archivo Microsoft Excel 9-24
Acerca de los archivos de Excel soportados 9-24
Acceso a varias tablas por hoja 9-25
Uso de un archivo Microsoft Excel almacenado en un origen de datos del directorio de
archivos 9-26
Carga de un archivo Microsoft Excel almacenado localmente 9-27
Refrescamiento y supresión de un archivo de Excel cargado 9-28
Creación de un juego de datos mediante un archivo CSV 9-29
Acerca de los archivos CSV soportados 9-29
Creación de un juego de datos a partir de un archivo CSV almacenado centralmente 9-30
Carga de un archivo CSV almacenado de forma local 9-31
Edición del tipo de dato 9-32
Refrescamiento y supresión de un archivo CSV cargado 9-32
Creación de un juego de datos a partir de una fuente XML HTTP 9-33
Creación de un juego de datos a partir de un juego de datos XML HTTP 9-33
Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo
de datos 9-34
Cómo se devuelven los datos 9-35
Notas adicionales sobre los juegos de datos con datos de la columna CLOB 9-37
Gestión de datos XHTML almacenados en una columna CLOB 9-37
Recuperación de datos XHTML encapsulados en CDATA 9-37
Encapsulamiento de datos XHTML en CDATA en la consulta 9-38

vii
 Prueba de modelos de datos y generación de datos de muestra 9-38
Editar un juego de datos existente 9-39
Inclusión de información de usuario almacenada en variables del sistema en los datos del
informe 9-40
Adición de las variables del sistema de usuario como elementos 9-41
Caso de uso de ejemplo: Límite del juego de datos devuelto por el ID de usuario 9-41
Creación de variables de enlace desde los valores de atributo de usuario de LDAP 9-42

10 Estructuración de datos
Trabajar con modelos de datos 10-1
Acerca de los juegos de datos no relacionados de varias partes 10-1
Acerca de los juegos de datos relacionados de varias partes 10-3
Directrices para trabajar con juegos de datos 10-5
Acerca de la interfaz 10-6
Crear enlaces entre juegos de datos. 10-9
Acerca de los enlaces de nivel de elemento 10-9
Creación de enlaces de nivel de elemento 10-10
Eliminación de enlaces de nivel de elemento 10-10
Suprimir enlaces de nivel de grupo 10-11
Creación de subgrupos 10-11
Movimiento de un elemento entre un grupo principal y un grupo secundario 10-12
Creación de elementos de agregado de nivel de grupo 10-13
Creación de filtros de grupo 10-18
Realización de funciones a nivel de elemento 10-19
Definición de propiedades de elementos 10-19
Ordenar datos 10-20
Realización de funciones de nivel de grupo 10-20
Menú de acciones de grupo 10-21
Edición de juegos de datos 10-21
Eliminación de elementos del grupo 10-21
Edición de propiedades de grupo 10-22
Realización de funciones de nivel global 10-22
Adición de una función de agregado de nivel global 10-23
Adición de un elemento de nivel de grupo o de nivel global por expresión 10-25
Adición de un elemento de nivel global por PL/SQL 10-26
Uso de la vista Estructura para editar la estructura de datos 10-27
Cambio de nombre de elementos 10-27
Adición de un valor para elementos nulos 10-28
Referencia de función 10-28

viii
11 Adición de parámetros y listas de valores
Acerca de los parámetros 11-1
Adición de un nuevo parámetro 11-3
Creación de un parámetro de texto 11-3
Creación de un parámetro de menú 11-4
Personalización de la visualización de parámetros de menús 11-5
Definición de un parámetro de fecha 11-6
Creación de un parámetro de punto de vista (POV) 11-7
Inclusión de un valor de parámetro de PDV en una consulta MDX 11-7
Creación de un parámetro de búsqueda 11-8
Acerca de las listas de valores 11-8
Adición de listas de valores 11-8
Creación de una lista a partir de una consulta SQL 11-9
Creación de una lista desde un juego de datos fijo 11-11
Creación de una lista a partir de una consulta MDX 11-11
Adición de parámetros de campos flexibles 11-12
Requisitos para la utilización de campos flexibles 11-12
Adición de un parámetro de campo flexible y de una lista de valores 11-13
Adición de lista de valores de campo flexible 11-13
Adición del parámetro de menú para la lista de valores de campo flexible 11-14
Uso del parámetro de campo flexible para transferir valores a un campo flexible
definido en el modelo de datos 11-15
Referencia al campo flexible en la consulta SQL 11-16
Transferencia de un rango de valores 11-16

12 Adición de disparadores de eventos

Acerca de los disparadores 12-1
Adición de disparadores de datos Antes de datos y Después de datos 12-2
Orden de ejecución 12-3
Creación de disparadores de programación 12-3

13 Agregar campos flexibles

Acerca de los campos flexibles 13-1
Uso de campos flexibles en su modelo de datos 13-1
Adición de campos flexibles clave 13-2
Introducción de detalles de campo flexible 13-3

ix
14 Adición de definiciones de repartición
Acerca de la repartición 14-1
¿Qué es una definición de depuración? 14-2
Requisitos para agregar definiciones de repartición 14-2
Uso de una consulta SQL para agregar una definición de repartición al modelo de datos 14-2
Asociación de PDF a informes mediante el motor de repartición 14-3
Uso de un juego de datos visualizado para agregar una definición de repartición al modelo
de datos 14-4
Definición de la consulta para la entrega de un archivo XML 14-5
Transferencia de un parámetro a la consulta de repartición 14-9
Definición de los elementos Dividir por y Entregar por para un juego de datos CLOB/XML 14-10
Configuración de un informe para usar una definición de repartición 14-12
Consulta de repartición de ejemplo 14-12
Creación de una tabla para utilizarla como origen de datos de una entrega 14-13

15 Adición de metadatos personalizados para Oracle WebCenter Content

Server
Acerca de la asignación de metadatos personalizados 15-1
Requisitos 15-1
Asignación de campos de datos a campos de metadatos personalizados 15-1
Supresión de campos de metadatos no usados 15-4

16 Mejores prácticas de rendimiento

Información sobre la opción Timeout por defecto de Oracle WebLogic Server 16-1
Mejores prácticas para juegos de datos de SQL 16-1
Solo devuelva los datos que necesite 16-2
Uso de alias de columnas para acortar la longitud del archivo XML 16-2
Evite usar filtros de grupo mediante la mejora de la consulta 16-3
Cómo evitar llamadas PL/SQL en cláusulas WHERE 16-3
Evite usar la tabla dual del sistema 16-3
Cómo evitar llamadas PL/SQL en el nivel de elemento 16-3
Cómo evitar incluir varios juegos de datos 16-4
Evitar juegos de datos anidados 16-4
Evite las consultas en línea como columnas de resumen 16-5
Cómo evitar valores de enlace de parámetros excesivos 16-6
Consejos sobre los parámetros de varios valores 16-6
Agrupación de divisiones y ordenación de datos 16-7
Límite de las listas de valores 16-8
Trabajar con parámetros de fecha 16-9

x
 Ejecución del informe en línea/fuera de línea (programación) 16-9
Definición de propiedades de modelo de datos para evitar errores de memoria 16-9
Timeout de consulta 16-10
Activar eliminación de SQL 16-10
Tamaño de recuperación de base de datos 16-10
Modo escalable 16-10
Ajuste de consultas SQL 16-11
Generación de la explicación del plan 16-11
Explicación del plan para una sola consulta 16-11
Explicación del plan para informes 16-11
Directrices para ajustar las consultas 16-12
Consejos para ajustar la base de datos 16-13
Validación de modelos de datos 16-13
Resultados de validación del modelo de datos 16-13

Parte IV Uso de modelos semánticos de Oracle BI Enterprise Edition

17 Carga de modelos semánticos desde Oracle BI Enterprise Edition

Acerca de la carga de modelos semánticos de Oracle BI Enterprise Edition en la nube 17-1
Preparación del archivo de modelo semántico 17-2
Carga de modelos semánticos desde un archivo .rpd mediante la consola 17-3
Acerca de la edición de modelos semánticos cargados desde Oracle BI Enterprise Edition 17-4
Descarga e instalación de Oracle Analytics Client Tools 17-5
Conexión a un modelo semántico en la nube 17-6
Edición de un modelo semántico en la nube 17-7
Carga de un modelo semántico en la nube 17-8
Conexión a un origen de datos mediante una conexión a la consola 17-8
Conexión a un origen de datos mediante una conexión de datos 17-9
Conexión de un modelo semántico a un origen de datos de Spark 17-10
Trabajo con la herramienta de administración de modelos 17-11
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data
Warehouse 17-11
Visión general de la conexión a las vistas analíticas 17-11
Creación y carga de un modelo semántico basado en una vista analítica 17-12
Conexión a vistas analíticas en Oracle Autonomous Data Warehouse 17-16

Parte V Referencia

xi
A Preguntas frecuentes
Preguntas más frecuentes sobre Data Modeler (modelos semánticos) A-1
Principales preguntas frecuentes para el editor de modelo de datos (informes de impresión
perfecta) A-3

B Solución de problemas
Solución de problemas con Data Modeler B-1
Solución de problemas con la herramienta de administración de modelos (Oracle Analytics
Client Tools) B-3

C Referencia del editor de expresiones

Objetos de modelo semántico C-1
Operadores SQL C-1
Expresiones condicionales C-3
Funciones C-5
Funciones de agregación C-6
Funciones analíticas C-10
Funciones de fecha y hora C-11
Funciones de conversión C-13
Funciones de visualización C-14
Funciones de evaluación C-15
Funciones matemáticas C-16
Funciones de agregado de ejecución C-18
Funciones espaciales C-19
Funciones de cadena C-20
Funciones del sistema C-25
Funciones de serie temporal C-25
Constantes C-28
Tipos C-28
Variables C-28

xii
Prefacio
Descubra cómo modelar datos en Oracle Analytics Cloud.

Temas:
• Destinatarios
• Accesibilidad a la documentación
• Diversidad e inclusión
• Documentos relacionados
• Convenciones

Destinatarios
Modelado de datos empresariales en Oracle Analytics Cloud está pensado para
administradores y analistas de inteligencia empresarial que utilicen Oracle Analytics Cloud:
• Los analistas modelan los datos empresariales y crean libros de trabajo, análisis,
paneles de control e informes de pixelado perfecto para los consumidores. Los analistas
pueden seleccionar visualizaciones interactivas y crear cálculos avanzados para
entender mejor los datos.
• Los administradores editan y cargan modelos de datos creados en Oracle BI Enterprise
Edition en Oracle Analytics Cloud. Los analistas usan los modelos de datos para crear
libros de trabajo, análisis, paneles de control e informes de pixelado perfecto.

Accesibilidad a la documentación
Oracle se compromete a facilitar la accesibilidad.
Para obtener más información sobre el compromiso de Oracle con la accesibilidad, visite el
sitio web del Oracle Accessibility Program en http://www.oracle.com/pls/topic/lookup?
ctx=acc&id=docacc.

Acceso a Oracle Support

Los clientes de Oracle que hayan adquirido servicios de soporte disponen de acceso a
soporte electrónico a través de My Oracle Support. Para obtener más información, visite
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info o, si tiene alguna
discapacidad auditiva, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs.

Diversidad e inclusión
Oracle asume un compromiso absoluto con la diversidad y la inclusión. Oracle respeta y
valora el hecho de contar con una fuerza laboral diversa que aumenta el liderazgo de

xiii
 Prefacio

pensamiento y la innovación. Como parte de nuestra iniciativa para crear una cultura
más inclusiva que tenga un impacto positivo en nuestros empleados, clientes y
partners, estamos trabajando para eliminar términos insensibles de nuestros
productos y nuestra documentación. Además, somos conscientes de la necesidad de
mantener la compatibilidad con la tecnología existente de nuestros clientes y la
necesidad de garantizar la continuidad del servicio a medida que las ofertas y los
estándares industriales de Oracle evolucionan. Debido a estas restricciones técnicas,
nuestro esfuerzo para eliminar términos insensibles llevará tiempo y demandará
cooperación externa.

Documentos relacionados
Para obtener una lista completa de guías, consulte el separador Libros en el centro de
ayuda de Oracle Analytics Cloud.
• http://docs.oracle.com/en/cloud/paas/analytics-cloud/books.html

Convenciones
Este documento utiliza las convenciones de texto e imagen de Oracle estándar.

Convenciones de texto

Convención Significado
negrita El formato de negrita indica elementos de la interfaz gráfica de
usuario asociados a una acción, o bien términos definidos en el
texto o en el glosario.
cursiva El formato de cursiva indica títulos de libros, énfasis o variables de
pendientes de asignación para los que se proporcionan valores
concretos.
espacio sencillo El formato de espacio sencillo indica comandos en un párrafo,
direcciones URL, código en los ejemplos, texto que aparece en la
pantalla o texto que se introduce.

Vídeos e imágenes
Las máscaras y los estilos personalizan el aspecto de Oracle Analytics Cloud, los
paneles de control, los informes y otros objetos. Puede que los vídeos y las imágenes
que se utilizan en esta guía no tengan la misma máscara o el mismo estilo que está
utilizando, pero el comportamiento y las técnicas que se muestran son los mismos.

xiv
Parte I
Introducción al modelado de datos
empresariales
Esta parte ofrece una introducción al modelado de datos en Oracle Analytics Cloud.

Capítulos:
• Acerca del modelado de datos empresariales
1
Acerca del modelado de datos empresariales
Oracle Analytics Cloud ofrece varias herramientas para modelar sus datos empresariales.

Temas:
• Tipos de modelos
• Herramientas de modelado de datos

Tipos de modelos
Puede crear varios modelos semánticos o modelos de datos con Oracle Analytics Cloud.
• Modelos semánticos para libros de trabajo de visualización, análisis y paneles de control
que cree usando Data Modeler o Semantic Modeler (vista previa).
Consulte Uso de Data Modeler para crear modelos semánticos y Uso de Semantic
Modeler para crear modelos semánticos (vista previa).
• Modelos de datos para informes de impresión perfecta que cree con el editor de modelo
de datos.
Consulte Creación de modelos de datos para informes de visualización perfecta.
• Archivos .rpd de modelo semántico de Oracle BI Enterprise Edition que cargue
directamente en Oracle Analytics Cloud o que edite y cargue con la herramienta de
administración de modelos.
Consulte Uso de modelos semánticos de Oracle BI Enterprise Edition.

Herramientas de modelado de datos

Oracle Analytics Cloud ofrece varias herramientas de modelado de datos.

1-1
 Capítulo 1
Herramientas de modelado de datos

Caso de uso Herramientas de modelado de datos

Visualizaciones de datos • Data Modeler
Análisis
Paneles de control
• Semantic Modeler (vista previa)
• Archivo .rpd de modelo semántico de Oracle BI
Informes de visualización • Editor del modelo de datos
perfecta
Modelador de datos basado en el explorador que es
fácil de usar y que ofrece funciones de modelado
simples. Los modelos semánticos se muestran como
áreas temáticas que puede utilizar en
visualizaciones, paneles de control y análisis.
Data Modeler no soporta funciones de modelado
complejas como la federación de varios orígenes o el
redireccionamiento automático de consultas.
Una herramienta de modelado basada en
explorador que permite a los desarrolladores crear
y desplegar modelos semánticos en un archivo .rpd.
Semantic Modeler genera modelos semánticos
mediante el lenguaje de marcado de modelo
semántico (SMML) para que los desarrolladores
tengan libertad para utilizar el editor de modelos
semánticos, el editor SMML u otro editor para
desarrollar modelos semánticos.
Semantic Modeler proporciona integración
completa con Git para facilitar el desarrollo entre
varios usuarios.
Puede utilizar Semantic Modeler para crear modelos
semánticos controlados solamente a partir de
orígenes de datos relacionales. El soporte para otros
orígenes de datos se incluirá en futuras versiones.
Enterprise Edition
– Herramienta de administración de modelos
Si ha modelado previamente los datos de negocio
con Oracle BI Enterprise Edition, no tiene que
empezar desde cero con Data Modeler o Semantic
Modeler. Puede cargar un archivo .rpd de modelo
semántico completo en Oracle Analytics Cloud y
empezar a utilizar inmediatamente las áreas
temáticas en las visualizaciones, los paneles de
control y los análisis.
También puede utilizar la herramienta de
administración de modelos para descargar, editar y
cargar los archivos .rpd de modelo semántico en
Oracle Analytics Cloud.
El editor del modelo de datos le permite combinar
datos de varios juegos de datos en una única
estructura de datos XML para obtener informes de
visualización perfecta.

1-2
Parte II
Uso de Data Modeler para crear modelos
semánticos
En esta parte se describe cómo diseñar, crear y proteger modelos semánticos con Data
Modeler.

Capítulos:
• Introducción a Data Modeler
• Descripción del modelado de datos
• Cómo empezar a crear el modelo semántico
• Definición de jerarquías y niveles para obtención de detalles y agregación
• Protección del modelo semántico
2
Introducción a Data Modeler
En este tema se describe cómo puede acceder y empezar a trabajar con Data Modeler.

Temas:
• Flujo de trabajo típico para modelar datos
• Apertura de Data Modeler
• Tareas principales para Data Modeler

Flujo de trabajo típico para modelar datos

A continuación se detallan las tareas comunes de modelado de datos con Data Modeler.

Tarea Descripción Más información

Consulte información Familiarícese con Data Modeler,
sobre Data Modeler incluida la forma de refrescar los
datos, de publicar cambios y de buscar
los menús de acciones.
Crear un nuevo Inicie un nuevo modelo y conéctelo al
modelo origen de datos.
Examinar objetos de Revise las tablas de origen para
origen determinar cómo estructurar el
modelo semántico.
Crear nuevas vistas en Cree vistas para dimensiones de
la base de datos según representación de roles o para
sea necesario combinar varias tablas en una única
vista, como en orígenes de copo de
nieve o normalizados.
Agregar tablas de Cree tablas de hechos y tablas de
hechos y tablas de dimensiones a partir de objetos de
dimensiones origen.
Unir tablas de hechos Cree uniones entre una tabla de
y dimensiones hechos y una de dimensiones.
Agregar una Cree una tabla de dimensiones de
dimensión de tiempo tiempo y una tabla de origen de base
de datos con datos de tiempo.
Agregar medidas Especifique la agregación para
agregadas y calculadas columnas y cree medidas calculadas
con expresiones.
Agregar atributos Especifique atributos personalizados
derivados para tablas de dimensiones con
expresiones.
Uso de Data Modeler
Creación de un modelo
semántico
Revisión de tablas y datos de
origen
Agregación de vistas de origen
propias
Adición de tablas de hechos y
tablas de dimensiones a un
modelo semántico
Unión de tablas de hechos y
dimensiones
Creación de una dimensión de
tiempo
Adición de medidas y atributos
al modelo semántico
Creación de atributos derivados

2-1
 Capítulo 2
Apertura de Data Modeler

Tarea Descripción Más información

Crear jerarquías y Defina jerarquías y niveles basados en Edición de jerarquías y niveles
niveles las relaciones entre grupos de
columnas de atributos.
Crear variables También puede crear variables que Definición de variables
calculen y almacenen valores
dinámicamente para su uso en
expresiones de columna y filtros de
datos
Configurar permisos Controlar quiénes pueden acceder a Protección del acceso a los
de objeto tablas de hechos, tablas de objetos del modelo
dimensiones y columnas.
Configurar filtros de Defina filtros de seguridad de datos a Protección del acceso a los
seguridad de datos nivel de fila para tablas de hechos, datos
tablas de dimensiones y columnas.
Cargar un archivo .rpd Si ha modelado los datos de negocio Carga de modelos semánticos
de modelo semántico con Oracle BI Enterprise Edition, en desde un archivo .rpd mediante
lugar de crear un modelo semántico la consola
desde cero mediante Data Modeler,
puede usar la consola para cargar y
editar el modelo semántico en la nube.

Apertura de Data Modeler

El administrador le dará acceso a Data Modeler.
1. Conéctese a Oracle Analytics Cloud.
2. Haga clic en el menú Página en la página inicial, y seleccione Abrir Data
Modeler.

3. En la página Modelos, abra un modelo existente o cree uno nuevo.

Tareas principales para Data Modeler

En este tema se identifican las principales tareas para el modelado de datos con Data
Modeler.
• Creación de un modelo semántico
• Revisión de tablas y datos de origen
• Agregación de vistas de origen propias
• Creación de tablas de hechos y dimensiones desde una vista o tabla única
• Creación de tablas de hechos individuales

2-2
 Capítulo 2
Tareas principales para Data Modeler

• Creación de tablas de dimensiones individualmente

• Unión de tablas de hechos y dimensiones
• Creación de medidas calculadas
• Creación de atributos derivados
• Creación de una dimensión de tiempo
• Edición de jerarquías y niveles
• Protección del acceso a los objetos del modelo
• Publicación de cambios en el modelo de datos

2-3
3
Descripción del modelado de datos
Se crea un modelo de los datos de negocio para permitir a los analistas estructurar las
consultas del mismo modo intuitivo que hacen preguntas de negocios.

Vídeo

Temas:
• Acerca del modelado de datos con Data Modeler
• Planificación de un modelo semántico

Acerca del modelado de datos con Data Modeler

Un modelo semántico es un diseño que presenta datos de negocio para su análisis de tal
forma que refleja la estructura del negocio. Los modelos semánticos permiten a los analistas
estructurar las consultas de la misma forma intuitiva en la que hacen preguntas de negocio.
Los modelos bien diseñados son simples y enmascaran la complejidad de la estructura de
datos subyacente.
Con Data Modeler puede modelar datos de varios tipos de origen, como una estrella y un
copo de nieve, de distintas formas que tienen lógica para los usuarios de negocios. Debe
tener el rol Autor de modelo de datos de BI para utilizar Data Modeler.

Nota:
Si ha modelado los datos de negocio con Oracle BI Enterprise Edition, no tiene que
empezar desde cero con Data Modeler. Puede usar la herramienta de
administración de modelos para cargar el archivo .rpd de modelo semántico en la
nube. Consulte Carga de modelos semánticos desde Oracle BI Enterprise Edition.

Aunque no todos los objetos de origen tienen relaciones de estrella, Data Modeler presenta
los datos como una estructura de estrella simple en el modelo semántico. Es decir, el modelo
semántico representa los hechos que se pueden medir y que se ven en términos de distintos
atributos dimensionales.
Al crear un modelo semántico con Data Modeler, realice las siguientes tareas:
• Conéctese a la base de datos que contiene sus datos de negocio.
• Agregue tablas o vistas de origen al modelo y clasifíquelas como tabla de hechos o tabal
de dimensiones.
• Defina uniones entre una tabla de hechos y una de dimensiones
• Asegurarse de que cada tabla de dimensiones se asigna al menos a una tabla de
hechos y de que cada tabla de hechos se asigna al menos a una tabla de dimensiones.

3-1
 Capítulo 3
Planificación de un modelo semántico

• Especificar reglas de agregación para diferentes columnas de hechos, crear

medidas derivadas basadas en expresiones, crear jerarquías de dimensiones
para soportar el detalle y crear medidas basadas en nivel.
• Publicar el modelo semántico para guardar los cambios de forma permanente y
hacer que los datos estén disponibles para usarlos en los análisis.
Después de publicar el modelo semántico, puede empezar a visualizar los datos en la
página inicial de informes de empresa. El modelo semántico se muestra como un área
temática que puede utilizar en visualizaciones, paneles de control y análisis. El
nombre del área temática coincide con el nombre del modelo semántico.
Cuando modela objetos de origen con varias relaciones de estrella, todos forman
parte del mismo modelo semántico y están incluidos en la misma área temática.
¿Puedo utilizar mi archivo. rpd de modelo semántico con Data Modeler?
Sí. En este capítulo se describe cómo se crean modelos semánticos desde cero
mediante Data Modeler. Si ha modelado los datos de negocio con Oracle BI
Enterprise Edition, puede cargar el archivo .rpd de modelo semántico completo en
Oracle Analytics Cloud y empezar a utilizar inmediatamente las áreas temáticas en las
visualizaciones, los paneles de control y los análisis. Consulte Carga de modelos
semánticos desde Oracle BI Enterprise Edition.
Si carga un archivo de modelo semántico existente de esta manera:
• Se desactivará Data Modeler.
Aparecerá el mensaje "Utilice la herramienta de administración de Oracle BI para
gestionar su modelo".
• Puede usar la herramienta de administración de modelos para hacer cambios.
Consulte Edición de un modelo semántico en la nube.

Planificación de un modelo semántico

Antes de empezar a modelar los datos, tómese su tiempo para pensar los requisitos
de su negocio y comprender los conceptos del modelado de datos.

Temas:
• Descripción de los requisitos del modelo semántico
• Componentes de un modelo semántico
• Acerca del modelado de objetos de origen con relaciones de estrella
• Acerca del modelado de objetos de origen con relaciones de copo de nieve
• Acerca del modelado de orígenes desnormalizados
• Acerca del modelado de orígenes normalizados

Descripción de los requisitos del modelo semántico

Antes de poder empezar a modelar los datos, primero debe comprender los requisitos
del modelo semántico:
• ¿Qué tipos de preguntas de negocio va a intentar responder?
• ¿Cuáles son las medidas necesarias para comprender el rendimiento del
negocio?

3-2
 Capítulo 3
Planificación de un modelo semántico

• ¿Cuáles son todas las dimensiones con las que funciona el negocio? O, con otras
palabras, ¿cuáles son las dimensiones utilizadas para desglosar las medidas y
proporcionar cabeceras para los informes?
• ¿Hay elementos jerárquicos en cada dimensión? Y, ¿qué tipos de relaciones definen
cada jerarquía?
Después de haber respondido estas preguntas, podrá identificar y definir los elementos del
modelo de negocio.

Componentes de un modelo semántico

Las tablas de hechos, las tablas de dimensiones, las uniones y las jerarquías son los
componentes clave de un modelo semántico.

Componente Descripción
Tablas de hechos Las tablas de hechos contienen medidas (columnas) que tienen
agregaciones incorporadas en sus definiciones.
Las mediciones agregadas a partir de hechos se deben definir en una
tabla de hechos. Las medidas suelen ser datos calculados como el valor
en dólares o la cantidad vendida, y pueden especificarse en términos de
jerarquías. Por ejemplo, puede que desee determinar la suma de dólares
para un producto específico en un mercado concreto a lo largo de un
período de tiempo determinado.
Cada medida tiene su propia regla de agregación, como SUM, AVG, MIN o
MAX. Puede que un negocio desee comparar valores de una medida y
necesite un cálculo para expresar la comparación.
Tablas de Un negocio utiliza hechos para medir el rendimiento mediante
dimensiones dimensiones correctamente establecidas, por ejemplo, por tiempo,
producto y mercado. Cada dimensión tiene un juego de atributos
descriptivos. Las tablas de dimensiones contienen atributos que
describen entidades de negocio (como Customer Name, Region, Address
o Country).
Los atributos de las tablas de dimensiones proporcionan contexto a los
datos numéricos, como por ejemplo, poder categorizar solicitudes de
servicio. Los atributos almacenados en esta dimensión podrían incluir:
Service Request Owner, Area, Account o Priority.
Las tablas de dimensiones en el modelo se agrupan. En otras palabras,
incluso aunque haya tres instancias de origen distintas de una tabla
Cliente concreta, el modelo solo tiene una tabla. Para lograr esto, las tres
instancias de origen de Customer se combinan en una con las vistas de
base de datos.
Uniones Las uniones indican relaciones entre tablas de hechos y tablas de
dimensiones en el modelo. Al crear uniones, se especifica la tabla de
hechos, la tabla de dimensiones, la columna de hechos y la columna de
dimensiones que desea unir.
Las uniones permiten que las consultas devuelvan filas en las que hay al
menos una coincidencia en ambas tablas.
Consejo: Los analistas pueden utilizar la opción Incluir valores nulos al
crear informes para devolver filas de una tabla cuando no hay filas
coincidentes en otra tabla.

3-3
 Capítulo 3
Planificación de un modelo semántico

Componente Descripción
Jerarquías Las jerarquías son juegos de relaciones descendentes entre los atributos
de la tabla de dimensiones.
En las jerarquías, los niveles se acumulan desde los niveles más bajos
hasta los niveles más altos. Por ejemplo, los meses pueden acumularse
en un año. Estas acumulaciones se producen sobre los elementos de
jerarquía y abarcan las relaciones empresariales naturales.

Acerca del modelado de objetos de origen con relaciones de estrella

Los orígenes de estrella están formados por una o varias tablas de hechos que hacen
referencia a cualquier número de tablas de dimensiones. Debido a que Data Modeler
presenta los datos en una estructura de estrella, trabajar con orígenes de estrella es
el caso de modelado más simple. En orígenes de estrella, las dimensiones se
normalizan con cada una de las dimensiones representadas por una sola tabla.
Por ejemplo, suponga que tiene distintos orígenes para Medidas de ingresos,
Productos, Clientes y Pedidos. En este caso, carga los datos de cada origen en tablas
de bases de datos distintas. A continuación, puede utilizar Data Modeler para crear
una tabla de hechos (Medidas de ingresos) y tablas de dimensiones (Productos,
Clientes y Pedidos). Por último, crea uniones entre las tablas de dimensiones y la
tabla de hechos.
Al crear sus tablas de hechos y de dimensiones, puede arrastrar y soltar los objetos
de origen en el modelo semántico o puede utilizar opciones de menú para crear las
distintas tablas de hechos y de dimensiones individuales.
Consulte Guía básica de modelado de datos para obtener una lista completa de
tareas de modelado de datos.

Acerca del modelado de objetos de origen con relaciones de copo de

nieve
Los orígenes de copo de nieve son similares a los orígenes de estrella. En una
estructura de copo de nieve, sin embargo, las dimensiones se normalizan en varias
tablas relacionadas en lugar de en tablas de una sola dimensión.
Por ejemplo, suponga que tiene distintos orígenes para Medidas de ingresos,
Productos, Clientes y Pedidos. Además, tiene distintos orígenes para Marcas (unidos
a Productos) y Grupo de clientes (unidos a Clientes). Las tablas Marcas y Grupo de
clientes se consideran "divididas en copos de nieve" de las tablas de dimensiones
básicas Clientes y Productos.
En este caso, carga los datos de cada origen en tablas de bases de datos distintas. A
continuación, crea vistas de base de datos que combinan las distintas tablas de
dimensiones en una sola tabla. En este ejemplo, crea una vista que combina
Productos y Marca y otra vista que combina Cliente y Grupo de clientes.
A continuación, utilice Data Modeler para crear una tabla de hechos (Medidas de
ingresos) y tablas de dimensiones (vista Productos + Marca, vista Clientes + Grupo de
clientes y Pedidos). Por último, crea uniones entre las tablas de dimensiones y la tabla
de hechos.

3-4
 Capítulo 3
Planificación de un modelo semántico

Consulte Guía básica de modelado de datos para obtener una lista completa de tareas de
modelado de datos.

Acerca del modelado de orígenes desnormalizados

Los orígenes desnormalizados combinan los hechos y las dimensiones como columnas en
una tabla (o archivo plano). Con un origen plano desnormalizado, se carga un archivo de
datos en una tabla. El archivo de datos consta de atributos de dimensión y columnas de
medidas.
En algunos casos, el modelo semántico podría estar compuesto por un modelo híbrido que
implicara una combinación de orígenes de estrella, copo de nieve y desnormalizados. Por
ejemplo, un origen desnormalizado podría incluir información sobre medidas de ingresos,
productos, clientes y pedidos, pero todo en un solo archivo, en lugar de en distintos archivos
de origen.
En este caso, primero se carga el archivo desnormalizado como una sola tabla de base de
datos. A continuación, se utiliza el asistente de Agregar al modelo para particionar las
columnas en varias tablas de hechos y dimensiones. En este ejemplo, se arrastran y se
sueltan las columnas de medidas de ingresos para crear una tabla de hechos y, a
continuación, se arrastran y se sueltan las columnas para productos, clientes y pedidos para
crear tres tablas de dimensiones distintas. Por último, crea uniones entre las tablas de
dimensiones y la tabla de hechos.
Consulte Guía básica de modelado de datos para obtener una lista completa de tareas de
modelado de datos.

Acerca del modelado de orígenes normalizados

Los orígenes normalizados o transaccionales distribuyen los datos en varias tablas para
minimizar la redundancia de almacenamiento de datos y optimizar las actualizaciones de
datos. En un origen normalizado, tiene varios archivos de datos que corresponden a cada
una de las tablas transaccionales. Es probable que los datos de las aplicaciones de Oracle
Cloud se particionen en un origen normalizado.
De forma similar a los orígenes de copo de nieve, el modelado de orígenes normalizados
implica la creación de vistas de base de datos para combinar columnas de varias tablas de
origen en tablas de hechos y dimensiones individuales. Algunos orígenes normalizados son
muy complejos y necesitan varias vistas de base de datos para organizar los datos en un
modelo de tipo estrella.
Por ejemplo, suponga que tiene archivos de origen para Products, Customers, Orders y
Order Items. Tanto Orders como Order Item contienen hechos.
En este caso, primero se cargan los archivos como tablas de bases de datos
independientes. A continuación, crea una vista de base de datos que combina varias
columnas de hechos en una única tabla. En este ejemplo, crea una vista que combina
columnas de Orders y Order Items.
A continuación, utilice Data Modeler para crear una tabla de hechos (vista Orders + Order
Items) y tablas de dimensiones (Products y Customers). Por último, crea uniones entre las
tablas de dimensiones y la tabla de hechos.
Consulte Guía básica de modelado de datos para obtener una lista completa de tareas de
modelado de datos.

3-5
4
Cómo empezar a crear el modelo semántico
En esta sección se proporciona información sobre cómo realizar los primeros pasos para
crear un modelo semántico, como agregar tablas de dimensiones, tablas de hechos y
uniones.

Vídeo

Temas:
• Flujo de trabajo típico para modelar datos
• Uso de Data Modeler
• Revisión de tablas y datos de origen
• Agregación de vistas de origen propias
• Adición de tablas de hechos y tablas de dimensiones a un modelo semántico
• Unión de tablas de hechos y dimensiones
• Creación de una dimensión de tiempo
• Adición de medidas y atributos al modelo semántico
• Copia de objetos del modelo

Uso de Data Modeler

Data Modeler permite modelar los datos necesarios para realizar informes.

Temas:
• Apertura de Data Modeler
• Creación de un modelo semántico
• Uso del panel izquierdo de Data Modeler
• Uso del panel derecho de Data Modeler
• Uso de los menús de acción
• Bloqueo de un modelo semántico
• Validación de un modelo semántico
• Refrescamiento y sincronización de objetos de origen y objetos de modelo semántico
• Publicación de cambios en el modelo semántico
• Borrado de datos almacenados en caché
• Cambio de nombre de un modelo semántico
• Conexión de un modelo a una base de datos distinta
• Exportación de un modelo semántico

4-1
 Capítulo 4
Uso de Data Modeler

• Importación de un modelo semántico

• Supresión de un modelo semántico

Creación de un modelo semántico

Cree un nuevo modelo semántico desde cero en Data Modeler.

Vídeo
1. Abra Data Modeler.
2. Haga clic en Crear modelo.
3. Introduzca un nombre y una descripción para el modelo semántico.
El área temática asociada a este modelo recibe el mismo nombre.
4. Conecte el modelo a una base de datos.
Si la base de datos que desea no aparece en la lista, solicite al administrador que
configure la conexión en su lugar.

Uso del panel izquierdo de Data Modeler

Hay disponibles varios menús de modelado de datos en el panel izquierdo de Data
Modeler.
• Base de datos : muestra los objetos de origen como tablas y vistas de base de
datos
• Modelo de datos: muestra objetos de modelo como tablas de hechos, tablas de
dimensiones, jerarquías, columnas de hechos y columnas de dimensiones
• Variables : muestra variables para su uso en filtros de seguridad de datos y en
expresiones de columna
• Roles : muestra roles que puede utilizar al definir permisos de objetos y filtros de
seguridad de datos
Filtre una lista para encontrar exactamente lo que desea.
1. En Data Modeler, en el panel izquierdo, abra el menú Base de datos, Modelo de
datos, Variables o Roles.
2. Haga clic en el icono Filtrar a la derecha del menú seleccionado.

4-2
 Capítulo 4
Uso de Data Modeler

3. En el área Filtrar, introduzca un valor de cadena para filtrar la visualización.

4. Suprima el texto o vuelva a hacer clic en el icono Filtrar para eliminar el filtro.

Uso del panel derecho de Data Modeler

El panel de la derecha de Data Modeler es un panel contextual que cambia en función de la
tarea que esté realizando. Una vez empezado el modelado de datos, la vista por defecto o
inicial muestra las tablas de hechos, las tablas de dimensiones y las uniones definidas hasta
el momento.

4-3
 Capítulo 4
Uso de Data Modeler

• En el área de las tablas de hechos y las tablas de dimensiones, puede ver el

número de uniones de cada tabla de hechos y de dimensiones, así como el
número de medidas en cada tabla de hechos.

• Las uniones se muestran bajo las tablas de hechos y de dimensiones. Haga clic
en la flecha arriba o abajo de cada cabecera de columna para ordenar.

• Al hacer clic en un objeto para abrir su editor, el editor aparece en el panel

derecho. Por ejemplo, al hacer clic en el nombre de una tabla de dimensiones del
menú Modelo de datos del panel izquierdo, se abre el editor de tablas de
dimensiones en el panel derecho.
• Abra el separador Permiso para controlar quién tiene acceso al modelo y quién
puede crear informes desde el área temática asociada.

• Abra el separador Propiedades para renombrar el modelo, o bien para conectarlo

a una base de datos diferente.

Uso de los menús de acción

Data Modeler proporciona menús de acción para la mayoría de los objetos. Al
seleccionar un objeto, aparecerá un icono de engranaje que muestra el menú ( ).

El menú global Acciones de modelo de la esquina superior derecha le permite

borrar, cerrar, refrescar o desbloquear el modelo.
También puede utilizar los menús de acciones para suprimir objetos individuales que
haya bloqueado.
• Puede suprimir vistas de origen, pero no se pueden suprimir tablas de origen.
Utilice el Taller de SQL para borrar tablas de la base de datos de origen.
• No se pueden suprimir objetos de modelo de los que dependan otros objetos.

4-4
 Capítulo 4
Uso de Data Modeler

Bloqueo de un modelo semántico

Debe bloquear el modelo semántico antes de realizar algún cambio. Haga clic en Bloquear
para editar para bloquear el modelo semántico.

Consejos:
• Publique los cambios regularmente (en los exploradores se produce un timeout después
de 20 minutos de inactividad).
• Publique los cambios antes de cerrar el explorador para asegurarse de que se libera el
bloqueo.
• Bloquee el modelo antes de cambiar las vistas.
• Si tiene privilegios administrativos, puede sustituir los bloqueos definidos por otros
usuarios.

Validación de un modelo semántico

Puede utilizar el icono de marca de control global Validar en la esquina superior izquierda
para comprobar si el modelo semántico es válido.
El modelo semántico también se valida automáticamente al publicar cambios. Los errores de
validación se muestran en la parte inferior del panel derecho.

Utilice el menú Acciones de mensajes para personalizar los tipos de mensajes que se
muestran (errores, advertencias e información).
Algunas tareas se validan cuando se realizan. Por ejemplo, no puede guardar una vista de
origen, a menos que su consulta SQL sea válida. Las expresiones para las medidas
calculadas y las columnas derivadas deben ser válidas para poder guardarlas. Los mensajes
de validación que se muestran conforme está realizando tareas proporcionan más
información sobre cualquier error de validación.

Refrescamiento y sincronización de objetos de origen y objetos de modelo

semántico
Data Modeler proporciona tres formas de refrescar los datos para garantizar que consulta la
información más actualizada. Puede refrescar los objetos de origen, refrescar el modelo

4-5
 Capítulo 4
Uso de Data Modeler

semántico o sincronizar el modelo semántico con las definiciones del objeto de origen
en la base de datos.
Refrescamiento de objetos de origen
Puede refrescar el panel Base de datos para garantizar que la lista de objetos de
origen refleja los objetos más recientes en la base de datos. Por ejemplo, puede
refrescar la lista de objetos de origen para incluir cualquier tabla de base de datos
nueva que se haya agregado. La lista de objetos de origen no se refresca
automáticamente una vez que se cargan los nuevos objetos en la base de datos.
Para refrescar objetos de origen, seleccione Refrescar en el menú Acciones de
base de datos del panel izquierdo.

Refrescamiento del modelo semántico

En algunos casos, otros usuarios de Data Modeler pueden haber bloqueado el
modelo y haber realizado cambios. Puede refrescar el modelo semántico para
garantizar que Data Modeler muestra la versión más reciente del modelo.
Para refrescar el modelo semántico, seleccione Refrescar en el menú Acciones de
modelo de datos del panel izquierdo.
También puede seleccionar Refrescar modelo en el menú con el icono de engranaje
Acciones de modelo junto al botón Bloquear para editar.
Sincronización con la base de datos
Puede sincronizar el modelo semántico con objetos de origen en la base de datos. La
sincronización identifica los objetos en el modelo que se han suprimido en la base de
datos, así como las tablas y columnas que son nuevas. También identifica otras
discrepancias como los tipos de datos de columna que no coinciden.
Para sincronizar todos los objetos de modelo y los objetos de origen con la base de
datos, seleccione Sincronizar con base de datos en el menú Acciones de modelo
global en la esquina superior derecha.
Para sincronizar tablas de hechos o tablas de dimensiones individuales, seleccione
Sincronizar con base de datos en el menú Acciones de la tabla de hechos o tabla
de dimensiones determinada en la lista de objetos de modelo de datos del panel
izquierdo. A continuación, haga clic en Aceptar.
Debe bloquear el modelo semántico para sincronizar con la base de datos.

4-6
 Capítulo 4
Uso de Data Modeler

Las discrepancias de sincronización se muestran en un cuadro de mensajes en la parte

inferior del panel derecho. Utilice el menú Acciones de mensajes para personalizar los tipos
de mensajes mostrados (errores, advertencias e información), seleccione o anule la
selección de todos los mensajes y realice acciones de sincronización en los mensajes
seleccionados. Por ejemplo, puede seleccionar todas las advertencias de tipos de datos que
no coinciden y, a continuación, seleccionar Sincronización seleccionada en el menú
Acciones para realizar los cambios de sincronización correspondientes.

Publicación de cambios en el modelo semántico

Al actualizar un modelo semántico, se realizan cambios que puede guardar o desechar.
Publique un modelo para guardar los cambios permanentemente y que los datos estén
disponibles para su uso en informes. El modelo semántico publicado se muestra como un
área temática.

Sugerencia:
Aunque los cambios en el modelo semántico se guardan como el trabajo del
usuario, solo se guardan en la sesión del explorador. Los cambios no se guardan
realmente hasta que se publica el modelo.

Cuando se publica un modelo semántico, se valida automáticamente. Cualquier error de

validación aparecerá en la parte inferior del panel derecho. Si ve errores de validación,
soluciónelos y vuelva a intentar publicar el modelo semántico de nuevo.

4-7
 Capítulo 4
Uso de Data Modeler

Después de realizar cambios en el modelo semántico, puede realizar estas acciones

mediante los menús de la esquina superior derecha:
• Publicar y desbloquear: verifica que el modelo es válido, guarda los cambios y
publica el modelo para su uso en informes. El modelo está desbloqueado para
otros usuarios.
• Publicar y mantener bloqueo: verifica que el modelo es válido, guarda los
cambios y publica el modelo para su uso en informes. Se mantiene el bloqueo
para posteriores ediciones.
• Desbloquear : elimina el bloqueo del modelo, de forma que otros usuarios lo
puedan actualizar. Los cambios no publicados realizados en el modelo se
desechan.
• Revertir : devuelve el modelo a su estado de publicación anterior. Los cambios no
publicados realizados en el modelo se desechan, pero el modelo permanece
bloqueado.
• Borrar: suprime permanentemente todos los objetos del modelo y los elimina de
todos los informes basados en el área temático del modelo.
También puede hacer clic en Deshacer y Rehacer en la esquina superior derecha
para revertir o volver a aplicar los cambios individuales.

Sugerencia:
No es necesario publicar el modelo para guardar los cambios en la base de
datos. Los cambios realizados en las vistas de la base de datos y otros
objetos de base de datos de origen se guardan en la base de datos al
realizar la acción, no en el modelo semántico. Para cambios de base de
datos, no están disponibles Deshacer y Rehacer.

Después de publicar el modelo, espere unos dos minutos para que los cambios
realizados en el modelo semántico se reflejen en los informes y paneles de control.
Para ver los cambios inmediatamente, abra el informe y haga clic en Refrescar y, a
continuación, en Recargar metadatos del servidor.
Oracle Analytics Cloud realiza una instantánea cuando usted o alguna otra persona
publican cambios en el modelo semántico. Si está teniendo algún problema con el
último modelo semántico, puede pedirle al administrador que restaure una versión
anterior.

Borrado de datos almacenados en caché

Oracle Analytics Cloud almacena en caché los datos para maximizar el rendimiento.
Esto significa que es posible que las actualizaciones de datos no se reflejen de forma
inmediata en los informes y Data Modeler.
Después de cargar datos nuevos en las tablas, puede que desee borrar la caché para
ver los datos más recientes.
• Para ver los datos nuevos en Data Modeler, seleccione el menú Refrescar
modelo.
• Para ver los datos nuevos en los informes, borre manualmente la caché del menú
Modelo de datos del panel izquierdo

4-8
 Capítulo 4
Uso de Data Modeler

– Para borrar los datos almacenados en caché para una tabla de dimensiones o de
hechos particular, haga clic con el botón derecho en la tabla y seleccione Borrar
datos almacenados en caché.
– Para borrar todos los datos almacenados en caché, haga clic en Acciones de
modelo de datos y, a continuación, seleccione Borrar todos los datos
almacenados en caché para eliminar todos los datos de la caché.
También puede seleccionar Borrar todos los datos almacenados en caché en el menú
global Acciones de modelo de la esquina superior derecha.

Sugerencia:
Borre siempre la caché después de cargar los datos nuevos para asegurarse de
que en los informes aparecen los datos más recientes.

Cambio de nombre de un modelo semántico

Para cambiar el nombre de un modelo semántico, bloquéelo, seleccione el separador
Propiedades y cambie el nombre.
Esta acción también permite cambiar el nombre del área temática correspondiente de los
informes.

Conexión de un modelo a una base de datos distinta

Cuando inicie un nuevo modelo semántico, se lo solicitará que seleccione la base de datos
en la que están almacenados los datos. Todas las tablas y vistas de esta base de datos se
muestran en Data Modeler para que pueda agregarlas al modelo. En ocasiones, se mueven
los datos o cambia la base de datos de origen. Si esto sucede, cambie la conexión de la
base de datos del modelo.
Si cambia la base de datos, los informes basados en el área temática del modelo no
funcionarán a menos que todos los objetos de origen necesarios estén disponibles en la
nueva base de datos.
1. En Data Modeler, bloquee el modelo para que no se pueda editar.

4-9
 Capítulo 4
Uso de Data Modeler

2. Haga clic en el separador Propiedades.

3. Seleccione la base de datos.
Si la lista no muestra la base de datos que busca, pídale al administrador que le
configure una conexión.

4. Sincronice el modelo semántico con la nueva base de datos. Seleccione

Sincronizar con base de datos en el menú Acciones de modelo.

Exportación de un modelo semántico

Los modelos semánticos individuales se pueden exportar a un archivo JSON y la
información se puede importar a otro servicio. Si desea implantar pequeños cambios
en el modelo, puede editar el archivo JSON antes de importarlo. Por ejemplo, puede
que desee cambiar el nombre del modelo (modelDisplayName) o la conexión de base
de datos (connectionName).

1. Abra Data Modeler.

2. En la página Modelos, haga clic en el icono Acciones de modelo para el modelo
que desea exportar y seleccione Exportar.
3. Guarde el archivo JSON. El nombre por defecto es model.json.

Importación de un modelo semántico

Los modelos semánticos individuales se pueden exportar a un archivo JSON y la
información se puede importar a otro servicio. Si desea implantar pequeños cambios
en el modelo, puede editar el archivo JSON antes de importarlo. Por ejemplo, puede
que desee cambiar el nombre del modelo (modelDisplayName) o la conexión de base
de datos (connectionName).

Para que un modelo semántico funcione correctamente, debe disponer de acceso a

las tablas de bases de datos asociadas. Antes de importar el modelo semántico,
asegúrese de que Data Modeler puede conectarse a la base de datos indicada. Si no
es así, solicite a su administrador que configure la conexión.

4-10
 Capítulo 4
Revisión de tablas y datos de origen

1. Abra Data Modeler.

2. Haga clic en Importar modelo.
3. Acceda al archivo JSON que contiene el modelo semántico que desea importar.
4. Haga clic en Aceptar.
5. Opcional: Seleccione una conexión de base de datos para el modelo.
Si Data Modeler no reconoce el nombre de conexión del archivo JSON, se le pedirá que
seleccione una conexión de base de datos. Si la conexión que busca no aparece en la
lista, solicite al administrador que la configure e inténtelo de nuevo.
6. Opcional: Indique si desea sustituir un modelo semántico con el mismo nombre. Haga
clic en Sí para sobrescribir el modelo, o en No para cancelar la acción.
Esto ocurre cuando el modelo mencionado en el archivo JSON entra en conflicto con
otro modelo en Data Modeler. Si no desea sustituir el modelo existente, cambie el
atributo modelDisplayName en el archivo JSON e inténtelo de nuevo.

Supresión de un modelo semántico

Puede suprimir todos los objetos del modelo semántico si desea borrar el modelo y empezar
de nuevo. O puede suprimir un modelo completo junto con su área temática.
• Borrado de contenido de modelo: Bloquee el modelo y seleccione Borrar modelo del
menú Acciones de modelo global en la esquina superior derecha.
Esta acción elimina permanentemente todos los objetos en el modelo semántico y
también los elimina de cualquier informe que se base en el área temática del modelo.
• Supresión de un modelo: Haga clic en Data Modeler y, a continuación, en el menú
Acciones de modelo del modelo que no desee y seleccione Suprimir.
Esta acción elimina de forma permanente el modelo semántico y su área temática.
Antes de borrar o suprimir un modelo, se recomienda que el usuario o el administrador
realicen una instantánea del modelo como copia de seguridad

Revisión de tablas y datos de origen

En este tema se describe cómo puede obtener más información sobre los objetos de la base
de datos de origen que están disponibles para su modelo semántico.

Temas:
• Visualización de objetos de origen
• Vista previa de los datos en objetos de origen

4-11
 Capítulo 4
Revisión de tablas y datos de origen

Visualización de objetos de origen

Puede ver una lista de tablas y vistas de origen en el menú Base de datos en el panel
izquierdo. Haga clic en una tabla o vista para ver sus propiedades.

El separador Visión general de las tablas y vistas de origen muestra información de

columna, como el nombre de la columna, el tipo de dato, si es única y si acepta
valores nulos.

Vista previa de los datos en objetos de origen

Puede obtener una vista previa de las primeras 25 filas de datos de las vistas y tablas
de la base de datos. Al revisar las filas iniciales, puede obtener ideas para modelar las
vistas y tablas de base de datos como tablas de dimensiones o como tablas de
hechos.

1. Abra Data Modeler.

2. En el menú Base de datos del panel izquierdo, haga clic en una vista o tabla de
base de datos para abrirla.
3. Haga clic en el separador Datos.
4. Revise las primeras 25 filas de datos de la tabla o vista. Si es necesario, puede
ajustar el tamaño de las columnas en la tabla de visualización.

4-12
 Capítulo 4
Creación de vistas de origen

5. Haga clic en Obtener recuento de filas para recuperar un recuento de filas completo de
la tabla o vista. Esta operación puede tardar en completarse si la tabla es grande.
6. Haga clic en Listo.

Creación de vistas de origen

Cree vistas de origen como base para los objetos del modelo si cree que va a realizar
cambios posteriores.

Temas:
• Acerca de las vistas de origen
• Agregación de vistas de origen propias
• Definición de filtros para vistas de origen

Acerca de las vistas de origen

Las vistas de origen son consultas de datos guardadas en la base de datos. Puede
considerar que una vista de origen es como una "tabla virtual".
Puede crear vistas de origen cuando utilice una sola tabla como origen para más de una
tabla de dimensiones. Por ejemplo, puede crear vistas de origen que utilizan la tabla de
origen Employee como origen de las tablas de dimensiones Employee y Manager.
También se crean vistas de origen al crear una tabla de dimensiones que se basa en varias
tablas de origen, como en un origen de copo de nieve. Por ejemplo, puede crear una vista de
origen que combine columnas de tablas de origen Customer y Customer Group para crear
una sola tabla de dimensiones Customers.
También puede realizar cálculos de agregación previa en una vista de origen. Por ejemplo,
para crear una columna Average Revenue que sea una agregación previa calculada, puede
incluir el cálculo en la consulta SQL para la vista:
SELECT
"BICS_REVENUE_FT1"."UNITS",
"BICS_REVENUE_FT1"."ORDER_KEY",
"BICS_REVENUE_FT1"."REVENUE",
"BICS_REVENUE_FT1"."PROD_KEY",
"BICS_REVENUE_FT1"."REVENUE"/"BICS_REVENUE_FT1"."UNITS" AS AVERAGE_REVENUE
FROM
"BICS_REVENUE_FT1"

En general, cree vistas de origen como base para objetos de modelo cuando piense que
puede desear realizar cambios posteriores. La creación de un modelo semántico basado en
vistas de origen proporciona una mayor flexibilidad que el uso de tablas de origen
directamente. Por ejemplo, el uso de vistas de origen facilita en gran medida la ampliación
de objetos de modelo, la creación de filtros y la adición de cálculos agregados previamente.

4-13
 Capítulo 4
Creación de vistas de origen

Agregación de vistas de origen propias

Puede agregar vistas a la base de datos origen desde Data Modeler. Por ejemplo,
puede crear una vista de origen que combine las tablas de origen Brands y Products
para crear un origen único para la tabla de dimensiones.
Cree vistas de origen como base para los objetos del modelo si cree que va a realizar
cambios posteriores. Puede crear una nueva vista y agregar cualquier columna que
desee de otras tablas y vistas de la base de datos. También puede crear una vista
mediante la copia de una tabla de origen existente u otra vista de origen.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el menú Base de datos del panel izquierdo, haga clic en Acciones y, a
continuación, en Crear vista.

Inicialmente, la vista está vacía. Puede agregar cualquier columna que desee de
otras tablas y vistas de la base de datos.

Sugerencia:
Para crear una vista a partir de una vista o tabla de origen existente,
vaya al objeto de base de datos que desea copiar, haga clic en
Acciones y, a continuación, en Duplicar.

3. En el editor de vistas, especifique un nombre y descripción para la vista. También

puede anular la selección de Eliminar filas duplicadas si desea incluir las filas
duplicadas en la vista.

4. Agregue columnas a la vista de base de datos arrastrando y soltando tablas o

vistas del menú Base de datos en el área Columnas del editor de vista.
También puede hacer clic en Agregar columnas, seleccionar una vista o tabla de
base de datos de origen y, a continuación, hacer clic en Agregar.

4-14
 Capítulo 4
Creación de vistas de origen

5. Si es necesario, defina alias para las columnas. También puede mover filas hacia arriba
o hacia abajo con el menú Acción para una fila específica.
6. En el separador Uniones, puede definir uniones para la vista. Haga clic en Crear unión y
especifique la tabla de la izquierda, la tabla de la derecha, las columnas y el tipo de
unión. Debe incluir más de una tabla de origen en la vista para crear uniones.
7. En el separador Filtros, puede definir filtros para la vista.
8. En el separador Consulta SQL, revise el código para la consulta SQL de la vista de
origen.

Puede editar el código SQL para la consulta aquí, pero hágalo solo si está familiarizado
con él. La introducción de código SQL no válido puede producir resultados inesperados.
Si edita la consulta SQL directamente, las actualizaciones simples se reflejarán en los
separadores Visión general, Unión y Filtros y puede utilizar estos separadores para
editar la vista posteriormente. Por ejemplo, puede incluir:
• Una cláusula SELECT simple con alias y la palabra clave DISTINCT
• Cláusula FROM con uniones
• Cláusula WHERE con condiciones de filtro combinadas con la palabra clave AND
Si utiliza el separador Consulta SQL para realizar cambios de código avanzados, no
puede utilizar los separadores Visión general, Uniones o Filtros para editar la vista
posteriormente. Por ejemplo, si incluye:
• Funciones de agregación SQL, cláusula GROUP BY, cláusula HAVING

4-15
 Capítulo 4
Creación de vistas de origen

• Cláusula ORDER BY
• Palabra clave OR en la cláusula WHERE
9. Opcional: Haga clic en el separador Datos para obtener una vista previa de las
primeras 25 filas de datos. También puede obtener un recuento de filas completo.
Es mejor ver los datos después de definir uniones entre todas las tablas para
obtener un mejor rendimiento.
10. Haga clic en Guardar y cerrar.

Definición de filtros para vistas de origen

Un filtro especifica los criterios que se aplican a las columnas para limitar los
resultados que se devuelven. En otras palabras, un filtro es la cláusula WHERE para la
sentencia VIEW. Por ejemplo, puede definir un filtro donde País de cliente sea igual a
Estados Unidos.

1. Cree una vista.

2. Haga clic en el separador Filtros.
3. Haga clic en Crear filtro.
4. En la fila WHERE, seleccione en primer lugar la columna para el filtro. A
continuación, seleccione la condición, como "es distinto de" o "es mayor que".
Por último, especifique el valor del filtro. Puede especificar una variable si es
necesario.

5. Opcional: Haga clic en Crear filtro para agregar una fila "y" al filtro. Especifique la
columna, la condición y el valor. Repita esta operación según sea necesario.
6. Para eliminar una fila, haga clic en Acciones y, a continuación, seleccione
Suprimir.

7. Haga clic en Guardar.

4-16
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

Adición de tablas de hechos y tablas de dimensiones a un

modelo semántico
Utilice tablas de hechos y tablas de dimensiones para representar aspectos del negocio que
desea comprender mejor.

Temas:
• Acerca de las tablas de hechos y de dimensiones
• Creación de tablas de hechos y dimensiones desde una vista o tabla única
• Creación de tablas de hechos individuales
• Creación de tablas de dimensiones individualmente
• Edición de tablas de hechos y tablas de dimensiones
• Adición de más columnas a tablas de hechos y de dimensiones

Acerca de las tablas de hechos y de dimensiones

Las tablas de hechos y de dimensiones contienen las columnas que almacenan los datos
para el modelo:
• Las tablas de hechos contienen medidas, que son columnas con agregaciones
incorporadas en sus definiciones. Por ejemplo, Revenue y Units son columnas de
medidas.
• Las tablas de dimensiones contienen atributos que describen las entidades de negocio.
Por ejemplo, Customer Name, Region y Address son columnas de atributos.
Las tablas de hechos y de dimensiones representan los aspectos del negocio que desea
entender mejor. Consulte Componentes de los modelos de datos.
Antes de empezar el modelado de tablas de hechos y de dimensiones, asegúrese de que los
datos que necesita modelar están disponibles en la lista de tablas de origen. Asegúrese
también de que ha creado las vistas de origen en las que se deben basar los objetos de
modelo.
Si cree que la lista de objetos de origen de la base de datos ha cambiado desde que abrió
Data Modeler, puede hacer clic en Refrescar en el menú Acciones de base de datos. Si
los datos que necesita no se han cargado aún en la base datos, puede cargarlos.

Creación de tablas de hechos y dimensiones desde una vista o tabla única

Algunas tablas de origen contienen tanto hechos como dimensiones. Para estas tablas de
origen, Data Modeler proporciona un asistente que le ayudará a particionar las columnas de
hechos y dimensiones en tablas de hechos y de dimensiones.

Vídeo
Por ejemplo, puede darse el caso de que tenga un origen que contenga atributos de
producto y de cliente, así como medidas de ingresos. Utilice el asistente para crear las tablas
de hechos y de dimensiones correspondientes.
1. En Data Modeler, bloquee el modelo para editarlo.

4-17
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

2. En el menú Base de datos del panel izquierdo, haga clic con el botón derecho en
la tabla de origen que contiene los datos de hechos y dimensionales que desea
modelar y seleccione Agregar al modelo y, a continuación, Agregar como
tablas de hechos y dimensiones.

3. Para permitir que Data Modeler sugiera algunas tablas de hechos, tablas de
dimensiones y uniones para la tabla de origen, seleccione Permitir a Data
Modeler realizar recomendaciones y haga clic en Aceptar. Puede revisar las
sugerencias en el paso 4.
Si prefiere elegir tablas de hechos y de dimensiones usted mismo desde cero:
a. Anule la selección Permitir a Data Modeler realizar recomendaciones y
haga clic en Aceptar.
b. Arrastre medidas desde la tabla de origen hasta la tabla de hechos.

Sugerencia:
También puede hacer clic en el icono Más del área de la cabecera
de columna para seleccionar una columna para incluirla en la tabla
de hechos.

c. Introduzca un nombre para la tabla de hechos, como Costos o Medidas.

d. Agregue una tabla de dimensiones para cada grupo de atributos relacionados
e introduzca un nombre significativo, como Productos. Arrastre y suelte las
columnas relacionadas desde la tabla de origen hasta la tabla de dimensiones
adecuada.

4-18
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

e. Para agregar más tablas de dimensiones, haga clic en Agregar y repita el paso
anterior.
f. Para suprimir una tabla de dimensiones, haga clic en la X junto al nombre de tabla.
g. Especifique las columnas de unión para cada una de las tablas de dimensiones.
Active las casillas situadas junto a las columnas adecuadas para marcar dichas
columnas como columnas de unión.
Si falta la columna de unión que seleccione en la tabla de hechos, se agregará la
columna correspondiente a la tabla de hechos automáticamente.

4. Revise las tablas de hechos, las tablas de dimensiones y las columnas de unión. Por
ejemplo:
• Cambie el nombre de las tablas de hechos y de dimensiones.
• Agregue o elimine columnas.
• Agregue, suprima o fusione tablas de dimensiones.
• Mueva columnas de una tabla de dimensiones a otra.
5. Haga clic en Siguiente.
6. Revise los objetos que se van a crear.

7. Haga clic en Crear.

8. Haga clic en Listo.
Se mostrarán las tablas de hechos, tablas de dimensiones y uniones nuevas en Data
Modeler. Aparecerán nuevas vistas en el panel Base de datos.

4-19
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

Creación de tablas de hechos individuales

Puede agregar tablas de origen individuales que contengan datos de hechos al
modelo semántico.
Si tiene distintas tablas de origen con datos de hechos, como en un origen de estrella,
puede agregarlas al modelo semántico individualmente. Por ejemplo, si tiene una
tabla de origen que solo contiene medidas de ingresos, puede utilizar este método
para crear la tabla de hechos correspondiente.
También puede tener orígenes con información de hechos distribuida en varias tablas,
como orígenes transaccionales normalizados. En este caso, cree primero vistas de
origen para combinar tablas de forma que se parezca a un modelo en estrella. Para
obtener más información sobre la creación de vistas, consulte Agregación de vistas de
origen propias. Para obtener más información sobre el modelado de los diferentes
tipos de vistas, consulte Planificación de un modelo semántico.

Sugerencia:
Cree vistas de origen como base para el modelado de objetos si cree que va
a realizar cambios posteriores como la ampliación del modelo de objetos, la
creación de filtros y la adición de cálculos anteriores a la agregación. La
creación de una tabla de hechos basada en vistas de origen proporciona
mayor flexibilidad que el uso de tablas de origen directamente.

Cuando utilice este método para crear tablas de hechos individuales, todas las
columnas de la tabla o vista de origen se asignarán a una sola tabla de hechos y, si el
origen tiene relaciones con otras tablas o vistas, se le ofrecerá la posibilidad de
agregarlas al modelo.
Después de bloquear el modelo, realice una de las siguientes acciones para crear
tablas de hechos de forma individual:
• Arrastre la tabla o vista de origen del menú Base de datos del panel izquierdo al
área Tablas de hechos del modelo semántico.
• En el menú Base de datos del panel izquierdo, haga clic con el botón derecho en
la tabla o vista y, a continuación, haga clic en Agregar al modelo y en Agregar
como tabla de hechos.
• En el menú Base de datos del panel izquierdo, haga clic en Acciones de tabla o
Acciones de vista y, a continuación, haga clic en Agregar al modelo y después
en Agregar como tabla de hechos.
• En el editor de tablas o vistas de base de datos para una tabla o vista de origen
concreta, haga clic en Agregar al modelo y, a continuación, en Agregar como
tabla de hechos.
• En el panel derecho, haga clic en Agregar en el área Tablas de hechos del
modelo semántico. A continuación, seleccione una o varias tablas y vistas de
origen de la lista Objetos de base de datos y haga clic en Aceptar.
• Para copiar una tabla de hechos existente, haga clic en Acciones de tablas de
hechos para la tabla de hechos que desea copiar y, a continuación, haga clic en
Duplicar.

4-20
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

Después de agregar la vista o tabla de origen al modelo, puede editar la tabla de hechos.

Creación de tablas de dimensiones individualmente

Puede agregar tablas de origen individuales que contengan datos de dimensión al modelo
semántico.
Si tiene tablas de origen dimensional diferentes, como en un origen de estrella, puede
agregarlas al modelo semántico individualmente. Por ejemplo, si tiene una tabla de origen
que solo contiene atributos de cliente, puede utilizar este método para crear la tabla de
dimensiones correspondiente.
Opcionalmente, para orígenes de copo de nieve o normalizados (transaccionales), puede
crear vistas de origen para combinar objetos de origen de forma que parezca un modelo en
estrella. Para obtener más información sobre la creación de vistas, consulte Agregación de
vistas de origen propias. Para obtener más información sobre el modelado de los diferentes
tipos de vistas, consulte Planificación de un modelo semántico.

Sugerencia:
Cree vistas de origen como base para el modelado de objetos si cree que va a
realizar cambios posteriores como la ampliación del modelo de objetos, la creación
de filtros y la adición de cálculos anteriores a la agregación. La creación de una
tabla de dimensiones basada en vistas de origen proporciona mayor flexibilidad
que el uso de tablas de origen directamente.

Cuando utilice este método para crear tablas de dimensiones individuales, todas las
columnas de la tabla o vista de origen se asignarán a una única tabla de dimensiones y si el
origen tiene relaciones con otras vistas o tablas, le proporcionaremos la opción de
agregarlas a su modelo.
Tras bloquear el modelo, realice una de las siguientes acciones para crear tablas de
dimensiones individualmente:
• Arrastre la tabla o vista del menú Base de datos del panel izquierdo al área Tablas de
dimensiones del modelo de datos.
• En el menú Base de datos del panel izquierdo, haga clic con el botón derecho en la
tabla, después en Agregar al modelo y, a continuación, en Agregar como tabla de
dimensiones.
• En el menú Base de datos del panel izquierdo, haga clic en Acciones de tabla o en Ver
acciones para una tabla o vista, haga clic en Agregar al modelo y, a continuación, en
Agregar como tabla de dimensiones.
• Haga clic en Agregar en el área Tablas de dimensiones y, a continuación, seleccione
Agregar a tablas de bases de datos. En la lista Objetos de base de datos, seleccione
uno o más orígenes, y haga clic en Aceptar.
• En el Editor de vistas o en la Tabla de la base de datos de una vista o tabla de origen
concreta, haga clic en Agregar al modelo y, a continuación, en Agregar como tabla de
dimensiones.
• Para copiar una tabla de dimensiones existente, haga clic en Acciones de tablas de
dimensiones para la tabla de dimensiones que desea copiar y, a continuación, haga clic
en Duplicar.

4-21
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

Después de agregar la vista o tabla de origen al modelo, puede editar la tabla de

dimensiones.

Edición de tablas de hechos y tablas de dimensiones

Puede editar las propiedades de las tablas de hechos y de dimensiones en el modelo
semántico y obtener una vista previa de los datos de origen.

1. En Data Modeler, bloquee el modelo para editarlo.

2. Haga clic en la tabla de hechos o en la tabla de dimensiones que desea editar.
3. Cambie la configuración en el separador Visión general según sea necesario.
• Dimensión de tiempo: solo para tablas de dimensiones. Especifica que las
jerarquías para esta tabla de dimensiones soportan una dimensión de tiempo.
• Activar niveles omitidos y Activar jerarquías desequilibradas: solo para
tablas de dimensiones. Defina las propiedades para las jerarquías asociadas
a esta tabla de dimensiones.
• Lista de columnas: haga clic en el enlace de una columna para editar esa
columna en el editor de columnas. O bien, haga clic con el botón derecho en
la fila de la columna y haga clic en Editar.
• Agregación: solo para tablas de hechos. Haga clic para seleccionar un tipo
de agregación para la columna en una lista, o seleccione Definir agregación
en el menú Acciones de columna. Entre los tipos de agregación se incluyen:
• Solo para tablas de hechos. Haga clic para seleccionar un tipo de agregación
para la columna en una lista, o seleccione Definir agregación en el menú
Acciones de columna. Entre los tipos de agregación se incluyen:
Ninguna: no se aplica ninguna agregación.
Suma: calcula la suma agregando todos los valores.
Media: calcula el valor medio.
Mediana: calcula el valor intermedio.
Recuento: calcula el número de filas que no son nulas.
Recuento de los valores distintos: calcula el número de filas que no son
nulas. Cada incidencia distinta de una fila se cuenta una sola vez.
Máximo: calcula el valor numérico máximo.
Mínimo: calcula el valor numérico mínimo.
Primera: selecciona la primera incidencia del elemento.
Última: selecciona la última incidencia del elemento.
Desviación estándar: calcula la desviación estándar para mostrar el nivel de
variación respecto a la media.
Desviación estándar (todos los valores): calcula la desviación estándar con
la fórmula de la varianza de la población y la desviación estándar.
Consejo: algunas medidas calculadas muestran Agregado previamente para
la agregación. Estas medidas tienen cálculos que implican medidas que ya
tienen aplicada una agregación. Para editar un cálculo que contenga medidas
agregadas previamente, haga clic en el nombre de la columna.

4-22
 Capítulo 4
Adición de tablas de hechos y tablas de dimensiones a un modelo semántico

• Disponible: haga clic para marcar una columna como Disponible o No disponible
para seleccionar si esa columna se va a mostrar en los análisis que se crean.
También puede seleccionar Marcar como No disponible o Marcar como
Disponible en el menú Acciones de columna.
• Editar todo: puede hacer clic para editar las propiedades de columnas individuales
en la tabla, o seleccionar Editar todo para editar todas las filas a la vez.
• Agregar columna : haga clic en Agregar columna para mostrar el editor de
columnas y crear una nueva columna.

4. En el separador Datos de origen, puede obtener una vista previa de las primeras 25 filas
de los datos de origen para la tabla. Cambie el tamaño de las columnas en la tabla
mostrada si es necesario. Haga clic en Obtener recuento de filas para recuperar un
recuento de filas completo de la tabla o vista.
5. Solo para tablas de dimensiones: en el separador Jerarquías, edite las jerarquías y
niveles para la tabla.
6. En el separador Permisos, especifique los permisos de objeto.
7. En el separador Filtros de datos, puede definir los filtros de datos que proporcionan
filtrado a nivel de fila para los objetos del modelo semántico. Consulte Protección del
acceso a los datos.
8. Haga clic en Listo para volver al modelo semántico.

Adición de más columnas a tablas de hechos y de dimensiones

Hay distintas formas de agregar más columnas de origen a tablas de hechos y de
dimensiones en su modelo.
• Si se agregan nuevas columnas a una tabla de origen y desea incluirlas en tablas de
hechos y de dimensiones en su modelo, sincronice la tabla de hechos o de dimensiones
con la base de datos. La sincronización identifica cualquier columna nueva y la agrega a
la tabla de hechos o de dimensiones. Consulte Refrescamiento y sincronización de
objetos de origen y objetos de modelo semántico.
• Las tablas de dimensiones pueden combinar columnas de varios orígenes. Consulte
Adición de columnas de otro origen a una tabla de dimensiones.

4-23
 Capítulo 4
Unión de tablas en un modelo semántico

Adición de columnas de otro origen a una tabla de dimensiones

Puede agregar las columnas de otra tabla de origen o vista a una tabla de
dimensiones existente. Por ejemplo, puede que desee incluir atributos de una tabla
Product Category en la tabla de dimensiones Products.

1. En Data Modeler, bloquee el modelo para editarlo.

2. Seleccione la tabla de dimensiones que desea editar para que se muestre el
separador Visión general.
3. Arrastre y suelte la tabla de origen o la vista que contiene las columnas que desea
agregar del panel Base de datos a la tabla de dimensiones (área de columnas).
También puede hace clic con el botón derecho en la tabla de dimensiones que
desea editar, hacer clic en Agregar columnas y, a continuación, seleccionar la
tabla de origen o vista que contenga las columnas que desea agregar.
4. Seleccione las columnas de unión correspondientes y haga clic en Aceptar.

Visualice la tabla de dimensiones para ver las columnas adicionales. La propiedad

Origen muestra que la tabla de dimensiones está basada en una nueva vista de la
base de datos. Data Modeler crea una nueva vista de la base de datos cuando
agregue columnas desde otro origen.

Unión de tablas en un modelo semántico

En el modelo, una unión indica una relación entre una tabla de hechos y una tabla de
dimensiones.

Vídeo

Temas:
• Acerca de las uniones
• Unión de tablas de hechos y dimensiones

4-24
 Capítulo 4
Creación de una dimensión de tiempo

Acerca de las uniones

En el modelo, una unión indica una relación entre una tabla de hechos y una tabla de
dimensiones. Si utiliza el asistente de Agregar al modelo para modelar los datos, el asistente
crea uniones automáticamente entre una tabla de hechos y cada una de sus tablas de
dimensiones correspondientes.
Al modelar tablas de hechos y de dimensiones de forma individual, se crean
automáticamente uniones entre ellas si las referencias a estas uniones existen en las tablas
de origen.
También puede crear uniones de forma manual en el modelo semántico. Para ello, arrastre y
suelte una tabla de dimensiones o una tabla de hechos, o haga clic en Crear unión en el
área Uniones.
Al definir una unión entre una tabla de hechos y una tabla de dimensiones, debe seleccionar
una columna de unión de cada tabla. Puede crear una unión en más de una columna.

Unión de tablas de hechos y dimensiones

Defina uniones entre tablas de hechos y tablas de dimensiones para permitir la consulta de
datos relacionados. Por ejemplo, puede definir una unión entre la tabla de hechos Profit
Metrics y la tabla de dimensiones Products.

1. En Data Modeler, bloquee el modelo para editarlo.

2. En el área Tablas de dimensiones arrastre y suelte una tabla de dimensiones en el área
Tablas de hechos. O bien, en el área Uniones, haga clic en Crear unión.

3. En el área Uniones, especifique la tabla de hechos, columna de hechos, tabla de

dimensiones y columna de dimensiones adecuada que desea utilizar para la unión.
Por ejemplo, puede especificar una columna de fecha de facturación y otra de fecha de
calendario.
4. Haga clic en el icono de marca de control para guardar los cambios realizados en la
unión.
Si desea eliminar los cambios, haga clic en el icono X. Si comienza a crear una nueva
unión y hace clic en X, la nueva fila de la unión se elimina de la tabla Uniones.
Después de crear las uniones, podrá ver las jerarquías y los niveles por defecto al hacer clic
en el separador Jerarquías de la tabla de dimensiones especificada.

Creación de una dimensión de tiempo

Las funciones de serie temporal permiten comparar el rendimiento del negocio con períodos
de tiempo anteriores, lo que permite analizar datos que abarcan varios períodos de tiempo.
Por ejemplo, las funciones de serie temporal permiten realizar comparaciones entre las

4-25
 Capítulo 4
Creación de una dimensión de tiempo

ventas actuales y las ventas de hace un año, hace un mes, etc. Para utilizar las
funciones de serie temporal, el modelo semántico debe incluir una dimensión de
tiempo

Vídeo
Al crear una dimensión de tiempo, el asistente Crear dimensión de tiempo crea una
tabla en la base de datos, la rellena con datos de tiempo, crea una tabla de
dimensiones de tiempo correspondiente en el modelo semántico y crea una jerarquía
de tiempo.
El asistente de Crear dimensión de tiempo rellena la tabla de origen con datos de
tiempo del 1 de enero de 1970 al 31 de diciembre de 2020.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el área Tablas de dimensión, haga clic en Agregar y, a continuación, en Crear
dimensión de tiempo.

3. En el asistente de Crear dimensión de tiempo, especifique los nombres para la

tabla de base de datos, la tabla de dimensiones y la jerarquía.
4. En Niveles de jerarquía, especifique los niveles que desea incluir, como Año,
Trimestre y Mes.

5. Haga clic en Siguiente.

6. En la siguiente página, revise las tareas que realizará el asistente para crear la
dimensión de tiempo.

7. Haga clic en Crear para activar el asistente para crear la dimensión.

4-26
 Capítulo 4
Adición de medidas y atributos al modelo semántico

El asistente agrega una dimensión de tiempo con datos a la base de datos y crea una
dimensión correspondiente en el modelo semántico. Esta acción puede tardar hasta 30
segundos.
8. Haga clic en Listo.
9. Para crear uniones entre las columnas de la tabla de hechos y las columnas de la tabla
de dimensiones de tiempo, haga clic en Crear unión en el modelo semántico.
La dimensión de tiempo tiene dos columnas únicas. La columna DAY_TS tiene el tipo
TIMESTAMP y la columna DATE_ID tiene el tipo NUMBER. Al crear una unión,
especifique la columna con el formato de registro de hora o con el formato numérico (en
función de si la columna de la tabla de hechos tiene un tipo de fecha o de número).
10. En el área Uniones de la nueva definición, seleccione la columna de hechos adecuada y,
a continuación, seleccione la columna de registro de hora o numérica adecuada de la
dimensión de tiempo.
Después de crear las uniones, puede visualizar el separador Jerarquías en el editor
Dimensión de tiempo para ver las jerarquías y los niveles por defecto.
11. Edite las tablas del modelo.

12. Haga clic en Listo para volver al modelo semántico.

Adición de medidas y atributos al modelo semántico

En este tema se describe cómo agregar medidas y atributos al modelo semántico.

Vídeo

Temas:
• Edición de medidas y atributos
• Especificación de agregación para medidas en tablas de hechos
• Creación de medidas calculadas
• Creación de atributos derivados
• Creación de expresiones en el editor de expresiones
• Copia de medidas y atributos

Edición de medidas y atributos

Utilice el editor de tablas para agregar, editar y suprimir medidas y atributos en el modelo
semántico.

1. En Data Modeler, bloquee el modelo para editarlo.

2. Haga clic en la tabla de hechos o en la tabla de dimensiones que contiene la media o el
atributo que desea editar.
3. Para editar todas las columnas directamente en el editor de tablas, seleccione Editar
todo.
Para editar, copiar o suprimir una selección de columnas al mismo tiempo, pulse Mayús
o Ctrl y haga clic al mismo tiempo en las filas que desee.

4-27
 Capítulo 4
Adición de medidas y atributos al modelo semántico

4. En el editor de tablas, haga clic con el botón derecho en una columna y,

opcionalmente, haga clic en Copiar o Suprimir, según corresponda.
5. En el editor de tablas, haga clic en la columna que desea editar o haga clic en
Agregar columna.
6. Cambie la configuración en el separador Visión general según sea necesario:
• Edite el nombre mostrado y la descripción.
• Cambie la ordenación.
Por defecto, las columnas se ordenan según los datos de la columna y los
informes muestran los datos en este orden. Para ordenar una columna según
los datos de otra columna, seleccione Ordenar por una columna diferente y
seleccione el valor Ordenar por que prefiera. Por ejemplo, en lugar de
ordenar un atributo Nombre del mes alfabéticamente, podría ordenar por
número de mes, como 1 (Enero), 2 (Febrero), 3 (Marzo), etc.

7. Cambie la configuración de las medidas calculadas o de los atributos derivados.

8. Opcional: En el separador Permisos, modifique los permisos de objeto.
9. Opcional: En el separador Filtros de datos, defina los filtros de datos que
proporcionen filtrado de nivel de fila para los objetos del modelo semántico.
Consulte Protección del acceso a los datos.

4-28
 Capítulo 4
Adición de medidas y atributos al modelo semántico

10. Opcional: En el separador Niveles para las columnas de una tabla de hechos, cree una
medida basada en niveles. Consulte Definición de niveles de agregación para medidas.
11. Haga clic en Listo para volver al editor de tablas.

Especificación de agregación para medidas en tablas de hechos

Puede especificar la agregación para una medida en una tabla de hechos. Por ejemplo,
puede definir la regla de agregación para una columna Ingresos en Suma.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el área Tablas de hechos, haga clic en la tabla de hechos para la que desea crear
medidas.
3. En la lista Columnas, cambie la regla de agregación para las columnas correspondientes
para especificar que son medidas.
Para aplicar la misma regla de agregación a varias columnas, pulse Mayús y haga clic o
Ctrl y haga clic en las columnas correspondientes.
Entre las opciones de agregación se incluyen:
Ninguna: Ninguna agregación.
Suma: calcula la suma agregando todos los valores.
Media: calcula el valor medio.
Mediana: calcula el valor intermedio.
Recuento: calcula el número de filas que no son nulas.
Recuento de los valores distintos: calcula el número de filas que no son nulas. Cada
incidencia distinta de una fila se cuenta una sola vez.
Máximo: calcula el valor numérico máximo.
Mínimo: calcula el valor numérico mínimo.
Primera: selecciona la primera incidencia del elemento.
Última: selecciona la última incidencia del elemento.
Desviación estándar: calcula la desviación estándar para mostrar el nivel de variación
respecto a la media.
Desviación estándar (todos los valores): calcula la desviación estándar con la fórmula
de la varianza de la población y la desviación estándar.

Sugerencia:
Algunas medidas calculadas se han agregado previamente. Estas medidas
tienen cálculos que implican medidas que ya tienen aplicada una agregación.
Para editar un cálculo que contenga medidas agregadas previamente, haga
clic en el nombre de la columna.

4-29
 Capítulo 4
Adición de medidas y atributos al modelo semántico

En la mayoría de las medidas, se aplica la misma regla de agregación a cada

dimensión; pero, en el caso de algunas medidas, querrá especificar reglas de
agregación diferentes para distintas dimensiones.
Normalmente, las dimensiones de tiempo suelen requerir reglas de agregación
diferentes. Por ejemplo, Recuento (medida calculada) normalmente se agrega
como SUMA en las dimensiones de organización y geografía, pero SUMA no se
aplica a una dimensión de tiempo. La agregación de la dimensión de tiempo debe
ser ÚLTIMO, para que se pueda ver el recuento en la última semana o el último
día del año.
4. Para sustituir la agregación para dimensiones específicas:
a. Haga clic en el nombre de la columna de medida.
b. Anule la selección de la opción Misma para todas las dimensiones.

c. Haga clic en Agregar sustitución.

4-30
 Capítulo 4
Adición de medidas y atributos al modelo semántico

d. Seleccione la dimensión que desea agregar de forma diferente, por ejemplo, Tiempo.
e. Seleccione una regla de agregación para la dimensión.
f. Si es necesario, sustituya la agregación por otra dimensión.
g. Haga clic en Listo.
Si se han definido reglas de agregación específicas a dimensiones para una medida,
aparecerá un asterisco * junto a la regla de agregación de la tabla Columnas. Por
ejemplo, Suma*.
5. Por defecto, todas las columnas de la tabla de hechos aparecerán en informes. Anule la
selección del cuadro Disponible de cualquier columna que no desee mostrar. Puede
utilizar Mayús+ clic o Ctrl + clic para seleccionar varias filas.
6. Haga clic en Cancelar para cancelar cualquiera de los cambios.
7. Haga clic en Listo para volver al editor de tablas.

Creación de medidas calculadas

En una tabla de hechos no se incluyen todas las medidas que necesita, por lo que puede
crear medidas calculadas. Por ejemplo, puede crear una medida calculada denominada
Average Order Size con la fórmula Revenue/Number of Orders.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el área Tablas de hechos, haga clic en la tabla de hechos para la que desea crear
medidas.
3. En el área Columnas, haga clic en Agregar columna.
4. En el editor de Nueva columna, introduzca un nombre y una descripción para la
columna.
A continuación, introduzca una expresión directamente en el cuadro Expresión, o haga
clic en Editor completo para mostrar el editor de expresiones.
5. Las expresiones pueden contener medidas que ya se han agregado, así como medidas
en las que no se ha aplicado ninguna agregación. Puede:
• Definir Agregación en Antes del cálculo, si la expresión incluye medidas que ya se
han agregado o la agregación no es necesaria.
• Definir Agregación en Después del cálculo y seleccionar una regla de agregación,
como Sum, Average o Count para aplicar la agregación después de calcular la
expresión.
6. Haga clic en Listo para volver al editor de tablas.

4-31
 Capítulo 4
Adición de medidas y atributos al modelo semántico

Acerca de la creación de medidas calculadas

Las medidas calculadas, como sugiere su nombre, se calculan a partir de otras
medidas. Por ejemplo, puede crear una medida que calcule Average Order Size con la
fórmula Revenue/Number of Orders.
Los cálculos pueden contener medidas ya agregadas, así como medidas sin ninguna
agregación aplicada. Por ejemplo:
• El cálculo incluye medidas agregadas: Sum(Revenue)/Sum(Orders)
• El cálculo incluye medidas a las que no se ha aplicado ninguna agregación:
UnitPrice X Quantity
Si las medidas del cálculo no se han agregado previamente, por ejemplo,
UnitPrice y Quantity, puede aplicar la agregación después del cálculo. Por
ejemplo, Sum(UnitPrice X Quantity).

Compruebe las medidas en los cálculos antes de decidir si se debe aplicar la

agregación Antes del cálculo o Después del cálculo a la expresión.
Los cálculos incluyen medidas ya agregadas
Defina la agregación en Antes del cálculo si el cálculo contiene medidas agregadas
previamente. Por ejemplo: Sum(Revenue)/Sum(Orders).

4-32
 Capítulo 4
Adición de medidas y atributos al modelo semántico

Los cálculos incluyen medidas no agregadas

Opcionalmente, puede aplicar la agregación después del cálculo. Defina la agregación en
Después del cálculo y, a continuación, seleccione una regla de agregación de la lista. Por
ejemplo, Sum, Average, Count, etc.
No incluya columnas de expresión en el cálculo. Si incluye columnas agregadas en el
cálculo, se ignora la agregación de las columnas.

4-33
 Capítulo 4
Adición de medidas y atributos al modelo semántico

Creación de atributos derivados

Puede crear atributos personalizados o derivados para tablas de dimensiones que
estén basadas en una expresión. Por ejemplo, puede utilizar una expresión para
concatenar varias columnas de dirección en una sola columna Full Address.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el área Tablas de dimensiones, haga clic en la tabla de dimensiones para la
que desea crear atributos derivados.
3. En el área Columnas, haga clic en Agregar columna.
4. En el editor de Nueva columna, introduzca un nombre y una descripción para la
columna. A continuación, introduzca una expresión directamente en el cuadro
Expresión, o haga clic en Editor completo para mostrar el editor de expresiones.
Puede utilizar una variable en una expresión de columna.

5. Haga clic en Listo para volver al editor de tablas.

Creación de expresiones en el editor de expresiones

Puede utilizar el editor de expresiones para crear restricciones, agregaciones y otras
transformaciones en las columnas.

Temas:
• Acerca del editor de expresiones
• Creación de una expresión

Acerca del editor de expresiones

Al modelar datos, puede utilizar el editor de expresiones para crear restricciones,
agregaciones y otras transformaciones en columnas. Por ejemplo, puede utilizar el
editor de expresiones para cambiar el tipo de dato de una columna de fecha a
carácter. También puede utilizar el editor de expresiones para crear expresiones para
filtros de datos.

4-34
 Capítulo 4
Adición de medidas y atributos al modelo semántico

El editor de expresiones contiene las siguientes secciones:

• El cuadro Expresión del lado izquierdo permite editar la expresión actual.
• La barra de herramientas de la parte inferior contiene operadores de expresiones de uso
frecuente, como un signo más, un signo igual o una coma para separar elementos.
• La sección Elementos de expresión del lado derecho proporciona bloques integrantes
que puede utilizar en la expresión. Entre los ejemplos de elementos se encuentran
tablas, columnas, funciones y tipos.

La sección Elementos de expresión solo incluye elementos que sean relevantes para la
tarea. Por ejemplo, si abre el editor de expresiones para definir una medida calculada, la
sección Elementos de expresión solo incluye la tabla de hechos actual, cualquier tabla
de dimensiones unida a esa tabla, más cualquier tabla de hechos unida indirectamente a
través de una tabla de dimensiones. Del mismo modo, al definir un atributo derivado, ve
la tabla de dimensiones actual, cualquier tabla de hechos unida a esa tabla y cualquier
tabla de dimensiones unida esas tablas de hechos.
Otro ejemplo es que las jerarquías de tiempo solo se incluyen si la tabla de hechos de
tiempo está unida a la tabla actual.
Consulte Referencia del editor de expresiones.

Creación de una expresión

Puede utilizar el editor de expresiones para crear restricciones, agregaciones y otras
transformaciones en las columnas.

4-35
 Capítulo 4
Adición de medidas y atributos al modelo semántico

1. Agregue o edite una columna desde el editor de tablas.

2. Introduzca una expresión en el cuadro Expresión y haga clic en Listo. O bien,
haga clic en Editor completo para iniciar el editor de expresiones.
3. Utilice los menús de Elementos de expresión para buscar los bloques de creación
que desea utilizar para crear la expresión.
Arrastre y suelte un elemento para agregarlo a la expresión. También puede hacer
doble clic en un elemento para insertarlo, o bien seleccionar el elemento y hacer
clic en el icono de flecha.
Al agregar una función, los corchetes indican el texto que se debe sustituir.
Seleccione el texto y, a continuación, escriba o utilice los menús de Elementos de
expresión para agregar el elemento adecuado.
Consulte Referencia del editor de expresiones.
4. Haga clic en Filtro y, a continuación, introduzca el texto en el campo de búsqueda
para filtrar los elementos disponibles. Elimine el texto para volver a la lista
completa de elementos.
5. Haga clic en Acciones para mostrar u ocultar menús de Elementos de expresión
para ampliar o reducir todos los menús.
6. Haga clic en un elemento de la barra de herramientas para insertar un operador.
7. Haga clic en Deshacer o Rehacer según sea necesario cuando cree la expresión.
8. Haga clic en Validar para comprobar el trabajo realizado.
9. Haga clic en Guardar cuando haya terminado.

Copia de medidas y atributos

Puede copiar medidas y atributos y pegarlos en el modelo semántico.
• En el menú Modelo de datos del panel izquierdo, haga clic con el botón derecho
en la columna que desea copiar y seleccione Copiar.
Para copiar varias columnas, haga clic mientras pulsa Mayús o haga clic en todas
las filas que desee mientras pulsa Ctrl y, a continuación, haga clic con el botón
derecho para seleccionar Copiar.
• En el menú Modelo de datos del panel izquierdo, haga clic en Acciones de
columna en la columna que desea copiar y seleccione Copiar.
La copia aparece con un número agregado al nombre.

4-36
 Capítulo 4
Copia de objetos del modelo

Copia de objetos del modelo

En ocasiones es más sencillo copiar objetos que empezar desde cero.
En Data Modeler, puede copiar tablas de hechos, tablas de dimensiones, tablas de bases de
datos y vistas de bases de datos:
• Tablas de hechos
Para copiar una tabla de hechos existente, seleccione Duplicar en el menú Acciones
de tablas de hechos. Al copiar una tabla de hechos, Data Modeler incluye uniones por
defecto. Consulte Creación de tablas de hechos individuales.
No se copia la configuración de nivel de agregación para medidas, ya que, en la mayoría
de los casos, la configuración de nivel de la tabla de hechos original y de la versión
copiada difieren. Después de copiar una tabla de hechos, revise y defina los niveles de
agregación necesarios para las medidas.
• Tablas de dimensiones
Para copiar una tabla de dimensiones existente, seleccione Duplicar en el menú
Acciones de tablas de dimensiones. Al copiar una tabla de dimensiones, Data Modeler
excluye las uniones por defecto. Consulte Creación de tablas de dimensiones
individualmente.
• Tablas de base de datos y vistas
Para copiar un objeto de base de datos existente, seleccione Duplicar en el menú
Acciones. Al copiar una tabla o una vista, Data Modeler crea una vista basada en la
tabla o vista que haya copiado. Consulte Agregación de vistas de origen propias.

4-37
5
Definición de jerarquías y niveles para
obtención de detalles y agregación
Puede definir jerarquías y niveles en Data Modeler.

Temas:
• Flujo de trabajo típico para definir jerarquías y niveles
• Acerca de las jerarquías y los niveles
• Edición de jerarquías y niveles
• Definición de niveles de agregación para medidas

Flujo de trabajo típico para definir jerarquías y niveles

A continuación, se muestran las tareas comunes para agregar jerarquías y niveles al modelo
semántico.

Tarea Descripción Más información

Agregar jerarquías y Crea jerarquías y niveles para las Edición de jerarquías y niveles
niveles tablas de dimensiones
Definir niveles de Define niveles de agregación Definición de niveles de
agregación para medidas personalizados para medidas que agregación para medidas
son diferentes del nivel por defecto

Acerca de las jerarquías y los niveles

Una jerarquía muestra las relaciones entre grupos de columnas en una tabla de
dimensiones. Por ejemplo, los trimestres contienen los meses y los meses contienen los
días. Las jerarquías permiten cambiar de nivel en los informes.
Una tabla de dimensiones puede contener una o más jerarquías. Una jerarquía suele
empezar por un nivel total, seguido de niveles secundarios, y descender hasta el nivel de
detalle inferior.
Todas las jerarquías de una determinada dimensión deben tener un nivel inferior común. Por
ejemplo, una dimensión de tiempo podría contener una jerarquía fiscal y una jerarquía de
calendario, con Día como nivel inferior común. El día tiene dos niveles principales con
nombre denominados Año fiscal y Año natural, que son ambos secundarios del nivel raíz
Todo.
En todos los niveles, excepto en el nivel total, se debe especificar al menos una columna
como columna clave o de visualización. Sin embargo, no es necesario asociar explícitamente
todas las columnas de una tabla a los niveles. Cualquier columna que no esté asociada a un
nivel se asocia automáticamente al nivel inferior de la jerarquía que se corresponda con la
tabla de dimensiones.

5-1
 Capítulo 5
Edición de jerarquías y niveles

No hay límite en el número de niveles que puede tener una jerarquía. El número total
de niveles no es, por sí mismo, un factor determinante para el rendimiento de la
consulta. Sin embargo, tenga en cuenta que, en el caso de consultas
extremadamente complejas, incluso unos pocos niveles pueden afectar al
rendimiento.

Edición de jerarquías y niveles

Cuando se unen las tablas de hechos y las tablas de dimensiones, se crea una
jerarquía por defecto, pero también se pueden agregar jerarquías y niveles a dichas
tablas. Por ejemplo, una jerarquía Geography puede incluir niveles para Country,
State y City.
1. En Data Modeler, bloquee el modelo para editarlo.
2. En el área Tablas de dimensiones, haga clic en la tabla de dimensiones para la
que desea agregar una jerarquía. La tabla de dimensiones debe tener al menos
una unión a una tabla de hechos.
3. En el editor de dimensiones, haga clic en el separador Jerarquías.
4. En el área Jerarquías, haga clic en Agregar nivel y seleccione las columnas de
dimensión o los niveles compartidos que desea utilizar.

5. Arrastre y suelte los niveles en una posición diferente del orden, según
corresponda. También puede hacer clic con el botón derecho en un nivel y
seleccionar Mover a la izquierda o Mover a la derecha.

6. Haga clic en un nivel para acceder a un cuadro de diálogo en el que puede

especificar el nombre de nivel, la columna de clave y la columna de visualización
para el nivel.
7. Anule la selección de Disponible si no desea que la jerarquía esté visible en los
análisis.
8. Haga clic en Listo cuando termine.

5-2
 Capítulo 5
Definición de niveles de agregación para medidas

Definición de propiedades de la tabla de dimensiones para jerarquías

En el separador Visión general de una tabla de dimensiones concreta, puede definir
propiedades que se apliquen a todas las jerarquías de esa tabla.

1. En Data Modeler, bloquee el modelo para editarlo.

2. Haga clic en la tabla de dimensiones que desea editar.
3. Utilice el separador Visión general para definir las propiedades según sea necesario.
• Dimensión de tiempo: especifica que las jerarquías para esta tabla de dimensiones
soportan una dimensión de tiempo. Las jerarquías para las dimensiones de tiempo
no pueden incluir niveles de salto ni estar desequilibradas.
• Activar niveles omitidos: especifica que esta tabla de dimensiones soporta
jerarquías con niveles omitidos. Una jerarquía de nivel de salto es una jerarquía en la
que los miembros no tienen un valor para un nivel ascendiente concreto. Por
ejemplo, en una jerarquía País-Estado-Ciudad-Distrito, la ciudad "Washington, D.C."
no pertenece a Estado. En este caso, puede aumentar detalle desde el nivel País
(EE.UU.) hasta el nivel Ciudad (Washington, D.C.) y así sucesivamente.
En una consulta, no se muestran los niveles saltados y no afectan a los cálculos.
Cuando se ordenan jerárquicamente, los miembros aparecen bajo sus ascendientes
más cercanos.
• Activar jerarquías desequilibradas: especifica que esta tabla de dimensiones
soporta jerarquías desequilibradas. Una jerarquía desequilibrada (o irregular) es una
jerarquía en la que las hojas (miembros sin secundarios) no tienen necesariamente
la misma profundidad. Por ejemplo, un sitio puede tener datos del mes actual en el
nivel de día, datos del mes anterior en el nivel de mes y en el nivel de trimestre para
los datos de los últimos 5 años.

Definición de niveles de agregación para medidas

Si se unen las tablas de hechos y las tablas de dimensiones, puede definir niveles de
agregación personalizados para una medida.

1. En Data Modeler, bloquee el modelo para editarlo.

2. En el área Tablas de hechos, haga clic en la tabla de hechos en la que está ubicada la
medida.
3. Especifique la regla de agregación para la nueva columna que desea convertir en la
medida basada en nivel.
4. Haga clic en el nombre de columna y, a continuación, en Niveles.
5. En el separador Niveles, para una o más jerarquías, utilice la guía de desplazamiento
para seleccionar el nivel de agregación para la medida.

5-3
 Capítulo 5
Definición de niveles de agregación para medidas

6. Haga clic en Listo para volver al editor de tablas.

Acerca de la definición de niveles de agregación para las medidas

Por defecto, las medidas se agregan en el nivel de los atributos de dimensión que se
han seleccionado en un análisis. Por ejemplo, en un análisis que incluye las columnas
Sales Person y Revenue, los ingresos se agregan en el nivel de un vendedor.
Para calcular los ratios, suele necesitar medidas que se hayan agregado en un nivel
que sea diferente al detalle de los análisis. Por ejemplo, para calcular la contribución
porcentual de ingresos para un vendedor (Revenue Percent Contribution for a Sales
Person) con respecto a su departamento, necesita los ingresos del departamento
(Department Revenue) en el nivel de vendedor (Sales Person) en un análisis (Sales
Person, Revenue, Revenue *100 / Revenue@Dept). En este ejemplo, Revenue@Dept
tiene un nivel de agregación personalizado diferente al nivel por defecto.

5-4
6
Protección del modelo semántico
Puede definir permisos a nivel de objeto y filtros de datos de seguridad a nivel de fila para el
modelo semántico.

Temas:
• Flujo de trabajo típico para proteger datos de modelos
• Creación de variables para su uso en expresiones
• Protección del acceso a los objetos del modelo
• Protección del acceso a los datos

Flujo de trabajo típico para proteger datos de modelos

A continuación, se detallan las tareas comunes para proteger el modelo semántico.

Tarea Descripción Más información

Definir variables para Opcionalmente, crea variables que Creación de variables para su
filtros de datos, si es calculan y almacenan de forma uso en expresiones
necesario dinámica valores para utilizarlos
en expresiones de columna y filtros
de datos.
Definición de permisos en Los permisos de objetos controlan Protección del acceso a los
objetos de modelos la visibilidad de todo su modelo o objetos del modelo
de tablas de hechos individuales,
tablas de dimensiones y columnas.
Definir filtros de seguridad Los filtros de datos limitan los Protección del acceso a los
a nivel de fila resultados que se devuelven para datos
tablas de hechos, tablas de
dimensiones y columnas.

Creación de variables para su uso en expresiones

En Data Modeler, puede definir variables que calculan y almacenan valores dinámicamente
de forma que pueda utilizar dichos valores en expresiones de columna o filtros de datos.

Temas:
• Acerca de las variables
• Definición de variables

6-1
 Capítulo 6
Creación de variables para su uso en expresiones

Acerca de las variables

Las variables calculan y almacenan valores dinámicamente de forma que pueda
utilizar dichos valores en expresiones. Puede utilizar variables en expresiones de
columna o en filtros de datos.
Por ejemplo, suponga que User1 pertenece a Department1 y User2 pertenece a
Department2. Cada usuario debe acceder solo a los datos específicos de su
departamento. Puede utilizar la variable DEPARTMENT_NUMBER para almacenar los
valores adecuados para User1 y User2. Puede utilizar esta variable en un filtro de
datos en el que los datos se filtran por Department2 para User1 y Department2 para
User2. Es decir, las variables modifican de forma dinámica el contenido de metadatos
para ajustarlo a un entorno de datos cambiante.
Los valores de las variables no son seguros, ya que los permisos de objeto no se
aplican a las variables. Cualquier persona que conozca o pueda averiguar el nombre
de la variable puede utilizarla en una expresión. Por este motivo, no incluya datos
confidenciales, como contraseñas, en las variables.
No puede utilizar una variable en una expresión que define otra variable.

Definición de variables
Puede crear una variable para su uso en expresiones de columna y filtros de datos.
Por ejemplo, una variable denominada SalesRegion puede utilizar una consulta SQL
para recuperar el nombre de la región de ventas del usuario.

Sugerencia:
Haga referencia a los objetos de base de datos de origen solo en la consulta
SQL para una variable. No incluya nombres de objetos de modelo semántico
en la consulta.

1. En Data Modeler, bloquee el modelo para editarlo.

2. En el menú Variables del panel izquierdo, haga clic en el icono Más.
3. Introduzca una consulta SQL para rellenar el valor de la variable:
a. Especifique si la variable devuelve Un único valor o Varios valores.
b. Introduzca una consulta SQL para rellenar el valor o los valores de la variable.
Por ejemplo:
— Devolver un solo valor con la consulta como: SELECT prod-name FROM
products
— Devolver varios valores con una consulta como: SELECT 'MyVariable',
prod-name FROM products
Para varios valores, utilice siempre el formato: SELECT ‘NombreVariable’,
ValorVariable FROM Tabla
c. Proporcione un valor inicial por defecto si es necesario.
d. Haga clic en Probar para validar que la consulta devuelve un valor adecuado

6-2
 Capítulo 6
Protección del acceso a los objetos del modelo

4. Para crear una variable que refresque su valor al inicio de cada sesión de usuario,
seleccione Al iniciar sesión para Actualizar valor.
5. Para crear una variable que refresque su valor según la programación que haya definido,
seleccione De manera programada para Actualizar valor.
En el área Ejecutar consulta SQL, seleccione la frecuencia y la fecha de inicio para
refrescar la variable.
6. Para crear una variable con un valor estático que nunca cambie, seleccione Nunca para
Actualizar valor y proporcione un valor para la variable en el campo Valor.
7. Haga clic en Listo para volver al modelo semántico.

Sugerencia:
Para editar una variable existente, haga clic con el botón derecho en la lista
Variables y seleccione Inspeccionar. Para suprimir una variable, haga clic con
el botón derecho y seleccione Suprimir.

Después de definir una variable, puede utilizarla en un filtro de datos o en una expresión de
columna.

Protección del acceso a los objetos del modelo

Es importante mantener la información confidencial segura. Todo el mundo tiene acceso a
los datos del modelo por defecto. Para evitar la exposición de datos confidenciales, defina
permisos de mostrar y ocultar para todo el modelo o para tablas de hechos, tablas de
dimensiones y columnas individuales.
Por ejemplo, puede restringir el acceso a determinadas columnas Ingresos para asegurarse
de que solo los usuarios autorizados puedan verlas. O bien puede restringir el acceso a todo
el modelo para impedir que los usuarios abran el modelo o accedan a su área temática.
1. En Data Modeler, bloquee el modelo para editarlo.
2. Para restringir el acceso a todo el modelo, seleccione el separador Permisos.

6-3
 Capítulo 6
Protección del acceso a los objetos del modelo

Para restringir el acceso a un elemento concreto del modelo, edite la tabla de

hechos, tabla de dimensiones o columna cuyo acceso desea proteger y, a
continuación, seleccione el separador Permisos.
3. Para controlar el acceso, haga clic en Agregar y seleccione el rol adecuado.
También puede hacer clic en Roles en el panel izquierdo. A continuación, arrastre
un rol y suéltelo en la lista Permisos. Para agregar varios roles, pulse Mayús y
haga clic o Ctrl y haga clic para seleccionar primero antes de arrastrar y soltar.

4. Especifique si este objeto es visible para los usuarios con ese rol seleccionando
Visible u Oculto.
• Modelos: Si oculta un modelo, los usuarios con ese rol no podrán abrir el
modelo ni su área temática.
• Objetos de modelo: Si oculta una tabla de hechos, tabla de dimensiones o
columna, los usuarios con ese rol no podrán ver el objeto en los informes.
Los mismos usuarios verán el objeto en Data Modeler si tienen el rol Autor de
modelo de datos de BI y tienen acceso al modelo.
5. Para eliminar roles de la lista Permisos (no puede eliminar el rol Todos), realice
una de estas acciones:
• Haga clic con el botón derecho en un rol y seleccione Eliminar.

• Seleccione Eliminar en el menú Acciones de ese rol.

• Para seleccionar varios roles, pulse Mayús y haga clic o pulse Ctrl y haga clic
y, a continuación, seleccione Eliminar selección en el menú Acción de
permisos.
• Para eliminar todos los roles, seleccione Eliminar todo en el menú Acción de
permisos.

Acerca de la herencia de permisos

Cuando hay varios roles de aplicación que actúan en un usuario o rol con atributos de
seguridad que entran en conflicto, al usuario o al rol se le otorga el atributo de
seguridad menos restrictivo. Asimismo, cualquier permiso explícito que actúe en un
usuario tiene prioridad sobre cualquier permiso en los mismos objetos que se haya
otorgado a ese usuario a través de roles de aplicación.

6-4
 Capítulo 6
Protección del acceso a los datos

Sugerencia:
Si deniega el acceso a una tabla, también se deniega implícitamente el acceso a
todas las columnas de esa tabla.

Protección del acceso a los datos

Puede definir filtros de datos para tablas de hechos, tablas de dimensiones y columnas que
proporcionan una seguridad a nivel de fila para los objetos de modelo de datos. Por ejemplo,
puede crear un filtro que restrinja el acceso a la tabla Products de forma que solo estén
visibles determinadas marcas para los usuarios asignados a un rol concreto.

1. En Data Modeler, bloquee el modelo para editarlo.

2. Edite la tabla de hechos, la tabla de dimensiones o la columna cuyo acceso desee
proteger.
3. Seleccione el separador Filtros de datos.
4. Agregue un rol a la lista Filtros de datos con una de las siguientes acciones:
• Haga clic en Agregar y seleccione el rol adecuado.
• En el panel izquierdo, haga clic en Roles. A continuación, arrastre y suelte un rol en
la lista Filtros de datos.
5. Introduzca una expresión para especificar qué datos son accesibles para ese rol.
Introduzca la expresión directamente o haga clic en Editor completo para mostrar el
editor de expresiones.
Puede utilizar una variable en una expresión de filtro de datos.

6. Seleccione Activar para especificar si el filtro está activado para ese rol.
7. Para eliminar filtros de la lista Filtros de datos, realice una de las siguientes acciones:
• Haga clic con el botón derecho en un filtro y seleccione Eliminar.
• Seleccione Eliminar en el menú Acciones de ese filtro.
• Seleccione varios filtros haciendo clic mientras pulsa Mayús o Ctrl y, a continuación,
seleccione Eliminar selección en el menú Acción de filtro de datos.

6-5
 Capítulo 6
Protección del acceso a los datos

• Para eliminar todos los filtros, seleccione Eliminar todo en el menú Acción de
filtro de datos.
8. Haga clic en Listo.

6-6
Parte III
Creación de modelos de datos para informes
de visualización perfecta
En esta parte se describe el proceso para crear y personalizar modelos de datos para
informes de impresión perfecta.

Capítulos:
• Introducción al modelado de datos para informes de visualización perfecta
• Uso del editor de modelo de datos
• Creación de juegos de datos
• Estructuración de datos
• Adición de parámetros y listas de valores
• Adición de disparadores de eventos
• Acerca de las opciones de origen de datos
• Agregar campos flexibles
• Adición de definiciones de repartición
• Adición de metadatos personalizados para Oracle WebCenter Content Server
• Mejores prácticas de rendimiento
7
Introducción al modelado de datos para
informes de visualización perfecta
En este tema se describe cómo puede acceder y empezar a trabajar con el modelado de
datos para obtener informes con una visualización perfecta.

Temas:
• Flujo de trabajo típico para modelar datos para informes de visualización perfecta
• Inicio del editor de modelo de datos
• Principales tareas para el modelado de datos para informes de visualización perfecta

Flujo de trabajo típico para modelar datos para informes de

visualización perfecta
Un modelo de datos que se utiliza para los informes de visualización perfecta puede ser
simple, con un juego de datos recuperado de un solo origen de datos (por ejemplo, los datos
devueltos de las columnas en la tabla de empleados); o puede ser complejo, con
parámetros, disparadores y definiciones de repartición, y utilizando varios juegos de datos.

Tarea Usuario Más información

Iniciar el editor del modelo de datos. Modelador de Inicio del editor de modelo de datos
datos de informe
Definir propiedades para el modelo Modelador de Propiedades de modelo de datos
de datos. (Opcional) datos de informe
Crear los juegos de datos para el Modelador de Creación de juegos de datos
modelo de datos. datos de informe
Definir la estructura de salida de Modelador de Estructuración de datos
datos. (Opcional) datos de informe
Definir los parámetros que se van a Modelador de Adición de parámetros y listas de
transferir a la consulta y definir datos de informe valores
listas de valores para que los
usuarios seleccionen valores de
parámetro. (Opcional)
Definir disparadores de eventos. Modelador de Acerca de los disparadores
(Opcional) datos de informe
(Solo para Fusion Applications Suite) Modelador de Agregar campos flexibles
Definir campos flexibles. (Opcional) datos de informe
Probar el modelo de datos y agregar Modelador de Prueba de modelos de datos y
datos de muestra. datos de informe generación de datos de muestra
Agregar una definición de Modelador de Adición de definiciones de repartición
repartición. (Opcional) datos de informe

7-1
 Capítulo 7
Inicio del editor de modelo de datos

Tarea Usuario Más información

Asignar metadatos personalizados Modelador de Adición de metadatos personalizados
para documentos que se van a datos de informe para Oracle WebCenter Content Server
entregar en servidores de contenidos
web (opcional)

Inicio del editor de modelo de datos

Inicie el editor de modelo de datos desde la cabecera o desde la página inicial.
Para iniciar el editor de modelo de datos:
• Use uno de estos métodos:
– Haga clic en Nuevo y, a continuación, haga clic en Modelo de datos.
– En la región Crear, haga clic en Modelo de datos.

Principales tareas para el modelado de datos para informes

de visualización perfecta
En este tema se identifican las principales tareas para el modelado de datos para
informes de visualización perfecta.
• Creación de un juego de datos
• Crear enlaces entre juegos de datos.
• Adición de parámetros y listas de valores
• Adición de disparadores de eventos
• Agregar campos flexibles
• Asignación de campos de datos a campos de metadatos personalizados
• Validación de modelos de datos

7-2
8
Uso del editor de modelo de datos
En este tema se describen los componentes y las funciones que soporta el editor del modelo
de datos.

Temas:
• Componentes de un modelo de datos
• Acerca de las opciones de origen de datos
• Funciones del editor del modelo de datos
• Propiedades de modelo de datos
• Gestión de orígenes de datos privados

Componentes de un modelo de datos

Un modelo de datos soporta los siguientes componentes:
• Juego de datos
Un juego de datos contiene la lógica para recuperar datos de un único origen de datos.
Un juego de datos puede recuperar datos de distintos orígenes de datos (por ejemplo,
una base de datos, un archivo de datos existente, una llamada de servicio web a otra
aplicación, o una URL/URI a un proveedor de datos externo). Un modelo de datos puede
tener varios juegos de datos de distintos orígenes.
• Disparadores de evento
Un disparador comprueba si se produce un evento. Cuando se produce el evento, el
disparador ejecuta el código PL/SQL asociado a este. El editor del modelo de datos
soporta disparadores antes y después de los datos, así como disparadores de
programación. Los disparadores antes y después de los datos constan de una llamada
para ejecutar un juego de funciones definidas en un paquete PL/SQL almacenado en
una base de datos Oracle. Un disparador de programación se ejecuta para los informes
programados y prueba una condición que determina si se debe o no ejecutar un trabajo
de informe programado.
• Campos flexibles
Un campo flexible es una estructura específica de Fusion Applications Suite. El editor de
modelos de datos soporta la recuperación de datos desde estructuras de campo flexible
definidas en las tablas de base de datos de Fusion Applications Suite.
• Listas de valores
Una lista de valores es un menú de valores en la que los consumidores del informe
pueden seleccionar valores de parámetro para transferirlos al informe.
• Parámetros
Un parámetro es una variable cuyo valor se puede definir en tiempo de ejecución. El
editor del modelo de datos soporta varios tipos de parámetro.

8-1
 Capítulo 8
Acerca de las opciones de origen de datos

• Definiciones de repartición
La repartición es un proceso de división de datos en bloques que genera
documentos para cada bloque de datos y entrega los documentos a uno o varios
destinos. Una única definición de repartición proporciona las instrucciones
necesarias para dividir los datos del informe, generando el documento y
entregando la salida a los destinos especificados.
• Metadatos personalizados (para servidores de contenidos web)
Si ha configurado un servidor de contenidos web como un destino de entrega y ha
activado los metadatos personalizados, el componente de metadatos
personalizados se muestra en el editor de modelo de datos. Utilice este
componente para asignar campos de datos del modelo de datos a los campos de
metadatos personalizados configurados para un juego de reglas definidas en un
perfil de contenido.

Acerca de las opciones de origen de datos

Los tipos de origen de datos soportados para crear juegos de datos se pueden
clasificar en tres tipos generales.
Puede conectar a orígenes de datos locales a través de un canal de acceso privado
(PAC) Consulte Conexión a orígenes de datos privados a través de un canal de
acceso privado.
Está soportado el rango completo de funciones del editor del modelo de datos para
los siguientes tipos de juego de datos:
• Consultas SQL ejecutadas en Oracle BI Server, una base de datos Oracle
Database u otras bases de datos soportadas. Publisher puede recuperar la
información de metadatos de estas consultas SQL.
Consulte Creación de juegos de datos utilizando consultas SQL.
• Consultas multidimensionales (MDX) en el origen de datos de OLAP
Consulte Creación de un juego de datos con una consulta de MDX con respecto a
un origen de datos de OLAP.
• Orígenes de datos de hoja de cálculo de Microsoft Excel
Puede almacenar la hoja de cálculo de Excel en un directorio de archivos
configurado como origen de datos por el administrador, o bien cargarla
directamente desde un origen local en el modelo de datos. Consulte Creación de
un juego de datos con un archivo Microsoft Excel.
• Orígenes de datos de archivo de datos XML
Puede almacenar el archivo XLM en un directorio de archivos configurado como
origen de datos por el administrador, o bien cargarlo directamente desde un
origen local en el modelo de datos. Consulte Creación de un juego de datos
mediante un archivo XML.
• Orígenes de datos de archivo CSV (valor separado por comas)
Puede almacenar el archivo CSV en un directorio de archivos configurado como
origen de datos por el administrador, o bien cargarlo directamente desde un
origen local en el modelo de datos. Consulte Creación de un juego de datos
mediante un archivo CSV.

8-2
 Capítulo 8
Funciones del editor del modelo de datos

Tipos de juego de datos que pueden utilizar funciones parciales del editor en el
modelo de datos
Publisher puede recuperar los nombres de columna y la información de tipo de dato del
origen de datos de estos tipos de juego de datos, pero no puede procesar ni estructurar los
datos. Solo está soportado un subjuego del rango completo de funciones del editor del
modelo de datos para los siguientes tipos de juego de datos:
• Análisis
Consulte Creación de un juego de datos mediante un análisis.
• Visualización
Consulte Uso de análisis de autoservicio.

Tipos de juego de datos que no se pueden modificar en el editor del modelo de datos
Para los siguientes tipos de juego de datos, Publisher puede recuperar los datos generados
y estructurados en el origen. No puede aplicar modificaciones adicionales en el editor del
modelo de datos para los siguientes tipos de juego de datos:
• Fuentes XML HTTP fuera de la web
Consulte Creación de un juego de datos a partir de una fuente XML HTTP.
• Servicios web
Consulte Creación de un juego de datos mediante un servicio web.
Para utilizar un servicio web para devolver datos para el informe, proporcione el servicio
web WSDL a Publisher y, a continuación, defina los parámetros en Publisher.

Funciones del editor del modelo de datos

El editor del modelo de datos le permite combinar datos de varios juegos de datos en una
única estructura de datos XML.
Los juegos de datos de varios orígenes de datos se pueden fusionar como un XML
secuencial o en el nivel de línea para crear un único XML jerárquico combinado. Mediante el
editor del modelo de datos, puede combinar de forma sencilla datos de los siguientes tipos
de juegos de datos: consulta SQL, OLAP (consulta MDX), LDAP y Microsoft Excel.
El editor del modelo de datos está diseñado con un panel de componentes en el lado
izquierdo y un panel de trabajo en el lado derecho. La selección de un componente en el
panel de la izquierda inicia los campos adecuados para el componente en el área de trabajo.
El editor del modelo de datos soporta lo siguiente
• Agrupar datos: cree grupos para organizar las columnas del informe. Los grupos
pueden hacer dos cosas: separar los datos de una consulta en juegos y filtrar los datos
de una consulta.
Cuando crea una consulta, el motor de datos crea un grupo que contiene las columnas
seleccionadas por la consulta; puede crear grupos para modificar la jerarquía de los
datos que aparecen en un modelo de datos. Los grupos se utilizan principalmente
cuando se desea tratar algunas columnas de forma diferente que otras. Por ejemplo,
puede crear grupos para producir subtotales o crear divisiones.
• Enlazar datos: defina enlaces maestro -detalle entre juegos de datos para agrupar datos
en varios niveles.

8-3
 Capítulo 8
Funciones del editor del modelo de datos

• Agregar datos: cree totales y subtotales de nivel de grupo.

• Transformar datos: modifique los datos de origen para que se ajusten a los
términos de negocio y los requisitos de informes.
• Crear cálculos: calcule valores de datos necesarios para el informe que no estén
disponibles en los orígenes de datos subyacentes.
El editor del modelo de datos proporciona funciones en el nivel de elemento, el nivel
de grupo y el nivel global. Tenga en cuenta que no todos los tipos de juegos de datos
soportan todas las funciones. Consulte la sección Notas importantes que acompaña al
tipo de juego de datos para conocer las limitaciones. En la imagen que se muestra a
continuación se resaltan algunas de las funciones y acciones disponibles en el editor
del modelo de datos.

Acerca de la barra de herramientas del editor del modelo de datos

La barra de herramientas del editor del modelo de datos en la parte superior le
proporciona las opciones necesarias para gestionar orígenes de datos privados,
visualizar datos, crear un informe y guardar el modelo de datos.

Opción Descripción
Validar Valida las consultas utilizadas para los
juegos de datos, las listas de valores y las
definiciones de repartición.
Gestionar orígenes de datos privados Conéctese a orígenes de datos privados
para su uso personal que no requieran la
configuración de un administrador.
Ver datos Muestre el separador Datos, donde puede
ver y generar datos de muestra.

8-4
 Capítulo 8
Funciones del editor del modelo de datos

Opción Descripción
Crear informe Cree un nuevo informe con este modelo de
datos.
Guardar/Guardar como Seleccione Guardar para guardar el
trabajo en curso en el objeto de modelo de
datos existente, o seleccione Guardar
como para guardar el modelo de datos
como un nuevo objeto en el catálogo.
Si crea un modelo de datos y, a
continuación, sale del editor del modelo de
datos sin guardarlo, puede que aparezca
una entrada de borrador o de modelo de
datos temporal en la sección Reciente de la
página inicial. Estas entradas no se pueden
suprimir manualmente, pero se suprimen
de forma automática después de 24 horas.
Ayuda Vea la Ayuda en Pantalla.

Acerca de la interfaz
Por defecto, los juegos de datos que ha creado se muestran en la Vista de diagrama como
objetos independientes.

El generador de estructuras de juegos de datos tiene tres vistas:

• Vista de diagrama: la Vista de diagrama muestra juegos de datos y permite crear
enlaces y filtros de forma gráfica, agregando elementos basados en expresiones,
agregando funciones de agregado y funciones de nivel global, editando propiedades de
elemento y suprimiendo elementos. La vista de diagrama es la vista que se utiliza
normalmente para crear la estructura de datos.

8-5
 Capítulo 8
Funciones del editor del modelo de datos

• Vista de estructura: la Vista de estructura tiene dos modos:

Vista de tabla y Salida
La vista de tabla muestra las propiedades de los elementos en una tabla y permite
la actualización de los nombres de alias, los nombres de presentación de los
elementos, la ordenación, los valores nulos y las opciones de restablecimiento de
los elementos XML. En la siguiente imagen se muestra la Vista de tabla de la
estructura.

La vista Salida proporciona una vista clara de la estructura XML que se genera.
La vista Salida no se puede actualizar. En la figura se muestra la vista Salida.

8-6
 Capítulo 8
Funciones del editor del modelo de datos

• Vista de código: la Vista de código muestra el código de estructura de datos creado

por el generador de estructuras de datos que lee el motor de datos. Puede actualizar el
contenido en la vista de código. En la figura se muestra la vista de código.

8-7
 Capítulo 8
Propiedades de modelo de datos

Propiedades de modelo de datos

Puede acceder a la página Propiedades del modelo de datos haciendo clic en
Propiedades en el panel de componentes.
Introduzca las siguientes propiedades para el modelo de datos:

Propiedad
Descripción
Origen de datos por defecto
Paquete por defecto Oracle DB
Descripción
Introduzca una descripción para el modelo de datos.
El catálogo muestra las descripciones de los modelos
de datos. Esta descripción es traducible.
Seleccione el origen de datos en la lista. Los modelos
de datos pueden incluir varios juegos de datos de
uno o varios orígenes de datos. El origen de datos
por defecto que seleccione aquí se presenta como el
valor por defecto de cada nuevo juego de datos SQL
que defina. Seleccione Refrescar lista de orígenes
de datos para ver todos los orígenes de datos
nuevos agregados desde que se inició la sesión.
Introduzca un paquete PL/SQL por defecto para los
modelos de datos que incluyan disparadores de
evento o un filtro de grupo PL/SQL. El paquete debe
existir en el origen de datos por defecto.
Si define una consulta en una base de datos Oracle
Database, puede incluir disparadores antes o
después de los datos (disparadores de evento) en el
modelo de datos. Los disparadores de eventos
utilizan paquetes PL/SQL para ejecutar funciones de
nivel del RDBMS.

8-8

Propiedad
Timeout de consulta
Activar depuración de SQL
Omitir consulta de juegos de
datos no utilizados
Capítulo 8
Propiedades de modelo de datos
Descripción
Introduzca un límite de tiempo en segundos dentro
del cual la base de datos debe ejecutar sentencias
SQL. Esta propiedad se aplica a modelos de datos
basados en consultas SQL para informes
programados. Si la consulta SQL sigue en
procesamiento al cumplirse la condición del valor
de timeout, se devuelve el error Fallo al
recuperar xml de datos. Introduzca un valor
en segundos. Si no introduce un valor para este
modelo de datos, se utiliza el valor de propiedad del
servidor.
Seleccione esta propiedad para mejorar el tiempo de
procesamiento y reducir el uso de memoria. Esta
propiedad se aplica solo a las consultas de Oracle
Database que utilizan SQL estándar. Si la consulta
devuelve muchas columnas, pero la plantilla de
informe solo utiliza un subjuego, la eliminación de
SQL devuelve solo aquellas columnas que la
plantilla necesita.
Tenga en cuenta que Activar depuración de SQL
también es una propiedad de nivel de servidor. Por
tanto, la propiedad de nivel de modelo de datos se
define por defecto en el nivel de instancia para
heredar la configuración de nivel de instancia o
servidor. Para activar o desactivar la depuración
SQL para este modelo de datos en particular,
seleccione Activar o Desactivar en la lista.
La eliminación de SQL no se aplica a tipos de
plantillas PDF, de Excel y de texto electrónico.
Seleccione esta propiedad para omitir la ejecución
de todos los juegos de datos no utilizados en el
diseño a fin de reducir el tiempo de procesamiento y
el uso de memoria. Por defecto, se ejecutan todos los
juegos de datos de un modelo de datos si se requiere
un juego de datos para la salida. Si un modelo de
datos contiene varios juegos de datos para
diferentes diseños, puede que no todos los diseños
requieran todos los juegos de datos definidos en el
modelo de datos.
Debe definir la propiedad Activar eliminación de
SQL en Activar para utilizar la propiedad Omitir
consulta de juegos de datos no utilizados.
8-9

Propiedad
Activar rastreo de sesión SQL
Nombre de rastreo SQL
Activar depuración de XML
Origen de datos de copia
seguridad
Activar salida de CSV
Capítulo 8
Propiedades de modelo de datos
Descripción
Seleccione esta propiedad para activar el rastreo de
la sesión SQL. Para cada sentencia SQL, el rastreo
contiene:
• Recuentos de análisis, ejecuciones y
recuperaciones
• Tiempo de CPU y tiempo transcurrido
• Lecturas físicas y lógicas
• Número de filas procesadas
• Fallos de caché de biblioteca
• Nombre de usuario para el que se ha producido
cada análisis
• Cada confirmación y rollback
Esta propiedad se aplica a las consultas de Oracle
Database que utilizan SQL estándar.
Los administradores y autores de BI pueden activar
los diagnósticos antes de ejecutar el informe y, a
continuación, descargar los logs de diagnóstico.
Introduzca un nombre para el rastreo SQL.
Seleccione Activado para eliminar juegos de datos
XML con más de 2 GB.
Si activa la depuración de datos XML, Publisher
eliminará los elementos de datos innecesarios y
creará la estructura XML utilizando solo los campos
de datos asignados a los campos de diseño. La
depuración de datos mejora el rendimiento,
especialmente en extracciones de datos
extremadamente grandes.
Los consumidores de informes pueden configurar la
depuración de datos XML al programar un trabajo.
La depuración de datos XML no está soportada para
la plantilla XPT (diseño de Publisher).
Seleccione la propiedad Activar conexión de copia
de seguridad para utilizar el origen de datos de
copia de seguridad.
• Para utilizar el origen de datos de copia de
seguridad solo cuando el primario está inactivo,
seleccione Cambiar a origen de datos de copia
de seguridad si origen de datos primario no
disponible. Tenga en cuenta que cuando el
origen de datos primario está inactivo, el motor
de datos debe esperar una respuesta antes de
cambiar a la copia de seguridad.
• Para utilizar siempre el origen de datos de copia
de seguridad al ejecutar este modelo de datos,
seleccione Usar solo origen datos de copia
seguridad. El uso de la base de datos de copia
de seguridad puede mejorar el rendimiento.
Debe activar una copia de seguridad para el origen
de datos.
Seleccione esta propiedad para generar la salida de
informe solo en un archivo CSV.
8-10
 Capítulo 8
Propiedades de modelo de datos

Propiedad
Optimizar ejecución de
consultas
Emplear varios threads para la
ejecución de consultas
Descripción
Seleccione esta propiedad para permitir que el
procesador de datos optimice la ejecución de
consultas SQL de juegos de datos principales y
secundarios.
Seleccione esta propiedad solo si el modelo de datos
incluye una estructura jerárquica principal-
secundario en un juego de datos SQL. No seleccione
esta opción para los juegos de datos no
estructurados y los que no sean SQL.
Seleccione esta propiedad para crear varias
conexiones de base de datos para consultar juegos
de datos secundarios en paralelo. Si selecciona esta
propiedad, aumenta el número de conexiones a
base de datos por modelo de datos.
Esta propiedad solo se activa si:
• Optimizar ejecución de consultas está
definido en true.
• El modelo de datos tiene más de un juego de
datos.
• El modelo de datos tiene consultas de juegos de
datos secundarios paralelas asociadas al juego
de datos principal.
• El modelo de datos utiliza el origen de datos por
defecto.
Esta propiedad no se puede utilizar si:
• El modelo de datos utiliza disparadores de
eventos.
• El modelo de datos tiene una consulta de juego
de datos asociada de forma lineal al juego de
datos principal.
• El modelo de datos utiliza varios orígenes de
datos.

Opciones de salida XML

Estas opciones definen las características de la estructura de datos XML. Todos los cambios
que se realicen en estas opciones pueden afectar a los diseños que se crean en el modelo
de datos.
• Incluir etiquetas de parámetros: si define parámetros para el modelo de datos,
seleccione esta opción para incluir los valores de parámetro en el archivo de salida XML.
Consulte Adición de parámetros y listas de valores para agregar parámetros al modelo
de datos. Active esta opción cuando desee utilizar el valor de parámetro en el informe.
• Incluir etiquetas vacías para elementos nulos: seleccione esta opción para incluir
elementos con valores nulos en los datos XML de salida. Cuando incluye un elemento
nulo, un elemento solicitado que no contiene ningún dato en el origen de datos se
incluye en la salida XML como una etiqueta XML vacía como se muestra a continuación:
<ELEMENT_ID\>. Por ejemplo, si el elemento MANAGER_ID no tuviera ningún dato y
eligiera incluir elementos nulos, aparecería en los datos de la siguiente forma:
<MANAGER_ID />. Si no selecciona esta opción, no se muestra ninguna entrada para
MANAGER_ID.

8-11
 Capítulo 8
Propiedades de modelo de datos

• Incluir etiquetas de apertura y cierre: seleccione esta opción para incluir

etiquetas de apertura y cierre en los datos XML de salida.
• Incluir etiqueta de lista de grupos: (esta propiedad es para la compatibilidad
con versiones anteriores a 10g y la migración de Oracle Report). Seleccione esta
opción para incluir etiquetas de juego de filas en los datos XML de salida. Si
incluye etiquetas de lista de grupos, la lista de grupos se muestra como otra
jerarquía dentro de los datos.
• Excluir etiquetas para columnas LOB: seleccione esta propiedad para excluir
las etiquetas de elementos XML para columnas LOB. El modelo de datos debe
contener un único juego de datos del tipo de consulta SQL y un único elemento de
datos de objeto grande de caracteres que contenga datos extraídos de un archivo
XML. No puede usar funciones de nivel global, de resumen o de agregado,
elementos basados en expresiones o filtros de grupo.
• Excluir salto de línea y retorno de carro para LOB: seleccione esta opción para
excluir retornos de carro y saltos de línea en los datos.
• Etiqueta XML mostrada: seleccione este formato de visualización para generar
las etiquetas de datos XML en mayúsculas, en minúsculas, o para conservar la
definición que ha suministrado en la estructura de datos.

Fragmentación de datos XML

La fragmentación de datos XML soporta el procesamiento distribuido.
La fragmentación de datos XML es adecuada para informes grandes y de larga
ejecución. Si el administrador selecciona la propiedad de tiempo de ejecución Activar
fragmentación de datos en el nivel de instancia, puede activar la fragmentación de
datos XML para los distintos modelos de datos, informes y trabajos programados.
En un modelo de datos, si hace clic en Fragmentación, selecciona Activar
fragmentación y especifica un atributo en el campo Dividir por, el preprocesador del
modelo de datos utiliza la clave de división para dividir grandes cantidades de datos
XML en varios fragmentos de datos de tamaño gestionable.
Antes de activar la fragmentación de datos XML, es necesario que comprenda sus
limitaciones y recomendaciones de uso.
Fragmentación de datos XML:
• Es más adecuada para mostrar informes mediante una tabla y sin referencias
cruzadas.
• Admite operaciones de ordenación, agrupación, agregación y de referencias
cruzadas solo dentro de la salida fragmentada individual. La salida fusionada no
soporta estas operaciones de datos.
• Agrega números de página a las páginas PDF de la salida fusionada. En la
plantilla de informe, elimine el elemento de numeración de página para evitar
números de página duplicados o solapados en la salida PDF.
• Soporta el cálculo de totales y otras funciones solo en la salida fragmentada
individual, y cada una se restablece con cada salida fragmentada.
• Soporta solo RTF, XPT y eText, y las plantillas XSL.
• Soporta solo los formato de salida PDF, XLSX y de texto.

8-12
 Capítulo 8
Propiedades de modelo de datos

• No soporta varios formatos de salida. Si selecciona la fragmentación de XML para un

trabajo programado, no están permitidas varias salidas.
• No está soportada para los informes en línea.

Adición de anexos al modelo de datos

En la región Anexo de la página se muestran los archivos de datos que haya cargado o
asociado al modelo de datos.

Cómo adjuntar datos de muestra

Tras crear el modelo de datos, debe adjuntar un juego pequeño, pero representativo, de los
datos de muestra generados a partir del modelo de datos. Los datos de muestra se usan en
las herramientas de edición de diseño de Publisher. Si se usa un archivo de ejemplo
pequeño se mejorará el rendimiento durante la fase de diseño.
El editor del modelo de datos proporciona una opción para generar y adjuntar los datos de
muestra. Consulte Prueba de modelos de datos y generación de datos de muestra.
El administrador puede definir un límite para el tamaño del archivo de datos de muestra.

Cómo adjuntar un esquema

El editor del modelo de datos le permite adjuntar un esquema de ejemplo a la definición del
modelo de datos.
Publisher no usa el archivo de esquema. Sin embargo, puede adjuntar el esquema como
referencia para los desarrolladores. El editor del modelo de datos no soporta la generación
de esquemas.

Archivos de datos
Si carga un archivo CSV o XML local de Microsoft Excel como origen de datos para este
informe, el archivo se muestra aquí.
Utilice el botón Refrescar para refrescar este archivo desde el origen local. Para obtener
información sobre la carga de archivos que usar como orígenes de datos, consulte Creación
de juegos de datos.
En la figura siguiente se muestra la región Anexos con datos de muestra y archivos de datos
adjuntos:

8-13
 Capítulo 8
Gestión de orígenes de datos privados

Gestión de orígenes de datos privados

Los desarrolladores de modelos de datos pueden crear y gestionar conexiones de
origen de datos HTTP, del servicio web, OLAP y JDBC privadas sin tener que
depender de un usuario administrador. No obstante, los usuarios administradores
pueden seguir viendo, modificando y suprimiendo conexiones de origen de datos
privadas, si es necesario.
Las conexiones de origen de datos privadas se identifican mediante la palabra
(Private) agregada al final del nombre del origen de datos. Por ejemplo, si crea una
conexión JDBC privada denominada My JDBC Connection, esta se muestra como My
JDBC Connection (Private) en las listas desplegables de orígenes de datos.
Si el usuario tiene el rol de administrador, solo puede crear orígenes de datos públicos
incluso si crea el origen de datos en la página Gestionar orígenes de datos privados.
Para crear una conexión de origen de datos privada:
1. En la barra de herramientas del editor del modelo de datos, haga clic en
Gestionar orígenes de datos privados.
2. Seleccione el separador de tipo de conexión y haga clic en Agregar origen de
datos.
Si está conectado como administrador, el cuadro de diálogo muestra todas las
conexiones de origen de datos; sin embargo, en este cuadro de diálogo solo
puede crear o modificar orígenes de datos JDBC, OLAP, HTTP y de servicio web.
3. Introduzca el nombre de conexión privada y la información de conexión.
4. Haga clic en Probar conexión. Se muestra una confirmación.
5. Haga clic en Aplicar. La conexión de origen de datos privada ya está disponible
para su uso en los juegos de datos.

8-14
9
Creación de juegos de datos
En este tema se describe la creación de juegos de datos, la prueba de modelos de datos y el
almacenamiento de datos de muestra.

Temas:
• Creación de un juego de datos
• Editar un juego de datos existente
• Creación de juegos de datos utilizando consultas SQL
• Creación de un juego de datos con una consulta de MDX con respecto a un origen de
datos de OLAP
• Uso del generador de consultas MDX
• Creación de un juego de datos mediante un análisis
• Uso de análisis de autoservicio
• Creación de un juego de datos mediante un servicio web
• Creación de un juego de datos mediante un archivo XML
• Creación de un juego de datos con un archivo Microsoft Excel
• Creación de un juego de datos mediante un archivo CSV
• Creación de un juego de datos a partir de una fuente XML HTTP
• Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo
de datos
• Prueba de modelos de datos y generación de datos de muestra
• Inclusión de información de usuario almacenada en variables del sistema en los datos
del informe

Creación de un juego de datos

Publisher puede recuperar datos de varios tipos de orígenes de datos.
Para crear un juego de datos:
1. En el panel de componentes del editor de modelo de datos, haga clic en Nuevo juego
de datos y seleccione su tipo de juego de datos de origen.
2. Complete los campos requeridos. Consulte el tema de ayuda del tipo de juego de datos
que desea crear.

Creación de juegos de datos utilizando consultas SQL

En estos temas se explica cómo crear juegos de datos con consultas SQL.
• Introducción de consultas SQL

9-1
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

• Uso de SQL Query Builder

• Adición de una variable de enlace a una consulta
• Adición de referencias léxicas a consultas SQL
• Definición de consultas SQL de Oracle BI Server

Introducción de consultas SQL

Utilice estos pasos para introducir consultas SQL.
Para introducir consultas SQL:
1. Haga clic en Nuevo juego de datos y, a continuación, en Consulta SQL.
2. En el cuadro de diálogo para crear un nuevo juego de datos, introduzca un
nombre para el juego de datos.
3. El origen de datos se define por defecto en el origen de datos por defecto que ha
seleccionado en la página Propiedades. Si no va a utilizar el origen de datos por
defecto para este juego de datos, seleccione el Origen de datos en la lista.
También puede utilizar las conexiones de origen de datos privadas como orígenes
de datos para los juegos de datos de la consulta SQL.
4. Seleccione SQL estándar en la lista desplegable Tipo de SQL. El SQL estándar
se utiliza para las sentencias SELECT normales interpretadas para comprender el
esquema de base de datos.
5. Introduzca la consulta SQL o haga clic en Query Builder para iniciar la página
Query Builder.
6. Si va a utilizar campos flexibles, variables de enlace o algún otro procesamiento
especial en la consulta, edite el código SQL devuelto por Query Builder para
incluir las sentencias necesarias.
Si incluye referencias léxicas para el texto que embebe en una sentencia
SELECT, debe sustituir los valores para obtener una sentencia SQL válida.
7. Después de introducir la consulta, haga clic en Aceptar para guardarla. Para las
consultas SQL estándar, el editor del modelo de datos valida la consulta.
Si la consulta incluye una variable de enlace, se le solicitará que cree el
parámetro de enlace. Haga clic en Aceptar para que el modelo de datos cree el
parámetro de enlace.

Uso de SQL Query Builder

Use el generador de consultas para crear consultas SQL sin codificación. El
generador de consultas le permite buscar y filtrar objetos de base de datos,
seleccionar objetos y columnas, establecer relaciones entre objetos y ver resultados
de consulta con formato a pesar de tener un conocimiento mínimo acerca de SQL.
En esta sección se describe cómo usar el generador de consultas y contiene los
siguientes temas:
• Visión general del generador de consultas
• Creación de una consulta mediante Query Builder
• Tipos de columna soportados

9-2
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

• Adición de objetos al panel de diseño

• Eliminación u ocultación de objetos en el panel de diseño
• Condiciones de consulta
• Creación de relaciones entre objetos
• Guardar una consulta
• Edición de una consulta guardada

Visión general del generador de consultas

La página Generador de consultas se divide en un panel Selección de objetos y un panel de
diseño y salida.
• El panel Selección de objetos contiene una lista de objetos desde la que puede crear
consultas. Solo se muestran los objetos del esquema actual.
• El panel de diseño y salida consta de cuatro separadores:
– Modelo: muestra los objetos seleccionados en el panel Selección de objetos.
– Condiciones: le permite aplicar condiciones a sus columnas seleccionadas.
– SQL: muestra la consulta.
– Resultados: muestra los resultados de la consulta.

Creación de una consulta mediante Query Builder

Puede crear una consulta mediante Query Builder.
Para crear una consulta mediante Query Builder:
1. Seleccione un esquema.
La lista Esquema muestra todos los esquemas disponibles en el origen de datos. Puede
que no tenga acceso a todos los esquemas de esta lista.
2. Agregue objetos al panel Diseño y seleccione columnas.
El panel Selección de objetos muestra las tablas, las vistas y las vistas materializadas
del esquema seleccionado. En una base de datos Oracle Database, el panel también
muestra los sinónimos. Cuando selecciona un objeto en la lista, este se muestra en el
panel Diseño. Utilice el panel Diseño para especificar cómo se deben utilizar los objetos
seleccionados en la consulta.
Puede que necesite utilizar el campo Buscar para introducir una cadena de búsqueda.
Si el origen de datos incluye más de 100 tablas, utilice la función Buscar para buscar y
seleccionar objetos.
3. Opcional: Establezca relaciones entre objetos.
4. Agregue un nombre de alias único para cualquier columna duplicada.
5. Opcional: Cree condiciones de consulta.
6. Ejecute la consulta y visualice los resultados.

9-3
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

Tipos de columna soportados

Todos los tipos de columna se muestran como objetos en el panel Diseño. No puede
seleccionar más de 60 columnas para cada consulta.
Cuando utiliza el gateway de datos para conectarse a un origen de datos, las
consultas SQL solo soportan los tipos de datos STRING, CHAR, VARCHAR, NCHAR,
NVARCHAR, DATE, TIMESTAMP, NUMBER, INTEGER, FLOAT y DOUBLE. Si una
consulta SQL para acceder a un origen de datos conectado a través del gateway de
datos contiene un tipo de dato no soportado, recibirá un mensaje de error.

Tipo de columna soportado Restricciones

VARCHAR2, CHAR NA
NUMBER NA
DATE, TIMESTAMP El tipo de dato TIMESTAMP WITH LOCAL
TIMEZONE no está soportado.
Objeto Binario Grande (BLOB) El BLOB puede ser una imagen, un texto o
datos XML. Cuando ejecuta la consulta en
Query Builder, el BLOB no se muestra en el
panel Resultados; sin embargo, la consulta
se construye correctamente cuando se
guarda en el editor del modelo de datos.
Los datos BLOB no están soportados para
un origen de datos de Oracle BI EE debido a
las limitaciones del controlador BIJDBC.
Utilice una plantilla RTF si desea utilizar
una columna de datos BLOB con un tipo de
dato de imagen.
Objeto grande de caracteres (CLOB) Publisher no soporta la consulta de
columnas CLOB en un origen de datos de
Oracle BI EE.

Adición de objetos al panel de diseño

Seleccione cada objeto que desee agregar al panel de diseño.
• Cuando agrega un objeto, aparece un icono que representa al tipo de dato junto a
cada nombre de columna.
• Cuando selecciona una columna, esta aparece en el separador Condiciones. La
casilla de control Mostrar en el separador Condiciones controla si una columna
está incluida en los resultados de la consulta. Por defecto, esta casilla de control
está seleccionada.
• Para seleccionar las primeras veinte columnas, haga clic en el icono pequeño en
la esquina superior izquierda del objeto y, a continuación, seleccione, Activar
todo.
• También puede ejecutar una consulta pulsando las teclas CTRL + INTRO.
Para agregar objetos al panel de diseño:
1. Seleccione un objeto.
2. Seleccione la casilla de control de cada columna que desee incluir en la consulta.
3. Para ejecutar la consulta y ver los resultados, seleccione Resultados.

9-4
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

Eliminación u ocultación de objetos en el panel de diseño

Puede eliminar u ocular los objetos en el panel Diseño.
Para eliminar un objeto:
1. Haga clic en Eliminar en la esquina superior derecha del objeto.
Para ocultar temporalmente las columnas de un objeto:

• Haga clic en Mostrar/Ocultar columnas.

Condiciones de consulta
Las condiciones le permiten filtrar e identificar los datos con los que desea trabajar.
A medida que selecciona columnas dentro de un objeto, puede especificar condiciones en el
separador Condiciones. Puede modificar el alias de columna, aplicar condiciones de
columna, ordenar columnas o aplicar funciones.

Atributo Condición Descripción

Condición La condición modifica la cláusula WHERE de la consulta. Al especificar
una condición de columna, debe incluir el operador y el operando
adecuados. Todas las condiciones SQL estándar están soportadas. Por
ejemplo:
>=10
='VA'
IN (SELECT dept_no FROM dept)
BETWEEN SYSDATE AND SYSDATE + 15
Función Especifica las funciones. Las funciones de argumento disponibles
incluyen:
• Columnas de número: COUNT, COUNT DISTINCT, AVG, MAXIMUM,
MINIMUM, SUM
• Columnas VARCHAR2, CHAR: COUNT, COUNT DISTINCT, INITCAP,
LENGTH, LOWER, LTRIM, RTRIM, TRIM, UPPER
• Columnas DATE, TIMESTAMP: COUNT, COUNT DISTINCT
Agrupar por Especifica las columnas que se van a utilizar para el agrupamiento
cuando se utilice una función de agregado. Solo se aplica para las
columnas incluidas en la salida.

A medida que selecciona columnas y define condiciones, Query Builder escribe la sentencia
SQL. Para ver la sentencia SQL subyacente, seleccione el separador SQL.

Creación de relaciones entre objetos

Puede crear relaciones entre objetos mediante la creación de una unión. Una unión identifica
una relación entre dos o más tablas, vistas o vistas materializadas.
• Acerca de las condiciones de unión
• Unión objetos manualmente

9-5
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

Acerca de las condiciones de unión

Cuando escribe una consulta de unión, especifica una condición que transmite una
relación entre dos objetos. Esta condición se denomina una condición de unión.
Una condición de unión especifica cómo se combinan las filas de un objeto con las
filas de otro objeto.
El generador de consultas soporta uniones internas, externas, de izquierda y de
derecha.
• Una unión interna, también denominada una unión simple, devuelve las filas que
cumplen la condición de unión.
• Una unión externa amplía el resultado de una unión simple.
Una unión externa devuelve todas las filas que cumplen la condición de unión, y
devuelve además algunas o todas las filas de una tabla para las que ninguna de
las filas de la otra cumple la condición de unión.

Unión objetos manualmente

Cree una unión de forma manual mediante la selección de la columna de unión en el
panel Diseño.
Para unir objetos manualmente:
1. En el panel Selección de objetos, seleccione los objetos que desee unir.
2. Identifique las columnas que desee unir.
Puede crear una unión seleccionando la columna Unir situada junto al nombre de
columna. La columna Unir aparece a la derecha del tipo de dato. Cuando el
cursos se sitúa en la posición adecuada, aparece el siguiente consejo de ayuda:
Haga clic aquí para seleccionar la columna que unir
3. Seleccione la columna Unir adecuada para el primer objeto.
Cuando se selecciona, la columna Unir se oscurece. Para anular la selección de
una columna Unir, solo tiene que volver a seleccionarla o pulsar ESC.
4. Seleccione la columna Unir adecuada para el segundo objeto.
Cuando se une, una línea conecta las dos columnas. A continuación aparece un
ejemplo.

9-6
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

5. Seleccione las columnas que se van a incluir en la consulta. Puede ver la sentencia SQL
que resulta de la unión colocando el cursor sobre la línea de unión.
6. Haga clic en Resultados para ejecutar la consulta.

Guardar una consulta

Guarde consultas tras crearlas.
Una vez que haya creado una consulta, haga clic en Guardar para volver al editor del
modelo de datos. La consulta aparece en el cuadro Consulta SQL. Haga clic en Aceptar
para guardar el juego de datos.

Edición de una consulta guardada

Cuando se guarda una consulta del generador de consultas en el editor del modelo de datos,
también puede utilizar el generador de consultas para editar la consulta.
Si ha realizado modificaciones en la consulta o no ha utilizado el generador de consultas
para construirla, es posible que reciba un error al iniciar el generador de consultas para
editar la consulta. Si el generador de consultas no puede analizar la consulta, puede editar
las sentencias directamente en el cuadro de texto.
No puede editar una consulta personalizada ni una avanzada con el generador de consultas.
Para editar una consulta guardada:

9-7
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

1. Seleccione el juego de datos SQL.

2. En la barra de herramientas, haga clic en Editar juego de datos seleccionado
para iniciar el cuadro de diálogo Editar juego de datos.
3. Haga clic en Generador de consultas para cargar la consulta en el generador de
consultas.
4. Edite la consulta y haga clic en Guardar.

Adición de una variable de enlace a una consulta

Después de crear una consulta, es posible que desee que los usuarios puedan
transferir un parámetro a la consulta para limitar los resultados.
Para agregar una variable de enlace a una consulta:
1. En el generador de consultas, haga clic en el separador Condiciones.
2. Para la columna a la que desea agregar una variable de enlace, introduzca el
nombre de parámetro con el siguiente formato:
in (:PARAMETER_NAME)
Una vez que ha editado la consulta, el generador de consultas ya no puede
analizarla. Debe realizar todas las ediciones adicionales manualmente.
Por ejemplo, en la lista de empleados, desea que los usuarios seleccionen un
departamento específico.
En la imagen se muestran las columnas de la tabla de departamento.

Adición de una variable de enlace mediante un editor de texto

Utilice el editor del modelo de datos para actualizar una consulta SQL.
1. En el cuadro de texto Editar juego de datos, actualice la consulta SQL mediante la
adición de lo siguiente después de la cláusula where en la consulta.
and "COLUMN_NAME" in (:PARAMETER_NAME)
Por ejemplo:
and "DEPARTMENT_NAME" in (:P_DEPTNAME)
donde P_DEPTNAME es el nombre que elija para el parámetro, como se muestra a
continuación.

9-8
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

2. Haga clic en Guardar.

3. En el editor del modelo de datos, cree el parámetro que ha introducido con la sintaxis de
variable de enlace como se muestra en la imagen.

4. Seleccione el parámetro y haga clic en Aceptar para que el editor del modelo de datos
cree la entrada del parámetro.

Adición de referencias léxicas a consultas SQL

Puede utilizar referencias léxicas para sustituir las cláusulas que aparecen después de
SELECT, FROM, WHERE, GROUP BY, ORDER BY o HAVING.
Utilice una referencia léxica cuando desee que el parámetro sustituya varios valores en
tiempo de ejecución. También puede utilizar referencias léxicas para incluir campos flexibles

9-9
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

en la consulta. Las referencias léxicas solo están soportadas en las consultas de

aplicaciones de Fusion Applications Suite.
Cree una referencia léxica en la consulta SQL mediante la siguiente sintaxis:
&parametername

1. Antes de crear la consulta, defina un parámetro en el paquete por defecto PL/SQL

para cada referencia léxica en la consulta. El motor de datos utiliza estos valores
para sustituir los parámetros léxicos.
2. En el editor del modelo de datos, en la página Propiedades, especifique el
Paquete por defecto Oracle DB.
3. En el editor del modelo de datos, cree un disparador de eventos Antes de datos
para llamar al paquete PL/SQL.
4. Cree una consulta SQL que contenga las referencias léxicas.
5. Al hacer clic en Aceptar para cerrar la consulta SQL, se le solicitará que
introduzca el parámetro.
Por ejemplo, cree un paquete denominado employee. En el paquete employee, defina
un parámetro denominado where_clause:

Package employee
AS
where_clause varchar2(1000);
.....

Package body employee

AS
.....
where_clause := 'where DEPARTMENT_ID=10';
.....

Haga referencia al parámetro léxico de la consulta SQL donde desee que el

parámetro se sustituya por el código definido en el paquete; por ejemplo:

select "EMPLOYEES"."EMPLOYEE_ID" as "EMPLOYEE_ID",

"EMPLOYEES"."FIRST_NAME" as "FIRST_NAME",
"EMPLOYEES"."LAST_NAME" as "LAST_NAME",
"EMPLOYEES"."SALARY" as "SALARY",
from "OE"."EMPLOYEES" "EMPLOYEES"
&where_clause

Al hacer clic en Aceptar en el cuadro de diálogo Crear juego de datos SQL, el cuadro
de diálogo de referencia léxica le solicita que introduzca un valor para las referencias
léxicas que ha introducido en la consulta SQL, como se muestra en la imagen
siguiente. Introduzca el valor de la referencia léxica como está definido en el paquete
PL/SQL.

9-10
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

En tiempo de ejecución, el motor de datos sustituye &where_clause por el contenido de

where_clause definido en el paquete.

Acerca de la definición de consultas SQL de Oracle BI Server

En este tema se describen los puntos que debe recordar al definir consultas SQL de Oracle
BI Server.
Tenga en cuenta los siguientes puntos al crear un juego de datos en Oracle BI Server:
• Al crear una consulta SQL de Oracle BI Server utilizando el editor de datos SQL o Query
Builder, se genera un SQL lógico, y no un SQL físico como otros orígenes de base de
datos.
• Las columnas jerárquicas no están soportadas. Siempre se devuelve el nivel más alto.
• Dentro de un área temática, siempre se crean las condiciones de unión entre tablas; por
lo tanto, no tiene que crear uniones en Query Builder. Query Builder no muestra la clave
primaria.
Puede enlazar juegos de datos mediante la función Crear enlace del editor del modelo
de datos. Consulte Creación de enlaces de nivel de elemento. Para los juegos de datos
creados desde Oracle BI Server, hay un límite de dos enlaces de nivel de elemento para
un único modelo de datos.
• En Query Builder, las funciones Orden de clasificación y Agrupar por mostradas en el
separador Condiciones no están soportadas para las consultas de Oracle BI Server. Si
introduce un Orden de clasificación o selecciona la casilla de control Agrupar por, Query
Builder construye la sentencia SQL y la escribe en el cuadro de texto Consulta SQL de
Publisher, pero si intenta cerrar el cuadro de diálogo Juego de datos, falla la validación
de la consulta.
Para aplicar la agrupación en los datos recuperados por la consulta SQL, puede utilizar
la función Agrupar por del editor del modelo de datos en su lugar. Consulte Creación de
subgrupos.
• Si transfiere parámetros a Oracle BI Server y selecciona Valor nulo transferido en Puede
seleccionar todo, asegúrese de gestionar el valor nulo en la consulta.

9-11
 Capítulo 9
Creación de juegos de datos utilizando consultas SQL

Definición de consultas SQL de Oracle BI Server

Cuando se inicia Query Builder en Oracle BI Server, Query Builder muestra las áreas
temáticas del catálogo. Puede arrastrar las áreas temáticas al espacio de trabajo de
Query Builder para mostrar las columnas. Seleccione las columnas que desee incluir
en el modelo de datos.
Para definir consultas SQL de Oracle BI Server :
1. En el editor del modelo de datos, haga clic en Nuevo juego de datos y, a
continuación, en Consulta SQL.
2. Introduzca un nombre para el juego de datos.
3. En la lista Origen de datos, seleccione la conexión Oracle BI Server, que
normalmente se muestra como Oracle BI EE.
4. Haga clic en Query Builder para iniciar la página Query Builder.
También puede introducir la sintaxis SQL manualmente en el cuadro de texto
Consulta SQL; no obstante, debe utilizar la sintaxis Sentencia SQL lógica utilizada
por Oracle BI Server.
5. En la lista desplegable Catálogo, seleccione un área temática como se muestra a
continuación. En la lista se muestran las áreas temáticas definidas en Oracle BI
Server.

6. Seleccione tablas y columnas para la consulta.

7. Haga clic en Guardar.
8. Haga clic en Aceptar para volver al editor del modelo de datos. La sentencia SQL
generada en una sentencia SQL lógica que sigue un esquema de estrella (es
decir, no es una sentencia SQL física).
9. Guarde los cambios realizados en el modelo de datos.

9-12
 Capítulo 9
Creación de un juego de datos con una consulta de MDX con respecto a un origen de datos de OLAP

Creación de un juego de datos con una consulta de MDX con

respecto a un origen de datos de OLAP
Publisher soporta consultas de expresiones multidimensionales (MDX) con respecto a
orígenes de datos de OLAP.
MDX le permite consultar objetos multidimensionales, como cubos de Essbase y devolver
juegos de celdas multidimensionales que contengan datos del cubo. Para crear consultas de
MDX, introduzca manualmente la consulta de MDX o use generador de consultas MDX para
crear la consulta.
• Creación de un juego de datos con una consulta de MDX
• Uso del generador de consultas MDX

Creación de un juego de datos con una consulta de MDX

Puede crear consultas MDX introduciendo la consulta MDX manualmente o utilizando el
generador de consultas MDX para crear la consulta.
En el origen de datos de OLAP, no utilice caracteres Unicode del rango U+F900 a U+FFFE
para definir atributos de metadatos como nombres de columna o nombres de tabla. Este
rango de Unicode incluye Japanese Katakana de ancho medio y variantes ASCII de ancho
completo. El uso de estos caracteres provoca errores cuando se generan datos XML para un
informe de visualización perfecta.
Para crear un juego de datos mediante una consulta MDX:
1. En la barra de herramientas, haga clic en Nuevo juego de datos y, a continuación,
seleccione Consulta MDX.
A continuación, se muestra el cuadro de diálogo Nuevo juego de datos - Consulta MDX.

2. Introduzca un nombre para el juego de datos.

3. Seleccione el origen de datos para el juego de datos. Solo se muestran en la lista los
orígenes de datos definidos como conexiones OLAP.

9-13
 Capítulo 9
Uso del generador de consultas MDX

Todas las conexiones de origen de datos OLAP privadas que haya creado
también estarán disponibles en la lista desplegable Origen de datos.
4. Introduzca la consulta MDX o haga clic en Query Builder.
5. Haga clic en Aceptar para guardar. El editor del modelo de datos valida la
consulta.

Uso del generador de consultas MDX

Utilice el generador de consultas MDX para generar consultas MDX básicas sin tener
que codificarlas. El generador de consultas MDX le permite agregar dimensiones a
ejes de columnas, filas, páginas y punto de vista, así como obtener una vista previa
de los resultados de la consulta.
MDX Query Builder solo le permite crear juegos de datos de orígenes de datos de
Essbase. Para los orígenes de datos de OLAP restantes, debe crear la consulta
manualmente.
• Descripción del proceso de generación de consultas MDX
• Uso del cuadro de diálogo Seleccionar cubo
• Selección de dimensiones y medidas
• Realización de acciones de consulta MDX
• Aplicación de filtros de consulta MDX
• Selección de opciones de consulta MDX y guardado de consultas MDX

Descripción del proceso de generación de consultas MDX

Puede crear consultas MDX introduciendo la consulta MDX manualmente o utilizando
el generador de consultas MDX para crear la consulta.
Para usar el generador de consultas de MDX para crear una consulta de MDX:
1. En la barra de herramientas, haga clic en Nuevo juego de datos y, a
continuación, seleccione Consulta de MDX para iniciar el cuadro de diálogo
Nuevo juego de datos - Consulta de MDX.
2. Introduzca un nombre para el juego de datos.
3. Seleccione un origen de datos.
4. Inicie el generador de consultas de MDX.
5. Seleccione un cubo de Essbase para la consulta.
6. Para seleccionar las dimensiones y las medidas, arrástrelas y suéltelas en los
ejes Columnas, Filas, Divisor/Punto de Vista y Páginas.
7. Opcional: Utilice acciones para modificar la consulta.
8. Opcional: Aplique filtros.
9. Defina las opciones de consulta y guarde la consulta.

9-14
 Capítulo 9
Uso del generador de consultas MDX

Uso del cuadro de diálogo Seleccionar cubo

En el cuadro de diálogo Seleccionar cubo, seleccione el cubo de Essbase que desea usar
para crear la consulta de MDX.
La conexión al origen de datos de MDX que haya seleccionado previamente determina los
cubos de Essbase que se pueden seleccionar.

Selección de dimensiones y medidas

Puede crear consultas MDX mediante la selección, de dimensiones para los ejes Columnas,
Filas, Divisor/punto de vista y Páginas.
Los miembros de la dimensión Cuenta se muestra individualmente por nombre de miembro.
Todos los demás miembros de dimensión se representan por nombre de generación, como
se muestra a continuación.
Puede arrastrar generaciones de dimensión y medidas individuales desde la dimensión
Cuenta a los ejes Columnas, Filas, Divisor/punto de vista y Páginas.

Cree la consulta mediante el arrastre de miembros de dimensión o medidas desde el panel

Dimensiones a una de las siguientes áreas de eje:
• Columnas: eje (0) de la consulta
• Filas: eje (1) de la consulta
• Divisor/punto de vista: el eje divisor le permite limitar una consulta a solo una porción
específica del cubo de Essbase. Representa la cláusula WHERE opcional de una
consulta.

9-15
 Capítulo 9
Uso del generador de consultas MDX

• Páginas: eje (2) de la consulta

Puede anidar miembros de dimensión en los ejes Columnas y Filas, pero solo puede
agregar una única dimensión al eje Divisor/punto de vista.

Adición de miembros de dimensión en el eje Divisor/Punto de vista

Al agregar una dimensión al eje Divisor/Punto de vista, se abre el cuadro de diálogo
Selección de miembro.
Solo puede seleccionar un miembro de dimensión para este eje. Solo tiene que
seleccionar la dimensión en el cuadro de diálogo Selección de miembro y, a
continuación, hacer clic en Aceptar.
El cuadro de diálogo Selección de miembro no aparece si agrega una medida al eje
Divisor/Punto de vista.

Realización de acciones de consulta MDX

La barra de herramientas Generador de consultas de MDX contiene los siguientes
botones para modificar la consulta de MDX:
• Haga clic en Intercambiar filas y Columnas para cambiar las dimensiones entre
las columnas y las filas.
• Haga clic en Acciones para mostrar las siguientes opciones de menú para
selección:
– Seleccionar cubo: selecciona un cubo de Essbase distinto para la consulta.
– Definir tabla de alias: selecciona la tabla de alias usada para los nombres
mostrados de la dimensión. Los nombres de alias se usan para fines de
visualización y no se usan en la consulta.
– Refrescamiento automático: muestra los resultados como miembros de
dimensión en los ejes Columnas, Filas, Divisor/Punto de vista y Páginas y
refresca automáticamente la sintaxis de la consulta de MDX.
– Borrar resultados: borra los resultados y elimina las selecciones de
miembros de todos los ejes y cualquier filtro agregado a la consulta.
– Mostrar columnas vacías: muestra las columnas que no contienen datos.
– Mostrar filas vacías: muestra las filas que no contienen datos.
– Mostrar consulta: muestra la sintaxis de la consulta de MDX resultante de
cómo se colocan las dimensiones en los ejes Columnas, Filas, Divisor/Punto
de vista y Páginas.

9-16
 Capítulo 9
Uso del generador de consultas MDX

Aplicación de filtros de consulta MDX

Puede crear filtros para dimensiones en los ejes Columnas, Filas y Páginas en el generador
de consultas MDX para optimizar aún más la consulta MDX.

Puede crear varios filtros para una consulta, pero solo puede crear un filtro para cada uno de
los ejes Columnas, Filas o Páginas.
• Para crear un filtro, haga clic en el botón de flecha abajo de una dimensión en el eje,
Columnas, Filas o Página para mostrarlo en el área Filtros. Cree el filtro mediante la
selección del miembro de dimensión deseado, como se muestra a continuación.

Selección de opciones de consulta MDX y guardado de consultas MDX

Utilice el cuadro de diálogo Opciones para seleccionar las propiedades de dimensión a fin de
incluirlas en la consulta para cada una de las dimensiones en los ejes Columnas, Filas y
Páginas.
Para seleccionar las opciones de consulta MDX y guardar la consulta:
1. Una vez que ha creado la consulta, haga clic en Guardar para mostrar el cuadro de
diálogo Opciones.
2. Seleccione las propiedades de dimensión.
Las propiedades de dimensión son las siguientes:
• Alias de miembro: nombres de alias de miembros de la dimensión según el
esquema de Essbase.
• Nombres de ascendientes: nombres de dimensión de ascendientes según el
esquema de Essbase.
• Número de nivel: números de nivel de dimensión según el esquema de Essbase.
• Número de generación: número de generación de las dimensiones según el
esquema de Essbase.

9-17
 Capítulo 9
Creación de un juego de datos mediante un análisis

Por ejemplo, si selecciona las propiedades Alias de miembro y Número de nivel

para Columnas, los resultados de la consulta MDX son los siguientes:

SELECT
NON EMPTY Hierarchize([Market].Generations(2).Members)
PROPERTIES MEMBER_ALIAS,LEVEL_NUMBER ON Axis(0),
NON EMPTY CROSSJOIN(Hierarchize([Product].Generations(3).Members),
{[Accounts].[Margin],[Accounts].[Sales],[Accounts].
[Total_Expenses]})ON Axis(1),
NON EMPTY [Year].Generations(3).Members ON Axis(2) FROM Demo.Basic

3. Haga clic en Aceptarpara regresar al cuadro de diálogo Nuevo juego de datos -

Consulta MDX y revise la salida de la consulta MDX como se muestra a
continuación.
4. Haga clic en Aceptar para regresar al editor del modelo de datos y guardar los
cambios.
Si modifica una consulta MDX después de guardarla en Publisher, Oracle
recomienda que guarde manualmente la sintaxis y que no utilice el generador de
consultas MDX para hacerlo.

Creación de un juego de datos mediante un análisis

Puede utilizar el catálogo de presentación de Oracle BI para seleccionar un análisis
como origen de datos.
Un análisis es una consulta realizada en los datos de una organización que
proporciona respuestas a peticiones de negocio. Una consulta contiene las sentencias
SQL subyacentes que se emiten a Oracle BI Server.
Las columnas jerárquicas no están soportadas en los modelos de datos de Publisher
Cree un juego de datos utilizando un análisis:
1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y
seleccione Análisis.
2. En el cuadro de diálogo Nuevo juego de datos - Análisis, introduzca un nombre
para este juego de datos.
3. Haga clic en el icono de examinar para conectarse al catálogo de presentación de
Oracle BI.
4. Cuando se inicie el cuadro de diálogo de conexión al catálogo, desplácese por las
carpetas para seleccionar el análisis que desee utilizar como juego de datos para
el informe.
5. Introduzca un valor de Timeout en segundos. Si Publisher no ha recibido los
datos del análisis una vez transcurrido el tiempo especificado en el valor de
timeout, Publisher dejará de intentar recuperar los datos del análisis.
6. Haga clic en Aceptar.

9-18
 Capítulo 9
Uso de análisis de autoservicio

Notas adicionales sobre juegos de datos de análisis

Los parámetros y las listas de valores se heredan de los análisis y se muestran en tiempo de
ejecución.
El análisis debe tener valores por defecto para las variables de filtro. Si el análisis contiene
variables de presentación sin variables por defecto, no puede utilizarlo como origen de datos
para los informes en Publisher.
No puede utilizar divisiones de grupo, filtros de grupo, enlaces de datos ni funciones de nivel
de grupo al estructurar datos basados en juegos de datos para un análisis. Puede utilizar
funciones de nivel de grupo y definir valores para elementos nulos.

Uso de análisis de autoservicio

Puede utilizar análisis de autoservicio para crear juegos de datos para informes.
En Oracle Analytics, puede cargar datos de una gran variedad de orígenes (por ejemplo,
hojas de cálculo, archivos CSV y muchas bases de datos) en el sistema, así como explorar
los datos para buscar correlaciones, detectar patrones y ver las tendencias.
Utilice el editor de juegos de datos para capturar los datos analizados en juegos de datos
que incluyen tablas y uniones. Puede utilizar estos flujos de datos y juegos de datos de
autoservicio para generar informes en línea e informes fuera de línea (informes
programados).

Nota:
Después de importar un juego de datos de autoservicio en Publisher, si cambia la
estructura del juego de datos de autoservicio, debe editar y refrescar manualmente
dicho juego de datos de autoservicio. No puede importar las expresiones ni los
elementos calculados por el usuario de un juego de datos de autoservicio en un
modelo de datos de Publisher. No puede establecer enlaces entre juegos de datos.

Creación de un juego de datos mediante un juego de datos de autoservicio

Puede utilizar juegos de datos de autoservicio que contengan una o más tablas para crear
juegos de datos.
1. En el panel de componentes del editor del modelo de datos, seleccione Juego de datos
y seleccione Datos de DV.
El separador Juegos de datos muestra todos los juegos de datos de autoservicio.
2. En el separador Juegos de datos, seleccione el juego de datos que desee utilizar para la
generación de informes de visualización perfecta.
3. Seleccione las columnas de cada tabla que desee utilizar en el juego de datos para la
generación de informes.
4. Haga clic en Siguiente.
5. Introduzca un nombre para el juego de datos.
6. Si desea configurar parámetros, realice los siguientes pasos para cada parámetro.

9-19
 Capítulo 9
Creación de un juego de datos mediante un servicio web

a. Haga clic en Agregar parámetro.

b. Seleccione una columna en la lista Nombre de columna.
c. Si desea cambiar el nombre del parámetro, edite el nombre en el campo
Parámetro.
7. Haga clic en Finalizar.

Creación de un juego de datos mediante un flujo de datos de

autoservicio
Puede utilizar flujos de datos de autoservicio para crear juegos de datos.
No puede utilizar los siguientes tipos de flujos de datos para crear juegos de datos:
• Flujos de datos creados con la opción Guardar modelo.
• Flujos de datos con juegos de datos bifurcados.
1. Seleccione Juegos de datos, haga clic en Nuevo juego de datos en el
separador Diagrama y, a continuación, seleccione Datos de DV.
2. En el separador Flujos de datos, seleccione el flujo de datos que desee utilizar y
haga clic en Siguiente.
3. Introduzca un nombre para el juego de datos.
4. Si desea configurar parámetros, realice los siguientes pasos para cada parámetro.
a. Haga clic en Agregar parámetro.
b. Seleccione una columna en la lista Nombre de columna.
c. Si desea cambiar el nombre del parámetro, edite el nombre en el campo
Parámetro.
5. Haga clic en Finalizar.

Creación de un juego de datos mediante un servicio web

Publisher soporta juegos de datos que utilizan orígenes de datos de servicio web
simples y complejos para devolver datos XML válidos. Solo están soportados los
servicios web de documento/literal.
Se recomiendo que defina primero los parámetros, de modo que los métodos estén
disponibles para su selección al configurar el origen de datos. Los parámetros se
deben configurar en la sección Parámetros de la definición de informe.
El uso de varios parámetros está soportado. Asegúrese de que el nombre del método
sea correcto y de que el orden de los parámetros coincida con el orden en el método.
Para llamar a un método en el servicio web que acepte dos parámetros, debe asignar
dos parámetros definidos en el informe a los dos parámetros en el método. Tenga en
cuenta que solo están soportados los parámetros del tipo simple; por ejemplo, cadena
y entero.

Opciones de origen de datos de servicio web

El administrador puede configurar los datos de un servicio web como origen de datos.

9-20
 Capítulo 9
Creación de un juego de datos mediante un servicio web

El administrador puede configurar conexiones a orígenes de datos de servicio web y,

posteriormente, puede utilizar el origen de datos en varios modelos de datos. Debe
configurar la conexión para poder crear el modelo de datos.
Publisher soporta juegos de datos que utilizan orígenes de datos de servicio web simples y
complejos para devolver datos XML válidos.

Creación de un juego de datos mediante un servicio web simple

Si no está familiarizado con los métodos y los parámetros disponibles en el servicio web al
que se va a llamar, puede abrir la URL en un explorador para verlos.
Para crear un juego de datos mediante un servicio web simple:
1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y, a
continuación, seleccione Servicio web.
2. Introduzca el nombre del juego de datos.
3. Seleccione el origen de datos y el método.
4. Haga clic en Aceptar.
5. En el panel Modelo de datos, seleccione Parámetros, haga clic en Crear nuevo
parámetro y defina los parámetros para que estén disponibles para el juego de datos del
servicio web.
6. Edite el juego de datos del servicio web y agregue los parámetros al juego de datos.
7. Haga clic en Guardar.

Creación de un juego de datos mediante un servicio web complejo

Puede utilizar orígenes de datos de un servicio web complejo para devolver datos XML
válidos. Un tipo de servicio web complejo utiliza internamente soapRequest/soapEnvelope
para transferir los valores de parámetro al host de destino.
Para crear un juego de datos mediante un servicio web complejo:
1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y, a
continuación, seleccione Servicio web.
2. Introduzca el nombre del juego de datos, el origen de datos y el método.
Los métodos disponibles para su selección están basados en el origen de datos del
servicio web complejo. Cuando selecciona un método, se muestran los Parámetros.
Para ver los parámetros opcionales, seleccione Mostrar parámetros opcionales.
Si no está familiarizado con los métodos y los parámetros disponibles en el servicio web,
abra la URL de WSDL URL en un explorador para visualizarlos.
3. Si el inicio de los datos XML para el informe está demasiado embebido en la respuesta
XML generada por la solicitud de servicio web, en el campo Datos de respuesta XPath,
especifique la ruta de acceso a los datos que se van a utilizar en el informe.
4. Agregue los parámetros necesarios para el servicio web.
5. Pruebe el servicio web.

9-21
 Capítulo 9
Creación de un juego de datos mediante un archivo XML

Información adicional en los juegos de datos de servicio web

Como no hay metadatos disponibles de los juegos de datos de servicios web, no
están soportados ni el enlace ni la agrupación.

Creación de un juego de datos mediante un archivo XML

Puede usar un archivo XML para crear un origen de datos.
Puede:
• Coloque el archivo XML en un directorio que su administrador haya configurado
como origen de datos.
• Cargue el archivo XML en el modelo de datos de un directorio local.
Para usar el editor de diseño y el visor interactivo, guarde datos de muestra del origen
de archivo XML en el modelo de datos.

Acerca de los archivos XML soportados

El soporte de archivos XML como tipo de juego de datos en Publisher sigue unas
directrices determinadas.
• Los archivos XML que utiliza como entrada para el motor de datos de Publisher
deben estar codificados en UTF-8.
• No utilice los siguientes caracteres en los nombres de etiqueta XML: ~, !, #, $, %,
^, &, *, +, `, |, :, \", \\, <, >, ?, ,, /. Si el archivo de origen de datos contiene alguno
de estos caracteres, utilice el separador Estructura del editor del modelo de datos
para cambiar los nombres de etiqueta a uno que sea aceptable.
• Utilice archivos XML válidos. Oracle proporciona muchas utilidades y métodos
para validar archivos XML.
• No hay ningún metadato disponible de los juegos de datos de archivo XML, por lo
que la agrupación y el enlace no están soportados.

Carga de un archivo XML almacenado localmente

Puede crear juegos de datos con archivos XML almacenados localmente.
Para crear un juego de datos con un archivo XML almacenado localmente:
1. En la barra de herramientas, haga clic en Nuevo juego de datos y seleccione
Archivo XML.
2. Introducir un nombre para el juego de datos.
3. Haga clic en Cargar junto al campo Nombre de archivo para buscar y actualizar
el archivo XML desde un directorio local. Si se ha cargado el archivo al modelo de
datos, puede seleccionarlo en la lista Nombre de archivo.
4. Haga clic en Cargar.
5. Haga clic en Aceptar.
6. (Necesario) Guarde los datos de muestra en el modelo de datos.

9-22
 Capítulo 9
Creación de un juego de datos mediante Content Server

Refrescamiento y supresión de un archivo XML cargado

Puede refrescar y suprimir archivos XML cargados locales.
Después de cargar el archivo, este se muestra en el panel Propiedades del modelo de
datos en la región Anexos, como se muestra a continuación.

Para refrescar el archivo local en el modelo de datos:

1. En el panel de componentes, haga clic en Modelo de datos para ver la página
Propiedades.
2. En la región Anexo de la página, busque el archivo en la lista Archivos de datos.
3. Haga clic en Refrescar.
4. En el cuadro de diálogo Cargar, busque y cargue la versión más reciente del archivo. El
archivo debe tener el mismo nombre; de lo contrario, no sustituirá la versión anterior.
5. Guarde el modelo de datos.
Para suprimir el archivo local:
1. En el panel de componentes, haga clic en Modelo de datos para ver la página
Propiedades.
2. En la región Anexo de la página, busque el archivo en la lista Archivos de datos.
3. Haga clic en Suprimir.
4. Haga clic en Aceptar para confirmar.
5. Guarde el modelo de datos.

Creación de un juego de datos mediante Content Server

Puede configurar conexiones al origen de datos de Content Server en la página
Administración y utilizarlas posteriormente en varios modelos de datos.
Debe configurar la conexión para poder crear un modelo de datos. Cree un modelo de datos
creando primero el juego de datos de consulta SQL (necesario) y cree a continuación el
juego de datos de Content Server.

9-23
 Capítulo 9
Creación de un juego de datos con un archivo Microsoft Excel

1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y

seleccione Content Server.
En el cuadro de diálogo Nuevo juego de datos - Content Server, realice lo
siguiente:
2. Introduzca un nombre para el juego de datos en el campo Nombre.
3. Seleccione el origen de datos del servidor de contenidos en el campo Origen de
datos.
4. Seleccione el Grupo principal en la lista de valores.
5. Seleccione el Identificador de documento en la lista de valores.
6. Seleccione el Tipo de contenido en la lista de valores.

7. Haga clic en Aceptar.

Creación de un juego de datos con un archivo Microsoft

Excel
En estos temas se describen los requisitos, las opciones y los procedimientos para
usar archivos Microsoft Excel como origen de datos.
• Acerca de los archivos de Excel soportados
• Acceso a varias tablas por hoja

Acerca de los archivos de Excel soportados

El soporte de archivos Microsoft Excel como tipo de juego de datos en Publisher sigue
unas directrices determinadas.
• Guarde los archivos Microsoft Excel con el formato Libro de Excel 97-2003 (*.xls)
de Microsoft Excel. No están soportados los archivos creados en una aplicación o
una biblioteca de terceros.
• El archivo Excel de origen puede contener una única hoja o varias hojas.

9-24
 Capítulo 9
Creación de un juego de datos con un archivo Microsoft Excel

• Cada hoja de trabajo puede contener una o varias tablas. Una tabla es un bloque de
datos ubicado en las filas y las columnas continuas de una hoja.
En cada tabla, Publisher siempre considera que la primera fila es la fila de cabecera de
la tabla.
• La primera fila debajo de la fila de cabecera no debe estar vacía y se utiliza para
determinar el tipo de columna de la tabla. El tipo de dato de los datos de la tabla debe
ser número, texto o fecha/hora.
• Si hay varias tablas en una única hoja de trabajo, estas deben estar identificadas con un
nombre para que Publisher reconozca a cada una. Consulte Acceso a varias tablas por
hoja.
• Si no tienen un nombre todas las tablas del archivo Excel, solo se reconocen y se
recuperan los datos de la primera tabla.
• Cuando se crea el juego de datos, Publisher trunca todos los ceros finales después del
punto decimal de los números en todos los casos. Para conservar los puntos finales en
el informe final, debe aplicar una máscara de formato en la plantilla para mostrar los
ceros.
• Los parámetros de un solo valor están soportados, pero los parámetros de varios valores
no están soportados.

Acceso a varias tablas por hoja

Si la hoja de trabajo de Microsoft Excel contiene varias tablas que desea incluir como
orígenes de datos, debe definir un nombre para cada tabla en Microsoft Excel.
El nombre que defina debe empezar por el prefijo: BIP_; por ejemplo, BIP_SALARIES.
Para acceder a varias tablas por hoja:
1. Inserte la tabla en Microsoft Excel.
2. Seleccione la tabla y defina un nombre con el prefijo BIP_.
Por ejemplo, puede utilizar el comando Define Name de Microsoft Excel 2007 para asignar a
una tabla el nombre BIP_Salaries.

9-25
 Capítulo 9
Creación de un juego de datos con un archivo Microsoft Excel

Uso de un archivo Microsoft Excel almacenado en un origen de datos

del directorio de archivos
Cree juegos de datos mediante archivos Microsoft Excel almacenados en directorios
de archivos.
Tenga en cuenta que para incluir parámetros para el juego de datos, debe definir
primero los parámetros, de modo que estén disponibles para su selección cuando
defina el juego de datos. El tipo de juego de datos de Excel soporta un valor por
parámetro. No soporta la selección múltiple para los parámetros.
Para crear un juego de datos mediante un archivo Microsoft Excel de un origen de
datos de directorio de archivos:
1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y
seleccione Archivo Microsoft Excel. Se inicia el cuadro de diálogo Nuevo juego
de datos - Archivo Microsoft Excel.
2. Introducir un nombre para el juego de datos.
3. Haga clic en Compartido para activar la lista Origen de datos.
4. Seleccione el origen de datos en el que reside el archivo Microsoft Excel.
5. A la derecha del campo Nombre de archivo, haga clic en el icono para examinar
para buscar el archivo Microsoft Excel en los directorios del origen de datos.
Seleccione el archivo.
6. Si el archivo Excel contiene varias hojas o tablas, seleccione el Nombre de la
hoja y el Nombre de la tabla adecuados para este juego de datos, como se
muestra a continuación.

9-26
 Capítulo 9
Creación de un juego de datos con un archivo Microsoft Excel

7. Si ha agregado parámetros para este juego de datos, haga clic en Agregar parámetro.
Introduzca el Nombre y seleccione el Valor. La lista Valor se rellena según el Nombre de
parámetro definido en la sección Parámetros. Solo están soportados parámetros de un
único valor.
8. Haga clic en Aceptar.
9. Enlace los datos desde esta consulta a los datos de otras consultas o modifique la
estructura de salida.

Carga de un archivo Microsoft Excel almacenado localmente

Para utilizar un archivo Microsoft Excel local como origen de datos, primero debe cargarlo.
Tenga en cuenta que, para incluir parámetros para el juego de datos, primero debe definir los
parámetros de modo que estén disponibles para su selección al definir el juego de datos. El
tipo de juego de datos de Excel soporta un valor por parámetro. No soporta la selección
múltiple para los parámetros.
Para crear un juego de datos utilizando un archivo Microsoft Excel almacenado localmente:
1. Haga clic en el botón Nuevo juego de datos de la barra de herramientas y seleccione
Archivo Microsoft Excel. Se inicia el cuadro de diálogo Crear juego de datos - Excel.
2. Introducir un nombre para el juego de datos.
3. Seleccione Local para activar el botón de carga.
4. Haga clic en el icono Cargar para buscar y cargar el archivo Microsoft Excel de un
directorio local. Si se ha cargado el archivo al modelo de datos, puede seleccionarlo en
la lista Nombre de archivo.
5. Si el archivo Excel contiene varias hojas o tablas, seleccione el Nombre de la hoja y el
Nombre de la tabla adecuados para este juego de datos, como se muestra a
continuación.

9-27
 Capítulo 9
Creación de un juego de datos con un archivo Microsoft Excel

6. Si ha agregado parámetros para este juego de datos, haga clic en Agregar

parámetro. Introduzca el Nombre y seleccione el Valor. La lista Valor se propaga
según el Nombre de parámetro definido en la sección Parámetros. Solo están
soportados parámetros de un único valor.
7. Haga clic en Aceptar.
8. Enlace los datos desde esta consulta a los datos de otras consultas o modifique la
estructura de salida.

Refrescamiento y supresión de un archivo de Excel cargado

Puede refrescar y suprimir archivos de Excel local cargados.
Después de cargar el archivo, este se muestra en el panel Propiedades del modelo
de datos en la región Anexos, como se muestra a continuación.

9-28
 Capítulo 9
Creación de un juego de datos mediante un archivo CSV

Para refrescar el archivo local en el modelo de datos:

1. Haga clic en Modelo de datos en el panel de componentes para ver la página
Propiedades.
2. En la regiónAnexo de la página, busque el archivo en la lista Archivos de datos.
3. Haga clic en Refrescar.
4. En el cuadro de diálogo Cargar, busque y cargue la última versión del archivo. El archivo
debe tener el mismo nombre; de lo contrario, no sustituirá la versión anterior.
5. Guarde el modelo de datos.
Para suprimir el archivo local:
1. Haga clic en Modelo de datos en el panel de componentes para ver la página
Propiedades.
2. En la región Anexo de la página, busque el archivo en la lista Archivos de datos.
3. Haga clic en Suprimir.
4. Haga clic en Aceptar para confirmar.
5. Guarde el modelo de datos.

Creación de un juego de datos mediante un archivo CSV

Publisher soporta juegos de datos que usan orígenes de datos de archivos CSV para
devolver datos XML válidos.
En los temas siguientes se describe el uso de requisitos y procedimientos para usar un CSV
como origen de datos:
• Acerca de los archivos CSV soportados
• Creación de un juego de datos a partir de un archivo CSV almacenado centralmente
• Carga de un archivo CSV almacenado de forma local

Acerca de los archivos CSV soportados

El soporte de archivos CSV como tipo de juego de datos en Publisher sigue unas directrices
determinadas.
• Puede utilizar un archivo CSV ubicado en un directorio que el administrador haya
configurado como origen de datos.
Puede cargar un archivo de un directorio local.
• Los delimitadores de archivo CSV soportados son Coma, Pleca, Punto y coma y
Tabulador.
• Si el archivo CSV contiene cabeceras, los nombres de cabecera se utilizan como
nombres de etiqueta XML. Los siguientes caracteres no están soportados en los
nombres de etiqueta XML: ~, !, #, $, %, ^, &, *, +, `, |, :, \", \\, <, >, ?, ,, /. Si el archivo de
origen de datos contiene uno de estos caracteres en un nombre de cabecera, utilice el
separador Estructura del editor del modelo de datos para editar los nombres de etiqueta.
• Los juegos de datos CSV soportan la edición del tipo de dato asignado en el editor del
modelo de datos. Consulte Edición del tipo de dato. Si actualiza el tipo de dato para un

9-29
 Capítulo 9
Creación de un juego de datos mediante un archivo CSV

elemento del juego de datos, debe asegurarse de que los datos del archivo son
compatibles con el tipo de dato que ha seleccionado.
• Los archivos CSV que utilice como entrada para el motor de datos de Publisher
deben estar codificados en UTF-8 y no pueden contener cabeceras de columna
vacías.
• No están soportadas las divisiones de grupo, los enlaces de datos ni las funciones
de nivel de grupo y expresión.
• Los campos de datos de los archivos CSV deben utilizar el formato de fecha ISO
canónico para los elementos de fecha asignados; por ejemplo,
2012-01-01T10:30:00-07:00 y ######.## para los elementos de número
asignados.
• Los archivos CSV no se validan.

Creación de un juego de datos a partir de un archivo CSV

almacenado centralmente
Puede utilizar un archivo CSV de un directorio de archivos para crear un juego de
datos.
1. En la barra de herramientas del editor del modelo de datos, haga clic en Nuevo
juego de datos y seleccione Archivo CSV. Se inicia el cuadro de diálogo Nuevo
juego de datos - Archivo CSV.

2. Introducir un nombre para el juego de datos.

3. Haga clic en Compartido para activar la lista Origen de datos.
4. Seleccione el Origen de datos donde reside el archivo CSV.
La lista se propaga a partir de las conexiones Origen de datos de archivo
configuradas.
5. Haga clic en Examinar para conectarse al origen de datos, examinar los
directorios disponibles y seleccionar el archivo.
6. Seleccione Primera fila como cabecera de columna para especificar si la
primera fila del archivo contiene nombres de columna.

9-30
 Capítulo 9
Creación de un juego de datos mediante un archivo CSV

Si no selecciona esta opción, se asigna a las columnas un nombre genérico; por

ejemplo, Column1, Column2. Puede editar los nombres de etiqueta XML y los nombres
mostrados en el separador Estructura del editor del modelo de datos.
7. Seleccione el Delimitador de CSV utilizado en el archivo.
La selección por defecto es Coma (,).
8. Haga clic en Aceptar.

Carga de un archivo CSV almacenado de forma local

Cree juegos de datos utilizando archivos CSV almacenados en directorios de archivos
locales.
Para crear un juego de datos utilizando un archivo CSV almacenado de forma local:
1. En la barra de herramientas, haga clic en Nuevo juego de datos y seleccione Archivo
CSV. Se inicia el cuadro de diálogo Nuevo juego de datos - Archivo CSV, como se
muestra a continuación.

2. Introducir un nombre para el juego de datos.

3. Seleccione Local para activar el botón Cargar.
4. Haga clic en Cargar para buscar y cargar el archivo CSV desde un directorio local.
5. Opcional: Seleccione Primera fila como cabecera de columna para especificar si la
primera fila del archivo contiene nombres de columna. Si no selecciona esta opción, se
asigna a las columnas un nombre genérico; por ejemplo, Column1, Column2. Los
nombres de etiqueta XML y los nombres mostrados asignados se pueden editar en el
separador Estructura del editor del modelo de datos.
6. Seleccione el Delimitador de CSV utilizado en el archivo. La selección por defecto es
Coma (,).
7. Haga clic en Aceptar.

9-31
 Capítulo 9
Creación de un juego de datos mediante un archivo CSV

Edición del tipo de dato

Después de cargar un tipo de dato de archivo CSV, puede editarlo según sea
necesario.
Para editar el tipo de dato de un elemento de archivo CSV, haga clic en el icono de
tipo de dato o actualícelo en el cuadro de diálogo Propiedades del elemento.
Los datos de un elemento deben ser compatibles con el tipo de dato que asigne. La
interfaz de usuario no valida los datos cuando se actualiza el tipo de dato. Si los datos
no coinciden (por ejemplo, si hay un valor de cadena para un elemento que ha
definido como Entero), pueden producirse errores en las herramientas de edición de
diseño o en tiempo de ejecución.
Solo puede actualizar los tipos de dato para orígenes de datos de archivo CSV.

Refrescamiento y supresión de un archivo CSV cargado

Puede refrescar y suprimir archivos CSV cargados locales.
Después de cargar el archivo, este se muestra en el panel Propiedades del modelo de
datos en la región Anexos, como se muestra a continuación.

Para refrescar el archivo local en el modelo de datos:

1. En el panel de componentes, haga clic en Modelo de datos para ver la página
Propiedades.
2. En la región Anexo de la página, busque el archivo en la lista Archivos de datos.
3. Haga clic en Refrescar.
4. En el cuadro de diálogo Cargar, busque y cargue la versión más reciente del
archivo. El archivo debe tener el mismo nombre; de lo contrario, no sustituirá la
versión anterior.
5. Guarde el modelo de datos.
Para suprimir el archivo local:
1. En el panel de componentes, haga clic en Modelo de datos para ver la página
Propiedades.

9-32
 Capítulo 9
Creación de un juego de datos a partir de una fuente XML HTTP

2. En la región Anexo de la página, busque el archivo en la lista Archivos de datos.

3. Haga clic en Suprimir.
4. Haga clic en Aceptar para confirmar.
5. Guarde el modelo de datos.

Creación de un juego de datos a partir de una fuente XML

HTTP
Utilizando el tipo de juego de datos HTTP (fuente XML), puede crear modelos de datos a
partir de fuentes XML y RSS a través de la web recuperando datos mediante el método
HTTP GET.
Para incluir parámetros para el juego de datos, se recomienda que defina primero los
parámetros, de modo que estén disponibles para su selección cuando defina el juego de
datos. Consulte Adición de parámetros y listas de valores.
No hay ningún metadato disponible de los juegos de datos de fuente XML HTTP, por lo que
la agrupación y el enlace no están soportados.
Puede que requiera una configuración adicional para acceder a fuentes de orígenes de datos
externas en función de la seguridad de su sistema. Por ejemplo, si la fuente RSS está
protegida mediante capa de conexión segura (SSL).

Creación de un juego de datos a partir de un juego de datos XML HTTP

Puede configurar orígenes de datos HTTP (fuente XML) de dos maneras diferentes.
Después de que el administrador haya configurado las conexiones a orígenes de datos
HTTP, puede utilizar este origen de datos en varios modelos de datos.
1. En la barra de herramientas, haga clic en Nuevo juego de datos y seleccione HTTP
(fuente XML). Se inicia el cuadro de diálogo Nuevo juego de datos - HTTP (fuente XML),
como se muestra a continuación.

2. Introducir un nombre para el juego de datos.

9-33
 Capítulo 9
Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo de datos

3. Seleccione un origen de datos.

4. Introduzca el sufijo de URL para el origen de la fuente RSS o XML.
5. Seleccione el método: GET.
6. Para agregar un parámetro, haga clic en Agregar parámetro. Introduzca el
Nombre y seleccione el Valor. La lista Valor se propaga según el Nombre de
parámetro definido en la sección Parámetros.
7. Haga clic en Aceptar para cerrar el cuadro de diálogo del juego de datos.

Uso de datos almacenados como un objeto grande de

caracteres (CLOB) en un modelo de datos
Publisher soporta el uso de datos almacenados como el tipo de dato de objeto grande
de caracteres (CLOB) en los modelos de datos Esta función le permite utilizar datos
XML generados por un proceso independiente y almacenados en la base de datos
como entrada para un modelo de datos de Publisher.
Utilice Query Builder para recuperar la columna de la consulta SQL y utilice el editor
de modelo de datos para especificar cómo desea estructurar los datos. Cuando se
ejecuta el modelo de datos, el motor de datos puede estructurar los datos como:
• Un juego de caracteres sin formato en un nombre de etiqueta XML que se puede
mostrar en un informe (por ejemplo, una Descripción del elemento)
• Un XML estructurado
Asegúrese de que los datos no incluyen saltos de línea ni retornos de carro. Es
posible que los saltos de línea y los retornos de carro en los datos no se
representen de la forma esperada en los diseños de informe.
Para crear un juego de datos a partir de datos almacenados como un CLOB:
1. En la barra de herramientas, haga clic en Nuevo juego de datos y, a
continuación, seleccione Consulta SQL. Se inicia el cuadro de diálogo Nuevo
juego de datos - Consulta SQL.
2. Introduzca un nombre para el juego de datos.
3. Si no está utilizando el origen de datos por defecto para este juego de datos,
seleccione Origen de datos en la lista.
4. Introduzca la consulta SQL o utilice Query Builder para construir la consulta para
recuperar la columna de datos CLOB.
Por ejemplo, puede crear una consulta en la que los datos CLOB se almacenen
en una columna denominada "DESCRIPTION".

9-34
 Capítulo 9
Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo de datos

5. Después de introducir la consulta, haga clic en Aceptar para guardarla. Publisher valida
la consulta.
6. Por defecto, el editor del modelo de datos asigna a la columna CLOB el tipo de dato
"CLOB". Para cambiar el tipo de dato a XML, haga clic en el icono de tipo de dato y
seleccione XML.

Cómo se devuelven los datos

Al ejecutar la consulta, si la columna CLOB contiene un XML con el formato correcto y
selecciona el tipo de dato XML, el motor de datos devuelve los datos XML estructurados
dentro del nombre de etiqueta de la columna CLOB.
Ejemplo de salida cuando el tipo de dato es XML:
Tenga en cuenta que el elemento <DESCRIPTION> contiene los datos XML almacenados en
la columna CLOB, como se muestra a continuación.

9-35
 Capítulo 9
Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo de datos

Ejemplo de salida cuando el tipo de dato es CLOB:

Si selecciona devolver los datos como el tipo de dato CLOB, los datos devueltos se
estructuran como se muestra a continuación.

9-36
 Capítulo 9
Uso de datos almacenados como un objeto grande de caracteres (CLOB) en un modelo de datos

Notas adicionales sobre los juegos de datos con datos de la columna CLOB
Dispone de más información en los datos de la columna CLOB.
Para consultar notas específicas sobre el uso de los datos de la columna CLOB en una
consulta de repartición, consulte Uso de una consulta SQL para agregar una definición de
repartición al modelo de datos.

Gestión de datos XHTML almacenados en una columna CLOB

Los datos de documentos XHTML almacenados en una columna CLOB de base de datos
pueden representar el marcador en el informe generado.
Para que el motor de representación de informes pueda gestionar las etiquetas de marcador,
debe encapsular los datos XHTML en una sección CDATA dentro de los datos del informe
XML que transfiere el motor de datos.
Se recomienda que almacene los datos en la base de datos encapsulados en la sección
CDATA. A continuación, puede utilizar una sentencia select simple para extraer los datos. Si
los datos no están encapsulados en la sección CDATA, debe incluir instrucciones en la
sentencia SQL para encapsularlos.
En las secciones siguientes se describe cómo extraer datos XHTML en cada caso:
• Recuperación de datos XHTML encapsulados en CDATA
• Encapsulamiento de datos XHTML en CDATA en la consulta
Solo las plantillas RTF soportan la representación del marcador HTML en un informe.

Recuperación de datos XHTML encapsulados en CDATA

En este ejercicio se asume que tiene los siguientes datos almacenados en columna de base
de datos denominada "CLOB_DATA".

<![CDATA[
<p><font style="font-style: italic; font-weight: bold;" size="3">
<a href="http://www.oracle.com">oracle</a></font> </p>
<p><font size="6"><a href="http://docs.oracle.com/">Oracle Documentation</a>
</font></p>
]]>

Recupere los datos de la columna con una sentencia SQL sencilla, por ejemplo:
select CLOB_DATA as "RTECODE" from MYTABLE
En el editor de modelo de datos, defina el tipo de dato de la columna RTECODE en XML,
como se muestra a continuación.

9-37
 Capítulo 9
Prueba de modelos de datos y generación de datos de muestra

Encapsulamiento de datos XHTML en CDATA en la consulta

En este ejercicio se asume que tiene los siguientes datos almacenados en la columna
de base de datos denominada "CLOB_DATA".

<p><font style="font-style: italic; font-weight: bold;" size="3">

<a href="http://www.oracle.com">oracle</a></font> </p>
<p><font size="6"><a href="http://docs.oracle.com/">Oracle
Documentation</a>
</font></p>

Utilice la siguiente sintaxis de la consulta SQL para recuperarla e incluirla en la

sección CDATA:

select '<![CDATA' || '['|| CLOB_DATA || ']' || ']>' as "RTECODE"from

MYTABLE

En el editor de modelo de datos, defina el tipo de dato de la columna RTECODE en

XML.

Prueba de modelos de datos y generación de datos de

muestra
El editor de modelo de datos le permite probar el modelo de datos y ver el resultado
para asegurarse de que la salida en la esperada.
Después de ejecutar una prueba correcta, puede seleccionar guardar la salida de la
prueba como datos de muestra para el modelo de datos. También puede utilizar la
función Exportar para exportar datos de muestra a un archivo. Si falla la ejecución del
modelo de datos, puede ver el log del motor de datos.
Para probar el modelo de datos:
1. En el editor del modelo de datos, seleccione el separador Datos, como se
muestra a continuación.

9-38
 Capítulo 9
Editar un juego de datos existente

2. Para los juegos de datos de objeto de vista, análisis y consulta SQL: en el separador
Datos, seleccione el número de filas que se va a devolver. Si ha incluido parámetros,
introduzca los valores deseados para la prueba.
3. Haga clic en Ver para mostrar el XML que devuelve el modelo de datos.
4. Seleccione una de las siguientes opciones para mostrar los datos de muestra:
• Utilice la Vista de árbol para ver los datos de muestra en una jerarquía de datos.
Esta es la opción de visualización por defecto.
• Utilice Vista de tabla para ver los datos de muestra en una tabla con formato como
la que se muestra en los informes de Publisher.
Puede crear un informe basado en este modelo de datos.
Para guardar el juego de datos de prueba como datos de muestra del modelo de datos:
1. Una vez que se ha ejecutado correctamente el modelo de datos, haga clic en Guardar
como datos de muestra. Los datos de muestra se guardan en el modelo de datos.
Para exportar los datos de prueba:
1. Para los juegos de datos de objeto de vista, análisis y consulta SQL: en el separador
Datos, seleccione el número de filas que se va a devolver.
2. Una vez que se ha ejecutado correctamente el modelo de datos, haga clic en Exportar.
Se le solicitará que abra o guarde el archivo en un directorio local.
Para ver el log del motor de datos:
1. Haga clic en Ver log de motor de datos. Se le solicitará que abra o guarde el archivo en
un directorio local. El archivo log del motor de datos es un archivo XML.
Para probar el juego de datos de UCM:
Para Content Server, en función del identificador de documento y el tipo de contenido, el
contenido del documento se recupera del servidor (UCM) de contenidos. Sin embargo, si el
identificador de documento es nulo o está vacío, el contenido del documento estará vacío.

Editar un juego de datos existente

Puede modificar modelos de datos mediante la edición de los juegos de datos de un modelo
de datos.
Para editar un juego de datos existente:
1. En el panel de componentes del editor del modelo de datos, haga clic en Juegos de
datos. Se muestran todos los juegos de datos de este modelo de datos.
2. Haga clic en el juego de datos que desea editar.
3. Haga clic en Editar juego de datos seleccionado. Se abre el cuadro de diálogo para el
juego de datos.

9-39
 Capítulo 9
Inclusión de información de usuario almacenada en variables del sistema en los datos del informe

4. Realice los cambios en el juego de datos y haga clic en Aceptar.

5. Guarde el modelo de datos.
6. Pruebe el modelo de datos editado y agregue nuevos datos de muestra.

Inclusión de información de usuario almacenada en

variables del sistema en los datos del informe
Publisher almacena información sobre el usuario actual a la que puede acceder el
modelo de datos del informe.
La información de usuario se almacena en las variables del sistema como se describe
a continuación.

Variable del sistema Descripción

xdo_user_name
xdo_user_roles
xdo_user_report_oracle_la
ng
xdo_user_report_locale
xdo_user_ui_oracle_lang
xdo_user_ui_locale
Identificador de usuario del usuario que envía el informe.
Por ejemplo: Administrador
Roles asignados al usuario que envía el informe. Por
ejemplo: XMLP_ADMIN, XMLP_SCHEDULER
Idioma del informe de las preferencias de cuenta del
usuario. Por ejemplo: ZHS
Configuración regional del informe de las preferencias de
cuenta del usuario. Por ejemplo: en-US
Idioma de la interfaz de usuario de las preferencias de
cuenta del usuario. Por ejemplo: US
Configuración regional de la interfaz de usuario de las
preferencias de cuenta del usuario. Por ejemplo: en-US

Publisher rellena las variables del sistema en un informe en línea. En un trabajo

programado, Publisher no rellena las variables del sistema
XDO_USER_REPORT_LOCALE, XDO_USER_UI_LOCALE,
XDO_USER_UI_ORACLE_LANG, XDO_USER_REPORT_ORACLE_LANG y
XDO_USER_REPORT_LOCALE.

9-40
 Capítulo 9
Inclusión de información de usuario almacenada en variables del sistema en los datos del informe

Adición de las variables del sistema de usuario como elementos

Para agregar la información de usuario al modelo de datos, puede definir las variables como
parámetros y definir el valor del parámetro como elemento en su modelo de datos.
También puede simplemente agregar las variables como parámetros para, a continuación,
hacer referencia a los valores de parámetros en su informe.
La siguiente consulta:

select
:xdo_user_name as USER_ID,
:xdo_user_roles as USER_ROLES,
:xdo_user_report_oracle_lang as REPORT_LANGUAGE,
:xdo_user_report_locale as REPORT_LOCALE,
:xdo_user_ui_oracle_lang as UI_LANGUAGE,
:xdo_user_ui_locale as UI_LOCALE
from dual

devolverá el siguiente resultado:

<?xml version="1.0" encoding="UTF-8"?>

<! - Generated by Publisher - >
<DATA_DS>
<G_1>
<USER_ROLES>XMLP_TEMPLATE_DESIGNER, XMLP_DEVELOPER, XMLP_ANALYZER_EXCEL,
XMLP_ADMIN, XMLP_ANALYZER_ONLINE, XMLP_SCHEDULER </USER_ROLES>
<REPORT_LANGUAGE>US</REPORT_LANGUAGE>
<REPORT_LOCALE>en_US</REPORT_LOCALE>
<UI_LANGUAGE>US</UI_LANGUAGE>
<UI_LOCALE>en_US</UI_LOCALE>
<USER_ID>administrator</USER_ID>
</G_1>
</DATA_DS>

Caso de uso de ejemplo: Límite del juego de datos devuelto por el ID de

usuario
En el siguiente ejemplo se limitan los datos que devuelve el ID de usuario.

select EMPLOYEES.LAST_NAME as LAST_NAME,

EMPLOYEES.PHONE_NUMBER as PHONE_NUMBER,
EMPLOYEES.HIRE_DATE as HIRE_DATE,
:xdo_user_name as USERID
from HR.EMPLOYEES EMPLOYEES
where lower(EMPLOYEES.LAST_NAME) = :xdo_user_name

Observe el uso de la función lower(). El elemento xdo_user_name siempre tiene el formato

de minúsculas. Publisher no tiene un elemento USERID, por lo que debe usar el nombre de
usuario y usarlo directamente en la consulta, o bien podría realizar una consulta en una tabla
de búsqueda para encontrar un ID de usuario.

9-41
 Capítulo 9
Inclusión de información de usuario almacenada en variables del sistema en los datos del informe

Creación de variables de enlace desde los valores de atributo de usuario de

LDAP
Para enlazar los valores de atributo de usuario almacenados en su directorio de LDAP
a una consulta de datos, puede definir los nombres de atributos en Publisher para
crear las variables de enlace necesarias.

Requisito
Los atributos que se pueden usar para crear las variables de enlace las debe definir
en la página Configuración de seguridad un administrador.
Los atributos se definen en el campo Nombres de atributo para variables de enlace de
consultas de datos de la definición del modelo de seguridad LDAP. Se puede usar
cualquier atributo definido para los usuarios (por ejemplo: memberOf,
sAMAccountName, primaryGroupID, mail).

Cómo construye Publisher la variable de enlace

Puede hacer referencia a los nombres de atributo que introduce en el campo
Nombres de atributo para variables de enlace de consultas de datos de la
definición Modelo de seguridad de LDAP en la consulta.
A continuación, se muestra cómo se construyen las variables de enlace:

xdo_<attribute name>

Suponga que ha introducido los atributos de ejemplo: memberOf, sAMAccountName,

primaryGroupID, mail. Estos se pueden utilizar a continuación en una consulta como
las siguientes variables de enlace:

xdo_memberof
xdo_SAMACCOUNTNAME
xdo_primaryGroupID
xdo_mail

Tenga en cuenta que se omiten las mayúsculas y minúsculas del atributo; sin
embargo, el prefijo "xdo_" debe estar en minúsculas.
Utilícelos en un modelo de datos como se muestra a continuación:

SELECT
:xdo_user_name AS USER_NAME,
:xdo_user_roles AS USER_ROLES,
:xdo_user_ui_oracle_lang AS USER_UI_LANG,
:xdo_user_report_oracle_lang AS USER_REPORT_LANG,
:xdo_user_ui_locale AS USER_UI_LOCALE,
:xdo_user_report_locale AS USER_REPORT_LOCALE,
:xdo_SAMACCOUNTNAME AS SAMACCOUNTNAME,
:xdo_memberof as MEMBER_OF,
:xdo_primaryGroupID as PRIMARY_GROUP_ID,

9-42
 Capítulo 9
Inclusión de información de usuario almacenada en variables del sistema en los datos del informe

:xdo_mail as MAIL
FROM DUAL

Las variables de enlace de LDAP devuelven los valores almacenados en el directorio de

LDAP para el usuario que está conectado.

9-43
10
Estructuración de datos
En este tema se describen las técnicas para estructurar los datos que devuelve el motor de
datos de Publisher, incluida la agrupación, el enlace, los filtros de grupo, así como las
funciones de nivel global y de grupo.

Temas:
• Trabajar con modelos de datos
• Funciones del editor del modelo de datos
• Acerca de la interfaz
• Crear enlaces entre juegos de datos.
• Creación de enlaces de nivel de elemento
• Creación de subgrupos
• Movimiento de un elemento entre un grupo principal y un grupo secundario
• Creación de elementos de agregado de nivel de grupo
• Creación de filtros de grupo
• Realización de funciones a nivel de elemento
• Definición de propiedades de elementos
• Ordenar datos
• Realización de funciones de nivel de grupo
• Realización de funciones de nivel global
• Uso de la vista Estructura para editar la estructura de datos
• Referencia de función

Trabajar con modelos de datos

El diagrama Modelo de datos le ayuda a definir de forma rápida y sencilla juegos de datos,
grupos de división y totales para un informe en función de varios juegos de datos.
• Acerca de los juegos de datos no relacionados de varias partes
• Acerca de los juegos de datos relacionados de varias partes
• Directrices para trabajar con juegos de datos

Acerca de los juegos de datos no relacionados de varias partes

Si no enlaza los juegos de datos (o consultas), el motor de datos produce un juego de datos
de consulta no relacionados de varias partes.
Por ejemplo, en el modelo de datos, cuya imagen aparece abajo, una consulta selecciona
products y otra selecciona customers. No existe relación entre los productos y los clientes.

10-1
 Capítulo 10
Trabajar con modelos de datos

El resultado se muestra en la estructura de datos tal y como aparece en la siguiente

imagen.

10-2
 Capítulo 10
Trabajar con modelos de datos

Acerca de los juegos de datos relacionados de varias partes

Los datos recuperados para una parte de un juego de datos o una consulta pueden estar
determinados por los datos recuperados para otra parte. El resultado se denomina a menudo
una relación maestro/detalle o principal/secundario que está definida con un enlace de datos
entre dos juegos de datos o consultas.
Cuando se ejecuta un modelo de datos maestro/detalle, cada fila de la consulta maestra (o
principal) ejecuta una consulta del detalle (o el secundario) para recuperar solo las filas
coincidentes.
En el ejemplo (la siguiente imagen), dos juegos de datos están enlazados por el elemento
Customer ID. El juego de datos Órdenes es un secundario del juego de datos Clientes.

10-3
 Capítulo 10
Trabajar con modelos de datos

Este ejemplo genera la estructura de datos que se muestra en la siguiente imagen.

10-4
 Capítulo 10
Trabajar con modelos de datos

Directrices para trabajar con juegos de datos

Se recomiendan unas directrices determinadas para crear modelos de datos.
• Reduzca el número de juegos de datos o consultas en el modelo de datos tanto como
sea posible. En general, cuantos menos juegos de datos y consultas tenga, más rápido
se ejecutará el modelo de datos. Si bien los modelos de datos de varias consultas a
menudo son más sencillos de entender, los modelos de datos de una sola consulta
suelen ejecutarse con más rapidez. Es importante entender que en las consultas
principal-secundaria, para cada principal, se ejecuta la consulta secundaria.
• Solo debe utilizar modelos de datos de varias consultas en los siguientes casos:
– Para realizar funciones que no están soportadas directamente por el tipo de
consulta, como una consulta SQL.

10-5
 Capítulo 10
Acerca de la interfaz

– Para soportar vistas complejas; por ejemplo, consultas distribuidas o

consultas GROUP BY.
– Para simular una vista si no tiene o no desea utilizar una vista.

Acerca de la interfaz
Por defecto, los juegos de datos que ha creado se muestran en la Vista de diagrama
como objetos independientes.

El generador de estructuras de juegos de datos tiene tres vistas:

• Vista de diagrama: la Vista de diagrama muestra juegos de datos y permite
crear enlaces y filtros de forma gráfica, agregando elementos basados en
expresiones, agregando funciones de agregado y funciones de nivel global,
editando propiedades de elemento y suprimiendo elementos. La vista de
diagrama es la vista que se utiliza normalmente para crear la estructura de datos.
• Vista de estructura: la Vista de estructura tiene dos modos:
Vista de tabla y Salida
La vista de tabla muestra las propiedades de los elementos en una tabla y permite
la actualización de los nombres de alias, los nombres de presentación de los
elementos, la ordenación, los valores nulos y las opciones de restablecimiento de
los elementos XML. En la siguiente imagen se muestra la Vista de tabla de la
estructura.

10-6
 Capítulo 10
Acerca de la interfaz

La vista Salida proporciona una vista clara de la estructura XML que se genera. La vista
Salida no se puede actualizar. En la figura se muestra la vista Salida.

10-7
 Capítulo 10
Acerca de la interfaz

• Vista de código: la Vista de código muestra el código de estructura de datos

creado por el generador de estructuras de datos que lee el motor de datos. Puede
actualizar el contenido en la vista de código. En la figura se muestra la vista de
código.

10-8
 Capítulo 10
Crear enlaces entre juegos de datos.

Crear enlaces entre juegos de datos.

Puede utilizar el motor de datos de Publisher para combinar y estructurar datos después de
extraerlos del origen de datos.
A veces, no es posible la unión y la estructuración de datos en el origen en un juego de
datos combinado. Por ejemplo, no puede unir datos en el origen si los datos residen en
orígenes diferentes, como Microsoft SQL Server y una base de datos Oracle Database.
Incluso si los datos proceden del mismo origen, si va a crear informes o documentos grandes
que puedan contener cientos de miles de filas o páginas, estructure los datos para que
coincidan con el diseño deseado y optimicen la generación de documentos.
Cree un enlace para definir una relación maestro-detalle o principal-secundaria entre dos
juegos de datos. Puede crear enlaces como enlaces de nivel de elemento. Los enlaces
grupo-nivel se proporcionan para la compatibilidad con plantillas de datos de versiones
anteriores de Publisher. Para los juegos de datos migrados, suprima los enlaces de grupo y
cree enlaces de elemento. Si se crean enlaces de nivel de grupo entre juegos de datos, se
pueden corromper los datos.
Un enlace de datos o una relación principal-secundario relaciona los resultados de varias
consultas. Un enlace de datos puede establecer las siguientes relaciones:
• Entre una columna de una consulta y una columna de otra consulta.
• Entre un grupo de una consulta y un grupo de otra consulta; es útil cuando se desea que
la consulta secundaria conozca los datos de su principal.

Acerca de los enlaces de nivel de elemento

Los elementos de nivel de elemento crean un enlace (unión) entre dos juegos de datos y
definen una relación maestro-detalle (principal-secundario) entre ellos.

10-9
 Capítulo 10
Creación de enlaces de nivel de elemento

Cree enlaces de nivel de elemento, el método preferido, para definir relaciones

maestro-detalle entre los juegos de datos. Al usar enlaces de nivel de elemento para
enlazar juegos de datos, no necesita codificar una unión entre los dos juegos de datos
mediante una variable de enlace.

Creación de enlaces de nivel de elemento

Enlace los juegos de datos para definir una relación maestro-detalle o principal-
secundario entre dos juegos de datos.
Al definir un enlace de nivel de elemento le permite establecer el enlace entre los
elementos de los juegos de datos maestros y de detalle.
1. Abra el menú de acción de elemento y haga clic en Crear enlace
2. En el cuadro de diálogo Crear enlace, seleccione el elemento y haga clic en
Aceptar para crear el enlace.
A continuación se muestra el cuadro de diálogo Crear enlace.

Eliminación de enlaces de nivel de elemento

Puede suprimir tanto los enlaces a nivel de grupo como los enlaces a nivel de
elemento entre juegos de datos.
• Puede:.
– Abra el menú de acción de elemento para el elemento y haga clic en Suprimir
enlace
– Seleccione el conector de elementos para mostrar los nombres de elementos
enlazados y haga clic en el botón Suprimir.

10-10
 Capítulo 10
Creación de subgrupos

Suprimir enlaces de nivel de grupo

Puede suprimir tanto los enlaces a nivel de grupo como los enlaces a nivel de elemento
entre juegos de datos.
1. En el grupo principal, haga clic en Menú.
2. Haga clic en Suprimir enlace de grupo.
3. En el cuadro de diálogo Suprimir enlace de grupo, seleccione la opción Grupo
secundario en la lista y haga clic en Aceptar.

Creación de subgrupos
Además de crear estructuras principal-secundario mediante el enlace de dos juegos de
datos, también puede agrupar elementos en el mismo juego de datos por otros elementos.
La creación de subgrupos puede ser útil si la consulta devuelve datos que tienen datos de
cabecera repetidos para cada fila de detalles. Al crear un subgrupo, puede dar forma a los
datos XML para que la generación de documentos sea mejor y más eficiente.
1. Seleccione el elemento que se va a agrupar con otros elementos del juego de datos.
2. Haga clic en el icono del menú de acción del elemento para abrir el menú y seleccione
Agrupar por, como se muestra a continuación.

Al hacerlo, se crea un nuevo grupo dentro del juego de datos mostrado. En la siguiente
figura se muestra el juego de datos G_2 agrupado por el elemento COMPANY. Esto crea
un nuevo grupo denominado G_3 que contiene los otros cinco elementos del juego de

10-11
 Capítulo 10
Movimiento de un elemento entre un grupo principal y un grupo secundario

datos. En la siguiente figura se muestra cómo aparece el juego de datos agrupado

en la Vista de diagrama junto con la estructura.

Puede realizar cualquiera de las acciones de grupo en el grupo que ha creado.

3. Para desagruparlo, haga clic en Menú en la barra de título del grupo y, a
continuación, haga clic en Desagrupar.

Movimiento de un elemento entre un grupo principal y un

grupo secundario
Una vez que ha creado un grupo dentro del juego de datos, aparecen dos nuevas
opciones en el menú de acciones del elemento que le permiten mover elementos
entre los grupos principales y secundarios.
En el elemento que desee mover, haga clic en el icono de acciones del elemento para
abrir el menú. Si el elemento está en el grupo principal y desea moverlo al grupo
secundario, seleccione Mover elementos seleccionados a grupo secundario.
Si el elemento está en el grupo secundario y desea moverlo al grupo principal,
seleccione Mover elementos seleccionados a grupo principal. En la siguiente
figura, el menú de acciones del elemento de OFFICE_DSC muestra la opción para
mover el elemento al grupo principal.
Antes de mover un elemento, tenga en cuenta las dependencias en otros elementos.

10-12
 Capítulo 10
Creación de elementos de agregado de nivel de grupo

Creación de elementos de agregado de nivel de grupo

Puede utilizar el editor de modelo de datos para agregar datos en el nivel de grupo o de
informe.
Por ejemplo, si agrupa los datos de ventas por Nombre del cliente, puede agregar ventas
para obtener un subtotal de las ventas de cada cliente. Solo se pueden agregar datos en el
nivel principal para un elemento secundario.
Las funciones de agregado son las siguientes:
• Media: calcula la media de todas las incidencias de un elemento.
• Recuento: cuenta el número de incidencias de un elemento.
• Primero: muestra el valor de la primera incidencia de un elemento en el grupo.
• Último: muestra el valor de la última incidencia de un elemento en el grupo.
• Máximo: muestra el valor más alto de todas las incidencias de un elemento en el grupo.
• Mínimo: muestra el valor más bajo de todas las incidencias de un elemento en el grupo.
• Resumen: muestra el valor de todas las incidencias de un elemento en el grupo.
1. Arrastre el elemento hasta el campo Suelte aquí la función de agregado en el grupo
principal.
En la siguiente figura se muestra la creación de una función de agregado de nivel de
grupo en G_DEPT basada en el elemento SALARY.

10-13
 Capítulo 10
Creación de elementos de agregado de nivel de grupo

Cuando se suelta el elemento, se crea un nuevo elemento en el grupo principal.

Por defecto, se aplica la función Recuento. El icono situado junto al nombre del
nuevo elemento de agregado indica la función. Detenga el cursor sobre el icono
para mostrar la función.
En la siguiente figura se muestra el nuevo elemento de agregado, CS_1, con la
función por defecto Recuento definida.

10-14
 Capítulo 10
Creación de elementos de agregado de nivel de grupo

2. Para cambiar la función, haga clic en el icono de función para ver la lista de funciones
disponibles y seleccionar de la lista, como se muestra a continuación.

10-15
 Capítulo 10
Creación de elementos de agregado de nivel de grupo

3. Para renombrar el elemento o actualizar otras propiedades, haga clic en el icono

de menú Acción del elemento. Compruebe si el elemento tiene una dependencia
de otros elementos antes de renombrarlo.

10-16
 Capítulo 10
Creación de elementos de agregado de nivel de grupo

En el menú, haga clic en Propiedades. A continuación, se muestra el cuadro de diálogo

Propiedades.

4. En el cuadro de diálogo Editar propiedades, configure las propiedades según sea

necesario.

10-17
 Capítulo 10
Creación de filtros de grupo

• Nombre de columna: nombre interno que asigna al elemento el editor de

modelo de datos de Publisher. Este nombre no se puede actualizar.
• Alias (nombre de etiqueta XML): Publisher asigna un nombre de etiqueta
por defecto para el elemento en el archivo de datos XML. Puede actualizar
este nombre de etiqueta para asignar un nombre más fácil de recordar en el
archivo de datos.
• Nombre mostrado: el nombre mostrado aparece en las herramientas de
diseño de informe. Actualice este nombre para que sea significativo para los
usuarios de negocio.
• Función: si aún no ha seleccionado la función deseada, puede seleccionarla
en esta lista.
• Tipo de dato: Publisher asigna un tipo de dato Entero o Doble por defecto
según la función. Algunas funciones también proporcionan la opción Flotante.
• Valor si es Nulo: si el valor que devuelve la función es nulo, puede
proporcionar aquí un valor por defecto para evitar que haya un valor nulo en
los datos.
• Redondear: por defecto, el valor se redondea al tercer decimal más cercano.
Puede cambiar el valor de redondeo, si es necesario.
• Do restablecer: por defecto, la función se restablece en el nivel de grupo. Por
ejemplo, si el juego de datos se agrupa por DEPARTMENT_ID y ha definido
una función de suma para SALARY, la suma se restablece para cada grupo
de datos de DEPARTMENT_ID, lo cual le proporciona la suma SALARY solo
para dicho departamento. Si, por el contrario, desea que la función se
restablezca solo en el nivel global, y no en el nivel de grupo, seleccione No
restablecer. De este modo, se crea un total actualizado SALARY para todos
los departamentos. Esta propiedad es solo para las funciones de nivel de
grupo.

Creación de filtros de grupo

Los filtros le permiten eliminar condicionalmente registros seleccionados por sus
consultas.
Los filtros de grupo funcionan para las columnas dentro de los elementos del grupo de
juego de datos. Es posible que los filtros de grupo no funcionen para los elementos de
expresión y los elementos de grupos de otro juego de datos.
Los grupos pueden tener dos tipos de filtro:
• Expresión: cree una expresión utilizando funciones y operadores predefinidos
• Función PL/SQL: cree un filtro personalizado
Una vez que ha agregado un filtro de grupo, el objeto de juego de datos muestra el
indicador de filtro.
Para crear filtros de grupo:
1. Haga clic en Menú y, a continuación, seleccione Crear filtro de grupo.
2. Seleccione el Tipo de filtro de grupo: Expresión o PL/SQL. Para los filtros PL/
SQL, asegúrese de especificar el Paquete PL/SQL como Paquete por defecto
Oracle DB en las propiedades del modelo de datos.

10-18
 Capítulo 10
Realización de funciones a nivel de elemento

3. Introduzca el filtro:
• Para introducir una expresión, seleccione los elementos y muévalos al cuadro de
definición Filtro de grupo. Haga clic en las funciones y los operadores predefinidos
para insertarlos en el cuadro Filtro de grupo.
Haga clic en Validar expresión para asegurarse de que la entrada es válida.
• Para introducir una función PL/SQL, seleccione el paquete PL/SQL en el cuadro
Disponible y mueva la función al cuadro Filtro de grupo.
La función PL/SQL del paquete por defecto debe devolver un tipo booleano.

Realización de funciones a nivel de elemento

Puede realizar varias funciones a nivel de elemento.
• Agrupo por un elemento para crear un subgrupo, como se describe en Creación de
subgrupos
• Cree enlaces de nivel de elemento entre juegos de datos, como se describe en Creación
de enlaces de nivel de elemento
• Defina las propiedades de elementos, como se describe en Definición de propiedades de
elementos

Definición de propiedades de elementos

Puede definir propiedades para elementos individuales.
Tenga en cuenta que estas propiedades también se pueden editar en la vista de estructura.
Si necesita actualizar varias propiedades de elemento, puede ser más eficiente utilizar la
vista de estructura.
Para definir las propiedades de nivel de elemento mediante el cuadro de diálogo del
elemento:
1. Haga clic en el icono del menú de acciones del elemento. En el menú, seleccione
Propiedades.
2. Defina las propiedades según sea necesario.
• Alias: Publisher asigna un nombre de etiqueta por defecto al elemento en el archivo
de datos XML. Puede actualizar este nombre de etiqueta para asignar un nombre
más fácil de recordar en el archivo de datos.
• Nombre mostrado: el Nombre mostrado aparece en las herramientas de diseño de
informe y el nombre de columna en los informes. Actualice este nombre para que
sea significativo para los usuarios de negocio.
• Tipo de dato: Publisher asigna un tipo de dato por defecto. Los valores válidos son
Cadena, Fecha, Entero, Doble, Flotante.
• Ordenación: puede ordenar los datos XML de un grupo por uno o más elementos.
Por ejemplo, si en un juego de datos los empleados se agrupan por departamento y
gestor, puede ordenar los datos XML por departamento. Dentro de cada
departamento, puede agrupar y ordenar los datos por gestor, y dentro de cada
subgrupo de gestor, los empleados se pueden ordenar por salario. Si el elemento no
está en un grupo principal, la propiedad Orden de clasificación no está disponible.
• Valor si es nulo: i el valor de una incidencia del elemento es nulo, puede suministrar
un valor por defecto aquí para evitar un valor nulo en los datos.

10-19
 Capítulo 10
Ordenar datos

Ordenar datos
La ordenación solo está soportada para las columnas de división de grupo principales.
Por ejemplo, si un juego de datos de empleados se agrupa por departamento y gestor,
puede ordenar los datos XML por departamento. En cada departamento, puede
agrupar y ordenar los datos por mánager. Si sabe cómo se deben ordenar los datos
en el informe final, especifique la ordenación durante la generación de los datos para
optimizar la generación de documentos.
Para aplicar un orden de clasificación a un grupo:
1. Haga clic en el icono del menú de acción del elemento por el que desee ordenar.
En el menú, seleccione Propiedades.
2. Seleccione la opción Orden de clasificación.
En la figura siguiente se muestra el cuadro de diálogo Propiedades del elemento
DEPARTMENT_ID con la lista Orden de clasificación mostrada.

Realización de funciones de nivel de grupo

En esta sección se describe cómo realizar las funciones de grupo.
Los temas incluyen:
• Menú de acciones de grupo
• Edición de juegos de datos
• Eliminación de elementos del grupo
• Edición de propiedades de grupo

10-20
 Capítulo 10
Realización de funciones de nivel de grupo

Menú de acciones de grupo

El botón Menú está disponible en el nivel de grupo y permite realizar varias funciones.
• Cree, edite y suprima filtros de grupo, como se describe en Creación de filtros de grupo.
• Agregue un elemento al grupo basado en una expresión, como se describe en Adición
de un elemento de nivel de grupo o de nivel global por expresión.
• Edite el juego de datos, como se describe en Edición de juegos de datos.
• Elimine elementos del grupo, como se describe en Eliminación de elementos del grupo.
• Edite las propiedades del grupo, como se describe en Edición de propiedades de grupo.

Edición de juegos de datos

Inicie el editor de juegos de datos para modificar las propiedades de los juegos de datos
seleccionados.
Para editar el juego de datos a nivel de grupo:
1. Haga clic en el menú a nivel de grupo.
2. Seleccione Editar juego de datos para iniciar el editor de juegos de datos.

Eliminación de elementos del grupo

Puede eliminar los elementos de grupos necesarios.
Para eliminar un elemento del grupo:
• En la fila de elementos, haga clic en el menú y, a continuación, haga clic en Eliminar
elemento. A continuación aparece un ejemplo. Solo puede eliminar elementos
agregados como función de grupo (sum, count, etc.) o agregados como expresión.

10-21
 Capítulo 10
Realización de funciones de nivel global

Edición de propiedades de grupo

Edite las propiedades necesarias de un grupo.

1. Haga clic en Menú y seleccione Propiedades.

2. Edite la opción Nombre del grupo o Nombre mostrado y haga clic en Aceptar,
como se muestra a continuación.

Realización de funciones de nivel global

Las funciones de nivel global le permiten agregar elementos al juego de datos del
informe en el nivel de informe superior.
Puede agregar los siguientes tipos de elementos como datos de nivel superior:
• Elementos basados en funciones de agregado
• Elementos basados en expresiones
• Elementos basados en sentencias PL/SQL (para orígenes de datos de Oracle
Database)
Asegúrese de ordenar correctamente las funciones de nivel global. Las funciones de
nivel global se ejecutan secuencialmente.
Si selecciona el tipo de dato Entero para cualquier elemento calculado y la expresión
devuelve una fracción, no se truncan los datos. A continuación, se muestra el objeto
Funciones de nivel global. Para agregar elementos según las funciones de
agregado, arrastre el elemento hasta el espacio "Suelte aquí para la función de
agregado" del objeto. Para agregar un elemento según una expresión o PL/SQL, haga
clic en Menú y seleccione la acción adecuada.

10-22
 Capítulo 10
Realización de funciones de nivel global

Adición de una función de agregado de nivel global

Puede agregar funciones de agregado de nivel global según los elementos seleccionados.
Las funciones disponibles son las siguientes:
• Recuento
• Media
• Primero
• Último
• Máximo
• Mínimo
• Resumen
1. Arrastre el elemento de datos del juego de datos y suéltelo en el área Suelte aquí para
la función de agregado del objeto Funciones de nivel global.
Por ejemplo, en la imagen siguiente se muestra la creación de una función de agregado
de nivel global según el elemento Salary.

10-23
 Capítulo 10
Realización de funciones de nivel global

2. Cuando libera el mouse, el editor del modelo de datos asigna un nombre por
defecto al elemento de agregado y asigna Recuento la como función por defecto.
En la figura siguiente se muestra cómo se modifica la función del nuevo elemento
global CS_1 de Recuento a Media

3. Haga clic en el icono de función situado a la izquierda del nuevo nombre de

elemento y seleccione la función en la lista.
4. Para cambiar el nombre por defecto, haga clic en el icono de acciones situado a la
derecha del nombre de elementos y haga clic en Propiedades para iniciar el
cuadro de diálogo Editar propiedades.

10-24
 Capítulo 10
Realización de funciones de nivel global

Adición de un elemento de nivel de grupo o de nivel global por expresión

Puede agregar funciones de agregado de nivel de grupo o de nivel global por expresiones.
1. Para agregar un elemento de nivel de grupo, en el objeto Grupo, haga clic en Menú y
seleccione Agregar elemento por expresión.

2. En el cuadro de diálogo Agregar elemento por expresión, introduzca los campos y los
operadores.

10-25
 Capítulo 10
Realización de funciones de nivel global

3. En el campo Nombre mostrado, introduzca un nombre que sea significativo para

los usuarios profesionales.
4. Opcional: Seleccione un tipo de dato.
5. Utilice la flecha selectora para mover los elementos de datos necesarios para la
expresión del cuadro Disponible al cuadro Expresión.
6. Haga clic en un operador para insertarlo en el cuadro Expresión o selecciónelo
en la lista de funciones.
7. Haga clic en Validar expresión para validar la expresión.

Adición de un elemento de nivel global por PL/SQL

La función PL/SQL debe devolver un tipo de dato VARCHAR.

1. En la página Propiedades, especifique el Paquete PL/SQL como el Paquete por

defecto Oracle DB en las propiedades del modelo de datos.
2. En el objeto Funciones de nivel global, haga clic en Menú y, a continuación, en
Agregar elemento por PL/SQL.
3. En el cuadro de diálogo Agregar elemento por PL/SQL, introduzca los siguientes
campos:
• Nombre: introduzca un nombre significativo para el elemento.
• Nombre mostrado: introduzca un nombre mostrado. Este aparece en las
herramientas de diseño del informe. Introduzca un nombre que sea
significativo para los usuarios profesionales.
• Tipo de dato: seleccione Cadena.

4. Seleccione el paquete PL/SQL en el recuadro Disponible y haga clic en el botón

selector para mover la función al recuadro Filtro de grupo.

10-26
 Capítulo 10
Uso de la vista Estructura para editar la estructura de datos

Uso de la vista Estructura para editar la estructura de datos

La vista Estructura le permite obtener una vista previa de la estructura del modelo de datos.
En la columna Origen de datos se muestran los elementos de fecha en un árbol jerárquico
que puede reducir y ampliar. Utilice esta vista para verificar la precisión de la estructura del
modelo de datos para realizar las siguientes ediciones:
• Cambio de nombre de elementos
• Adición de un valor para elementos nulos
La vista Estructura se muestra a continuación.

Cambio de nombre de elementos

Use la página Estructura para definir nombres fáciles de recordar para elementos del modelo
de datos.
Puede cambiar el nombre tanto de la etiqueta del elemento XML (Vista XML) como el que
aparece en las herramientas de diseño del informe (Vista de negocio). En la figura siguiente
se muestra el cambio de nombre de los elementos del origen de datos por nombres de vista
de negocio más fáciles de recordar.

10-27
 Capítulo 10
Referencia de función

Adición de un valor para elementos nulos

La opción Estructura también le permite introducir un valor que usar para un elemento
si el modelo de datos devuelve un valor nulo para el elemento.
1. Haga clic en el separador Estructura.
2. Introduzca el valor que usar en el campo Valor si es nulo para el elemento.

Referencia de función
En la siguiente tabla, se describe el uso de las funciones soportadas disponibles en el
cuadro de diálogo Agregar elemento por expresión y el cuadro de diálogo Editar filtro
de grupo.

Función Descripción Sintaxis Ejemplo

IF Operador IF lógico IF (boolean_expr, IF
Evalúa boolean_expr y true_return, (G_1.DEPARTMENT_ID
devuelve true_return si false_return) == 10, 'PASSED',
boolean_expr es 'FAIL')returns 'PASSED'
verdadera, y if DEPARTMENT_ID =
false_return si 10, otherwise returns
boolean_expr es falsa. 'FAIL'

NOT Operador NOT lógico STRING(NOT(boolean STRING(NOT(G_1.JOB_I

Evalúa boolean_expr y _expr)) D == 'MANAGER'))
devuelve true si devuelve 'TRUE' si
boolean_expr es falsa. JOB_ID = MANAGER; de
lo contrario, devuelve
'FALSE'

10-28
 Capítulo 10
Referencia de función

Función Descripción Sintaxis Ejemplo

AND Operador AND lógico STRING(AND(boolean STRING(AND
Evalúa boolean_expr1 y _expr1, (G_1.JOB_ID ==
boolean_expr2 y boolean_expr2, ...)) 'MANAGER',
devuelve true si ambas G_1.DEPARTMENT_ID
expresiones booleanas == 10)) devuelve 'TRUE'
son verdaderas; en caso si JOB_ID = MANAGER y
contrario, devuelve DEPARTMENT_ID = 10;
false. de lo contario, devuelve
'FALSE'
&& Operador AND lógico STRING(boolean_expr STRING(G_1.JOB_ID ==
Evalúa boolean_expr1 y 1 && boolean_expr2) 'MANAGER' &&
boolean_expr2 y G_1.DEPARTMENT_ID
devuelve true si ambas == 10)
expresiones booleanas devuelve 'TRUE' si
son verdaderas; en caso JOB_ID = MANAGER y
contrario, devuelve DEPARTMENT_ID = 10;
false. de lo contrario,
devuelve 'FALSE'
|| Operadores OR lógicos STRING(OR(boolean_e STRING(OR (G_1.JOB_ID
Evalúa boolean_expr1 y xpr1, boolean_expr2) == 'MANAGER',
boolean_expr2 y G_1.DEPARTMENT_ID
devuelve true si una o == 10))
ambas expresiones devuelve 'TRUE' si
booleanas son JOB_ID = MANAGER o
verdaderas; en caso DEPARTMENT_ID = 10;
contrario, devuelve de lo contrario,
false. devuelve 'FALSE'
MAX Devuelve el valor MAX(expr1, expr2, MAX(G1_Salary, 10000)
máximo del elemento en expr3, ...) devuelve el máximo del
el juego. salario o 10000
MIN Devuelve el valor MIN(expr1, expr2, MIN(G1_Salary,5000)
mínimo del elemento en expr3, ...) devuelve el mínimo del
el juego. salario o 5000
ROUND Devuelve un número ROUND(number[,inte ROUND(2.777)
redondeado a las ger]) devuelve 3
posiciones de enteros a Si se omite el entero, ROUND(2.777, 2)
la derecha de la coma el número se
decimal. devuelve 2.78
redondea a 0
posiciones.
El entero puede ser
negativo para
redondear dígitos a la
izquierda de la coma
decimal.
Integer debe ser un
entero.
FLOOR Devuelve el entero más FLOOR(n) FLOOR(2.777)
pequeño que sea igual o devuelve 2
menor que n.
CEILING Devuelve el entero más CEILING(n) CEILING(2.777)
grande que sea mayor o devuelve 3
igual que n.

10-29
 Capítulo 10
Referencia de función

Función Descripción Sintaxis Ejemplo

ABS Devuelve el valor ABS(n) ABS(-3)
absoluto de n. devuelve 3
AVG Devuelve el valor medio AVG(expr1, expr2, AVG(G_1.SALARY,G_1.CO
de la expresión. expr3, ...) MMISSION_PCT*G_1.SA
LARY)
devuelve la media de
SALARY y COMMISSION
Por ejemplo, si SALARY
= 14000 y
COMMISSION_PCT = .4,
la expresión se evalúa
como 9800.0
LENGTH Devuelve la longitud de LENGTH(expr) Ejemplo de devolución
una matriz. de la longitud de una
La función LENGTH matriz: LENGTH{1, 2, 4,
calcula la longitud 4}) devuelve 4
utilizando los caracteres Ejemplo de devolución
que se definen en el de la longitud de una
juego de caracteres de cadena:
entrada. LENGTH('countries')
Si char es nulo, la devuelve 9
función devuelve null.
Si char es una matriz,
devuelve la longitud de
la matriz.
SUM Devuelve la suma del SUM(expr1, expr2, ...) SUM (G_1.SALARY,
valor de la expresión. G_1.COMMISSION_PCT*
G_1.SALARY)
devuelve la suma del
salario y la comisión
Por ejemplo, si SALARY
= 14000 y
COMMISSION_PCT =.4,
la expresión se evalúa
como 19,600.0
NVL Sustituye null (se NVL(expr1, expr2) NVL(G_1.COMMISSION_
devuelve como un Si expr1 es nula, NVL PCT, .3) devuelve .3 si
espacio en blanco) por devuelve expr2. G_1.COMMISSION_PCT
una cadena en el es nulo
Si expr1 no es nula,
resultado de una
NVL devuelve expr1.
consulta.
CONCAT Devuelve char1 CONCAT(char1, char2) CONCAT(CONCAT(First_
concatenado con char2. Name, ' '), Last_Name)
donde First_Name = Joe
y Last_Name = Smith
devuelve Joe Smith
STRING Devuelve char como tipo STRING(expr) STRING(G1_SALARY)
de dato de cadena. donde salary = 4400
devuelve 4400 como
cadena

10-30
 Capítulo 10
Referencia de función

Función Descripción Sintaxis Ejemplo

SUBSTRING Extrae una subcadena SUBSTRING(string, SUBSTRING('this is a
de una cadena. start_pos, end_pos) test', 5, 7) devuelve "is"
string es la cadena de (es decir, los caracteres
origen. del 6 al 7)
SUBSTRING('this is a
start_pos es la
test', 5) devuelve "is a
posición para iniciar
test"
la extracción.
end_pos es la posición
final de la cadena que
se va a extraer
(opcional).
INSTR Devuelve la posición/ INSTR(string1, INSTR('this is a test', 'is
ubicación del primer string2) a')
carácter de una string1 es la cadena devuelve 5
subcadena en una que se va a buscar.
cadena
string2 es la
subcadena que se va a
buscar en string1.
DATE Convierte una cadena de DATE(char, DATE(01-Jan-2013,'dd-
fecha Java válida en un format_string) MMM-yyyy')
tipo de dato de fecha donde (1) char es devuelve
con formato canónico. cualquier cadena de 2013-01-01T08:00:00.000
fecha Java válida (por +00:00
ejemplo, 13-JAN-2013)
(2) format_string es el
formato de fecha Java
de la cadena de
entrada (por ejemplo,
dd-MMM-yyyy) Las
cadenas de entrada y
formato deben ser
una cadena con
formato de fecha Java
válida.
FORMAT_DA Convierte un argumento FORMAT_DATE(date,f FORMAT_DATE(SYSDAT
TE de fecha con formato de ormat_string) E,'dd-MMM-yyyy')
fecha Java en una donde el valor SYSDATE
cadena con formato. =
2013-01-24T16:32:45.000
-08:00 devuelve 24-
Jan-2013
FORMAT_NU Convierte un número o FORMAT_NUMBER(nu FORMAT_NUMBER(SOM
MBER una cadena numérica en mber,format_string) E_NUMBER, '$9,999.00')
una cadena con el donde el valor de
formato numérico SOME_NUMBER =
especificado. 12345.678
devuelve $12,345.68

10-31
 Capítulo 10
Referencia de función

Función Descripción Sintaxis Ejemplo

DECODE Sustituye el valor de una DECODE(expr, search, DECODE(PROD_FAMILY
expresión por otro valor result [, search, _CODE,100,'Colas',200,'R
según la búsqueda result]...[, default]) oot Beer',300,'Cream
especificada y los Sodas',400,'Fruit
criterios de sustitución. Sodas','Other') devuelve
(1) 'Colas' si
PROD_FAMILY_CODE =
100 (2) 'Root Beer' si
PROD_FAMILY_CODE =
200 (3) 'Cream Sodas' si
PROD_FAMILY_CODE =
300 (4) 'Fruit Sodas' si
PROD_FAMILY_CODE =
400 (5) 'Other' si
PROD_FAMILY_CODE es
cualquier otro valor
REPLACE Sustituye una secuencia REPLACE(expr,string1 REPLACE(G_1.FIRST_NA
de caracteres en una ,string2) ME,'B','L')
cadena por otro juego de donde string1 es la donde G_1.FIRST_NAME
caracteres. cadena que se va a = Barry
buscar y string2 es la devuelve Larry
cadena por la que se
va a sustituir.

10-32
11
Adición de parámetros y listas de valores
En este tema se describe cómo agregar parámetros y listas de valores a un modelo de
datos.

Temas:
• Acerca de los parámetros
• Adición de un nuevo parámetro
• Acerca de las listas de valores
• Adición de listas de valores
• Adición de parámetros de campos flexibles

Acerca de los parámetros

Los parámetros de un modelo de datos le permiten interactuar con los datos cuando se
visualizan informes.
Tipos de parámetro soportados:
• Texto: permite introducir una cadena de texto para transferirla como parámetro.
• Menú: permite realizar seleccione en una lista de valores. Una lista de valores puede
contener datos fijos que ha especificado o una lista creada mediante una consulta SQL
que se ejecuta en cualquier de los orígenes de datos definidos. Esta opción soporta la
selección múltiple, una opción Seleccionar todo y el refrescamiento de página parcial
para parámetros en cascada.
Para crear un parámetro de tipo menú, defina la lista de valores y, a continuación, defina
el parámetro y asócielo a la lista de valores.
• Fecha: le permite seleccionar una fecha como parámetro. Debe utilizar el tipo de dato
Date y el formato de fecha de Java.
• PDV: le permite utilizar un punto de vista jerárquico como parámetro para seleccionar
datos de Essbase. Puede visualizar una dimensión de cubo, ampliar un nodo de
estructura de datos y aumentar el detalle para seleccionar datos de un PDV. Debe utilizar
una consulta MDX para crear una lista de valores para un parámetro de PDV.
• Búsqueda: le permite especificar un texto de búsqueda y seleccionar un valor en una
larga lista de valores.
Puede definir parámetros obligatorios para el informe. Un símbolo de asterisco junto a una
etiqueta de parámetro indica que el parámetro está marcado como obligatorio en el modelo
de datos. Debe proporcionar valores para los parámetros obligatorios de un informe, si
desea ejecutar el informe en línea o programar el informe.
Una vez que ha definido los parámetros del modelo de datos, puede configurar cómo se
muestran los parámetros en el informe.

11-1
 Capítulo 11
Acerca de los parámetros

Puede utilizar parámetros de varias maneras en función del tipo de juego de datos.
Por ejemplo, puede utilizar todas las funciones de parámetro con juegos de datos de
consultas SQL. Con otros tipos de juegos de datos, puede utilizar todas las funciones
de parámetro, ninguna o un subjuego, como se describe en esta tabla.

Tipo de juego de Parámetro Selección Puede Refrescar otros

datos soportado múltiple seleccionar parámetros al
todo cambiar
Consulta SQL Sí Sí Sí Sí
Soporta todos
los tipos de
parámetro
Consulta de LDAP Sí No No No
Soporta solo el
parámetro de
tipo Texto
Consulta de MDX Sí No No No
Soporta los
tipos de
parámetro
Texto y PDV,
que devuelven
un valor de
texto
Análisis Heredado del Sí (utilizando Sí (utilizando Sí (utilizando
análisis paneles de paneles de paneles de Oracle
Oracle BI) Oracle BI) BI)
Juego de datos de Sí Sí Sí No
DV Soporta todos
los tipos de
parámetro
HTTP (fuente XML) Sí No No No
Soporta solo
los tipos de
parámetro
Texto y Fecha
Servicio web Sí No No No
Soporta solo
los tipos de
parámetro
Texto y Fecha
Archivo CSV No No No No
Archivo Microsoft Sí No No No
Excel Soporta solo
los tipos de
parámetro
Texto y Fecha
Archivo XML No No No No
Servidor de No No No No
contenidos

11-2
 Capítulo 11
Adición de un nuevo parámetro

Adición de un nuevo parámetro

Cree un parámetro asignándole un nombre y otras propiedades.
El nombre del parámetro que elija no debe exceder la longitud máxima que permita su base
de datos para un identificador. Consulte la documentación de la base de datos para conocer
las limitaciones de longitud del identificador.
Cuando diseña diseños de informe con el Editor de diseño, la vista previa de la salida del
informe utiliza los valores por defecto de los parámetros.
Puede configurar la colocación de filas en el nivel de informe. La definición de informe
soporta opciones de visualización adicionales para los parámetros.
Para agregar un nuevo parámetro:
1. En el panel de componentes Modelo de datos, haga clic en Parámetros y, a
continuación, en Crear nuevo parámetro.
2. Introduzca un Nombre para el parámetro.
El nombre debe coincidir con todas las referencias a este parámetro en el juego de
datos.
3. Seleccione el Tipo de dato en la lista. Un tipo de dato Fecha solo soporta un Tipo de
parámetro de fecha.
4. Introduzca un Valor por defecto para el parámetro. Se recomienda para evitar consultas
de larga duración.
5. Seleccione el Tipo de parámetro.
6. Para marcar el parámetro como obligatorio, seleccione Obligatorio.
Si no se proporcionan valores para los parámetros obligatorios, no podrá probar un
informe con la opción Ver datos, ejecutar el informe en línea ni programar el informe.
7. En el valor Colocación de filas, configure el número de filas para mostrar los
parámetros y en qué fila desea colocar cada parámetro.
Por ejemplo, si el informe tiene seis parámetros, puede asignar cada parámetro a una
fila diferente de la 1 a la 6, donde 1 es la fila superior; o bien asignar dos parámetros a
cada una de las filas 1, 2, 3. Por defecto, todos los parámetros se asignan a la fila 1.

Creación de un parámetro de texto

El parámetro del tipo Texto proporciona un cuadro de texto para solicitar al usuario que
introduzca una entrada de texto como parámetro en el origen de datos.
Para crear un parámetro de texto:
1. Seleccione Texto en la lista Tipo de parámetro.
2. Introduzca la Etiqueta mostrada. Por ejemplo, Department.
3. Introduzca el Tamaño campo de texto como un entero. Este campo determina el
tamaño (ancho) del campo, pero no limita el número de caracteres que puede introducir
el usuario en el cuadro de texto.
4. Active las siguientes Opciones, si es necesario:

11-3
 Capítulo 11
Adición de un nuevo parámetro

• El campo de texto contiene valores separados por comas: permite al

usuario introducir varios valores delimitados por comas para este parámetro.
Se debe definir el parámetro del origen de datos para que soporte varios
valores.
• Refrescar otros parámetros al cambiar: realiza un refrescamiento parcial
para refrescar cualquier otro parámetro cuyo valor dependa del valor de este.

Creación de un parámetro de menú

Un parámetro de tipo Menú presenta una lista de valores al usuario.
Primero, debe definir la lista de valores. El parámetro de tipo Menú solo soporta los
tipos de dato Cadena y Entero.
Para crear un parámetro de menú:
1. Seleccione Menú en la lista Tipo de parámetro. El panel inferior muestra los
campos adecuados.
2. En Tipo de datos, seleccione Cadena o Entero.
3. Introduzca la Etiqueta mostrada. La etiqueta mostrada es la etiqueta que se
muestra a los usuarios cuando visualizan el informe. Por ejemplo: Department.
4. Seleccione la Lista de valores que ha definido para este parámetro.
5. Introduzca el Número de valores para mostrar en la lista. Si el número de
valores de la lista excede la entrada de este campo, el usuario debe hacer clic en
Buscar para buscar un valor no mostrado, como se muestra en la siguiente
figura. El valor por defecto de este campo se establece en 100.

6. Active las siguientes Opciones, si es necesario:

• Selección múltiple: permite al usuario seleccionar varias entradas en la lista.
El origen de datos debe admitir varios valores para el parámetro. La
visualización de un parámetro de menú que soporta la selección múltiple es
diferente. Consulte las dos figuras siguientes.
• Puede seleccionar todo: inserta una opción Todo en la lista.
Cuando el usuario selecciona Todo en la lista de valores, puede transferir un
valor nulo para el parámetro.
El uso de * transfiere un valor nulo, por lo que debe gestionar este valor nulo
en el origen de datos. Un método para gestionar el valor nulo sería el
comando NVL estándar de Oracle; por ejemplo: where customer_id =
nvl(:cstid, customer_id) donde cstid es un valor transferido de la lista de
valores, y cuando el usuario selecciona Todo, transfiere un valor nulo.

11-4
 Capítulo 11
Adición de un nuevo parámetro

• Refrescar otros parámetros al cambiar: realiza un refrescamiento parcial de la

página para refrescar cualquier otro parámetro cuyo valor dependa del valor de este.
En la siguiente figura se muestra cómo se visualiza el parámetro de tipo de menú
Department para el consumidor del informe cuando no está activada la selección múltiple.

En la siguiente figura se muestra cómo se visualiza el parámetro de tipo de menú

Department para el consumidor del informe cuando está activada la selección múltiple.

Personalización de la visualización de parámetros de menús

La visualización de parámetros de menú del informe se puede personalizar aún más en la
definición del informe.

11-5
 Capítulo 11
Adición de un nuevo parámetro

Los parámetros de tipo de menú soportan la opción de visualización adicional como

lista estática de casillas de control o botones de radio.

Definición de un parámetro de fecha

El parámetro de tipo Fecha proporciona un selector de fecha que solicita al usuario
que introduzca una fecha para transferirla como parámetro al origen de datos.
1. Seleccione Fecha en la lista Tipo de parámetro El panel inferior muestra los
campos adecuados para que realice su selección.
2. Introduzca la Etiqueta mostrada. La etiqueta mostrada es la etiqueta que se
muestra a los usuarios cuando visualizan el informe. Por ejemplo: Hire Date.
3. Introduzca el Tamaño campo de texto como un entero. Este campo determina el
número de caracteres que puede introducir el usuario en el cuadro de texto para
la entrada de fecha. Por ejemplo: 10.
4. Opcional: Seleccione Ignorar zona horaria de usuario si desea mostrar el valor
de parámetro de fecha en UTC.
5. Introduzca la Cadena de formato de fecha. El formato debe ser un formato de
fecha Java; por ejemplo, MM-dd-yyyy.
6. Opcional: Introduzca una Fecha de inicio y una Fecha de finalización. Las
fechas que se introducen aquí definen el rango de fechas que se presenta al
usuario en el selector de fecha. Por ejemplo, si introduce la Fecha de inicio
01-01-1990, el selector de fecha no permite al usuario seleccionar una fecha
anterior a 01-01-1990. Deje la Fecha de finalización en blanco para permitir
todas las fechas futuras.
En la figura se puede ver cómo se muestra el parámetro Hire Date al consumidor del
informe.

11-6
 Capítulo 11
Adición de un nuevo parámetro

Creación de un parámetro de punto de vista (POV)

El parámetro de tipo PDV (punto de vista) le proporciona una vista multidimensional.
Puede especificar directamente un parámetro de PDV en una consulta MDX y crear el
parámetro de PDV, o bien crear primero un parámetro de PDV y, a continuación, actualizar
una consulta MDX para incluir el parámetro de PDV en la cláusula WHERE. Antes de crear
un parámetro de tipo PDV en un modelo de datos, defina la lista de valores para el
parámetro de PDV.
Para crear un parámetro de PDV:
1. En el panel de componentes Modelo de datos, haga clic en Parámetros.
2. Haga clic en Crear nuevo parámetro.
3. Introduzca un nombre para el parámetro en el campo Nombre.
4. Seleccione PDV en la lista Tipo de parámetro.
5. En la lista Tipo de datos, seleccione Texto.
6. Introduzca un valor por defecto para el parámetro en el campo Valor por defecto.
7. En el valor Colocación de filas, configure el número de filas para mostrar los
parámetros.
8. Utilice la columna Volver a ordenar para especificar el orden para el parámetro.
9. Introduzca una etiqueta en el campo Etiqueta mostrada.
10. Seleccione una lista de valores para el parámetro de PDV en la lista Lista de valores.

Inclusión de un valor de parámetro de PDV en una consulta MDX

Puede buscar una dimensión en un cubo e incluir un valor de parámetro de PDV en una
consulta MDX.
Si incluye un parámetro de PDV en una consulta MDX de un modelo de datos y si ese
parámetro de PDV no existe en el modelo de datos, Publisher crea ese parámetro de PDV
en el modelo de datos cuando guarda la consulta.
Para incluir un valor de parámetro de PDV en una consulta MDX:
1. En el panel de componentes del editor del modelo de datos, haga clic en Juegos de
datos.
2. Haga clic en el juego de datos de la consulta MDX que desea editar.
3. Haga clic en Editar juego de datos seleccionado.
4. En la cláusula WHERE de la consulta MDX, introduzca el nombre del parámetro de PDV
delimitado por ${ }.
Por ejemplo, si desea crear un parámetro de PDV con el nombre P_Year o si el
parámetro de PDV P_Year existe en el modelo de datos, especifique la condición como
WHERE ([Year].[${P_Year}]
5. En el cuadro de diálogo de enlace del valor de parámetro, haga clic en el icono de
búsqueda situado junto al parámetro.
6. En el cuadro de diálogo de selección de dimensión, seleccione el cubo, la dimensión y el
valor para el parámetro.

11-7
 Capítulo 11
Acerca de las listas de valores

7. Haga clic en Seleccionar.

8. Haga clic en Aceptar.
9. Guarde el modelo de datos.

Creación de un parámetro de búsqueda

Puede utilizar el parámetro del tipo Buscar para proporcionar un cuadro que permita
introducir un texto de búsqueda y un icono de búsqueda para buscar y mostrar los
valores que coincidan con las búsqueda a fin de que los usuarios puedan realizar su
selección.
Utilice el parámetro del tipo Buscar para buscar un valor dentro de una larga lista de
valores. Debe crear una lista de valores para el parámetro para poder definir el
parámetro del tipo Buscar.
Para crear un parámetro del tipo Buscar:
1. En el panel de componentes del modelo de datos, haga clic en Parámetros y, a
continuación, en Crear nuevo parámetro.
2. Introduzca un nombre para el parámetro, seleccione Cadena en la lista Tipo de
dato e introduzca un valor por defecto para el parámetro.
3. Seleccione Buscar en la lista Tipo de parámetro.
4. Introduzca una etiqueta para el parámetro en el campo Etiqueta mostrada.
5. Seleccione la lista de valores para el parámetro en la lista Lista de valores.
6. Opcional: Seleccione Refrescar otros parámetros al cambiar.

Acerca de las listas de valores

Una lista de valores es un juego de valores definido en el que el consumidor de un
informe puede realizar su selección para transferir un valor de parámetro al origen de
datos.
Si define un parámetro del tipo menú, la lista de valores proporciona el menú de
opciones. Debe definir la lista de valores antes de definir el parámetro de menú.
Rellene la lista mediante uno de los siguientes métodos:
• Consulta SQL: recupera los valores de una base de datos mediante una consulta
SQL.
• Datos fijos: recupera los valores que un usuario introduce de forma manual.
• Consulta MDX: recupera los valores de un PDV o un divisor.

Adición de listas de valores

Puede crear listas de valores de Consulta SQL o Datos fijos.
1. En el panel de componentes de Modelo de datos, haga clic en Lista de valores y,
a continuación, haga clic en Crear nueva lista de valores.

11-8
 Capítulo 11
Adición de listas de valores

2. Introduzca un nombre para la lista y seleccione un valor en Tipo.

Creación de una lista a partir de una consulta SQL

El motor de datos espera un par nombre-valor (mostrado) de la consulta de lista de valores.
En la lista de valores Sentencia Select, la columna que aparece primero se utiliza como
nombre mostrado, y la segunda se utiliza para el valor que se transfiere al parámetro en la
consulta de juego de datos mediante el motor de datos.
Si la consulta solo devuelve una columna, se utiliza el mismo valor de columna tanto como
nombre mostrado de la lista de valores que se muestra al usuario como el valor que se
transfiere el parámetro.
1. Seleccione un Origen de datos en la lista.
2. En el panel inferior, seleccione Almacenar resultado en caché (recomendado) si desea
que los resultados de la consulta se almacenen en la caché para la sesión de informe.
3. Introduzca la consulta SQL o utilice Query Builder. En la siguiente figura se muestra una
lista de valores de tipo de consulta SQL.

11-9
 Capítulo 11
Adición de listas de valores

En la consulta SQL que se muestra a continuación solo se selecciona la columna

DEPARTMENT_NAME y la tabla DEPARTMENTS. En este caso, la lista de valores
muestra los resultados de la consulta en la lista y transfiere el mismo valor al
parámetro en el juego de datos. En la siguiente figura se muestran las entradas
mostradas de la lista de valores y los valores transferidos al juego de datos. Los
elementos de menú y los valores mostrados para P_DEPT son los valores de
DEPARTMENT_NAME.

Si, en su lugar, desea transferir el DEPARTMENT_ID al parámetro del juego de datos,

y mostrar el DEPARTMENT_NAME en la lista, construya la consulta SQL de la
siguiente manera:

Select "DEPARTMENTS"."DEPARTMENT_NAME" as "DEPARTMENT_NAME",

"DEPARTMENTS"."DEPARTMENT_ID" as "DEPARTMENT_ID"
from "DEMO"."DEPARTMENTS" "DEPARTMENTS

En la siguiente figura se muestran las entradas mostradas de la lista de valores y los

valores transferidos al juego de datos. El menú muestra el DEPARTMENT_NAME,
mientras que los valores mostrados para P_DEPT son los valores de
DEPARTMENT_ID.

11-10
 Capítulo 11
Adición de listas de valores

Creación de una lista desde un juego de datos fijo

Cree una lista a partir de un juego de datos fijo para cada par de etiqueta/valor necesario.
Al crear un par de etiqueta/valor, la etiqueta se muestra al usuario en la lista. El valor se
transfiere al motor de datos.
1. En el panel inferior, haga clic en el icono Crear una lista de valores nueva para agregar
un par de etiqueta y valor.
2. Repita para cada par de etiqueta/valor necesario.
En la figura siguiente se muestra una lista de valores de tipo de dato fijo.

Creación de una lista a partir de una consulta MDX

Puede utilizar una consulta MDX para crear una lista de valores multidimensionales
especificando la porción de un cubo de Essbase.
Para crear una lista a partir de una consulta MDX:
1. En el panel de componentes del modelo de datos, haga clic en Lista de valores.
2. Haga clic en Crear nueva lista de valores.
3. Introduzca un nombre para la lista en el campo Nombre.
4. Seleccione Consulta MDX en la lista Tipo.
5. Seleccione un origen de datos de OLAP en la lista Origen de datos.
6. En el panel inferior, seleccione Almacenar resultado en caché (recomendado) si desea
que se almacenen los resultados en la caché para la sesión de informe.

11-11
 Capítulo 11
Adición de parámetros de campos flexibles

7. Seleccione el PDV/divisor para la consulta MDX.

a. Haga clic en el icono de búsqueda POV/divisor.
b. Seleccione un cubo.
c. Seleccione una dimensión.
El campo PDV/divisor muestra el cubo y la dimensión seleccionados con el
formato cubo.dimensión.

Adición de parámetros de campos flexibles

Los clientes de Oracle E-Business Suite que hayan configurado Publisher para utilizar
la seguridad de E-Business Suite pueden crear informes que utilicen campos flexibles
clave como parámetros.
Cuando define un modelo de datos para transferir un campo flexible clave como un
parámetro, Publisher presenta un cuadro de diálogo al consumidor del informe para
realizar selecciones a fin de transferir los segmentos de campo flexible como
parámetros al informe, de manera similar a la forma en la que se presentan los
campos flexibles cuando se ejecutan informes a través del gestor simultáneo en E-
Business Suite.
La lista de valores de campo flexible aparece en el visor de informes como se muestra
a continuación.

La lista de valores de campo flexible aparece como un cuadro de diálogo en el que

puede seleccionar los valores de segmento, como se muestra a continuación.

Requisitos para la utilización de campos flexibles

Al definir una lista de valores, los clientes de E-Business Suite ven una lista Tipo
denominada "Campo flexible".

11-12
 Capítulo 11
Adición de parámetros de campos flexibles

Para activar la lista de valores de tipo Campo flexible, configure el uso de E-Business Suite
Security. El campo flexible ya debe estar definido en E-Business Suite.

Adición de un parámetro de campo flexible y de una lista de valores

Agregue parámetros de campo flexible mediante la adición de la lista de valores.
La lista de valores de tipo de campo flexible recupera la definición de metadato de campo
flexible para presentar los valores adecuados para cada segmento en el cuadro de diálogo
de selección de lista de valores de campo flexible. Utilice el parámetro de campo flexible
para transferir valores al campo flexible definido en el modelo de datos.
En tiempo de ejecución, la referencia &flexfield_name se sustituye por el código léxico
construido según los valores en la definición de componente de campo flexible.
1. Agregue la lista de valores de campo flexible.
2. Agregue un parámetro y asócielo a la lista de valores de campo flexible mediante la
selección de la lista de valores de campo flexible como menú de origen del parámetro.
3. Agregue el componente de campo flexible al modelo de datos.
4. Haga referencia al campo flexible en la consulta SQL utilizando la sintaxis
&flexfield_name.

Adición de lista de valores de campo flexible

Agregue una lista de valores recuperada de una definición de campo flexible.
Si selecciona Campos flexibles como Tipo, la opción Origen de datos ya no se podrá editar.
Todas las listas de valores del tipo Campos flexibles utilizan Oracle E-Business Suite como
origen de datos.
1. En el panel de componentes del modelo de datos, haga clic en Lista de valores y, a
continuación, en Crear nueva lista de valores.
2. Introduzca un Nombre para la lista y seleccione Campos flexibles como Tipo.
3. En el panel Flex_Acct_List:Tipo: Flexfields, introduzca lo siguiente:
• Abreviatura de la aplicación: abreviatura de la aplicación de E-Business Suite, por
ejemplo: SQLGL.
• Código flexible de ID: código de campo flexible definido para este campo flexible en
la pantalla Registrar campos flexibles clave, por ejemplo: GL#.
• Número flexible de ID: nombre de la columna o el parámetro de origen que
contiene la información de estructura de campo flexible, por ejemplo: 101
o :STRUCT_NUM. Si utiliza un parámetro, asegúrese de definirlo en el modelo de
datos.
En la imagen se muestra un ejemplo del tipo campo flexible, LOV.

11-13
 Capítulo 11
Adición de parámetros de campos flexibles

Adición del parámetro de menú para la lista de valores de campo flexible

Defina el parámetro para mostrar la lista de valores de campo flexible y capturar los
valores seleccionados por el usuario.
La definición del parámetro de tipo Campo flexible incluye un campo adicional
denominado Rango para soportar campos flexibles de rango. Un campo flexible de
rango soporta valores altos y bajos para cada segmento clave en lugar de valores
únicos. Puede personalizar el valor por defecto del campo flexible y la colocación de
filas en la definición de informe. La colocación de filas determina si este parámetro
aparece en el visor de informes.
Las siguientes opciones están desactivadas para los parámetros de campo flexible:
Número de valores para mostrar en la lista, Selección múltiple, Puede
seleccionar todo y Refrescar otros parámetros al cambiar.
1. En el panel de componentes Modelo de datos, haga clic en Parámetros y, a
continuación, en Crear nuevo parámetro.
2. Seleccione Menú en la lista Tipo de parámetro.
3. Seleccione Cadena o Entero como Tipo de dato.
4. Introduzca un Valor por defecto para el parámetro de campo flexible.
5. Introduzca la Colocación de filas.
6. Introduzca la Etiqueta mostrada. La etiqueta mostrada es la etiqueta que se
muestra a los usuarios cuando visualizan el informe. Por ejemplo: Cuenta de.
7. Seleccione la Lista de valores que ha definido para este parámetro.
Cuando se selecciona una lista de valores que es del tipo Campo flexible, se
muestra un campo adicional denominado Rango.
En la imagen se muestra una definición de parámetro para la lista de valores de
campo flexible.

11-14
 Capítulo 11
Adición de parámetros de campos flexibles

Uso del parámetro de campo flexible para transferir valores a un campo flexible
definido en el modelo de datos
Después de agregar el parámetro de menú a la lista de valores del campo flexible, puede
transferir los valores de parámetro a un componente de campo flexible del modelo de datos.
Para definir el campo flexible en el modelo de datos:
1. En el panel de componentes del modelo de datos, haga clic en Campos flexibles y, a
continuación, en Crear nuevo campo flexible.
2. Introduzca lo siguiente:
• Nombre: introduzca un nombre para el componente de campo flexible.
• Tipo: seleccione el tipo de campo flexible en la lista. El tipo que seleccione aquí
determina los campos adicionales necesarios.
• Abreviatura de la aplicación: introduzca la abreviatura de la aplicación de Fusion
Applications Suite que es propietaria de este campo flexible (por ejemplo, GL).
• Código flexible de ID: introduzca el código de campo flexible definido para este
campo flexible en la pantalla Registrar campo flexible clave (por ejemplo, GL#).
• Número flexible de ID: introduzca el nombre de la columna de origen o del
parámetro que contiene la información de la estructura de campo flexible. Por
ejemplo: 101. Para utilizar un parámetro, añada dos puntos como prefijo al nombre
del parámetro; por ejemplo, :PARAM_STRUCT_NUM.
3. En la región inferior de la página, introduzca los detalles del tipo de campo flexible que
ha seleccionado. En el campo que va a tomar el valor de parámetro, introduzca el
nombre del parámetro precedido de dos puntos; por ejemplo, :P_Acct_List.
En la figura que se muestra a continuación, el componente de campo flexible se define
como un Tipo "Where". El parámetro :P_Acct_List se introduce en el campo Operando1.
En tiempo de ejecución, los valores seleccionados por el usuario para el parámetro
P_Acct_List se utilizarán para crear la cláusula where.

11-15
 Capítulo 11
Adición de parámetros de campos flexibles

Referencia al campo flexible en la consulta SQL

Por último, cree la consulta SQL en la base de datos de E-Business Suite.
Use la sintaxis léxica en la consulta SQL. En la figura siguiente, &Acct_Flex es el
léxico del campo flexible que se llama en la condición where de la consulta SQL.

Transferencia de un rango de valores

Para definir los parámetros para las listas de valores de campo flexible cuando desee
transferir un rango de valores, debe crear dos parámetros de menú que hagan
referencia a la misma lista de valores de campo flexible.
En tiempo de ejecución, los usuarios seleccionan un valor alto en la lista de valores y
un valor bajo en la misma lista de valores. Estos dos valores se transfieren a
continuación como operandos al componente de campo flexible del modelo de datos.

11-16
 Capítulo 11
Adición de parámetros de campos flexibles

1. Cree una lista de valores de campo flexible.

2. Cree el parámetro de rango alto. En el campo Rango, seleccione Alto para designar
este parámetro como el valor alto.
3. Cree el parámetro de rango bajo. En el campo Rango, seleccione Bajo para designar
este parámetro como el valor bajo. Ambos parámetros hacen referencia a la lista de
valores de campo flexible que ha creado en el paso 1. En la figura siguiente se muestra
la creación de parámetros para definir el rango.

4. Cree el campo flexible en el modelo de datos.

En la región inferior de la página, introduzca los detalles del tipo de campo flexible que
ha seleccionado. Introduzca el parámetro con dos puntos como prefijo; por
ejemplo, :P_Acct_List.
En la figura que se muestra a continuación, el componente de campo flexible se define
como un Tipo "Where". Los parámetros :P_FLEX_LOW y :P_FLEX_HIGH se introducen
en los campos Operando1 y Operando2. En tiempo de ejecución, los valores
seleccionados por el usuario para los parámetros P_FLEX_LOW y P_FLEX_HIGH se
utilizarán para crear la cláusula where.

Cuando se muestra el informe asociado a este modelo de datos en el visor de informes, el

consumidor del informe puede ver los dos parámetros de campo flexible, como se muestra a
continuación.

11-17
 Capítulo 11
Adición de parámetros de campos flexibles

Cuando el consumidor del informe hace clic en el indicador de campo flexible alto o
bajo (...), se inicia un cuadro de diálogo donde puede introducir los valores alto y bajo,
como se muestra a continuación.

Las características de visualización en el visor de informes del parámetro de campo

flexible del rango son muy similares a la presentación de los campos flexibles del
rango en E-Business Suite.

11-18
12
Adición de disparadores de eventos
En este tema se describe cómo definir los disparadores en su modelo de datos. Los modelos
de datos soportan disparadores de eventos Antes de datos y Después de datos y
disparadores de programación.

Temas:
• Acerca de los disparadores
• Adición de disparadores de datos Antes de datos y Después de datos
• Creación de disparadores de programación

Acerca de los disparadores

Un disparador de eventos comprueba si se produce un evento y, cuando este se produce,
ejecuta el código asociado al disparador.
Publisher soporta tres tipos:
• Antes de datos: se activa justo antes de que se ejecute el juego de datos.
• Después de datos: se activa justo después de que el motor de datos ejecute todos los
juegos de datos y genere el XML.
• Disparador de programación: se activa cuando se dispara un trabajo programado y
ante de que este se ejecute.
Los disparadores antes y después de datos ejecutan una función PL/SQL almacenada en un
paquete PL/SQL en Oracle Database. El tipo de dato de retorno de una función PL/SQL
dentro del paquete debe ser un tipo booleano y la función debe devolver de forma explícita
TRUE o FALSE.
Un disparador de programación se asocia a un trabajo programado. En el momento en que
un trabajo de informe está programado para ejecutarse, lo que se ejecuta es una consulta
SQL. Si la sentencia SQL devuelve algún dato, se ejecuta el trabajo de informe. Si la
consulta SQL no devuelve ningún dato, se omite la instancia del trabajo.
Los disparadores de eventos solo aceptan un valor en un parámetro. Si transfiere varios
valores a un parámetro de disparador de evento programado, el estado del trabajo
programado se define en Omitido.
Los disparadores de eventos no se utilizan para rellenar los datos utilizados en una
definición de repartición. Consulte Adición de definiciones de repartición.

12-1
 Capítulo 12
Adición de disparadores de datos Antes de datos y Después de datos

Adición de disparadores de datos Antes de datos y Después

de datos
Puede agregar disparadores de eventos que se inicien antes y después de los datos.
Si define un paquete por defecto, debe definir todos los parámetros como una variable
PL/SQL global en el paquete PL/SQL. A continuación, puede transferir los parámetros
de forma explícita al disparador de la función PL/SQL, o bien todos los parámetros
estarán disponibles como variable PL/SQL global. Consulte Propiedades de modelo
de datos
1. En el panel Propiedades del modelo de datos, introduzca el Paquete por
defecto Oracle DB que contiene la firma de la función PL/SQL que se va a
ejecutar cuando se inicie el disparador.
2. En el panel de tareas, haga clic en Disparadores de eventos.
3. En el panel Disparadores de eventos, haga clic en Crear nuevo disparador de
evento.
4. Introduzca lo siguiente para el disparador:
• Nombre: asigne al disparador un nombre significativo.
• Tipo: seleccione Antes de datos o Después de datos.
• Lenguaje: seleccione PL/SQL.
En la figura siguiente se muestra un disparador de evento.

5. Seleccione el paquete en el cuadro Funciones disponibles y haga clic en la

flecha para mover una función al cuadro Disparador del evento.

12-2
 Capítulo 12
Creación de disparadores de programación

El nombre aparece como <nombre de paquete>.<nombre de función> PL/SQL.

Orden de ejecución
Si define varios disparadores del mismo tipo, se activan en el orden en que aparezcan en la
tabla (de la parte superior a la inferior).
Para cambiar el orden de la ejecución:
• Utilice las flechas de Volver a ordenar para colocar los disparadores en el orden
correcto.

Creación de disparadores de programación

Un disparador de programación se dispara cuando un trabajo de informe está programado
para que se ejecute. Los disparadores de programación son de tipo Consulta SQL.
Cuando se programa un trabajo de informe para su ejecución, el disparador de programación
ejecuta la sentencia SQL definida para el disparador. Si se devuelven datos, se envía el
trabajo de informe. Si no se devuelven datos de la consulta SQL del disparador, el trabajo de
informe se omite.
El disparador de programación que asocie con un trabajo de informe puede residir en
cualquier modelo de datos del catálogo. No es necesario crear el disparador de
programación en el modelo de datos del informe para el que desee ejecutar el disparador.
Puede reutilizar los disparadores de programación en varios trabajos de informe.
1. En el panel de tareas del editor del modelo de datos, haga clic en Disparadores del
evento.
2. En el panel Disparadores del evento, haga clic en el icono Crea nuevo.
3. Introduzca lo siguiente para el disparador:
• Nombre: introduzca un nombre para el disparador.
• Tipo: seleccione Programación.
• Idioma: acepte el valor por defecto, Consulta SQL.
4. En el panel inferior, introduzca lo siguiente:
• Opciones: seleccione esta casilla de control para almacenar en la caché los
resultados de la consulta de disparador.
• Origen de datos: seleccione el origen de datos para la consulta de disparador.
• Consulta SQL: introduzca la consulta en el área de texto o haga clic en Query
Builder para utilizar esta utilidad para construir la consulta SQL; consulte Uso de
SQL Query Builder.
Puede incluir parámetros en la consulta de disparador. Defina el parámetro en el
mismo modelo de datos que el disparador. Introduzca los valores de parámetro
cuando programe el trabajo de informe.
Las consultas del disparador de programación no soportan parámetros de selección
múltiple. Si la consulta espera un juego de valores, modifique la consulta.
Si la consulta SQL devuelve algún resultado, se ejecuta el trabajo de informe
programado. En la siguiente figura se muestra un disparador de programación para

12-3
 Capítulo 12
Creación de disparadores de programación

probar niveles de inventario según un valor de parámetro que se puede introducir

en tiempo de ejecución.

12-4
13
Agregar campos flexibles
En este tema se describe el soporte de campos flexibles en los modelos de datos

Temas:
• Acerca de los campos flexibles
• Adición de campos flexibles clave

Acerca de los campos flexibles

Un campo flexible es un campo de datos que puede personalizar la organización según sus
necesidades de negocio sin programación
Las aplicaciones de Oracle Fusion Cloud Applications Suite utilizan dos tipos de campos
flexibles:
• Campos flexibles clave
Un campo flexible clave es un campo que puede personalizar para introducir valores
multisegmento como números de artículo, números de cuenta, etc.
• Campos flexibles descriptivos
Un campo flexible descriptivo es un campo que puede personalizar para introducir
información adicional para la que la aplicación no ha proporcionado un campo.
Si va a generar informes sobre datos de una aplicación de Fusion Applications Suite, utilice
el componente de campo flexible del modelo de datos para recuperar datos de campo
flexible.

Antes de incluir campos flexibles en los informes, debe entender los campos flexibles de las
aplicaciones.

Uso de campos flexibles en su modelo de datos

Use de campos flexibles basados en sentencias SQL SELECT de su modelo de datos.
Para usar campos flexibles en su modelo de datos basado en SQL:

13-1
 Capítulo 13
Adición de campos flexibles clave

• Agregue el componente Campo flexible al modelo de datos como se describe en

este capítulo.
• Defina la sentencia SQL SELECT con respecto a las tablas de datos de las
aplicaciones.
• En la sentencia SELECT, defina cada campo flexible como léxico. Utilice el
elemento &LEXICAL_TAG para incrustar léxicos relacionados con los campos
flexibles en la sentencia SELECT.

Adición de campos flexibles clave

Puede utilizar referencias de campo flexible clave para reemplazar las cláusulas que
aparecen después de SELECT, FROM, WHERE, ORDER BY o HAVING.
Utilice una referencia de campo flexible cuando desee que el parámetro reemplace
varios valores en tiempo de ejecución. El editor del modelo de datos soporta los
siguientes tipos de campo flexible:
• Donde: este tipo de léxico se utiliza en la sección WHERE de la sentencia.
Utilícelo para modificar la cláusula WHERE para que la sentencia SELECT pueda
filtrar en función de los datos del segmento de campo flexible clave.
• Ordenar por: este tipo de léxico se utiliza en la sección ORDER BY de la
sentencia. Utilícelo para obtener una lista de expresiones de columna de modo
que la salida resultante se pueda ordenar por los valores del segmento flexible.
• Seleccionar: este tipo de léxico se utiliza en la sección SELECT de la sentencia.
Utilícelo para recuperar y procesar datos relacionados con la combinación de
código de campo flexible clave (KFF) según la definición de léxico.
• Filtrar: este tipo de léxico se utiliza en la sección WHERE de la sentencia.
Utilícelo para modificar la cláusula WHERE para que la sentencia SELECT pueda
filtrar en función del identificador de filtro transferido desde el servicio de
programación de Oracle Enterprise.
• Metadatos de segmento: utilícelo para recuperar metadatos relacionados con
campos flexibles. No es necesario escribir código PL/SQL para recuperar estos
metadatos. En su lugar, defina una sentencia SELECT ficticia y, a continuación,
utilice este léxico para obtener los metadatos. Este léxico debe devolver una
cadena constante.
Después de configurar los componentes de campo flexible del modelo de datos, cree
una referencia léxica de campo flexible en la consulta SQL mediante la siguiente
sintaxis:
&LEXICAL_TAG ALIAS_NAME

Por ejemplo:
&FLEX_GL_BALANCING alias_gl_balancing

Después de introducir la consulta SQL, al hacer clic en Aceptar

• Introduzca lo siguiente:
– Nombre de léxico: introduzca un nombre para el componente de campo
flexible.
– Tipo de campo flexible: seleccione Campo flexible clave.

13-2
 Capítulo 13
Adición de campos flexibles clave

– Tipo de léxico: seleccione el tipo en la lista. La selección que realice aquí determina
los campos adicionales necesarios. Consulte Introducción de detalles de campo
flexible.
– Abreviatura de la aplicación: introduzca la abreviatura de la aplicación de Fusion
Applications Suite que es propietaria de este campo flexible; por ejemplo, GL.
– Código de campo flexible: introduzca el código de campo flexible definido para
este campo flexible. En Oracle E-Business Suite, este código se define en la pantalla
Registrar campo flexible clave: por ejemplo, GL#.
– Número flexible de ID: introduzca el nombre de la columna de origen o del
parámetro que contiene la información de la estructura de campo flexible. Por
ejemplo: 101. Para utilizar un parámetro, añada dos puntos como prefijo al nombre
del parámetro; por ejemplo, :PARAM_STRUCT_NUM.

Introducción de detalles de campo flexible

La región Detalles muestra los campos adecuados según el Tipo de léxico que seleccione.

Campos para el tipo de campo flexible clave: Metadatos de segmento

En esta tabla se describen los campos de detalles para los metadatos segmentados.

Campo Descripción
Número de instancia de Introduzca el nombre de la columna de origen o del parámetro
estructura que contiene la información de la estructura de campo flexible.
Por ejemplo: 101. Para utilizar un parámetro, añada dos puntos
como prefijo al nombre del parámetro; por
ejemplo, :PARAM_STRUCT_NUM.
Segmentos (Opcional) Identifica para qué segmentos se solicitan estos datos.
El valor por defecto es "ALL". Consulte Oracle E-Business Suite
Developer's Guide para conocer la sintaxis.
Mostrar segmentos Seleccione esta casilla para que se muestren automáticamente los
principales segmentos principales de los segmentos dependientes incluso si
no se muestran en el atributo de los segmentos.
Tipo de metadatos Seleccione el tipo de metadatos que se van a devolver:
Petición datos de segmentos anterior — Petición datos de
segmento(s) anterior.
Petición datos segmentos izquierda — Petición datos segmento(s)
izquierda

13-3
 Capítulo 13
Adición de campos flexibles clave

Campos para el tipo de campo flexible clave: Seleccionar

En la tabla siguiente se muestran los campos de detalles para el tipo de campo
flexible Seleccionar.

Campo Descripción
Activar varias instancias Indica si este léxico soporta varias estructuras. Al marcar
de estructura esta casilla se indica que todas las estructuras se utilizan
potencialmente para la creación de informes de datos. El
motor de datos utiliza
<code_combination_table_alias>.<set_defining_column_name
> para recuperar el número de estructura.
Alias de tabla de Especifique el alias de tabla para añadirlo como prefijo a los
combinación de código nombres de columna. Utilice TABLEALIAS si SELECT se une a
otras tablas de campo flexible o utiliza una autounión.
Número de instancia de Introduzca el nombre de la columna de origen o del
estructura parámetro que contiene la información de la estructura de
campo flexible. Por ejemplo: 101. Para utilizar un parámetro,
añada dos puntos como prefijo al nombre del parámetro; por
ejemplo, :PARAM_STRUCT_NUM.
Segmentos (Opcional) Identifica para qué segmentos se solicitan estos
datos. El valor por defecto es "ALL". Consulte Oracle E-
Business Suite Developer's Guide para conocer la sintaxis.
Mostrar segmentos Seleccione esta casilla para que se muestren
principales automáticamente los segmentos principales de los segmentos
dependientes incluso si no se muestran en el atributo de los
segmentos.
Tipo de salida Seleccione una de las siguientes opciones:
• Valor: valor de segmento como se muestra a los
usuarios.
• Valor rellenado: valor de segmento rellenado como se
muestra a los usuarios. Los valores de tipo numérico se
rellenan desde la izquierda. Los valores de tipo cadena
se rellenan por la derecha.
• Descripción: descripción del valor de segmento hasta el
tamaño de descripción definido en la definición de
segmento.
• Descripción completa: descripción del valor de
segmento (tamaño completo).
• Seguridad: devuelve Y si la combinación actual está
protegida frente al usuario actual; de lo contrario,
devuelve N.

Campos para el tipo de campo flexible clave: Donde

En la tabla siguiente se muestran los campos de detalles para el tipo de campo
flexible clave Donde.

Campo Descripción
Alias de tabla de Especifique el alias de tabla para añadirlo como prefijo a los
combinación de código nombres de columna. Utilice TABLEALIAS si SELECT se une a
otras tablas de campo flexible o utiliza una autounión.

13-4
 Capítulo 13
Adición de campos flexibles clave

Campo Descripción
Número de instancia de Introduzca el nombre de la columna de origen o del
estructura parámetro que contiene la información de la estructura de
campo flexible. Por ejemplo: 101. Para utilizar un parámetro,
añada dos puntos como prefijo al nombre del parámetro; por
ejemplo, :PARAM_STRUCT_NUM.
Segmentos (Opcional) Identifica para qué segmentos se solicitan estos
datos. El valor por defecto es "ALL". Consulte Oracle E-
Business Suite Developer's Guide para conocer la sintaxis.
Operador Seleccione el operador adecuado.
Operando1 Introduzca el valor que se va a utilizar en el lado derecho del
operador condicional.
Operando2 (Opcional) Valor superior para el operador BETWEEN.

Campos para el tipo de campo flexible clave: Ordenar por

En la tabla siguiente se muestran los campos de detalles para el tipo de campo flexible
Ordenar por.

Campo Descripción
Activar varias instancias de Indica si este léxico soporta varias estructuras. La selección de
estructura esta casilla indica que todas las estructuras se utilizan
potencialmente para la creación de informes de datos. El motor de
datos utiliza
<code_combination_table_alias>.<set_defining_column_name>
para recuperar el número de estructura.
Número de instancia de Introduzca el nombre de la columna de origen o del parámetro
estructura que contiene la información de la estructura de campo flexible.
Por ejemplo: 101. Para utilizar un parámetro, añada dos puntos
como prefijo al nombre del parámetro; por
ejemplo, :PARAM_STRUCT_NUM.
Alias de tabla de Especifique el alias de tabla para añadirlo como prefijo a los
combinación de código nombres de columna. Utilice TABLEALIAS si SELECT se une a
otras tablas de campo flexible o utiliza una autounión.
Segmentos (Opcional) Identifica para qué segmentos se solicitan estos datos.
El valor por defecto es "ALL". Consulte Oracle E-Business Suite
Developer's Guide para conocer la sintaxis.
Mostrar segmentos Seleccione esta casilla para que se muestren automáticamente los
principales segmentos principales de los segmentos dependientes incluso si
no se muestran en el atributo de los segmentos.

Campos para el tipo de campo flexible clave: Filtrar

En la tabla siguiente se muestran los campos de detalles para el tipo de campo flexible
Filtrar.

Campo Descripción
Alias de tabla de Especifique el alias de tabla para añadirlo como prefijo a los
combinación de código nombres de columna. Utilice TABLEALIAS si SELECT se une a
otras tablas de campo flexible o utiliza una autounión.

13-5
 Capítulo 13
Adición de campos flexibles clave

Campo Descripción
Número de instancia de Introduzca el nombre de la columna de origen o del parámetro
estructura que contiene la información de la estructura de campo flexible.
Por ejemplo: 101. Para utilizar un parámetro, añada dos puntos
como prefijo al nombre del parámetro; por
ejemplo, :PARAM_STRUCT_NUM.

13-6
14
Adición de definiciones de repartición
En este tema se describe el soporte para los informes de repartición, y cómo configurar una
definición de repartición en el modelo de datos con el fin de dividir y entregar el informe a
varios destinatarios.

Temas:
• Acerca de la repartición
• ¿Qué es una definición de depuración?
• Requisitos para agregar definiciones de repartición
• Uso de una consulta SQL para agregar una definición de repartición al modelo de datos
• Uso de un juego de datos visualizado para agregar una definición de repartición al
modelo de datos
• Definición de la consulta para la entrega de un archivo XML
• Transferencia de un parámetro a la consulta de repartición
• Definición de los elementos Dividir por y Entregar por para un juego de datos CLOB/XML
• Configuración de un informe para usar una definición de repartición
• Consulta de repartición de ejemplo
• Creación de una tabla para utilizarla como origen de datos de una entrega

Acerca de la repartición
La repartición es un proceso de división de datos en bloques que genera documentos para
cada bloque y entrega los documentos a uno o varios destinos.
Los datos para el informe se generan mediante la ejecución de una consulta una vez y la
división a continuación de los datos según un valor Key. Para cada bloque de datos, se
genera y se entrega un documento independiente.
El uso de Publisher durante la repartición permite dividir un único informe en función de un
elemento del modelo de datos y entregar el informe en función de un segundo elemento del
modelo de datos. Según el elemento de entrega, puede aplicar una plantilla, un formato de
salida, un método de entrega y una configuración regional diferentes a cada segmento
dividido del informe. Las implantaciones de ejemplo son:
• Generación y entrega de facturas según los diseños específicos del cliente y la
preferencia de entrega.
• Generación de informes financieros para generar un informe maestro de todos los
centros de costo, dividiendo en informes de centros de costo individuales para el gestor
adecuado.
• Generación de nóminas para todos los empleados basada en una extracción y entrega
por correo electrónico.

14-1
 Capítulo 14
¿Qué es una definición de depuración?

¿Qué es una definición de depuración?

Una definición de depuración es un componente del modelo de datos. Después de
definir los juegos de datos para el modelo de datos, puede configurar una o más
definiciones de depuración.
Al configurar una definición de depuración, debe definir lo siguiente:
• El elemento Dividir por gobierna cómo se dividen los datos. Por ejemplo, para
dividir un lote de facturas por cada factura, puede utilizar un elemento
denominado CUSTOMER_ID. Se debe ordenar o agrupar el juego de datos por
este elemento.
• Entregar por gobierna cómo se aplican las opciones de formato y entrega. En el
ejemplo de la factura, es probable que cada factura tenga criterios de entrega
determinados por el cliente; por lo tanto, el elemento Entregar por también sería
CUSTOMER_ID.
• La Consulta de entrega es una consulta SQL que define para construir el archivo
de datos XML de entrega. La consulta debe devolver los detalles de formato y
entrega.

Requisitos para agregar definiciones de repartición

En este tema se muestran los requisitos para agregar una definición de repartición al
modelo de datos.
Antes de definir la repartición y de activarla en el informe, asegúrese de lo siguiente:
• Ha definido un juego de datos de consulta SQL o un juego de datos de Data
Modeler para este modelo de datos.
• El juego de datos se ordena o agrupa por el elemento por el que desee dividir los
datos en la definición de repartición.
• La información de entrega y formato está disponible para Publisher. Puede
proporcionar la información en tiempo de ejecución para Publisher de una de las
siguientes formas:
– La información se almacena en una tabla de base de datos disponible para
Publisher para una definición de entrega dinámica.
– La información se codifica en el SQL de entrega para una definición de
entrega estática.
• La definición de informe para este modelo de datos se ha creado e incluye los
diseños que se van a aplicar a los datos del informe.

Uso de una consulta SQL para agregar una definición de

repartición al modelo de datos
En la tabla Definiciones de repartición, agregue una definición de repartición
especificando el nombre, el tipo, el origen de datos y otras propiedades.
Utilice una consulta SQL para agregar una definición de repartición al modelo de
datos y activar la repartición en el informe. Las validaciones de consulta SQL

14-2
 Capítulo 14
Uso de una consulta SQL para agregar una definición de repartición al modelo de datos

garantizan que la consulta SQL para la repartición devuelva filas distintas. La consulta SQL
falla con un error si el tamaño de los resultados de una consulta de repartición supera las
200 000 filas.
1. En el panel de componentes del editor del modelo de datos, haga clic en Repartición
para crear una consulta de repartición.
2. En la tabla Definición de reparticiones, haga clic en el botón Crear repartición.
3. Introduzca lo siguiente para esta definición de repartición:
• Nombre: introduzca un nombre para la consulta. Por ejemplo, Repartir en archivo.
• Tipo: seleccione Consulta SQL.
• Origen de datos: seleccione el origen de datos que contiene la información de
entrega.
4. En la región inferior, introduzca lo siguiente para esta definición de repartición:
• Dividir por: seleccione el elemento del juego de datos por el que desea dividir los
datos.
• Entregar por: seleccione el elemento del juego de datos por el que desea dar
formato a los datos y entregarlos.
• Activar salida consolidada: seleccione esta opción para generar un único informe
consolidado.
• Agrupar datos por valores clave de división: seleccione esta opción para agrupar
los datos según los valores de clave de división.
• Consulta SQL: introduzca la consulta o haga clic en QueryBuilder para crear la
consulta de repartición.
• Anexo: asocie archivos PDF externos al PDF del resultado de repartición si es
necesario.
5. En el cuadro de diálogo Propiedades del informe, seleccione Activar repartición para
activar la repartición para un informe.
Si los elementos split-by y deliver-by residen en un documento XML almacenado como
un CLOB en la base de datos, debe introducir la XPATH completa en los campos Dividir por
y Entregar por.

Asociación de PDF a informes mediante el motor de repartición

Puede que deba asociar archivos PDF junto con las facturas para los clientes. Ahora puede
agregar estos documentos a la factura durante la repartición.
Una vez definida una consulta de repartición, puede introducir la consulta de anexo en el
separador Anexo. El anexo espera que el origen del repositorio sea un contenido de
WebCenter, el cual puede definir el administrador como origen de datos.
1. Haga clic en el separador Anexo.
2. Seleccione el nombre del servidor de contenido en la lista de valores Repositorios de
anexos.
3. Defina la consulta SQL para el anexo en el servidor de contenidos.
4. Haga clic en el icono Guardar después de realizar los cambios en el modelo de datos.
5. Haga clic en el botón Ver datos.

14-3
 Capítulo 14
Uso de un juego de datos visualizado para agregar una definición de repartición al modelo de datos

6. Haga clic en Ver para ver los datos.

7. Guarde los datos haciendo clic en Guardar como datos de muestra.
8. Para crear un informe basado en el modelo de datos que ha creado, haga clic en
Crear informe.
Tenga en cuenta que los anexos PDF se entregan a los destinatarios junto con el
informe principal como un único archivo PDF. El documento anexo no se embebe por
separado, sino que se agrega al informe.
Si desea guardar el informe PDF completo junto con los anexos como un único
archivo consolidado, marque la opción Activar salida consolidada debajo de la
consulta de repartición. La salida consolidada contiene la fusión secuencial de informe
y anexo de cada repartición. El usuario (con el rol de consumidor) que programa el
trabajo de informe de repartición y el administrador podrán ver la salida consolidada
en la página Detalles de historial de trabajos.

Uso de un juego de datos visualizado para agregar una

definición de repartición al modelo de datos
Puede utilizar un juego de datos visualizado de Data Modeler para agregar una
definición de repartición al modelo de datos y, a continuación, activar la repartición en
el informe.
Si desea agregar los juegos de datos que se crean en Data Modeler a la definición de
repartición, asegúrese de crear la consulta correcta en Data Modeler, ya que no es
posible cambiar la clave y los canales de entrega después de agregar el juego de
datos a la definición de repartición en Publisher. En Data Modeler, puede crear
modelos de datos desde el principio o utilizar datos empresariales modelados
previamente con Oracle BI Enterprise Edition.
Para utilizar un juego de datos de Data Modeler para definir la repartición en el
modelo de datos y, a continuación, activar la repartición en el informe:
1. En el panel de componentes del editor del modelo de datos, haga clic en
Repartición para crear una consulta de repartición.
2. En la tabla de definiciones Repartición, haga clic en el botón Crear nueva
repartición.
3. Introduzca lo siguiente para esta definición de repartición:
Nombre: introduzca un nombre para la consulta. Por ejemplo, Repartir en correo
electrónico.
Tipo: seleccione los Juegos de datos de DV para utilizar un juego de datos
definido en Data Modeler.
4. En la región inferior, introduzca lo siguiente para esta definición de repartición:
Dividir por: seleccione el elemento del juego de datos por el que desea dividir los
datos.
Entregar por: seleccione el elemento del juego de datos por el que desea dar
formato a los datos y entregarlos.
Activar salida consolidada: seleccione esta opción para generar un único
informe consolidado.

14-4
 Capítulo 14
Definición de la consulta para la entrega de un archivo XML

Agrupar datos por valores clave de división: seleccione esta opción para agrupar los
datos según los valores de clave de división.
Nombre del juego de datos: seleccione el juego de datos definido en Data Modeler.
5. En el cuadro de diálogo Propiedades del informe, seleccione Activar repartición para
activar la repartición para un informe.
Si los elementos split-by y deliver-by residen en un documento XML almacenado como
un CLOB en la base de datos, debe introducir la XPATH completa en los campos Dividir por
y Entregar por.

Definición de la consulta para la entrega de un archivo XML

La consulta de repartición es una consulta SQL que define para proporcionar la información
necesaria para formatear y entregar el informe.
Publisher utiliza los resultados de la consulta de repartición para crear el XML de entrega.
El motor de repartición de utiliza el XML de entrega como tabla de asignación para cada
elemento Entregar por. La estructura del XML de entrega que requiere Publisher es la
siguiente:

<ROWSET>
<ROW>
<KEY></KEY>
<TEMPLATE></TEMPLATE>
<LOCALE></LOCALE>
<OUTPUT_FORMAT></OUTPUT_FORMAT>
<DEL_CHANNEL></DEL_CHANNEL>
<TIMEZONE></TIMEZONE>
<CALENDAR></CALENDAR>
<OUTPUT_NAME></OUTPUT_NAME>
<SAVE_OUTPUT></SAVE_OUTPUT>
<PARAMETER1></PARAMETER1>
<PARAMETER2></PARAMETER2>
<PARAMETER3></PARAMETER3>
<PARAMETER4></PARAMETER4>
<PARAMETER5></PARAMETER5>
<PARAMETER6></PARAMETER6>
<PARAMETER7></PARAMETER7>
<PARAMETER8></PARAMETER8>
<PARAMETER9></PARAMETER9>
<PARAMETER10></PARAMETER10>
</ROW>
</ROWSET>

• KEY: clave de entrega, que debe coincidir con el elemento Entregar por. El motor de
repartición utiliza la clave para enlazar los criterios de entrega a una sección específica
de los datos repartidos. Asegúrese de introducir "KEY" entre comillas dobles en la
sentencia select; por ejemplo:
select d.department_name as "KEY",
• TEMPLATE: nombre del diseño que se va a aplicar. Tenga en cuenta que el valor es el
nombre del diseño (por ejemplo, 'Customer Invoice'), y no el nombre del archivo de
plantilla (por ejemplo, invoice.rtf).

14-5
 Capítulo 14
Definición de la consulta para la entrega de un archivo XML

• LOCALE: configuración regional de la plantilla; por ejemplo, 'en-US'.

• OUTPUT_FORMAT: formato de salida. En la tabla siguiente se muestran los
valores válidos que se deben introducir para la consulta de repartición.

Formato de salida Valor para Tipos de plantilla que pueden generar este
introducir en la formato de salida
consulta de
repartición
Interactivo N/A No está soportado para la repartición
HTML html – Publisher
– RTF
– Hoja de estilo XSL (FO)
PDF pdf – Publisher
– RTF
– PDF
– Hoja de estilo XSL (FO)
RTF rtf – Publisher
– RTF
– Hoja de estilo XSL (FO)
Excel (*.xlsx) xlsx – Publisher
– RTF
– Hoja de estilo XSL (FO)
PowerPoint (*.pptx) pptx – Publisher
– RTF
– Hoja de estilo XSL (FO)
MHTML MHTML – Publisher
– RTF
– Hoja de estilo XSL (FO)
PDF/A PDFA – Publisher
– RTF
– Hoja de estilo XSL (FO)
PDF/X PDFX – Publisher
– RTF
– Hoja de estilo XSL (FO)
PDF comprimidos PDFZ – Publisher
– RTF
– PDF
– Hoja de estilo XSL (FO)
XML con formato xslfo – Publisher
FO – RTF
– Hoja de estilo XSL (FO)
Datos (XML) xml – Publisher
– RTF
– PDF
– Excel
– Hoja de estilo XSL (FO)
– Hoja de estilo XSL (XML HTML/Texto)
– Etext

14-6
 Capítulo 14
Definición de la consulta para la entrega de un archivo XML

Formato de salida Valor para Tipos de plantilla que pueden generar este
introducir en la formato de salida
consulta de
repartición
Datos (CSV) csv – Publisher
– RTF
– PDF
– Excel
– Hoja de estilo XSL (FO)
– Hoja de estilo XSL (XML HTML/Texto)
– Etext
XML txml Hoja de estilo XSL (XML HTML/Texto)
Texto texto – Hoja de estilo XSL (XML HTML/Texto)
– Etext

• SAVE_OUTPUT: indica si se deben guardar los documentos de salida en las tablas del
historial de Publisher para que se pueda ver y descargar el historial en la página Historial
de trabajos de informe.
Los valores válidos son 'true' (por defecto) y 'false'. Si no está definida esta propiedad, se
guarda la salida.
• DEL_CHANNEL: método de entrega. Los valores válidos son:
– CECS
– EMAIL
– FAX
– FILE
– FTP
– OBJECTSTORAGE
– PRINT
– WCC
• TIMEZONE: zona horaria que se va a utilizar para el informe. Los valores deben tener el
formato Java; por ejemplo: 'America/Los_Angeles'. Si no se proporciona la zona horaria,
se utiliza la zona horaria por defecto del sistema para generar el informe.
• CALENDAR: calendario que se va a utilizar para el informe. Los valores válidos son:
– GREGORIAN
– ARABIC_HIJRAH
– ENGLISH_HIJRAH
– JAPANESE_IMPERIAL
– THAI_BUDDHA
– ROC_OFFICIAL (Taiwán)
Si no se proporciona, se utiliza el valor 'GREGORIAN'.
• OUTPUT_NAME: nombre que se va a asignar al archivo de salida en el historial de
trabajos de informe.

14-7
 Capítulo 14
Definición de la consulta para la entrega de un archivo XML

• Parámetros de entrega por canal: los valores necesarios para los parámetros
dependen del método de entrega seleccionado. Las asignaciones de valores de
parámetro para cada método se muestran en la tabla siguiente. No todos los
canales de entrega utilizan todos los parámetros.

Canal de entrega Valores de PARAMETER

CEC (Oracle Content PARAMETER1: Nombre de servidor
Management Cloud) PARAMETER2: Nombre de carpeta
PARAMETER3: Nombre de archivo
Correo electrónico PARAMETER1: Dirección de correo electrónico
PARAMETER2: Cc
PARAMETER3: De
PARAMETER4: Asunto
PARAMETER5: Cuerpo del mensaje
PARAMETER6: Valor de anexo ('true' o 'false'). Si el formato de
salida es PDF, debe definir este parámetro en "true" para asociar
el PDF al correo electrónico.
PARAMETER7: Responder a
PARAMETER8: Cco (no se utilizan los valores de PARAMETER 9-10)
Fax PARAMETER1: Nombre de servidor de faxes
PARAMETER2: Número de fax
(los valores de PARAMETER 3-10 no se utilizan)
Archivo PARAMETER1: Directorio
PARAMETER2: Nombre de archivo
(los valores de PARAMETER 3-10 no se utilizan)
FTP y SFTP PARAMETER1: Nombre de servidor
PARAMETER2: Nombre de usuario
PARAMETER3: Contraseña
PARAMETER4: Directorio remoto
PARAMETER5: Nombre archivo remoto
PARAMETER6: seguro (defina este valor en 'true' para activar FTP
seguro)
(los valores de PARAMETER 7-10 no se utilizan)
Si desea utilizar la configuración de entrega FTP configurada por
el administrador, no introduzca los valores del nombre de usuario
(PARAMETER2) y la contraseña (PARAMETER3). Proporcione las
credenciales de nombre de usuario (PARAMETER2) y contraseña
(PARAMETER3) para el servidor FTP solo si desea anular la
configuración del servidor FTP y utilizar la autenticación basada
en contraseña.
Object Storage PARAMETER1: Nombre de servidor
PARAMETER2: Prefijo
PARAMETER3: Nombre de archivo

14-8
 Capítulo 14
Transferencia de un parámetro a la consulta de repartición

Canal de entrega Valores de PARAMETER

Impresora PARAMETER1: Grupo de impresoras
PARAMETER2: Nombre de impresora o de una impresora en CUPS,
el URI de la impresora; por ejemplo: ipp://myserver.com:631/
printers/printer1
PARAMETER3: Número de copias
PARAMETER4: Caras. Los valores válidos son:
• "d_single_sided" para una cara
• "d_double_sided_l" para dúplex/borde largo
• "d_double_sided_s" para cambio de cara/borde corto
Si no se especifica el parámetro, se utiliza el valor de una cara.
PARAMETER5: Bandeja. Los valores válidos son:
• "t1" para "Bandeja 1"
• "t2" para "Bandeja 2"
• "t3" para "Bandeja 3"
Si no se especifica, se utiliza el valor por defecto de impresora.
PARAMETER6: Rango de impresión. Por ejemplo, "3" imprime solo
la página 3, "2-5" imprime las páginas 2-5, "1,3-5" imprime las
páginas 1 y 3-5
(los valores de PARAMETER 7-10 no se utilizan)
WCC PARAMETER1: Nombre de servidor
PARAMETER2: Grupo de seguridad
PARAMETER3: Autor
PARAMETER4: Cuenta (opcional)
PARAMETER5: Título
PARAMETER6: Archivo primario (o Nombre de archivo)
PARAMETER7: Comentarios (opcional)
PARAMETER8: ID de contenido (opcional, el ID de contenido debe
ser único).
PARAMETER9: Personalizar metadatos

Transferencia de un parámetro a la consulta de repartición

Puede transferir el valor de un elemento del XML de repartición mediante un parámetro
definido en el modelo de datos.
Por ejemplo, si desea poder seleccionar la plantilla en el momento del envío, puede definir
un parámetro en el modelo de datos y utilizar la sintaxis :parameter_name en la consulta. En
el siguiente ejemplo, se muestra este caso de uso de un parámetro en una consulta de
repartición.
Supongamos que la definición de informe incluye tres diseños: layout1, layout2 y layout3. En
el momento del envío, desea seleccionar el diseño (o la TEMPLATE, definida en la consulta
de repartición) que se va a utilizar.
Para transferir un parámetro a la consulta de repartición:
1. En el modelo de datos, defina una lista de valores con los nombres de diseño

14-9
 Capítulo 14
Definición de los elementos Dividir por y Entregar por para un juego de datos CLOB/XML

2. Cree un parámetro del tipo menú. Introduzca P1 como nombre y seleccione Lista
de diseños en Lista de valores.
3. En la consulta de repartición, transfiera el valor del parámetro al campo
TEMPLATE mediante :P1como se muestra en la siguiente figura:

Definición de los elementos Dividir por y Entregar por para

un juego de datos CLOB/XML
Si los elementos split-by y deliver-by necesarios para la definición de repartición
residen en un juego de datos recuperado de una columna CLOB de una base de

14-10
 Capítulo 14
Definición de los elementos Dividir por y Entregar por para un juego de datos CLOB/XML

datos, Publisher no puede analizar el XML para presentar los elementos en los campos
Dividir por y Entregar por en el editor del modelo de datos.
Por lo tanto, debe introducir manualmente la XPath para encontrar cada elemento en el
juego de datos XML recuperado. Para asegurarse de que introduce la ruta correctamente,
utilice la función Obtener salida XML del editor del modelo de datos para ver el XML que
genera el motor de datos.
Por ejemplo, el código XML de ejemplo, que se muestra en la siguiente figura, se ha
almacenado en una columna CLOB en la base de datos denominada "XMLTEXT", y se ha
extraído como un juego de datos XML:

Para este ejemplo, desea agregar una definición de repartición con los elementos split-by y
deliver-by basados en el DEPARTMENT_ID, que es un elemento dentro del juego de datos
CLOB/XML.
Cuando agrega la definición de repartición, los campos Dividir por y Entregar por no pueden
analizar la estructura subyacente al elemento XMLTEXT. Por lo tanto, el campo no muestra
los elementos disponibles bajo el nodo XMLTEXT, como se muestra en la siguiente figura.

14-11
 Capítulo 14
Configuración de un informe para usar una definición de repartición

Para utilizar el elemento DEPARTMENT_ID como elemento Dividir por, escriba

manualmente la XPath al campo, como se muestra en la siguiente figura.

Configuración de un informe para usar una definición de

repartición
Aunque se pueden definir varias definiciones de repartición para un solo modelo de
datos, solo se puede activar una para un informe.

Para configurar un informe para utilizar una definición de repartición:

1. Permita que un informe utilice una definición de repartición en el cuadro de
diálogo Propiedades del informe del editor de informes.
2. Programe un trabajo para este informe.
3. Seleccione que se utilice la definición de repartición para formatear y entregar el
informe.
Puede seleccionar que no se utilice la definición de repartición y seleccionar su
propia salida y destino como un informe programado normal.

Consulta de repartición de ejemplo

El siguiente ejemplo de consulta de repartición está basado en un informe de factura.
Este informe lo entregará CUSTOMER_ID a la dirección de correo electrónico
individual de cada cliente.
En este ejemplo se asume que las preferencias de entrega y formato para cada
cliente se incluyen en una tabla de base de datos denominada "CUSTOMERS". La
tabla CUSTOMERS incluye las siguientes columnas que se recuperarán para crear
dinámicamente el XML de entrega en tiempo de ejecución:
• CST_TEMPLATE
• CST_LOCALE
• CST_FORMAT
• CST_EMAIL_ADDRESS
El CUSTOMER_ID se utilizará como KEY y también para definir el nombre del archivo
de salida.

14-12
 Capítulo 14
Creación de una tabla para utilizarla como origen de datos de una entrega

El código SQL para generar el juego de datos de entrega para este ejemplo es el siguiente:

select distinct
CUSTOMER_ID as "KEY",
CST_TEMPLATE TEMPLATE,
CST_LOCALE LOCALE,
CST_FORMAT OUTPUT_FORMAT,
CUSTOMER_ID OUTPUT_NAME,
'EMAIL' DEL_CHANNEL,
CST_EMAIL_ADDRESS PARAMETER1,
'accounts.receivable@example.com' PARAMETER2,
'bip-collections@example.com' PARAMETER3,
'Your Invoices' PARAMETER4,
'Hi'||CUST_FIRST_NAME||':'|| 'Please find attached your
invoices.' PARAMETER5,
'true' PARAMETER6,
'donotreply@mycompany.com' PARAMETER7
from CUSTOMERS

Creación de una tabla para utilizarla como origen de datos de

una entrega
Si la información de entrega no está disponible fácilmente en los orígenes de datos
existentes, puede considerar crear una tabla y utilizarla para que la consulta pueda crear el
XML de entrega.
A continuación, se muestra un ejemplo:

CREATE TABLE "XXX"."DELIVERY_CONTROL"

( "KEY" NUMBER,
"TEMPLATE" VARCHAR2(20 BYTE),
"LOCALE" VARCHAR2(20 BYTE),
"OUTPUT_FORMAT" VARCHAR2(20 BYTE),
"DEL_CHANNEL" VARCHAR2(20 BYTE),
"PARAMETER1" VARCHAR2(100 BYTE),
"PARAMETER2" VARCHAR2(100 BYTE),
"PARAMETER3" VARCHAR2(100 BYTE),
"PARAMETER4" VARCHAR2(100 BYTE),
"PARAMETER5" VARCHAR2(100 BYTE),
"PARAMETER6" VARCHAR2(100 BYTE),
"PARAMETER7" VARCHAR2(100 BYTE),
"PARAMETER8" VARCHAR2(100 BYTE),
"PARAMETER9" VARCHAR2(100 BYTE),
"PARAMETER10" VARCHAR2(100 BYTE),
"OUTPUT_NAME" VARCHAR2(100 BYTE),
"SAVE_OUTPUT" VARCHAR2(4 BYTE),
"TIMEZONE" VARCHAR2(300 BYTE),
"CALENDAR" VARCHAR2(300 BYTE)
) PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255 NOCOMPRESS LOGGING
STORAGE(INITIAL 65536 NEXT 1048576 MINEXTENTS 1 MAXEXTENTS 2147483645
PCTINCREASE 0 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT)
TABLESPACE "EXAMPLES";

14-13
 Capítulo 14
Creación de una tabla para utilizarla como origen de datos de una entrega

Si el controlador JDBC que utiliza no soporta alias de columna, cuando defina la tabla
de control de repartición, las columnas deben coincidir exactamente con el nombre de
la etiqueta XML de control. Por ejemplo, la columna KEY debe denominarse KEY, y
debe estar en mayúsculas. PARAMETER1 debe denominarse PARAMETER1, no
parameter1 ni param1, ni ningún otro nombre que no coincida.
Consejos para crear una tabla de creación de entrega de repartición:
• Si el juego de datos dividido no contiene un valor DELIVERY_KEY, el documento
no se entrega ni se genera. Por ejemplo, utilizando el ejemplo anterior, si el cliente
con el identificador 123 no está definido en la tabla de entrega de repartición, no
se genera el documento de este cliente.
• Para permitir que un juego de datos dividido genere más de un documento o
entregue a más de un destino, duplique el valor DELIVERY_KEY y proporcione
juegos diferentes de OUTPUT_FORMAT, DEL_CHANNEL u otros parámetros. Por
ejemplo, el cliente con el identificador 456 desea que su documento se entregue
en dos direcciones de correo electrónico. Para ello, inserte dos filas en la tabla,
ambas con 456 como DELIVERY_KEY y cada una con su propia dirección de
correo electrónico.

14-14
15
Adición de metadatos personalizados para
Oracle WebCenter Content Server
En este tema se describe cómo utilizar el editor del modelo de datos para asignar campos
del origen de datos a campos de metadatos personalizados. Al entregar informes a Oracle
WebCenter Content, Publisher puede rellenar los campos de metadatos personalizados
definidos en los perfiles de documento.

Temas:
• Acerca de la asignación de metadatos personalizados
• Asignación de campos de datos a campos de metadatos personalizados
• Supresión de campos de metadatos no usados

Acerca de la asignación de metadatos personalizados

El componente Personalizar metadatos permite la asignación de campos de datos, por
ejemplo, el número de factura o de cliente, del modelo de datos a los campos de metadatos
definidos en las reglas de perfil de documento configuradas en el servidor de Oracle
WebCenter Content.
Al ejecutar el informe y seleccionar el servidor de Oracle WebCenter Content como destino
de entrega, Publisher genera y almacena el documento en el servidor de contenido con los
metadatos.

Requisitos
Se deben cumplir determinados requisitos para usar esta función del editor de modelos de
datos.
Requisitos:
• Se debe configurar el servidor de contenido como destino de entrega con metadatos
personalizados activados.
• Para asignar los campos de metadatos personalizados a campos de datos de su juego
de datos del modelo de datos, el juego de datos debe ser de un tipo cuya estructura de
datos pueda recuperar el editor de modelo de datos, por ejemplo, están soportados los
juegos de datos SQL y de Excel; sin embargo, no están soportados los juegos de datos
del servicio web.

Asignación de campos de datos a campos de metadatos

personalizados
Puede iniciar metadatos en un perfil de documento.
Para asignar metadatos personalizados:

15-1
 Capítulo 15
Asignación de campos de datos a campos de metadatos personalizados

1. En el panel de tareas del editor del modelo de datos, haga clic en Metadatos
personalizados.

2. Oracle WebCenter Content Server almacena los metadatos en un perfil de

documento. Un perfil de documento se anida posteriormente en reglas. Para
recuperar los campos de metadatos para la asignación, primero debe seleccionar
el servidor de WebCenter, a continuación, el Perfil de contenido y, por último, el
juego de Reglas.
En la región de cabecera Metadatos personalizados, seleccione las Reglas de la
siguiente manera:
• Servidor: seleccione el servidor de contenidos web donde está definido el
perfil de contenido.
• Perfil de contenido: seleccione el perfil de contenido que incluye las reglas
que definen los campos de metadatos personalizados.
• Reglas: seleccione el juego de reglas que especifica los campos de
metadatos.
Si no selecciona un juego de reglas, Publisher carga los metadatos para todas
las reglas en Perfil de contenido.
3. Haga clic en Cargar metadatos. El panel inferior muestra los campos de
metadatos definidos en las Reglas que ha seleccionado.

15-2
 Capítulo 15
Asignación de campos de datos a campos de metadatos personalizados

4. Para cada campo de metadatos, asigne un campo de datos de sus juegos de datos
seleccionándolo en la lista Asignación de datos. La lista Asignación de datos muestra
todos los campos de datos de sus juegos de datos.
Si un campo de metadatos es necesario, se muestra una S en la columna Necesario.

15-3
 Capítulo 15
Supresión de campos de metadatos no usados

5. Cuando haya terminado con la asignación de campos de metadatos, haga clic en

Guardar.

Supresión de campos de metadatos no usados

Publisher carga todos los campos de metadatos definidos para el juego de reglas que
seleccione. Puede suprimir los campos de metadatos personalizados no necesarios.

1. Seleccione el campo de metadatos, ya sea haciendo clic en el nombre de campo

del panel de la izquierda o haciendo clic en la columna de selección de la tabla.
2. Haga clic en el botón Suprimir.

15-4
16
Mejores prácticas de rendimiento
En este tema se proporcionan consejos para crear modelos de datos eficientes para un
mejor rendimiento.

Temas:
• Información sobre la opción Timeout por defecto de Oracle WebLogic Server
• Mejores prácticas para juegos de datos de SQL
• Límite de las listas de valores
• Trabajar con parámetros de fecha
• Ejecución del informe en línea/fuera de línea (programación)
• Definición de propiedades de modelo de datos para evitar errores de memoria
• Ajuste de consultas SQL
• Validación de modelos de datos

Información sobre la opción Timeout por defecto de Oracle

WebLogic Server
WebLogic Server tiene un timeout por defecto de 600 segundos para cada thread de
solicitud.
Cuando el tiempo sea más de 600 segundos, Oracle WebLogic Server marca el thread como
Parado. Cuando el número de threads parados llegue a los 25, el servidor se cierra.
Para evitar este problema, verifique que el tiempo de ejecución de SQL no exceda la
configuración de WebLogic Server.

Mejores prácticas para juegos de datos de SQL

Tenga en cuenta los siguientes consejos que le facilitarán la creación de juegos de datos
SQL más eficientes:
• Solo devuelva los datos que necesite
• Uso de alias de columnas para acortar la longitud del archivo XML
• Evite usar filtros de grupo mediante la mejora de la consulta
• Cómo evitar llamadas PL/SQL en cláusulas WHERE
• Evite usar la tabla dual del sistema
• Cómo evitar llamadas PL/SQL en el nivel de elemento
• Cómo evitar incluir varios juegos de datos
• Evitar juegos de datos anidados

16-1
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

• Evite las consultas en línea como columnas de resumen

• Cómo evitar valores de enlace de parámetros excesivos
• Consejos sobre los parámetros de varios valores
• Agrupación de divisiones y ordenación de datos

Solo devuelva los datos que necesite

Asegúrese de que la consulta devuelve solo los datos que necesita para los informes.
La devolución de un exceso de datos es un riesgo de que se produzcan excepciones
OutOfMemory.
Por ejemplo, no debe devolver simplemente todas las columnas como en:

SELECT * FROM EMPLOYEES;

Evite siempre el uso de *.

Las dos mejores prácticas para restringir los datos devueltos son las siguientes:
• Seleccione siempre solo las columnas que necesite
Por ejemplo:
SELECT DEPARTMENT_ID, DEPARTMENT_NAME FROM EMPLOYEES;
• Utilice una cláusula WHERE y parámetros de enlace siempre que sea posible
para restringir los datos devueltos con más precisión.
En este ejemplo solo se seleccionan las columnas necesarias y solo aquellas que
coinciden con el valor del parámetro:

SELECT DEPARTMENT_ID, DEPARTMENT_NAME

FROM EMPLOYEES
WHERE DEPARTMENT_ID IN (:P_DEPT_ID)

Uso de alias de columnas para acortar la longitud del archivo XML

Cuanto más corto sea el nombre de la columna, más pequeño será el archivo XML
resultante; cuanto menor sea el archivo XML, de forma más rápida lo analiza el
sistema.
Acorte los nombres de columna con alias para acortar el tiempo de procesamiento de
la E/S y mejorar la eficacia de los informes.
En este ejemplo, DEPARTMENT_ID se acorta a "id" y DEPARTMENT_NAME se acorta a
"name":

SELECT DEPARTMENT_ID id, DEPARTMENT_NAME nameFROM EMPLOYEES

WHERE DEPARTMENT_ID IN (:P_DEPT_ID)

16-2
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

Evite usar filtros de grupo mediante la mejora de la consulta

Si bien la función Filtro de grupo de Data Modelo le permite eliminar los registros que haya
recuperado su consulta. Este proceso tiene lugar en el nivel medio, que es mucho menos
eficaz que el nivel de la base de datos.

Es mejor eliminar los registros innecesarios mediante su consulta usando en su lugar las
condiciones de la cláusula WHERE.

Cómo evitar llamadas PL/SQL en cláusulas WHERE

Las llamadas a la función PL/SQL en la cláusula WHERE de la consulta pueden provocar
varias ejecuciones.
Estas llamadas a funciones se ejecutan para cada fila encontrada en la base de datos
coincidente. Es más, en esta construcción es necesario que PL/SQL cambie de contexto con
SQL, lo que no es eficiente.
Como mejor práctica, evite las llamadas PL/SQL en la cláusula WHERE; en su lugar, una las
tablas base y agregue filtros.

Evite usar la tabla dual del sistema

Usar la tabla DUAL del sistema para devolver las constantes sysdate o de otro tipo no es un
método eficaz. Debe evitar el uso de la tabla DUAL del sistema cuando no sea necesario.
Por ejemplo, en lugar de:

SELECT DEPARTMENT_ID ID, (SELECT SYSDATE FROM DUAL) TODAYS_DATE FROM

DEPARTMENTS WHERE DEPARTMENT_ID IN (:P_DEPT_ID)

Debe:

SELECT DEPARTMENT_ID ID, SYSDATE TODAYS_DATE FROM DEPARTMENTS WHERE

DEPARTMENT_ID IN (:P_DEPT_ID)

En el primer ejemplo, no se necesita DUAL. Puede acceder a SYSDATE directamente.

Cómo evitar llamadas PL/SQL en el nivel de elemento

Las llamadas a las funciones del paquete a nivel de elemento, grupo o fila no están
permitidas. Puede incluir llamadas a funciones de paquete a nivel de elemento global porque
estas funciones solo se ejecutan una vez por solicitud de ejecución modelo de datos.
Ejemplo:

<dataStructure>
<group name="G_order_short_text" dataType="xsd:string"
source="Q_ORDER_ATTACH">
<element name="order_attach_desc" dataType="xsd:string"
value="ORDER_ATTACH_DESC"/>

16-3
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

<element name="order_attach_pk" dataType="xsd:string"

value="ORDER_ATTACH_PK"/>

El siguiente elemento es incorrecto:

<element name="ORDER_TOTAL _FORMAT" dataType="xsd:string" value="

WSH_WSHRDPIK_XMLP_PKG.ORDER_TOTAL _FORMAT "/>
<!-- This is wrong should not be called within group.-->
</group>

<element name="S_BATCH_COUNT" function="sum" dataType="xsd:double"

value="G_mo_number.pick_slip_number"/>
</dataStructure>

Cómo evitar incluir varios juegos de datos

Puede resultar deseable crear un modelo de datos con varios juegos de datos para
ofrecer varios informes, pero esta práctica hace que se reduzca mucho el rendimiento.
Cuando se ejecuta un informe, el procesador de datos ejecuta todos los juegos de
datos con independencia de si los datos se usan en la salida final.
Para obtener un mejor rendimiento del informe y mayor eficiencia de la memoria,
piénselo bien antes de usar un solo modelo de datos para utilizar varios informes.

Evitar juegos de datos anidados

El modelo de datos proporciona un mecanismo para crear una jerarquía principal-
secundario mediante el enlace de elementos de un juego de datos a otro.
En tiempo de ejecución, el procesador de datos ejecuta la consulta principal y para
cada fila del principal ejecuta la consulta secundaria. Cuando un modelo de datos
tiene muchas relaciones principal-secundario anidadas, puede dar lugar a un
procesamiento lento.
Un mejor enfoque para evitar juegos de datos anidados es combinar varias consultas
de juego de datos en una única consulta mediante una cláusula WITH.
A continuación, se ofrecen algunos consejos generales sobre cuándo combinar varios
juegos de datos en un juego de datos:
• Cuando el principal y el secundario tienen una relación de 1 a 1 (es decir, cada fila
principal tiene exactamente una fila secundaria), fusione los juegos de datos
principal y secundario en una única consulta.
• Cuando la consulta principal tiene muchas más filas en comparación con la
consulta secundaria. Por ejemplo, una tabla de distribución de facturas enlazada a
una tabla de facturas en la que la tabla de distribución tiene millones de filas en
comparación con la tabla de facturas. Aunque la ejecución de cada consulta
secundaria tarda menos de un segundo, la ejecución de la consulta secundaria de
cada distribución puede causar threads STUCK.

16-4
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

Ejemplo de cuándo se debe utilizar una cláusula WITH:

Query Q1:
SELECT DEPARTMENT_ID EDID,EMPLOYEE_ID EID,FIRST_NAME FNAME,LAST_NAME
LNAME,SALARY SAL,COMMISSION_PCT COMMFROM EMPLOYEES

Query Q2:
SELECT DEPARTMENT_ID DID,DEPARTMENT_NAME DNAME,LOCATION_ID LOCFROM
DEPARTMENTS

Combine las tres consultas en una utilizando la cláusula WITH de la siguiente manera:

WITH Q1 as (SELECT DEPARTMENT_ID DID,DEPARTMENT_NAME DNAME,LOCATION_ID LOC

FROM DEPARTMENTS),
Q2 as (SELECT DEPARTMENT_ID EDID,EMPLOYEE_ID EID,FIRST_NAME FNAME,LAST_NAME
LNAME,SALARY SAL,COMMISSION_PCT COMM
FROM EMPLOYEES)
SELECT Q1.*, Q2.*
FROM Q1 LEFT JOIN Q2
ON Q1.DID=Q2.EDID

Evite las consultas en línea como columnas de resumen

Las consultas en línea se ejecutan para cada columna y fila. Por ejemplo, si una consulta
principal tiene 100 columnas y ofrece 1000 filas, cada consulta de columna se ejecuta 1000
veces.
Evite el siguiente uso de consultas en línea. Si esta consulta solo devuelve unas pocas filas,
este proceso puede funcionar bien. Sin embargo, si la consulta devuelve 10000 filas, cada
subconsulta o consulta en línea se ejecuta 10000 veces, lo que puede provocar que los
threads se paren.

SELECT
NATIONAL_IDENTIFIERS,NATIONAL_IDENTIFIER,
PERSON_NUMBER,
PERSON_ID,
STATE_CODE
FROM
(select pprd.person_id,(select REPLACE(national_identifier_number,'-') from
per_
national_identifiers pni where pni.person_id = pprd.person_id and rownum<2)
national_identifiers,(select national_identifier_number from per_national
identifiers pni where pni.person_id = pprd.person_id and rownum<2) national_
identifier,(select person_number from per_all_people_f ppf
where ppf.person_id = pprd.person_id
and :p_effective_start_date between ppf.effective_start_date and
ppf.effective_
end_date) PERSON_NUMBER
(Select hg.geography_code from hz_geographies hg
where hg.GEOGRAPHY_NAME = paddr.region_2
and hg.geography_type = 'STATE') state_code

16-5
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

Cómo evitar valores de enlace de parámetros excesivos

Oracle Database le permite enlazar un máximo de 1000 valores por parámetro.
Enlazar un gran número de valores de parámetros no es eficiente. Evite enlazar más
de 100 valores a un parámetro.
Cuando cree un parámetro de tipo Menú y su lista de valores contenga varios valores,
asegúrese de que activa tanto la opción Selección múltiple como Puede seleccionar
todo y, a continuación, también seleccione el valor NULO transferido para garantizar
que no se transfieran varios valores.

Consejos sobre los parámetros de varios valores

Los consumidores de informes a menudo deben ejecutar informes que soportan
determinadas condiciones.
• Si no se selecciona ningún parámetro (nulo), se devuelve todo.
• Permitir la selección de varios valores de parámetro
En estos casos, el uso de NVL() no funciona; por lo tanto, debe utilizar
• COALESCE() para consultas de Oracle Database
• CASE / WHEN para consultas (lógicas) de Oracle BI EE
Ejemplo:

SELECT EMPLOYEE_ID ID, FIRST_NAME FNAME, LAST_NAME LNAME FROM EMPLOYEES

WHERE DEPARTMENT_ID = NVL(:P_DEPT_ID, DEPARTMENT_ID

La sintaxis de consulta anterior solo es correcta si el valor de P_DEPT_ID es un solo

valor o es nulo. La sintaxis no funciona si se transfiere más de un solo valor.
Para soportar varios valores, utilice la siguiente sintaxis:

16-6
 Capítulo 16
Mejores prácticas para juegos de datos de SQL

Para Oracle Database:

SELECT EMPLOYEE_ID ID, FIRST_NAME FNAME, LAST_NAME LNAME FROM EMPLOYEES

WHERE (DEPARTMENT_ID IN (:P_DEPT_ID) OR COALESCE (:P_DEPT_ID, null) is NULL)

Para el origen de datos de Oracle BI EE:

(CASE WHEN ('null') in (:P_YEAR) THEN 1 END =1 OR "Time"."Per Name Year" in

(:P_YEAR))

Para Oracle BI EE, el tipo de dato del parámetro debe ser una cadena. Los tipos de dato de
número y fecha no están soportados.

Agrupación de divisiones y ordenación de datos

El modelo de datos proporciona una función para crear divisiones de grupo y ordenar datos.
La ordenación solo está soportada para las columnas de división de grupo principales. Por
ejemplo, si un juego de datos de empleados se agrupa por departamento y gestor, puede
ordenar los datos XML por departamento. Si sabe cómo deben ordenarse los datos en el
informe o la plantilla final, especifique la ordenación en tiempo de generación de datos para
optimizar la generación de documentos. El orden de columna especificado en la cláusula
SELECT debe coincidir exactamente con los órdenes de elemento de la estructura de datos.
De lo contrario, puede que la división de grupo y la ordenación no funcionen. Debido a su
complejidad, no está permitido realizar varias agrupaciones con varias ordenaciones en
diferentes niveles de grupo.
Ejemplo: en el ejemplo que se muestra a continuación, la ordenación y la división de grupo
solo se aplican al grupo principal; es decir, G_1. Observe el orden de columna en la consulta,
el cuadro de diálogo del juego de datos y la estructura de datos. El orden de columna SQL
debe coincidir exactamente con el orden de campo del elemento de estructura de datos; de
lo contrario, se puede producir la corrupción de los datos.
Ejemplo:

SELECT d.DEPARTMENT_ID DEPT_ID, d.DEPARTMENT_NAME DNAME,

E.FIRST_NAME FNAME,E.LAST_NAME LNAME,E.JOB_ID JOB,E.MANAGER_ID
FROM EMPLOYEES E,DEPARTMENTS D
WHERE D.DEPARTMENT_ID = E.DEPARTMENT_ID
ORDER BY d.DEPARTMENT_ID, d.DEPARTMENT_NAME

Una vez que ha definido la consulta, puede utilizar el diseñador del modelo de datos para
seleccionar elementos de datos y crear divisiones de grupo como se muestra a continuación.

16-7
 Capítulo 16
Límite de las listas de valores

La estructura de datos con divisiones es la siguiente:

<output rootName="DATA_DS" uniqueRowName="false">

<nodeList name="data-structure"> <dataStructure tagName="DATA_DS">
<group name="G_1" label="G_1" source="q1">
<element name="DEPT_ID" value="DEPT_ID" label="DEPT_ID"
fieldOrder="1"/>
<element name="DNAME" value="DNAME" label="DNAME" fieldOrder="2"/>
<group name="G_2" label="G_2" source="q1">
<element name="FNAME" value="FNAME" label="FNAME"
fieldOrder="3"/>
<element name="LNAME" value="LNAME" label="LNAME"
fieldOrder="4"/>
<element name="JOB" value="JOB" label="JOB" fieldOrder="5"/>
<element name="MANAGER_ID" value="MANAGER_ID" label="MANAGER_ID"
fieldOrder="6"/>
</group>
</group>
</dataStructure>
</nodeList>
</output>

Límite de las listas de valores

Las listas de valores basadas en consultas SQL deben tener un límite de 1000 filas.
Si se agregan consultas de enlace sin control en una lista de valores, se pueden
producir excepciones OutOfMemory. Tenga en cuenta que el número de filas que
devuelve una lista de valores se almacena en memoria, por lo que cuanto mayor sea
el número de filas, más memoria se usará.

16-8
 Capítulo 16
Trabajar con parámetros de fecha

Trabajar con parámetros de fecha

Publisher siempre enlaza el parámetro de fecha o columna de fecha como objeto de registro
de hora.
Para evitar la conversión de registro de hora, defina el parámetro como cadena y transfiera
el valor con el formato 'DD-MM-AAAA' para que coincida con el formato de fecha del
RDBMS.

Ejecución del informe en línea/fuera de línea (programación)

La ejecución de informes en modo interactivo/en línea utiliza el procesamiento en memoria.
Utilice las siguientes directrices para decidir cuándo es adecuado un informe para la
ejecución en línea.
Para el modo en línea/interactivo:
• Cuando el tamaño de salida del informe es inferior a 50 MB
Los exploradores no ajustan la escala cuando cargan grandes volúmenes de datos. La
carga de más de 50 MB en el explorador ralentizará o posiblemente bloqueará la sesión.
• El timeout de consulta SQL del modelo de datos es inferior a 500 segundos
Todas las ejecuciones de consultas SQL que tardan más de 500 segundos producen
threads de parada de WebLogic Server. Para evitar esta condición, programe consultas
de larga duración. El proceso del programador utiliza sus propios threads de JVM en
lugar de los threads de servidor de Weblogic. Es más eficiente programar informes que
ejecutar informes en línea.
• El número total de elementos de la estructura de datos es inferior a 500
Cuando la estructura de datos del modelo de datos contiene muchos elementos de
datos, el procesador de datos debe conservar los valores de elemento en la memoria, lo
cual puede causar excepciones OutOfMemory. Para evitar esta condición, programe
estos informes. Para los informes programados, el procesador de datos utiliza el sistema
de archivos temporales para almacenar y procesar datos.
• Ninguna columna CLOB o BLOB
El procesamiento en línea guarda las columnas CLOB o BLOB completas en la memoria.
Debe programar informes que incluyan columnas CLOB o BLOB.

Definición de propiedades de modelo de datos para evitar

errores de memoria
Puede usar las propiedades del modelo de datos para ayudar a evitar los errores de
memoria en el sistema.
Puede definir las propiedades Timeout de consulta, Activar eliminación de SQL y Omitir
consulta de juegos de datos no utilizados en el nivel del modelo de datos.
Solo un administrador puede definir las propiedades de tiempo de ejecución Activar modo
escalable de modelo de datos y Tamaño de recuperación de base de datos para todos
los modelos de datos.

16-9
 Capítulo 16
Definición de propiedades de modelo de datos para evitar errores de memoria

Timeout de consulta
La propiedad Timeout de consulta especifica el límite de tiempo en segundos dentro
del cual la base de datos debe ejecutar sentencias SQL para informes programados.
El valor por defecto del timeout de consulta SQL para informes programados es de
600 segundos. Especifique el límite de tiempo en el modelo de datos. Mediante el
aumento del número de segundos, se arriesga a obtener threads de parada en Oracle
WebLogic Server. No aumente el valor a menos que ya se hayan utilizado otras
optimizaciones y alternativas.
Las consultas que no pueden ejecutarse en menos de 600 no están bien optimizadas.
Pida al DBA o al experto en rendimiento que analice y ajuste la consulta. Aumente el
número de segundos solo después de intentar las optimizaciones de la consulta.

Activar eliminación de SQL

La propiedad de depuración de SQL especifica si se deben recuperar solo las
columnas que se utilizan en el diseño/la plantilla del informe.
Defina la propiedad Activar depuración de SQL en Activado en la página
Propiedades del modelo de datos para mejorar el rendimiento permitiendo al sistema
recuperar solo las columnas utilizadas en el diseño o la plantilla del informe. El
sistema no recuperará las columnas que están definidas en la consulta pero que no
se han utilizado en el informe. Esta propiedad no modifica la cláusula WHERE; en
lugar de ello, encapsula la consulta SQL completa con las columnas especificadas en
el diseño.
Si ha activado la depuración SQL, puede utilizar la propiedad Omitir consulta de
juegos de datos no utilizados para omitir la ejecución de juegos de datos no
utilizados en un diseño.

Tamaño de recuperación de base de datos

La propiedad de tiempo de ejecución Tamaño de recuperación de base de datos
especifica el número de filas de datos que se recuperan de la base de datos a la vez.
Un administrador puede configurar la propiedad de tiempo de ejecución Tamaño de
recuperación de base de datos para todos los modelos de datos. Un número
elevado reduce el número de llamadas a la base de datos, pero consume más
memoria para el almacenamiento de más filas de datos. Defina la propiedad Activar
modo automático de tamaño de recuperación de base de datos en true para
permitir al sistema calcular el tamaño de recuperación óptimo en tiempo de ejecución.

Modo escalable
En la propiedad de modo escalable del modelo de datos se especifica si se va a usar
el sistema de archivos temporales para generar datos.
El administrador puede definir la propiedad de tiempo de ejecución Activar modo
escalable de modelo de datos para todos los modelos de datos.
Si selecciona Activar modo escalable de modelo de datos, Publisher utiliza el
sistema de archivos temporal para generar datos, mientras que el procesador de
datos utiliza la mínima memoria disponible.

16-10
 Capítulo 16
Ajuste de consultas SQL

Ajuste de consultas SQL

El ajuste de las consultas es el paso más importante para mejorar el rendimiento de
cualquier informe.
La explicación del plan, la supervisión SQL y la instalación de rastreo SQL con TKPROF son
las herramientas de diagnóstico de rendimiento más básicas que pueden ayudar a ajustar
las sentencias SQL en aplicaciones que se ejecuten en Oracle Database.
Publisher proporciona un mecanismo para generar los informes de explicación del plan y
supervisión SQL, y para activar el rastreo de sesión SQL. Esta funcionalidad solo es
aplicable en sentencias SQL que se ejecutan en Oracle Database. Las consultas lógicas de
cualquier otro tipo de base de datos no están soportadas.

Generación de la explicación del plan

Puede generar una explicación del plan en el nivel del juego de datos para una sola consulta
o a nivel de informe para todas las consultas de un informe.
Para obtener más información sobre cómo interpretar la explicación del plan, consulte Oracle
Database SQL Tuning Guide.

Explicación del plan para una sola consulta

En el cuadro de diálogo Editar del juego de datos SQL puede generar una explicación del
plan antes de ejecutar realmente la consulta. De esta forma se consigue la mejor estimación
posible de un plan. La consulta se ejecutará al enlazarse con valores nulos.

Haga clic en Generar explicación del plan en el cuadro de diálogo Editar consulta SQL.
Abra el documento generado en un editor de texto como, por ejemplo, Bloc de notas o
Wordpad.

Explicación del plan para informes

Para generar una explicación del plan para un informe, ejecute un informe a través de
Scheduler.
1. En el menú Nuevo, seleccione Trabajo de informe.
2. Seleccione el informe que se va a programar y, a continuación, haga clic en el separador
Diagnóstico.
Debe tener privilegios de administrador de BI o de desarrollador de modelos de datos de
BI para acceder al separador Diagnóstico.
3. Seleccione Activar plan de explicación SQL y Activar diagnóstico de motor de datos.
• Activar plan de explicación SQL: genera un log de diagnóstico con información del
informe de supervisión de plan de explicación/SQL.
• Activar diagnóstico de motor de datos: genera un log de procesador de datos.
• Activar diagnóstico de procesador de informes: genera FO (opciones de formato) e
información de log relacionada con el servidor.

16-11
 Capítulo 16
Ajuste de consultas SQL

• Activar diagnóstico de trabajo consolidado: genera el log completo, que

incluye detalles del log del programador, del log del procesador de datos y del
log de FO y del servidor.
4. Ejecute el informe.
5. En la página inicial, en Examinar/gestionar, seleccione Historial de trabajos de
informe.
6. Seleccione el informe para ver los detalles. En Salida y entrega, haga clic en Log
de diagnóstico para descargar la salida de la explicación del plan.

Ejemplo de explicación del plan:

Directrices para ajustar las consultas

Ajuste las consultas siguiendo un juego de directrices.
• Analice la explicación del plan e identifique sentencias SQL de alto impacto.
• Agregue las condiciones de filtro necesarias y elimine las uniones no deseadas.
• Evite y elimine las exploraciones de tabla completa (FTS) en tablas grandes.
Tenga en cuenta que, en algunos casos, las exploraciones de tabla completa en
tablas pequeñas son más rápidas y mejoran la recuperación de consultas.
Asegúrese de utilizar la recuperación para las tablas pequeñas.
• Utilice las indicaciones SQL para forzar el uso de los índices adecuados.
• Evite las subconsultas complejas y utilice tablas temporales globales cuando sea
necesario.
• Utilice las funciones de análisis de Oracle SQL para varias agregaciones.
• Evite usar demasiadas subconsultas en las cláusulas where, si es posible. En su
lugar, reescriba las consultas con uniones externas.

16-12
 Capítulo 16
Validación de modelos de datos

• Evite las funciones de grupo, como las condiciones HAVING e IN / NOT IN de cláusula
where.
• Utilice sentencias CASE y funciones DECODE para funciones de agregado complejas.

Consejos para ajustar la base de datos

Siga las mejores prácticas al realizar el ajuste de una base de datos.
• Trabaje con el administrador de la base de datos para recopilar estadísticas en las
tablas.
• Si el servidor es muy lento, analice las incidencias de red, E/S o disco y optimice los
parámetros del servidor.
• En algunos escenarios, cuando no se puede evitar una recuperación de datos de gran
tamaño, es posible que se produzcan errores de tamaño de montón de PGA en la base
de datos. Para resolver estas incidencias, aumente el tamaño de montón de PGA como
último recurso. Utilice la siguiente sentencia para aumentar el tamaño de montón:
alter session set events '10261 trace name context forever, level 2097152'

Validación de modelos de datos

Si valida modelos de datos, los mensajes de validación le ayudan a corregir modelos de
datos, optimizar consultas, reducir threads de parada y mejorar el rendimiento de la creación
de informes.
Una vez creado o editado un modelo de datos que se ha creado en la versión actual o en
una versión anterior, si hace clic en Validar, Publisher:
1. Comprueba las consultas utilizadas para los juegos de datos, las listas de valores y las
definiciones de repartición.
2. Genera el plan de ejecución para las consultas SQL.
3. Muestra una lista de mensajes de error y advertencia.
Realice la acción necesaria según el mensaje de validación. Consulte Resultados de
validación del modelo de datos.
Tenga en cuenta que si ha cambiado de versión de Publisher desde una versión anterior, los
modelos de datos existentes se marcan como no validados.

Resultados de validación del modelo de datos

En este tema se muestran los mensajes de validación del modelo de datos para referencia.

Tipos de mensaje
• Error: debe resolver los errores del modelo de datos si desea utilizarlo para ejecutar un
informe.
• Advertencia: realice la corrección sugerida en el mensaje de advertencia. El rendimiento
del informe puede verse afectado si selecciona que se ejecute el informe ignorando la
advertencia.

16-13
 Capítulo 16
Validación de modelos de datos

Referencia de mensaje

Tipo de Tipo de mensaje Mensaje Límite

validación
Consulta Advertencia La consulta SQL contiene SELECT *. El uso
de '*' está restringido. Seleccione las
columnas específicas.
Consulta Advertencia El modelo de datos contiene consultas JDBC
de BI anidadas. El enlace de consultas
lógicas está restringido. Utilice OTBI en
lugar de los informes de Publisher o
elimine el enlace entre los juegos de datos
de OBIEE.
Consulta Advertencia El plan de ejecución de consulta SQL
contiene uniones cartesianas fusionadas.
Genere el plan de explicación para la
consulta SQL e identifique las uniones
cartesianas fusionadas. Agregue los filtros
que sean necesarios a la consulta SQL.
Tiempo de Advertencia Un número de valores de enlace por 100
ejecución parámetro superior al límite de {0}
produce un bajo rendimiento. Reduzca el
número de valores de enlace.
Consulta Advertencia El número de columnas en SELECT excede 30
el límite de {0}. Seleccione solo las
columnas necesarias y active la
depuración.
Consulte Publisher Best Practices for SaaS
Environments (identificador de documento
2145444.1).
Consulta Advertencia El número de columnas en SELECT excede 100
el límite de {0}. Seleccione solo las
columnas necesarias.
Consulta Advertencia La consulta SQL contiene uniones no
uniformes. La generación de filas
intermedias puede causar problemas de
rendimiento. Reemplace las uniones no
uniformes por una unión uniforme o una
unión externa.
Consulta Advertencia La longitud del nombre de columna 15
seleccionado excede el límite de {0}. La
longitud del nombre de columna no debe
ser superior a 15 caracteres. Utilice un alias
corto para los nombres de columna.
Consulta Advertencia El número de consultas o subconsultas en 10
línea excede el límite de {0}. Elimine las
consultas en línea adicionales elegidas.
Consulta Advertencia La consulta SQL contiene la cláusula FROM
DUAL. La consulta SQL contiene
demasiadas tablas DUAL. Evite el uso de la
cláusula FROM DUAL.

16-14
 Capítulo 16
Validación de modelos de datos

Tipo de Tipo de mensaje Mensaje Límite

validación
Consulta Advertencia El número de columnas LOB en SELECT 2
excede el límite de {0}. Seleccione solo las
columnas necesarias.
Consulta Error La consulta contiene palabras clave DDL o
DML. Elimine las palabras clave DDL o
DML de la consulta SQL.
Estructura Advertencia El número de divisiones de grupo en un 2
único juego de datos excede el límite de {0}.
Elimine varios grupos del juego de datos.
Estructura Advertencia El modelo de datos contiene filtros de
grupo. Reemplace los filtros de grupo por la
cláusula WHERE en la consulta SQL.
Tiempo de Error La propiedad del modelo de datos no es
ejecución válida o contiene valores no válidos.
Especifique la propiedad de modelo de
datos correcta y compruebe el valor de la
propiedad.
Consulta Advertencia El plan de ejecución de consulta SQL
contiene exploraciones de tabla completa.
Proporcione los filtros necesarios en las
columnas indexadas de la consulta SQL.
Consulta Advertencia El plan de ejecución de consulta SQL
contiene un alto número de lecturas de
buffer. Las lecturas de buffer exceden el
límite de 1 GB. Agregue filtros en la
consulta SQL para reducir el volumen de
recuperación de datos.
Consulta Advertencia El plan de ejecución de consulta SQL
contiene un alto número de ciclos de CPU.
Agregue filtros necesarios en la consulta
SQL para reducir el volumen de
recuperación de datos.
Consulta Advertencia El plan de ejecución de consulta SQL
contiene llamadas de función en las
columnas de filtro. Utilice las llamadas de
función SQL en los resultados de las
columnas de índice con bajo rendimiento.
Elimine las llamadas de función en las
columnas de filtro.
Consulta Advertencia Llamadas de función detectadas en
predicados de la cláusula WHERE.
Consulta Advertencia Llamadas detectadas a funciones PL/SQL
en la lista SELECT; estas llamadas pueden
afectar significativamente al rendimiento.
Consulta Advertencia Las subconsultas escalares son
subconsultas de la lista SELECT. Deben
devolver exactamente un valor. El uso de
ROWNUM o de DISTINCT para restringir la
salida indica un problema de rendimiento
potencial.

16-15
 Capítulo 16
Validación de modelos de datos

Tipo de Tipo de mensaje Mensaje Límite

validación
Consulta Advertencia Demasiados valores en el filtro IN-LIST
podrían impedir que el optimizador
encuentre un plan más eficiente.
Tiempo de Advertencia Un predicado de seguridad está
ejecución encapsulado en una subconsulta, causando
una anidación innecesaria. BI Server ha
generado demasiadas uniones entre las
subconsultas WITH usando la función
SYS_OP_MAP_NONNULL no soportada.
Consulta Advertencia BI Server ha generado demasiadas uniones
entre las subconsultas WITH usando la
función SYS_OP_MAP_NONNULL no
soportada.
Consulta Advertencia Una tabla o una vista en línea detectada
estaba unida externamente mediante
OUTER en el lado opcional de la unión y no
tiene ningún dato seleccionado en ella.
Consulta Advertencia Las subconsultas escalares son
subconsultas de la lista SELECT. La
inclusión de una cláusula WITH en una
subconsulta escalar puede crear graves
problemas de rendimiento.
Consulta Advertencia Las tablas que se muestran en una consulta
y están unidas a otras tablas pero que
nunca se han utilizado en una cláusula
SELECT FROM pueden ser redundantes.
Compruebe si esta tabla está unida en la
columna de clave primaria a las columnas
de clave ajena de otras tablas.
Consulta Advertencia La columna se define como una
subconsulta escalar correlacionada y se
utiliza posteriormente en una expresión de
filtro o de unión. Esto puede provocar una
degradación grave del rendimiento.
Consulta Advertencia Predicados que utilizan variables de enlace
de no trivial. Por ejemplo, (:JCODE IS NULL
OR mcd.JCODE LIKE :JCODE).
Consulta Advertencia La expresión CASE contiene más de 10
expresiones WHEN ... THEN complejas.
Consulta Advertencia Se ha hecho referencia a columnas
definidas como constantes (literales) de un
objeto de vista en los predicados de unión
de una consulta.
Consulta Advertencia La sentencia SQL tiene más de 10
bifurcaciones de UNION en una
subconsulta.
Consulta Advertencia Elimine la referencia innecesaria a la tabla,
ya que se utiliza la misma columna en
SELECT, JOIN y FILTER.
Estructura Advertencia No almacene datos en CLOB y lo convierta
a XML. Almacénelos en XML para
optimizar el rendimiento.

16-16
Parte IV
Uso de modelos semánticos de Oracle BI
Enterprise Edition
En esta parte se describe cómo puede volver a utilizar modelos semánticos que haya creado
con Oracle BI Enterprise Edition en Oracle Analytics Cloud.

Capítulos:
• Carga de modelos semánticos desde Oracle BI Enterprise Edition
17
Carga de modelos semánticos desde Oracle
BI Enterprise Edition
Los administradores pueden cargar modelos semánticos creados con Oracle BI Enterprise
Edition en Oracle Analytics Cloud. Después de cargar un archivo .rpd de modelo semántico
en la nube, los autores de contenido pueden generar visualizaciones de datos, paneles de
control y análisis con normalidad.

Temas
• Acerca de la carga de modelos semánticos de Oracle BI Enterprise Edition en la nube
• Preparación del archivo de modelo semántico
• Carga de modelos semánticos desde un archivo .rpd mediante la consola
• Acerca de la edición de modelos semánticos cargados desde Oracle BI Enterprise
Edition
• Descarga e instalación de Oracle Analytics Client Tools
• Conexión a un modelo semántico en la nube
• Edición de un modelo semántico en la nube
• Carga de un modelo semántico en la nube
• Conexión a un origen de datos mediante una conexión a la consola
• Conexión a un origen de datos mediante una conexión de datos
• Solución de problemas con la herramienta de administración de modelos (Oracle
Analytics Client Tools)
• Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous
Data Warehouse

Nota:
Los administradores pueden utilizar instantáneas para migrar contenido, además
de modelos semánticos de Oracle BI Enterprise Edition. Consulte Migración de
Oracle Analytics Cloud utilizando instantáneas.

Acerca de la carga de modelos semánticos de Oracle BI

Enterprise Edition en la nube
Si ya ha modelado los datos de negocio con Oracle BI Enterprise Edition, no tiene que
empezar desde cero en Oracle Analytics Cloud. Pida a un administrador que cargue el
archivo de modelo semántico en Oracle Analytics Cloud, y empiece a explorar los datos a
través de visualizaciones, análisis y paneles de control.

17-1
 Capítulo 17
Preparación del archivo de modelo semántico

Oracle Analytics Cloud permite cargar un archivo .rpd de modelo semántico con:
• Uno o más modelos semánticos
• Conexiones a una o más bases de datos
Deberá validar el archivo .rpd de modelo semántico y configurar los detalles de
conexión a la base de datos en Oracle BI Enterprise Edition.
Cuando el administrador carga un archivo .rpd de modelo semántico desde Oracle BI
Enterprise Edition, los modelos semánticos existentes (si los hubiera) se suprimen y
se sustituyen por contenido del archivo cargado, y se desactiva Data Modeler. Los
modelos semánticos cargados del archivo están disponibles para los autores de
contenido a través del panel Área temáticas.
Si son necesarios cambios en el modelo, los administradores pueden usar la
herramienta de administración de modelos para editar y desplegar sus actualizaciones
en Oracle Analytics Cloud. Esta herramienta está disponible con Oracle Analytics
Client Tools. Consulte Descarga e instalación de Oracle Analytics Client Tools.

Nota:
Oracle publica una nueva versión de Oracle Analytics Client Tools con cada
actualización de Oracle Analytics Cloud. Después de que Oracle actualice
su entorno de Oracle Analytics Cloud, siempre debe descargar y comenzar a
usar la última versión de Oracle Analytics Client Tools.

Si desea copiar los informes y los paneles de control integrados en Oracle BI

Enterprise Edition en Oracle Analytics Cloud, también puede hacerlo. Consulte Carga
de contenido de un archivo de catálogo en Visualización de datos y creación de
informes en Oracle Analytics Cloud.

Preparación del archivo de modelo semántico

Tómese su tiempo para preparar el archivo .rpd de modelo semántico para la nube.
1. Verifique que está utilizando Oracle BI Enterprise Edition 11.1.1.7 o posterior.
2. Abra el archivo .rpd de modelo semántico y utilice el Gestor de comprobación de
consistencia para ejecutar comprobaciones de consistencia.
3. Elimine todos los bloques de inicialización que definen las variables de sesión
USER, ROLES o GROUP.
Oracle Analytics no soporta las variables :user y :password en las credenciales de
conexión de origen de datos.
4. Verifique que la información de conexión a la base de datos del modelo semántico
está actualizada.
Revise la configuración de pool de conexiones desde la herramienta de
administración de Oracle BI:
• El Nombre del origen de datos debe contener la cadena de conexión
completa de la base de datos en la que se almacenan los datos.
No puede especificar un nombre de servicio de red aquí.
• La interfaz de llamada debe ser Oracle Call Interface (OCI).

17-2
 Capítulo 17
Carga de modelos semánticos desde un archivo .rpd mediante la consola

Si el modelo semántico se conecta a varias bases de datos, asegúrese de que la

configuración de cada pool de conexiones es correcta.
5. Desactive las áreas temáticas que no desee exponer o que no tengan una conexión
activa.
Si falta la información de conexión, los usuarios verán el mensaje Error de
recuperación de las áreas temáticas si intentan consultar las áreas temáticas en
Oracle Analytics Cloud.
6. Realice una copia de seguridad de Oracle Analytics Cloud en una instantánea que
incluya el modelo semántico actual, por si necesita restaurar esta versión.
Cuando el modelo semántico esté listo, puede cargarlo en Oracle Analytics Cloud.

Carga de modelos semánticos desde un archivo .rpd mediante

la consola
Los administradores pueden cargar modelos semánticos creados con Oracle BI Enterprise
Edition en Oracle Analytics Cloud. Tras migrar los modelos semánticos a la nube, los autores
de contenido pueden visualizar los datos con normalidad.
Cuando se cargan modelos semánticos desde Oracle BI Enterprise Edition, se suprime
información del modelo semántico existente en Oracle Analytics Cloud y se sustituye por
contenido del archivo .rpd de modelo semántico. Los modelos semánticos que cargue están
disponibles para los autores de contenido como áreas temáticas.

Nota:
También puede cargar archivos .rpd de modelo semántico en Oracle Analytics
Cloud utilizando la herramienta de administración de modelos (Oracle Analytics
Client Tool).

1. Verifique el archivo .rpd de modelo semántico y las conexiones de base de datos

asociadas.
2. En Oracle Analytics Cloud, haga clic en Consola.
3. Seleccione Instantáneas.
4. Realice una instantánea del modelo semántico actual en caso de que necesite restaurar
esta versión.
5. En el menú de página, haga clic en Reemplazar modelo de datos.
6. Haga clic en Examinar y seleccione el archivo .rpd de modelo semántico que desea
cargar.
7. Introduzca la contraseña para el archivo.
8. Haga clic en Aceptar.
9. Vaya a la página inicial, haga clic en Datos y, a continuación, en Juegos de datos para
ver los modelos semánticos que ha cargado, disponibles como áreas temáticas.

17-3
 Capítulo 17
Acerca de la edición de modelos semánticos cargados desde Oracle BI Enterprise Edition

10. Opcional: Si el archivo .rpd de modelo semántico incluye permisos y filtros de

datos, puede crear roles de aplicación coincidentes en Oracle Analytics Cloud
para garantizar la seguridad de los datos en la nube.
a. Cree roles de aplicaciones con exactamente los mismos nombres que los
definidos en la herramienta de administración de Oracle BI.
b. Asigne usuarios (y roles de usuario) a los roles de aplicación según sea
necesario.

Acerca de la edición de modelos semánticos cargados

desde Oracle BI Enterprise Edition
Los administradores pueden utilizar la consola para cargar modelos semánticos de
Oracle BI Enterprise Edition en Oracle Analytics Cloud. Una vez que se carga el
modelo semántico, los desarrolladores de modelos semánticos pueden usar la
herramienta de administración de modelos para editar y desplegar sus actualizaciones
en Oracle Analytics Cloud. Los usuarios pueden empezar a explorar los datos con
ayuda de visualizaciones, análisis y paneles de control.

Requisitos
• Oracle BI Enterprise Edition 11.1.1.7 o posterior.
• Una máquina Windows de 64 bits en la que descargar Oracle Analytics Client
Tools y ejecutar la herramienta de administración de modelos. Consulte Descarga
e instalación de Oracle Analytics Client Tools.

Nota:
Oracle publica una nueva versión de Oracle Analytics Client Tools con
cada actualización de Oracle Analytics Cloud. Después de que Oracle
actualice su entorno de Oracle Analytics Cloud, siempre debe descargar
y comenzar a usar la última versión de Oracle Analytics Client Tools.

• Un archivo .rpd de modelo semántico validado.

• Credenciales de usuario válidas. Un usuario en el sistema de gestión de identidad
de Oracle Cloud asociado con Oracle Analytics Cloud que tenga permisos de
administrador en Oracle Analytics Cloud (es decir, un usuario con el rol de
aplicación BIServiceAdministrator).
Oracle Analytics Cloud utiliza uno de estos sistemas de gestión de identidad de
Oracle Cloud:
– Oracle Identity Cloud Service (IDCS): si Oracle Analytics Cloud se federa
con Oracle Identity Cloud Service, debe conectarse con las credenciales de
usuario de Oracle Identity Cloud Service.
– Dominios de identidad de Oracle Cloud Infrastructure Identity and
Access Management (IAM): si Oracle Analytics Cloud utiliza un dominio de
identidad de IAM para la gestión de identidad, debe conectarse con las
credenciales de usuario del dominio de identidad.
Si no está seguro, pregunte al administrador de servicio de nube. Consulte Acerca
de la configuración de usuarios y grupos.

17-4
 Capítulo 17
Descarga e instalación de Oracle Analytics Client Tools

Si Oracle Analytics Cloud usa un proveedor de identidad externo como Active Directory
para la conexión única e intenta conectarse con sus credenciales de usuario de conexión
única, verá el mensaje "Connection failed 401: Unauthorized" cuando intente
conectarse.
• Compruebe con el administrador de servicio de nube que el número de puerto requerido
está abierto (es decir, el puerto 443 para el acceso HTTPS a Oracle Analytics Cloud; si
no, el puerto 80 para el acceso HTTP).

Flujo de trabajo habitual para utilizar la herramienta de administración de modelos

para editar el modelo semántico
• Cargar el modelo semántico. Consulte Carga de modelos semánticos desde un
archivo .rpd mediante la consola.
• Editar el modelo semántico. Consulte Edición de un modelo semántico en la nube.
• Copie los análisis y los paneles de control integrados en Oracle BI Enterprise Edition en
Oracle Analytics Cloud. Consulte Carga de contenido de un archivo de catálogo en
Visualización de datos y creación de informes en Oracle Analytics Cloud.

Descarga e instalación de Oracle Analytics Client Tools

Descargue e instale Oracle Analytics Client Tools si desea editar el modelo semántico
(archivo .rpd) o activar las conexiones remotas desde los análisis y los paneles de control de
informes. Instale Oracle Analytics Client Tools en una máquina de Windows. El paquete de
software instala la herramienta de administración de modelos, el gestor de catálogos y el
gestor de trabajos.

Nota:
Oracle actualiza Oracle Analytics Client Tools con cada actualización de Oracle
Analytics Cloud. Asegúrese de que utiliza la versión más reciente de Oracle
Analytics Client Tools.

1. Navegue a:Página de descarga de Oracle Analytics Client Tools.

2. Haga clic en el enlace Actualización de <Mes de Año> de Oracle Analytics Client
Tools más reciente para acceder a la página Oracle Software Delivery Cloud.
3. Haga clic en la flecha hacia abajo Plataformas, luego en Microsoft Windows x64 (64
bits) y, por último, haga clic fuera de la lista desplegable o pulse Intro.
4. En la columna Software de la tabla, asegúrese de que Oracle Analytics Client...
está seleccionado y anule la selección de cualquier otro archivo ZIP (por ejemplo,
Windows Data Gateway...).
5. Acepte el acuerdo de licencia de Oracle Cloud Service.
6. Haga clic en Descargar para iniciar Oracle Download Manager y siga las instrucciones
en pantalla.
7. Cuando la descarga haya terminado, haga clic en Abrir destino.
8. Extraiga y ejecute el instalador de Oracle del archivo ZIP descargado.
Por ejemplo, extraiga y ejecute el archivo de instalador oac_client-<update ID>-
win64.exe y siga las instrucciones en pantalla.

17-5
 Capítulo 17
Conexión a un modelo semántico en la nube

Para iniciar las herramientas, vaya al menú Inicio de Windows, haga clic en
Oracle Analytics Client Tools y, a continuación, seleccione el nombre de la
herramienta que desee usar. Por ejemplo, si desea editar su modelo semántico,
haga clic en Herramienta de administración de modelos.

Conexión a un modelo semántico en la nube

Debe introducir los detalles de conexión para Oracle Analytics Cloud antes de abrir,
publicar o cargar un modelo semántico en Oracle Analytics Cloud mediante la
herramienta de administración de modelos.
1. Abra la herramienta de administración de modelos.
Vaya al menú Inicio de Windows, haga clic en Oracle Analytics Client Tools y
seleccione la herramienta de administración de modelos.
2. En la herramienta de administración de modelos, seleccione cómo desea
conectarse a Oracle Analytics Cloud.
Por ejemplo, haga clic en Archivo, luego en Cloud y, a continuación, en Abrir,
Publicar, o Cargar.
3. Introduzca la información de conexión de Oracle Analytics Cloud.
a. En Usuario, especifique un usuario en el sistema de gestión de identidad de
Oracle Cloud asociado con Oracle Analytics Cloud que tenga permisos de
administrador en Oracle Analytics Cloud (es decir, un usuario con el rol de
aplicación BIServiceAdministrator).
Si su Oracle Analytics Cloud se federa con un sistema de gestión de identidad
externo, probablemente se conecta a Oracle Analytics Cloud con sus
credenciales de conexión única. No puede usar sus credenciales de conexión
única para conectarse a Oracle Analytics Cloud desde la herramienta de
administración de modelos; debe usar las credenciales de usuario de gestión
de identidad de Oracle Cloud. Consulte Requisitos.
b. En Contraseña, introduzca la contraseña para el Usuario especificado.
c. En Nube, introduzca bootstrap.
d. En Nombre del host, introduzca la URL de Oracle Analytics Cloud,
excluyendo https:// y /ui/dv.
Por ejemplo, si la URL de Oracle Analytics Cloud es https://oac123456-
oacppacm12345.uscom-central-1.oraclecloud.com/ui/dv, introduzca
oac123456-oacppacm12345.uscom-central-1.oraclecloud.com.
Puede obtener la URL de Oracle Analytics Cloud desde la consola de Oracle
Cloud Infrastructure. Desplácese hasta la instancia de Oracle Analytics Cloud
y, a continuación, copie el valor en el campo URL. En productos anteriores de
Oracle Analytics Cloud, haga clic en Gestionar esta instancia y copie la
dirección del enlace para URL de Oracle Analytics Cloud.
e. En Número de puerto, introduzca 443.
f. Seleccione SSL.
En Almacén de confianza, haga clic en Examinar y seleccione el almacén
de claves de JDK por defecto enlazado con JRE:
<OAC client home>\oracle_common\jdk\jre\lib\security\cacerts

17-6
 Capítulo 17
Edición de un modelo semántico en la nube

En Contraseña, especifique la contraseña para el almacén de confianza (JSK) que

contiene el certificado de CA de confianza que ha utilizado para firmar el certificado
de Oracle Analytics Cloud. El certificado de Oracle Analytics Cloud lo firma una CA
conocida, por lo que puede utilizar el cacerts (el almacén de confianza de JKS por
defecto que confía en CA conocidas) de Java regular.
g. Si ha desplegado la herramienta de administración de modelos en una máquina
conectada a una red con proxy activado, seleccione Proxy.
Pregunte al administrador de red por la URL del servidor proxy y el número de
puerto.
Se estima que la conexión inicial tarda entre 3 y 15 minutos, dependiendo del tamaño del
modelo semántico.

Edición de un modelo semántico en la nube

Use la herramienta de administración de modelos para editar un modelo semántico que haya
cargado previamente en Oracle Analytics Cloud.
1. Abra la herramienta de administración de modelos.
Vaya al menú Inicio de Windows, haga clic en Oracle Analytics Client Tools y
seleccione la herramienta de administración de modelos.
2. En la herramienta de administración de modelos, haga clic en el menú Archivo,
seleccione Abrir y En la nube.
3. Introduzca la información de conexión de Oracle Analytics Cloud.
4. Actualice su modelo.
a. Realice cambios en el modelo, según sea necesario.
b. Para validar los cambios, haga clic en Herramientas, en Mostrar comprobador de
consistencia y, a continuación, en Comprobar todos los objetos.
c. Para guardar los cambios localmente, haga clic en Archivo y, a continuación, en
Guardar.
5. Para cargar los cambios en Oracle Analytics Cloud, haga clic en Archivo, en Nube y, a
continuación, en Publicar.
Utilice el menú secundario Archivo para refrescar o desechar los cambios:
• Refrescar: utilice esta opción para refrescar su modelo semántico con las últimas
actualizaciones. Si otro desarrollador ha modificado el modelo semántico, se le solicitará
que inicie una fusión.
• Desechar: utilice esta opción para cancelar los cambios implantados en el modelo
semántico en la sesión actual.

17-7
 Capítulo 17
Carga de un modelo semántico en la nube

Carga de un modelo semántico en la nube

Puede utilizar la herramienta de administración de modelos para cargar el archivo .rpd
de modelo semántico en Oracle Analytics Cloud.

Nota:
Los administradores también pueden usar la consola para archivos .rpd de
modelo semántico. Consulte Carga de modelos semánticos desde un
archivo .rpd mediante la consola.

1. En la herramienta de administración de modelos, abra su archivo .rpd de modelo

semántico.
2. En el menú Archivo, haga clic en Nube y, a continuación, en Cargar.
3. Introduzca la información de conexión de Oracle Analytics Cloud.

Utilice el menú secundario Archivo para refrescar o desechar los cambios:

• Refrescar: utilice esta opción para refrescar su modelo semántico con las últimas
actualizaciones. Si otro desarrollador ha modificado el modelo semántico, se le
solicitará que inicie una fusión.
• Desechar: utilice esta opción para cancelar los cambios implantados en el modelo
semántico en la sesión actual.

Conexión a un origen de datos mediante una conexión a la

consola
Los administradores pueden definir conexiones de base de datos para modelos
semánticos mediante la consola de Oracle Analytics Cloud. Esto incluye bases de
datos como Oracle Database Cloud Service, Oracle Autonomous Data Warehouse y
Oracle Autonomous Transaction Processing.
Si desea volver a utilizar las mismas conexiones de base de datos en la herramienta
de administración de modelos, no tiene que volver a introducir los detalles de la
conexión. Puede hacer referencia a las conexiones de la base de datos "por nombre"
en el cuadro diálogo Pool de conexiones.
Si aún no lo ha hecho, cree la conexión de base de datos en la consola y escriba su
nombre. Por ejemplo, MyCloudSalesDB.
1. En la herramienta de administración de modelos, vaya al panel Capa física y abra
el cuadro de diálogo Pool de conexiones.
2. En Nombre, introduzca un nombre para el origen de datos.
3. Seleccione la casilla de control Usar conexión de consola.
4. En Nombre de conexión, introduzca el nombre de la conexión de la base de
datos tal como se define en la consola (distinción entre mayúsculas y minúsculas).
Por ejemplo, MyCloudSalesDB.

17-8
 Capítulo 17
Conexión a un origen de datos mediante una conexión de datos

Nota:
Ignore el resto de opciones en este cuadro de diálogo, por ejemplo Nombre de
origen de datos, Nombre de usuario de conexión compartido and
Contraseña.

Conexión a un origen de datos mediante una conexión de datos

En Oracle Analytics Cloud, los usuarios con acceso Autor de contenido de DV pueden
configurar conexiones a una amplia gama de orígenes de datos y hacer que esas
conexiones de datos las puedan usar los modeladores de negocio cuando creen modelos
semánticos en la herramienta de administración de modelos al definir una opción de
conexión denominada Conexión al sistema.
Para obtener una lista de orígenes de datos con la opción Conexión al sistema, consulte
Orígenes de datos soportados.
Para usar una conexión de datos en la herramientas de administración de modelos,
simplemente introduzca su ID de objeto en el cuadro de diálogo Pool de conexiones. No
tiene que volver a introducir los detalles de la conexión.
1. En Oracle Analytics Cloud, obtenga el ID de objeto de la conexión que desea usar en la
herramienta de administración de modelos.
a. Si aún no lo ha hecho, cree una conexión al origen de datos y seleccione la casilla
de control Conexión al sistema.
Consulte Opciones de conexión a la base de datos.
b. En el menú Acciones de la conexión, haga clic en Inspeccionar.
c. Haga clic en Copiar para copiar el ID de objeto de la conexión.

2. En la herramienta de administración de modelos, vaya al panel Físico y abra el cuadro

de diálogo Pool de conexiones.

17-9
 Capítulo 17
Conexión de un modelo semántico a un origen de datos de Spark

3. En Nombre, introduzca un nombre para el origen de datos.

4. Seleccione la casilla de control Usar conexión de datos.
5. Introduzca el ID de objeto de la conexión de datos que desea usar.
Los ID de objeto usan el formato: 'owner'.'connection name'
Por ejemplo: 'oac.user@example.com'.'myoracledatabase'

Nota:
Ignore el resto de opciones en este cuadro de diálogo, por ejemplo
Nombre de origen de datos, Nombre de usuario de conexión
compartido and Contraseña.

Conexión de un modelo semántico a un origen de datos de

Spark
Si desea conectar el modelo semántico a un origen de datos de Spark, debe
especificar los detalles de las conexiones de Spark en el archivo .rpd.
1. En la herramienta de administración de modelos, abra el archivo .rpd, vaya al
panel Físico, haga clic con el botón derecho y seleccione Nueva base de datos.
2. Introduzca un nombre para la conexión de la base de datos y establezca Tipo de
base de datos en ODBC avanzado.
3. Haga clic en Pool de conexiones y agregue un pool de conexiones.

17-10
 Capítulo 17
Trabajo con la herramienta de administración de modelos

4. Introduzca un nombre para el pool de conexiones y establezca Interfaz de llamadas en

ODBC 3.5.
5. En el campo Nombre de origen de datos (DSN), haga lo siguiente:
Sustituya los valores HOST y PORT por la dirección IP del valor del host y puerto de Hive
Thrift:
DRIVER=Oracle 8.0 Apache Hive Wire
Protocol;HOST=<hive_host_ip_address>;PORT=<binaryprotocol port for hive>
6. Agregue los detalles de autenticación y guarde el pool de conexiones.
7. Importe el objeto de capa física y complete el modelo semántico antes de cargar el
archivo .rpd en Oracle Analytics.

Trabajo con la herramienta de administración de modelos

Utilice estas opciones para gestionar y publicar un modelo semántico utilizando la
herramienta de administración de modelos.
Cuando se conecte a Oracle Analytics Cloud en la herramienta de administración de
modelos, debe introducir las credenciales de un usuario del sistema Oracle Cloud Identity
Management asociado con Oracle Analytics Cloud. No podrá conectarse como usuario de
conexión única desde un sistema externo de gestión de identidad federado. Consulte
Requisitos.

Opción de menú Úsela para:

Archivo, después Nube, después
Abrir
Archivo, después Nube, después
Publicar
Abra un modelo semántico que haya cargado en Oracle
Analytics Cloud para poder editarlo.
Publique los cambios que haya realizado en el modelo de
datos. Los usuarios verán los cambios la próxima vez que
inicie sesión en Oracle Analytics Cloud.

Creación de un modelo semántico a partir de vistas analíticas

en Oracle Autonomous Data Warehouse
En Oracle Analytics, puede modelar las vistas analíticas de Autonomous Data Warehouse en
Oracle Analytics y visualizar los datos.

Temas:
• Visión general de la conexión a las vistas analíticas
• Creación y carga de un modelo semántico basado en una vista analítica
• Conexión a vistas analíticas en Oracle Autonomous Data Warehouse

Visión general de la conexión a las vistas analíticas

En Oracle Analytics, puede modelar las vistas analíticas de Autonomous Data Warehouse y
visualizar los datos. Las vistas analíticas aceleran las consultas analíticas de datos
almacenados en las tablas y vistas de Oracle. Las vistas analíticas le permiten agregar
fácilmente agregaciones y cálculos a los datos que se pueden consultar con SQL
relativamente sencillo.

17-11
 Capítulo 17
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data Warehouse

Debe incluir las vistas analíticas en un modelo semántico y, a continuación, cargar el

modelo semántico en Oracle Analytics. Después de cargar el modelo semántico,
puede ver las dimensiones, las medidas y las medidas calculadas personalizadas en
los libros de trabajo de visualización de Oracle Analytics.

Elementos necesarios
• Oracle Autonomous Data Warehouse, 18c o posterior
• Oracle SQL Developer, 19.x o posterior
• Oracle Analytics Cloud, última versión.
• Oracle Analytics Client Tools (herramienta de administración de modelos), última
versión (versión mínima 6.0)

Creación y carga de un modelo semántico basado en una vista

analítica
Cree y cargue un modelo semántico basado en una vista analítica en una instancia de
Oracle Autonomous Data Warehouse para poder visualizar los datos.
Antes de empezar, asegúrese de que tiene los componentes necesarios; consulte
Visión general de la conexión a las vistas analíticas.
1. Opcional: Utilice SQL Developer para identificar y validar las vistas analíticas en el
origen de datos de Oracle Autonomous Data Warehouse que desee visualizar en
Oracle Analytics.

17-12
 Capítulo 17
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data Warehouse

Por ejemplo, si está usando SQL Developer, haga clic con el botón derecho en la vista
analítica y seleccione Validar vista analítica. Asegúrese de que la vista analítica es
válida antes de continuar.
2. Para incluir sus vistas analíticas en un nuevo modelo semántico y poder cargarlo en
Oracle Analytics:
a. En la herramienta de administración de modelos, haga clic en Archivo y en Nuevo
repositorio.
b. En la página Información del repositorio, especifique un Nombre y una Contraseña.
c. En la página Seleccionar origen de datos:
Para Tipo de conexión, seleccione Vistas analíticas de Oracle.
Para Nombre de origen de datos, copie la URL de conexión de Oracle Autonomous
Data Warehouse del archivo tnsnames.ora. En la instancia de Oracle Autonomous
Data Warehouse, extraiga el archivo tnsnames.ora del archivo wallet.zip. Copie la
cadena de descripción de texto, incluidos los paréntesis, tal y como se muestra.

17-13
 Capítulo 17
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data Warehouse

En Nombre de usuario y Contraseña, especifique las credenciales de la

instancia de Oracle Autonomous Data Warehouse.
d. En la página Seleccionar objetos de metadatos, mueva las vistas analíticas
que desee visualizar de la lista Vista de origen de datos a la lista Vista de
repositorio.

3. Para incluir vistas analíticas en un modelo semántico existente en Oracle

Analytics Cloud:
a. En la herramienta de administración de modelos, abra el modelo semántico
usando el modo En la nube.
b. Haga clic en Archivo y en Importar metadatos.
c. Siga las instrucciones en línea para conectarse a Oracle Autonomous Data
Warehouse e importar los metadatos.

4. En el panel Físico, verifique que puede ver las vistas analíticas que desea
visualizar.

17-14
 Capítulo 17
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data Warehouse

5. Arrastre las vistas analíticas del panel Físico al panel Presentación.

6. Cargue el modelo semántico que contiene las vistas analíticas en Oracle Analytics
Cloud.
Para cargar el archivo .rpd de modelo semántico sobrescribiendo el modelo semántico
existente (si lo hubiera):
a. En Oracle Analytics, haga clic en Consola y en Instantáneas.
b. En el menú de página, seleccione Reemplazar modelo de datos.
c. En la página Reemplazar modelo de datos, seleccione el nuevo archivo de modelo
semántico y haga clic en Reemplazar.

17-15
 Capítulo 17
Creación de un modelo semántico a partir de vistas analíticas en Oracle Autonomous Data Warehouse

Para cargar cambios en un modelo semántico existente que ha abierto usando el

modo En la nube, publique el modelo semántico en Oracle Analytics Cloud. En la
herramienta de administración de modelos, haga clic en Archivo, en Nube y en
Publicar.
Ya puede visualizar los datos de las vistas analíticas.

Conexión a vistas analíticas en Oracle Autonomous Data Warehouse

Conéctese a vistas analíticas para visualizar datos en Oracle Autonomous Data
Warehouse.
Antes de comenzar, pídale a su administrador de Oracle Analytics que ponga a su
disposición las vistas analíticas en un área temática local (modelo semántico).
1. En Oracle Analytics, en la página inicial, haga clic en Crear y después en Juego
de datos.
2. Haga clic en Área temática local.
3. Seleccione un área temática basada en una vista de análisis.
4. Seleccione los hechos y las medidas que quiere analizar y agréguelos a un nuevo
juego de datos.
Ya puede visualizar los datos en el juego de datos.

17-16
Parte V
Referencia
Este apartado ofrece información de referencia.
• Preguntas frecuentes
• Solución de problemas
• Referencia del editor de expresiones
A
Preguntas frecuentes
Esta referencia responde a algunas preguntas habituales que suelen tener los
administradores y analistas de inteligencia empresarial responsables de modelar datos
empresariales en Oracle Analytics Cloud.

Temas:
• Preguntas más frecuentes sobre Data Modeler (modelos semánticos)
– ¿Puedo utilizar los mismos datos para diferentes análisis?
– Después de agregar nuevas columnas a mi tabla de origen, ¿puedo incluir las
nuevas columnas en mi modelo semántico?
– ¿En qué situaciones debo crear objetos de modelo basados en vistas de origen?
– ¿Puedo incluir columnas de una tabla o vista de origen diferente en mi tabla de
dimensiones existente si se basa directamente en una tabla de origen?
– ¿Puedo incluir columnas de una tabla o vista de origen diferente en mi tabla de
dimensiones existente si se basa en una tabla de origen?
– ¿Puedo crear una vista de origen que se base en otra vista de origen?
– ¿Puedo migrar mi modelo semántico de un entorno a otro?
• Principales preguntas frecuentes para el editor de modelo de datos (informes de
impresión perfecta)
– ¿Cómo compruebo si el modelo de datos genera datos correctamente?
– ¿Cómo fragmento los datos XML para procesar juegos de datos grandes?
– ¿Cuál es el límite de tamaño de una consulta SQL para la repartición?
– ¿Cómo optimizo las consultas SQL?

Preguntas más frecuentes sobre Data Modeler (modelos

semánticos)
En este tema, se identifican las preguntas más frecuentes sobre el modelado de datos.

¿Puedo utilizar los mismos datos para diferentes análisis?

Sí. Puede crear vistas de origen que muestren las mismas columnas de origen en diferentes
contextos. Puede utilizar las vistas para incluir los mismos objetos de origen en varias
dimensiones. Por ejemplo, para utilizar datos de tiempo para las dimensiones Order Date y
Ship Date, cree dos vistas basadas en la tabla de origen de tiempo, time_order_date_v y
time_ship_date_v. Las vistas se podrán utilizar a continuación como orígenes de las
dimensiones Order Date y Ship Date.

A-1
 Apéndice A
Preguntas más frecuentes sobre Data Modeler (modelos semánticos)

Después de agregar nuevas columnas a mi tabla de origen, ¿puedo incluir las

nuevas columnas en mi modelo semántico?
Sí. Puede incluir las columnas de origen recién creadas. Para incluir las nuevas
columnas, seleccione Sincronizar con base de datos en el menú Acciones de la
tabla de hechos o de dimensiones correspondiente del modelo semántico. A
continuación, en la lista de mensajes, seleccione el elemento de mensaje que
describe las nuevas columnas y seleccione Sincronización seleccionada en el menú
Acciones de mensajes.

¿En qué situaciones debo crear objetos de modelo basados en vistas de

origen?
Cree una vista de origen siempre que crea que va a realizar cambios posteriores,
como la ampliación de los objetos de modelo, la creación de filtros y la adición de
cálculos. La creación de modelos basados en vistas de origen proporciona una mayor
flexibilidad que el uso directamente de tablas de origen.

¿Puedo incluir columnas de una tabla o vista de origen diferente en mi tabla de

dimensiones existente si se basa directamente en una tabla de origen?
Sí. Es fácil agregar columnas de otra tabla o vista de origen en una tabla de
dimensiones existente. Para ello, arrastre y suelte la tabla o vista en su tabla de
dimensiones existente Consulte Adición de columnas de otro origen a una tabla de
dimensiones.

¿Puedo incluir columnas de una tabla o vista de origen diferente en mi tabla de

dimensiones existente si se basa en una tabla de origen?
Sí. Para ello, existen dos métodos. Puede arrastrar y soltar la tabla en la tabla de
dimensiones para incluir las columnas. También puede editar la vista para incluir las
nuevas columnas de origen y sincronizar la tabla de dimensiones con los cambios
realizados en la base de datos. La sincronización identifica las nuevas columnas de la
vista y las agrega a su tabla de dimensiones.

¿Puedo crear una vista de origen que se base en otra vista de origen?
Sí. Para ello, arrastre y suelte la vista de origen en el área Columnas del separador
Visión general al crear la vista, o seleccione una vista de origen en el cuadro de
diálogo Agregar columnas como origen.
Por ejemplo, suponga que tiene las tablas de origen time y time_fiscal. Ha creado una
vista denominada time_v que combina time y time_fiscal. Desea crear varias
dimensiones basadas en los datos de tiempo, como Order Day y Ship Day. En primer
lugar debe crear la dimensión Order Day basada en time_v y, a continuación, crear
otra vista al principio de time_v para crear Ship Day. (Tenga en cuenta que también
puede crear una vista paralela denomina ship_day_v que combine también time y
time_fiscal.)

¿Puedo migrar mi modelo semántico de un entorno a otro?

Sí. Realice una instantánea de su entorno y mígrela al nuevo entorno. Consulte
Realización de instantáneas y restauración.

¿Puedo localizar análisis y paneles de control almacenados en el catálogo?

Sí. Siga el procedimiento Localización de leyendas de catálogo.

A-2
 Apéndice A
Principales preguntas frecuentes para el editor de modelo de datos (informes de impresión perfecta)

¿Puedo usar un archivo .rpd de modelo semántico de Oracle BI Enterprise Edition?

Sí. Si ha modelado los datos de negocio con Oracle BI Enterprise Edition, no tiene que
empezar desde cero en Oracle Analytics Cloud. En lugar de utilizar Data Modeler, puede
usar la consola o la herramienta de administración de modelos para cargar el archivo .rpd de
modelo semántico en Oracle Analytics Cloud. La herramienta de administración de modelos
está disponible al descargar Oracle Analytics Client Tools. Consulte Carga de modelos
semánticos desde Oracle BI Enterprise Edition.

¿Puedo editar mi archivo .rpd de modelo semántico después de haberlo cargado en

Oracle Analytics Cloud?
Sí. Consulte Edición de un modelo semántico en la nube.

Principales preguntas frecuentes para el editor de modelo de

datos (informes de impresión perfecta)
En este tema se identifican las principales preguntas frecuentes para crear y gestionar los
modelos de datos para informes de pixelado perfecto.

¿Cómo compruebo si el modelo de datos genera datos correctamente?

Abra el modelo de datos, haga clic en Datos y seleccione Ver para ver un máximo de 200
filas de datos. Si desea ver los datos completos, cree un informe y consúltelo en línea o
prográmelo.

¿Cómo fragmento los datos XML para procesar juegos de datos grandes?
Active la fragmentación de datos XML a nivel de instancia o a nivel de modelo de datos.

¿Cuál es el límite de tamaño de una consulta SQL para la repartición?

El límite de tamaño de los resultados de una consulta SQL es 200 000 filas.

¿Cómo optimizo las consultas SQL?

Use las propiedades de modelos de datos Omitir consulta de juegos de datos no
utilizados, Optimizar ejecución de consultas y Emplear varios threads para la
ejecución de consultas para optimizar las consultas SQL.

A-3
B
Solución de problemas
En este tema se describen problemas comunes que puede encontrar al modelar los datos
empresariales en Oracle Analytics Cloud y se explica cómo solucionarlos.

Temas:
• Solución de problemas con Data Modeler
– No veo ninguna tabla o vista en Data Modeler
– No veo el panel izquierdo en Data Modeler
– No puedo editar objetos en Data Modeler
– No puedo bloquear el modelo de datos
– No puedo publicar el modelo de datos
– Conveniencia de utilizar el separador Consulta SQL para editar una unión o filtro
para una vista
– Aparece un mensaje indicando un error de cluster y que no se encuentra el nodo del
servidor activo

Solución de problemas con Data Modeler

En este tema se describen los problemas más comunes que puede encontrar al utilizar Data
Modeler y explica cómo solucionarlos.

No veo ninguna tabla o vista en Data Modeler

Si inicia Data Modeler y no ve ninguna tabla o vista, puede que se haya dado alguna de las
siguientes situaciones:
• No hay ninguna tabla en la base de datos conectada a su servicio. Utilice una de las
herramientas de carga de datos soportadas para cargar algunos datos.
• Data Modeler no muestra los últimos objetos de base de datos. Para ver los últimos
objetos, refresque el panel Base de datos en Data Modeler.

No veo el panel izquierdo en Data Modeler

El panel izquierdo en Data Modeler está reducido. Para mostrar el panel izquierdo, haga clic
en el icono Restaurar panel que se muestra a la izquierda de la página.

No puedo editar objetos en Data Modeler

Siempre debe bloquear el modelo semántico antes de realizar ningún cambio. Haga clic en
Bloquear para editar para bloquear el modelo semántico.

B-1
 Apéndice B
Solución de problemas con Data Modeler

No puedo bloquear el modelo semántico

Compruebe si alguien ha bloqueado el modelo semántico. Si usted es el
administrador, puede sustituir el bloqueo. De lo contrario, espere a que se libere el
bloqueo. Para obtener más información, consulte Sustitución de bloqueos en Bloqueo
del modelo de datos.

No puedo publicar el modelo semántico

Compruebe si Data Modeler está abierto en varios separadores o ventanas del
explorador. En caso afirmativo, cierre los separadores o ventanas adicionales del
explorador que ejecutan Data Modeler e intente publicar de nuevo el modelo. Si se
sigue produciendo un error de publicación, reinicie el explorador.

Conveniencia de utilizar el separador Consulta SQL para editar una unión o filtro
para una vista
El mensaje que indica que se utilice el separador Consulta SQL para editar uniones/
filtros se muestra al hacer clic en el separador Uniones o en el separador Filtros en el
editor de vistas por uno de los siguientes motivos:
• Oracle Analytics Cloud no puede analizar la consulta SQL para la vista de la
base de datos
Si utiliza únicamente los separadores Visión general, Uniones y Filtros para editar
una vista de base de datos, Oracle Analytics Cloud crea una consulta SQL simple
para usted. Si decide editar el SQL manualmente a través del separador Consulta
SQL, las consultas simples se vuelven a reflejar en los separadores Visión
general, Unión y Filtros, de modo que pueda utilizar estos separadores para
seguir editando la vista posteriormente. Sin embargo, si ha utilizado el separador
Consulta SQL para realizar cambios de código más avanzados, no puede utilizar
los separadores Visión general, Uniones o Filtros para seguir editando la vista
porque Oracle Analytics Cloud no puede verificar las actualizaciones. Por ejemplo,
si incluye:
– Funciones de agregación SQL, cláusula GROUP BY, cláusula HAVING
– Cláusula ORDER BY
– Palabra clave OR en la cláusula WHERE
– Cláusula UNION
• Oracle Analytics Cloud no puede acceder a la vista de la base de datos
Si el problema persiste, informe del problema a su administrador. El administrador
puede investigar los problemas de conexión relacionados con el servicio de base
de datos.

Aparece un mensaje indicando un error de cluster y que no se encuentra el

nodo del servidor activo
La instancia puede estar inactiva o la base de datos puede estar bloqueada. Si el
problema persiste, informe del problema al administrador.

B-2
 Apéndice B
Solución de problemas con la herramienta de administración de modelos (Oracle Analytics Client Tools)

Solución de problemas con la herramienta de administración de

modelos (Oracle Analytics Client Tools)
Estos son algunos consejos sobre cómo solucionar problemas cuando intenta conectarse a
Oracle Analytics Cloud desde la herramienta de administración de modelos. La herramienta
de administración de modelos está disponible al descargar Oracle Analytics Client Tools.
Acceda a estos archivos log en la máquina cliente:
• BI_client_domain
home\domains\bi\servers\obis1\logs\user_name_NQSAdminTool.log
• BI_client_domain_home\domains\bi\clients\datamodel\logs\datamodel.log
En esta tabla se describen algunos problemas de conexión comunes y cómo se pueden
resolver.

Problemas de conexión comunes Causa y resolución

401: No autorizado O Fallo de Las credenciales de conexión no son válidas.
autenticación
Error al inicializar la
conexión TLS segura o
excepción de proxy:
java.security.NoSuchAlgorithm
Exception: Error al crear la
implantación (algoritmo: por
defecto, proveedor: SunJSSE,
clase:
sun.security.ssl.SSLContextIm
pl$DefaultSSLContext)
O security\cacerts.
Error al inicializar la
conexión TLS segura o
excepción de proxy: el host
remoto ha cerrado la conexión
durante el establecimiento de
la comunicación
• Asegúrese de que existe la cuenta de usuario.
• Asegúrese de que ha escrito correctamente el nombre
de usuario y la contraseña.
• Asegúrese de que la contraseña no contiene signos de
exclamación (!).
• Asegúrese de que el usuario tiene el rol de aplicación
de administrador de servicio de BI.
El problema tiene varias causas:
• La conexión apunta a un archivo no ubicado en un
almacén clave o de confianza.
• La conexión apunta a un almacén clave o de
confianza que no contiene un certificado para
verificar el certificado del servidor.
• La contraseña del almacén de confianza no es
correcta.
Utilice el almacén de claves de JDK por defecto ubicado
en:
BI_client_domain_home\oracle_common\jdk\jre\lib\

B-3

Solución de problemas con la herramienta de administración de modelos (Oracle Analytics Client Tools)
Problemas de conexión comunes
Fallo de conexión. Puede que El problema tiene varias causas:
los procesos del servidor
estén caídos o que el nombre
de host, el número de puerto,
la instancia de servicio o el • Si el archivo datamodel.log registra Connection
protocolo (http/https) no
sean correctos
No puedo usar la herramienta de
administración de modelos en
modo SSL
Apéndice B
Causa y resolución
• Asegúrese de que ha especificado el nombre de host y
el número de puerto correctos. Consulte Conexión a un
modelo semántico en la nube.
timed out, compruebe si la máquina en la que ha
instalado Oracle Analytics Client Tools se encuentra
en una red con proxy activado. Si es así, póngase en
contacto con el administrador de red para obtener
información sobre el servidor y el puerto de proxy, y
especifíquelos cuando se conecte al modelo
semántico.
• Si no puede diagnosticar un problema de conexión
utilizando los archivos log del cliente y Oracle
Analytics Cloud está desplegado en un entorno
gestionado por el cliente, compruebe los archivos log
del servidor bi-lcm-rest.log.0 y bi_server1.out.
Por ejemplo, si el usuario de la base de datos no
dispone del rol de aplicación BIServiceAdministrator,
el archivo bi_server1.out informa de un error
parecido a:
oracle.bi.restkit.security.auth.RequiredGrou
pAuthoriser> <BEA-000000> <Failed
authorisation for user: weblogic>
Si los certificadores de seguridad por defecto no
funcionan, importe los certificados de seguridad del
servidor. Por ejemplo, en la máquina en la que haya
descargado e instalado Oracle Analytics Client Tools, tal
vez desee usar la herramienta de gestión de certificados y
claves (herramienta de claves) para ejecutar estos
comandos:
C:\Oracle\Middleware\oracle_common\jdk\jre\bin
\keytool.exe -importcert -alias oacserver -
file
C:\Oracle\Middleware\oracle_common\jdk\jre\lib
\security\server.crt -keystore
C:\Oracle\Middleware\oracle_common\jdk\jre\lib
\security\cacerts -storepass
password
B-4
C
Referencia del editor de expresiones
En esta sección se describen los elementos de expresión que puede utilizar en el editor de
expresiones.

Temas:
• Objetos de modelo semántico
• Operadores SQL
• Expresiones condicionales
• Funciones
• Constantes
• Tipos
• Variables

Objetos de modelo semántico

Puede utilizar objetos de modelo semántico en expresiones, como niveles de tiempo,
columnas de dimensiones y columnas de hechos.
Para hacer referencia a un objeto de modelo semántico, utilice la sintaxis:
" Nombre de la tabla de hechos/dimensiones "." Nombre de columna "

Por ejemplo: "Order Metrics"."Booked Amount"-"Order Metrics"."Fulfilled Amount"

La sección Elementos de expresión solo incluye elementos relevantes para la tarea, por lo
que puede que no se muestren todas las tablas de hechos y de dimensiones. De igual
manera, las jerarquías de tiempo solo se incluyen si la tabla de hechos Time está unida a la
tabla actual.

Operadores SQL
Los operadores SQL se utilizan para especificar comparaciones entre expresiones.
Puede utilizar varios tipos de operadores SQL.

Operador Ejemplo Descripción Sintaxis

BETWEEN "COSTS"."UNIT_C Determina si un valor está entre dos BETWEEN
OST" BETWEEN límites no inclusivos. [LowerBound] AND
100.0 AND BETWEEN puede precedido por NOT [UpperBound]
5000.0 para negar la condición.

IN "COSTS"."UNIT_C Determina si un valor está presente IN ([Comma

OST" IN(200, en un juego de valores. Separated List])
600, 'A')

C-1
 Apéndice C
Operadores SQL

Operador Ejemplo Descripción Sintaxis

IS NULL "PRODUCTS"."PRO Determina si un valor es nulo. IS NULL
D_NAME" IS NULL
LIKE "PRODUCTS"."PRO Determina si un valor coincide con LIKE
D_NAME" LIKE toda una cadena o con parte de ésta.
'prod%' Se suele utilizar con caracteres
comodín para indicar cualquier
coincidencia de cadenas de
caracteres de cero o varios
caracteres (%) o cualquier
coincidencia de carácter único (_).
+ (FEDERAL_REVENU Signo más para sumar. +
E +
LOCAL_REVENUE)
-
TOTAL_EXPENDITU
RE
- (FEDERAL_REVENU Signo menos para restar. -
E +
LOCAL_REVENUE)
-
TOTAL_EXPENDITU
RE
*oX SUPPORT_SERVICE Signo de multiplicación para *
S_EXPENDITURE * multiplicar. X
1.5
/ CAPITAL_OUTLAY_ Signo de división para dividir. /
EXPENDITURE/
1.05
% Porcentaje %
|| STATE|| Concatenación de cadenas de ||
CAST(YEAR AS caracteres.
CHAR(4))
( (FEDERAL_REVENU Paréntesis de apertura. (
E +
LOCAL_REVENUE)
-
TOTAL_EXPENDITU
RE
) (FEDERAL_REVENU Paréntesis de cierre. )
E +
LOCAL_REVENUE)
-
TOTAL_EXPENDITU
RE

C-2
 Apéndice C
Expresiones condicionales

Operador Ejemplo Descripción Sintaxis

> YEAR > 2000 and Signo mayor que: indica los valores >
YEAR < 2016 and mayores que la comparación.
YEAR <> 2013
< YEAR > 2000 and Signo menor que: indica los valores <
YEAR < 2016 and inferiores a la comparación.
YEAR <> 2013
= Signo igual: indica el mismo valor. =
>= Signo mayor que o igual: indica los >=
valores que son iguales o mayores
que la comparación.
<= Signo menor que o igual: indica los <=
valores que son iguales o inferiores a
la comparación.
<> YEAR > 2000 and Distinto de, indica los valores que <>
YEAR < 2016 and son superiores o inferiores, pero
YEAR <> 2013 diferentes.

, STATE in Coma: signo que se utiliza para ,

('ALABAMA','CAL separar elementos en una lista.
IFORNIA')

Expresiones condicionales
Puede utilizar expresiones condicionales para crear expresiones que conviertan valores.
Las expresiones condicionales descritas en esta sección son bloques que sirven para crear
expresiones condicionales que convierten un valor de un formato a otro.
Siga estas reglas:
• En las sentencias CASE, AND tiene prioridad sobre OR.
• Las cadenas deben estar entre comillas simples.

C-3
 Apéndice C
Expresiones condicionales

Expresión Ejemplo Descripción Sintaxis

CASE (If) CASE Evalúa cada condición CASE WHEN
WHEN score-par < 0 WHEN y, si se cumple, request_condition
asigna el valor a la 1 THEN expr1 ELSE
THEN 'Bajo par'
expresión THEN expr2 END
WHEN score-par = 0 correspondiente.
THEN 'Par' Si no se cumple ninguna
WHEN score-par = 1 condición WHEN, se asigna
THEN 'Bogey' el valor por defecto
especificado en la
WHEN score-par = 2
expresión ELSE. Si no se
THEN 'Doble Bogey'
especifica ninguna
ELSE 'Triple bogey o expresión ELSE, el
peor' sistema agregará
automáticamente ELSE
END
NULL.
Nota: Consulte Mejores
prácticas para el uso de
sentencias CASE en
análisis y visualizaciones.
CASE CASE Score-par También se conoce como CASE expr1 WHEN
(Switch) CASE (Lookup). Se expr2 THEN expr3
WHEN -5 THEN 'Birdie
examina el valor de la ELSE expr4 END
en el par 6'
primera expresión y, a
WHEN -4 THEN 'Debe continuación, de las
ser Tiger' expresiones WHEN. Si la
WHEN -3 THEN 'Tres primera expresión
coincide con cualquier
bajo par'
expresión WHEN, asigna el
WHEN -2 THEN 'Dos valor de la expresión
bajo par' THEN correspondiente.
WHEN -1 THEN 'Birdie' Si no coincide ninguna
de las expresiones WHEN,
WHEN 0 THEN 'Par'
se le asigna el valor por
WHEN 1 THEN 'Bogey' defecto especificado en la
WHEN 2 THEN 'Doble expresión ELSE. Si no se
Bogey' especifica ninguna
expresión ELSE, el
ELSE 'Triple bogey o
sistema agregará
peor' automáticamente ELSE
END NULL.
Si la primera expresión
coincide con una
expresión en varias
cláusulas WHEN, solo se
asignará la expresión
posterior a la primera
coincidencia.
Nota Consulte Mejores
prácticas para el uso de
sentencias CASE en
análisis y visualizaciones.

C-4
 Apéndice C
Funciones

Expresión Ejemplo Descripción Sintaxis

IfCase > - - ELSE [expr]
ELSE
IfCase > - - IFNULL([expr],
IFNULL [value])
IfCase > - - NULLIF([expr],
NULLIF [expr])
IfCase > - - WHEN [Condition]
WHEN THEN [expr]
IfCase > - - CASE WHEN
CASE [Condition] THEN
[expr] END
SwitchCase - - ELSE [expr]
> ELSE
SwitchCase - - IFNULL([expr],
>IFNULL [value])
SwitchCase - - NULLIF([expr],
> NULLIF [expr])
SwitchCase - - WHEN [Condition]
> WHEN THEN [expr]

Funciones
Hay varios tipos de funciones que puede utilizar en expresiones.

Temas:
• Funciones de agregación
• Funciones analíticas
• Funciones de fecha y hora
• Funciones de conversión
• Funciones de visualización
• Funciones de evaluación
• Funciones matemáticas
• Funciones de agregado de ejecución
• Funciones espaciales
• Funciones de cadena
• Funciones del sistema
• Funciones de serie temporal

C-5
 Apéndice C
Funciones

Funciones de agregación
Las funciones agregadas realizan operaciones en varios valores para crear resultados
de resumen.
En la lista siguiente se describen las reglas de agregación que están disponibles para
las columnas y las columnas de medida. La lista también incluye funciones que puede
utilizar al crear un elemento calculado para realizar análisis.
• Predeterminado: aplica la regla de agregación predeterminada como en el
modelo semántico o por el autor original del análisis. No disponible para
elementos calculados en los análisis.
• Determinado por el servidor: aplica la regla de agregación determinada por
Oracle Analytics (como, por ejemplo, la regla que se define en el modelo
semántico). La agregación se realiza en Oracle Analytics para reglas simples
como suma, mínimo y máximo. No está disponible para columnas de medida del
panel Diseño ni para elementos calculados en análisis.
• Suma: calcula la suma obtenida al agregar todos los valores en el juego de
resultados. Utilícela para elementos que tengan valores numéricos.
• Mínimo: calcula el valor mínimo (valor numérico inferior) de las filas en el juego
de resultados. Utilícela para elementos que tengan valores numéricos.
• Máximo: calcula el valor máximo (valor numérico superior) de las filas en el juego
de resultados. Utilícela para elementos que tengan valores numéricos.
• Media: calcula la media de un elemento en el juego de resultados. Utilícela para
elementos que tengan valores numéricos. Las medias de tablas y tablas
dinámicas se redondean al número entero más próximo.
• Primero: en el juego de resultados, selecciona la primera incidencia del elemento
para medidas. Para los elementos calculados, selecciona el primer miembro
según la pantalla de la lista Seleccionados. No está disponible en el cuadro de
diálogo Editar fórmula de columna.
• Último: en el juego de resultados, seleccione la última incidencia del elemento.
Para los elementos calculados, selecciona el último miembro según la pantalla en
la lista Seleccionados. No está disponible en el cuadro de diálogo Editar fórmula
de columna.
• Recuento: calcula el número de filas en el juego de resultados que tienen un
valor no nulo para el elemento. El elemento es normalmente un nombre de
columna, en cuyo caso se devuelve el número de filas con valores no nulos para
dicha columna.
• Recuento de los Valores Distintos: agrega procesamientos distintos a la función
Recuento, lo que significa que cada incidencia distinta del elemento se cuenta
sólo una vez.
• Ninguno: no aplica agregación. No disponible para elementos calculados en los
análisis.
• Total basado en informe (si procede): si no se selecciona, especifica que
Oracle Analytics debe calcular el total en base a todo el juego de resultados antes
de aplicar ningún filtro a las medidas. No está disponible en el cuadro de diálogo
Editar fórmula de columna ni para elementos calculados en los análisis. Sólo
disponible para columnas de atributo.

C-6
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

AGGREGATE AGGREGATE(sales Agrega columnas según el nivel o los AGGREGATE(measure AT
AT AT month, niveles que especifique. level [, level1,
region) measure es el nombre de una columna de levelN])
medida. level es el nivel en el que desea
realizar la agregación. También puede
especificar más de un nivel. No se puede
especificar un nivel a partir de una
dimensión que contenga los niveles que
se están utilizando como nivel de medida
para la medida especificada en el primer
argumento. Por ejemplo, no puede
escribir la función como
AGGREGATE(yearly_sales AT month), ya
que month procede de la misma
dimensión de tiempo que se está
utilizando como nivel de medida para
yearly_sales.
AVG Avg(Sales) Calcula la media (promedio) de un juego AVG(expr)
numérico de valores.
AVGDISTINCT Calcula la media de todos los valores AVG(DISTINCT expr)
distintos de una expresión.
BIN BIN(revenue BY Clasifica una determinada expresión BIN(numeric_expr [BY
productid, year numérica en un número especificado de grain_expr1, ...,
WHERE productid cubos del mismo ancho. La función grain_exprN] [WHERE
puede devolver el número de bin o uno
> 2 INTO 4 BINS condition] INTO
de los dos puntos finales del intervalo de
RETURNING bins. numeric_expr es la medida o el number_of_bins BINS
RANGE_LOW) atributo numérico en el bin. BY [BETWEEN min_value
grain_expr1,…, grain_exprN es una lista AND max_value]
de expresiones que define el detalle con [RETURNING {NUMBER |
el que se calcula el valor de RANGE_LOW |
numeric_expr. BY es necesario para las
expresiones de medida, y es opcional
RANGE_HIGH}])
para las expresiones de atributo. WHERE
es un filtro que se aplica a numeric_expr
antes de que se asignen los valores
numéricos a los bins INTO
number_of_bins BINS es el número de
bins que devolver. BETWEEN min_value
AND max_value son los valores mínimo y
máximo que se utilizan como puntos
finales de los bins más externos.
RETURNING NUMBER indica que el valor
de retorno debe ser el número de bins (1,
2, 3, 4, etc.). Éste es el estado por defecto.
RETURNING RANGE_LOW indica el valor
más bajo del intervalo de bins.
RETURNING RANGE_HIGH indica el valor
más alto del intervalo de bins

C-7
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

BottomN Clasifica los n valores más bajos del BottomN(expr,
argumento de la expresión de 1 a n, integer)
donde 1 corresponde al valor numérico
más bajo.
expr es una expresión que se evalúa
como un valor numérico. integer es
cualquier entero positivo. Representa el
número más bajo de las clasificaciones
que aparecen en el conjunto de
resultados (1 es la clasificación más baja).
COUNT COUNT(Products) Determina el número de elementos con COUNT(expr)
un valor no nulo.
COUNTDISTIN Agrega un procesamiento distinto a la COUNT(DISTINCT expr)
CT función COUNT.
expr es cualquier expresión.
COUNT* SELECT COUNT(*) Cuenta el número de filas. COUNT(*)
FROM Facts
Primero First(Sales) Selecciona el primer valor devuelto no First([NumericExpress
nulo del argumento de la expresión. La ion)]
función First funciona en el nivel más
detallado especificado en la dimensión
que haya definido de forma explícita.
Último Last(Sales) Selecciona el último valor devuelto no Last([NumericExpressi
nulo de la expresión. on)]
MAVG Calcula el promedio (media) móvil de las MAVG(expr, integer)
últimas n filas de datos en el juego de
resultados, incluida la fila actual.
expr es una expresión que se evalúa
como un valor numérico. integer es
cualquier entero positivo. Representa el
valor medio de las últimas n filas de
datos.
MAX MAX(Revenue) Calcula el valor máximo (valor numérico MAX(expr)
más elevado) de las filas que cumplen el
argumento de expresión numérica.
MEDIAN MEDIAN(Sales) Calcula el valor medio de las filas que MEDIAN(expr)
cumplen el argumento de expresión
numérica. Cuando hay un número par de
filas, la mediana es la media de las dos
filas centrales. Esta función siempre
devuelve un doble.
MIN MIN(Revenue) Calcula el valor mínimo (valor numérico MIN(expr)
mínimo) de las filas que cumplen el
argumento de la expresión numérica.

C-8
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

NTILE Determina el rango de un valor según NTILE(expr, numTiles)
una amplitud de rango especificada por
el usuario. Devuelve enteros para
representar cualquier intervalo de
rangos. NTILE con numTiles=100
devuelve lo que se denomina
normalmente "percentil" (con números
que oscilan entre 1 y 100, siendo 100 el
valor más elevado de la clasificación).
expr es cualquier expresión que se evalúa
como un valor numérico. numTiles es un
entero positivo, no nulo, que representa
el número de mosaicos.
PERCENTILE Calcula una clasificación de percentiles PERCENTILE(expr)
para cada valor que cumple el argumento
de la expresión numérica. Los rangos de
clasificación de percentiles están entre 0
(0º percentil) y 1 (100º percentil).
expr es cualquier expresión que se evalúa
como un valor numérico.
RANK RANK(chronologic Calcula el rango de cada valor que RANK(expr)
al_key, null, cumple el argumento de expresión
year_key_columns numérica. Al número más alto, se le
asigna el rango 1 y a cada rango sucesivo
)
se le asigna el siguiente entero
consecutivo (2, 3, 4...). Si determinados
valores coinciden, se les asigna el mismo
rango (por ejemplo, 1, 1, 1, 4, 5, 5, 7...).
expr es cualquier expresión que se evalúa
como un valor numérico.
STDDEV STDDEV(Sales) Devuelve la desviación estándar de un STDDEV(expr)
STDDEV(DISTINCT conjunto de valores. El tipo de retorno
Sales) siempre es un doble.

STDDEV_POP STDDEV_POP(Sales Devuelve la desviación estándar de un STDDEV_POP([NumericEx

) juego de valores mediante la fórmula pression])
STDDEV_POP(DISTI numérica de la desviación estándar y la
varianza de relleno.
NCT Sales)
SUM SUM(Revenue) Calcula la suma que se obtiene al agregar SUM(expr)
todos los valores que cumplen el
argumento de expresión numérica.
SUMDISTINCT Calcula la suma obtenida al sumar todos SUM(DISTINCT expr)
los valores distintos que cumplen el
argumento de la expresión numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.

C-9
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

TOPN Clasifica los n valores más altos del TOPN(expr, integer)
argumento de expresión de 1 a n, de
forma que 1 corresponde al valor
numérico más alto.
expr es una expresión que se evalúa
como un valor numérico. integer es
cualquier entero positivo. Representa el
número más alto de clasificaciones que se
muestran en el juego de resultados,
donde 1 es el rango más alto.

Funciones analíticas
Las funciones de análisis permiten explorar los datos utilizando modelos como
Tendencia Lineal y Cluster.

Función Ejemplo Descripción Sintaxis

TRENDLINE TRENDLINE(revenue,
(calendar_year,
calendar_quarter,
calendar_month) BY
(product), 'LINEAR',
'VALUE')
CLUSTER CLUSTER((product,
company),
(billed_quantity,
revenue), 'clusterName',
'algorithm=k-
means;numClusters=%1;maxI
ter=%2;useRandomSeed=FALS
E;enablePartitioning=TRUE
', 5, 10)
Oracle recomienda que TRENDLINE(numeric_expr,
aplique una línea de ([series]) BY
tendencia utilizando la ([partitionBy]),
propiedad Agregar
model_type, result_type)
estadísticas al mostrar
una visualización.
Consulte Ajuste de
propiedades de
visualización.
Ajusta un modelo lineal,
polinómico o
exponencial y devuelve
los valores o el modelo
ajustados. numeric_expr
representa el valor Y de
la tendencia, y series
(columnas de tiempo)
representan el valor X.
Recopila un juego de CLUSTER((dimension_expr1
registros en grupos , ... dimension_exprN),
basándose en una o más (expr1, ... exprN),
expresiones de entrada
output_column_name,
mediante K-Means o la
agrupación en clusters options,
jerárquica. [runtime_binded_options])

C-10
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

OUTLIER OUTLIER((product,
company),
(billed_quantity,
revenue), 'isOutlier',
'algorithm=kmeans')
REGR REGR(revenue,
(discount_amount),
(product_type, brand),
'fitted', '')
Clasifica un registro OUTLIER((dimension_expr1
como valor atípico en , ... dimension_exprN),
función de una o más (expr1, ... exprN),
expresiones de entrada
output_column_name,
mediante K-Means,
agrupación en clusters options,
jerárquica o algoritmos [runtime_binded_options])
de detección de valores
atípicos de varias
variables.
Ajusta un modelo lineal y REGR(y_axis_measure_expr,
devuelve los valores o el (x_axis_expr),
modelo ajustados. Esta (category_expr1, ...,
función puede utilizarse
category_exprN),
para ajustar una curva
lineal en dos medidas. output_column_name,
options,
[runtime_binded_options])

Funciones de fecha y hora

Las funciones de fecha y hora manipulan los datos según DATE y DATETIME.

Función Ejemplo Descripción Sintaxis

CURRENT_Dat CURRENT_DATE Devuelve la fecha actual. CURRENT_DATE
e La fecha se determina en el sistema
donde se ejecuta Oracle BI.
CURRENT_TIM CURRENT_TIME(3) Devuelve la hora actual al número CURRENT_TIME(expr)
E especificado de dígitos de precisión, por
ejemplo: HH:MM:SS.SSS
Si no se especifica ningún argumento, la
función devuelve la precisión por
defecto.
CURRENT_TIM CURRENT_TIMESTAM Devuelve la fecha/registro de hora actual CURRENT_TIMESTAMP(exp
ESTAMP P(3) al número especificado de dígitos de r)
precisión.
DAYNAME DAYNAME(Order_Da Devuelve el nombre del día de la semana DAYNAME(expr)
te) de una expresión de fecha especificada.

DAYOFMONTH DAYOFMONTH(Order Devuelve el número correspondiente al DAYOFMONTH(expr)

_Date) día del mes de una expresión de fecha
especificada.
DAYOFWEEK DAYOFWEEK(Order_ Devuelve un número entre 1 y 7 DAYOFWEEK(expr)
Date) correspondiente al día de la semana de
una expresión de fecha especificada. Por
ejemplo, 1 siempre corresponde al
domingo, 2 al lunes, y así sucesivamente
hasta el sábado, que corresponde al
número 7.

C-11
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

DAYOFYEAR DAYOFYEAR(Order_ Devuelve el número (entre 1 y 366) DAYOFYEAR(expr)
Date) correspondiente al día del año de una
expresión de fecha especificada.
DAY_OF_QUAR DAY_OF_QUARTER(O Devuelve un número (entre 1 y 92) que DAY_OF_QUARTER(expr)
TER rder_Date) corresponde al día del trimestre de la
expresión de fecha especificada.
HOUR HOUR(Order_Time) Devuelve un número (entre 0 y 23) HOUR(expr)
correspondiente a la hora de una
expresión de hora especificada. Por
ejemplo, 0 corresponde a las 00:00 y 23
corresponde a las 23.00.
MINUTE MINUTE(Order_Tim Devuelve un número (entre 0 y 59) MINUTE(expr)
e) correspondiente al minuto de una
expresión de tiempo especificada.
MONTH MONTH(Order_Time Devuelve el número (entre 1 y 12) MONTH(expr)
) correspondiente al mes de una expresión
de fecha especificada.
MONTHNAME MONTHNAME(Order_ Devuelve el nombre del mes de una MONTHNAME(expr)
Time) expresión de fecha especificada.

MONTH_OF_Q MONTH_OF_QUARTE Devuelve el número (entre 1 y 3) MONTH_OF_QUARTER(expr

UARTER R(Order_Date) correspondiente al mes del trimestre de )
una expresión de fecha especificada.
NOW NOW() Devuelve la fecha/hora actual. La función NOW()
NOW es equivalente a la función
CURRENT_TIMESTAMP.
QUARTER_OF_ QUARTER_OF_YEAR( Devuelve el número (entre 1 y 4) QUARTER_OF_YEAR(expr)
YEAR Order_Date) correspondiente al trimestre del año de
una expresión de fecha especificada.
SECOND SECOND(Order_Tim Devuelve el número (entre 0 y 59) SECOND(expr)
e) correspondiente a los segundos de una
expresión de tiempo especificada.
TIMESTAMPA TIMESTAMPADD(SQL Agrega el número especificado de TIMESTAMPADD(interval
DD _TSI_MONTH, intervalos a un registro de hora y , expr, timestamp)
12,Time."Order devuelve un solo registro de hora.
Date") Las opciones de intervalo son:
SQL_TSI_SECOND, SQL_TSI_MINUTE,
SQL_TSI_HOUR, SQL_TSI_DAY,
SQL_TSI_WEEK, SQL_TSI_MONTH,
SQL_TSI_QUARTER, SQL_TSI_YEAR
TIMESTAMPDI TIMESTAMPDIFF(SQ Devuelve el número total de intervalos TIMESTAMPDIFF(interva
FF L_TSI_MONTH, especificados entre dos indicaciones de l, expr, timestamp2)
Time."Order fecha/hora.
Date",CURRENT_DA Utilice los mismos intervalos que
TE) TIMESTAMPADD.

WEEK_OF_QU WEEK_OF_QUARTER( Devuelve un número (entre 1 y 13) que WEEK_OF_QUARTER(expr)

ARTER Order_Date) corresponde a la semana del trimestre de
la expresión de fecha especificada.

C-12
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

WEEK_OF_YE WEEK_OF_YEAR(Ord Devuelve un número (entre 1 y 53) que WEEK_OF_YEAR(expr)
AR er_Date) corresponde a la semana del año de la
expresión de fecha especificada.
YEAR YEAR(Order_Date) Devuelve el año de la expresión de fecha YEAR(expr)
especificada.

Funciones de conversión
Las funciones de conversión convierten un valor de un formato a otro.

Función Ejemplo Descripción Sintaxis

CAST CAST(hiredate AS Cambia el tipo de dato de una CAST(expr AS type)
CHAR(40)) FROM expresión o un literal nulo a otro
employee tipo de dato. Por ejemplo, se puede
convertir customer_name (un tipo
de datos CHAR o VARCHAR) o birthdate
(un literal de fecha y hora).
Utilice CAST para cambiar a un tipo
de dato Date.
No utilice TODATE.

IFNULL IFNULL(Sales, 0) Prueba si una expresión se evalúa IFNULL(expr, value)

en un valor nulo y, en caso
afirmativo, asigna el valor
especificado a la expresión.
INDEXCOL SELECT Utiliza información externa para INDEXCOL([integer
INDEXCOL(VALUEOF devolver la columna adecuada para literal], [expr1] [,
(NQ_SESSION.GEOGRAPHY que la pueda ver el usuario [expr2], ?-])
conectado.
_LEVEL), Country,
State, City), Revenue
FROM Sales
NULLIF SELECT e.last_name, Compara dos expresiones. Si son NULLIF([expression],
NULLIF(e.job_id, iguales, la función devuelve NULL. [expression])
j.job_id) "Old Job Si no son iguales, la función
devuelve la primera expresión. No
ID" FROM employees e,
puede especificar el literal NULL
job_history j WHERE para la primera expresión.
e.employee_id =
j.employee_id ORDER
BY last_name, "Old
Job ID";
To_DateTime SELECT To_DateTime Convierte los literales de cadena de To_DateTime([expressi
('2009-03-0301:01:00' formato DateTime a un tipo de dato on], [literal])
, 'yyyy-mm-dd DateTime.
hh:mi:ss') FROM sales

C-13
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

VALUEOF SalesSubjectArea.Cust Hace referencia al valor de una VALUEOF(expr)
omer.Region = variable de modelo semántico en un
VALUEOF("Region filtro.
Security"."REGION") Utilice variables expr como
argumentos de la función VALUEOF.
Utilice el nombre para hacer
referencia a las variables de modelo
semántico.

Funciones de visualización
Las funciones de visualización se utilizan en el juego de resultados de una consulta.

Función Ejemplo Descripción Sintaxis

BottomN BottomN(Sales, Devuelve los n valores inferiores de la BottomN([NumericExpre
10) expresión, clasificados de menor a ssion], [integer])
mayor.
FILTER FILTER(Sales Calcula la expresión con el filtro de FILTER(measure USING
USING Product = agregación previa especificado. filter_expr)
'widget')
MAVG MAVG(Sales, 10) Calcula el promedio (media) móvil de las MAVG([NumericExpressi
últimas n filas de datos en el juego de on], [integer])
resultados, incluida la fila actual.
MSUM SELECT Month, Calcula una suma móvil de las últimas n MSUM([NumericExpressi
Revenue, filas de datos, incluida la fila actual. on], [integer])
MSUM(Revenue, 3) La suma de la primera fila es igual a la
as 3_MO_SUM FROM expresión numérica de la primera fila. La
Sales suma de la segunda fila se calcula
tomando la suma de las dos primeras
filas de datos, etc. Cuando se llega a la fila
n , la suma se calcula en función de las
últimas n filas de datos.
NTILE NTILE(Sales, Determina el rango de un valor según NTILE([NumericExpress
100) una amplitud de rango especificada por sion], [integer])
el usuario. Devuelve enteros para
representar cualquier intervalo de
rangos. El ejemplo muestra un rango
desde 1 hasta 100, donde la menor venta
= 1 y la mayor venta = 100.
PERCENTILE PERCENTILE(Sales Calcula el rango de porcentaje de cada PERCENTILE([NumericEx
) valor que cumple el argumento de pression])
expresión numérica. Oscila entre 0
(primer percentil) y 1 (100º percentil),
incluidos.

C-14
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

RANK RANK(Sales) Calcula el rango de cada valor que RANK([NumericExpressi
cumple el argumento de expresión on])
numérica. Al número más alto, se le
asigna el rango 1 y a cada rango sucesivo
se le asigna el siguiente entero
consecutivo (2, 3, 4...). Si determinados
valores coinciden, se les asigna el mismo
rango (por ejemplo, 1, 1, 1, 4, 5, 5, 7...).
RCOUNT SELECT month, Toma un juego de registros como entrada RCOUNT([NumericExpres
profit, y cuenta el número de registros sion])
RCOUNT(profit) encontrados hasta ese momento.
FROM sales WHERE
profit > 200
RMAX SELECT month, Toma un juego de registros como entrada RMAX([NumericExpressi
profit, y muestra el valor máximo a partir de los on])
RMAX(profit) registros encontrados hasta ese
momento. El tipo de grupos especificado
FROM sales
debe ser uno que se pueda ordenar.
RMIN SELECT month, Toma un juego de registros como entrada RMIN([NumericExpressi
profit, y muestra el valor mínimo a partir de los on])
RMIN(profit) registros encontrados hasta ese
momento. El tipo de grupos especificado
FROM sales
debe ser uno que se pueda ordenar.
RSUM SELECT month, Calcula una suma de valores a partir de RSUM([NumericExpressi
revenue, los registros encontrados hasta ese on])
RSUM(revenue) as momento.
RUNNING_SUM FROM La suma de la primera fila es igual a la
sales expresión numérica de la primera fila. La
suma de la segunda fila se calcula
tomando la suma de las dos primeras
filas de datos, etc.
TOPN TOPN(Sales, 10) Devuelve los n valores superiores de la TOPN([NumericExpressi
expresión, clasificados de mayor a on], [integer])
menor.

Funciones de evaluación
Las funciones de evaluación son funciones de base de datos que se pueden utilizar para
transferir expresiones para obtener cálculos avanzados.
Las funciones de base de datos embebidas pueden necesitar una o más columnas. Se hace
referencia a ellas mediante %1 ... %N en la función. Las columnas reales deben enumerarse
después de la función.

C-15
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

EVALUATE SELECT Transfiere la función de la base de datos EVALUATE([string
EVALUATE('instr( especificada con columnas opcionales a expression], [comma
%1, %2)', las que se hace referencia como separated
parámetros a la base de datos para
address, 'Foster expressions])
evaluación.
City') FROM
employees
EVALUATE_AG EVALUATE_AGGR('R Transfiere la función de la base de datos EVALUATE_AGGR('db_agg
GR EGR_SLOPE(%1, especificada con columnas opcionales a _function(%1...%N)'
%2)', las que se hace referencia como [AS datatype] [,
parámetros a la base de datos para
sales.quantity, column1, columnN])
evaluación. Esta función se utiliza para
market.marketkey agregar funciones con una cláusula
) GROUP BY.

Funciones matemáticas
Las funciones matemáticas descritas en esta sección realizan operaciones
matemáticas.

Función Ejemplo Descripción Sintaxis

ABS ABS(Profit) Calcula el valor absoluto de una ABS(expr)
expresión numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
ACOS ACOS(1) Calcula el arcocoseno de una expresión ACOS(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
ASIN ASIN(1) Calcula el arcoseno de una expresión ASIN(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
ATAN ATAN(1) Calcula el arcotangente de una expresión ATAN(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
ATAN2 ATAN2(1, 2) Calcula la arcotangente de y /x, donde y es ATAN2(expr1, expr2)
la primera expresión numérica, y x la
segunda.
CEILING CEILING(Profit) Redondea una expresión numérica no CEILING(expr)
entera al siguiente entero superior. Si la
expresión numérica se evalúa como un
entero, la función CEILING devuelve ese
entero.
COS COS(1) Calcula el coseno de una expresión COS(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.

C-16
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

COT COT(1) Calcula la cotangente de una expresión COT(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
DEGREES DEGREES(1) Convierte una expresión de radianes a DEGREES(expr)
grados.
expr es cualquier expresión que se evalúa
como un valor numérico.
EXP EXP(4) Eleva el valor a la potencia especificada. EXP(expr)
Calcula e elevado a la potencia n, donde e
es la base del logaritmo natural.
ExtractBit Int Recupera un bit en una posición ExtractBit([Source
ExtractBit(1, 5) determinada en un entero. Devuelve un Number], [Digits])
entero de 0 o 1 que corresponde a la
posición del bit.
FLOOR FLOOR(Profit) Redondea una expresión numérica no FLOOR(expr)
entera al siguiente entero inferior. Si la
expresión numérica se evalúa como un
entero, la función FLOOR devuelve ese
entero.
LOG LOG(1) Calcula el logaritmo neperiano de una LOG(expr)
expresión.
expr es cualquier expresión que se evalúa
como un valor numérico.
LOG10 LOG10(1) Calcula el logaritmo decimal de una LOG10(expr)
expresión.
expr es cualquier expresión que se evalúa
como un valor numérico.
MOD MOD(10, 3) Divide la primera expresión numérica MOD(expr1, expr2)
entre la segunda expresión numérica y
devuelve la parte restante del cociente.
PI PI() Devuelve el valor constante de pi. PI()
POWER POWER(Profit, 2) Toma la primera expresión numérica y la POWER(expr1, expr2)
eleva a la potencia especificada en la
segunda expresión numérica.
RADIANS RADIANS(30) Convierte una expresión de grados a RADIANS(expr)
radianes.
expr es cualquier expresión que se evalúa
como un valor numérico.
RAND RAND() Devuelve un número pseudoaleatorio RAND()
entre 0 y 1.
RANDFromSee RAND(2) Devuelve un número pseudoaleatorio RAND(expr)
d basado en un valor original. Para un
valor semilla concreto, se genera el
mismo conjunto de números aleatorios.

C-17
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

ROUND ROUND(2.166000, Redondea una expresión numérica a n ROUND(expr, integer)
2) dígitos de precisión.
expr es cualquier expresión que se evalúa
como un valor numérico.
Un entero es cualquier entero positivo
entero que representa el número de
dígitos de precisión.
SIGN SIGN(Profit) Devuelve lo siguiente: SIGN(expr)
• 1 si la expresión numérica se evalúa
como un número positivo
• -1 si la expresión numérica se evalúa
como un número negativo
• 0 si la expresión numérica se evalúa
como cero
SIN SIN(1) Calcula el seno de una expresión SIN(expr)
numérica.
SQRT SQRT(7) Calcula la raíz cuadrada del argumento SQRT(expr)
de expresión numérica. La expresión
numérica debe evaluar un número no
negativo.
TAN TAN(1) Calcula la tangente de una expresión TAN(expr)
numérica.
expr es cualquier expresión que se evalúa
como un valor numérico.
TRUNCATE TRUNCATE(45.1234 Trunca un número decimal para devolver TRUNCATE(expr,
5, 2) el número especificado de decimales integer)
desde el separador de decimales.
expr es cualquier expresión que se evalúa
como un valor numérico.
Un entero es cualquier entero positivo
que representa el número de caracteres a
la derecha del lugar decimal que se
devuelve.

Funciones de agregado de ejecución

Las funciones de agregado de ejecución realizan operaciones en varios valores para
crear resultados de resumen.

Función Ejemplo Descripción Sintaxis

MAVG Calcula el promedio (media) móvil de las MAVG(expr, integer)
últimas n filas de datos en el juego de
resultados, incluida la fila actual.
expr es cualquier expresión que se evalúa
como un valor numérico. integer es
cualquier entero positivo. Representa el
valor medio de las últimas n filas de
datos.

C-18
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

MSUM select month, Calcula una suma móvil de las últimas n MSUM(expr, integer)
revenue, filas de datos, incluida la fila actual.
MSUM(revenue, 3) expr es cualquier expresión que se evalúa
as 3_MO_SUM from como un valor numérico. integer es
sales_subject_ar cualquier entero positivo. Representa la
suma de las últimas n filas de datos.
ea
RSUM SELECT month, Calcula una suma de valores a partir de RSUM(expr)
revenue, los registros encontrados hasta ese
RSUM(revenue) as momento.
RUNNING_SUM from expr es cualquier expresión que se evalúa
sales_subject_ar como un valor numérico.
ea
RCOUNT select month, Toma un juego de registros como entrada RCOUNT(expr)
profit, y cuenta el número de registros
RCOUNT(profit) encontrados hasta ese momento.
from expr es una expresión de cualquier tipo
sales_subject_ar de dato.
ea where profit
> 200
RMAX SELECT month, Toma un juego de registros como entrada RMAX(expr)
profit,RMAX(prof y muestra el valor máximo a partir de los
it) from registros encontrados hasta ese
momento.
sales_subject_ar
ea expr es una expresión de cualquier tipo
de dato.
RMIN select month, Toma un juego de registros como entrada RMIN(expr)
profit,RMIN(prof y muestra el valor mínimo a partir de los
it) from registros encontrados hasta ese
momento.
sales_subject_ar
ea expr es una expresión de cualquier tipo
de dato.

Funciones espaciales
Las funciones espaciales le permiten realizar análisis geográficos al modelar los datos. Por
ejemplo, podría calcular la distancia entre dos áreas geográficas (conocidas como formas o
polígonos).

Nota:
No puede usar estas funciones espaciales en cálculos personalizados para libros
de trabajo de visualización.

Función Ejemplo Descripción Sintaxis

GeometryArea GeometryArea(Shape) Calcula el área que ocupa GeometryArea(Shape)
una forma.

C-19
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

GeometryDista GeometryDistance(TRIP_STA Controla la distancia GeometryDistance(Shape 1,
nce RT, TRIP_END) entre dos formas. Shape 2)
GeometryLeng GeometryLength(Shape) Calcula la circunferencia GeometryLength(Shape)
th de una forma.
GeometryRelat GeometryRelate(TRIP_START Determina si una forma GeometryRelate(Shape 1,
e , TRIP_END) está incluida en otra Shape 2)
forma. Devuelve TRUE o
FALSE como cadena
(varchar).
GeometryWith GeometryWithinDistance(TR Determina si dos formas GeometryWithinDistance(Sh
inDistance IP_START, TRIP_END, 500) están en la distancia ape1, Shape2,
especificada entre sí. DistanceInFloat)
Devuelve TRUE o FALSE
como cadena (varchar).

Funciones de cadena
Las funciones de cadena realizan diversas manipulaciones de caracteres. Actúan en
las cadenas de caracteres.

Función Ejemplo Descripción Sintaxis

ASCII ASCII('a') Convierte una cadena de un solo carácter ASCII(expr)
en el código ASCII correspondiente, entre
0 y 255. Si la expresión de caracteres
evalúa varios caracteres, se devuelve el
código ASCII correspondiente a la
primera letra de la expresión.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
BIT_LENGTH BIT_LENGTH('abcd Devuelve la longitud, en bits, de una BIT_LENGTH(expr)
ef') cadena especificada. Cada carácter
Unicode contiene 2 bytes de longitud
(igual a 16 bits).
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
CHAR CHAR(35) Convierte un valor numérico entre 0 y CHAR(expr)
255 en el valor del carácter
correspondiente en código ASCII.
expr es cualquier expresión que se evalúa
como un valor numérico entre 0 y 255.
CHAR_LENGT CHAR_LENGTH(Cust Devuelve la longitud, en número de CHAR_LENGTH(expr)
H omer_Name) caracteres, de una cadena especificada.
Los espacios iniciales y finales no
cuentan para la longitud de la cadena.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.

C-20
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

CONCAT SELECT DISTINCT Concatena dos cadenas de caracteres. CONCAT(expr1, expr2)
CONCAT ('abc', exprs son expresiones que se evalúan
'def') FROM como cadenas de caracteres separadas
employee por comas.
Debe utilizar datos no procesados, datos
sin formato, con CONCAT.

INSERT SELECT Inserta una cadena de caracteres INSERT(expr1,

INSERT('123456', determinada en una ubicación integer1, integer2,
2, 3, 'abcd') especificada de otra cadena de caracteres. expr2)
FROM table expr1 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena de caracteres de
destino.
integer1 es cualquier entero positivo que
representa el número de caracteres desde
el principio de la cadena de destino en la
que se insertará la segunda cadena.
integer2 es cualquier entero positivo que
representa el número de caracteres de la
cadena de destino que se sustituirá por la
segunda cadena.
expr2 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena de caracteres que se
insertará en la cadena de destino.
LEFT SELECT Devuelve un número de caracteres LEFT(expr, integer)
LEFT('123456', especificado a la izquierda de la cadena.
3) FROM table expr es cualquier expresión que se evalúa
como una cadena de caracteres.
integer es cualquier entero positivo que
representa el número de caracteres de la
parte izquierda de la cadena que se va a
devolver
LENGTH LENGTH(Customer_ Devuelve la longitud, en número de LENGTH(expr)
Name) caracteres, de una cadena especificada.
Se devuelve el tamaño excluyendo los
caracteres finales en blanco.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
LOCATE LOCATE('d' Devuelve la posición numérica de una LOCATE(expr1, expr2)
'abcdef') cadena de caracteres en otra cadena de
caracteres. Si la cadena de caracteres no
se encuentra en la cadena en que se está
buscando, la función devuelve un valor
de 0.
expr1 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena que se va a buscar.
expr2 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena que se va a buscar.

C-21
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

LOCATEN LOCATEN('d' Al igual que LOCATE, devuelve la LOCATEN(expr1, expr2,
'abcdef', 3) posición numérica de una cadena de integer)
caracteres en otra cadena de caracteres.
LOCATEN incluye un argumento de
entero que permite especificar una
posición inicial para empezar la
búsqueda.
expr1 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena que se va a buscar.
expr2 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena que se va a buscar.
integer es cualquier entero positivo (que
no sea cero) que representa la posición
inicial para empezar a buscar la cadena
de caracteres.
LOWER LOWER(Customer_N Pasa a minúsculas una cadena de LOWER(expr)
ame) caracteres.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
OCTET_LENGT OCTET_LENGTH('ab Devuelve el número de bytes de una OCTET_LENGTH(expr)
H cdef') cadena especificada.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
POSITION POSITION('d', Devuelve la posición numérica de POSITION(expr1 IN
'abcdef') strExpr1 en una expresión de caracteres. expr2)
Si no se encuentra strExpr1, la función
devuelve 0.
expr1 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena que se buscará en la
cadena de destino.
expr2 es cualquier expresión que se
evalúa como una cadena de caracteres.
Identifica la cadena de destino que se va
a buscar.
REPEAT REPEAT('abc', 4) Repite una expresión especificada n REPEAT(expr, integer)
veces.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
integer es cualquier entero positivo que
representa el número de veces que se
repetirá la cadena de caracteres.

C-22
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

REPLACE REPLACE('abcd123 Reemplaza uno o más caracteres de una REPLACE(expr1, expr2,
4', '123', 'zz') expresión de caracteres especificada por expr3)
uno o más caracteres.
expr1 es cualquier expresión que se
evalúa como una cadena de caracteres.
Esta es la cadena en la que se sustituirán
los caracteres.
expr2 es cualquier expresión que se
evalúa como una cadena de caracteres.
Esta segunda cadena identifica los
caracteres de la primera cadena que se
sustituirán.
expr3 es cualquier expresión que se
evalúa como una cadena de caracteres.
Esta tercera cadena especifica los
caracteres que se sustituirán en la
primera cadena.
RIGHT SELECT Devuelve un número especificado de RIGHT(expr, integer)
RIGHT('123456', caracteres a la derecha de la cadena.
3) FROM table expr es cualquier expresión que se evalúa
como una cadena de caracteres.
integer es cualquier entero positivo que
representa el número de caracteres de la
parte derecha de la cadena que se va a
devolver.
SPACE SPACE(2) Inserta espacios en blanco. SPACE(expr)
integer es cualquier entero positivo que
indica el número de espacios que se van a
insertar.
SUBSTRING SUBSTRING('abcde Crea una nueva cadena que empieza en SUBSTRING([SourceStri
f' FROM 2) un número fijo de caracteres en la cadena ng] FROM
original. [StartPostition])
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
startPos es cualquier entero positivo que
representa el número de caracteres desde
el inicio de la parte izquierda de la
cadena por donde debe empezar el
resultado.

C-23
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

SUBSTRINGN SUBSTRING('abcde Al igual que SUBSTRING, crea una nueva SUBSTRING(expr FROM
f' FROM 2 FOR 3) cadena que empieza en un número fijo startPos FOR length)
de caracteres en la cadena original.
SUBSTRINGN incluye un argumento de
entero que permite especificar la longitud
de la nueva cadena en número de
caracteres.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
startPos es cualquier entero positivo que
representa el número de caracteres desde
el inicio de la parte izquierda de la
cadena por donde debe empezar el
resultado.
TrimBoth Trim(BOTH '_' Elimina los caracteres iniciales y finales TRIM(BOTH char FROM
FROM '_abcdef_') especificados de una cadena de expr)
caracteres.
char es un carácter cualquiera. Si omite
esta especificación (y las comillas simples
necesarias), se utiliza un carácter en
blanco como valor por defecto.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
TRIMLEADING TRIM(LEADING '_' Elimina los caracteres iniciales TRIM(LEADING char
FROM '_abcdef') especificados de una cadena de FROM expr)
caracteres.
char es un carácter cualquiera. Si omite
esta especificación (y las comillas simples
necesarias), se utiliza un carácter en
blanco como valor por defecto.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
TRIMTRAILIN TRIM(TRAILING Elimina los caracteres finales TRIM(TRAILING char
G '_' FROM especificados de una cadena de FROM expr)
'abcdef_') caracteres.
char es un carácter cualquiera. Si omite
esta especificación (y las comillas simples
necesarias), se utiliza un carácter en
blanco como valor por defecto.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.
UPPER UPPER(Customer_N Pasa a mayúsculas una cadena de UPPER(expr)
ame) caracteres.
expr es cualquier expresión que se evalúa
como una cadena de caracteres.

C-24
 Apéndice C
Funciones

Funciones del sistema

La función del sistema USER devuelve valores relacionados con la sesión. Por ejemplo, el
nombre de usuario con el que se ha conectado.

Función Ejemplo Descripción Sintaxis

DATABASE Devuelve el nombre del área temática a DATABASE()
la que se ha conectado.
USER Devuelve el nombre de usuario para el USER()
modelo semántico al que está conectado.

Funciones de serie temporal

Las funciones de serie temporal son funciones de agregación que se utilizan en las
dimensiones de tiempo.
Los miembros de la dimensión de tiempo deben estar en el nivel de la función o por debajo
de éste. Por este motivo, deben proyectarse una o varias columnas que permiten identificar
de forma exclusiva miembros en un nivel determinado o por debajo de éste en la consulta.

Función Ejemplo Descripción Sintaxis

AGO SELECT Year_ID, Calcula el valor agregado de una medida AGO(expr, time_level,
AGO(sales, year, desde la hora actual hasta un período de offset)
1) tiempo especificado en el pasado. Por
ejemplo, AGO puede producir ventas para
cada mes del trimestre actual y las ventas
correspondientes al trimestre anterior.
PERIODROLLI SELECT Month_ID, Calcula el agregado de una medida a lo PERIODROLLING(measure
NG PERIODROLLING largo del período que comienza por x , x [,y])
(monthly_sales, unidades de tiempo y finaliza por y
unidades de tiempo a partir de la hora
-1, 1)
actual. Por ejemplo, PERIODROLLING
puede calcular las ventas de un período
que empieza en un trimestre anterior al
actual y termina en un trimestre
posterior al actual.
measure es el nombre de una columna de
medidas.
x es un entero que especifica el
desplazamiento con respecto al momento
actual.
y especifica el número de unidades de
tiempo sobre las que se calcula la
función.
hierarchy es un argumento opcional que
especifica el nombre de una jerarquía en
una dimensión de tiempo, como yr, mon,
day, que desea utilizar para calcular el
intervalo de tiempo.

C-25
 Apéndice C
Funciones

Función Ejemplo Descripción Sintaxis

TODATE SELECT Year_ID, Agrega una medida desde el principio de TODATE(expr,
Month_ID, TODATE un período de tiempo especificado hasta time_level)
(sales, year) la hora mostrada actualmente. Por
ejemplo, esta función puede calcular las
ventas de Acumulado Anual.
expr es una expresión que hace
referencia a una columna de medida
como mínimo.
time_level es el tipo de período de tiempo,
como trimestre, mes o año.

Función FORECAST
Crea un modelo de series temporal de la medida especificada sobre las series
mediante el suavizado exponencial (ETS), estacional ARIMA o ARIMA. Esta función
da como resultado una previsión para el conjunto de periodos según se ha
especificado en el argumento numPeriods.
Syntax FORECAST(numeric_expr, ([series]), output_column_name, options,
[runtime_binded_options])])

Donde:
• numeric_expr indica la media de la que realiza la previsión, por ejemplo, los datos
de ingresos de los que realizar la previsión.
• series indica el detalle de tiempo empleado para crear un modelo de previsión. La
serie es una lista de una o más columnas de dimensión de tiempo. Si omite
series, el detalle de tiempo viene determinado por la consulta.
• output_column_name indica los nombres de columna válidos de forecast, low,
high y predictionInterval.
• options indica una cadena con una lista de pares de nombre y valor separados
por puntos y comas (;). El valor puede incluir %1 ... %N especificado en
runtime_binded_options.
• runtime_binded_options indica una lista separada por comas de columnas y
opciones. Los valores de estas columnas y opciones se evalúan y se resuelven
durante el tiempo de ejecución de consultas individuales.
Opciones de la función FORECAST En la siguiente tabla se muestran las opciones
disponibles que se pueden usar con la función FORECAST.

Nombre de la opción Valores Descripción

numPeriods Entero Número de períodos del que
realizar la previsión
predictionInterval De 0 a 100, donde los valores Nivel de confianza para la
superiores especifican una mayor predicción.
confianza
modelType ETS Modelo que utilizar para la
SeasonalArima previsión.
ARIMA

C-26
 Apéndice C
Funciones

Nombre de la opción Valores Descripción

useBoxCox TRUE Si es TRUE, utilice la
FALSE transformación Box-Cox.

lambdaValue No se aplica Parámetro de transformación Box-

Cox.
Ignore si el valor es NULL o
cuando el valor de useBoxCox sea
FALSE.
De lo contrario, los datos se
transforman antes de estimar el
modelo.
trendDamp TRUE Es un parámetro para el modelo
FALSE ETS.
Si el valor es TRUE, utilice la
tendencia desechada. Si el valor es
FALSE o NULL, utilice la tendencia
no desechada.
errorType No se aplica Es un parámetro para el modelo
ETS.
trendType N (ninguno) Es un parámetro para el modelo
A (aditivo) ETS.
M (multiplicativo)
Z (seleccionado automáticamente)
seasonType N (ninguno) Es un parámetro para el modelo
A (aditivo) ETS.
M (multiplicativo)
Z (seleccionado automáticamente)
modelParamIC ic_auto Criterios de información (IC)
ic_aicc usados en la selección de modelo.
ic_bic
ic_auto (es el valor por defecto)

Ejemplo de previsión de ingresos por día

En este ejemplo se selecciona la previsión de ingresos por día.
FORECAST("A - Sample Sales"."Base Facts"."1- Revenue" Target,
("A - Sample Sales"."Time"."T00 Calendar Date"),'forecast',
'numPeriods=30;predictionInterval=70;') ForecastedRevenue

Ejemplo de previsión de ingresos por año y trimestre

En este ejemplo se selecciona la previsión de ingresos por año y trimestre.
FORECAST("A - Sample Sales"."Base Facts"."1- Revenue",
("A - Sample Sales"."Time"."T01 Year" timeYear, "A - Sample Sales"."Time"."T02
Quarter" TimeQuarter),'forecast', 'numPeriods=30;predictionInterval=70;')
ForecastedRevenue

C-27
 Apéndice C
Constantes

Constantes
Puede usar constantes para incluir fechas y horas específicas en las expresiones.
Entre las constantes disponibles se incluyen Date, Time y Timestamp.

Constante Ejemplo Descripción Sintaxis

DATE DATE Inserta una fecha específica. DATE [yyyy-mm-dd]
[2014-04-09]
TIME TIME [12:00:00] Inserta una hora específica. TIME [hh:mi:ss]
TIMESTAMP TIMESTAMP Inserta un registro de hora específico. TIMESTAMP [yyyy-mm-
[2014-04-09 dd hh:mi:ss]
12:00:00]

Tipos
Puede utilizar tipos de dato, como CHAR, INT y NUMERIC en las expresiones.

Por ejemplo, puede utilizar tipos al crear expresiones CAST que cambien el tipo de
dato de una expresión o un literal nulo a otro tipo de dato.

Variables
Las variables se utilizan en expresiones.
Puede utilizar una variable en una expresión.
Consulte Técnicas avanzadas: referencia a valores almacenados en variables.

C-28