Compartir a través de

Crear o editar un libro de trabajo de Azure

En este artículo se describe cómo crear un nuevo libro de trabajo y cómo agregar elementos a su libro de trabajo de Azure.

Este video le guiará a través de la creación de libros de trabajo.

Crear un nuevo libro de trabajo de Azure

Para crear un libro de Azure, haga lo siguiente:

  1. En la página Libros de Azure, seleccione una plantilla vacía o seleccione Nuevo en la barra de herramientas superior.
  2. Combine cualquiera de estos elementos para agregarlos al libro:

Nota

Para agregar nuevos elementos al libro, asegúrese de que está en modo Edición seleccionando Edit en la barra de herramientas.

Agregar texto

Los libros de trabajo permiten a los autores incluir bloques de texto en sus libros de trabajo. El texto puede ser un análisis humano de los datos, información para ayudar a los usuarios a interpretar los datos, títulos de sección, etc.

Captura de pantalla de la incorporación de texto a un libro.

El texto se agrega a través de un control Markdown, en el que un autor puede agregar su contenido. Un autor puede usar todas las funcionalidades de formato completo de Markdown. Estas funcionalidades incluyen diferentes estilos de encabezado y fuente, hipervínculos, tablas, etc. Markdown permite a los autores crear informes enriquecidos similares a Word o Portal o narraciones analíticas. El texto puede contener valores de parámetro en el texto en markdown y esas referencias de parámetro se actualizarán a medida que cambien los parámetros.

Modo de edición: captura de pantalla que muestra cómo agregar texto a un libro en modo de edición.

Modo de vista previa: captura de pantalla que muestra cómo agregar texto a un libro en modo de vista previa.

Agregar texto a un libro de Azure:

  1. Agregue un paso de texto mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar texto debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) situados a la derecha del botón Editar situado junto a uno de los elementos del libro, seleccione Agregar y, a continuación, Agregar texto.

  2. Escriba el texto de Markdown en el campo del editor.

  3. Usa la opción Estilo de texto para cambiar entre markdown sin formato y markdown envuelto con el estilo estándar de información, advertencia, éxito o error del portal de Azure.

    Sugerencia

    Use esta hoja de referencia rápida de Markdownpara ver las diferentes opciones de formulario.

  4. Use la pestaña Vista previa para ver el aspecto que tiene los contenidos. La vista previa mostrará el contenido dentro de un área de desplazamiento para limitar su tamaño, pero cuando se muestra en tiempo de ejecución, el contenido de Markdown se expande para llenar cualquier espacio que necesite, sin barras de desplazamiento.

  5. Seleccione Edición finalizada.

Estilos de texto

Estos estilos de texto están disponibles:

Estilo Descripción
llanura No se ha aplicado ningún formato.
información Estilo de "información" del portal, con un icono ℹ o similar y un fondo azul
error Estilo de "error" del portal, con un icono ❌ o similar y un fondo rojo
éxito Estilo de "éxito" del portal, con un icono ✔ o similar y un fondo verde
upsell Estilo de "incremento de ventas" del portal, con un icono 🚀 o similar, y un fondo púrpura
advertencia Estilo de "advertencia" del portal, con un icono ⚠ o similar y un fondo azul

También puede elegir un parámetro de texto como origen del estilo. El valor del parámetro debe ser uno de los valores de texto anteriores. La ausencia de un valor o cualquier valor no reconocido se trata como plain estilo.

Ejemplos de estilo de texto

Ejemplo de estilo de información: captura de pantalla de cómo agregar texto a un libro en modo de vista previa que muestra el estilo de información.

Ejemplo de estilo de advertencia: captura de pantalla de una visualización de texto en estilo de advertencia.

Agregar consultas

Las Hojas de cálculo de Azure permiten consultar cualquiera de los orígenes de datos admitidos.

Por ejemplo, puede consultar Azure Resource Health para ver todos los problemas de servicio que afectan a los recursos. También puede consultar las métricas de Azure Monitor, que son datos numéricos que se recopilan a intervalos regulares. Las métricas de Azure Monitor proporcionan información sobre un aspecto de un sistema en un momento determinado.

