Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Implementa bloques de Looker
En esta página, se describen los pasos para instalar un bloque de Looker precompilado para Cortex Framework ubicado en un repositorio público de GitHub, como los siguientes:
Accede a Looker: Accede a Looker y familiarízate con la plataforma.
Explora los paneles disponibles: Explora los paneles precompilados y las estadísticas disponibles en el panel que deseas implementar. Para obtener más información, consulta Bloques de Looker disponibles.
Después de completar los requisitos previos, estarás listo para 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 desde una URL de Git a través de Looker Marketplace.
Opción B: Instala el repositorio a través de un forking.
En las siguientes secciones, se describen los pasos para cada opción.
Opción A: Instala desde Looker Marketplace a través de una URL de Git
Looker Marketplace es una ubicación central dentro de Looker para encontrar, implementar y administrar bloques, aplicaciones, visualizaciones y complementos de Looker. Para instalar desde 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 storefront.
En el menú Mercado, selecciona la opción Administrar.
En la página Administrar, selecciona el menú de tres puntos Opcionesmore_vert.
Selecciona el botón Install via Git URL.
Ingresa la URL y confirma el SHA del repositorio elegido:
En la parte superior izquierda de la página LookML Projects, selecciona Configure New Model para abrir la página Configure a Model.
En la página Configurar un modelo, especifica las opciones de tu modelo:
Model: Asigna un nombre a tu modelo con el mismo nombre del archivo model.lkml en el repositorio. Por ejemplo, asígnale el nombre cortex-<datasource> al modelo.
Project: Asigna un nombre a tu proyecto. Asócialo con el mismo nombre que el del modelo o especifica uno diferente.
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.
Haz clic en Guardar para guardar el proyecto como Proyecto pendiente.
En la página Proyectos de LookML, busca el proyecto nuevo en la sección Proyectos pendientes.
Haz clic en Agregar LookML para abrir la página Nuevo proyecto.
En la página Proyecto nuevo, especifica las opciones para tu proyecto:
Nombre del proyecto: Ya se propagó con el valor especificado en el paso anterior.
Punto de partida: Selecciona Proyecto en blanco.
Selecciona Crear proyecto. Looker crea el proyecto y lo abre en el IDE de Looker.
Actualiza los valores de las constantes en el archivo manifest.lkml:
Abre el archivo manifest.lkml en tu repositorio bifurcado en Looker.
Busca la sección de constantes y actualiza los valores como se describe en la sección Parámetros obligatorios.
Confirma y, luego, implementa los cambios en producción. Con el proyecto de Looker basado en tu repositorio bifurcado, puedes personalizar el LookML para que se adapte a tus necesidades empresariales únicas. Sigue los pasos que se indican en Cómo enviar tus cambios a producción.
Parámetros obligatorios
Estos valores obligatorios se configuran durante el proceso de instalación del mercado o 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.
Parámetro
Valor
Descripción
Bloques de Looker
Connection Name
Nombre de la conexión
Es el nombre de la conexión de BigQuery que permite que Looker consulte el conjunto de datos de Cortex REPORTING.
debe estar habilitado.
Todos
Project ID
ID del proyecto
El Google Cloud proyecto en el que reside el conjunto de datos de informes en BigQuery Para obtener más información, consulta Identifica proyectos.
Todos
Reporting Dataset
Es el nombre del conjunto de datos para los informes.
El conjunto de datos de REPORTING de Cortex Data Foundation que se implementó, en el que las vistas de conjuntos de datos de la fuente de datos residen en el proyecto Google Cloud 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.
Todos
Client
Número de cliente de SAP (mandt)
Es el número de cliente de SAP (mandt) que se usará para los informes.
SAP
Sign Change
Yes o No
En el caso de los informes 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 Cambio de signo en Yes, se mostrará como un número positivo en los informes del estado de resultados.
SAP
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:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eThis guide outlines how to install prebuilt Looker blocks for Cortex Framework from public GitHub repositories, such as those for SAP, Salesforce, Oracle EBS, Meta, and YouTube.\u003c/p\u003e\n"],["\u003cp\u003eBefore installing Looker Blocks, ensure Cortex Framework is deployed, you have access to Looker, and you have explored the available dashboards.\u003c/p\u003e\n"],["\u003cp\u003eInstallation can be performed either through the Looker Marketplace using a Git URL or by forking the desired repository and connecting it to a new LookML project.\u003c/p\u003e\n"],["\u003cp\u003eThe installation process requires specifying parameters like the Connection Name, Project ID, and Reporting Dataset, which can be configured during Marketplace installation or within the \u003ccode\u003emanifest.lkml\u003c/code\u003e file when forking.\u003c/p\u003e\n"],["\u003cp\u003eSome blocks, such as SAP and Oracle EBS, have specific deployment requirements detailed in their respective documentation pages.\u003c/p\u003e\n"]]],[],null,["# Deploy Looker Blocks\n====================\n\nThis page describes the steps for installing a prebuilt Looker\nblock for Cortex Framework located in a public GitHub repository, such as:\n\n- [SAP for Cortex](https://github.com/looker-open-source/block-cortex-sap)\n- [Salesforce Sales Cloud (SFDC) for Cortex](https://github.com/looker-open-source/block-cortex-salesforce)\n- [Oracle EBS for Cortex](https://github.com/looker-open-source/block-cortex-oracle-ebs)\n- [Salesforce Marketing Cloud (SFMC) for Cortex](https://github.com/looker-open-source/block-cortex-sfmc)\n- [Meta for Cortex](https://github.com/looker-open-source/block-cortex-meta)\n- [YouTube (with DV360) for Cortex](https://github.com/looker-open-source/block-cortex-youtube)\n- [Cross Media \\& Product Connected Insights for Cortex](https://github.com/looker-open-source/block-cortex-cross-media)\n\nFor deploying the Looker Dashboard for Dun \\& Bradstreet,\nsee [Looker Studio Dashboard for Dun \\& Bradstreet](/cortex/docs/looker-dashboard-dun-and-bradstreet).\n\nPrerequisites\n-------------\n\nTo access and use these pre built dashboards, you need to priorly do the\nfollowing:\n\n1. **Deploy Cortex Framework** : Ensure you have Cortex Framework set up and configured with your data sources. For more information, see [Cortex Framework prerequisites for deployment](/cortex/docs/deployment-prerequisites).\n2. **Access Looker:** Access Looker and get familiar with the platform.\n3. **Explore available dashboards** : Explore the prebuilt dashboards and the available insights in the dashboard you would like to deploy. For more information, see [Available Looker Blocks](/cortex/docs/looker-block-overview).\n\nAfter completing the prerequisites, you are ready to install your\nLooker Block.\n\nInstallation\n------------\n\nLooker Blocks use [LookML](/looker/docs/what-is-lookml)\n(Looker Modeling Language) to define the semantic model for\nthe Looker dashboards. To install the LookML Model that\ncorresponds to your Cortex data source, use one of the following options:\n\n- **Option A**: Install through Looker Marketplace from a Git URL.\n- **Option B**: Install by forking the repository.\n\nThe following sections describe the steps for each option.\n\n### Option A: Install through Looker Marketplace from a Git URL\n\nThe [Looker Marketplace](/looker/docs/marketplace) is a central\nlocation within Looker for finding, deploying, and managing\nLooker Blocks, applications, visualizations, and plug-ins. To\ninstall through Looker Marketplace from a Git URL, follow these steps:\n\n1. Go to your Looker instance.\n2. Click the **Marketplace** button on the Looker menu bar storefront.\n3. From the Marketplace menu, select the **Manage** option.\n4. On the **Manage** page, select the three-dot **Options** menu more_vert.\n5. Select **Install via Git URL** button.\n6. Enter the URL and commit SHA of the chosen repository:\n - [SAP for Cortex](https://github.com/looker-open-source/block-cortex-sap)\n - [Salesforce Sales Cloud (SFDC) for Cortex](https://github.com/looker-open-source/block-cortex-salesforce)\n - [Oracle EBS for Cortex](https://github.com/looker-open-source/block-cortex-oracle-ebs)\n - [Salesforce Marketing Cloud (SFMC) for Cortex](https://github.com/looker-open-source/block-cortex-sfmc)\n - [Meta for Cortex](https://github.com/looker-open-source/block-cortex-meta)\n - [YouTube (with DV360) for Cortex](https://github.com/looker-open-source/block-cortex-youtube)\n - [Cross Media \\& Product Connected Insights for Cortex](https://github.com/looker-open-source/block-cortex-cross-media)\n7. Click **Install**.\n8. Agree and Continue at the terms and conditions dialog.\n9. Enter the [required parameters](#required_parameters) that corresponds to your data:\n - Connection Name\n - Project ID\n - Reporting Dataset\n10. Click **Install**.\n\nFor more information, see the Looker documentation for\n[Installing a Tool from a Git URL.](/looker/docs/marketplace#installing_a_tool_from_a_git_url)\n\n### Option B: Install by forking the repository\n\nTo install Looker blocks by forking the repository, follow these steps:\n\n1. **Fork the GitHub repository**:\n\n 1. Navigate to the GitHub repository for the chosen Looker Block:\n - [SAP for Cortex](https://github.com/looker-open-source/block-cortex-sap)\n - [Salesforce Sales Cloud (SFDC) for Cortex](https://github.com/looker-open-source/block-cortex-salesforce)\n - [Oracle EBS for Cortex](https://github.com/looker-open-source/block-cortex-oracle-ebs)\n - [Salesforce Marketing Cloud (SFMC) for Cortex](https://github.com/looker-open-source/block-cortex-sfmc)\n - [Meta for Cortex](https://github.com/looker-open-source/block-cortex-meta)\n - [YouTube (with DV360) for Cortex](https://github.com/looker-open-source/block-cortex-youtube)\n - [Cross Media \\& Product Connected Insights for Cortex](https://github.com/looker-open-source/block-cortex-cross-media)\n 2. Click **Fork** in the top-right corner of the repository.\n 3. Create a fork with your username. This creates a copy of the repository in your GitHub account.\n2. **Create a blank LookML project**:\n\n | **Note:** For Looker versions prior to 24.20, see [Creating a Blank Project](/looker/docs/create-projects#creating_a_blank_project) from the [New Project Page](/looker/docs/create-projects)-\n 1. [Verify that you are in Development Mode](/looker/docs/dev-mode-prod-mode#switching_in_and_out_of_development_mode).\n 2. Select **Projects** from the **Develop** menu.\n 3. From the top left of the **LookML Projects** page, select\n **Configure New Model** to open the **Configure a Model** page.\n\n 4. On the **Configure a Model** page, specify the options for your model:\n\n 1. **Model** : Name your model with the same name of\n the `model.lkml` file in the repository. For example, name the\n model `cortex-\u003cdatasource\u003e`.\n\n | **Note:** Looker enforces unique model names. If a model with the intended name already exists, an error message will be displayed. Ensure model name uniqueness to avoid installation failures.\n 2. **Project**: Name your project. Either name it the same as the\n model or specify a different name.\n\n 3. **Allowed Connections:** Specify which database connections can\n be used by the model, or specify that the model is allowed to use\n any current or future connections.\n\n 5. Click **Save** to save the project as a **Pending Project**.\n\n 6. From the **LookML Projects** page, locate the new project under the\n **Pending Projects** section.\n\n 7. Click **Add LookML** to open the **New Project** page.\n\n 8. On the New Project page, specify the options for your project:\n\n 1. **Project Name**: Already populated with value specified in prior step.\n 2. **Starting Point** : Select **Blank Project**.\n 9. Select **Create Project** . Looker creates the project\n and opens it in the [Looker IDE](/looker/docs/looker-ide).\n\n For more information, see the original Looker documentation\n for [Generating a LookML model](/looker/docs/generating-a-model).\n3. **Connect the new LookML project to the forked repository** : Follow the\n steps in the Looker documentation,\n [Setting up and testing a Git connection](/looker/docs/setting-up-git-connection).\n\n4. **Update the values of constants in the `manifest.lkml` file**:\n\n 1. Open the `manifest.lkml` file in your forked repository in Looker.\n 2. Locate the constants section and update the values as described in the [Required parameters](#required_parameters) section.\n5. **Commit and deploy changes to production** . With the\n Looker project based on your forked repository, you can customize\n the LookML to fit your unique business needs. Follow the steps in\n [Getting your changes to production](/looker/docs/version-control-and-deploying-changes#getting_your_changes_to_production).\n\n### Required parameters\n\nThese required values are configured during the Marketplace Installation process\nor if this Block was installed from a forked Git repository, you need to\nupdate the values for these constants in the `manifest.lkml` file for the project.\n\n### Additional block-specific requirements\n\nSome blocks have specific requirements for its deployment. For more information,\nsee the block-specific deployment:\n\nExtra Resources\n---------------\n\nFor more information about LookML, see the following documentation and training:\n\n- [Looker Best Practices](/looker/docs/best-practices/home)\n- [Looker Google Cloud Training](https://www.cloudskillsboost.google/catalog?keywords=looker&locale=&skill-badge%5B%5D=any&format%5B%5D=any&language%5B%5D=any)"]]
