spartacus
@spartacus
Bonjour et bienvenue !
Ce README fait partie de la branche develop , qui est une branche de développement active dans le référentiel Spartacus. En tant que tel, le texte suivant peut contenir des références à des travaux en cours et non encore officiellement publiés.
À partir de la version 2211.19, la vitrine composable a aligné son versioning avec SAP Commerce Cloud. La version précédente de la vitrine composable était la version 6.8. Pour plus d'informations, consultez Modifications apportées à la numérotation des versions et aux politiques de mise à jour pour Composable Storefront à partir de février 2024.
À partir de la version 5.0, « SAP Commerce Cloud, composable storefront » est le nom de la version officielle des bibliothèques du projet « Spartacus » publiées par SAP. La vitrine composable officiellement prise en charge est disponible pour les clients SAP Commerce Cloud. La documentation est disponible sur le portail d'aide SAP.
La vitrine Composable est basée sur le code open source Spartacus et est incluse dans la licence SAP Commerce Cloud sans frais supplémentaires. La vitrine Composable a une politique de mise à jour progressive.
Les clients sur site peuvent toujours utiliser l'open source Spartacus. Pour plus d'informations, consultez Bibliothèques Spartacus auto-éditées à l'aide du code Open Source.
Spartacus est une vitrine JavaScript simplifiée basée sur Angular pour SAP Commerce Cloud. Spartacus communique avec SAP Commerce Cloud exclusivement via l'API Commerce REST.
Spartacus est...
Spartacus fournit des fonctionnalités de vitrine de base telles que :
Consultez la documentation de version sur le portail d'aide SAP pour plus d'informations.
Si vous travaillez avec Spartacus 2211, consultez les exigences relatives à l'environnement de développement angulaire 2211 sur le portail d'aide SAP.
Si vous travaillez avec Spartacus 6.x, consultez les exigences pertinentes en matière d'environnement de développement Angular 6.x sur le portail d'aide SAP.
Si vous travaillez avec Spartacus 5.x, consultez les exigences pertinentes en matière d'environnement de développement Angular 5.x sur le portail d'aide SAP.
Pour connaître les exigences du back-end, consultez la matrice de compatibilité Composable Storefront.
Si vous travaillez avec Spartacus 4.x, votre environnement de développement Angular doit inclure les éléments suivants :
Si vous travaillez avec Spartacus 3.x, votre environnement de développement Angular doit inclure les éléments suivants :
Si vous travaillez avec Spartacus 2.x, votre environnement de développement Angular doit inclure les éléments suivants :
Si vous travaillez avec Spartacus 1.x, votre environnement de développement Angular doit inclure les éléments suivants :
Pour le back-end, SAP Commerce Cloud version 1905 ou supérieure est requis, et SAP Commerce Cloud version 2005 ou ultérieure est recommandé.
Remarque : Certaines fonctionnalités de Spartacus nécessitent des points de terminaison d'API qui ne sont disponibles que dans les versions plus récentes de SAP Commerce Cloud. Pour plus d'informations, voir Matrice de compatibilité sur le portail d'aide SAP.
Pour être opérationnel avec Spartacus, l'approche recommandée consiste à créer votre application de vitrine à partir de bibliothèques prêtes à l'emploi. Vous pouvez également cloner et créer à partir des sources, mais la mise à niveau n'est pas aussi simple.
Spartacus ne peut actuellement être utilisé qu'avec une instance SAP Commerce Cloud via les API Commerce.
Pour ajouter rapidement des bibliothèques Spartacus à une application Angular, vous pouvez utiliser les schémas Spartacus : ng add @spartacus/schematics . Cela configurera et installera les bibliothèques Spartacus sur votre projet Angular. Veuillez consulter la documentation officielle des schémas Spartacus pour connaître tous les prérequis et les instructions sur la façon d'utiliser les schémas Spartacus.
Pour obtenir des instructions de configuration complètes, voir Configuration de Composable Storefront sur le portail d'aide SAP.
Pour tenir notre promesse d'évolutivité, le modèle de conception de Spartacus consiste à créer des fonctionnalités non essentielles sous forme de bibliothèques de fonctionnalités qui ajoutent ou modifient les fonctionnalités fournies.
Lorsque vous utilisez Spartacus, vous créez une application qui extrait les bibliothèques Spartacus, qui contiennent les ressources de base nécessaires pour travailler avec SAP Commerce. Vous créez ensuite de nouvelles fonctionnalités contenant des fonctionnalités et des pages personnalisées.
Le contenu des pages Spartacus est récupéré à partir du CMS (Content Management System) SAP Commerce Cloud, tel que les logos, les liens, les bannières et les pages statiques. Nous recommandons que les nouvelles fonctionnalités basées sur le contenu suivent le même modèle pour permettre aux gestionnaires de contenu de modifier le contenu des pages via les outils CMS.
La documentation pour la personnalisation et l'extension de Spartacus est toujours en cours de développement et sera publiée dès qu'elle sera disponible.
Voir API Composable Storefront.
La dernière documentation générée pour les bibliothèques d'applications Spartacus (modules, classes, interfaces, etc.) est hébergée ici : https://sap.github.io/spartacus/
La documentation de l'application est versionnée et est incluse dans la section Actifs de chaque version de chaque bibliothèque Spartacus. Vous pouvez télécharger la documentation d'une version particulière en accédant à la section Actifs de n'importe quelle bibliothèque Spartacus de cette version particulière, puis en cliquant sur docs.tar.gz ou docs.zip . Pour trouver le dossier Assets d'une bibliothèque particulière, accédez aux bibliothèques publiées pour Spartacus, cliquez sur le lien de la bibliothèque qui vous intéresse et faites défiler vers le bas de la page.
Par exemple, pour télécharger la documentation de l'application pour la version 3.4.0, vous pouvez accéder au dossier Assets de la bibliothèque @spartacus/[email protected] ici.
Remarque : Les versions 1.x et 2.x des bibliothèques Spartacus fonctionnent uniquement avec les versions 1905 et 2005 de SAP Commerce. Certaines fonctionnalités, telles que les annulations et les retours, ne sont disponibles qu'avec SAP Commerce 2005, car la prise en charge nécessaire de l'API OCC est uniquement disponible dans SAP Commerce 2005.
Lorsque la version 1.0.0 est publiée, il est recommandé d'utiliser SAP Commerce 1905. Spartacus fonctionne avec les versions 1808 et 1811 de SAP Commerce Cloud, avec certaines limitations.
Spartacus est également mis à jour afin de fonctionner correctement avec les prochaines versions de SAP Commerce Cloud. Cela signifie que certaines fonctionnalités de Spartacus ne peuvent fonctionner qu'avec les futures éditions inédites de SAP Commerce Cloud. Cela sera noté au fur et à mesure que nous publierons de nouvelles versions de Spartacus.
Les problèmes connus sont documentés dans le système de suivi des problèmes GitHub.
Spartacus est fourni « tel quel », sans aucune ligne de soutien officielle.
Pour obtenir de l'aide de la communauté Spartacus :
L'équipe Spartacus accueille favorablement les commentaires, les idées, les demandes et surtout les contributions au code.
De nombreuses améliorations sont à venir ! Toutes les tâches seront publiées sur notre système de suivi des problèmes GitHub. Comme mentionné, certaines des améliorations nécessiteront des changements radicaux. Même si nous nous efforçons d'éviter cela, nous ne pouvons pas garantir que cela ne se produira pas avant la première version.
Copyright (c) 2024 SAP SE ou une société affiliée SAP. Tous droits réservés. Ce fichier est sous licence Apache Software License, v. 2, sauf indication contraire dans le fichier LICENSE.