Para agregar una consulta a un libro de trabajo de Azure:

  1. Agregue una consulta mediante cualquiera de estos pasos:

    • Seleccione Agregar, y Agregar consulta debajo de un elemento existente o en la parte inferior del libro de trabajo.
    • Seleccione los puntos suspensivos (...) situados a la derecha del botón Editar junto a uno de los elementos del libro, seleccione Agregar y, después, Agregar texto.

  2. Seleccione el origen de datos de la consulta. Los demás campos se determinan en función del origen que elija.

  3. Seleccione cualquier otro valor necesario en función del origen de datos seleccionado.

    Nota

    Tenga en cuenta los permisos de usuario al seleccionar el tipo de recurso. Por ejemplo, si tiene permisos de lectura para un recurso, pero no para el área de trabajo de Log Analytics a la que el recurso envía telemetría, debe seleccionar el recurso para Tipo de recurso para ver los datos.

  4. Seleccione la visualización del libro.

  5. En la sección de la consulta, escriba la consulta o selecciónela en una lista de consultas de ejemplo seleccionando Ejemplos y, a continuación, edite la consulta a su gusto.

  6. Seleccione Ejecutar consulta.

  7. Cuando esté seguro de que tiene la consulta que desea en el libro, seleccione Finalizar edición.

Procedimientos recomendados para consultar registros

  • Predefina reglas de resumen para agregar datos que quieras visualizar. En lugar de ejecutar consultas en grandes conjuntos de datos o intervalos de tiempo prolongados, cree reglas de resumen para agregar los datos que necesita de una o varias tablas a medida que llegan los datos al área de trabajo de Log Analytics. La visualización de los datos agregados directamente desde una tabla personalizada de datos resumidos, en lugar de consultar datos sin procesar de una o varias tablas, mejora el rendimiento de las consultas y reduce los errores de consulta y los tiempos de espera.

  • Use los intervalos de tiempo más pequeños posibles. Cuanto más grande sean los intervalos de tiempo, más lentas son las consultas y más datos se devuelven. Durante intervalos de tiempo más largos, es posible que la consulta tenga que ir al almacenamiento "en frío" más lento, lo que hace que la consulta sea aún más lenta. El valor predeterminado es el intervalo de tiempo más corto, pero permite al usuario elegir un intervalo de tiempo mayor que puede ser más lento.

  • Use el valor especial "All" en las listas desplegables. Puede agregar un elemento especial All en la configuración del parámetro desplegable. Puede usar un valor especial. El uso de un elemento especial All correctamente puede simplificar drásticamente las consultas.

  • Atención con las columnas que faltan. Si usa una tabla personalizada o columnas personalizadas, diseñe su plantilla para que sirva si falta la columna en un área de trabajo. Consulte la función column_ifexists.

  • Atención con una tabla que falte. Si la plantilla se instala como parte de una solución, o en otros casos en los que se garantiza que existen las tablas, no es necesario comprobar que faltan columnas. Si va a crear plantillas genéricas que podrían estar visibles en cualquier recurso o área de trabajo, es recomendable proteger las tablas que no existen.

    El lenguaje de consulta de Log Analytics no tiene una función table_ifexists como la función para probar las columnas. Sin embargo, hay algunas maneras de comprobar si existe una tabla. Por ejemplo, puede usar una unión difusa. Al realizar una unión, puede usar la configuración isfuzzy=true para permitir que la unión siga vigente si algunas de las tablas no existen. Puede agregar una consulta de parámetro en su libro de trabajo que comprueba la existencia de la tabla y oculta algún contenido si no existe. Los elementos que no están visibles no se ejecutan, por lo que puede diseñar la plantilla para que otras consultas del libro que produzcan un error si la tabla no existe no se ejecuten hasta después de que la prueba compruebe que existe la tabla.

    Por ejemplo:

    let MissingTable = view () { print isMissing=1 };
union isfuzzy=true MissingTable, (AzureDiagnostics | getschema | summarize c=count() | project isMissing=iff(c > 0, 0, 1))
| top 1 by isMissing asc

    Esta consulta devuelve un 1 si la tabla AzureDiagnostics no existe en el área de trabajo. Si la tabla real no existe, se devuelve la fila falsa de MissingTable . Si existen columnas en el esquema de la tabla AzureDiagnostics, se devuelve un valor 0. Puede usarlo como un valor de parámetro y ocultar condicionalmente los pasos de consulta a menos que el valor del parámetro sea 0. También puede usar visibilidad condicional para mostrar un texto que indique que el área de trabajo actual carece de la tabla que falta y redirigir al usuario a la documentación sobre cómo iniciar el proceso.

    En lugar de ocultar los pasos, es posible que solo quiera tener filas como resultado. Puede cambiar la MissingTable para que sea una tabla de datos vacía con el esquema coincidente adecuado:

    let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')

    En este caso, la consulta no devuelve ninguna fila si falta la tabla AzureDiagnostics o si falta la columna ResourceId de la tabla.

