Propriétés du tSAPInfoCubeInput Standard - Cloud - 8.0

SAP

Version
Cloud
8.0
Language
Français
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Studio Talend
Content
Création et développement > Systèmes tiers > Applications métier > Composants SAP
Gouvernance de données > Systèmes tiers > Applications métier > Composants SAP
Qualité et préparation de données > Systèmes tiers > Applications métier > Composants SAP
Last publication date
2024-04-02

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

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

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

Remarque : Lorsqu'une fenêtre vous signale que ce composant nécessite sapjco.jar, téléchargez le module et consultez les instructions à l'adresseSAP Java Connector (en anglais).

Basic settings

Type de propriété

Sélectionnez la manière de configurer les informations de connexion.

  • Built-In : les paramètres de connexion seront définis localement pour ce composant. Vous devez spécifier manuellement les valeurs pour toutes les propriétés de connexion.

  • Repository : les paramètres de connexion stockés centralement dans le Repository > Metadata seront réutilisés par ce composant.

    Vous devez cliquer sur le bouton [...] et, dans la boîte de dialogue Repository Content, sélectionnez les détails de connexion à réutiliser. Toutes les propriétés de connexion seront automatiquement renseignées.

Use an existing connection

Cochez cette case et, dans la liste Connection configuration qui s'affiche, sélectionnez le composant duquel réutiliser la configuration de la connexion à la base de données.

Lorsqu'un Job contient un Job parent et un Job enfant, la liste qui s'affiche présente uniquement les composants de connexion du Job du même niveau.

Server Type

Sélectionnez le type du serveur auquel se connecter, Application Server ou Message Server.

Client

ID du système SAP client.

UserId et Password

Identifiant et mot de passe de connexion de l'utilisateur ou de l'utilisatrice.

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.

Language

Spécifiez la langue du système SAP.

Host name

Nom ou adresse IP de l'hôte sur lequel le serveur SAP s'exécute.

System number

Numéro du système SAP.

Cette propriété est disponible uniquement lorsque l'option Application Server est sélectionnée dans la liste Server Type.

System ID

ID du système SAP.

Cette propriété est disponible uniquement lorsque l'option Message Server est sélectionnée dans la liste Server Type.

Group Name

Saisissez le nom du groupe SAP.

Cette propriété est disponible uniquement lorsque l'option Message Server est sélectionnée dans la liste Server Type.

Schema et Edit schema

Un schéma est une description de lignes. Il définit le nombre de champs (colonnes) à traiter et à passer au composant suivant. Lorsque vous créez un Job Spark, évitez le mot réservé line lors du nommage des champs.

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

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

Créez le schéma en cliquant sur le bouton Edit Schema. Si vous effectuez des modifications, le schéma passe automatiquement en type built-in.

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

Ce composant offre la fonction de schéma dynamique. Cela vous permet de récupérer des colonnes inconnues de fichiers sources ou de copier des lots de colonnes d'une source sans avoir à mapper chaque colonne individuellement. Pour plus d'informations concernant les schémas dynamiques, consultez Schéma dynamique.

Cette fonctionnalité de schéma dynamique est conçue pour permettre de récupérer des colonnes inconnues d'une table. Il est recommandé de l'utiliser uniquement à cet effet et non pour créer des tables.

Name

Saisissez le nom de l'objet InfoCube duquel récupérer les données.

Max row number

Spécifiez le nombre maximal de lignes à récupérer. Par défaut, la valeur est définie à -1, ce qui signifie que toutes les lignes sont récupérées.

Filter Group

Spécifiez les conditions de recherche utilisées pour filtrer les données à récupérer en cliquant sur le bouton [+] pour ajouter autant de lignes que nécessaire, chaque ligne pour une condition de recherche, puis configurez la valeur des attributs suivants pour chaque condition.

  • Column : saisissez le nom de la colonne du schéma sur laquelle les données récupérées seront filtrées.

  • Sign : sélectionnez Include ou Exclude dans la liste déroulante.

    • Include : données répondant à la condition seront récupérées.

    • Exclude : données ne répondant pas à la condition seront récupérées.

  • Operator : sélectionnez dans la liste déroulante l'opérateur du filtre sur les données utilisé pour construire la condition de recherche.

  • Value : spécifiez la valeur de recherche utilisée pour la condition de recherche. Notez que les caractères de remplacement ne sont pas supportés.

  • High value : spécifiez une autre valeur de recherche utilisée pour construire la condition de recherche pour l'opérateur Between.

    Lorsque vous utilisez une colonne de type Date pour spécifier un filtre, les valeurs de dates et temps des colonnes Value et High Value doivent être au format yyyyMMdd et HHMMSS, format potentiellement différent de celui défini dans l'éditeur de schéma. Notez que les caractères de remplacement ne sont pas supportés.

Les caractères de remplacement suivants peuvent être utilisés lors de la spécification de la valeur de recherche à l'aide d'un modèle :

  • * : met en correspondance n'importe quel nombre de caractères.

  • + : met en correspondance un seul caractère.

  • # : à utiliser pour échapper des caractères (par exemple *, #) et pour une comparaison sensible à la casse avec casse exacte.

