Dans une prochaine version, la JVM intégrée pour le plug-in crawler et les fonctionnalités du connecteur client sera transférée vers IBM Semeru Runtimes, version 21. Si votre plug-in crawler ou vos connecteurs personnalisés utilisent des fonctionnalités incompatibles avec IBM SDK, Java Technology Edition, Version 8 et IBM Semeru Runtimes, Version 21, vous devez réviser votre code pour garantir la compatibilité avec les versions ultérieures, telles que Discovery 5.2.x et les versions ultérieures.

Pour la migration de la JVM, voir les pages suivantes :

Création d'un connecteur personnalisé

Discovery fournit des connecteurs à de nombreuses sources de données courantes, comme décrit dans la section Configuration des sources de données Cloud Pak for Data. Si vous avez besoin de vous connecter à une source de données différente, vous pouvez écrire et déployer un connecteur personnalisé.

IBM Cloud Pak for Data IBM Software Hub

Ces informations s'appliquent uniquement aux déploiements installés.

Tout code personnalisé utilisé avec IBM Watson® Discovery relève de la responsabilité du développeur et n'est pas couvert par l'assistance IBM.

Exemple de code et de fichiers de configuration pour un connecteur personnalisé de base.

Rubriques connexes :

Exigences relatives au connecteur personnalisé

Un connecteur personnalisé est un composant qui utilise le SDK et le cadre de crawler documenté ici pour se connecter à une source de données spécifique et l'explorer. Les connecteurs personnalisés ont les mêmes exigences générales que les connecteurs fournis. Pour plus d'informations, voir Configuration requise pour les sources de données.

Avant d'implémenter un connecteur personnalisé, vous devez connaître les informations suivantes sur la source de données:

  • Emplacement du réseau de la source de données (nom ou adresse du serveur, y compris le port, ou URL, y compris le port)
  • Méthode d'authentification et données d'identification de sécurité de la source de données
  • Chemin ou chemins d'accès sur la source de données que le connecteur doit explorer
  • Méthode ou protocole de connexion pris en charge par la source de données

Conception d'un connecteur personnalisé

Un connecteur personnalisé requiert les fonctionnalités suivantes :

  • Configuration d'un moteur d'exploration.

    • Configuration de tous les paramètres requis pour la connexion à la source de données.
    • Découverte d'un vide sanitaire sur la source de données. Au moins un espace d'exploration est requis.

  • Exploration de documents.

    • Exploration des documents sur chaque ensemble de données.
    • Ajout d'informations de liste de contrôle d'accès (ACL) à chaque document.

  • Extraction des informations de liste de contrôle d'accès pour le nom d'utilisateur qui s'authentifie auprès de la source de données.

Ces capacités peuvent être mises en œuvre en utilisant les interfaces et les méthodes décrites dans le code de développement de connecteurs personnalisés.

Limitations du connecteur personnalisé

Respectez les remarques et avertissements suivants lorsque vous mettez en œuvre un connecteur personnalisé.

  • Les connecteurs personnalisés ne prennent pas en charge les fonctions suivantes:

    • Paramètres de synchronisation
    • Filtrage des documents en fonction de l'accès utilisateur au moment de la requête. (Au moment de l'exploration et de l'indexation, seuls les documents auxquels l'utilisateur en cours a le droit d'accéder sont renvoyés.)
    • Paramètres de validation required et hidden. Ils sont ignorés lorsque le connecteur est affiché dans Discovery
    • L'utilisation des balises <condition /> dans le fichier de définition. Ces balises sont actuellement ignorées.

  • Lorsque vous utilisez le code du connecteur d'exemple dans la version actuelle, Discovery ne regroupe pas les paramètres d'authentification pour les propriétés du connecteur personnalisé. Par exemple, même lorsque le bouton à bascule {connector_name}_DATASOURCE_SETTINGS_USE_KEY_LABEL est défini sur Off, l'interface utilisateur affiche les zones pour {connector_name}_DATASOURCE_SETTINGS_KEY_LABEL et {connector_name}_DATATSOURCE_SETTINGS_PASSPHRASE_LABEL.

  • Le type de paramètre list n'est pas pris en charge.

  • Si un connecteur personnalisé ne parvient pas à se connecter à sa source pour une raison quelconque, il émet un message d'erreur générique tel que Failed to create connector ou Timed out, ou une erreur HTTP 500. Des informations d'échec spécifiques ne sont pas fournies actuellement.

    Pour plus d'informations sur les problèmes possibles, voir les notes sur l'édition.