Tutorial: Consultas de registros centrados en recursos en libros

En este vídeo se muestra cómo usar consultas de registros de nivel de recurso en Workbooks de Azure. También tiene sugerencias y trucos sobre cómo habilitar escenarios avanzados y mejorar el rendimiento.

Consultas de registros centrados en recursos en libros

Parámetro de tipo de recurso dinámico

Utiliza ámbitos dinámicos para mejorar la eficacia de las consultas. En el fragmento de código siguiente se usa esta heurística:

  1. Recursos individuales: si el recuento de recursos seleccionados es menor o igual que 5
  2. Grupos de recursos: si el número de recursos es superior a 5, pero el número de grupos de recursos a los que pertenecen los recursos es menor o igual que 3
  3. Suscripciones: en caso contrario
Resources
| take 1
| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
| mvexpand x to typeof(string)
| extend jkey = 1
| join kind = inner (Resources
| where id in~ ({VirtualMachines})
| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
| extend jkey = 1) on jkey
| project x, label = 'x',
    selected = case(
        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true,
        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true,
        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true,
        false)

Ámbito de recurso estático para consultar varios tipos de recursos

[
    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
]

Parámetros de recursos agrupados por tipo de recurso

Resources
| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets'
| where resourceGroup in~({ResourceGroups})
| project value = id, label = id, selected = false,
    group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets')

Incorporación de parámetros

Puede recopilar entradas de los usuarios y hacer referencia a estas en otras partes del libro mediante parámetros. Utiliza parámetros para delimitar el conjunto de resultados o para establecer la visualización adecuada. Los parámetros le ayudan a crear informes interactivos y experiencias. Para obtener más información sobre cómo se pueden usar los parámetros, consulte parámetros del libro.

Los libros permiten determinar el modo en que se presentan los controles de parámetro a los consumidores: cuadro de texto frente a lista desplegable, selección única frente a selección múltiple, valores de texto, JSON, KQL o Azure Resource Graph.

Vea este vídeo para aprender a usar parámetros y datos de registro en Workbooks de Azure.

Para agregar un parámetro a un libro de Azure:

  1. Agregue un parámetro mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar parámetro debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) a la derecha del botón Editar situado junto a uno de los elementos del libro, seleccione Agregar y, a continuación, Agregar parámetro.

  2. En el panel de nuevo parámetro que aparece, escriba los valores de estos campos:

    • Nombre del parámetro: los nombres de parámetros no pueden incluir espacios ni caracteres especiales
    • Nombre para mostrar: los nombres para mostrar pueden incluir espacios, caracteres especiales, emojis, etc.
    • Tipo de parámetro:
    • Requerido:

  3. Seleccione Edición finalizada.

    Imagen que muestra la creación de un parámetro de intervalo de tiempo.

Agregar gráficos de métricas

La mayoría de los recursos de Azure emiten datos de métricas sobre el estado y el mantenimiento, como el uso de la CPU, la disponibilidad del almacenamiento, el recuento de transacciones de bases de datos, las solicitudes de aplicación con errores, etc. Mediante los libros, puede crear visualizaciones de estos datos de métricas como gráficos de serie temporal.

En el ejemplo siguiente se muestra el número de transacciones en una cuenta de almacenamiento durante la hora anterior. De este modo, el propietario del almacenamiento podrá ver la tendencia de las transacciones y buscar anomalías en el comportamiento.

Recorte de pantalla en el que se muestra un gráfico de área de métricas para las transacciones de almacenamiento en un libro.

