Utilisation des ressources OData

Objectives

After completing this lesson, you will be able to:
  • Créez une ressource de données dans un service OData.
  • Accédez à la ressource de données OData à partir de votre application.

Ressource OData

Une ressource OData est une connexion à un magasin de données qui respecte le protocole OData. Il n'est pas si important de comprendre OData en détail. Par conséquent, nous aborderons les points les plus importants à connaître lors de la connexion depuis SAP Build Apps.

Exemple d'intégration OData dans l'éditeur.

Un service OData définit un ensemble d'entités. Ces entités représentent des éléments réels tels que les clients, les produits, les sites et les salariés. Étant donné que les services OData doivent fournir des métadonnées sur le service, une fois que vous aurez fourni l'URL au service, SAP Build Apps saura quelles entités il existe, leurs zones et les types de données.

Chaque entité définira un ensemble de champs, où chaque champ représente une information sur cette entité. Par exemple, pour les clients, vous pouvez avoir les zones suivantes :

  • CustomerID
  • CompanyName
  • ContactName
  • ContactTitle
  • Adresse
  • Localité
  • Région
  • Code postal
  • Pays
  • Tél.
  • Télécopie

Jusqu'à présent, nous avons défini la nature des données que nous voulons stocker. Cependant, nous stockons éventuellement les données réelles dans notre entité de service OData et ces données sont représentées sous la forme d'un ensemble de lignes, chaque ligne ayant une valeur pour chacune des zones. Il se peut donc que nous ayons les données suivantes :

Vous trouverez de plus amples informations sur OData, y compris le système fictif avec l'exemple Northwind pour tester l'utilisation, à l'adresse suivante : https://www.odata.org/

Exemple de données

CustomerIDCompanyNameContactNameContactTitleAdresse
ALFKIAlfreds FutterkisteMaria AndersSales RepresentativeObere Str. 57
ANATRAna Trujillo Emparedados y heladosAna TrujilloOwnerAvda. de la Constituci\u00f3n 2222

Création de ressource OData

Scénario de gestion

Cette procédure montre comment créer une ressource OData.

Notez que cette procédure est orientée vers l'exemple de service OData standard, Northwind.

Étapes

  1. Créez une ressource OData.

    1. Dans un nouveau projet SAP Build Apps, ouvrez l'onglet Données.

    2. Accédez aux entités de données classiques SAP Build AppsCREATE DATA ENTITYOData Integration.

    3. Pour l'URL de l'API de base, saisissez https://services.odata.org/v4/northwind/northwind.svc/and, puis sélectionnez VERIFY URL.

      À ce stade, SAP Build Apps lit toutes les métadonnées et affiche une liste des entités contenues dans le service.

    4. Basculez le commutateur en regard de Clients.

      Cela crée une connexion à cette entité. Si vous voulez vous connecter à d'autres entités, vous pouvez basculer entre ces entités.

Accéder aux données à partir de la ressource OData

Scénario de gestion

Dans cette procédure, vous allez apprendre les étapes pour la connecter ou récupérer des données.

Étapes

  1. Accédez aux données à partir de la ressource OData.

    1. Revenez à la zone de graphiques de l'interface utilisateur.

      Il doit y avoir un titre et un composant de texte.

    2. Sélectionnez le composant de titre et, dans le volet Propriétés, remplacez le contenu par Clients.

    3. Sélectionnez Variables.

  2. Créez une variable de données.

    Nous allons maintenant créer une variable de données qui stockera les données du backend et contiendra la logique de récupération.

    1. Sélectionnez Variables de données, puis Ajouter une variable de données.

    2. Sélectionnez Clients comme ressource de données sur laquelle baser la variable de données.

    3. Sélectionnez Interface utilisateur pour revenir à la zone de graphiques de l'interface utilisateur.

    4. Sélectionnez le composant de texte et nous le configurerons pour afficher les noms des clients.

    5. Dans le volet Propriétés, cliquez sur l'icône sous Répéter avec, puis sélectionnez Données et variables, puis Variable de données.

    6. Sélectionnez Clients, puis Sauvegarder.

    7. Dans le volet Propriétés, sélectionnez ABC sous la zone Contenu et sélectionnez Poste de données en répétition.

    8. Sélectionnez current, puis CompanyName.

    9. Sélectionnez Sauvegarder.

    10. Sélectionnez Sauvegarder (en haut à droite).

  3. Exécutez l'application.

    Vous verrez une liste de clients récupérée à partir du backend.

Générer les données d'un collègue avec OData

Scénario de gestion

Utilisez des interfaces pour la page de médias sociaux afin d'obtenir le prénom et le nom de famille et la ville associée d'un collègue fictif, obtenu par l'événement de chargement de la page à partir d'un service OData.

Options d'exercice

Pour commencer l'exercice, sélectionnez Commencer l'exercice dans la figure ci-dessous.

Une fenêtre pop-up s'ouvre. Vous disposez des options suivantes :

  • Début : la simulation démarre. Suivez la simulation pour apprendre à générer les données d'un collègue avec OData.
  • Ouvrir le document PDF : un PDF s'ouvre. En fonction des étapes décrites dans ce document, vous pouvez effectuer les exercices dans votre propre infrastructure système.

Générer les repas par logique de bouton et OData

Scénario de gestion

Dans le cadre de l'événement social des deux collègues, configurez un bouton de sorte que deux options alimentaires différentes soient générées et s'afficheront l'une par rapport à l'autre. Pour ce faire, sélectionnez chacun d'eux dans une liste à l'aide du service OData. Vous pouvez ainsi manipuler la police avec du texte.

Options d'exercice

Pour commencer l'exercice, sélectionnez Commencer l'exercice dans la figure ci-dessous.

Une fenêtre pop-up s'ouvre. Vous disposez des options suivantes :

  • Début : la simulation démarre. Suivez la simulation pour apprendre à générer les repas par logique de bouton et OData.
  • Ouvrir le document PDF : un PDF s'ouvre. En fonction des étapes décrites dans ce document, vous pouvez effectuer les exercices dans votre propre infrastructure système.