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

Créer un nouveau data object pour interroger le service REST de NHTSA avec les informations du modèle du véhicule.

1. Dans App Studio, dans le volet de navigation de gauche, cliquez sur Data > Data objects and integrations pour ouvrir la page d’accueil Data objects and integrations.
   
2. Dans le coin supérieur droit de la page d’accueil, 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 du nom Data objects, saisissez NHTSA Model data.
4. 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.
5. Dans le champ Name, saisissez NHTSA vPIC.
6. Dans le champ Description, saisissez NHTSA Product Information Catalog Vehicle Listing.
   
7. 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. La section Parameters s’ouvre pour afficher les éléments de l’URL de l’URL du service.
8. À 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.

   Partie de l’URL	Nom du paramètre
   Ford	make
   2015	modelyear
   Truck	vehicletype

   
9. Cliquez sur Initialize call pour interroger le service REST et accédez à la deuxième étape de l’assistant.

Consultez un exemple de données de réponse du service REST de NHTSA et mappez la réponse vers le modèle de données pour le data object.

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 mappage par défaut et créer un champ texte nommé SearchCriteria dans le data object.
   
3. Répétez les étapes 1 et 2 pour le tableau Results et les champs de réponse Make_Name, Model_Name et VehicleTypeName.
   
4. Cliquez sur Next pour terminer le mappage des données et accéder à la troisième étape de l’assistant.

Saisissez les paramètres d’intégration pour finir de configurer l’intégration au service REST de NHTSA.

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.
   
5. Cliquez sur Submit pour terminer la configuration de l’intégration du data object et de REST.

Configurez la source de données en cours de simulation pour interroger le service REST de NHTSA deux fois afin d’obtenir une liste de modèles de véhicules pour les voitures et les camions.

1. Dans Dev Studio, dans le volet de navigation de gauche, cliquez sur Data types pour afficher la liste des data objects définis pour l’application GoGoRoad.
2. Ouvrez l’entrée Vehicle model pour obtenir la liste des data views configurée pour le data object.
3. 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. 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.
   

Configurez un data transform pour renseigner la data page avec les résultats du service NHTSA.

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.
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. Définir les paramètres pour les données requises par le service NHTSA.
   1. Cliquez sur l’onglet Parameters pour définir trois paramètres requis par le service NHTSA.
   2. Sous l’onglet Parameters, cliquez sur l’icône add pour ajouter une ligne permettant de définir un paramètre.
   3. Dans la ligne de paramètre vide, dans le champ Name, saisissez make.
   4. Dans la liste déroulante Required sélectionnez Yes.
   5. Répétez les étapes b à d afin d’ajouter deux autres paramètres au data transform en utilisant les informations du tableau suivant.

      Nom	Obligatoire
      modelyear	Oui
      vehicletype	Oui

5. Ajoutez les informations permettant de clôturer les références aux pages auxquelles data transform a accédé.
   1. Cliquez sur l’onglet Pages & Classes pour identifier les pages utilisées par le data transform et la classe de chaque page.
   2. Sous l’onglet Pages & Classes, dans le champ Page name, saisissezPrimary.pxResults pour identifier la page contenant le résultat du data transform.
   3. Dans le champ Class, saisissez ou sélectionnez GoGo-GoGoRoad-Data-VehicleModels pour identifier la classe de la page de résultat.
   4. Cliquez sur l’icône Add item pour ajouter une deuxième ligne à l’onglet Pages & Classes.
   5. Dans le champ Pagename, saisissez D_NHTSAModelData.Results pour identifier la page qui contient le résultat du data transform.
   6. Dans le champ Class, saisissez ou sélectionnez GoGo-GoGoRoad-Data-NHTSAModelData-Results pour identifier la classe de la page de résultat.
      
6. Configurez la logique du data transform.
   1. Cliquez sur l’onglet Definition pour configurer la logique du data transform.
   2. 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.
   3. Pour l’étape 1, dans le champ Target, saisissez Primary.pxResults.
   4. Dans la liste déroulante Relation, sélectionnez each page in.
   5. 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.
   6. 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.
   7. Dans le champ Source, saisissez ou sélectionnez .Make_Name pour identifier l’élément à copier vers la cible.
   8. Cliquez deux fois sur l’icône plus pour ajouter les étapes 1.2 et 1.3 au data transform.
   9. Complétez les champs des étapes 1.2 et 1.3 en utilisant les informations présentées dans le tableau suivant.

      	Action	Cible	Source
      1.2	Set	.Model	.Model_Name
      1.3	Set	.VehicleType	.VehicleTypeName

      
7. Cliquez sur Save pour compléter la configuration du data transform.

Ajoutez des paramètres à la data page D_VehiclemodelsList et configurez les paramètres pour les sources de données agrégées.

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 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 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. Pour la première source agrégée, définissez les valeurs pour les paramètres transmis au data transform.
   1. 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.
   2. Dans la boîte de dialogue, au niveau du champ Value, saisissez param.make pour transférer la valeur du paramètre make à la data page.
   3. 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.
   4. Dans le champ Value pour le paramètre vehicletype, saisissez "Passenger Car" pour transmettre une chaîne de constantes.
   5. 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.