Para agregar un gráfico de métricas a un libro de Azure:

  1. Agregue un gráfico de métricas mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar métrica debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) a la derecha del botón Editar junto a uno de los elementos del libro de trabajo, luego seleccione Agregar y después Agregar métrica.

  2. Seleccione un tipo de recurso, los recursos a los que dirigirse, el espacio de nombres de las métricas, el nombre de la métrica y la agregación que se va a usar.

  3. Si es necesario, establezca otros parámetros, como el intervalo de tiempo, dividir por, la visualización, el tamaño y la paleta de colores.

  4. Seleccione Edición finalizada.

Este es un gráfico de métricas en modo de edición:

Captura de pantalla que muestra un gráfico de área de métricas de las transacciones de Storage en el modo de edición.

Parámetros de gráfico de métricas

Parámetro Explicación Ejemplo
Tipo de recurso Tipo de recurso que se creará Almacenamiento o máquina virtual.
Recursos Un conjunto de recursos del que obtener el valor de las métricas MyStorage1
Espacio de nombres Espacio de nombres con la métrica Almacenamiento > Blob
Métrica Métrica para visualizar Almacenamiento > Blob > Transacciones
Agregación La función de agregación que se va a aplicar a la métrica Suma, recuento, promedio, etc.
Intervalo de tiempo Ventana de tiempo para ver la métrica Última hora, últimas 24 horas, etc.
Visualización La visualización que se utilizará Área, barras, líneas, dispersión, cuadrícula
Dividir por Dividir, de manera opcional, la métrica en una dimensión Transacciones por tipo geográfico
Tamaño El tamaño vertical del control Pequeño, mediano o grande
Paleta de colores Paleta de colores que se va a utilizar en el gráfico. Se omite si se usa el parámetro Split by Azul, verde, rojo, etc.

Ejemplos de gráficos de métricas

Transacciones divididas por nombre de API como un gráfico de líneasCaptura de pantalla que muestra un gráfico de líneas de métricas para las transacciones de almacenamiento divididas por nombre de API.

Transacciones divididas por tipo de respuesta como gráfico de barras grandeCaptura de pantalla que muestra un gran gráfico de barras de métricas para transacciones de almacenamiento divididas por tipo de respuesta.

Latencia media como gráfico de dispersiónCaptura de pantalla que muestra un gráfico de dispersión de métricas sobre la latencia de almacenamiento.

Puede usar vínculos para crear vínculos a otras vistas, libros, otros elementos de un libro o para crear vistas con pestañas en un libro. Se pueden aplicar estilos a los vínculos como hipervínculos, botones y pestañas. Captura de pantalla de cómo agregar un vínculo a un libro.

Vea este vídeo para aprender a usar pestañas, grupos y vínculos contextuales en Workbooks de Azure:

Puede aplicar estilos al elemento link en sí y a vínculos individuales.

Estilos del elemento link

Estilo Ejemplo Notas
Lista de viñetas Recorte de pantalla de un vínculo al libro en estilo de viñetas. El valor predeterminado, vínculos, aparece como una lista con viñetas de vínculos, uno en cada línea. Los campos Texto antes del vínculo y Texto después del vínculo se pueden usar para agregar más texto antes o después de los elementos link.
Lista Recorte de pantalla de un vínculo de libro con estilo de lista. Los enlaces aparecen en formato de lista, sin viñetas.
Párrafo Recorte de pantalla de un enlace al libro de trabajo de estilo de párrafo. Los vínculos aparecen como un párrafo de vínculos, con la forma de un párrafo de texto.
Navegación Recorte de pantalla de un vínculo de libro con estilo de navegación. Los vínculos aparecen como vínculos, con divisores verticales, o barras verticales (|), entre cada vínculo.
Pestañas Recorte de pantalla de un vínculo a un libro de trabajo con estilo de pestañas. Los vínculos aparecen como pestañas. Cada vínculo aparece como una pestaña, no se aplican opciones de estilo de vínculo a vínculos individuales. Consulte la sección de pestañas siguiente para obtener información sobre cómo configurar las pestañas.
Barra de herramientas Recorte de pantalla de un vínculo de libro con estilo de barra de herramientas. Los vínculos aparecen como una barra de herramientas con estilo de Azure Portal, con iconos y texto. Cada vínculo aparece como un botón de la barra de herramientas. Consulte la sección de la barra de herramientas siguiente para obtener información sobre cómo configurar las barras de herramientas.

Estilos de vínculo

