Validación de contenido

El Validador de contenido busca los nombres de modelos, Explorar y campos a los que se hace referencia en su contenido de Looker. Es una herramienta muy ú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:

Desde aquí, puedes usar el validador de contenido de dos formas:

Antes de usar el Validador de contenido

Debes tener mucho cuidado al realizar cambios con la validación de contenido. El Validador de contenido no tiene una función para deshacer y puede afectar muchos Apariencias 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 dificultan el aislamiento de los estilos afectados.

Además, ten en cuenta los plazos para usar el Validador de contenido. Cuando implementes cambios de desarrollo en producción, debes corregir los estilos y mosaicos afectados aproximadamente al mismo tiempo, de modo que se dañen durante el tiempo mínimo. Si corriges los aspectos y mosaicos demasiado pronto, según tu trabajo en modo de desarrollo, se mostrarán dañados a los usuarios hasta que apliques los cambios. Del mismo modo, si demora la corrección de la apariencia y los mosaicos hasta mucho después de aplicar los cambios, los usuarios verán los mosaicos y las apariencias hasta que los corrija.

Si usas el Validador de contenido para cambiar los nombres de los campos que funcionan como filtros en tus paneles, asegúrate de revisar la sección Filtros de las programaciones de tu panel y actualizar los filtros según sea necesario para reflejar tus cambios. Si una publicación programada en el panel incluye filtros que ya no funcionan (por ejemplo, si cambió el campo al que se hace referencia), la publicación programada fallará y el propietario de la programación recibirá un mensaje de error que indica que un filtro no es válido.

Ten cuidado cuando uses el Validador de contenido para hacer un cambio en un Explorar usado en un mosaico del panel de resultados combinados, ya que el Validador de contenido aplica cualquier cambio a todas las Explorars incluidas en el mosaico de resultados combinados. Por ejemplo, no puedes usar el Validador de contenido para cambiar el nombre del modelo en una sola exploración de un mosaico de resultados combinados sin cambiar el nombre del modelo en todas las exploraciones incluidas en los resultados combinados.

Cómo usar el Validador de contenido para corregir errores

El Validador de contenido es una herramienta útil para encontrar y corregir errores que resulten de cambios en tu LookML. Por ejemplo, si cambias el nombre de un campo de customer a user, dejarán de funcionar las apariencias o los mosaicos del panel que incluían el campo customer (a menos que hayas usado el parámetro alias). El Validador de contenido enumerará las referencias al campo customer y también proporcionará una manera fácil de corregir el error.

Cuando ejecutas el validador de contenido, se validan todas las referencias que tus estilos y paneles hacen a tus modelos, exploraciones, vistas y campos de LookML, y mostrará un error por cualquier referencia que tu contenido haga a un objeto LookML desconocido.

El Validador de contenido no muestra los siguientes errores:

  • Contenido para el que no tienes el permiso develop. El Validador de contenido se limita a tus permisos, de modo que solo puedes usar el Validador de contenido 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 Funciones para obtener información sobre los permisos del modelo.
  • Parece que se borraron y están en la Papelera. Si deseas validar un Look borrado, tu administrador de Looker primero debe restablecerlo.

Cómo ejecutar el validador de contenido

Lee la sección Antes de usar el validador de contenido antes de continuar. El Validador de contenido puede afectar muchas partes de tu contenido de Looker, por lo que es importante planificar y considerar de antemano.

Sigue estos pasos para validar tu LookML con el validador de contenido:

  1. Haz clic en el botón Validar.
  2. Haz clic en las pestañas Agrupar por para cambiar la forma en que se agrupan los errores:
    • Error: Enumera cada error y agrupa el contenido de Looker que tiene el error. Esto resulta útil si deseas corregir el mismo error en varios contenidos a la vez.
    • Carpeta: Enumera cada carpeta y agrupa el contenido de Looker que tiene errores. Esto es útil si deseas corregir sólo los errores de una carpeta en particular.
    • Contenido: enumera cada fragmento de contenido que tiene errores y agrupa los errores. Esto es útil si deseas corregir todos los errores en una sola vista, mosaico, filtro, etcétera.
  3. Si te encuentras en el modo de desarrollo, es importante comprender las implicaciones de cambiar los estilos y mosaicos. Si los "corrige" antes de implementar los cambios rotundos, habrá un período en el que la corrección será prematura, por lo que los usuarios experimentarán la apariencia o mosaicos de la aplicación. Looker proporciona un mensaje de advertencia para ayudarlo a recordar esto.
  4. En la tabla de errores, se muestra cualquier error, junto con una lista de las apariencias y los mosaicos que contienen el error, además del modelo subyacente y Explorar que producen el error. Puedes usar las pestañas Agrupar por en la esquina 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 funciones para corregir los errores y se describen con más detalle a continuación.

