Étapes : configurer des sources de données pour la base de données JDBC

Adaptive Planning

Vous pouvez utiliser

Adaptive Planning

Integration pour extraire des informations depuis des bases de données compatibles JDBC. La plupart des bases de données utilisées pour les applications de finances et comptabilité sont compatibles JDBC (Java Database Connectivity). JDBC est une norme qui utilise le langage de programmation Java pour assurer la connectivité à un large éventail de bases de données.

Une source de données de base de données compatible JDBC nécessite un pilote. Le tableau ci-dessous indique des informations sur les pilotes JDBC les plus utilisés.

Les agents de données Adaptive Planning se connectent uniquement à des bases de données sur site. La connexion à des bases de données Cloud avec un agent n'est pas prise en charge.

Source JDBC	Présentation	Fournisseur Jar	Classe de pilote	Exemple JDBC/URL	Informations sur les URL JDBC
Oracle	PrésentationBase de données Oracle	ojdbc6-11.2.0.3.jar Vous pouvez obtenir ce fichier sur le site web d'Oracle ou via le référentiel Maven d'Oracle.	oracle.jdbc.OracleDriver	jdbc:oracle:thin:@example-win-db:1521:ANACONDA	Classe OracleDriver
SQL Server	Microsoft SQL Server	jtds-1.3.1.jar distribué dans le dossier Data Agent Plugins. voir Sécurité intégrée pourSources de données JDBC pour le détail de l'emplacement de DLL	net.sourceforge.jtds.jdbc.Driver	jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS	Formats jTDS
SQL Server	Microsoft SQL Server	jsqljdbc41.jar distribué dans le dossier Data Agent Plugins. voir Sécurité intégrée pourSources de données JDBC pour le détail de l'emplacement de DLL	com.microsoft.sqlserver.jdbc.SQLServerDriver	jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;	Création de l'URL de connexion
MySql	Manuels de référence MySQL	mysql-connector-5.1.17.jar	com.mysql.jdbc.Driver	jdbc:mysql://localhost:3306/AGENT_test	Syntaxe d'URL
h2	Moteur de base de données H2	Recherchez le fichier h2*.jar dans la distribution de Workday Adaptive Planning Data Agent Service Manager. Pour les versions 7.1.44 et antérieures de l'agent de données, recherchez le fichier h2.jar dans la distribution d'Adaptive Data Agent Service Manager.	org.h2.Driver	jdbc:h2:/data/test	Aide-mémoire H2

Les fichiers jar se trouvent dans

C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.

Pour les versions 7.1.44 et antérieures de l'agent de données, utilisez

C:/Program Files/Adaptive Data Agent/Plugins

sur la machine hébergeant le service de l'agent de données.

Après avoir ajouté un fichier jar, accédez aux services locaux et redémarrez le service de l'agent de données.

Avant de configurer une source de données dans une base de données locale, vous devez avoir créé un agent de données qui indique :

Adaptive Planning

Integration comment communiquer avec la base de données. Pour plus d'informations sur la création d'agents de données, voir Créer des agents de données.

Pour configurer une source de données de base de données JDBC, procédez comme suit :

Accédez au concepteur de données en sélectionnant Intégration > Concepteur de données
.

Dans le dossier Source de données de la Bibliothèque de composants à droite de l'écran, cliquez sur Créer une nouvelle source de données
. La boîte de dialogue Créer apparaît.

Sélectionnez la base de données JDBC comme type de source de données, saisissez le nom de la base de données et sélectionnez l'agent que vous souhaitez utiliser pour cette source de données.

Cliquez sur Créer
. La zone centrale de l'écran affiche les paramètres de votre nouvelle source de données, ainsi que d'autres informations.

Saisissez les informations de la source de données :

Agent associé :

sélectionnez l'agent de données Adaptive Planning auquel vous souhaitez vous connecter. Cette liste contient tous les agents de données trouvés dans

la Bibliothèque de composants

Agents de données

Classe de pilote :
indiquez la classe de pilote correspondant à la base de données. (Vous pouvez obtenir cette information auprès du fournisseur de la base de données.)

URL :
saisissez l'URL de la base de données.

Nom d'utilisateur :
saisissez le nom d'utilisateur utilisé pour accéder à la base de données.

Mot de passe :
saisissez le mot de passe associé au nom d'utilisateur.

Filtre de schéma :
saisissez le nom du ou des schémas à partir desquels vous souhaitez importer des données. Si vous saisissez les noms de plusieurs schémas, saisissez les noms de schémas séparés par un point-virgule. Utilisez ce champ pour limiter le nombre de tables devant être actualisées dans

Adaptive Planning

Intégration. Ce champ est facultatif.