Estilo Descripción
Vínculo De forma predeterminada, los vínculos aparecen como hipervínculos. Los vínculos URL solo pueden tener el estilo de vínculo.
Botón (principal) El vínculo aparece como un botón "principal" en el portal, normalmente con color azul.
Botón (secundario) Los vínculos aparecen como un botón "secundario" en el portal, normalmente con un color "transparente", un botón blanco en temas claros y un botón gris oscuro en temas oscuros.

Si se usan parámetros obligatorios en campos de texto de botón, texto de información sobre herramientas o valores, y el parámetro obligatorio se anula al usar los botones, el botón se deshabilitará. Puede usar esta funcionalidad, por ejemplo, para deshabilitar botones cuando no se selecciona ningún valor en otro parámetro o control.

Los vínculos pueden usar todas las acciones disponibles en las acciones de vínculo y tienen dos acciones más disponibles:

Acción Descripción
Establecer un valor de parámetro Un parámetro se puede establecer en un valor cuando el usuario del libro selecciona un vínculo, un botón o una pestaña. A menudo, las pestañas se configuran para establecer un parámetro en un valor, que oculta y muestra otras partes del libro en función de ese valor.
Desplazarse a un paso Cuando el usuario del libro selecciona un vínculo, el libro moverá el foco y se desplazará para que otro paso sea visible. Esta acción se puede usar para crear un "índice" o una experiencia de estilo del tipo "volver a la primera página".

Pestañas

La mayoría de las veces, los vínculos de pestaña se combinan con la acción Establecer un valor de parámetro.

Crear pestañas

Para agregar pestañas a un libro de Azure:

  1. Seleccione Agregar>vínculos o pestañas.

  2. Establezca Estilo en Pestañas.

  3. Escriba un nombre de pestaña para cada pestaña.

  4. En la columna Acción , seleccione Establecer un valor de parámetro para cada pestaña.

  5. En la columna Valor , establezca el mismo nombre de parámetro (por ejemplo, selectedTab) para cada pestaña.

  6. En la columna Configuración , escriba un valor diferente para cada pestaña.

    Este es un ejemplo configurado para crear dos pestañas, donde al seleccionar cualquiera de las pestañas se establece un parámetro selectedTab en un valor diferente.

    Captura de pantalla de creación de pestañas en libros.

    Nota

    En el ejemplo solo se muestra una tercera pestaña que se está editando para mostrar los marcadores de posición del nombre del parámetro y el valor del parámetro.

    Un libro de trabajo de ejemplo con las pestañas anteriores está disponible en los libros de trabajo de ejemplo de Azure con vínculos.

Agregar contenido a pestañas

  1. Edite el contenido del libro que desea agregar a una pestaña específica.

  2. En Configuración avanzada, seleccione Hacer que este elemento sea visible condicionalmente.

  3. Seleccione Agregar condición, escriba el nombre del parámetro (por ejemplo, selectedTab), establezca Comparación en iguales y establezca Valor de parámetro en el valor que asignó a la pestaña (por ejemplo, 1).

    Captura de pantalla de una pestaña condicionalmente visible en libros de trabajo.

    La primera pestaña está seleccionada de forma predeterminada, estableciendo inicialmente selectedTab en 1, y haciendo que ese paso sea visible. Al seleccionar la segunda pestaña, se cambia el valor del parámetro a 2y se muestra otro contenido.

    Captura de pantalla de los libros de trabajo con el contenido mostrado cuando se selecciona la pestaña 2.

Limitaciones de pestañas

  • No se admiten vínculos de direcciones URL en las pestañas. Un vínculo de dirección URL en una pestaña aparece como una pestaña deshabilitada.
  • No se admite ningún estilo de elemento en las pestañas. Los elementos aparecen como pestañas y solo se muestra el campo nombre de pestaña (texto del vínculo). Los campos que no se usan con el estilo de pestañas se ocultan mientras están en modo de edición.
  • La primera pestaña está seleccionada de forma predeterminada, invocando cualquier acción que haya especificado esa pestaña. Si la acción de la primera pestaña abre otra vista, en cuanto se crean las pestañas, aparece una vista.
  • Puede usar pestañas para abrir otras vistas, pero esta funcionalidad se debe usar con moderación, ya que la mayoría de los usuarios no esperan navegar seleccionando una pestaña. Si otras pestañas establecen un parámetro en un valor específico, una pestaña que abre una vista no cambiaría ese valor, por lo que el resto del contenido del libro continúa mostrando la vista o los datos de la pestaña anterior.

