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

Adaptive Planning

Vous pouvez utiliser

Adaptive Planning

Intégration pour extraire des renseignements des bases de données conformes à JDBC. La plupart des bases de données utilisées pour les applications de gestion financière et de 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 aux bases de données sur site. La connexion à des bases de données en nuage avec un agent n'est pas prise en charge.

Source JDBC	Aperçu	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 à partir du site Web d’Oracle ou au moyen du référentiel Maven d’Oracle.	oracle.jdbc.OracleDriver	jdbc:oracle:thin:@example-win-db:1521:ANACONDA	Class OracleDriver
Serveur SQL	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 détails d'emplacement de dll	net.sourceforge.jtds.jdbc.Driver	jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS	formats jTDS
Serveur SQL	Microsoft SQL Server	jsqljdbc41.jar distribué dans le dossier Data Agent Plugins. voir Sécurité intégrée pourSources de données JDBC pour détails d'emplacement de dll	com.microsoft.sqlserver.jdbc.SQLServerDriver	jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;	Création de l’adresse URL de connexion
MySql	Manuels de référence SQL	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 la

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

Pour les versions d’agent de données 7.1.44 et antérieures, utilisez

C:/Program Files/Adaptive Data Agent/Plugins

répertoire sur la machine hébergeant le service Data Agent.

Après avoir ajouté un fichier jar, accédez aux services locaux et redémarrez Data Agent Service.

Avant de pouvoir définir une source de données à partir d’une base de données locale, vous devez créer un agent de données qui dise

Adaptive Planning

Intégration comment communiquer avec la base de données. Pour savoir comment créer des agents de données, voir Créer des agents de données.

Pour définir 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 du côté droit de l’écran, cliquez sur Créer une nouvelle source de données
. La boîte de dialogue Créer s’affiche.

Sélectionnez la base de données JDBC comme type de source de données, entrez 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.

Entrez 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

Agents de données

de la bibliothèque de composantes

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 :
entrez l’adresse URL de la base de données.

Nom d’utilisateur :
entrez le nom d’utilisateur qui sert à accéder à la base de données.

Mot de passe
: entrez le mot de passe associé au nom d’utilisateur.

Filtre de schéma :
entrez le nom du ou des schémas à partir desquels vous souhaitez importer des données. Si vous entrez les noms de plusieurs schémas, entrez les noms de schémas séparés par un point-virgule. Utilisez ce champ pour limiter le nombre de tables à actualiser 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 préciser les détails de journalisation pour 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, la date d mise à jour de la source de données.

