Personalización de ThingWorx Navigate > Creación de tareas personalizadas > Creación de una tarea personalizada mediante componentes > Introducción a los componentes de ThingWorx Navigate > Componentes disponibles > Identidad del elemento
Identidad del elemento
Definición y uso
El componente Identidad del elemento es un widget que permite mostrar información básica, también conocida como información de identidad, en un elemento específico. La información aparece en un panel, normalmente en la parte superior de la página del elemento. En el panel se incluyen la imagen, el título principal, el título secundario, el icono secundario y los distintos atributos de identidad del elemento. El icono secundario indica el tipo de elemento y se puede configurar para utilizar iconos de Windchill. El componente Identidad del elemento también incluye una barra de acciones integrada, que contiene las acciones que se pueden ejecutar en el elemento.
A continuación, se presenta una imagen de ejemplo en la que se muestra el componente Identidad del elemento:
El componente Identidad del elemento se puede configurar de las siguientes maneras:
• Definir los títulos principal y secundario
• Configurar las acciones disponibles en la Barra de acciones integrada.
• Definir los atributos de identidad que se deben mostrar.
• Elegir si se debe mostrar una imagen y definir una ruta de la imagen por defecto
• Elegir si se debe mostrar un icono secundario
• Elegir si se puede contraer el panel
Identidad de la tarea, Identidad del artículo e Identidad del documento son las configuraciones predefinidas disponibles para el componente Identidad del elemento.
Propiedades de enlace 
Entrada
Nombre de la propiedad
Descripción
Tipo de propiedad
Input
Se utiliza para identificar los datos que se deben extraer del sistema back-end. A continuación, se proporciona un ejemplo:
JSON de ejemplo:
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
* 
Para el componente Identidad del elemento, la propiedad de configuración attributes y la propiedad de enlace input deben utilizar el mismo adaptador del sistema back-end. Por lo tanto, al utilizar el componente, asegúrese de que la entrada y la configuración tengan los mismos valores para thingName y instanceName en la clave adapter.
JSON en formato CCO
TailoringName
Identifica de forma exclusiva una instancia del componente Identidad del elemento. Este valor se utiliza internamente para buscar información de personalización de esa instancia específica.
Utilice esta propiedad de enlace solo cuando haya una página de personalización dedicada para la tarea personalizada.
Cadena
Propiedades de configuración 
En la tabla y las imágenes siguientes se muestran las propiedades JSON que se utilizan para configurar este componente.
Para obtener más información sobre la estructura de la configuración, consulte Estructura de configuración de componentes.
Para obtener más información sobre las subpropiedades, consulte Subpropiedades y claves de contenedor.
Nombre de la propiedad
Descripción
Tipo de propiedad
Valor por defecto
Obligatorio u opcional
actionBarConfiguration
Acciones que se deben mostrar en la barra de acciones de la interfaz de usuario. Para obtener más información, consulte el componente Barra de acciones.
N/D
Opcional
attributes
La lista de atributos para los que se extraen los datos del sistema back-end.
* 
• Para el componente Identidad del elemento, la propiedad de configuración attributes y la propiedad de enlace input deben utilizar el mismo adaptador del sistema back-end. Por lo tanto, al utilizar el componente, asegúrese de que la entrada y la configuración tengan los mismos valores para thingName y instanceName en la clave adapter.
• Aunque los atributos de la configuración no se extraen mediante un adaptador, el componente requiere el uso de los mismos valores para thingName y instanceName en la configuración que se utilizan en la entrada.
• El componente Identidad del elemento no soporta el uso de varios adaptadores.
N/D
Opcional
defaultImagePath
La ruta por defecto para extraer la imagen.
Esta propiedad es una subpropiedad de showImage y solo es pertinente cuando showImage se define en true. Su clave de contenedor es itemIdentityShowImageDefinition.
N/D
Obligatorio cuando showImage se define en true.
enableExpandCollapse
Permite determinar si el panel Identidad del elemento se puede contraer y expandir en la interfaz de usuario.
Cuando se define en true, el panel se puede contraer para mostrar solo el título principal y, cuando sea pertinente, la barra de acciones.
Cuando se define en false, el panel no se puede contraer y siempre está totalmente expandido.
true
Obligatorio
primaryTitle
El título principal que aparece en la parte superior del panel Identidad del elemento.
N/D
Obligatorio
secondaryTitle
El título secundario, que aparece debajo del título principal en el panel Identidad del elemento.
N/D
Obligatorio
showImage
Determina si se debe mostrar una imagen en el panel Identidad del elemento.
Opciones: true, false.
Cuando se define en true, se muestra una imagen en el panel. Defina la ruta de la imagen mediante la propiedad defaultImagePath.
Cuando se define en false, no se muestra ninguna imagen.
N/D
Obligatorio
showSecondaryIcon
Si se debe mostrar un icono secundario.
Opciones: true, false.
Cuando se define en true, se muestra un icono secundario en el panel. Cuando se define en false, no se muestra ningún icono secundario.
false
Obligatorio
Configuración de ejemplo 
Para obtener configuraciones de ejemplo del componente Identidad de elemento, consulte Identidad de la tarea, Identidad del artículo e Identidad del documento.
Servicios de personalización 
Además de la configuración, cada componente soporta la extensión de la lógica empresarial para personalizar el componente. En la lógica empresarial de cada componente se incluyen los servicios desestimables en una plantilla de cosa que se pueden extender y sustituir. En la tabla siguiente se describen los servicios desestimables de este componente.
Para obtener ejemplos de las devoluciones y los parámetros de cada servicio, consulte Ejemplos de entrada/salida para servicios de personalización.
Nombre
Descripción
GetConfigurations
Devuelve las configuraciones disponibles para la implementación de componentes.
Parámetros: ninguno
Devuelve: JSON
GetImplementationLabel
Devuelve el nombre localizado del componente o el token que se puede utilizar para obtener el nombre localizado. Este nombre localizado se muestra en la interfaz de usuario de Mashup Builder.
Parámetros: ninguno
Devuelve: Cadena
ProcessAttributesConfiguration
Procesa la configuración de atributos y divide los atributos en atributos de fábrica y atributos adicionales.
Devuelve un JSON con pares de valores de clave de la siguiente forma:
• OOTBAttributes : OOTB Attributes configuration CCO JSON
• additionalAttributes : Additional Attributes configuration CCO JSON
Los atributos se dividen en atributos de fábrica y atributos adicionales según su tipo de objeto. Los atributos que tienen un tipo de objeto que termina con .Custom.Adapter o .Custom.Implementation se tratan como atributos adicionales. Todos los demás atributos se consideran atributos de fábrica.
El componente Identidad del elemento no soporta el uso de solo atributos con un tipo de objeto que termine en .Custom.Implementation. Asegúrese de utilizar como mínimo un atributo con un tipo de objeto diferente.
Parámetros:
attributes (obligatorio): JSON con la lista de atributos de fábrica y atributos adicionales.
configuration (opcional): JSON con la configuración combinada final obtenida del recurso del administrador de personalización.
Devuelve: JSON en formato CCO
GetItemIdentityAttributes
Verifica la configuración y añade los atributos adicionales que son obligatorios y, a continuación, llama a GetAttributeValues para extraer todos los valores de atributo del sistema back-end.
Parámetros:
input (obligatorio): JSON en formato CCO en el que se incluye el ID de entrada de los datos que se van a extraer del sistema back-end y la información del adaptador para el sistema back-end.
configuration (opcional): JSON con la configuración combinada final obtenida del recurso del administrador de personalización.
attributes (obligatorio): JSON con la lista de atributos de fábrica, tal como se define en la configuración o mediante la personalización.
Devuelve: JSON
GetAttributesValues
Devuelve un JSON con atributos y sus valores.
Parámetros:
input (obligatorio): JSON en formato CCO en el que se incluye el ID de entrada de los datos que se van a extraer del sistema back-end y la información del adaptador para el sistema back-end.
configuration (opcional): JSON con la configuración combinada final obtenida del recurso del administrador de personalización.
attributes (obligatorio): JSON con la lista de atributos de fábrica y atributos adicionales.
Devuelve: JSON en formato CCO
GetAdditionalAttributes
Devuelve la lista de atributos adicionales que se van a añadir a la lista de atributos de fábrica disponibles.
Parámetros: ninguno
Devuelve: JSON
Definición de implementación 
Para obtener definiciones de implementación del componente Identidad de elemento, consulte Identidad de la tarea, Identidad del artículo e Identidad del documento.
¿Fue esto útil?