Barras de herramientas

Use el estilo de barra de herramientas para que los vínculos aparezcan con este estilo. En el estilo de barra de herramientas, el autor debe rellenar estos campos:

  • Texto del botón, el texto que va a aparecer en la barra de herramientas. Se pueden usar parámetros en este campo.
  • Icono, el icono que va a aparecer en la barra de herramientas.
  • Texto de información sobre herramientas, el texto de información sobre herramientas que se mostrará en el botón de la barra de herramientas. Se pueden usar parámetros en este campo.

Captura de pantalla de la creación de vínculos con el estilo de una barra de herramientas en un libro.

Si se usa algún parámetro obligatorio en el texto del botón, el texto de información sobre herramientas o los campos de valor, y el parámetro requerido no está establecido, el botón de la barra de herramientas se deshabilita. Por ejemplo, esto se puede usar para deshabilitar los botones de la barra de herramientas cuando no hay ningún valor seleccionado en otro parámetro o control.

Hay disponible un libro de ejemplo con barras de herramientas, parámetros globales y acciones de ARM en los libros de Azure de ejemplo con vínculos.

Adición de grupos

Un elemento de grupo en un libro de trabajo le permite agrupar de forma lógica un conjunto de pasos.

Los grupos en los libros de trabajo son útiles para varios propósitos.

  • Diseño: Cuando quiera que los elementos se organicen de manera vertical, puede crear un grupo de elementos que se alinearán y establecer que el estilo del grupo sea de ancho porcentual, en lugar de asignar ancho porcentual a cada elemento.
  • Visibilidad: en los escenarios en los que quiera ocultar o mostrar varios elementos juntos, puede establecer la visibilidad de todo el grupo de elementos, en lugar de establecer la configuración de visibilidad en cada elemento individual. Esto puede ser útil en las plantillas que usan pestañas, ya que puede usar un grupo como contenido de la pestaña y todo el grupo se podrá ocultar o mostrar en función de un parámetro que haya establecido la pestaña seleccionada.
  • Rendimiento: si tiene una plantilla de gran tamaño con muchas secciones o pestañas, puede convertir cada sección en su propia subplantilla y usar grupos para cargar todas las subplantillas dentro de la plantilla de nivel superior. El contenido de las subplantillas no se cargará ni se ejecutará hasta que un usuario haga visibles esos grupos. Obtenga más información sobre cómo dividir una plantilla de gran tamaño en muchas plantillas.

Para agregar un grupo a su libro de trabajo:

  1. Agregue un parámetro mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar grupo debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) situados a la derecha del botón Editar situado junto a uno de los elementos del libro, seleccione Agregar y, a continuación, Agregar grupo.

    Recorte de pantalla en el que se muestra la selección para agregar un grupo a un libro.

  2. Seleccione elementos para el grupo.

  3. Seleccione Edición finalizada.

    Este es un grupo en modo de lectura con dos elementos: un elemento de texto y un elemento de consulta.

    Captura de pantalla que muestra un grupo en modo de lectura en un libro.

    En el modo de edición, puede ver que ambos elementos en realidad están dentro de un elemento de grupo. En la captura de pantalla siguiente, el grupo está en modo de edición. El grupo contiene dos elementos dentro del área de contorno discontinuo. Cada elemento puede estar en modo de edición o de lectura, independientes entre sí. Por ejemplo, el paso de texto está en modo de edición, mientras que el paso de consulta está en modo de lectura.

    Captura de pantalla de un grupo en modo de edición en un libro de trabajo.

Delimitación del ámbito de un grupo

Un grupo se trata como un nuevo ámbito en el libro. Los parámetros creados en el grupo solo son visibles dentro del grupo. Esto también se aplica a las combinaciones; solo puede ver los datos dentro de su grupo o en el nivel primario.

Tipos de grupo