Mode détaillé
: fournit de l’information très détaillée sur toutes les phases et actions. (Ce niveau 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.

Dès que 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 s’affichent. Types de colonnes pris en charge, répertorie les types de colonnes pris en charge pour les différents types de bases 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 les colonnes sont affichées dans le menu Composants de données
.

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

Les importations de données JDBC.

Les données de la source JDBC alimentent la table intermédiaire.

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

Vous pouvez également choisir d’ajouter l’information importée, auquel cas les données importées seront ajoutées à la table intermédiaire existante, ou fusionner l’information importée, auquel cas les lignes existantes dans les données JDBC seront fusionnées avec les lignes dans la zone intermédiaire.

Ajouter des tables à une source de données JDBC

Après avoir importé la structure de la base données, vous pouvez préciser les informations que vous souhaitez importer à partir de la base de données. La section Tables à importer
de l’écran vous permet de configurer les données importées à partir de la base de données.

Pour indiquer 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 est affichée 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 s’affiche pour la table et l’information de la base de données est affichée 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 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 située à côté d’une colonne pour l’importer.

Lorsque vous cochez une colonne, celle-ci s’affiche également dans la fenêtre d’aperçu une fois que le contenu contextuel est enregistré. Si vous décochez une colonne, la colonne sera retirée de la fenêtre d’aperçu.

Vous pouvez également changer le statut d’importation pour des colonnes individuelles en procédant comme suit :

Sélectionnez les propriétés de colonne et définissez la propriété.

Glissez-déposez les colonnes dans le concepteur.

Vous ne pouvez pas changer le statut d’importation des champs générés par le système, comme isDeleted
.

Personnaliser les tables

Pour chaque table, vous pouvez personnaliser le mode d’importation 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 table
dans le menu flottant.

Entrez les paramètres de table :

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

Tous les enregistrements sont remplacés à chaque exécution d’une importation de données
il s’agit du paramètre par défaut. Remplace les données de la table intermédiaire par les données importées de la source.

Cache distant utilisé pour identifier et envoyer les enregistrements modifiés lors de l’importation
: seuls les enregistrements de la base de données qui ont été changés ou qui sont nouveaux sont importés. Les enregistrements modifiés écrasent les enregistrements existants dans la zone intermédiaire. De nouveaux enregistrements sont ajoutés à la fin de l’information dans la zone intermédiaire.

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 intermédiaire correspondant aux périodes importées sont supprimés avant l’importation des données les plus récentes de la source.

Filtre d’importation des données :
utilisez cette option pour entrer une expression SQL qui filtre ou formate l’information en cours d’importation. 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 intermédiaire. Cliquez sur le champ pour afficher la boîte de dialogue Modifier le filtre SQL
(le filtre que vous entrez ici est appliqué aux données réelles de la base de données plutôt qu’aux données d’aperçu dans la zone intermédiaire). Certains types de source de données ne prennent pas 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 intermédiaire. Vous pouvez réviser 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 de colonne

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 intermédiaire après leur importation. Vous pouvez changer 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. Les 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 colonne
: cette boîte de dialogue permet de changer les propriétés de la colonne dans la table intermédiaire.

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’importation
: 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 intermédiaire

Vous pouvez télécharger des données à partir d’une seule table intermédiaire.

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

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

Sélectionnez Télécharger les données
.

Lorsque l’on vous y invite, cliquez sur Envoyer
. Cette opération envoie un courriel contenant une adresse URL pour télécharger les données
.

Adaptive Planning

L’intégration envoie un courriel contenant une adresse URL au compte de courriel associé au concepteur de données.

Ouvrez le courriel et cliquez sur l’adresse 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 d’aperçu Tables à importer
. Le filtre avancé
fournit des outils pour afficher et parcourir un sous-ensemble de données dans une table intermédiaire ou directement depuis la source distante (si vous avez sélectionné Base de données JDBC dans le menu déroulant Source). En changeant les propriétés de filtre, vous pouvez modifier la vue des données affichées dans la fenêtre d’aperçu sans changer les données dans la zone intermédiaire.

La zone d’aperçu sert expressément à offrir un aperçu d’une petite partie des données de la zone intermédiaire (ou de la base de données JDBC). Vous pouvez explorer les données disponibles dans la source de données JDBC et vérifier que vous obtenez les données souhaitées en examinant la zone intermédiaire. Vous pouvez également vous en servir pour affiner le filtre d’importation 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 intermédiaire.)

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 entrant un nombre dans la zone de texte.

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

Même si vous retirez une colonne de cette liste, la colonne ne sera pas retirée de la liste de l’importation.

Filtre SQL
: cliquez sur la grande zone de texte pour afficher la boîte de dialogue Modifier le filtre SQL
dans laquelle vous pouvez entrer un filtre SQL pour limiter le nombre de lignes dans l’aperçu. 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 entrée s’affiche dans le champ Filtre avancé
. Pour obtenir une aide détaillée sur la syntaxe SQL, vous pouvez cliquer 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 intermédiaire. Vous pouvez afficher un aperçu des données dans la zone intermédiaire.

Les informations restent dans la zone intermédiaire 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’importation.

Pour effacer les données de la zone intermédiaire, procédez comme suit :

Cliquez sur Effacer les tables intermédiaires
dans le menu Actions
. La zone intermédiaire est effacée pour toutes les tables dans la source de données.

Pour supprimer les caractères indiqués des flux de texte d’entrée dans des sources de données JDBC :

Consultez Retirer des caractères précisés des flux de texte d’entrée dans JDBC et Microsoft Dynamics GP

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

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

Assurez-vous que l'agent de données auquel vous souhaitez vous connecter est répertorié dans

Agents de données

de la bibliothèque de composantes

Accédez à Source de données JDBC dans Concevoir 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, un message d’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 :

Modifier la source de données JDBC et entrer d’un filtre de schéma.

Changer les autorisations associées à l’identifiant de connexion que vous utilisez pour accéder au serveur afin que moins de tables soient accessibles pour cet identifiant de connexion.

Lorsque vous importez la structure d’une base de données Oracle, les schémas suivants ne sont pas importés en tant que partie intégrante 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 en tant que 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.