Función
|
Descripción
|
---|---|
widgetProperties()
|
Permite obtener información sobre cada uno de los widgets del mashup. Se recupera información como, por ejemplo, el nombre mostrado y la descripción.
|
widgetEvents()
|
Permite obtener información sobre los eventos que se exponen en cada widget.
|
widgetServices()
|
Permite obtener información sobre los servicios que se exponen en cada widget.
|
Función
|
Descripción
|
---|---|
afterload()
|
Se invoca después de que se cargue el objeto y se hayan restaurado las propiedades del fichero, pero antes de que se haya representado el objeto.
|
Función
|
Descripción
|
---|---|
renderHtml()
|
Permite obtener el fragmento de HTML que está insertado en el elemento DOM del mashup.
|
afterRender()
|
Se invoca después de insertar el fragmento de HTML que representa el widget en el elemento DOM del mashup y se asigna un ID de elemento utilizable al elemento DOM que incluye el contenido del widget. Después, el elemento DOM está listo para la manipulación.
|
Función
|
Descripción
|
---|---|
beforeSetProperty()
|
Se invoca antes de que se actualice una propiedad de widget.
|
afterSetProperty()
|
Se invoca después de actualizar una propiedad de widget.
|
Función
|
Descripción
|
---|---|
beforeDestroy()
|
Se invoca antes de que se quite el elemento DOM del widget y el widget se desconecte del widget padre y se anule la asignación. Se deben liberar los recursos, tales como los plug-ins y los controladores de eventos que se adquieren durante la vida del widget. Para soportar la recarga del widget en un contenedor cargado de forma diferida, se debe añadir el argumento domOnly a la función beforeDesctroy() y, a continuación, destruir el widget solo cuando el valor sea falso. Si no se utiliza el argumento domOnly, la forma del widget se vuelve a cargar correctamente. Para obtener más información, consulte Uso de la carga diferida en un mashup.
|
Propiedad
|
Descripción
|
---|---|
Descripción
|
Descripción del widget, que se utiliza como sugerencia.
|
iconImage
|
Nombre de fichero del icono o la imagen del widget.
|
category
|
Matriz de cadenas que especifican las categorías en las que está disponible el widget.
Por ejemplo, Comunes, Gráficos, Datos, Contenedores, etc. De este modo, el usuario puede filtrar los widgets según el tipo de categoría.
|
isResizable
|
Permite especificar si se puede cambiar el tamaño del widget.
|
defaultBindingTargetProperty
|
Nombre de la propiedad que se debe utilizar como destino de enlace de datos o eventos.
|
borderWidth
|
Si el widget tiene un borde, defina esta propiedad en el ancho del borde. La propiedad ayuda a garantizar un diseño de píxeles perfectos durante el desarrollo y en tiempo de ejecución.
Por ejemplo, considere un widget cuyo tamaño en tiempo de ejecución debe ser 10X10 píxeles con un tamaño de borde de 1 píxel. En la fase de diseño, el tamaño del widget debe ser 8X8 píxeles para gestionar el píxel añadido en la fase de diseño. De este modo, el borde se coloca dentro del widget y hace que el ancho y la altura de las propiedades del widget sean precisos.
|
isContainer
|
Permite especificar si una instancia del widget puede ser un contenedor para otras instancias de widget. Los valores válidos son true y false. El valor por defecto de la propiedad es false.
|
customEditor
|
Nombre del cuadro de diálogo del editor personalizado que se debe utilizar para definir y editar la configuración del widget. En el proyecto de widget, cree un cuadro de diálogo con el nombre TW.IDE.Dialogs.<name>.
|
customEditorMenuText
|
El texto que aparece en el menú emergente del widget. También es el texto que aparece como sugerencia para los widgets de ThingWorx Composer. Por ejemplo, Configurar columnas de rejilla.
|
allowPositioning
|
Permite verificar si el widget se puede colocar en un panel. Los valores válidos son true y false. El valor por defecto de la propiedad es true.
|
supportsLabel
|
Permite especificar si el widget soporta la propiedad Rótulo. Los valores válidos son true y false. El valor por defecto de la propiedad es false.
Cuando se define en true, el widget expone una propiedad de rótulo. Esta propiedad se utiliza para crear un rótulo de texto que aparece junto al widget en ThingWorx Composer y en tiempo de ejecución.
|
supportsAutoResize
|
Permite especificar si el widget soporta automáticamente el cambio de tamaño. Los valores válidos son true y false. El valor por defecto de la propiedad es false.
Cuando se define en true, el widget se puede colocar en contenedores dinámicos, como columnas, filas, fichas dinámicas y mashups dinámicos.
|
properties
|
Una recopilación de objetos JSON para el widget que describen las propiedades del widget que se pueden modificar cuando el widget se añade a un mashup. Estas propiedades se muestran en la ventana de propiedades de Mashup Builder con el nombre de cada objeto que se utiliza como nombre de propiedad. Los atributos correspondientes controlan cómo se define el valor de la propiedad.
Por ejemplo:
properties: {
Prompt: { defaultValue: 'Search for...', baseType: STRING, isLocalizable: true }, Width: { defaultValue: 120 }, Height: { defaultValue: 20, isEditable: false }, } |
Atributo
|
Descripción
|
||||
---|---|---|---|---|---|
Descripción
|
Descripción del widget que se utiliza para la sugerencia.
|
||||
baseType
|
Tipo base del widget. Si el valor de tipo base es FIELDNAME, en la ventana de propiedades del widget se muestra una lista de campos disponibles en la infotable. Los campos se enlazan al valor sourcePropertyName en función de la restricción de tipo base.
Los demás tipos base especiales son:
• STATEDEFINITION: permite seleccionar una definición de estado.
• STYLEDEFINITION: permite seleccionar una definición de estilo.
• RENDERERWITHSTATE: permite mostrar un cuadro de diálogo en el que se puede seleccionar un procesador de datos y un formato de estado.
• STATEFORMATTING: permite mostrar un cuadro de diálogo en el que se puede seleccionar un estilo fijo o un estilo basado en estado.
• VOCABULARYNAME: permite seleccionar el vocabulario de etiquetas de datos en tiempo de ejecución.
|
||||
mustImplement
|
Si el tipo base es THINGNAME y se especifica el atributo mustImplement, Mashup Builder restringe el cuadro de diálogo para abrir solo los elementos emergentes que permiten implementar los valores de Tipo de entidad y Nombre de entidad especificados. Mashup Builder llama a la función QueryImplementingThings para validar si el valor pasado es de la clase Tipo de entidad y verifica si se ha implementa Nombre de entidad.
Por ejemplo:
'baseType': 'THINGNAME',
'mustImplement': { 'EntityType': 'ThingShapes', 'EntityName': 'Blog' } |
||||
baseTypeInfotableProperty
|
Si el tipo base del widget se define en RENDERERWITHFORMAT, el atributo especifica la propiedad de la infotable que se utiliza para la configuración.
|
||||
sourcePropertyName
|
Si el tipo base del widget se define en FIELDNAME, el atributo verifica qué propiedad de la infotable se utiliza para la configuración.
|
||||
baseTypeRestriction
|
Si se especifica este atributo, el valor se utiliza para restringir los campos disponibles en la lista desplegable FIELDNAME.
|
||||
tagType
|
Si el tipo base se define en TAGS, el atributo especifica el tipo de etiqueta. Los valores válidos son DataTags, que es el valor por defecto, o ModelTags.
|
||||
defaultValue
|
Se utiliza para definir el valor por defecto de una propiedad. El valor por defecto no está definido.
|
||||
isBindingSource
|
Permite especificar si la propiedad es un origen de enlace de datos. Los valores válidos son true y false. El valor por defecto de la propiedad es fasle.
|
||||
isBindingTarget
|
Permite especificar si la propiedad es un destino de enlace de datos. Los valores válidos son true y false. El valor por defecto de la propiedad es fasle.
|
||||
isEditable
|
Permite especificar si la propiedad es editable enThingWorx Composer. Los valores válidos son true que es el valor por defecto y false.
|
||||
isVisible
|
Permite especificar si la propiedad está visible en la ventana de propiedades. Los valores válidos son true y false. El valor por defecto de la propiedad es true.
|
||||
isLocalizable
|
Permite especificar si la propiedad se puede localizar. Este atributo es obligatorio cuando el tipo base se ha definido en STRING. Los valores válidos son true y false.
|
||||
selectOptions
|
Una matriz de estructuras de texto de visualización o valores.
Por ejemplo:
[{value: ‘optionValue1’, text: ‘optionText1’},
{value: ‘optionValue2’, text: ‘optionText2’}] |
||||
warnIfNotBoundAsSource
|
ThingWorx Composer verifica si la propiedad es un origen de enlace de datos. Los valores válidos son true y false.
Si el valor de atributo se define en true, pero la propiedad no está enlazada, ThingWorx Composer genera una lista de elementos que se deben completar para guardar el mashup.
|
||||
warnIfNotBoundAsTarget
|
Composer verifica si la propiedad es un destino de enlace de datos. Los valores válidos son true y false.
Si el valor de atributo se define en true, pero la propiedad no está enlazada, ThingWorx Composer genera una lista de elementos que se deben completar para guardar el mashup.
|