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 los arrastraremos hacia el editor de texto TEMPLATE CODE HTML&CSS (DROP ZONE). A partir versión 2.1.3-gradius también en sección Javascript
Text Label Parameter:
Este parámetro se sustituirá por la cadena que se escriba en el formulario cuando usemos la plantilla en el dashboard.
Todos estos comentarios contienen un parámetro name para diferenciarlos unos de otros. Además podremos utilizar en varios sitios del código el mismo comentario si queremos 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 seleccionemos 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 en nuestro código html queremos escribir el nombre del parámetro del data source para usarlo.
Por ejemplo, si creásemos una plantilla donde se mostrase una gráfica, en los valores de los ejes podríamos poner esta para que, en el formulario previo, se eligiesen que campos mostraría cada eje.
Label que se cargará con el valor elegido de una lista:
En este lo que haremos será guardar unas opciones que luego el usuario del template podrá seleccionar y la opción seleccionada será por lo que se sustituya el comentario
En el campo options pondremos las distintas opciones separadas por comas.
Podemos probar la plantilla accediendo a show gadget template donde podremos cambiar los parámetros por valores y seleccionar un datasource para comprobar si la plantilla cumple con los requisitos que se esperan de ella.
Crearemos una plantilla de ejemplo con parámetros para ver como usarlos
Para el ejemplo crearemos un gadget simple value:
Primer paso vamos a la pantalla para crear el gadget template.
Damos un identificador una descripción.
Insertamos el código, que tiene un parametro tipo texto y otro tipo Label con nombre de parámetro de Data Source
<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>
Guardamos y vamos nuestro dashboard.
Arrastarmos el icono donde queremos que aparezca nuestro gadget template
Seleccionamos la plantilla y nos parece un formulario a rellenar
Tras introducir el datasource y el texto del titulo y seleccionar el valor a mostrar ya veremos el gadget en nuestro dashboard con esta apariencia: