Skip to main content

Ajouter une source de données externe à un type de données

Archived

6 Tâches

30 mins

Visible to: All users
Intermédiaire Pega Platform 8.6 Intégration des données Français
This content is now archived and is no longer updated. Progress is not calculated. Pega Cloud instances are disabled, and badges are no longer awarded.

Scénario

Les demandes d’assistance routière doivent identifier le véhicule afin que le fournisseur de services puisse préparer l’intervention. Par exemple, certains véhicules peuvent nécessiter une dépanneuse à plateau ou un mélange de carburant à indice d’octane plus élevé. Pour mieux préparer les fournisseurs de services en vue d’une intervention, les parties prenantes veulent s’assurer que les utilisateurs saisissent une combinaison valide de marque, modèle et année de modèle du véhicule. Après avoir envisagé plusieurs sources possibles de modèles de véhicules, les parties prenantes ont décidé d’utiliser les informations du site web de l’US National Highway Traffic Safety Administration (NHTSA) disponible à l’adresse https://vpic.nhtsa.dot.gov/api.

Remplacez la source de données simulée actuelle par une intégration afin de récupérer les informations sur les modèles de voitures ou de camions des particuliers en utilisant un service REST (Representational State Transfer) fourni par la NHTSA. Renseignez la data page D_VehiclemodelsList avec les données de réponse de la NHTSA correspondant à l’année du modèle et à la marque saisies par l’utilisateur.

Note: Les données NHTSA comprennent des informations sur d’autres types de véhicules, comme les bus, qui ne sont pas pris en charge par le service d’assistance routière GoGoRoad. Pour afficher uniquement les modèles de véhicule pertinents, configurez l’intégration de manière à répondre à deux types de services NHTSA : un pour les voitures et un pour les camions.

Vous trouverez dans le tableau suivant les identifiants dont vous avez besoin pour relever le défi.

Rôle Nom d’utilisateur Mot de passe
Développeur d’applications author@gogoroad pega123!
Note: Votre environnement de travail est susceptible de prendre en charge la réalisation de plusieurs défis. Par conséquent, la configuration montrée dans la vidéo de présentation du défi peut ne pas correspondre exactement à votre environnement.

Présentation du défi

Détail des tâches

1 Créer un data object avec une source de données externe

  1. Dans le volet de navigation d’App Studio, cliquez sur Data.
  2. Dans le coin supérieur droit de la page d’accueil Data objects and integrations, cliquez sur New pour ouvrir l’assistant Data Object et créez un data object pour accéder au service NHTSA.
  3. Dans l’assistant Data Object, dans le champ Data object name, saisissez NHTSA Model data.
    data_object_creation
  4. Cliquez sur Next pour créer et configurer les informations de connexion du data object.
  5. Dans la liste déroulante System, sélectionnez Create new. L’assistant se met à jour pour afficher les champs supplémentaires afin de définir la nouvelle source de données.
  6. Dans le champ Name, saisissez NHTSA vPIC.
  7. Dans le champ Description, saisissez NHTSA Product Information Catalog Vehicle Listing.
    system_details
  8. Dans le champ Endpoint URL, saisissez https://vpic.nhtsa.dot.gov/api/vehicles/GetModelsForMakeYear/make/Ford/modelyear/2015/vehicletype/Truck?format=json pour indiquer l’URL du service web NHTSA.
  9. Développez la section Parameters pour afficher les éléments de l’URL du service.
  10. À partir du tableau suivant, ajoutez des paramètres pour la marque, l’année modèle et le type véhicule de l’URL du service.
    URL part Parameter name
    Ford make
    2015 modelyear
    Truck vehicletype
    connection_details
  11. Cliquez sur Initialize call pour appeler le service REST et accéder à la troisième étape de l’assistant.

2 Mapper la réponse à la source de données

Note: La réponse indique que sept réponses ont été trouvées et affiche les données pour l’un des sept résultats. Le nombre de résultats trouvés varie en fonction des paramètres envoyés au service.
  1. Sur la ligne SearchCriteria, cliquez sur Add new pour associer le champ SearchCriteria de la réponse REST à un champ destiné au data object. Les contenus de la ligne sont mis à jour pour afficher le champ Map to et les types de champs de la liste déroulante.
  2. Sur la ligne SearchCriteria, cliquez sur l’icône Add/edit map to pour accepter le mapping par défaut et créer un champ texte nommé SearchCriteria dans le data object.
    Search Criteria
  3. Répétez les étapes 1 et 2 pour les champs de réponse Make_Name, Model_Name et VehicleTypeName.
    Data mapping
  4. Cliquez sur Next pour terminer le mapping des données et accéder à la quatrième étape de l’assistant.

3 Définir les paramètres du point de terminaison pour l’intégration

