Configuración de un widget web

Puede configurar un widget web y personalizar después los valores correspondientes en las páginas de configuración específicas del widget.

Acerca de esta tarea

Después de configurar los niveles de acceso del widget web, se muestra una página de configuración específica del widget:

Procedimiento

  1. Necesario: En el campo Título del widget proporcione un breve nombre descriptivo. Al seleccionar un título, tenga en cuenta la finalidad del widget web, la página de inicio y que el título se utiliza en el panel de navegación para acceder al widget.
  2. Necesario: En el campo Página inicial proporcione una dirección web válida. Esta es la dirección web de la página que aparece de forma predeterminada cuando un usuario accede al widget de web desde el panel de navegación.
    Nota:

    El widget web soporta las variables de sustitución en el campo de URL Página de inicio. Es decir, puede especificar un URL que incluya las variables que se llenan cuando el widget web recibe un suceso que proporciona valores para las variables especificadas. Las variables globales también se permiten, por ejemplo, TIP_THEME. Si no se proporciona un valor adecuado para una variable, el URL se resuelve sin el elemento en cuestión del URL. Los ejemplos siguientes proporcionan información detallada sobre cómo se sustituyen las variables:

    • Ejemplo 1 - Sustitución de variables globales: existe un valor para la variable global especificada  
      El URL especificado en el campo de URL Página de inicio: /apm/index.html?theme=%%TIP_THEME%%
      URL resuelto con el tema IBM OneUI activo: /apm/index.html?theme=OneUI
      URL resuelto con el tema de consola oscura activo: /apm/index.html?theme=TIPDark
    • Ejemplo 2 - Sustitución de variables globales: no existe un valor para la variable global especificada  
      El URL especificado en el campo de URL Página de inicio: /apm/index.html?time=%%time%%
      URL resuelto:
      Nota: En este ejemplo, la variable global especificada (%time%) no existe y, por tanto, el URL resuelto no incluye un valor para la variable.
      /apm/index.html?time=
    • Ejemplo 3 - Sustitución de variables activadas por sucesos, donde el suceso incluye los valores adecuados para las variables especificadas  
      URL especificado en el campo de URL Página de inicio que incluye las siguientes variables:

      %%start%% y %%system_name%%

      /apm?start=%%start%%&system_name=%%system_name%%
      URL resuelto donde los datos de suceso incluyen la siguiente información:

      { name: "NodeClickedOn", payload: { start: 0, system_name: "HULK:Primary:NT" }

      /apm?start=0&system_name=HULK:Primary:NT
    • Ejemplo 4 - Sustitución de variables que incluye un valor de suceso y un valor global  
      URL especificado:

      Variables: %%TIP_THEME%% (que está en una variable global adecuada) y %%start%%

      /apm?theme=%%TIP_THEME%%&start=%%start%%
      URL resuelto donde los datos de suceso incluyen la siguiente información, suponiendo que el tema IBM One UI está activo:

      { name: "NodeClickedOn", payload: { start: 0}}

      /apm?theme=OneUI&start=0
    • Ejemplo 5 - Sustitución de variables activadas por sucesos, donde el suceso recibido incluye un elemento displayURL  
      El URL especificado en el campo de URL Página de inicio: Cualquier URL
      URL resuelto: El URL especificado en el elemento displayURL sustituye el campo de URL Página de inicio especificado. Si el URL nuevo incluye variables, se resolverán como los ejemplos que se proporcionan aquí.
  3. Opcional: En el campo Página de ayuda, proporcione un URL relativo o absoluto a un tema HTML de página de ayuda personalizada para sustituir el tema de ayuda predeterminado que se incluye con el widget web.
  4. Necesario: En el campo Nombre de iFrame HTML, proporcione un nombre de iFrame HTML exclusivo. La entrada en este campo sirve para identificar el widget de web para permitir que su contenido se actualice dinámicamente.
    Atención: Es importante especificar un nombre de iFrame exclusivo. De lo contrario, es posible que los widgets web que tengan el mismo nombre de iFrame no se visualicen correctamente hasta que configure su valor Nombre de iFrame HTML.
  5. Opcional: Seleccione Mostrar una barra de herramientas de control de navegador para proporcionar a los usuarios una barra de herramientas de navegación, es decir, botones de navegación web estándares y un campo de entrada de dirección web.
  6. Opcional: Para permitir a los usuarios personalizar la configuración de widget, marque el recuadro de selección correspondiente. De forma predeterminada, se deseleccionan los siguientes recuadros de selección:
    • Título del widget
    • Página inicial
    • Página de ayuda
    • Barra de control de navegador
  7. Pulse Guardar para confirmar los cambios o Restaurar valores predeterminados para restaurar el formulario.
  8. Pulse Siguiente para visualizar una página de Resumen en la que puede revisar sus valores.
  9. Pulse Finalizar para completar los pasos del asistente. El widget configurado está disponible para incluirse en los paneles de instrumentos de la consola.