Création d'un projet PAC

Objective

After completing this lesson, you will be able to génération d'un projet de modèle de programmation d'applications SAP Cloud

Utilisation de SAP Business Application Studio

Espace de développement et assistant de projet

Comme indiqué précédemment, nous souhaitons utiliser SAP Business Application Studio (BAS) comme environnement de développement pour créer des applications CAP pour l'exécution Node.js. BAS offre l'avantage que tout ce dont nous avons besoin pour le développement est disponible prêt à l'emploi. Par exemple, Node.js ainsi que le kit de développement CDS de CAP sont déjà installés prêts à l'emploi.

Regardez la vidéo pour en savoir plus sur la création d'espaces de développement et la génération de projets CAP afin de développer des applications à l'aide de BAS.

Interface de ligne de commande

Les projets PAC peuvent également être créés avec le package npm @sap/cds-dk. Ce package contient le client de ligne de commande et la boîte à outils de développement pour CAP.

@sap/cds-dk est disponible prêt à l'emploi dans BAS. Les commandes correspondantes peuvent être saisies directement dans un terminal de BAS. Pour ouvrir un nouveau terminal, sélectionnez TerminalNew Terminal dans le menu hamburger dans le coin supérieur gauche de BAS.

@sap/cds-dk fournit des commandes pour différentes étapes du développement de CAP, de l'initialisation de nouveaux projets au déploiement dans le cloud. Utilisez l'aide cds pour obtenir une vue d'ensemble de toutes les commandes. Utiliser la <>commande cds helpcommand ou cds <? pour obtenir de l'aide spécifique. Avec cds init un nouveau projet CAP peut être généré.

Configuration de la convention dépassée

Configuration minimale

CAP a des paramètres par défaut pour de nombreuses choses que vous devrez configurer dans d'autres frameworks. L'objectif est de faire fonctionner les choses sans configuration autant que possible. Si nécessaire, vous pouvez remplacer ces options par défaut par une configuration spécifique. Par exemple, vous pouvez remplacer les noms par défaut des dossiers ci-dessus dans le fichier package.json comme suit :

JSON
123456789
{ ... "cds": { "folders": { "db": "database/", "srv": "services/", "app": "uis/" } } }

Remarque

Nous vous recommandons de suivre les conventions de la PAC pour bénéficier de choses qui fonctionnent simplement prêtes à l'emploi. Ajoutez des configurations ou remplacez les valeurs par défaut uniquement si vous avez vraiment besoin de le faire.

Astuce

Vous pouvez utiliser la commande cds env pour afficher la configuration effective d'une clé spécifique ou de l'ensemble de l'environnement courant dans le terminal. Par exemple, si vous exécutez des dossiers cds env dans le terminal, vous obtenez la sortie suivante si vous n'avez pas écrasé les noms de dossiers par défaut :
JSON
1
{ db: 'db/', srv: 'srv/', app: 'app/' }

Test local

Lorsque vous exécutez la commande cds watch dans le terminal, vous démarrez un serveur http en mode veille. De ce fait, votre projet est compilé et servi localement. Cela signifie que votre application basée sur CAP est accessible et testée à partir de BAS (ou code VS) à l'aide du serveur fourni (voir la figure Démarrage d'un serveur HTTP).

La "veille" dans cds watch indique que la commande surveille en permanence les fichiers du projet pour les modifications. Une fois qu'une modification est détectée dans les fichiers source, le serveur redémarre automatiquement pour refléter ces modifications. Il n'est pas nécessaire d'arrêter et de redémarrer manuellement le serveur après des modifications.

Lorsque le serveur est en cours d'exécution en mode veille, il édite les journaux vers la console. Ces journaux peuvent être utiles pour détecter les problèmes, comprendre le flux de demandes et résoudre les erreurs.

Remarque

En fait, cds watch est juste un raccourci pratique pour:
Code Snippet
1
cds serve all --with-mocks --in-memory?

Exécuter le service CDS ? dans le terminal pour obtenir plus d'informations sur cds serve et les options disponibles.

Le --in-memory ? ajoute automatiquement une base de données en mémoire transitoire, qui sera démarrée à chaque (re)démarrage en fonction des paramètres par défaut ou de la configuration dans package.json. Le point d'interrogation ajouté applique une variante plus défensive qui respecte la base de données configurée, le cas échéant, et ajoute une base de données en mémoire uniquement si aucune base de données persistante n'est configurée.

Lorsque la veille cds est en cours d'exécution, vous pouvez ouvrir http://localhost:4004 dans un navigateur pour afficher une page générique index.html. Cette page est principalement à des fins de développement et de test. Dans les scénarios de production, il n'est généralement pas exposé ou remplacé par une interface utilisateur appropriée.

La page fournit une liste de tous les points de terminaison de service exposés. Cela permet aux développeurs et aux testeurs d'y accéder facilement.

Pour chaque service OData, il existe également un lien vers son document $metadata. Cliquez dessus pour afficher les métadonnées du service, qui décrit les ensembles d'entités, les types et d'autres détails du service au format XML.

Pour les applications Node.js, il existe également un lien d'aperçu Fiori sur la page index.html pour chaque ensemble d'entités exposé. Un tel lien sert dynamiquement une page de liste d'éléments SAP Fiori en fonction de l'ensemble d'entités correspondant. Veuillez noter que cela n'est pas destiné à une utilisation en production. Elle n'est pas censée remplacer une application d'éléments SAP Fiori appropriée.

Astuce

Pour arrêter le processus serveur, appuyez sur Ctrl+C dans le terminal où votre application s'exécute.

Démonstration et exercice : créer une application Hello World

Remarque

Dans l'exercice, suivez les instructions étape par étape de la démonstration suivante dans SAP Business Application Studio.

Vous trouverez le code source à partir de la simulation dans la branche 1_hello_world du référentiel GitHub suivant :

https://github.com/SAP-samples/cap-development-learning-journey

Vous trouverez ici des informations détaillées sur le contenu de ce référentiel et son utilisation.

Regardez la vidéo pour voir comment créer une application Hello World.

Maintenant que nous savons comment créer des projets CAP dans un espace de développement et comment tester localement les applications CAP, explorons les fonctionnalités de base de la PAC.