Implementa los bloques de Looker

En esta página, se describen los pasos para instalar un bloque de Looker prediseñado para Cortex Framework que se encuentra en un repositorio público de GitHub, como los siguientes:

Para implementar el panel de Looker para Dun & Bradstreet, consulta Panel de Data Studio para Dun & Bradstreet.

Requisitos previos

Para acceder a estos paneles prediseñados y usarlos, primero debes hacer lo siguiente:

Implementar Cortex Framework: Asegúrate de que Cortex Framework esté configurado con tus fuentes de datos. Para obtener más información, consulta los requisitos previos de Cortex Framework para la implementación.
Acceder a Looker: Accede a Looker y familiarízate con la plataforma.
Explorar los paneles disponibles: Explora los paneles prediseñados y las estadísticas disponibles en el panel que deseas implementar. Para obtener más información, consulta los bloques de Looker disponibles.

Después de completar los requisitos previos, podrás instalar tu bloque de Looker.

Instalación

Los bloques de Looker usan LookML (lenguaje de modelado de Looker) para definir el modelo semántico de los paneles de Looker. Para instalar el modelo de LookML que corresponde a tu fuente de datos de Cortex, usa una de las siguientes opciones:

Opción A: Instala a través de Looker Marketplace desde una URL de Git.
Opción B: Instala bifurcando el repositorio.

En las siguientes secciones, se describen los pasos para cada opción.

Opción A: Instala a través de Looker Marketplace desde una URL de Git

El Looker Marketplace es una ubicación central dentro de Looker para encontrar, implementar y administrar bloques de Looker, aplicaciones, visualizaciones y complementos. Para instalar a través de Looker Marketplace desde una URL de Git, sigue estos pasos:

Ve a tu instancia de Looker.
Haz clic en el botón Marketplace en la barra de menú de Looker .
En el menú Marketplace, selecciona la opción Administrar.
En la página Administrar, selecciona el menú de tres puntos Opciones .
Selecciona el botón Instalar a través de la URL de Git.
Ingresa la URL y el SHA de confirmación del repositorio elegido:
Haz clic en Instalar.
Acepta y continúa en el diálogo de términos y condiciones.
Ingresa los parámetros obligatorios que corresponden a tus datos:
- Nombre de la conexión
- ID del proyecto
- Conjunto de datos de informes
Haz clic en Instalar.

Para obtener más información, consulta la documentación de Looker para instalar una herramienta desde una URL de Git.

Opción B: Instala bifurcando el repositorio

Para instalar bloques de Looker bifurcando el repositorio, sigue estos pasos:

Bifurca el repositorio de GitHub:
1. Navega al repositorio de GitHub del bloque de Looker elegido:
2. Haz clic en Bifurcar en la esquina superior derecha del repositorio.
3. Crea una bifurcación con tu nombre de usuario. Esto crea una copia del repositorio en tu cuenta de GitHub.
Crea un proyecto de LookML en blanco:

Nota: Para las versiones de Looker anteriores a la 24.20, consulta Cómo crear un proyecto en blanco desde la página Nuevo proyecto-
1. Verifica que estés en el modo de desarrollo.
2. Selecciona Proyectos en el menú Desarrollo.
3. En la parte superior izquierda de la página Proyectos de LookML, selecciona Configurar modelo nuevo para abrir la página Configurar un modelo.
4. En la página Configurar un modelo, especifica las opciones de tu modelo:
  1. Modelo: Asigna a tu modelo el mismo nombre del archivo model.lkml en el repositorio. Por ejemplo, asigna el nombre al modelo cortex-<datasource>.
    
    Nota: Looker aplica nombres de modelos únicos. Si ya existe un modelo con el nombre deseado, se mostrará un mensaje de error. Asegúrate de que el nombre del modelo sea único para evitar fallas en la instalación.
  2. Proyecto: Asigna un nombre a tu proyecto. Puedes asignarle el mismo nombre que el modelo o especificar un nombre diferente.
  3. Conexiones permitidas: Especifica qué conexiones de base de datos puede usar el modelo o especifica que el modelo puede usar cualquier conexión actual o futura.
