tSAPODataInput
Propriétés du tSAPODataInput Standard
Ces propriétés sont utilisées pour configurer le tSAPODataInput s'exécutant dans le framework de Jobs Standard.
Le composant tSAPODataInput 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.
|
| OData version | Sélectionnez la version du protocole OData à utiliser. |
| 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 :
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 :
|
| 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. |
| Specify entity key | Cochez cette case pour saisir la clé utilisée pour identifier de manière unique un ensemble spécifique d'entités. Pour plus d'informations, consultez Addressing Entities (en anglais). 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. |
| Use $filter | Cochez cette case pour saisir une requête filtrant la collection de ressources gérées par l'URL de la requête. Pour plus d'informations, consultez System Query Option $filter (en anglais). Si les deux options Use $filter et Use $search sont appliquées à la même requête, les résultats incluent uniquement les entités correpondant aux deux critères. 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. |
| Use $search | Cochez cette case pour saisir une requête qui sera appliquée à l'URL de la requête et retournera toutes les entités correspondantes dans la collection. Pour plus d'informations, consultez System Query Option $search (en anglais). Si les deux options Use $filter et Use $search sont appliquées à la même requête, les résultats incluent uniquement les entités correpondant aux deux critères. 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. |
| Use $select | Cochez cette case pour saisir une requête qui sera appliquée à l'URL de requête et retournera un ensemble spécifique de propriétés pour chaque entité ou type complexe. Pour plus d'informations, consultez System Query Option $select (en anglais). Si les deux options Use $select et Use $expand sont appliquées à la même requête, les résultats comprennent uniquement les entités correspondant au critère de filtre $select. Vous devez inclure le critère $expand dans la requête $select, afin de retourner toutes les propriétés attendues. 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. |
| Use $expand | Cochez cette case pour saisir une requête qui sera appliquée à l'URL de requête et retournera les ressources développées associées à inclure dans les ressources récupérées. Pour plus d'informations, consultez System Query Option $expand (en anglais). Si les deux options Use $select et Use $expand sont appliquées à la même requête, les résultats comprennent uniquement les entités correspondant au critère de filtre $select. Vous devez inclure le critère $expand dans la requête $select, afin de retourner toutes les propriétés attendues. 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. |
| Return type | Sélectionnez l'une des options suivantes en fonction de la manière dont vous souhaitez parser les données retournées par le serveur.
|
| 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.
Créez le schéma en cliquant sur le bouton Edit Schema. Si le schéma est en mode Repository, trois options sont disponibles :
|
| Guess schema | Cliquez sur ce bouton pour récupérer le schéma en fonction de vos paramètres. Ce bouton fonctionne lorsque l'option Status, headers and body est sélectionnée dans la liste déroulante Returned content ou que l'option Output key/value pairs est sélectionnée et que les paires clé/valeur sont configurées dans la table, sous l'option Output key/value pairs. 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. |
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.
|
| Use $skip | Cochez cette case afin de spécifier, dans la collection sur laquelle la requête est effectuée, le nombre d'éléments à ignorer et ne pas inclure dans le résultat. Pour plus d'informations, consultez System Query Option $top and $skip (en anglais). Si les deux options Use $skip et Use $top sont appliquées à la même requête, les résultats incluent uniquement les entités correpondant aux deux critères. 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. |
| Use $top | Cochez cette case afin de spécifier, dans la collection sur laquelle la requête est effectuée, le nombre de premiers éléments à inclure dans le résultat. Pour plus d'informations, consultez System Query Option $top and $skip (en anglais). Si les deux options Use $skip et Use $top sont appliquées à la même requête, les résultats incluent uniquement les entités correpondant aux deux critères. 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. |
| Use $orderBy | Cochez cette case pour saisir une requête qui sera appliquée à l'URL de requête et retournera les ressources associées dans un ordre particulier. Pour plus d'informations, consultez System Query Option $orderby (en anglais). 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. |
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. |
Utilisation
| Conseils d'utilisation | Description |
|---|---|
| Règle d'utilisation |
Ce composant est généralement utilisé comme composant de début dans un Job ou un sous-Job et nécessite un lien de sortie. |
| Limitation |
Pour OData v4 : l'implémentation actuelle de ce composant nécessite que le service supporte la fonction $count. Pour OData v2 :
|