¿Cómo usar Template Parameters en Gadget Templates?

Los templates parameters son los parámetros que se requerirán al usuario de la plantilla y tendrá que rellenar cuando vaya a utilizarla.

Al rellenar el formulario, se sustituirá el parámetro por el valor seleccionado para este.

Para utilizarlos, arrástralos hacia el editor de texto TEMPLATE CODE HTML&CSS (DROP ZONE). A partir versión 2.1.3-gradius, esto también funcionará en la sección JavaScript.

Text Label Parameter:

Este parámetro se sustituirá por la cadena que se escriba en el formulario cuando uses la plantilla en el dashboard.

Todos estos comentarios contienen un parámetro name para diferenciarlos unos de otros. Además, puedes utilizar en varios sitios del código el mismo comentario si quieres especificar la misma cadena en distintas partes del código, no teniendo que rellenar así varios campos del formulario que aparece tras seleccionar la plantilla para su uso.

Number Label Parameter:

Este parámetro pedirá un número en el formulario tras seleccionar la plantilla para su uso.

Label con datos de Data Source:

Este parámetro se sustituye por el valor del datasource que selecciones en el formulario.

Label con nombre de parámetro de Data Source:

Este se sustituye por el nombre del campo del data source que seleccionemos en el formulario.

Este es útil si quieres escribir el nombre del parámetro del data source para usarlo en tu código html .

Por ejemplo, si creas una plantilla donde se muestre una gráfica, en los valores de los ejes puedes poner ésta para que, en el formulario previo, se elijan qué campos mostraría cada eje.

Label que se cargará con el valor elegido de una lista:

Aquí guardaremos unas opciones que después el usuario del template podrá seleccionar, y el comentario se sustituirá por la opción seleccionada.

En el campo options, debes poner las distintas opciones separadas por comas.

Puedes probar la plantilla accediendo a Show Gadget Template, donde podrás cambiar los parámetros por valores y seleccionar un datasource para comprobar si la plantilla cumple con los requisitos que se esperan de ella.

Crear una plantilla de ejemplo con parámetros para ver cómo usarlos

Para el ejemplo, vas a crear un gadget simple value:

Primer paso, ve a la pantalla para crear el gadget template.

Dale un identificador y una descripción.

Inserta el código, que tiene un parámetro tipo texto y otro tipo Label con nombre de parámetro de Data Source.

TEMPLATE CODE HTML&CSS (DROP ZONE)

<style>
  .card-count{
   color: #2e43ab;
    font-weight: bold;
    font-size: -webkit-xxx-large;
   padding-left: 20px;
  }
  .card-title{
   color: #000000;
    font-weight: bold;
    font-size: x-large;    
  }
   
.card-green{
  color:green;
   
  }
  .my-card{
      padding: 15px;
  }
   .card-icon{    
      padding-top: 0px;
      padding-left: 0px;
      padding-bottom: 25px;
      padding-right: 25px;
  }
   
</style>
 
 
<div class="my-card">
 
 
 <md-icon class="card-icon" style="font-size:35px">assessment</md-icon>
 <label class="card-title"><!--label-osp  name="title" type="text"--></label><br>
 <label class="card-count">{{ds[0].<!--label-osp  name="ontology field" type="ds_parameter"-->}}</label>
       
 
</div>

Guarda y ve a tu dashboard.

Arrastra el icono donde quieres que aparezca tu gadget template.

Selecciona la plantilla y aparece un formulario a rellenar.

Tras introducir el datasource y el texto del título y seleccionar el valor a mostrar, podrás ver el gadget en tu dashboard con esta apariencia.