Configurer la définition et la catégorie de l'indicateur personnalisé - 7.1

Guide utilisateur de Talend Data Fabric Studio

author
Talend Documentation Team
EnrichVersion
7.1
EnrichProdName
Talend Data Fabric
task
Création et développement
EnrichPlatform
Studio Talend

Avant de commencer

Vous avez sélectionné la perspective Profiling depuis le Studio Talend.

Procédure

  1. Dans la liste Indicator Category, sélectionnez une catégorie pour l'indicateur Java créé.
    La catégorie sélectionnée déterminera les colonnes attendues dans le résultat de l'analyse utilisant cet indicateur.
    Le tableau ci-dessous présente les catégories disponibles.

    Catégorie de l'indicateur

    Description

    Résultats attendus de requêtes

    User Defined Match

    Évalue le nombre de données répondant à une condition.

    L'ensemble de résultats doit contenir une ligne et deux colonnes. La seconde colonne contient le nombre total de valeurs.

    User Defined Frequency

    Évalue la fréquence des enregistrements utilisant les indicateurs personnalisés pour chaque enregistrement distinct.

    L'ensemble de résultats doit contenir au moins zéro ligne et deux colonnes. La première colonne contient une valeur et la seconde contient la fréquence (nombre) de cette valeur.

    User Defined Real Value

    Evalue la fonction réelle des données.

    L'ensemble de résultats doit contenir une ligne et une colonne contenant une valeur réelle.

    User Defined Count (catégorie par défaut)

    Analyse la quantité d'enregistrements et retourne le nombre de lignes.

    L'ensemble de résultats doit contenir une ligne et une colonne contenant le nombre de lignes.
  2. Cliquez sur Indicator Definition puis sur le bouton [+].
  3. Dans la liste Database, sélectionnez Java.
  4. Saisissez la classe Java dans le champ Java Class.
    Remarque : Si cette chaîne de caractères n'a pas été correctement spécifiée, un message d'erreur s'affichera lorsque vous essayerez de sauvegarder l'indicateur personnalisé Java.
  5. Sélectionnez l'archive Java contenant la classe Java :
    • Cliquez sur le bouton Edit....

      La boîte de dialogue [UDI Selector] s'ouvre.

    • Dans la vue Select libraries, cochez la case de l'archive contenant la classe Java et sélectionnez la classe dans le panneau inférieur de l'assistant.

    • Cliquez sur OK.

      La boîte de dialogue se ferme et l'archive Java s'ouvre dans l'éditeur d'indicateur.

      Vous pouvez ajouter ou supprimer des archives Java depuis la vue Manage Libraries de cette boîte de dialogue.

      Pour plus d'informations concernant la création d'une archive Java, consultez Créer une archive Java pour un indicateur personnalisé.

  6. Cliquez sur Indicator Parameters pour ouvrir la vue dans laquelle vous pouvez définir les paramètres afin de récupérer les valeurs des paramètres lors du codage de l'indicateur Java.
    Vous pouvez récupérer la valeur des paramètres avec un code similaire à celui-ci, récupérant le paramètre EMAIL_PARAM :
    // Check prerequisite
            IndicatorParameters param = this.getParameters();
            if (param == null) {
                log.error("No parameter set in the user defined indicator " + this.getName()); //$NON-NLS-1$
                return false;
            }
            Domain indicatorValidDomain = param.getIndicatorValidDomain();
            if (indicatorValidDomain == null) {
                log.error("No parameter set in the user defined indicator " + this.getName()); //$NON-NLS-1$
                return false;
            }
    
            // else retrieve email from parameter
            EList<JavaUDIIndicatorParameter> javaUDIIndicatorParameter = indicatorValidDomain.getJavaUDIIndicatorParameter();
            for (JavaUDIIndicatorParameter p : javaUDIIndicatorParameter) {
                if (EMAIL_PARAM.equalsIgnoreCase(p.getKey())) {
    Pour un exemple de code complet pour utiliser les paramètres dans un indicateur Java personnalisé, consultez la page https://github.com/Talend/tdq-Studio-se/tree/master/sample/test.myudi/src/main/java/org/talend/dataquality/indicator/userdefine/email.
  7. Cliquez sur le bouton [+] au bas de la table et définissez, dans la nouvelle ligne, les champs Parameters Key et Parameters Value, en cliquant dans chaque champ.
    Vous pouvez éditer ces paramètres par défaut ou ajouter de nouveaux paramètres à tout moment, lorsque vous utilisez cet indicateur dans une analyse de colonne. Pour ce faire, cliquez sur l'icône d'option d'indicateur dans l'éditeur d'analyse afin d'ouvrir une boîte de dialogue dans laquelle vous pouvez éditer les paramètres par défaut selon vos besoins, ou ajouter de nouveaux paramètres.
  8. Cliquez sur l'icône de sauvegarde en haut de l'éditeur.
    L'indicateur s'affiche sous le nœud User Defined Indicators, dans la vue DQ Repository. Vous pouvez utiliser cet indicateur dans des colonnes analysées via un simple glisser-déposer de la vue DQ Repository dans les colonnes listées dans l'éditeur.