Remarque : L'opérateur Contains pattern de la liste déroulante de la colonne Operator pourra être utilisé ultérieurement.

Specify a shared destination

Cochez cette case et spécifiez la destination partagée dans le champ Shared destination name qui s'affiche. La destination partagée permet aux composants SAP d'utiliser la destination partagée dans Talend Runtime lorsqu'ils sont exécutés comme partie d'une Route ESB ou d'un service de données ESB dans l'environnement OSGi du conteneur Talend Runtime.

En plus de spécifier le nom de la destination partagée, vous devez également configurer la source des données SAP (DataSource) pour Talend Runtime. La procédure pour définir la source des données SAP et pour la configurer sont décrites dans le fichier lisezmoi.txt fourni dans le package de Talend ESB, dans le dossier /add-ons/datasource/sap.

Si vous utilisez la configuration propre du composant, votre connexion SAP se ferme à la fin de l'exécution du composant. Pour éviter cela, utilisez une destination partagée ayant un nom spécifié.

Use FTP-Batch Options

Cochez cette case lorsque la taille des données à récupérer est supérieure à la taille spécifiée dans le champ Fetch size. Lorsque cette case est cochée, le système SAP génère autant de fichiers que nécessaire et écrit les données récupérées dans ces fichiers. Ce composant lit ensuite les fichiers via une connexion FTP afin de récupérer les données et transférer ces données au composant de sortie.

Les propriétés suivantes sont doivent être spécifiées lorsque cette case est cochée :

  • File Protocol : sélectionnez FTP ou son alternative sécurisée, SFTP.
  • Host : spécifiez l'adresse IP ou le nom d'hôte du serveur FTP.

  • Port : numéro du port d'écoute du serveur FTP.

  • User et Password : données d'authentification requises pour accéder au serveur FTP.

  • Directory : spécifiez le répertoire dans lequel sauvegarder les fichiers générés par le système SAP.

  • Data filename prefix : préfixe des fichiers générés par le système SAP.

Advanced settings

Fetch size

Saisissez la taille maximale du jeu de résultats (en nombre de lignes) pouvant être retournée depuis la base de données SAP BW en réponse à un appel BAPI ou à une requête.

Une valeur de -1, la valeur par défaut, utilise la taille de récupération par défaut, déterminée par le code Java ou du côté BAPI de SAP.

Il est recommandé de configurer ce champ en fonction de la mémoire allouée à votre Job et du nombre de champs demandés. Avec une taille de mémoire allouée donnée, plus vous demandez de champs, plus la taille de récupération est petite.

SAP Properties

Si vous souhaitez utiliser une configuration personnalisée pour le système SAP à utiliser, renseignez cette table avec la ou les propriétés(s) à personnaliser. Par exemple :
  • pour établir une connexion Unicode entre le système SAP et le Studio Talend, vous devez ajouter la propriété jco.server.unicode et configurer sa valeur à 1. Notez que cette propriété fonctionne si vous utilisez SAP Java Connector 2.x et n'est pas nécessaire pour SAP Java Connector 3.0 et ses versions supérieures.

  • si vous devez configurer une connexion SAP avec SNC (Secure Network Communications), ajoutez et configurez les propriétés suivantes dans ce champ.

    • jco.client.snc_mode
    • jco.client.snc_myname
    • jco.client.snc_lib=.../sapcrypto/sapcrypto.dll
    • jco.client.snc_partnername
    • jco.client.snc_qop
    Remarque : La valeur des propriétés ci-dessus varie selon l'environnement système. Contactez votre administrateur·trice système SAP si vous ne savez pas comment configurer ces propriétés.

    Pour plus d'informations concernant la configuration des paramètres SNC, consultez Configuring SNC: External Programs to AS ABAP Using RFC and Communication Paths that Support SNC.

Cette propriété n'est pas visible lorsque la case Use an existing connection est cochée.

SAP function extraction path

Sélectionnez cette option pour spécifier un répertoire pour la fonction SAP, afin de générer les fichiers contenant les données extraites. Vous pouvez saisir le chemin d'accès au répertoire dans le champ de texte à droite.

Si cette option n'est pas sélectionnée, les fichiers seront générés dans le répertoire spécifié dans le champ FTP directory de la vue Basic settings.

Cette option est disponible lorsque vous sélectionnez l'option Use FTP-Batch Options dans la vue Basic settings. Cette option n'est pas disponible si vous cochez la case Use the SAP Application Server logical path dans la vue Basic settings.

Comme le Studio Talend ne synchronise pas les répertoires spécifiés par les champs SAP function extraction path et FTP directory, assurez-vous que ces deux champs pointent vers la même ressource.

tStatCatcher Statistics

Cochez cette case pour collecter les métadonnées de traitement du Job, aussi bien au niveau du Job 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.

Utilisation

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

Les fichiers JAR et DLL spécifiques fournis par SAP doivent être ajoutés au Studio Talend et au poste de travail hébergeant votre Studio Talend. La procédure exacte varie d'une plateforme à une autre, par exemple 32 bits, 64 bits, sous Windows ou Linux.