Accéder au contenu principal Passer au contenu complémentaire

Insérer et mettre à jour des données à l'aide de services Web OData

Le Job suivant présente comment insérer des données dans un service OData à l'aide de données fixes, pios de mettre à jour les enregistrements insérés via les composants tODataInput et tODataOutput.

Avant de commencer

Ce scénario utilise les fonctionnalités du service Web OData afin de récupérer et de mettre à jour les données. Pour plus d'informations, consultez la documentation OData (en anglais). Vous devez accéder à un endpoint de service OData v4.x avec les identifiants d'authentification appropriés.

Relier les composants

Procédure

  1. Glissez-déposez les composants suivants depuis la Palette dans l'espace de modélisation graphique : un tFixedFlowInput, un tODATAOutput, un tODATAInput et un tLogRow.
  2. Reliez le tFixedFlowInput au tODATAOutput à l'aide d'un lien Row > Main.
  3. Reliez le tODATAOutput au tODATAInput à l'aide d'un lien Trigger > On SubJob OK.
  4. Reliez le tODATAInput au tLogRow à l'aide d'un lien Row > Main.
    Vue d'ensemble du Job dans le Studio, affichant les composants OData reliés.

Configurer les composants

Procédure

  1. Double-cliquez sur le composant tFixedFlowInput pour afficher sa vue Component.
  2. Dans la vue Basic settings, configurez les données fixes à insérer dans le service OData.
    Cliquez sur Edit schema et définissez le schéma pour qu'il corresponde à la structure de l'entité OData. Par exemple, pour une entité Person :
    • UserName (String)
    • FirstName (String)
    • LastName (String)
    • Email (String)
    Dans la zone Mode, sélectionnez Use Single Table et cliquez sur le bouton [+] pour ajouter des enregistrements d'exemple avec les valeurs appropriées pour chaque colonne.
    Vue Basic settings du tFixedFlowInput affichant les données contenant des champs relatifs aux personnes.
  3. Double-cliquez sur le composant tODATAOutput pour afficher sa vue Component.
  4. Dans sa vue Basic settings, configurez l'opération de sortie.
    • Dans le champ Root URL, saisissez l'URL de votre service OData, par exemple : https://services.odata.org/V4/ABCD pour le service de référence TripPin.
    • Dans la liste Authentication type, sélectionnez la méthode d'authentification appropriée, par exemple No authentication.
    • Cliquez sur Sync columns afin de récupérer le schéma du composant précédent.
    • Dans le champ Entity set, saisissez ou sélectionnez l'ensemble d'entités cibles, par exemple : People.
    • Dans la liste Output action, sélectionnez Insert pour ajouter les nouveaux enregistrements au service OData.
    Vue Basic settings du tODATAOutput affichant l'ensemble d'entités et l'opération d'insertion.
  5. Double-cliquez sur le composant tODATAInput pour afficher sa vue Component.
  6. Dans la vue Basic settings, configurez la connexion pour récupérer les données insérées.
    • Dans le champ Root URL, saisissez la même URL de service OData que celle utilisée dans le tODATAOutput.
    • Dans la liste Authentication type, sélectionnez la même méthode d'authentification.
    • Dans le champ Entity set, saisissez le même ensemble d'entités, par exemple : People.
    • Dans la liste Return type, sélectionnez Record afin de parser la réponse dans des enregistrements individuels.
    Cliquez sur Guess schema pour récupérer automatiquement le schéma en fonction de l'ensemble d'entités.
    Vue Basic settings du tODATAInput affichant l'URL, l'ensemble d'entités et le schéma.
  7. Double-cliquez sur le composant tLogRow pour afficher sa vue Component.
    Cliquez sur Sync columns afin de récupérer le schéma du composant précédent.
    Dans la zone Mode, sélectionnez Basic pour afficher dans la console les données récupérés, en plein texte.

Exécuter le Job

Procédure

  1. Appuyez sur les touches Ctrl + S pour sauvegarder votre Job.
  2. Appuyez sur F6 pour l’exécuter.

Résultats

Le Job insère les enregistrements de données fixes dans le service OData, récupère tous les enregistrements du même ensemble d'entités et les affiche dans la console. Ce Job présente un cycle complet d'écriture et lecture à l'aide de services Web OData pour l'intégration de données.

Console de la vue Run affichant la récupération et le traitement des enregistrements OData.

Que faire ensuite

Si vous souhaitez mettre à jour des informations dans l'entité OData, par exemple pour modifier un prénom, vous pouvez :
  • Modifier la configuration du composant tFixedFlowInput pour ne conserver que l'entité et le nom à modifier, par exemple pour passer de Johnathan à John.
    Vue Basic settings du tFixedFlowInput affichant les données contenant des champs relatifs aux personnes.
  • Modifier la configuration du composant tODATAOutput afin de sélectionner Update dans la liste Output action et Patch pour Update type, afin d'écraser l'enregistrement existant.
  • Exécutez le Job à nouveau. L'enregistrement concernant les personnes a été mis à jour et la nouvelle valeur du prénom s'affiche dans la console de la vue Run.
    Console de la vue Run affichant la mise à jour réussie de l'enregistrement OData.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.