Ajout d'un attribut personnalisé au composant Vignette
Le composant réutilisable Vignette affiche les attributs dont le système principal est Windchill. Vous pouvez également ajouter les attributs personnalisés qu'affichera le composant Vignette. Il s'agit d'attributs dont le système principal n'est pas Windchill, ou qui nécessitent une logique personnalisée pour la dérivation de leurs valeurs.
Pour ajouter un attribut personnalisé au composant Vignette, procédez comme indiqué dans les sections ci-dessous.
Créer un attribut personnalisé pour le composant Vignette
1. Créez un modèle d'objet dans ThingWorx Composer. Définissez le champ Modèle d'objet de base sur PTC.TileAttributeModelThingTemplate.
2. Sous l'onglet
Services, cliquez sur l'élément
dans la ligne
GetCustomAttributes.
3. Ajoutez une logique pour créer un ou plusieurs attributs personnalisés. L'ObjectType doit se terminer par .Custom. Le format de sortie de cette API est un objet CCO au format JSON. Voici un exemple de ce à quoi la sortie doit ressembler :
{
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": ""
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"version": "1.0.0"
}
4. Enregistrez les modifications apportées au modèle d'objet.
5. Créez un objet dans ThingWorx Composer. Définissez le champ Modèle d'objet de base sur le modèle d'objet que vous avez créé précédemment. Enregistrez l'objet.
Ajouter votre attribut personnalisé à la page de personnalisation de Mes tâches
Si vous souhaitez que votre attribut personnalisé apparaisse dans la page de personnalisation de Mes tâches, procédez comme suit :
1. Recherchez l'objet nommé PTC.ViewMyTasks.TailoringPage.TilesAttributesThing dans ThingWorx Composer. Sélectionnez cet objet.
2. Sous l'onglet
Propriétés et alertes, cliquez sur l'élément
dans la ligne
modelThing.
3. Saisissez le nom de l'objet que vous avez créé ci-dessus. Enregistrez PTC.ViewMyTasks.TailoringPage.TilesAttributesThing.
Désormais, vos attributs personnalisés apparaissent dans la page de personnalisation de Mes tâches.
Récupérer des valeurs pour votre attribut personnalisé
1. Ouvrez le modèle d'objet que vous avez créé précédemment.
2. Sous l'onglet
Services, cliquez sur l'élément
dans la ligne
GetCustomAttributesValues. Il prend les entrées suivantes :
◦ input : ID d'entrée pour lequel les données doivent être récupérées.
◦ configuration : attributs sélectionnés dans la page de personnalisation.
◦ OOTBResponse : réponse pour les attributs personnalisés standard.
3. Si nécessaire, ajoutez une logique pour récupérer les valeurs de vos attributs personnalisés à l'aide des paramètres ci-dessus. La réponse doit être dans un format semblable à celle de l'exemple suivant :
{
"timeStamp": "2019-08-14 15:40:45.175",
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": "5"
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"statusMessage": "OK",
"status": "200"
}
4. Enregistrez le modèle d'objet.
Ajouter votre attribut personnalisé à une application composite
1. Créez une application composite ou ouvrez une application composite existante.
2. Insérez un composant Vignette dans votre application composite, puis cliquez sur l'élément
pour configurer ce composant.
3. Modifiez la valeur de la propriété modelThing afin que sa valeur soit identique au nom de l'objet que vous avez créé précédemment.
4. Cliquez sur Terminé et enregistrez l'application composite.
| Le composant Vignette prend en charge l'intégration de modèles personnalisés pour ajouter des attributs personnalisés lors de la personnalisation de la zone Mes tâches. Si vous sélectionnez un attribut personnalisé lors de la personnalisation, puis que vous modifiez le modèle sur l'objet de personnalisation pour ajouter un nouvel attribut personnalisé, l'attribut personnalisé sélectionné précédemment sera toujours affiché dans la page de détails de la demande de modification de la collection Tâches de gestion des modifications. Pour veiller à ce que l'attribut sélectionné précédemment n'apparaisse pas sur la page de détails, enregistrez la page de personnalisation après avoir mis à jour l'objet de personnalisation. |
