Validación de contenido

El Validador de contenido busca en LookML el modelo, la exploración y los nombres de los campos a los que se hace referencia en tu contenido de Looker. Es una herramienta útil para validar tus referencias de LookML, corregir errores en LookML después de realizar cambios y actualizar los nombres de los elementos de LookML en tu proyecto.

Debes tener el permiso develop para usar el Validador de contenido.

Para abrir el Validador de contenido, selecciona Validador de contenido en el menú Desarrollar del panel de navegación izquierdo. Desde aquí, puedes usar el Validador de contenido de dos maneras:

Antes de usar el validador de contenido

Debes tener mucho cuidado cuando realices cambios con la validación de contenido. El validador de contenido no tiene una función para deshacer cambios y puede afectar muchos aspectos de los diseños y paneles, junto con sus vínculos Explorar desde aquí. Si cometes un error, debes intentar corregirlo lo antes posible, antes de que los cambios adicionales hagan que sea más difícil aislar las vistas afectadas.

Además, ten en cuenta el tiempo cuando uses el validador de contenido. Cuando envíes los cambios de desarrollo a producción, debes corregir los diseños y las tarjetas afectados aproximadamente al mismo tiempo para que estén inactivos durante el menor tiempo posible. Si corriges las Vistas y los mosaicos demasiado pronto en función de tu trabajo en Modo de desarrollo, los usuarios no los verán hasta que envíes los cambios. Del mismo modo, si demoras en corregir los diseños y las tarjetas hasta mucho tiempo después de enviar los cambios, los usuarios verán que los diseños y las tarjetas están dañados hasta que los corrijas.

Cómo usar el Validador de contenido para corregir errores

El Validador de contenido es una herramienta útil para encontrar y corregir errores resultantes de cambios en tu LookML. Por ejemplo, si cambias el nombre de un campo de customer a user, ya no funcionarán los elementos de diseño ni las tarjetas del panel que incluyan el campo customer (a menos que hayas usado el parámetro alias). El Validador de contenido enumerará todas las referencias al campo customer y proporcionará una manera fácil de corregir el error.

Cuando ejecutas el validador de contenido, este valida todas las referencias que tus diseños y paneles hacen a tus modelos, exploraciones, vistas y campos de LookML, y muestra un error para las referencias que tu contenido hace a un objeto de LookML desconocido.

El validador de contenido no muestra errores para lo siguiente:

  • Contenido para el que no tienes permiso develop El Validador de contenido se limita a tus permisos, por lo que solo puedes usarlo en el contenido para el que tienes el permiso develop (los modelos que puedes ver en el IDE de Looker). Consulta la página de documentación de Funciones para obtener información sobre los permisos de modelo.
  • Las vistas que se borraron y están en la Papelera. Si quieres validar una vista borrada, primero el administrador de Looker debe restablecerla.

Cómo ejecutar el validador de contenido

Para validar tu LookML con el Validador de contenido, sigue estos pasos:

  1. Haz clic en Validate.
  2. Selecciona las pestañas Agrupar por para cambiar cómo se agrupan los errores:
    • Error: Enumera cada error y agrupa el contenido de Looker que tiene el error. Esto es útil si quieres corregir el mismo error en varios elementos de contenido a la vez.
    • Carpeta: Muestra cada carpeta y agrupa el contenido de Looker que tiene errores. Esto es útil si quieres corregir solo los errores de una carpeta en particular.
    • Contenido: Enumera cada elemento de contenido que tenga errores y agrúpalos. Esto es útil si quieres corregir todos los errores en un solo aspecto, tarjeta, filtro, etcétera.
  3. Si estás en Modo de desarrollo, Looker mostrará un mensaje de advertencia. Es importante comprender las implicaciones de cambiar los aspectos y las tarjetas. Si los "corriges" antes de que se publiquen los cambios, habrá un período en el que la corrección será prematura, por lo que los usuarios verán tarjetas o diseños dañados. El mensaje de advertencia te ayuda a recordarlo.
  4. En la tabla de errores, se muestra cualquier error, junto con una lista de Vistas y mosaicos que contienen el error, además del modelo subyacente y la Exploración que producen el error. Puedes usar las pestañas Agrupar por en la parte superior derecha de la página para cambiar el diseño de la tabla de errores.
  5. Looker proporciona los botones Reemplazar o Quitar para cada fila, según el tipo de error. Estos botones proporcionan funcionalidad para corregir los errores y se describen con más detalle en Cómo usar el validador de contenido para corregir errores.

Visualiza los resultados de la validación de contenido

Los resultados de la validación de contenido muestran contenido de Looker que usa nombres de modelos, nombres de Explorar, nombres de vistas o nombres de campos que no existen o no se pueden encontrar. Consulta la sección Cómo usar el validador de contenido para corregir errores para obtener detalles sobre los elementos de LookML que el validador de contenido puede encontrar y validar.

