Créer des indicateurs Java personnalisés
- Big Data Platform
- Cloud API Services Platform
- Cloud Big Data Platform
- Cloud Data Fabric
- Cloud Data Management Platform
- Data Fabric
- Data Management Platform
- Data Services Platform
- Qlik Talend Cloud Enterprise Edition
- Qlik Talend Cloud Premium Edition
- Real-Time Big Data Platform
Vous pouvez créer vos propres indicateurs Java personnalisés.
Les processus de gestion des indicateurs personnalisés Java sont les mêmes que ceux des indicateurs système.
Vous pouvez également importer un indicateur Java personnalisé prêt à l'emploi du dossier Exchange dans la vue DQ repository (Référentiel DQ). Cet indicateur java personnalisé se connecte à un serveur d'e-mails et vérifie si un e-mail existe.
Définir l'indicateur personnalisé
- Big Data Platform
- Cloud API Services Platform
- Cloud Big Data Platform
- Cloud Data Fabric
- Cloud Data Management Platform
- Data Fabric
- Data Management Platform
- Data Services Platform
- Qlik Talend Cloud Enterprise Edition
- Qlik Talend Cloud Premium Edition
- Real-Time Big Data Platform
Procédure
- Dans la vue DQ repository (Référentiel DQ), développez Libraries (Bibliothèques) > Indicators (Indicateurs).
-
Cliquez-droit sur Custom Indicators (Indicateurs personnalisés).
-
Sélectionnez New Indicator dans le menu contextuel.
L'assistant [New Indicator] s'ouvre.
-
Dans le champ Name, saisissez un nom pour l'indicateur Java que vous souhaitez créer.
- Facultatif :
Définissez les autres métadonnées (Purpose (Objectif), Description et Author (Auteur)) dans les champs correspondants puis cliquez sur Finish.
L'éditeur d'indicateur s'ouvre et affiche les métadonnées de l'indicateur personnalisé.
Configurer la définition et la catégorie de l'indicateur personnalisé
- Big Data Platform
- Cloud API Services Platform
- Cloud Big Data Platform
- Cloud Data Fabric
- Cloud Data Management Platform
- Data Fabric
- Data Management Platform
- Data Services Platform
- Qlik Talend Cloud Enterprise Edition
- Qlik Talend Cloud Premium Edition
- Real-Time Big Data Platform
Avant de commencer
Procédure
-
Dans la vue Indicator Category (Catégorie de l'indicateur), sélectionnez dans la liste une catégorie pour l'indicateur.
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 Description Résultats attendus de requêtes User-defined Match (Correspondance personnalisée) É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 (Fréquence personnalisée) É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 (Valeur réelle personnalisée) 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 (Compte personnalisé) 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. - Cliquez sur Indicator Definition puis sur le bouton [+].
- Dans la liste Database, sélectionnez Java.
-
Saisissez la classe Java dans le champ Java Class.
Note InformationsRemarque : Vérifiez que le nom de la classe inclut le chemin d'accès au package. 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.
-
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 sur la création d'une archive Java, consultez Créer une archive Java pour un indicateur personnalisé.
-
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 plus détaillé de l'utilisation des paramètres dans un indicateur personnalisé Java, consultez la documentation disponible (en anglais). -
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 modifier 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 modifier les paramètres par défaut selon vos besoins, ou ajouter de nouveaux paramètres.
-
Cliquez sur l'icône de sauvegarde en haut de l'éditeur.
L'indicateur est listé dans le dossier Custom Indicators (Indicateurs personnalisés) dans l'arborescence DQ repository (Référentiel DQ). Vous pouvez utiliser cet indicateur dans des colonnes analysées via un simple glisser-déposer de la vue DQ repository (Référentiel DQ) dans les colonnes listées dans l'éditeur.
Créer une archive Java pour un indicateur personnalisé
- Big Data Platform
- Cloud API Services Platform
- Cloud Big Data Platform
- Cloud Data Fabric
- Cloud Data Management Platform
- Data Fabric
- Data Management Platform
- Data Services Platform
- Qlik Talend Cloud Enterprise Edition
- Qlik Talend Cloud Premium Edition
- Real-Time Big Data Platform
Avant de commencer
Procédure
-
Définissez la plateforme cible :
- Dans le menu Eclipse, sélectionnez Preferences (Préférences) pour afficher la boîte de dialogue Preferences (Préférences).
- Développez Plug-in Development et sélectionnez Target Platform, puis cliquez sur Add... afin d'ouvrir une vue dans laquelle créer la définition de la cible.
- Sélectionnez l'option Nothing: Start with an empty target definition, puis cliquez sur Next.
- Dans le champ Name, saisissez un nom pour la nouvelle définition de la cible, puis cliquez sur Next.
- Sélectionnez Installation dans la liste Add Content et cliquez sur Next.
-
Utilisez le bouton Browse... pour définir le chemin d'accès au répertoire d'installation puis cliquez sur Next.
La nouvelle définition de la cible s'affiche dans la liste des emplacements.
- Cliquez sur Finish pour fermer la boîte de dialogue.
-
Créer une archive Java pour un indicateur personnalisé.
-
Dans Eclipse, effectuez un check out sur le projet Git.
Dans ce projet Java, vous pouvez trouver quatre classes Java correspondant aux quatre catégories d'indicateurs listées dans la vue Indicator Category dans l'éditeur d'indicateur.
Chacune de ces classes Java étend l'indicateur UserDefIndicatorImpl. La capture d'écran ci-dessous montre un exemple d'utilisation de la classe Java MyAvgLength.
package test.udi; import org.talend.dataquality.indicators.sql.impl.UserDefIndicatorImpl; /** * @author mzhao * * A very simple example of a java implementation of a user defined indicator. This indicator returns a user defined * real value. It implements the minimum number of required methods. */ public class MyAvgLength extends UserDefIndicatorImpl { private double length = 0; @Override public boolean reset() { super.reset(); length = 0; return true; } @Override public boolean handle(Object data) { super.handle(data); // an indicator which computes the average text length on data which are more than 2 characters (this means that // text values with less than 2 characters are not taken into account). int dataLength = (data != null) ? data.toString().length() : 0; if (dataLength > 2) { length += dataLength; } return true; } /* * (non-Javadoc) * * @see org.talend.dataquality.indicators.impl.IndicatorImpl#finalizeComputation() */ @Override public boolean finalizeComputation() { value = String.valueOf(this.length / (this.getCount() - this.getNullCount())); return super.finalizeComputation(); } } - Modifiez le code des méthodes suivant chaque @Override selon vos besoins.
- Facultatif :
Utilisez les méthodes suivantes dans votre code pour retrouver les paramètres de l'indicateur :
Méthode Description Indicator.getParameter() Retourne un objet IndicatorParameters. IndicatorParameters.getIndicatorValidDomain() Retourne un objet Domain. Domain.getJavaUDIIndicatorParameter() Retourne une liste de paramètres d'indicateurs Java personnalisés JavaUDIIndicatorParameter qui stocke chaque pair clé/valeur définissant le paramètre. - Sauvegardez vos modifications.
- En utilisant Eclipse, exportez cette nouvelle archive Java.
-
Dans Eclipse, effectuez un check out sur le projet Git.
Résultats
L'archive Java est maintenant prête à être jointe à tout indicateur Java que vous souhaitez créer dans la perspective .
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.