Identité d'élément
Définition et mode d'utilisation
Le composant Identité d'élément est un widget qui vous permet d'afficher des informations de base, ou informations d'identité, sur un élément spécifique. Ces informations s'affichent dans un panneau, généralement sur la partie supérieure de la page de l'élément. Ce panneau contient l'image, le titre principal, le titre secondaire, l'icône secondaire et différents attributs d'identité pour l'élément. L'icône secondaire indique le type d'élément et peut être configurée pour utiliser des icônes Windchill. Le composant Identité d'élément contient également une barre d'actions intégrée, qui regroupe les actions que vous pouvez exécuter sur l'élément. Vous pouvez développer ou réduire le panneau Identité d'élément à l'aide de la flèche située dans la partie supérieure gauche du panneau. Lorsque ce panneau est réduit, seul le titre principal et la barre d'actions sont visibles.
La capture d'écran suivante vous donne un aperçu du composant Identité d'élément :
Vous pouvez configurer le composant Identité d'élément de l'une des manières suivantes :
• Définir les titres principaux et secondaires
• Configurer les actions disponibles dans la barre d'actions intégrée
• Définir les attributs d'identité à afficher
• Indiquez si vous souhaitez afficher une image et définissez un chemin d'image par défaut.
• Choisir d'afficher ou non une icône secondaire
Identité des tâches et Identité d'article sont des configurations prédéfinies disponibles pour le composant Identité d'élément.
Propriétés de liaison
Entrée | ||||
|---|---|---|---|---|
Nom de la propriété | Description | Type de propriété | ||
Input | Utilisé pour identifier les données à récupérer à partir du système principal. Voici un exemple : Exemple de JSON : { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] }
| JSON au format CCO | ||
TailoringName | Identifie de manière unique une instance du composant Identité d'élément. Cette valeur est utilisée en interne pour rechercher des informations sur la personnalisation de cette instance spécifique. N'utilisez cette propriété de liaison que lorsqu'il existe une page de personnalisation dédiée pour votre tâche personnalisée. | Chaîne | ||
Propriétés de configuration
Les tableaux ci-après présentent les propriétés JSON utilisées pour configurer ce composant.
Pour plus d'informations sur la structure de la configuration, consultez la rubrique Structure de configuration du composant.
Pour plus d'informations sur les sous-propriétés, consultez la rubrique Sous-propriétés et clés de conteneur.
Nom de la propriété | Description | Type de propriété | Valeur par défaut | Obligatoire ou facultatif ? | |||
|---|---|---|---|---|---|---|---|
actionBarConfiguration | Actions à afficher dans la barre d'actions de l'interface utilisateur. Pour plus d'informations, consultez la section relative au composant Barre d'actions. | N/A | Facultatif | ||||
attributes | La liste des attributs pour lesquels les données sont récupérées à partir du système principal.
| N/A | Facultatif | ||||
defaultImagePath | Le chemin par défaut pour la récupération de l'image. Cette propriété est une sous-propriété de showImage et est uniquement pertinente lorsque showImage est défini sur true. Sa clé de conteneur est itemIdentityShowImageDefinition. | N/A | Obligatoire lorsque showImage est défini sur true. | ||||
primaryTitle | Titre principal qui apparaît dans la partie supérieure du panneau Identité d'élément. | N/A | Obligatoire | ||||
secondaryTitle | Le titre secondaire qui apparaît sous le titre principal dans le panneau Identité d'élément. | N/A | Obligatoire | ||||
showImage | Détermine s'il convient d'afficher une image dans le panneau Identité d'élément. Options : true, false. Lorsque cette option est définie sur true, une image s'affiche dans le panneau. Définissez le chemin d'image à l'aide de la propriété defaultImagePath. Lorsque cette option est définie sur false, aucune image n'est affichée. | N/A | Obligatoire | ||||
showSecondaryIcon | Indique s'il faut afficher une icône secondaire. Options : true, false. Lorsque cette option est définie sur true, une icône secondaire s'affiche dans le panneau. Lorsque cette option est définie sur false, aucune icône secondaire n'est affichée. | false | Obligatoire | ||||
Exemple de configuration
Pour obtenir des exemples de configurations pour le composant Identité d'élément, consultez les rubriques Identité des tâches et Identité d'article.
Services de personnalisation
En plus de la configuration, chaque composant prend en charge l'extension de sa logique métier afin de le personnaliser. La logique métier de chaque composant inclut des services substituables dans un modèle d'objet que vous pouvez étendre et remplacer. Les services substituables pour ce composant sont détaillés dans le tableau suivant.
Vous trouverez des exemples de renvois et de paramètres pour chaque service à la rubrique Exemples d'entrée/sortie pour les services de personnalisation.
Nom | Description |
|---|---|
GetConfigurations | Renvoie les configurations disponibles pour l'implémentation du composant. Paramètres : aucun Renvois : JSON |
GetImplementationLabel | Renvoie soit le nom localisé du composant, soit le jeton qui peut être utilisé pour obtenir le nom localisé. Ce nom localisé s'affiche dans l'interface utilisateur de Mashup Builder. Paramètres : aucun Renvois : chaîne |
ProcessAttributesConfiguration | Traite la configuration des attributs et divise ces derniers en attributs standard et attributs supplémentaires. Renvoie un JSON avec des paires de valeurs clés sous la forme suivante : • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON Les attributs sont divisés en ceux standard et supplémentaires en fonction de leur type d'objet. Les attributs dont le type d'objet se termine par .Custom.Adapter ou .Custom.Implementation sont traités comme des attributs supplémentaires. Tous les autres attributs sont considérés comme des attributs standard. Le composant Identité d'élément ne prend pas en charge l'utilisation seule d'attributs avec un type d'objet se terminant par .Custom.Implementation. Assurez-vous d'utiliser au moins un attribut avec un type d'objet différent. Paramètres : attributes (obligatoire) : JSON avec la liste des attributs standard et supplémentaires. configuration (facultatif) : JSON avec la configuration fusionnée finale obtenue à partir de la ressource de gestionnaire de personnalisations. Renvois : JSON au format CCO |
GetItemIdentityAttributes | Vérifie la configuration et ajoute les éventuels attributs supplémentaires obligatoires, puis appelle GetAttributeValues pour récupérer toutes les valeurs d'attributs du système principal. Paramètres : input (obligatoire) : JSON au format CCO qui comprend l'ID d'entrée pour les données à récupérer du système principal et les informations d'adaptateur pour le système principal. configuration (facultatif) : JSON avec la configuration fusionnée finale obtenue à partir de la ressource de gestionnaire de personnalisations. attributes (obligatoire) : JSON contenant la liste des attributs standard, tels que définis dans la configuration ou établis via la personnalisation. Renvois : JSON |
GetAttributesValues | Renvoie un JSON avec des attributs et leurs valeurs. Paramètres : input (obligatoire) : JSON au format CCO qui comprend l'ID d'entrée pour les données à récupérer du système principal et les informations d'adaptateur pour le système principal. configuration (facultatif) : JSON avec la configuration fusionnée finale obtenue à partir de la ressource de gestionnaire de personnalisations. attributes (obligatoire) : JSON avec la liste des attributs standard et supplémentaires. Renvois : JSON au format CCO |
GetAdditionalAttributes | Renvoie la liste des attributs supplémentaires à ajouter à la liste des attributs standard disponibles. Paramètres : aucun Renvois : JSON |
Définition de l'implémentation
Pour obtenir les définitions d'implémentation du composant Identité d'élément, consultez les rubriques Identité des tâches et Identité d'article.