Visualiza los resultados de la validación de contenido

Los resultados de la validación de contenido muestran el contenido de Looker que utiliza 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 a fin de obtener detalles sobre los elementos de LookML que el validador de contenido puede encontrar y validar.

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

  • : mosaico del panel
  • : Alerta del panel
  • : Programa un panel o Look
  • : Filtra un panel o un campo en un mosaico que escucha un filtro de panel (consulta la página de documentación Cómo agregar y editar filtros de panel definidos por el usuario para obtener información sobre la configuración de mosaicos para escuchar los filtros del panel)

Los resultados de la validación se basan en el LookML disponible en el modo en que se encuentra cuando ejecuta el validador. Si estás en el modo de producción, los resultados de la validación reflejarán todo el LookML que se envió a producción. Si estás en el 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 su LookML, a un error tipográfico o a una unión faltante.

Para ajustar los errores, puedes usar los botones en cada línea de la tabla de errores:

Looker proporciona el botón Reemplazar para cada error (consulta la sección Reemplaza nombres de campos, vistas, Explorar y modelos a continuación para ver cómo reemplazar nombres por el Validador de contenido). Para los errores con nombres de campo en la sección Datos de un estilo o mosaico, Looker también muestra el botón Quitar (consulta la sección Cómo quitar un nombre de campo a continuación para obtener información sobre 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 (apariencia o mosaico), o bien a varios elementos:

  • Si agrupas por Error, los botones se aplican a todos los casos de ese error en todos los aspectos y mosaicos de tu instancia de Looker, lo que te permite corregir todos los casos en una sola operación.
  • Si agrupas por Carpeta o por Contenido, los botones se aplican a un caso del error en un solo aspecto o mosaico, lo que te permite considerar cada caso del error por separado.

Este es un ejemplo en el que la tabla se agrupa por Error, por lo que los botones afectan a todas las instancias de ese error:

Este es un ejemplo en el que la tabla se agrupa por Contenido: Los botones afectan solo a la instancia del error en un solo contenido:

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

Reemplaza los nombres por campos, vistas, Explorar y modelos

Los resultados de la validación de contenido incluyen un botón Reemplazar para los siguientes tipos de elementos a fin de que puedas cambiarlos:

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 presenta el error:

  • Si se produce un error en un campo, puedes reemplazarlo o quitarlo, o puedes reemplazar la vista, Explorar o el nombre del modelo.
  • Si se produce un error en el nombre de Explorar, puedes reemplazar el nombre de Explorar o el nombre del modelo.
  • Si el nombre de un modelo genera un error, puedes reemplazarlo.

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

  1. Haz clic en Validar para ejecutar el validador de contenido.
  2. Haz clic en una configuración de Agrupar por para elegir cómo se agrupan los errores. En este ejemplo, agrupamos los datos por Error para poder ajustar varios elementos a la vez.

  3. En la tabla de errores, haga clic en el botón Reemplazar junto al error que desea corregir.

  4. En el cuadro de diálogo, selecciona el tipo de elemento LookML que deseas cambiar: campo, vista, Explorar o modelo. Looker muestra las opciones adecuadas para cada error.

  5. Verifica el nombre del elemento que quieres reemplazar. El Validador de contenido lo completa automáticamente.

  6. Ingresa el nuevo nombre del elemento.

  7. Si has agrupado por Error y hay varios elementos que se verán afectados, puedes hacer clic en Mostrar contenido para ver una lista de los elementos que el Validador de contenido actualizará.

  8. De forma opcional, si desea dejar sus nombres sin modificar, puede desmarcar las casillas de verificación junto a los elementos de la lista.

  9. Haga clic en el botón Reemplazar para realizar el cambio.

Quita un nombre de campo

Para los errores con nombres de campo en la sección Datos (Looks) o un mosaico, la tabla de errores proporcionará el botón Eliminar (Remove) a la derecha del error. Puedes usar el Validador de contenido para eliminar los siguientes campos:

  • En la sección Datos de un mosaico o un mosaico del panel
  • Se hace referencia en las configuraciones de visualización, como el área Personalización de la pestaña Serie para los gráficos de columnas
  • Se hace referencia mediante un mosaico de panel a fin de escuchar un filtro de panel (esto se configura en la pestaña Tiles to Update de la ventana de configuración de filtros, que se describe en la página de documentación Cómo agregar y editar filtros de panel definidos por el usuario)

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

  1. Haz clic en Validar para ejecutar el validador de contenido.
  2. Haz clic en una configuración de Agrupar por para elegir cómo se agrupan los errores. En este ejemplo, agrupamos los datos por Error para poder ajustar varios elementos (Looks, mosaicos, o ambos) al mismo tiempo.

  3. En la tabla de errores, haga clic en el botón Quitar junto al error de campo que desea corregir.

  4. Verifica el nombre del elemento que quieres quitar. El Validador de contenido lo completa automáticamente.

  5. Si has agrupado por Error y hay varios elementos (Apariencia, mosaicos o ambos), puedes hacer clic en Mostrar contenido para ver una lista de los elementos que se actualizará el Validador de contenido.

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

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

Eliminación de estilos

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

Si quieres usar el validador de contenido para borrar la apariencia:

  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 la casilla Seleccionar que aparece junto a la apariencia o los estilos que deseas borrar.
  4. Haz clic en Borrar todos los estilos seleccionados.
  5. Haz clic en Aceptar en el cuadro de confirmación para borrar la apariencia seleccionada.

Si borras un Look por accidente, es posible que el administrador de Looker pueda recuperarlo. Looker almacena el contenido borrado en la papelera hasta que el equipo de administración de Looker vacía la papelera como parte de su proceso de mantenimiento.

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

El Validador de contenido también se puede usar para buscar y reemplazar nombres de modelos, exploraciones y campos. Por ejemplo, puede decidir que prefiere un campo sobre otro y quiere realizar ese reemplazo en su proyecto, aunque no haya errores. La lista completa de elementos que el Validador de contenido puede buscar/reemplazar se proporciona en la sección Cómo reemplazar nombres por campos, vistas, exploraciones y modelos que aparece más arriba.

Lee la sección Antes de usar el validador de contenido antes de continuar. El Validador de contenido puede afectar muchas partes de tu contenido de Looker, por lo que es importante planificar y considerar de antemano.

Sigue estos pasos para usar el validador de contenido como herramienta de búsqueda y reemplazo:

  1. En la pantalla Validador de contenido, haz clic en Buscar &reemplazar en todo el contenido.

  2. Seleccione el Tipo de elemento LookML que desea cambiar (campo, vista, Explorar o modelo).

  3. Ingrese el Nombre del elemento que desea reemplazar.

  4. Ingrese un Nombre de reemplazo para el campo, la vista, la exploración o el modelo.

  5. Haga clic en el botón Reemplazar para realizar el cambio.

Aspectos para tener en cuenta

Vuelve a ejecutar la validación del contenido para ver los resultados de las correcciones que hagas.

Ten en cuenta lo siguiente sobre el validador de contenido:

  • En el caso de las vistas, exploraciones o modelos, puedes cambiar sus nombres, pero no puedes quitarlos por completo. Consulta la sección Cómo quitar un nombre de campo para obtener una lista de los elementos que puedes quitar con el Validador de contenido.
  • Los cálculos de tabla solo pueden hacer referencia a los campos que se incluyen en la consulta de una imagen o un mosaico. Esto significa que si quitas un campo de una consulta de Look o mosaicos, pero en un cálculo de tabla aún se usa ese campo, se mostrará un nuevo error de validación de contenido.
  • No se validarán los elementos que se hayan borrado y que estén en la página de la Papelera. Si deseas validar un Look borrado, tu administrador de Looker primero debe restablecerlo.
  • Si estás en el modo de desarrollo, los resultados de la validación reflejarán tu LookML guardado incluso si no se envió a producción. Sin embargo, cualquier cambio que hagas con el validador de contenido afectará 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.