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

Propriétés du tODataOutput Standard

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

Le composant tODataOutput Standard appartient à la famille Internet.

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 R2022-02 du Studio Talend ou une mise à jour plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.
  • Ce composant supporte uniquement la version 4.x d'OData.

Basic settings

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. 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.

Root URL

Saisissez l'URL identifiant la racine du service OData auquel accéder, par exemple, https://services.odata.org/V4/xxx. Pour plus d'informations, consultez Service Root URL (en anglais).

Authentication type

Sélectionnez l'une des méthodes d'authentification suivantes selon les prérequis de sécurité du serveur :

  • No authentication (Pas d'authentification) : aucune authentification n'est attendue pour accéder au serveur.
  • Basic : un identifiant et un mot de passe sont attendus. Pour plus d'informations, consultez RFC 2617.
  • Digest : un identifiant et un mot de passe sont attendus. Pour plus d'informations, consultez RFC 2617.
  • Bearer token : un jeton d'accès brut est attendu. Il sera passé dans l'en-tête de la requête en tant que Authorization: Bearer <votre jeton>.
  • NTLM : un identifiant (pouvant contenir un nom de domaine) et un mot de passe sont attendus. Pour plus d'informations, consultez NT LAN Manager (NTLM) Authentication Protocol (en anglais).
  • API key : utilise une manière flexible de passer un jeton de clé d'API au serveur, avec la possibilité de sélectionner où le passer, avec quel nom et un préfixe :
    • Destination : sélectionnez où sera configuré le jeton : dans un en-tête avec le nom donné ou dans un paramètre de requête avec le nom donné (non recommandé car le jeton peut être visible dans les logs).
    • Name (Nom) : saisissez le nom de l'en-tête ou le paramètre de requête.
    • Prefix (Préfixe) (facultatif) : saisissez le préfixe à ajouter devant le jeton (uniquement si la Destination est Request header (En-tête de la requête)).
    • Token (Jeton) : saisissez le jeton d'authentification.
  • OAuth 2.0 gère automatiquement la récupération et le renouvellement du jeton d'accès par rapport au serveur OAuth puis le passe à l'endpoint cible en tant que jeton Bearer :
    • Flow (Flux) : le flux OAuth que vous souhaitez exécuter. Atuellement, seul le flux Client Credentials est supporté.
    • Authentication mode : pour toutes les méthodes d'authentification supportées, les paramètres de flux et de périmètre (scope) sont configurés dans le corps, au format 'application/x-www-form-urlencoded' avec les clés 'grant_type=xxx&scope=xxxx'.
    • Token endpoint : saisissez le jeton d'authentification au format oauth2/mydomain.com/token.
    • Client ID (ID Client) et Client secret (Secret du client) : saisissez l'ID client et le secret du client.
    • Scopes : saisissez le périmètre. S'il n'est pas configuré, la clé du périmètre n'est pas ajoutée dans le formulaire du corps.
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.

Entity set (Jeu d'entités)

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.

Paramètres avancés

Statistiques du tStatCatcher

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.

Accept header et Headers

Utilisez ces options pour définir des en-têtes de requêtes en tant que paires nom-valeur.

Talend supporte les en-têtes If-Match. Pour plus d'informations, consultez If-Match (en anglais).

Use custom URL parameters

Cochez cette case pour spécifier les paramètres qui seront configurés dans l'URL de la requête après le caractère ?, sous forme de paires nom-valeur.

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 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

Règle d'utilisation

Ce composant peut être utilisé en composant intermédiaire dans un flux de données ou en composant de fin dans un Job design.

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.