Mashup Builder > Widgets
Widgets
Los widgets de ThingWorx son los componentes visuales de páginas de mashup de ThingWorx. Un widget puede ser un procesador de datos avanzado, como un gráfico o más de un componente de utilidad, como un botón o un enlace de navegación. Los widgets de representación de datos tienen enlaces de datos entrantes. Cuando se ejecuta un servicio de datos, el conjunto de resultados de datos se enlaza al widget para la representación. Puede que otros widgets, como un botón, no tengan enlaces de datos entrantes, pero pueden tener un enlace de evento saliente. Por ejemplo, se puede enlazar el evento Clicked de un widget de botón a un servicio de datos. Al pulsar en el botón, el servicio de datos se ejecuta en el servidor.
Categorías de widgets para 8.4.X
En ThingWorx Platform, los 78 widgets se clasifican en tres categorías principales.
• Estándar: hay 64 widgets que aparecen como estándar en Mashup Builder. Estos son los widgets existentes en ThingWorx Platform.
• Beta: hay 13 widgets nuevos que aparecen como beta. También están disponibles como componentes Web que se pueden importar desde un SDK.
• Heredado: solo el widget de repetidor aparece como heredado. Este widget quedará obsoleto en una versión futura.
Hay otros widgets que están disponibles como extensiones. Algunas de estas extensiones aparecen en la sección Extensiones. Hay algunas extensiones disponibles en la página Descargas de software de PTC que se pueden importar y usar en ThingWorx. Estas extensiones importadas aparecen en la categoría Importado en Mashup Builder.
Categorías de widgets para 8.5.X y versiones posteriores
En la plataforma, los widgets se clasifican en cinco categorías principales: Pulse en la flecha situada junto a Categoría en el panel Widgets de la página de ThingWorx Composer, Diseñar, para seleccionar una categoría de widget. A continuación, se proporciona una descripción de lo que se incluye en cada categoría:
• Todo: todos los widgets.
• Estándar: widgets de componente Web y widgets existentes en ThingWorx Platform que no tienen un componente Web como reemplazo.
* 
Se hace referencia a algunos widgets como componentes Web porque están disponibles en ThingWorx Platform y se pueden importar desde un SDK.
• Se puede definir el tema: widgets a los que se pueden aplicar temas de estilo. Estos widgets se categorizan como Beta en las versiones anteriores.
• Heredado: widgets con reemplazos que son widgets estándar. Los widgets heredados se quedarán obsoletos en una versión futura.
• Importado: los widgets que se importan a ThingWorx Platform se muestran en esta categoría. Algunas de estas extensiones aparecen en la sección Extensiones. Hay algunas extensiones disponibles en la página Descargas de software de PTC que se pueden importar y usar en ThingWorx.
En el panel se incluyen subcategorías para ayudar a encontrar widgets, según su función. Los widgets que realizan una función similar se muestran juntos en cada una de estas subcategorías. Por ejemplo, en la sección Gráficos se muestra una lista de todos los widgets que pueden representar un gráfico. Se pueden seleccionar las siguientes subcategorías para buscar el widget que se debe utilizar en el mashup; Gráficos, Colaboración, Comunes, Componentes, Contenedores, Datos y Navegación
Colocación de widgets
Es posible arrastrar el widget a una ubicación de un mashup. Por ejemplo, se puede arrastrar un widget a una raíz de mashup o a un objeto de contenedor, como un panel o un conjunto de campos.
Propiedades de los widgets
Todos los widgets tienen propiedades para configurar la instancia de widget específica en una página. Las propiedades se editan en el panel de propiedades de widgets de Mashup Builder. Las propiedades se pueden definir manualmente o enlazarse a otros servicios de datos o eventos en el mashup. Si una propiedad es enlazable, junto al nombre de la propiedad habrá una flecha orientada a una entrada (el valor de la propiedad puede estar definido desde otro origen) o una flecha orientada hacia una salida (el valor de la propiedad puede ser el origen de otro valor de propiedad o parámetro), o ambas. Cada widget comparte las siguientes propiedades:
• Id: un identificador único que ThingWorx utiliza internamente.
• Type: el tipo de widget.
• DisplayName: un nombre descriptivo definido por el usuario para identificar el widget.
• Description: descripción definida por el usuario.
• Top: coordinada de Y superior para la ubicación del widget.
• Left: coordinada de X izquierda para la ubicación del widget.
• Width: ancho en píxeles.
• Height: altura en píxeles.
• Z-index: clasificación de los widgets por niveles. Normalmente, un índice Z inferior mueve el widget detrás de otro widget con un índice Z superior.
• ShowDataLoading: se muestran los datos mientras se cargan.
• Visible: permite mostrar el widget cuando se visualiza el mashup.
Cuando un valor de propiedad se ha definido manualmente, se realza el fondo de la fila de la propiedad. Si la propiedad tiene un enlace, la flecha de entrada correspondiente se rellenará.
Configuración de los widgets
Se puede abrir el cuadro de diálogo de configuración de widgets de una de las siguientes maneras:
• Pase el ratón sobre la flecha desplegable de la esquina superior izquierda del contenedor de widgets y, a continuación, elija Configurar enlaces de la lista.
• Seleccione el widget y, a continuación, pulse en el comando del panel Propiedades.
En el cuadro de diálogo de configuración se enumeran todas las propiedades enlazables del widget. Se pueden ver o definir los orígenes y los destinos de enlace de cada propiedad. Este cuadro de diálogo funciona como alternativa al método de arrastrar y soltar estándar para el enlace. Algunos widgets, como la cuadrícula avanzada, tienen sus propios cuadros de diálogo de configuración en los que se pueden definir las opciones específicas del widget.
Localización de las aplicaciones
Cuando se pulsa en junto a una propiedad de texto, el texto deja de estar definido en estático y, en su lugar, se basa en tokens de localización. Pulse en la varita mágica para seleccionar un token de localización existente o crear uno nuevo. Cuando se añade un nuevo token de localización, se añade un nombre de token con espacio para nombres, lo que impedirá conflictos con los tokens de otros orígenes y permitirá a los desarrolladores y traductores trabajar solo con tokens específicos de la aplicación. Para el campo Valor de cadena, se introduce el valor de texto por defecto. Después de definir todos los tokens necesarios para la aplicación, se pueden revisar en la página Tokens de localización filtrando por el nombre de token. Se debe añadir información de uso y de contexto para cada token.
Para las traducciones a otros idiomas, confirme que existen las tablas de localización para los idiomas en cuestión. Se puede utilizar el menú Importar/Exportar para exportar las entidades en un fichero XML. El usuario debe introducir el token de localización con espacio para nombres como el prefijo de token. En el fichero de salida XML, las traducciones para otros idiomas se deben añadir al elemento <Rows/> vacío. Una vez que las traducciones estén listas y se haya confirmado que los atributos de la tabla de localización name, description, languageCommon y languageNative son correctos, se pueden importar a ThingWorx y se combinan con las tablas de localización existentes para el idioma.
Se debe tener en cuenta lo siguiente:
• Si se introduce un nuevo idioma, muchos widgets utilizan tokens de la tabla de localización Sistema. Estos tokens se deben traducir, pero no hay una manera fácil de restringir el conjunto de tokens a los utilizados. Por lo tanto, se trata de un paso de filtrado manual. Para los idiomas existentes, compruebe si los tokens del sistema ya se han traducido.
• Al exportar y editar ficheros XML, es necesario asegurarse de que se mantenga la codificación UTF-8. Los problemas de codificación pueden aparecer como errores cuando un fichero se vuelve a importar o como cadenas localizadas con signos de interrogación u otros caracteres inesperados en lugar de letras acentuadas. ThingWorx se debe definir para utilizar UTF-8 como la codificación de ficheros por defecto. Especifique la opción -Dfile.encoding=UTF-8 de Java al inicio.
Eventos de widgets
Muchos widgets tienen eventos además de propiedades. Los eventos se pueden utilizar para iniciar servicios de datos. Si un widget tiene uno o más eventos, estos están disponibles en el panel Propiedades (con un icono de rayo) y mediante el menú contextual. Desde el menú contextual, se puede arrastrar un evento del widget a un servicio de datos.
Estilos de los widgets
Las definiciones de estilos son entidades definidas por el sistema para controlar el bloqueo y el procesamiento de un widget. Algunos widgets también soportan definiciones de estado, de modo que se pueden aplicar estilos dinámicamente según los valores de datos. Para obtener más información, consulte las secciones de widgets individuales. Para obtener información sobre el panel de propiedades, relativa a la aplicación de estilo a los widgets, consulte Temas.