Propriétés du tMDMRestInput Standard

Schema et Edit Schema

Un schéma est une description de lignes, il définit le nombre de champs 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 :

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

Built-in : le schéma sera créé et conservé pour ce composant seulement.

Repository : le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans divers projets et Jobs.

Use an existing connection

Cochez cette case pour utiliser un composant tMDMConnection déjà configuré.

URL

Saisissez l'URL d'accès à Talend MDM Server via l'API REST.

Username et Password

Saisissez les informations d'authentification à Talend MDM Server.

Pour saisir le mot de passe, cliquez sur le bouton [...] à côté du champ Password, puis, dans la boîte de dialogue qui s'ouvre, saisissez le mot de passe entre guillemets doubles et cliquez sur OK afin de sauvegarder les paramètres.

Data Container

Saisissez le nom du conteneur de données contenant les enregistrements de données à lire.

Type

Sélectionnez Master ou Staging afin de spécifier le type de la base de données dans laquelle effectuer l'action.

Récupérer les données brutes

Cochez cette case pour récupérer toutes les données recherchées d'une entité dans un seul champ, si nécessaire.

• XML field : sélectionnez le nom du champ dans lequel écrire les données récupérées.

• Accept Type : sélectionnez le type de contenu (XML ou JSON) que vous souhaitez récupérer.

Texte de la requête

Saisissez la requête que vous souhaitez inclure dans les appels de l'API REST pour récupérer les enregistrements de données qui vous intéressent. Notez que cette étape est obligatoire.

Hormis la requête d'exemple par défaut, la requête peut être :

• une variable globalMap, par exemple, ((String)globalMap.get("row1.query"))

• une variable de contexte avec pré-échappement, par exemple, context.lpcMDMRestQuery

• une requête incluant la variable globalMap et/ou la variable de contexte, par exemple, "{'select':{'from':['"+context.myEntity +"'],'fields':[{'field':'"+ (String)globalMap.get("field") +"'}] }}"

Vous pouvez renseigner le texte de chaque champ JSON de votre requête entre guillemets simples ou doubles.

Tout guillemet simple inclus dans la valeur d'un champ dans la requête doit être échappé deux fois avec des barres obliques inversées (\).

Par exemple, si vous avez la valeur This is Product's name dans le champ Name d'une entité Product, pour filtrer cette valeur particulière, vous pouvez écrire le texte de la requête de l'une des manières suivantes :

• "{'select':{'from':['Product'],'where':{'eq':[{'field':'Product/Name'},{'value':'This is Product\\'s name'}]}}}"
• "{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"

Une fois la requête saisie, assurez-vous que le schéma est bien défini par rapport à la requête. Pour plus d'informations, voir How to set the schema correctly based on the query text when using tMDMRestInput (en anglais).

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] 
    }
}

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] ,
         'joins': [
             {
             'from': 'Product/StoreFK',
             'on': 'Store/Id'
             }
          ] 
    }
}

Die on error

Cochez cette case pour passer la ligne en erreur et terminer le processus afin d'obtenir des lignes ne contenant aucune erreur. Si nécessaire, vous pouvez récupérer les lignes en erreur en utilisant un lien de type Row > Rejects.

Batch Size

Nombre de lignes dans chaque lot de traitement de données.

Lorsque le nombre d'enregistrements de la requête est supérieur à la taille du lot, les enregistrements doivent être paginés et récupérés lot par lot.

tStatCatcher Statistics

Cochez cette case pour collecter les métadonnées de traitement au niveau du Job ainsi qu'au niveau de chaque composant.

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 traitées. Cette variable est une variable After et retourne un entier.

Une variable Flow fonctionne durant l'exécution d'un composant. Une variable After fonctionne après l'exécution d'un composant.

Pour renseigner un champ ou une expression à l'aide d'une variable, appuyez sur les touches Ctrl+Espace pour accéder à la liste des variables. À partir de cette liste, vous pouvez choisir la variable que vous souhaitez utiliser.

Pour plus d'informations concernant les variables, consultez Utiliser les contextes et les variables.

Règle d'utilisation

Le tMDMRestInput peut être utilisé avec les composants tMDMConnection, tMDMCommit et tMDMRollback.

Le tMDMRestInput nécessite un lien de sortie.