Gestion de la personnalisation de l'interface utilisateur et des modèles dans SAP CPQ

Utilisation de modèles réactifs

Objectives

After completing this lesson, you will be able to:
  • Personnalisez les pages SAP CPQ à l'aide de modèles réactifs.
  • Configurez la visibilité des modèles réactifs personnalisés pour des groupes d'utilisateurs spécifiques.
  • Personnalisez l'interface utilisateur SAP CPQ à l'aide d'outils de développement intégrés.

Modèles réactifs

La figure illustre l'écran Modifier de la page Catalogue.

Chaque page de l'application est constituée d'au moins un modèle. Par exemple, la page Catalogue se compose du modèle CatalogPage, tandis que la page ApprovalHistory se compose des modèles ApprovalHistoryPage et Editeurs/DelegatedApprovers. Certains modèles sont utilisés sur plusieurs pages dans SAP CPQ. Ces modèles sont stockés dans la page Partagé.

Les modèles réactifs peuvent être laissés tels quels. Les modèles principaux sont toujours compatibles avec les nouvelles fonctionnalités de SAP CPQ ; vous n'avez pas besoin de les modifier chaque fois qu'une version se produit. La conservation de l'état d'origine des modèles principaux réduit le risque de rupture des modifications et entraîne un dysfonctionnement du logiciel. Cependant, il existe une option pour personnaliser les environnements en modifiant les modèles réactifs. Si vous personnalisez des modèles, gérez-les à chaque version. Il est fortement recommandé de personnaliser les modèles réactifs uniquement si nécessaire et avec un minimum de modifications qui peuvent être facilement suivies et modifiées.

Modifiez le contenu HTML de n'importe quelle page de l'application tout en conservant ses fonctionnalités de base : utilisez des modèles réactifs, accessibles à l'adresse Configurer→la conception de l'interface utilisateur→Modèles réactifs.

Personnalisation des pages SAP CPQ

Explorez une séquence de listes déroulantes et recherchez la section exacte d'une page SAP CPQ que vous souhaitez modifier. Copiez le modèle par défaut pour dupliquer le modèle par défaut (dans le volet supérieur) dans votre nouveau modèle (dans le volet inférieur). Le code du volet inférieur est exécuté lorsque la section Totaux du devis est affichée pour toute personne affectée à ce modèle.

Si vous cochez la case Par défaut, ce modèle devient le code HTML par défaut pour cette section.

Limitations des modèles personnalisés pour des groupes d'utilisateurs spécifiques

Figure illustrant les cases à cocher permettant de limiter la visibilité des modèles personnalisés.

Vous pouvez limiter la visibilité des modèles personnalisés à des groupes d'utilisateurs spécifiques. Si vous laissez la case décochée, le modèle sera utilisé uniquement lorsque les utilisateurs d'un type d'utilisateur particulier visitent. Pour ce faire, vous devez appliquer ce modèle à un ou plusieurs types d'utilisateur. Par exemple, vous pouvez appliquer ce modèle à un ou plusieurs types d'utilisateur en affectant un modèle personnalisé au type d'utilisateur donné.

Le framework Knockout conserve un lien actif entre la page du navigateur et les objets ViewModel et un autre lien entre ces objets et le serveur. Vous pouvez accéder aux méthodes Web sur le serveur SAP CPQ via les éléments JavaScript de la page.

Remarque

Lorsque vous décidez de modifier des modèles réactifs pour implémenter une exigence donnée, n'oubliez pas que vous êtes désormais propriétaire de la fonctionnalité de cette page. Vous êtes désormais responsable du suivi des mises à jour des modèles de système. SAP CPQ ne fusionne pas les mises à jour ultérieures de ses modèles HTML avec votre version personnalisée.

Le propriétaire du modèle n'est pas rappelé aux mises à jour effectuées après une personnalisation. Cependant, la page Historique du modèle affiche une ligne pour chaque mise à jour de la version système du modèle. Consultez le code mis à jour pour déterminer si des modifications du code sont nécessaires.

Pour chaque version de SAP CPQ qui suit la mise en production de votre implémentation, l'équipe de maintenance vérifie que chaque modèle avec un équivalent système mis à jour continue à fonctionner correctement, selon les besoins. Tenez compte de l'impact sur l'équipe de maintenance responsable de la mise à jour des pages personnalisées. Certaines modifications peuvent passer inaperçues dans vos procédures de test.

Remarque

Il est recommandé d'essayer toutes les autres options avant de choisir de modifier le HTML. Cette approche ne doit être prise en compte que lorsque les avantages l'emportent sur les coûts et les risques de maintenance.

Pour éviter d'interrompre les modifications, corrigez les problèmes indépendamment en modifiant les modèles personnalisés pour vous assurer qu'ils sont compatibles avec les autres modèles sur les mêmes pages avant le déploiement de la prochaine version.

Geler les modèles

Le gel des modèles est une fonctionnalité précieuse qui vous permet de rétablir l'état précédent de SAP CPQ pour un modèle non personnalisé (d'origine). Voici quelques avantages clés de l'utilisation de cette fonctionnalité :

  • Rollback pour la stabilité : si la rupture des modifications perturbe votre workflow, le gel du modèle vous permet de revenir à une version stable, réduisant ainsi les temps d'arrêt et les problèmes opérationnels.

  • Support pendant la transition Si vous rencontrez des problèmes liés à l'interruption des modifications que vous ne pouvez pas résoudre vous-même avant la version de production, le retrait du modèle offre une protection, ce qui vous permet de continuer à travailler sans interruption.

En utilisant la fonctionnalité de gel des modèles, vous pouvez assurer la continuité de vos opérations et gérer efficacement les modifications dans l'environnement SAP CPQ.

Personnalisation de SAP CPQ avec les outils de développement intégrés

L'endroit où vous trouverez la commande Injecter.

Les outils de développement intégrés dans SAP CPQ permettent de localiser un élément de page de modèle à personnaliser. Affichez la source de la page et faites défiler jusqu'au commentaire le plus proche indiquant le début d'un modèle réactif.

Cliquez avec le bouton droit de la souris sur n'importe quel élément disponible dans CPQ et sélectionnez Inspecter. Le code HTML s'affiche. Faites défiler vers le haut dans le panneau Éléments et le code HTML de l'élément est affiché par le modèle Section/Éléments.

Le document suivant fournit plus d'informations sur la personnalisation des modèles réactifs.

Séparateur optique pour illustrer la position centrale de la boîte à outils Knockout.

La boîte à outils la plus complexe du framework de personnalisation de l'interface utilisateur SAP CPQ combine l'utilisation du framework JavaScript Knockout, des fonctions d'extension et du JavaScript dans les modèles réactifs.

Knockout est une implémentation du modèle MVVM (Model-View-ViewModel). Dans le navigateur client, les objets JavaScript imbriqués fournissent le ViewModel, qui stocke les données des objets SAP CPQ.

Les objets ViewModel se trouvent entre les pages générées dans le navigateur et le serveur SAP CPQ en arrière-plan. Une mise à jour dans ViewModel est immédiatement reflétée sur votre écran (dans Vue), puis automatiquement synchronisée avec le backend du serveur. Ce comportement se produit lorsque vous liez des éléments HTML individuels de votre modèle à des propriétés spécifiques des objets ViewModel. Les deux extrémités du processus de synchronisation sont gérées par Knockout.

Ce processus vous permet de configurer une logique JavaScript personnalisée pour définir et contrôler dynamiquement le comportement des éléments de l'interface utilisateur. Les objets ViewModel et les propriétés (interface) qu'ils exposent à un contrôle IU donné dépendent du contexte en fonction de la section HTML actuelle.

Découvrez quels objets sont accessibles pour un élément IU donné à l'aide de l'extension Chrome Knockout Context Debugger (Knockouts).