Puede especificar el tipo de grupo que se va a agregar a su libro de trabajo. Hay dos tipos de grupos:

  • Editable: El grupo en el libro de trabajo le permite agregar, quitar o editar el contenido de los elementos en el grupo. Se suele usar con fines de diseño y visibilidad.
  • Desde una plantilla: el grupo del libro se carga a partir del contenido de otro libro por su identificador. El contenido de ese libro se carga y se combina en el libro en tiempo de ejecución. En el modo de edición, no se puede modificar el contenido del grupo, ya que solo se volverá a cargar desde la plantilla la próxima vez que se cargue el elemento. Al cargar un grupo desde una plantilla, use el identificador de recurso completo de Azure de un libro de trabajo existente.

Tipos de carga

Puede especificar cómo y cuándo se carga el contenido de un grupo.

Carga diferida

La opción predeterminada es la carga diferida. En la carga diferida, el grupo solo se carga cuando el elemento está visible. Esto permite que un grupo sea utilizado por elementos de pestaña. Si la pestaña nunca se selecciona, el grupo nunca se vuelve visible, por lo que el contenido no se carga.

En el caso de los grupos creados a partir de una plantilla, no se recupera el contenido de la plantilla y los elementos del grupo no se crean hasta que el grupo se vuelve visible. Los usuarios ven los indicadores de progreso de todo el grupo mientras se recupera el contenido.

Carga explícita

En este modo, se muestra un botón donde estaría el grupo y no se recupera ni se crea ningún contenido hasta que el usuario selecciona explícitamente el botón para cargar el contenido. Resulta útil en los escenarios en los que puede ser costoso procesar el contenido, o este se usa con poca frecuencia. El creador puede especificar el texto que aparecerá en el botón.

En esta captura de pantalla se muestran configuraciones de carga explícitas con un botón configurado de "Cargar más". Recorte de pantalla de la configuración de carga explícita para un grupo en libros de trabajo.

Este es el grupo antes de cargarse en el libro: captura de pantalla que muestra un grupo explícito antes de cargarse en el libro.

Grupo después de cargarse en el libro de trabajo: Captura de pantalla que muestra un grupo explícito después de cargarse en el libro de trabajo.

Modo Siempre

En el modo Siempre, el contenido del grupo siempre se carga y se crea tan pronto como se carga el libro. Se usa con más frecuencia cuando se está usando un grupo solo con fines de diseño, en el que el contenido siempre estará visible.

Uso de plantillas dentro de un grupo

Cuando un grupo está configurado para cargarse a partir de una plantilla, el contenido se carga de manera diferida de forma predeterminada y solo se cargará cuando el grupo sea visible.

Cuando se carga una plantilla en un grupo, el libro intenta combinar todos los parámetros declarados en la plantilla con los parámetros que ya existen en el grupo. Los parámetros que ya existan en el libro con nombres idénticos se combinarán con los de la plantilla que se carga. Si se combinan todos los parámetros de un paso de parámetro, este desaparece por completo.

Ejemplo 1: todos los parámetros tienen nombres idénticos

Supongamos que tiene una plantilla que tiene dos parámetros en la parte superior, un parámetro de intervalo de tiempo y un parámetro de texto denominado "Filtro": captura de pantalla que muestra los parámetros de nivel superior en un libro.

A continuación, un elemento de grupo carga una segunda plantilla que tiene sus propios dos parámetros y un paso de texto, donde los parámetros se denominan igual: Captura de pantalla de una plantilla de libro con parámetros de nivel superior.

Cuando se carga la segunda plantilla en el grupo, se combinan los parámetros duplicados. Como todos los parámetros se combinan, el paso de los parámetros internos también se combina. como resultado, el grupo contendrá solo el paso de texto.

Ejemplo 2: un parámetro tiene un nombre idéntico

Supongamos que tiene una plantilla que tiene dos parámetros en la parte superior, un parámetro de intervalo de tiempo y un parámetro de texto denominado "FilterB" (): Captura de pantalla de un elemento de grupo con el resultado de los parámetros combinados.

Cuando se carga la plantilla de elemento del grupo, el parámetro TimeRange se extrae del grupo. El libro contiene el paso de parámetros iniciales con TimeRange y Filter, y el parámetro del grupo solo incluye FilterB. Recorte de pantalla del grupo de cuadernos donde los parámetros no se eliminarán al combinar.

Si la plantilla que se cargó hubiera contenido TimeRange y Filter (en lugar de FilterB), el libro resultante tendría un paso de parámetros y un grupo que solo incluiría el paso de texto.

División de una plantilla de gran tamaño en muchas plantillas

