tSAPODataOutput

Ce composant insère, met à jour ou supprime des données provenant d'un service Web SAP OData.

Propriétés du tSAPODataOutput Standard

Ces propriétés sont utilisées pour configurer le tSAPODataOutput s'exécutant dans le framework de Jobs Standard.

Le composant tSAPODataOutput Standard appartient à la famille Applications Métier.

Le composant de ce framework est disponible dans tous les produits Talend nécessitant une souscription.

Ce composant est disponible uniquement si vous avez installé la mise à jour mensuelle 8.0.1 R2025-06 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

Basic settings

Propriétés	Description
Property type	Peut-être Built-In ou Repository. Built-In : propriétés utilisées ponctuellement. Repository : sélectionnez le référentiel dans lequel sont stockées les propriétés. Les champs suivants sont automatiquement renseignés à l'aide des données récupérées.
Schema et Edit Schema	Un schéma est une description de lignes, il définit le nombre de champ qui sont traités et passés au composant suivant. Le schéma est soit local (Built-in), soit distant dans le Repository. Built-in : le schéma est créé et stocké localement pour ce composant seulement. Pour plus d'informations concernant les schémas des composants dans l'onglet Basic settings (Paramètres simples), consultez Onglet Basic settings. Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets. Pour plus d'informations concernant les schémas des composants dans l'onglet Basic settings (Paramètres simples), consultez Onglet Basic settings. Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles : View schema : sélectionnez cette option afin de voir uniquement le schéma. Change to built-in property : sélectionnez cette option pour passer le schéma en mode Built-In et effectuer des modifications locales. Update repository connection : sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs. Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur No et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre Repository Content.
Guess schema	Cliquez sur ce bouton pour récupérer le schéma en fonction de vos paramètres. Lorsque vous récupérez des données depuis OData, vous pouvez spécifier le format et le contenu des données récupérées à l'aide du schéma, du bouton Guess schema, de l'option Entity set, de l'option Specify entity key, de l'option $filter/search/select/expand et de l'option Return type.
Root URL	Saisissez l'URL identifiant l'URL de base du service SAP OData auquel accéder, c'est-à-dire l'hôte et le port du serveur SAP.
Username et Password	Saisissez les identifiants utilisés pour l'authentification basique pour accéder au serveur. Note InformationsConseil : Pour saisir un mot de passe, un jeton ou une clé secrète du client, cliquez sur le bouton [...] près du champ correspondant pour ouvrir la boîte de dialogue Enter a new password. Saisissez le mot de passe, le jeton ou la clé secrète dans le champ de texte et cliquez sur OK. Vous pouvez saisir une chaîne de caractères JSON en mode pure password ou une expression Java en mode Java. Vous pouvez passer d'un mode à l'autre en cliquant sur switch to Java mode ou switch to pure password mode au-dessus du champ de texte.
Path	Saisissez le chemin d'accès au service du catalogue. Exemple : Root URL = http://<server>:<port> et Path = `/sap/opu/odata4/IWFND/config/default/iwfnd/CATALOGSERVICE`
Guess catalog service path	Cliquez sur ce bouton pour récupérer le chemin par défaut du service de catalogue SAP OData. Pour plus d'informations, consultez Catalog service (en anglais).
OData V4 parameters (facultatif)	Spécifiez les paramètres supplémentaires nécessaires à l'ajustement de votre requête au service : Search by API group ID : utilisez ce champ pour filtrer la liste par identifiants de groupe d'API en ajoutant un astérisque () au début ou à la fin de la valeur. Search by API description : utilisez ce champ pour filtrer la liste par descriptions d'API en ajoutant un astérisque () au début ou à la fin de la valeur. API group ID : sélectionnez l'identifiant du groupe à récupérer. Cette liste est alimentée en fonction des deux précédents paramètres. Pour plus d'informations, consultez Les groupes et l'API associée.
OData V2 parameters (facultatif)	Spécifiez les paramètres supplémentaires nécessaires à l'ajustement de votre requête au service : Search by service ID : utilisez ce champ pour filtrer les identifiants de service en ajoutant un astérisque () au début ou à la fin de la valeur. Search by service description : utilisez ce champ pour filtrer la liste par descriptions de service en ajoutant un astérisque () au début ou à la fin de la valeur. Search by service type : utilisez ce champ pour filtrer la liste par types de service en ajoutant un astérisque () au début ou à la fin de la valeur. Search by service version : utilisez ce champ pour filtrer la liste par versions de service en ajoutant un astérisque () au début ou à la fin de la valeur. Search by service author : utilisez ce champ pour filtrer la liste par auteurs de service en ajoutant un astérisque (*) au début ou à la fin de la valeur.
Service URL	Sélectionnez une URL de service dans la liste. Les valeurs sont soit basées sur le groupe d'API sélectionné (pour OData v4), soit générées à l'aide des paramètres de filtre (pour OData v2).
Entity set	Saisissez ou sélectionnez l'ensemble d'entités à récupérer depuis le service. Pour plus d'informations, consultez Addressing Entities (en anglais). Note InformationsConseil : Pour visualiser tous les ensembles d'entités, cliquez sur le bouton [...] près du champ correspondant pour ouvrir la boîte de dialogue Retrieve values et cliquez sur Run in background. Une nouvelle boîte de dialogue s'ouvre, affichant tous les ensembles d'entités récupérés que vous pouvez sélectionner. Vous pouvez également fournir une valeur personnalisée (Custom value) en cochant la case Use custom value. Cette option affecte le schéma du flux de sortie de ce composant. Il est recommandé de mettre à jour le schéma en cliquant sur le bouton Guess schema après avoir configuré les paires clé/valeur dans la table sous cette option.
Output action	Sélectionnez dans la liste une opération à effectuer. Insert : insère de nouveaux enregistrements dans l'ensemble d'entités précédemment défini. Update : modifie les enregistrements existants dans l'ensemble d'entités précédemment défini. Les types de mise à jour disponibles sont Patch (mettre à jour les enregistrements existants avec des propriétés modifiées) et Replace (écraser les enregistrements existants par des nouveaux). Delete : supprime des enregistrements existants dans l'ensemble d'entités précédemment défini.
Specify the request configuration	Sélectionnez cette option pour configurer votre requête. Key value : saisissez la valeur existante à mettre à jour ou à supprimer. Cette option est disponible uniquement lorsque l'option Update ou Delete est sélectionnée dans la liste Output action. Request body : saisissez le corps du message à inclure dans la requête. Le format doit correspondre au format sélectionné dans le champ Request body format. Exemple JSON : `{ "id": "184", "lastname": "Truce", "age": "37", }` Cette option est disponible uniquement lorsque l'option Insert ou Update est sélectionnée dans la liste Output action. Exemple XML : `<user> <id>184</id> <name>Truce</name> <age>37</age> </user>` Request body format : configurez le format du corps en sélectionnant l'option correspondante.