El ícono junto al nombre del contenido identifica el tipo de contenido:

  • Ícono de tarjeta en el panel.: Tarjeta del panel
  • Ícono de alerta en el panel.: Alerta del panel
  • Ícono de Programar en el panel o Programar en la vista: Programa un panel o una vista
  • Ícono de filtro en el panel.: Filtra un panel o un campo en una tarjeta que escuche un filtro de panel (consulta la página de documentación Agrega y edita filtros de panel definidos por el usuario para obtener información sobre cómo configurar tarjetas para que escuchen los filtros de panel).

Los resultados de la validación se basan en el LookML que está disponible en el modo en el que te encuentras cuando ejecutas el validador. Si estás en modo de producción, los resultados de la validación reflejarán todo LookML que se envió a producción. Si estás en Modo de desarrollo, los resultados de la validación reflejarán tu LookML guardado, incluso si no se envió a producción.

Los errores pueden deberse a cambios intencionales en LookML, así como a un error tipográfico o a una unión faltante.

Para ajustar los errores, puedes usar los botones Replace y Remove en cada línea de la tabla de errores de la siguiente manera:

  • Reemplazar: Looker proporciona el botón Reemplazar para cada error (consulta la sección Reemplazar nombres por campos, vistas, Exploraciones y modelos más adelante en esta página para descubrir cómo reemplazar nombres con el Validador de contenido).
  • Quitar: Para los errores con nombres de campo en la sección Datos de una vista o un mosaico, Looker también muestra el botón Quitar (consulta la sección Quita el nombre de un campo más adelante en esta página para saber cómo quitar nombres con el Validador de contenido).

Según la configuración de Agrupar por, los botones se aplicarán a un solo elemento (aspecto o tarjeta) o a varios:

  • Si agrupas por Error, los botones se aplicarán a todas las instancias de ese error en todos los looks y tarjetas de tu instancia de Looker, lo que te permitirá corregir todas las instancias en una sola operación.
  • Si agrupas por Carpeta o por Contenido, los botones se aplicarán a una ocurrencia del error en un solo aspecto o tarjeta, lo que te permite considerar cada ocurrencia del error por separado.

Por ejemplo, una tabla de errores se agrupa por Error y muestra tres instancias de contenido con una exploración desconocida llamada customers. La acción que se proporciona para los tres elementos de contenido es Replace. Si haces clic en Replace, se verán afectadas las tres instancias de contenido con el error 3 x Unknown explore 'customers'.

En algunos casos, es posible que haya varios errores en el contenido. Por ejemplo, una tabla de errores se agrupa por Contenido y muestra un contenido llamado Detalles del pedido. Se muestran cuatro errores Unknown field en la columna Errores, y cada error tiene sus propios botones de acción Reemplazar y Quitar en la columna Acciones.

Además, si agrupas por Contenido, tienes la opción adicional de borrar las vistas.

Reemplaza los nombres de los campos, las vistas, las exploraciones y los modelos

Los resultados de la validación de contenido incluyen un botón Reemplazar para los siguientes tipos de elementos a fin de poder cambiarles el nombre:

Para cualquiera de estos errores, puedes usar el Validador de contenido para reemplazar un atributo del contenido que sea igual o más general que el atributo que genera el error:

  • Si un campo tiene errores, puedes reemplazarlo o quitarlo, o bien reemplazar la vista, Explorar o el nombre del modelo.
  • Si hay un error en el nombre de una exploración, puede reemplazar el nombre de la exploración o el del modelo.
  • Si un nombre de modelo tiene errores, puedes reemplazarlo.

A continuación, se muestra cómo usar el Validador de contenido para reemplazar los nombres de los elementos en tu modelo:

  1. Haz clic en Validar para ejecutar el validador de contenido.
  2. Selecciona un parámetro de configuración Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para poder ajustar varios elementos al mismo tiempo.

  3. En la tabla de errores, haz clic en el botón Reemplazar junto al error que deseas corregir para abrir el diálogo Actualizar en el contenido.

  4. En la sección Tipo (Type) del diálogo Actualizar en el contenido (Update in Content), selecciona el tipo de elemento de LookML que quieres cambiar: campo, vista, Explorar o modelo. Looker muestra las opciones adecuadas para cada error.

  5. En la sección Nombre, verifica el nombre del elemento que deseas reemplazar. El Validador de contenido completa esta información automáticamente.

  6. En la sección Nombre de reemplazo, ingresa el nombre nuevo del elemento.

  7. Si agrupó según Error y varios elementos se verán afectados, haga clic en Mostrar contenido para ver una lista de los elementos que actualizará el Validador de contenido.

  8. De forma opcional, puedes borrar las casillas de verificación junto a los elementos de la lista para que sus nombres no cambien.

  9. Para realizar el cambio, haz clic en Reemplazar.

Quita el nombre de un campo