Niveau de journalisation :
sélectionnez un niveau de journalisation dans la liste déroulante afin de spécifier les détails de journalisation de cette source de données. Vos options sont les suivantes :

Erreur :
consigne uniquement les erreurs graves.

Informations :
consigne toutes les informations de base. Par exemple, lorsque la source de données a été mise à jour.

Mode détaillé :
fournit des informations très détaillées sur toutes les phases et actions. (Ce périmètre est principalement utilisé pour le débogage ou l'audit car il génère souvent trop d'informations pour une utilisation normale.)

Cliquez sur Enregistrer
dans le menu Actions.

Vous pouvez tester les informations de connexion dans la nouvelle source de données en cliquant sur Tester la connexion
dans le menu Actions
. Le système tente de se connecter à la base de données en utilisant les informations disponibles dans les champs de la source de données. Si le système peut se connecter à la base de données, cliquez sur OK
. En cas de problèmes de connexion, corrigez les erreurs et réessayez.

Lorsque vous pouvez vous connecter à la base de données, vous êtes prêt à importer la structure de données. Les tables et colonnes vous sont indiquées dans la base de données.

Seules les colonnes pour les types pris en charge apparaissent. La section Types de colonnes pris en chargerépertorie les types de colonne pris en charge pour les différents types de base de données.

Pour importer la structure de la base de données JDBC, procédez comme suit :

Cliquez sur Importer la structure
dans le menu Actions
. Les tables et colonnes apparaissent dans le menu Composants de données
.

Les modes d'import de données affectent la manière dont les données sont synchronisées. Le mode d'import par défaut (tous les enregistrements remplacés) pour une source de données JDBC est le suivant :

Les imports de données JDBC.

Les données de la source JDBC alimentent la table temporaire.

S'il existe un filtre SQL personnalisé, il est appliqué aux données à importer depuis le serveur de base de données pour déterminer le sous-ensemble de données à importer.

Vous pouvez également choisir d'ajouter des informations importées, auquel cas les données importées seront ajoutées à la table temporaire existante, ou fusionner des informations importées, auquel cas les lignes existantes dans les données JDBC seront fusionnées avec les lignes dans la zone de stockage temporaire.

Ajouter des tables à une source de données JDBC

Après avoir importé la structure de la base données, vous êtes prêt à spécifier les informations que vous souhaitez importer depuis la base de données. La section Tables à importer
de l'écran vous permet de configurer les données importées depuis la base de données.

Pour spécifier les tables à importer depuis la base de données, procédez comme suit :

Développez l'entrée de la source de données dans le menu Composants de données
.

Chaque table de la base de données apparaît comme un élément distinct.

Faites glisser les tables que vous voulez importer jusqu'à la section Tables à importer
au centre de l'écran.

À mesure que vous faites glisser chaque table vers la section Tables à importer, un onglet apparaît pour la table et les informations de la base de données apparaissent dans la section Tables à importer, ce qui vous permet de voir le type d'information que vous avez ajouté. L'onglet de chaque table dispose également d'un menu déroulant, auquel vous pouvez accéder en cliquant sur la flèche en regard de son nom.

Gérer les colonnes

Si une table avec laquelle vous travaillez dispose d'un grand nombre de colonnes, vous pouvez utiliser Gérer les colonnes
pour apporter des modifications rapides aux colonnes à importer. La boîte de dialogue Gérer les colonnes
affiche les colonnes disponibles dans une table afin que vous puissiez cocher ou décocher les colonnes à importer.

Pour gérer les colonnes à importer, procédez comme suit :

Cliquez sur la flèche de l'onglet situé à droite du nom de la table.

Cliquez sur Gérer les colonnes
dans le menu flottant.

Cochez la case en regard d'une colonne pour l'importer.

Lorsque vous cochez une colonne, celle-ci apparaît également dans la fenêtre d'aperçu une fois que le contenu contextuel est sauvegardé. Si vous décochez une colonne, la colonne sera supprimée de la fenêtre d'aperçu.

Vous pouvez également modifier le statut d'import de colonnes individuelles :

En sélectionnant les propriétés de colonne et en définissant la propriété.

En faisant glisser et en déposant les colonnes dans le concepteur.

Vous ne pouvez pas modifier le statut d'import des champs générés par le système, tel que isDeleted
.

Personnaliser les tables

Pour chaque table, vous pouvez personnaliser le mode d'import des données.

Pour personnaliser les paramètres d'une table, procédez comme suit :

Cliquez sur la flèche de l'onglet situé à droite du nom de la table.

Cliquez sur Paramètres de la table
dans le menu flottant.

Saisissez les paramètres de la table :

Mode d'import des données :
sélectionnez l'une des options dans la liste déroulante.