Note: Pour accéder au service et recevoir des données de réponse, la NHTSA n’exige pas d’authentification de l’utilisateur. Les autres fournisseurs de données peuvent imposer une authentification. Veuillez vérifier les règles d’authentification au moment de configurer une intégration à un service web.
  1. Dans l’URL du point de terminaison, dans le champ Name, saisissez GetVehicleModels_BaseURL pour identifier les paramètres de connexion.
  2. Sous Stage, dans le champ Base URL, saisissez https://vpic.nhtsa.dot.gov pour compléter l’URL utilisée après migration de l’application vers un système de simulation.
  3. Sous Prod, dans le champ Base URL, saisissez https://vpic.nhtsa.dot.gov pour compléter l’URL utilisée après migration de l’application vers un système de production.
  4. Sous Authentication, dans le champ Name, saisissez AuthProfile_NHTSA_vPIC.
    Environment settings
  5. Cliquez sur Submit pour terminer la configuration de l’intégration du data object et de REST.

4 Agréger la réponse à partir de la source de données

  1. Dans le volet de navigation de Dev Studio, cliquez sur Data types pour afficher la liste des data objects définis pour l’application GoGoRoad.
  2. Cliquez sur Vehicle models pour ouvrir le type de données.  
  3. Cliquez sur l’onglet Sources pour afficher les sources disponibles, puis cliquez sur List Vehicle models pour ouvrir la data page D_VehiclemodelsList qui met en cache une liste des modèles de véhicules.
  4. Dans la section Data Sources, décochez la case Simulate data source pour supprimer la source de données simulée de la data page.
  5. Dans la liste déroulante Source, sélectionnez Aggregate sources pour établir la data page via deux appels REST.
  6. Dans le champ Aggregate source name, saisissez NHTSA vPIC pour identifier la source de données pour la data page.
  7. Dans la liste déroulante Source, sélectionnez Data transform.
  8. Cliquez sur Add source pour ajouter une seconde source pour la data page.
  9. Dans la deuxième liste déroulante Source, sélectionnez Data transform.
    aggregate_sources_DP

5 Configurer le data transform d’une source

  1. Pour la première source, dans le champ Data transform, saisissez MapModels.
  2. Cliquez sur l’icône Open  pour créer le data transform.
    Open icon
  3. Cliquez sur Create and open pour accepter les paramètres par défaut et ouvrir le formulaire de règle du data transform.
  4. Cliquez sur l’onglet Parameters pour définir les trois paramètres requis par le service NHTSA.
    1. Sous l’onglet Parameters, cliquez sur l’icône Add  pour ajouter une ligne permettant de définir un paramètre.
    2. Dans la ligne de paramètre vide, dans le champ Name, saisissez make.
    3. Dans la liste déroulante Required sélectionnez Yes.
    4. Répétez les étapes 4a à 4c afin d’ajouter deux autres paramètres au data transform en utilisant les informations du tableau suivant.
      Name Required
      modelyear Yes
      vehicletype Yes
  5. Cliquez sur l’onglet Pages & Classes pour identifier les pages utilisées par le data transform et la classe de chaque page.
    1. Sous l’onglet Pages & Classes, dans le champ Page name, saisissez Primary.pxResults pour identifier la page contenant le résultat du data transform.
    2. Dans le champ Class, saisissez ou sélectionnez GoGo-GoGoRoad-Data-VehicleModels pour identifier la classe de la page de résultat.
    3. Cliquez sur l’icône Add item pour ajouter une deuxième ligne à l’onglet Pages & Classes.
    4. Dans le champ Pagename, saisissez D_NHTSAModelData.Results pour identifier la page qui contient le résultat du data transform.
    5. Dans le champ Class, saisissez ou sélectionnez GoGo-GoGoRoad-Data-NHTSAModelData-Results pour identifier la classe de la page de résultat.
      Page name
  6. Cliquez sur l’onglet Definition pour configurer la logique du data transform.
    1. Pour l’étape 1, dans la liste déroulante Action, sélectionnez Append and Map pour créer une nouvelle page de résultats pour chaque résultat généré. Le data transform crée une ligne enfant étiquetée 1.1 en dessous d’étape 1.
    2. Pour l’étape 1, dans le champ Target, saisissez Primary.pxResults.
    3. Dans la liste déroulante Relation, sélectionnez each page in.
    4. Dans le champ Source, saisissez D_NHTSAModelData[vehicletype:param.vehicletype,modelyear:param.modelyear,make:param.make].Results pour transmettre les paramètres requis à la data page qui interroge le service NHTSA et met la réponse en cache.
    5. Pour l’étape 1.1, dans le champ Target, saisissez ou sélectionnez .Make pour définir la valeur de l’élément Make sur la page cible.
    6. Dans le champ Source, saisissez ou sélectionnez .Make_Name pour identifier l’élément à copier vers la cible.
    7. Cliquez deux fois sur l’icône Add a row pour ajouter les étapes 1.2 et 1.3 au data transform.
    8. Complétez les champs des étapes 1.2 et 1.3 en utilisant les informations présentées dans le tableau suivant.
        Action Target Source
      1.2 Set .Model .Model_Name
      1.3 Set .VehicleType .VehicleTypeName
      map_models_DT
  7. Cliquez sur Save pour compléter la configuration du data transform.