En el caso de los errores con nombres de campos en la sección Datos de un aspecto o una tarjeta, la tabla de errores proporcionará un botón Quitar a la derecha del error. Puedes usar el validador de contenido para quitar los campos que tengan las siguientes características:

  • En la sección Datos de una vista o un mosaico del panel
  • Se hace referencia a ellos en las configuraciones de visualización, como el área Personalizaciones de la pestaña Serie para los gráficos de columnas.
  • Una tarjeta de panel hace referencia a él para escuchar un filtro de panel (se configura en la pestaña Tiles to Update de la ventana de configuración del filtro, que se describe en la página de documentación Agregar y editar filtros de panel definidos por el usuario).

No puedes usar el Validador de contenido para quitar campos de los filtros personalizados, los campos personalizados ni los cálculos de tablas, ya que, por lo general, debes realizar cambios adicionales para que la expresión siga funcionando. En su lugar, usa los mensajes de error de la validación de contenido para encontrar lugares en los que los filtros personalizados, los campos personalizados y las expresiones de cálculo de tablas deben corregirse y, luego, vuelve a procesar la expresión según corresponda.

  1. Haz clic en Validar para ejecutar el validador de contenido.
  2. Selecciona un parámetro de configuración Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para ajustar varios elementos (aspectos, tarjetas o ambos) al mismo tiempo.

  3. En la tabla de errores, haz clic en Remove junto al error de campo que deseas corregir para abrir el diálogo Remove Field from Content.

  4. En la sección Campo del diálogo Quitar campo del contenido, verifica el nombre del elemento que deseas quitar. El Validador de contenido lo completará automáticamente.

  5. Si agrupaste los elementos por Error y hay varios (aspectos, tarjetas o ambos), puedes hacer clic en Mostrar contenido para ver una lista de los elementos que actualizará el Validador de contenido.

  6. De manera opcional, puedes borrar las casillas de verificación junto a cualquier aspecto o tarjeta para que sus nombres no cambien.

  7. Haz clic en Quitar campo para realizar el cambio.

Cómo borrar looks

Si agrupas la tabla de errores por Contenido, tienes la opción de borrar las vistas en la tabla.

Sigue estos pasos para usar el Validador de contenido y borrar las vistas:

  1. Haz clic en Validar para ejecutar el validador de contenido.
  2. Agrupa la tabla por Contenido.
  3. En la tabla de errores, haz clic en el cuadro Seleccionar junto a la vista que deseas borrar.
  4. Haz clic en Borrar todos los aspectos seleccionados.
  5. Haz clic en Aceptar en el cuadro de confirmación para borrar los looks seleccionados.

Cómo usar el Validador de contenido para buscar y reemplazar

El Validador de contenido también se puede usar para buscar y reemplazar los nombres de modelos, Exploraciones y campos. Por ejemplo, puedes decidir que prefieres un campo en lugar de otro y quieres hacer ese reemplazo en tu proyecto, aunque no haya errores. La lista completa de elementos que el Validador de contenido puede buscar o reemplazar se proporciona en la sección Reemplazo de nombres de campos, vistas, Exploraciones y modelos.

Sigue estos pasos para usar el Validador de contenido como herramienta para buscar y reemplazar:

  1. En la pantalla Validador de contenido, haz clic en Buscar y Reemplaza en Todo el contenido para abrir el diálogo Actualizar en el contenido.
  2. Selecciona el Tipo de elemento de LookML que quieres cambiar (campo, vista, Explorar o modelo).
  3. Ingresa el Nombre del elemento que quieres reemplazar.
  4. Ingresa un Nombre de reemplazo para el campo, la vista, Explorar o el modelo.
  5. Haz clic en Reemplazar (Replace) para realizar el cambio.

Aspectos para tener en cuenta

Planifica volver a ejecutar la validación de contenido para ver los resultados de las correcciones que realices.

Ten en cuenta lo siguiente sobre el Validador de contenido:

  • Puedes cambiar sus nombres para las vistas, las Exploraciones o los modelos, pero no puedes quitarlos por completo. Consulta la sección Cómo quitar el nombre de un campo para obtener una lista de los elementos que se pueden quitar con el Validador de contenido.
  • Los cálculos de tablas solo pueden hacer referencia a campos que se incluyen en la consulta de un aspecto o mosaico. Esto significa que, si quitas un campo de la consulta de un aspecto o una tarjeta, pero un cálculo de tabla sigue usando ese campo, recibirás un nuevo error de validación de contenido.
  • No se validarán las vistas que se borraron y están en la página Papelera. Si quieres validar una vista borrada, primero el administrador de Looker debe restablecerla.
  • Si estás en Modo de desarrollo, los resultados de la validación reflejarán tu LookML guardado, incluso si no se envió a producción. Sin embargo, los cambios que realices con el Validador de contenido afectarán a los usuarios que vean el contenido en el modo de producción. Considera cambiar al modo de producción antes de ejecutar el validador de contenido.