Tous les enregistrements sont remplacés à chaque exécution d'un import de données
: il s'agit du paramètre par défaut. Remplace les données dans la table temporaire par les données importées de la source.

Cache distant utilisé pour identifier et envoyer les enregistrements modifiés lors de l'import
: seuls les enregistrements de la base de données qui ont été modifiés ou qui sont nouveaux sont importés. Les enregistrements modifiés écrasent les enregistrements existants dans la zone de stockage temporaire. De nouveaux enregistrements sont ajoutés à la fin des informations dans la zone de stockage temporaire.

Tous les enregistrements qui appartiennent à une plage de périodes sont transmis
: tous les enregistrements de la plage de périodes que vous indiquez sont importés. Les enregistrements dans la table temporaire correspondant aux périodes importées sont supprimés avant d'importer les données les plus récentes de la source.

Filtre d'import des données :
utilisez cette option pour saisir une expression SQL qui filtre ou formate les informations en cours d'import. Le filtre SQL est appliqué avant que les données ne soient extraites de la base de données afin de réduire la quantité de données devant être importées, ce qui vous donne un niveau de contrôle supplémentaire concernant les données à introduire dans la zone de stockage temporaire. Cliquez sur le champ pour afficher la boîte de dialogue Modifier le filtre SQL
(le filtre que vous saisissez ici est appliqué aux montants réels de la base de données plutôt qu'aux données de prévisualisation dans la zone de stockage temporaire). Les sources de données ne prennent pas toutes en charge le même niveau de fonctionnalité de filtrage SQL.

Cliquez sur Appliquer
pour appliquer les paramètres.

Répétez les étapes 1 à 3 pour chaque table.

Si une table de base de données comporte des clés définies, ces informations seront également intégrées dans la table temporaire. Vous pouvez consulter ces informations et les modifier, le cas échéant.

Cliquez sur Enregistrer
pour enregistrer les paramètres dans la source de données.

Paramétrer les options des colonnes

Lorsque vous utilisez la section Tables à importer
, vous pouvez voir un aperçu des données telles qu'elles se trouvent dans la source de données ou dans la zone de stockage temporaire après leur import. Vous pouvez modifier les options de chaque colonne en passant la souris sur son titre, puis en cliquant sur le menu déroulant en regard de son nom. Ces options sont les suivantes :

Trier par ordre croissant
: triez l'ensemble de la table en fonction de cette colonne dans l'ordre croissant.

Trier par ordre décroissant
: triez l'ensemble de la table en fonction de cette colonne dans l'ordre décroissant.

Paramètres de la colonne
: cette boîte de dialogue permet de modifier les propriétés de la colonne dans la table temporaire.

Nom
: nom de la colonne, tel qu'il est affiché dans l'en-tête.

Type de colonne
: type de données utilisées dans la colonne.

Convertir le type de colonne
: sélectionnez le nouveau type dans ce menu déroulant.

Exclure la colonne de l'import
: sélectionnez cette option pour supprimer cette colonne des données importées.

Supprimer une colonne personnalisée
: sélectionnez cette option pour supprimer la colonne. (Disponible uniquement pour les colonnes personnalisées.)

Télécharger des données depuis une table temporaire

Vous pouvez télécharger des données à partir d'une seule table temporaire.

Pour télécharger des données à partir d'une seule table temporaire, procédez comme suit :

Cliquez sur la flèche bas située dans un en-tête de table de la section Tables à importer.

Cliquez sur Télécharger les données
.

Lorsque vous y êtes invité, cliquez sur Envoyer
. Cette opération va envoyer un e-mail contenant une adresse URL pour télécharger les données
.

Adaptive Planning

Integration envoie un e-mail contenant une URL au compte de messagerie associé au concepteur de données.

Ouvrez l'e-mail et cliquez sur l'URL.

Les données sont téléchargées au format .csv.

Utiliser le filtre avancé

Sous le menu déroulant Source
, vous pouvez cliquer sur Filtre avancé
afin d'afficher des options permettant de filtrer les données dans la zone de prévisualisation Tables à importer
. Le filtre avancé
fournit des outils pour afficher et parcourir un sous-ensemble de données dans une table temporaire ou directement depuis la source distante (si vous avez sélectionné Base de données JDBC dans le menu déroulant Source). En modifiant les propriétés du filtre, vous pouvez modifier la vue des données affichées dans la fenêtre de prévisualisation sans modifier les données dans la zone de stockage temporaire.

La zone de prévisualisation est spécifiquement destinée à prévisualiser une petite partie des données de la zone de stockage temporaire (ou de la base de données JDBC). Vous pouvez explorer les données disponibles dans la source de données JDBC et vérifiez que vous obtenez les données souhaitées en examinant la zone de stockage temporaire. Vous pouvez également vous en servir pour affiner le filtre d'import des données que vous souhaitez utiliser. (Les filtres définis dans la fonction d'aperçu n'ont aucune incidence sur les données réelles de la zone de stockage temporaire.)

Filtre avancé
inclut les éléments suivants :

Lignes distinctes
: cochez cette case pour masquer les lignes dupliquées.

Nombre maximum de lignes
: limitez le nombre de lignes affichées dans la zone d'aperçu en saisissant un nombre dans la zone de texte.

Colonnes
: cochez ou décochez les colonnes dans ce menu déroulant pour afficher ou masquer les colonnes affichées.

Si vous supprimez une colonne de cette liste, la colonne ne sera pas supprimée de la liste de l'import.

Filtre SQL
: cliquez sur la grande zone de texte pour afficher la boîte de dialogue Modifier le filtre SQL
dans laquelle vous pouvez saisir un filtre SQL pour limiter le nombre de lignes prévisualisées. Cliquez sur Appliquer
pour vérifier automatiquement la syntaxe SQL du filtre. (S'il y a des erreurs, celles-ci sont indiquées dans l'expression.) L'expression que vous avez saisie s'affiche dans le champ Filtre avancé
. Pour obtenir de l'aide sur la syntaxe SQL, cliquez sur l'aide en ligne dans la section Remarques
.

Cliquez sur Supprimer le filtre
(en regard du menu déroulant Source) pour effacer tous les paramètres de filtre avancé.

Dans le cadre du processus de personnalisation de table, vous pouvez également créer des tables de jointure et des colonnes personnalisées en utilisant des expressions SQL.

Importer des données d'une base de données JDBC

Lorsque vous avez configuré et enregistré votre source de données JDBC, vous pouvez importer des données.

Pour importer des données d'une base de données JDBC, procédez comme suit :

Cliquez sur Importer des données
dans le menu Actions
.

Les données sélectionnées sont filtrées par des expressions SQL et chargées dans la zone de stockage temporaire. Vous pouvez prévisualiser les données dans la zone de stockage temporaire.

Les informations restent dans la zone de stockage temporaire jusqu'à ce que vous les effaciez manuellement ou jusqu'à ce qu'un chargement de données ultérieur les efface conformément au mode d'import.

Pour effacer les données de la zone de stockage temporaire, procédez comme suit :

Cliquez sur Effacer les tables temporaires
dans le menu Actions
. La zone de stockage temporaire pour toutes les tables dans la source de données est effacée.

Pour supprimer les caractères indiqués des flux de texte saisi dans des sources de données JDBC :

Reportez-vous à Supprimer les caractères indiqués des flux de texte saisi dans JDBC et Microsoft Dynamics GP.

Associer une source de données JDBC à un autre agent de données Adaptive Planning

Vous pouvez modifier l'agent de données Adaptive Planning que vous associez à votre source de données JDBC.

Vérifiez que l'agent de données auquel vous souhaitez vous connecter apparaît dans la liste

des agents de données

de la Bibliothèque de composants

Accédez à la Source de données JDBC dans Concevoir des intégrations.

Sélectionnez l'agent de données dans le champ

Agent associé

de la section

Paramètres

Schémas exclus des sources de données JDBC

Les sources de données JDBC qui se connectent à Oracle ou à MS SQL Server excluent explicitement certains schémas qui ne sont pas liés à des données financières.

Schémas exclus des sources de données JDBC Oracle

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Schémas exclus des sources de données MS SQL Server JDBC

INFORMATION_SCHEMA, SYS

Conseils de dépannage

Il existe quelques problèmes relatifs aux sources de données que vous pouvez rencontrer et dont les solutions ne sont pas immédiatement évidentes.

Lorsque vous importez la structure d'une base de données et que cette dernière se compose de plus de 1 000 tables, une erreur s'affiche et vous demande de filtrer la liste de tables. Vous pouvez résoudre cette erreur en effectuant l'une des actions suivantes :

Modification de la source de données JDBC et saisie d'un filtre de schéma.

Modification des autorisations associées à l'identifiant de connexion que vous utilisez pour accéder au serveur, pour que moins de tables soient accessibles pour cet identifiant de connexion.

Lorsque vous importez la structure d'une base de données, les schémas suivants ne sont pas importés comme faisant partie de la structure :

CTXSYS, MDSYS, SYSTEM, SYS,

XDB

. Ce sont les schémas de systèmes Oracle qui ne sont pas nécessaires à des fins d'intégration de données.

Lorsque vous importez la structure d'une base de données MS SQL, les schémas suivants ne sont pas importés comme faisant partie de la structure : INFORMATION_SCHEMA et sys. Ce sont les schémas de systèmes MS SQL qui ne sont pas nécessaires à des fins d'intégration de données.