Para mejorar el rendimiento, resulta útil dividir una plantilla de gran tamaño en varias plantillas más pequeñas que cargan el contenido de modo diferido o a petición del usuario. De esta manera la carga inicial es más rápida, ya que la plantilla de nivel superior puede ser más pequeña.

Al dividir una plantilla en partes, tendrá que dividirla básicamente en muchas plantillas (subplantillas) que funcionen de forma individual. Por tanto, si la plantilla de nivel superior tiene un parámetro TimeRange que otros elementos usan, la subplantilla también deberá incluir un elemento de parámetros que defina un parámetro con exactamente el mismo nombre. Las plantillas secundarias funcionarán de forma independiente y se pueden cargar dentro de plantillas más grandes en grupos.

Para convertir una plantilla más grande en varias subplantillas, haga lo siguiente:

  1. Cree un nuevo grupo vacío cerca del inicio del cuaderno de trabajo, después de los parámetros compartidos. Este nuevo grupo se convertirá, con el tiempo, en una subplantilla.

  2. Cree una copia del paso de parámetros compartidos y, a continuación, use mover al grupo para trasladar la copia al grupo que creó en el paso 1. Este parámetro permitirá que la subplantilla funcione independientemente de la plantilla externa y se combinará cuando se cargue dentro de esa plantilla externa.

    Nota

    Técnicamente, no es necesario que las subplantillas incluyan estos parámetros que se combinarán si no planea que las subplantillas sean visibles por sí mismas. Pero si las subplantillas no tienen los parámetros, será muy difícil editarlas o depurarlas si tiene que hacerlo más tarde.

  3. Mueva todos los elementos del libro que quiera incluir en la subplantilla al grupo que ha creado en el paso 1.

  4. Si los pasos individuales que se han movido en el paso 3 tenían una visibilidad condicional, esta es la nueva visibilidad del grupo externo (como se usa en las pestañas). Quite dicha visibilidad de los elementos dentro del grupo y agregue la configuración de visibilidad al grupo. Guarde e este momento para evitar la pérdida de cambios o exporte y guarde una copia del contenido JSON.

  5. Si quiere que ese grupo se cargue desde una plantilla, puede usar el botón Editar de la barra de herramientas del grupo. Esto abrirá solo el contenido de ese grupo como un libro de trabajo en una ventana nueva. Después, podrá guardarlo como corresponda y cerrar la vista de libro (no cierre el explorador, solo esa vista para volver al libro anterior que estaba editando).

  6. Después, podrá cambiar el paso de grupo para que se cargue desde la plantilla y establecer el campo "Id. de plantilla" en el libro o plantilla que ha creado en el paso 5. Para trabajar con id. de libro, el origen debe ser el identificador de recurso de Azure de un libro compartido. Presione Cargar y el contenido de ese grupo ahora se cargará desde esa subplantilla, en lugar de guardarse dentro de este libro externo.

Agregar imagen

Los libros permiten a los autores incluir imágenes en su contenido. Use el elemento image para proporcionar ayudas visuales, como diagramas, capturas de pantalla y otra información visual.

Para agregar una imagen en su libro de trabajo:

  1. Agregue una imagen mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar imagen debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) situados a la derecha del botón Editar situado junto a uno de los elementos del libro, seleccione Agregar y, a continuación, Agregar imagen.

  2. Escriba la dirección URL de la imagen en el campo proporcionado.

  3. Proporcione configuraciones adicionales, como el título, el tamaño y el texto alternativo de la imagen. Al establecer el tamaño de la imagen en tamaño completo, la imagen se establece en su tamaño original.

Agregar vídeo

Los cuadernos de trabajo permiten a los autores insertar vídeos en tu cuaderno de trabajo.

Para agregar un vídeo en el libro:

  1. Agregue un vídeo mediante cualquiera de estos pasos:

    • Seleccione Agregar y Agregar vídeo debajo de un elemento existente o en la parte inferior del libro.
    • Seleccione los puntos suspensivos (...) situados a la derecha del botón Editar situado junto a uno de los elementos del libro, seleccione Agregar y, a continuación, Agregar vídeo.

  2. Escriba la dirección URL del vídeo en el campo proporcionado.

  3. Proporcione configuraciones adicionales, como el título del vídeo, el tamaño y el texto alternativo.