5. Haz clic en Guardar para guardar el proyecto como un proyecto pendiente.
6. En la página Proyectos de LookML, busca el proyecto nuevo en la sección Proyectos pendientes.
7. Haz clic en Agregar LookML para abrir la página Nuevo proyecto.
8. En la página Nuevo proyecto, especifica las opciones para tu proyecto:
  1. Nombre del proyecto: Ya se propagó con el valor especificado en el paso anterior.
  2. Punto de partida: Selecciona Proyecto en blanco.
9. Selecciona Crear proyecto. Looker crea el proyecto y lo abre en el IDE de Looker.
Para obtener más información, consulta la documentación original de Looker para generar un modelo de LookML.
Conecta el nuevo proyecto de LookML al repositorio bifurcado: Sigue los pasos de la documentación de Looker para configurar y probar una conexión de Git.
Actualiza los valores de las constantes en el archivo manifest.lkml:
1. Abre el archivo manifest.lkml en tu repositorio bifurcado en Looker.
2. Busca la sección de constantes y actualiza los valores como se describe en la sección Parámetros obligatorios.
Confirma los cambios y realiza la implementación en producción. Con el proyecto de Looker basado en tu repositorio bifurcado, puedes personalizar LookML para que se adapte a tus necesidades empresariales únicas. Sigue los pasos que se indican en Cómo implementar tus cambios en producción.

Parámetros obligatorios

Estos valores obligatorios se configuran durante el proceso de instalación de Marketplace. Si este bloque se instaló desde un repositorio de Git bifurcado, debes actualizar los valores de estas constantes en el archivo manifest.lkml del proyecto.

<th">Parámetro <th">Valor <th">Descripción <th">Bloques de Looker </th"></th"></th"></th"><td"> Connection Name <td"> Nombre de la conexión <td">Es el nombre de la conexión de BigQuery que permite a Looker consultar el conjunto de datos REPORTING de Cortex. debe estar habilitado. <td">Todos </td"></td"></td"></td"><td"> Project ID <td"> ID del proyecto <td">Es el Google Cloud proyecto en el que reside el conjunto de datos de informes en BigQuery. Para obtener más información, consulta Identificación de proyectos. <td">Todos </td"></td"></td"></td"><td"> Reporting Dataset <td">Nombre del conjunto de datos para los informes <td">Es el conjunto de datos REPORTING de Cortex Data Foundation implementado en el que residen las vistas del conjunto de datos de la fuente de datos dentro del Google Cloud proyecto de BigQuery. Según la configuración de implementación de Cortex Data Foundation, el nombre de este conjunto de datos suele tener el patrón que termina con _REPORTING. <td">Todos </td"></td"></td"></td"><td"> Client <td"> Número de cliente de SAP (mandt) <td">Es el número de cliente de SAP (mandt) que se usará para los informes. <td">SAP </td"></td"></td"></td"><td"> Sign Change <td"> Yes o No <td">Para los informes de estado de resultados o de pérdidas y ganancias, los ingresos suelen mostrarse en el libro mayor como un número negativo, lo que indica un crédito. Si estableces el valor de Sign Change en Yes, se muestra como un número positivo en los informes de estado de resultados. <td">SAP </td"></td"></td"></td">

Requisitos adicionales específicos del bloque

Algunos bloques tienen requisitos específicos para su implementación. Para obtener más información, consulta la implementación específica del bloque:

<th">Bloque <th">Vínculo a los requisitos adicionales </th"></th"><td"> SAP <td">Especificaciones adicionales para el bloque de Looker de Cortex Framework para SAP. </td"></td"><td"> Oracle EBS <td">Especificaciones adicionales para el bloque de Looker de Cortex Framework para Oracle EBS. </td"></td">

Recursos adicionales

Para obtener más información sobre LookML, consulta la siguiente documentación y capacitación: