Plate-forme de nouvelle génération

Modification de la barre de navigation fournie par l'application

Actuellement, la barre de navigation de l'application inclut des options de menu de recherche globale et d'alertes. Vous pouvez étendre la barre de navigation en fonction des besoins de votre entreprise et afficher les options de menu d'alerte ou de recherche globale personnalisée. Vous pouvez également masquer les options de menu globales ou d'alerte dans la barre de navigation ou ajouter une option de menu.

La barre de navigation prend en charge à la fois la substitution et l'extensibilité différentielle. En fonction de votre cas d'utilisation métier, vous pouvez choisir l'une de ces approches.

Dans l'approche d'extensibilité de substitution, vous pouvez être propriétaire du code source de la barre de navigation. Utilisez l'approche d'extensibilité de substitution comme point d'extension pour intégrer des fonctions qui ne peuvent pas être obtenues à l'aide de l'approche d'extensibilité différentielle dans la page d'accueil ou la barre de navigation. Pour plus d'informations, voir Personnaliser la barre de navigation grâce à l'extensibilité de l'override.

Extension des options de menu avec extensibilité différentielle

Actuellement, la barre de navigation contient des options de menu de recherche globale et d'alertes qui se trouvent dans le répertoire <store-temp>/<packages>/libs/functional-components/src/lib correspondant.
  • Le composant de navigation Alertes s'affiche dans la barre de navigation, qui affiche les alertes entrantes. Ce composant se trouve dans le répertoire <store-temp>/packages/libs/functional-components/src/lib/alert et se développe ou se réduit lorsque vous cliquez sur l'icône en forme de cloche.
  • Le composant de navigation Recherche globale s'affiche dans la barre de navigation. Vous pouvez effectuer une recherche globale pour ouvrir rapidement une commande. Ce composant se trouve dans le répertoire <store-temp>/packages/libs/functional-components/src/lib/global-search et se développe ou se réduit lorsque vous cliquez sur l'icône de recherche.
Les cas d'utilisation de personnalisation suivants sont pris en charge pour la barre de navigation:
  • Vous pouvez remplacer les options de menu de recherche globale et d'alerte fournies par l'application par des composants personnalisés.
  • Vous pouvez masquer les options de menu de recherche globale et d'alerte fournies par l'application.
  • Vous pouvez ajouter une option de menu. Pour plus d'informations, voir Ajouter une option de menu.

Pour mapper les options de menu de la barre de navigation fournie par l'application avec le composant personnalisé, utilisez le fichier <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json . Dans le fichier JSON, veillez à mapper les identificateurs uniques des composants fournis par l'application avec les composants remplacés.

Le tableau suivant décrit la définition de schéma du fichier isf-navbar-extn-config.json :
Tableau 1. Attributs et descriptions de la définition du schéma
Nom d'attribut Descriptif
menuTID Indique l'identificateur unique de l'option de menu affichée dans la barre de navigation.

Les valeurs valides sont navBarMenuWidget_1 ou navBarMenuWidget_2.

componentName Indique le nom du composant chargé dans la barre de navigation. Par exemple, AlertsExtnComponent ou GlobalSearchExtnComponent.
affichage Indique si l'option de menu doit être affichée ou masquée dans la barre de navigation.

Les valeurs valides sont true ou false. La valeur par défaut est true.

Lorsque vous remplacez un composant de navigation fourni par l'application, mettez à jour <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json avec les attributs décrits dans le tableau.

L'exemple de fichier isf-navbar-extn-config.json suivant montre comment masquer le menu de recherche globale et remplacer l'option de menu d'alerte fournie par l'application par le composant personnalisé AlertsExtensionComponent .

[
    {
        "menuTID": "navBarMenuWidget_1",
        "display": false
    },
    {
        "menuTID": "navBarMenuWidget_2",
        "componentName": "AlertsExtensionComponent"
    }
   
]

Procédure

  1. Créez un composant personnalisé.
    Accédez au répertoire <store-temp>/extensions/features/override-component/src/app/components et exécutez la commande suivante:
    ng g c <componentName> --prefix=isf
  2. Ajoutez la variable de chaîne statique overrideComponent avec la valeur comme nom de classe de composant, comme illustré.
    ....
    public static overrideComponent = 'AlertsExtensionComponent';
    ....
  3. Mettez à jour le nom de classe de composant personnalisé.

    Accédez au répertoire <store-temp>/extensions/features/override-component/src/app . Ouvrez le fichier app.module.ts et mettez à jour le nom de classe de composant personnalisé dans l'objet customComponentDeclarations .

  4. Mettez à jour le fichier <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json avec les détails appropriés. Par exemple, pour remplacer le composant d'alerte fourni par l'application par le AlertsExtensionComponentpersonnalisé, procédez à la mise à jour comme suit:
    [
        {
            "menuTID": "navBarMenuWidget_2",
            "componentName": "AlertsExtensionComponent"
        }
    
    ]
  5. Vérifiez que vos modifications sont reflétées dans la barre de navigation.
    Pour vérifier localement la barre de navigation fournie par l'application étendue, démarrez l'application en exécutant la commande suivante:
    yarn start-app

Etape suivante

Pour vérifier les modifications dans le kit d'outils de développement, extrayez et déployez les personnalisations. Pour plus d'informations sur l'extraction et le déploiement des personnalisations, voir Extraction des personnalisations.