Advanced settings

Propriétés	Description
tStatCatcher Statistics	Cochez cette case pour collecter les données de log au niveau du Job ainsi qu'au niveau de chaque composant.
Connection timeout (ms)	Configurez le délai avant expiration (en millisecondes) de l'établissement de la connexion au serveur par le connecteur. Une erreur survient si une tentative d'établissement de la connexion échoue.
Receive timeout (ms)	Configurez le délai avant expiration (en millisecondes) de la réception des données de réponse. Une erreur survient si aucune donnée n'est reçue lorsque le délai avant expiration est dépassé.
Utiliser un proxy	Sélectionnez cette option pour utiliser un proxy HTTP ou SOCKS. Proxy type (Type de proxy) : sélectionnez le type de proxy à utiliser, HTTP ou SOCKS. Le proxy HTTP supporte l'authentification basique. Proxy host (Hôte du proxy) et Proxy port (Port du proxy) : saisissez l'adresse et le port du proxy. Proxy login (identifiant du proxy) et Proxy password (Mot de passe du proxy) : saisissez les identifiants nécessaires à l'authentification au proxy. Ces deux champs sont disponibles uniquement lorsque l'option HTTP est sélectionnée dans la liste déroulante Proxy type.
Body charset	Saisissez le type d'encodage du corps sur lequel la requête a été effectuée. Cette option est disponible uniquement lorsque l'option Insert/Update est sélectionnée et que la case Specify the request est cochée dans les paramètres simples.

Variables globales

Variables	Description
Variables globales	ERROR_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case. NB_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier.

Variables

Description

Variables globales

ERROR_MESSAGE : message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. Cette variable fonctionne uniquement si la case Die on error est décochée, lorsque le composant contient cette case.

NB_LINE : nombre de lignes lues par un composant d'entrée ou passées à un composant de sortie. Cette variable est une variable After et retourne un entier.

Utilisation

Conseils d'utilisation	Description
Règle d'utilisation	Ce composant est généralement utilisé comme composant de fin dans un Job ou un sous-Job et nécessite un lien d'entrée.
Limitation	Les entités avec plusieurs clés primaires ne sont pas officiellement supportées. Cependant, les opérations de mise à jour (PATCH/REPLACE) et de suppression peuvent être effectuées à l'aide d'une requête brute avec un format de chaîne de caractères de clé personnalisé (exemple : BankCountry='AT',BankInternalID='15500').

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.

Laissez vos commentaires ici