6 Paramétrer la data page pour configurer les deux appels de service

  1. Dans Dev Studio, cliquez sur l’onglet D_VehiclemodelsList pour retourner au formulaire de data page.
  2. Dans le formulaire de règles de la data page D_VehiclemodelsList, cliquez sur Parameters pour ajouter des paramètres à la data page.
  3. Dans la ligne vide, dans le champ Name, saisissez make afin de définir un paramètre pour la marque à transmettre au data transform.
  4. Dans la liste déroulante Required, sélectionnez Yes pour rendre le paramètre obligatoire.
  5. Cliquez sur l’icône Add item pour ajouter un deuxième paramètre à la data page.
  6. Dans la deuxième ligne, dans le champ Name, saisissez modelyear afin de définir un paramètre pour l’année du modèle à transmettre au data transform.
  7. Dans la liste déroulante Required, sélectionnez Yes pour rendre le paramètre obligatoire.
  8. Cliquez sur l’onglet Definition pour reprendre la configuration des sources agrégées.
  9. Sous le champ Data transform name, cliquez sur Parameters pour ouvrir une boîte de dialogue permettant de définir les valeurs à transmettre au data transform.
    1. Dans la boîte de dialogue, dans le champ Value du paramètre make , saisissez param.make pour transférer la valeur de ce paramètre à la data page.
    2. Dans le champ Value pour le paramètre modelyear, sélectionnez param.modelyear pour transférer la valeur du paramètre model year à la data page.
    3. Dans le champ Value du paramètre vehicletype, saisissez Passenger Car pour transmettre une chaîne de constantes.
    4. Cliquez sur Submit pour fermer la boîte de dialogue modale et enregistrer la configuration des paramètres.
  10. Pour la deuxième source agrégée, dans le champ Data transform name, saisissez ou sélectionnez MapModels pour interroger le data transform une deuxième fois afin de renseigner la data page.
  11. Appuyez sur la touche Tab  pour quitter le champ. Le lien Parameters s’affiche en dessous du champ Data transform name.
  12. Répétez l’étape 9 pour la deuxième source agrégée pour ajouter des valeurs de paramètre pour le data transform MapModels en utilisant les informations fournies dans le tableau suivant.
    Paramètre Valeur
    make param.make
    modelyear param.modelyear
    vehicletype Truck
  13. Cliquez sur Save pour compléter la configuration de la data page.

Vérifier votre travail

  1. Dans App Studio, cliquez sur Preview pour retourner dans le portail utilisateur.
  2. Créez un nouveau dossier Assistance Request.
  3. Avancez le dossier jusqu'à l'étape Identify Vehicle, en complétant les champs obligatoires.
  4. Dans le coin supérieur droit, cliquez sur l'icône Design  pour activer le mode Design.
    Design
  5. Dans la section Vehicle Information, cliquez sur l’icône Edit this section.
    Edit the section
  6. Dans le champ Model, cliquez sur l’icône Edit this field pour configurer la liste déroulante Model afin d'appliquer les paramètres obligatoires à la data page. Un volet de configuration apparaît sur le côté droit de la fenêtre de navigation.
    1. Dans la section List source, supprimez les contenus du champ Data Page.
    2. Dans le champ Data page, saisissez ou sélectionnez D_VehiclemodelsList pour sélectionner à nouveau la page et mettez à jour le volet des propriétés pour afficher les paramètres obligatoires.
    3. Dans le champ Value pour le paramètre make, saisissez ou sélectionnez .Make.
    4. Dans le champ Value pour le paramètre modelyear, saisissez ou sélectionnez .ModelYear.
    5. Dans le champ Property for value, saisissez ou sélectionnez .Model.
      List source
    6. Dans l’angle supérieur droit du volet, cliquez sur Apply pour terminer la configuration de la liste déroulante.
    7. Cliquez sur Design pour désactiver le mode Design.
  7. Dans le champ Model year, saisissez 2015.
  8. Dans le champ Make, saisissez Ford.
  9. Cliquez sur la liste déroulante Model pour afficher une liste de modèles de véhicules regroupés par type de véhicule.
    Model drop-down


Disponible dans les missions suivantes :

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice