SAP JavaBean Manuel utilisateur

Guide d'accès aux données
BusinessObjects XI 3.1 Service Pack 2
Copyright
© 2009 SAP® BusinessObjects™. Tous droits réservés. SAP BusinessObjects et
ses logos, BusinessObjects, Crystal Reports®, SAP BusinessObjects Rapid Mart™,
SAP BusinessObjects Data Insight™, SAP BusinessObjects Desktop Intelligence™,
SAP BusinessObjects Rapid Marts®, SAP BusinessObjects Watchlist Security™,
SAP BusinessObjects Web Intelligence® et Xcelsius® sont des marques ou
marques déposées de Business Objects, une société du groupe SAP, et/ou de
ses sociétés affiliées aux Etats-Unis et/ou dans d'autres pays. SAP® est une
marque déposée de SAP AG en Allemagne et/ou dans d'autres pays. Tous les
autres noms mentionnés peuvent être des marques de leurs propriétaires respectifs.
2009-05-27
Table des matières
Chapitre 1
Présentation de l'accès aux données
11
A propos de Connection Server................................................................12
Composants d'une connexion...................................................................12
A propos de l'architecture système......................................................13
A propos des pilotes d'accès aux données..........................................13
A propos des fichiers de configuration d'accès aux données....................14
A propos du fichier de configuration globale cs.cfg..............................15
A propos des fichiers de configuration de pilote *.sbo.........................15
Chapitre 2
Création d'une connexion
19
Conditions requises pour la connexion......................................................20
Vérification de la configuration de la connexion........................................20
Affichage de l'aide sur l'outil cscheck...................................................21
Pour exécuter l'outil cscheck................................................................22
Outil de vérification : présentation des fonctions..................................23
Outil de vérification : list.......................................................................24
Outil de vérification : driverssearch......................................................25
Outil de vérification : find......................................................................26
Outil de vérification : middleware.........................................................28
Outil de vérification : accessdriver........................................................30
Outil de vérification : connectivity.........................................................31
Outil de vérification : ping ....................................................................33
A propos des connexions JDBC ...............................................................36
Pour créer une connexion JDBC ..............................................................37
Exemple de structure de fichiers SBO JDBC.......................................38
Pour créer une connexion Generic JDBC.................................................38
Guide d'accès aux données
3
Table des matières
Exemple de structure de fichiers SBO Generic JDBC.........................40
A propos des connexions JavaBean.........................................................40
Pour créer une connexion JavaBean........................................................41
Exemple de structure de fichiers SBO JavaBean ...............................42
A propos des connexions ODBC ..............................................................42
Pour créer une connexion Generic ODBC................................................43
Pour créer une connexion Generic ODBC3..............................................45
Chapitre 3
Création d'une connexion au serveur de requêtes Data Federator
47
A propos des connexions au serveur de requêtes Data Federator...........48
Configuration de l'Assistant de création de connexion pour une
connexion JDBC ou ODBC Data Federator..............................................49
Configuration des connexions JDBC Data Federator................................50
Configuration de Connection Server pour une connexion JDBC
Data Federator.....................................................................................51
Configuration des connexions ODBC Data Federator...............................51
Configuration du middleware ODBC Data Federator ..........................52
Configuration de Connection Server pour une connexion ODBC
Data Federator.....................................................................................53
Configuration de définitions de connexion Web Intelligence Rich Client à
l'aide du middleware ODBC Data Federator.............................................54
Configuration du middleware ODBC Data Federator pour une connexion
Web Intelligence Rich Client ...............................................................55
Configuration de Connection Server pour une connexion Web Intelligence
Rich Client à Data Federator................................................................56
Définition de la clé de registre Web Intelligence Rich Client ...............56
Configuration de Connection Server pour des connexions
Web Intelligence Rich Client et Universe Designer à Data Federator..57
Chapitre 4
Configuration des paramètres globaux d'accès aux données
59
A propos des paramètres globaux.............................................................60
A propos du fichier de configuration cs.cfg................................................60
4
Guide d'accès aux données
Table des matières
Pour afficher et modifier le fichier cs.cfg....................................................61
Configuration des paramètres de pilote par défaut...................................61
Configuration des paramètres globaux......................................................62
Charset List Extension.........................................................................63
Config File Extension...........................................................................63
Description Extension...........................................................................64
Enable Failed Load..............................................................................64
Load Drivers On Startup.......................................................................65
Max Pool Time......................................................................................65
SQL External Extension.......................................................................67
SQL Parameter Extension....................................................................67
Strategies Extension............................................................................68
Configuration de la méthode d'accès........................................................68
Configuration du filtre de pilote..................................................................69
Définition d'une connectivité par ordinateur.........................................71
Configuration des protocoles d'accès CORBA..........................................73
Chapitre 5
Configuration des paramètres du pilote d'accès aux données
75
Configuration des paramètres du pilote.....................................................76
Fichiers de configuration d'accès aux données...................................76
Fichiers SBO installés..........................................................................77
Pour afficher et modifier un fichier SBO...............................................79
Configuration de l'accès aux données pour les pilotes ODBC DataDirect.80
Pour activer l'utilisation de pilotes de marque DataDirect....................80
Chapitre 6
Paramètres SBO – Informations de référence
83
Catégories de paramètres SBO................................................................84
Structure du fichier SBO............................................................................84
Paramètres SBO par défaut......................................................................87
Array Bind Available.............................................................................87
Guide d'accès aux données
5
Table des matières
Array Bind Size.....................................................................................87
Array Fetch disponible..........................................................................88
Array Fetch Size...................................................................................88
Taille maximale du nom de catalogue..................................................89
Séparateur de catalogue......................................................................90
Jeu de caractères.................................................................................90
Taille maximale du nom de colonne.....................................................91
Connexion partageable........................................................................91
Coût estimé disponible.........................................................................92
Description File.....................................................................................92
Capacités du pilote...............................................................................93
Caractère d'échappement....................................................................93
Extensions............................................................................................94
Family...................................................................................................94
Facteur de taille de champ...................................................................95
Forcer l'exécution.................................................................................95
Casse de l'identificateur.......................................................................96
Chaîne de signal des identificateurs....................................................96
Clause d'échappement LIKE................................................................97
Paramètres régionaux..........................................................................97
Nombre maximal de lignes disponibles................................................98
Optimize Execute.................................................................................98
Propriétaires disponibles......................................................................99
Cryptage du mot de passe.................................................................100
Taille maximale du nom de procédure...............................................100
Taille maximale du nom de paramètre de procédure.........................101
Qualificateurs disponibles..................................................................101
Expiration de la requête disponible....................................................102
Casse d'identificateur entre guillemets...............................................102
Taille maximale du nom de schéma...................................................103
Connexion partagée...........................................................................104
6
Guide d'accès aux données
Table des matières
Fichier SQL externe...........................................................................104
SQL Parameter File............................................................................105
Connexion unique disponible.............................................................107
Strategies File....................................................................................107
Taille maximale du nom de table........................................................108
Mode de transaction disponible.........................................................108
Mode de transaction...........................................................................109
Type....................................................................................................110
Version...............................................................................................110
Taille maximale des données XML.....................................................110
Paramètres SBO d'Informix.....................................................................111
Pour modifier le fichier ODBC.INI Informix.........................................111
V5toV6DriverName............................................................................112
Unicode..............................................................................................112
Paramètres SBO JavaBean.....................................................................113
Classe JavaBean...............................................................................113
Format d'URL.....................................................................................114
Paramètres SBO JDBC...........................................................................115
Clés étrangères disponibles...............................................................115
Classe JDBC......................................................................................115
Clés primaires disponibles.................................................................116
Paramètres SBO ODBC..........................................................................116
Statut de connexion disponible..........................................................117
Chaîne vide........................................................................................117
Forcer la fermeture de l'instruction.....................................................118
Native Int64 Available.........................................................................118
ODBC Cursors...................................................................................119
SQLDescribeParam disponible..........................................................119
SQLMoreResults disponible...............................................................120
Utilisation du pilote OEM DataDirect .................................................120
Paramètres SBO OLE DB.......................................................................121
Guide d'accès aux données
7
Table des matières
Enumerator CLSID.............................................................................121
Provider CLSID..................................................................................121
Paramètres SBO OLE DB OLAP.............................................................122
MSOlap CLSID...................................................................................122
Sybase ASE/CTLIB.................................................................................122
Identificateur entre guillemets............................................................122
Chapitre 7
Configuration des paramètres de génération SQL
125
A propos des paramètres de génération SQL.........................................126
A propos des fichiers PRM......................................................................126
Structure du fichier de paramètres PRM............................................129
Pour afficher et modifier un fichier PRM..................................................131
Pour afficher et modifier un fichier texte d'aide sur les fonctions.............131
Pour modifier le texte d'aide d'une fonction PRM....................................132
Chapitre 8
Paramètres PRM – Informations de référence
133
Informations de référence pour la configuration des fichiers PRM..........134
BACK_QUOTE_SUPPORTED..........................................................134
CASE_SENSITIVE.............................................................................135
CHECK_OWNER_STATE..................................................................135
CHECK_QUALIFIER_STATE.............................................................136
COMMA..............................................................................................137
CONCAT............................................................................................137
CONSTANT_SAMPLING_SUPPORTED...........................................138
DATABASE_DATE_FORMAT............................................................138
DATATYPE_BLOB..............................................................................139
DATATYPE_DOUBLE........................................................................139
DATATYPE_DTM...............................................................................139
DATATYPE_INT.................................................................................140
DATATYPE_NULL..............................................................................140
8
Guide d'accès aux données
Table des matières
DATATYPE_STRING .........................................................................140
DATE_WITHOUT_QUOTE ...............................................................141
DELIMIT_IDENTIFIERS.....................................................................141
EXT_JOIN..........................................................................................142
EXT_JOIN_INVERT...........................................................................143
EXTERN_SORT_EXCLUDE_DISTINCT...........................................143
GROUPBY_EXCLUDE_COMPLEX...................................................144
GROUPBY_WITH_ALIAS..................................................................145
GROUPBY_WITHOUT_CONSTANT.................................................145
GROUPBYCOL..................................................................................146
IDENTIFIER_DELIMITER..................................................................146
IF_NULL.............................................................................................147
INTERSECT.......................................................................................148
KEY_INFO_SUPPORTED.................................................................148
LEFT_OUTER....................................................................................149
LENMAXFORCOLUMNNAME...........................................................150
LENMAXFORTABLENAME...............................................................150
LENMAXFORVARCHAR....................................................................150
MINUS................................................................................................151
NO_DISTINCT...................................................................................151
NULL_IN_SELECT_SUPPORTED....................................................152
OLAP_CLAUSE.................................................................................153
OUTERJOINS_GENERATION...........................................................153
OVER_CLAUSE.................................................................................157
OWNER..............................................................................................158
PERCENT_RANK_SUPPORTED......................................................158
PREFIX_SYS_TABLE........................................................................159
QUALIFIER........................................................................................159
QUOTE_OWNER...............................................................................160
RANK_SUPPORTED.........................................................................161
REFRESH_COLUMNS_TYPE...........................................................161
Guide d'accès aux données
9
Table des matières
REVERSE_TABLE_WEIGHT.............................................................162
RIGHT_OUTER..................................................................................162
RISQL_FUNCTIONS..........................................................................163
SEED_SAMPLING_SUPPORTED.....................................................164
SORT_BY_NO...................................................................................164
UNICODE_PATTERN........................................................................165
UNION................................................................................................166
USER_INPUT_DATE_FORMAT........................................................166
USER_INPUT_NUMERIC_SEPARATOR..........................................167
Chapitre 9
Conversion de données – Informations de référence
169
Conversion de données ..........................................................................170
IBM DB2.............................................................................................170
Informix...............................................................................................172
Microsoft SQL Server.........................................................................173
Oracle.................................................................................................174
Red Brick............................................................................................175
Pour ajouter une prise en charge de TIME et de TIMESTAMP dans une
clause WHERE...................................................................................176
Sybase...............................................................................................177
Teradata.............................................................................................178
Annexe A
Informations supplémentaires
Index
10
Guide d'accès aux données
181
185
Présentation de l'accès aux
données
1
1
Présentation de l'accès aux données
A propos de Connection Server
A propos de Connection Server
Connection Server est un logiciel d'accès aux données qui gère la connexion
entre l'application BusinessObjects et la source de données.
Connection Server permet à des applications telles que Universe Designer
et Web Intelligence de se connecter à une source de données et d'exécuter
des requêtes.
Connection Server ne dispose pas d'une interface utilisateur. Vous créez et
administrez des connexions à partir de l'interface utilisateur de ces
applications ou en modifiant les fichiers de configuration Connection Server.
•
Création de connexions : vous utilisez l'Assistant de création de connexion
pour créer des connexions.
•
Optimisation de l'accès aux données : vous pouvez optimiser la
transmission des données via Connection Server en modifiant les fichiers
de configuration d'accès aux données. Il s'agit de fichiers au format XML
installés avec Connection Server. Vous pouvez définir les valeurs de
paramètres pour qu'elles s'appliquent à un pilote d'accès aux données
spécifique ou à tous les pilotes installés.
Composants d'une connexion
Une connexion d'accès aux données intègre les composants suivants :
• Connection Server est le logiciel qui gère la connexion entre l'application
et la source de données. Par exemple, Connection Server traite les
requêtes de données provenant de l'application.
12
•
Un pilote d'accès aux données est un composant logiciel spécifique à la
base de données qui gère la connexion entre Connection Server et le
middleware de base de données.
•
Les fichiers de configuration définissent les paramètres de configuration
de la connexion entre les éléments suivants :
• l'application et Connection Server
•
l'application et le pilote d'accès aux données
•
Connection Server et le pilote d'accès aux données
Guide d'accès aux données
Présentation de l'accès aux données
Composants d'une connexion
A propos de l'architecture système
Le diagramme ci-dessous décrit comment Connection Server et les pilotes
d'accès aux données s'intègrent dans une configuration Business Objects.
A propos des pilotes d'accès aux données
Les pilotes d'accès aux données établissent la connexion entre
Connection Server et la source de données. Pour pouvoir être accessible
depuis une application Business Objects, une base de données doit être
reliée à un pilote d'accès aux données.
Les applications Business Objects incluent les pilotes d'accès aux données
permettant de configurer les connexions à vos bases de données. Les pilotes
fournis dépendent du type de licence dont vous disposez.
Guide d'accès aux données
13
1
1
Présentation de l'accès aux données
A propos des fichiers de configuration d'accès aux données
Avant de pouvoir créer une connexion à une base de données pour laquelle
vous ne disposez pas de pilote, vous devez vous procurer les pilotes requis.
Pour cela, les options suivantes s'offrent à vous :
•
Contacter votre représentant Business Objects pour déterminer si un
pilote est disponible et si votre licence vous autorise à l'utiliser.
•
Utiliser le kit de développement de pilote (Driver Development Kit, DDK)
pour mettre au point un pilote à utiliser. Contactez votre représentant
Business Objects pour obtenir de plus amples renseignements.
Lorsque vous créez une connexion, vous sélectionnez le pilote d'accès aux
données correspondant à la source de données cible. Par exemple, si vous
accédez à une base de données Oracle 10g, vous devez installer le
middleware approprié (client Oracle 10g), puis le pilote d'accès aux données
Oracle de BusinessObjects.
Pour obtenir la liste la plus récente des pilotes d'accès aux données pris en
charge, visitez le site SAP Service MarketPlace à l'adresse http://ser
vice.sap.com/bosap-support ou contactez votre représentant
Business Objects.
Pour en savoir plus sur le DDK, voir le Data Access Driver Java SDK
Developer Guide (Guide de développement du pilote d'accès aux données
Java SDK) à l'adresse http://boc.sdn.sap.com.
A propos des fichiers de configuration
d'accès aux données
Les fichiers de configuration de l'accès aux données sont installés avec
BusinessObjects Enterprise. Les fichiers de configuration peuvent être divisés
en deux niveaux :
•
Niveau global : le fichier de configuration cs.cfg s'applique à toutes les
connexions.
•
Niveau du pilote : chaque pilote spécifique a un fichier de configuration
*.sbo correspondant.
Outre les fichiers de configuration qui contrôlent la connexion, chaque pilote
d'accès aux données est doté d'un fichier de configuration .prm
correspondant. Ces fichiers sont utilisés par des applications telles que
14
Guide d'accès aux données
Présentation de l'accès aux données
A propos des fichiers de configuration d'accès aux données
Universe Designer. Les fichiers .prm contrôlent la façon dont une application
génère le SQL en fonction des capacités logicielles de la base de données.
Remarque :
Dans ce guide, la variable connectionserver-install-dir correspond
au chemin d'installation racine pour les fichiers d'accès aux données utilisés
par les applications BusinessObjects. Sous Microsoft Windows, le répertoire
par défaut de connectionserver-install-dir est : C:\Program
Files\Business Objects\BusinessObjects Enterprise
12.0\win32_x86\dataAccess.
Attention :
Dans les fichiers de configuration de l'accès aux données, utilisez le caractère
d'échappement \ avec la barre oblique inverse\ dans les chemins de fichiers,
si vous déployez le logiciel BusinessObjects Enterprise sur une plateforme
Microsoft Windows.
A propos du fichier de configuration globale cs.cfg
Les fichiers de configuration globaux cs.cfg utilisés par les pilotes d'accès
aux données sont installés à l'emplacement suivant :
• connectionserver-install-dir \connectionServer
Le fichier cs.cfg contient des paramètres qui s'appliquent à tous les pilotes
d'accès aux données installés.
Rubriques associées
•
A propos des paramètres globaux page 60
A propos des fichiers de configuration de pilote *.sbo
Les fichiers de configuration utilisés par les pilotes d'accès aux données
sont installés à l'emplacement suivant :
• Sous Windows :
connectionserver-install-dir \connectionServer\SGBDR
•
Sous Unix :
Guide d'accès aux données
15
1
1
Présentation de l'accès aux données
A propos des fichiers de configuration d'accès aux données
connectionserver-install-dir /SGBDR/connectionServer
où SGBDR est le nom de la technologie de base de données qui utilise le
fichier de configuration.
Les paramètres des fichiers ci-dessous s'appliquent aux pilotes d'accès aux
données qui sont installés.
Fichier propre
au pilote
<pilote>.sbo
<pilote>.prm
16
Guide d'accès aux données
Modifiable ?
Description
Exemple
Oui
Il existe un fichier
.sbo pour chaque
protocole réseau
pris en charge ou
middleware de
base de données
utilisé pour la cooracle.sbo
nnexion à une
base de données.
Définit la configuration de la connectivité spécifique
pour chaque
base de données.
Oui
Définit les paramètres qui déterminent le mode
oracle.prm
de génération
SQL d'une application.
Présentation de l'accès aux données
A propos des fichiers de configuration d'accès aux données
Fichier propre
au pilote
<pilote><la
ngue>.cod
Modifiable ?
Non
Description
Exemple
Stocke des informations relatives
aux définitions
des connexions.
Définit les champs affichés lors
oracleen.cod
de la création
d'une nouvelle
connexion.
Remarque :
Ne modifiez pas
ces fichiers.
Rubriques associées
•
•
•
Catégories de paramètres SBO page 84
Informations de référence pour la configuration des fichiers PRM page 134
A propos des paramètres de génération SQL page 126
Guide d'accès aux données
17
1
1
Présentation de l'accès aux données
A propos des fichiers de configuration d'accès aux données
18
Guide d'accès aux données
Création d'une connexion
2
2
Création d'une connexion
Conditions requises pour la connexion
Conditions requises pour la connexion
Cette section décrit les conditions requises pour créer une connexion.
•
Vérifiez que la plateforme est prise en charge par les connexions
Business Objects.
•
Vérifiez que le middleware de la base de données est correctement
installé pour pouvoir accéder à la base de données via un ordinateur ou
un serveur.
•
Vérifiez que vous disposez de toutes les informations nécessaires pour
accéder à votre base de données (mot de passe et nom de connexion à
la base de données par exemple).
•
Installez la solution Business Objects que vous allez utiliser et le pilote
d'accès aux données approprié.
•
Vérifiez que tous les services ont démarré correctement.
•
Consultez le fichier Readme fourni avec la solution Business Objects
pour connaître les modifications d'environnement et de logiciel
éventuellement requises.
•
Voir les notes de version de l'accès aux données pour savoir si des
modifications qui peuvent modifier votre environnement ont été apportées
à la configuration.
Remarque :
Vous pouvez utiliser l'outil cscheck pour vérifier votre infrastructure et
déterminer si elle peut être utilisée avec des applications Business Objects.
Rubriques associées
•
Vérification de la configuration de la connexion page 20
Vérification de la configuration de la
connexion
Le logiciel Connection Server inclut un utilitaire de ligne de commande que
vous pouvez utiliser pour vérifier l'infrastructure de la connexion à la source
de données. L'outil cscheck permet de vérifier à tout moment le middleware
client et les pilotes d'accès aux données installés.
20
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Remarque :
Les résultats de toutes les vérifications concernent l'ordinateur local à partir
duquel vous exécutez l'outil.
L'outil cscheck est installé dans le répertoire suivant : connectionserverinstall-dir\connectionServer\tools.
cscheck s'exécute à partir d'une console de commandes (DOS ou shell).
La sortie est affichée à l'écran. Vous pouvez choisir de générer la sortie au
format XML ou de supprimer la sortie afin d'utiliser l'outil dans un script.
L'outil cscheck vous permet d'effectuer les fonctions suivantes sur l'ordinateur
local :
• renvoyer les détails de toutes les connectivités (couches réseau et bases
de données) que l'installation prend en charge
•
renvoyer les détails des pilotes d'accès aux données installés sur
l'ordinateur local
•
renvoyer les détails des connectivités installées sur l'ordinateur local
•
vérifier la validité d'une installation de middleware pour une couche réseau
et un client de base de données fournis
•
vérifier la validité d'une installation de pilote d'accès aux données pour
une couche réseau et un client de base de données fournis
•
vérifier si une connexion à une base de données spécifique peut être
établie
Rubriques associées
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck
L'outil cscheck propose des fonctionnalités pour :
•
afficher l'aide générale sur l'outil cscheck
•
afficher l'aide relative à chaque fonction cscheck disponible
L'aide est disponible dans la langue sélectionnée lors de l'installation de la
solution Business Objects.
Guide d'accès aux données
21
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Pour afficher l'aide générale de l'outil cscheck, utilisez la syntaxe suivante :
Figure 2-1 : Syntaxe d'aide des commandes
cscheck
--help|h --language|l { langue }
Pour afficher l'aide d'une fonction, utilisez la syntaxe suivante où NomFonction
correspond au nom de la fonction pour laquelle vous voulez afficher l'aide
et langue correspond à la langue d'affichage de l'aide :
Figure 2-2 : Syntaxe d'aide des fonctions
cscheck
--help|h { NomFonction }--language|l{ langue }
Exemple :
Pour afficher l'aide de l'outil cscheck en anglais, utilisez la commande
suivante :
cscheck --help
Pour afficher l'aide de la fonction connectivity en français, utilisez la
commande suivante :
cscheck --language fr --help connectivity
Pour exécuter l'outil cscheck
Vous pouvez exécuter l'outil cscheck à tout moment après avoir installé la
solution Business Objects.
1. Ouvrez une console de commandes.
2. Modifiez le répertoire en fonction du chemin d'installation de l'outil.
3. Entrez cscheck avec les paramètres corrects afin de trouver les
informations souhaitées.
4. Vérifiez les informations renvoyées.
Rubriques associées
•
22
Outil de vérification : présentation des fonctions page 23
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Outil de vérification : présentation des fonctions
A partir d'une console de commandes, utilisez la commande cscheck avec
la fonction appropriée et ses arguments pour renvoyer les résultats qui vous
intéressent.
Les commandes cscheck possèdent la structure suivante. Certains
paramètres sont facultatifs.
Figure 2-3 : syntaxe cscheck
cscheck --language|l { langue de sortie }--xml|x--mute|m nom de la
fonctionoptions de la fonction
La première partie de la commande contrôle le format de sortie :
• <langue de sortie> ou l suivi de la langue spécifiée dans la norme
ISO-639. Cette option est facultative. La langue par défaut est l'anglais.
•
--xml ou x indique que la sortie est au format XML. Cette option est
facultative. La sortie par défaut affiche du texte à l'écran.
•
--mute indique que la sortie n'est pas générée. Cette option est utile si
vous vous servez de l'outil dans un script qui vérifie le statut renvoyé.
Cette option est facultative. La sortie est générée par défaut.
La partie restante de la commande est composée de la fonction et des
arguments de l'option.
<nom de la fonction> peut prendre les valeurs suivantes. Chaque fonction
dispose d'une version abrégée pouvant être utilisée à la place du nom
complet :
• list ou lt
•
driverssearch ou ds
•
find ou fd
•
middleware ou mw
•
accessdriver ou ad
•
connectivity ou ct
•
ping ou pg
Guide d'accès aux données
23
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Rubriques associées
•
•
•
•
•
•
•
Outil de vérification : accessdriver page 30
Outil de vérification : connectivity page 31
Outil de vérification : driverssearch page 25
Outil de vérification : find page 26
Outil de vérification : list page 24
Outil de vérification : middleware page 28
Outil de vérification : ping page 33
Outil de vérification : list
Cette fonction renvoie la liste des couches réseau et des moteurs de base
de données pris en charge. Par exemple, vous pouvez l'utiliser pour
déterminer les valeurs correctes à utiliser avec les autres fonctions de l'outil
de vérification.
Remarque :
Cette fonction renvoie la liste complète des pilotes d'accès aux données et
du middleware pris en charge, y compris ceux qui ne sont pas
nécessairement installés sur votre ordinateur.
Figure 2-4 : syntaxe de la fonction list
cscheck |list||lt|
Exemple :
La commande suivante répertorie toutes les couches réseau et tous les
moteurs de base de données pris en charge par la solution Business Objects
installée sur l'ordinateur actif.
cscheck list
Vous trouverez ci-dessous un extrait de la liste des résultats.
Oracle Client
Oracle 9
Oracle 10
Oracle 11
Sybase Open Client
Sybase Adaptive Server 12
Sybase Adaptive Server 15
Informix ODBC Driver
24
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Informix XPS 8.4
Informix XPS 8.5
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
Teradata ODBC Driver
Teradata V2 R5
Teradata V2 R6
Teradata 12
ODBC Drivers
Generic ODBC Datasource
Generic ODBC3 Datasource
...
Rubriques associées
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : driverssearch
Cette fonction renvoie la liste des pilotes d'accès aux données installés.
Figure 2-5 : syntaxe de la fonction driverssearch
cscheck |driverssearch||ds|
Exemple :
La commande suivante répertorie tous les pilotes d'accès aux données
installés sur l'ordinateur.
cscheck driverssearch
Vous trouverez ci-dessous un extrait de la liste des résultats.
This access driver is installed: Oracle OCI access driver
Client layer: Oracle Client
Database engine(s):
Oracle 9
Oracle 10
Oracle 11
This access driver is installed: Sybase Open Client access
driver
Client layer: Sybase Open Client
Guide d'accès aux données
25
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Database engine(s):
Sybase Adaptive Server 12
Sybase Adaptive Server 15
This access driver is installed: Informix ODBC access driver
Client layer: Informix ODBC Driver
Database engine(s):
Informix XPS 8.4
Informix XPS 8.5
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
This access driver is installed: Teradata ODBC access driver
Client layer: Teradata ODBC Driver
Database engine(s):
Teradata V2 R5
Teradata V2 R6
Teradata 12
...
Rubriques associées
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : find
Cette fonction dresse la liste des types de connectivité disponibles
(middleware et clients de base de données) disponibles à partir de l'ordinateur
local. Cette opération inclut les étapes suivantes :
• types de connectivité disponibles sur l'ordinateur local
•
types de connectivité disponibles à l'aide de la couche de communication
CORBA
•
types de connectivité disponibles à l'aide de la couche de communication
HTTP
•
Les types de connectivité Java disponibles sur l'ordinateur local
Figure 2-6 : syntaxe de la fonction find
cscheck |find||fd| -m { mode d'accès à Connection Server }
26
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Tableau 2-1 : Paramètres d'entrée de la fonction
Mode permettant à l'application client
d'accéder à Connection Server :
• local : répertorie les types de connectivité disponibles sur l'ordinateur local.
Mode d'accès à Connection Server
(-m)
•
corba : répertorie les types de
connectivité disponibles à l'aide
de CORBA.
•
http : répertorie les types de connectivité disponibles à l'aide
d'HTTP.
•
java : répertorie les types de connectivité disponibles sur l'ordinateur local.
•
extended : répertorie les types de
connectivité local, java et corba.
Exemple : Recherche des connectivités locales
La commande suivante renvoie la liste des pilotes d'accès aux données
présents sur l'ordinateur local pouvant être chargés par Connection Server.
cscheck find –m local
Vous trouverez ci-dessous un extrait de la liste des résultats.
Local Library Mode
IBM DB2 Client
DB2 v9
DB2 UDB v8
DB2 UDB for z/OS v8
DB2 UDB for OS/390 v7
DB2 UDB for iSeries v5
Essbase Provider
Hyperion Essbase 7.0
Hyperion Essbase 9
Guide d'accès aux données
27
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Informix ODBC Driver
Informix Dynamic Server 7.3
Informix Dynamic Server 2000
Informix Dynamic Server 10
Informix Dynamic Server 11
Informix XPS 8.4
Informix XPS 8.5
ODBC Drivers
Generic ODBC datasource
Generic ODBC3 datasource
MS SQL Server 7.x
MS SQL Server 2000
MS SQL Server 2005
Sybase ASIQ 12
Sybase SQL Anywhere 10
...
Exemple : Recherche des connectivités du serveur CORBA
La commande suivante renvoie la liste des pilotes d'accès aux données
disponibles à partir d'un serveur CORBA.
cscheck find –m corba
Rubriques associées
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : middleware
Cette fonction vérifie la validité de l'installation du middleware client pour la
couche réseau et le client de base de données fournis. Pour vérifier à la fois
le middleware et le pilote d'accès aux données pour une couche réseau et
un client de base de données fournis, vous pouvez utiliser la fonction conne
ctivity.
Figure 2-7 : syntaxe de la fonction middleware
cscheck |middleware||mw|-c { couche réseau }-d{ client de base de
données }
28
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Tableau 2-2 : Paramètres d'entrée de la fonction
couche réseau (-c)
Couche réseau utilisée par le middleware de la base de données, telle
qu'elle est renvoyée par la fonction
find.
client de base de données (-d)
Base de données à vérifier, telle
qu'elle est renvoyée par la fonction
find.
Exemple :
La commande suivante vérifie la validité de l'installation du middleware du
client Oracle 9 sur l'ordinateur local. Elle crée le fichier de sortie suivant au
format XML : c:\result.xml.
cscheck --xml middleware -c "Client Oracle" -d "Oracle 9" >
c:\result.xml
Si le middleware n'est pas correctement installé, le résultat généré est le
suivant :
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
Rubriques associées
•
•
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : connectivity page 31
Outil de vérification : accessdriver page 30
Guide d'accès aux données
29
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Outil de vérification : accessdriver
Cette fonction vérifie la validité de l'installation du pilote d'accès aux données
pour la couche réseau et le client de base de données fournis. Pour vérifier
à la fois le middleware et le pilote d'accès aux données pour une couche
réseau et un client de base de données fournis, vous pouvez utiliser la
fonction connectivity.
Figure 2-8 : syntaxe de la fonction accessdriver
cscheck |accessdriver||ad|-c{ couche réseau }-d{ client de base de
données }
Tableau 2-3 : Paramètres d'entrée de la fonction
couche réseau (-c )
Couche réseau utilisée par le middleware de la base de données, telle
qu'elle est renvoyée par la fonction
find.
client de base de données (-d)
Base de données à vérifier, telle
qu'elle est renvoyée par la fonction
find.
Exemple :
La commande suivante vérifie la validité de l'installation d'un pilote d'accès
aux données Oracle 9 et affiche la sortie en français :
cscheck -l fr accessdriver -c "Client Oracle" -d "Oracle 9"
Si la langue française n'est pas installée, le résultat généré est le suivant :
The language specified is not installed. Please use an instal
led language. English ([en]).
30
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
Exemple :
La commande suivante vérifie la validité de l'installation d'un pilote d'accès
aux données Oracle 9.
cscheck ad -c "Oracle Client" -d "Oracle 9"
Le résultat généré est le suivant :
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI...
success.
Directory... success.
/connectionserver-install-dir/connectionServer//oracle...
success.
Library... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci9.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionSer
ver//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Rubriques associées
•
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : list page 24
Outil de vérification : connectivity
Cette fonction vérifie que le middleware et le pilote d'accès aux données
installés sont valides pour la couche réseau et le client de base de données
fournis.
Guide d'accès aux données
31
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Vous pouvez les vérifier manuellement à l'aide des fonctions middleware
et accessdriver. Vous pouvez utiliser la fonction ping pour savoir si vous
pouvez établir une connexion à une base de données spécifique.
Figure 2-9 : syntaxe de la fonction connectivity
cscheck |connectivity||ct|-c{ couche réseau }-d{ client de base de
données }
Tableau 2-4 : Paramètres d'entrée de la fonction
couche réseau (-c)
Couche réseau utilisée par le middleware de la base de données, telle
qu'elle est renvoyée par la fonction
find.
client de base de données (-d)
Base de données à vérifier, telle
qu'elle est renvoyée par la fonction
find.
Exemple :
La commande suivante vérifie le middleware du client Oracle installé et le
pilote d'accès aux données Oracle 9. La commande écrit la sortie dans le
fichier texte c:\result.txt.
cscheck -l en connectivity -c "Oracle Client" -d "Oracle
9">c:\result.txt
Si le middleware n'est pas correctement installé, le résultat généré est le
suivant :
Starting to check the middleware component installation...
Begin AND operator...
ORACLE_HOME... The environment setting does not exist.
End AND operator: failure.
The middleware is not correctly installed.
Starting to check the access driver component installation...
Begin AND operator...
Config Directory... success.
32
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
%SharedRoot%\ConnectionServer\Network Layers\Oracle OCI...
success.
Directory... success.
/connectionserver-install-dir/connectionServer//oracle...
success.
Library... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci9.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci10.so... success.
/connectionserver-install-dir/connectionSer
ver//libdbd_oci11.so... success.
Data File Name... success.
/connectionserver-install-dir/connectionSer
ver//oracle/oracle.sbo... success.
End AND operator: success.
The access driver is installed.
Rubriques associées
•
•
•
•
•
•
Outil de vérification : présentation des fonctions page 23
Affichage de l'aide sur l'outil cscheck page 21
Outil de vérification : find page 26
Outil de vérification : accessdriver page 30
Outil de vérification : middleware page 28
Outil de vérification : ping page 33
Outil de vérification : ping
Cette fonction a pour objectif d'accéder à une base de données spécifique
à l'aide des détails fournis.
Figure 2-10 : syntaxe de la fonction ping
cscheck ping|pg|-m{ mode d'accès à Connection Server }-c{ couche
réseau }-d{ client de base de données }-u{ nom d'utilisateur }-p{ mot de
passe }-s{ source de données }-t{ base de données }-r{ nom d'hôte }-j{
PID }
Guide d'accès aux données
33
2
2
Création d'une connexion
Vérification de la configuration de la connexion
Tableau 2-5 : Paramètres d'entrée de la fonction
Mode permettant à l'application client
d'accéder à Connection Server :
• local : Connection Server est
exécuté sur l'ordinateur local.
Mode d'accès à Connection Server
(-m)
34
•
corba : Connection Server est
exécuté sur un serveur CORBA.
•
http : Connection Server est exécuté sur un serveur HTTP.
•
java : Connection Server utilise
un pilote d'accès aux données
Java sur l'ordinateur local.
couche réseau (-c)
Middleware de base de données pour
la connexion à vérifier, tel qu'il est
renvoyé par la fonction find.
client de base de données (-d)
Type de base de données, tel qu'il
est renvoyé par la fonction find.
nom d'utilisateur (-u)
Nom d'utilisateur valide pour la base
de données.
mot de passe (-p)
Mot de passe correspondant au nom
d'utilisateur.
source de données (-s)
Serveur exécutant la base de données.
base de données (-t)
Serveur de la base de données.
Guide d'accès aux données
Création d'une connexion
Vérification de la configuration de la connexion
nom d'hôte (-r)
En mode CORBA, ordinateur hébergeant Connection Server.
PID (-i)
En mode CORBA, numéro de processus du Connection Server à utiliser
pour la commande ping.
Exemple : Commande ping pour une base de données Oracle
La commande suivante vérifie l'accès pour :
• Mode d'accès à Connection Server : local : la base de données est
exécutée sur l'ordinateur local.
•
Couche réseau : Oracle Client
•
Base de données : Oracle 8.1
•
Source de données : Harlaxton
•
Nom d'utilisateur : efashion
•
Mot de passe : X2345
cscheck ping -m local -c "Oracle Client" -d "Oracle 8.1" -u
"efashion" -p "X2345" -s "Harlaxton"
Exemple : Commande ping pour une base de données Sybase utilisant
CORBA
La commande suivante vérifie l'accès pour :
• Mode d'accès à Connection Server : CORBA : Connection Server
s'exécute sur un serveur CORBA.
•
Couche réseau : Sybase
•
Nom d'utilisateur : syadmin
•
Mot de passe : password
•
Source de données : Sybase Adaptive Server 15
Guide d'accès aux données
35
2
2
Création d'une connexion
A propos des connexions JDBC
•
Base de données : SY1
•
Hôte de base de données : sybasehost
•
ID de processus : 456
cscheck ping -m corba -c "Sybase Open Client" -d syb15 -u
"syadmin" -p "password" -s "Sybase Adaptive Server 15" -t
"SY1" -r "sybasehost" -i 456
Rubriques associées
•
•
Outil de vérification : présentation des fonctions page 23
Outil de vérification : find page 26
A propos des connexions JDBC
Un ensemble de pilotes d'accès aux données est installé avec l'application
Business Objects. Vous pouvez utiliser ces pilotes d'accès aux données
pour créer des connexions aux bases de données.
Le logiciel BusinessObjects inclut également des fichiers de configuration
pour l'utilisation de pilotes JDBC comme moyen d'accès aux bases de
données. Pour utiliser ces pilotes, procédez comme suit :
• Procurez-vous le logiciel du pilote Java auprès de votre fournisseur de
base de données.
•
Modifiez les fichiers de configuration fournis.
Remarque :
La connectivité JDBC est disponible pour BusinessObjects Enterprise XI 3.0
et versions ultérieures.
Attention :
Web Intelligence Rich Client ne prend pas en charge la connectivité JDBC
en mode 3 Tier.
Pour obtenir la liste la plus récente des pilotes JDBC pris en charge, visitez
le site SAP Service MarketPlace à l'adresse http://service.sap.com/bosapsupport ou contactez votre représentant Business Objects.
36
Guide d'accès aux données
Création d'une connexion
Pour créer une connexion JDBC
Remarque :
La couche d'accès aux données fournit la connectivité Generic JDBC qui
permet d'établir une connexion à une source de données que
BusinessObjects Enterprise ne prend pas en charge explicitement.
Rubriques associées
•
•
Pour créer une connexion JDBC page 37
Pour créer une connexion Generic JDBC page 38
Pour créer une connexion JDBC
Pour créer une connexion JDBC, procédez comme suit :
• Procurez-vous le logiciel de pilote JDBC nécessaire pour la base de
données et copiez les fichiers sur votre système. Ces fichiers sont
disponibles auprès du fournisseur de la base de données. Le logiciel du
pilote est généralement constitué d'un ou plusieurs fichiers .jar. Notez le
chemin d'installation de ces fichiers.
•
Vérifiez que vous disposez des informations nécessaires pour accéder
à la base de données (mot de passe et nom de connexion, par exemple).
Pour créer une connexion JDBC, respectez la procédure suivante :
1. Vérifiez si le pilote requiert des fichiers DLL supplémentaires et, le cas
échéant, assurez-vous que le système peut y accéder. Le pilote JDBC
SQLServer 2005, par exemple, utilise des DLL supplémentaires. Le
répertoire d'accès de ces DLL doit être inclus dans la variable
d'environnement PATH.
2. Accédez au répertoire contenant le fichier jdbc.sbo. Par exemple, sous
Microsoft Windows, les fichiers de configuration se trouvent dans le ré
pertoire connectionserver-install-dir\connectionServer\jdbc.
3. Utilisez un éditeur XML pour ouvrir le fichier jdbc.sbo à modifier.
4. Ajoutez les informations du fichier .jar requises à la zone Chemin de
la classe. Veillez à inclure les noms de chemins complets lorsque vous
spécifiez ces fichiers, par exemple :
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\msutil.jar</Path>
Remarque :
Ces fichiers doivent être installés sur l'ordinateur hébergeant l'application.
Guide d'accès aux données
37
2
2
Création d'une connexion
Pour créer une connexion Generic JDBC
Voir les informations de la structure du fichier d'exemple jdbc.sbo pour
en savoir plus.
5. Repérez le paramètre Capacités du pilote et vérifiez qu'il est défini
sur Procedures ou Query.
Si ce n'est pas le cas, le pilote JDBC n'est pas disponible depuis
l'Assistant de création de connexion.
6. Enregistrez le fichier .sbo et fermez-le.
7. Exécutez l'Assistant de connexion. Le pilote JDBC que vous avez
configuré apparaît dans la liste des connexions disponibles. Sélectionnez
le pilote JDBC et utilisez l'Assistant pour configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion est disponible.
Rubriques associées
•
•
Exemple de structure de fichiers SBO JDBC page 38
Conditions requises pour la connexion page 20
Exemple de structure de fichiers SBO JDBC
Les données ci-dessous présentent la section du fichier SBO JDBC que
vous devez modifier. Ce fichier SBO est destiné à Microsoft SQL Server 2000.
<DataBase Active="Yes" Name="MS SQL Server 2000">
...
<JDBCDriver>
<ClassPath>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\msbase.jar</Path>
<Path>C:\JDBC Drivers\MSSQLSERVER2000\\msutil.jar</Path>
<Path>C:\\JDBC Drivers\\MSSQLSERVER2000\\mssqlser
ver.jar</Path>
</ClassPath>
...
</JDBCDriver>
...
</DataBase>
Pour créer une connexion Generic JDBC
La procédure suivante explique comment configurer une connexion Generic
JDBC à une base de données. Pour créer une connexion Generic JDBC :
38
Guide d'accès aux données
Création d'une connexion
Pour créer une connexion Generic JDBC
•
Procurez-vous le logiciel de pilote JDBC nécessaire pour la base de
données et copiez les fichiers sur votre système. Vous devez installer le
fichier .jar sur l'ordinateur exécutant l'application Business Objects.
•
Vérifiez que vous disposez des informations nécessaires pour accéder
à la base de données (mot de passe et nom de connexion, par exemple).
Pour créer une connexion JDBC, respectez la procédure suivante :
1. Accédez au répertoire contenant les fichiers jdbc.sbo et jdbc.prm. Par
exemple, sous Microsoft Windows, les fichiers de configuration se
trouvent dans le répertoire connectionserver-install-dir\conne
ctionServer\jdbc.
2. Utilisez un éditeur XML pour ouvrir le fichier jdbc.sbo à modifier.
3. Ajoutez les informations du fichier .jar requises à la zone Chemin de
la classe. Veillez à inclure les noms de chemins complets lorsque vous
spécifiez ces fichiers. Définissez la classe du pilote JDBC et le format de
l'URL en vous servant des paramètres appropriés.
Voir les informations de la structure du fichier d'exemple jdbc.sbo pour
en savoir plus.
4. Enregistrez le fichier jdbc.sbo, puis fermez-le.
5. Utilisez un éditeur XML pour ouvrir le fichier jdbc.prm à modifier.
6. Ajoutez ou mettez à jour les informations spécifiques à la base de
données.
Remarque :
Il est possible que le fichier jdbc.prm ne contienne pas d'informations
sur les fonctions spécifiques de la base de données.
7. Enregistrez le fichier jdbc.prm, puis fermez-le.
8. Exécutez l'Assistant de création de connexion. Le pilote JDBC que vous
avez configuré apparaît dans la liste des connexions disponibles sous
Générique. Sélectionnez le pilote JDBC et utilisez l'Assistant pour
configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion à la source de données
est disponible pour être utilisée via JDBC.
Remarque :
Vous ne pouvez configurer qu'une seule connexion lors d'une implémentation
Generic JDBC.
Guide d'accès aux données
39
2
2
Création d'une connexion
A propos des connexions JavaBean
Rubriques associées
•
A propos des fichiers PRM page 126
Exemple de structure de fichiers SBO Generic JDBC
Les données ci-dessous présentent la section du fichier SBO JDBC que
vous devez modifier. Ce fichier SBO est destiné aux sources de données
Generic JDBC et à la base de données Ingres.
Remarque :
Le pilote JDBC Ingres est composé du fichier iijdbc.jar. La classe
com.ingres.jdbc.IngresDriver implémente l'interface JDBC ja
va.sql.Driver.
<DataBases>
<DataBase Active="Yes" Name="Generic JDBC datasource">
<JDBCDriver>
<ClassPath>
<Path>c:\\jdbc\\ingres\\iijdbc.jar</Path>
</ClassPath>
<Parameter Name="JDBC Class">com.ingres.jdbc.IngresDriver</Pa
rameter>
<Parameter Name="URL Format">jdbc:ingres://$DATASOURCE$</Pa
rameter>
</JDBCDriver>
...
</DataBases>
Remarque :
$DATASOURCE$ correspond soit à <hôte>:<port> ou à
<hôte>:<port>/<base de données>.
A propos des connexions JavaBean
Les développeurs peuvent créer des JavaBeans qui fournissent l'accès aux
sources de données. Vous pouvez créer des connexions à l'aide de ces
JavaBeans. Pour vous permettre de créer une connexion JavaBean, les
développeurs à l'origine du programme fournissent les éléments suivants :
40
•
les fichiers .jar nécessaires
•
les autres fichiers requis par JavaBean
Guide d'accès aux données
Création d'une connexion
Pour créer une connexion JavaBean
•
tous les paramètres de configuration spécifiques requis par le pilote de
JavaBean
Avec un pilote JavaBean, les procédures d'extraction des données sont
configurées en tant que procédures stockées. Lorsque vous configurez une
connexion JavaBean, dans l'écran Sélection du middleware de base de
données de l'Assistant de création de connexion, vous devez cocher la case
Filtrer les couches réseau des procédures stockées. Si vous ne procédez
pas ainsi, l'Assistant de création de connexion n'affiche pas les pilotes
JavaBean disponibles.
Pour créer une connexion JavaBean
Pour créer une connexion JavaBean, respectez la procédure suivante :
1. Utilisez un éditeur XML pour ouvrir le fichier javabean.sbo à modifier.
Par exemple, sous Microsoft Windows, les fichiers de configuration se
trouvent dans le répertoire connectionserver-install-dir\conne
ctionServer\javabean.
2. Ajoutez les informations du fichier .jar requises à la zone Chemin de
la classe. Veillez à inclure les noms de chemins complets lorsque vous
spécifiez ces fichiers.
Remarque :
Ces fichiers doivent être installés sur l'ordinateur hébergeant l'application
Business Objects.
Reportez-vous aux informations de la structure du fichier d'exemple Ja
vaBean.sbo pour en savoir plus.
3. Enregistrez le fichier .sbo et fermez-le.
4. Exécutez toutes les autres tâches de configuration spécifiées par le
développeur de JavaBean.
5. Exécutez l'Assistant de connexion. La source de données JavaBean que
vous avez configurée devrait apparaître dans la liste des connexions
disponibles. Sélectionnez la source de données JavaBean et utilisez
l'Assistant pour configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion est disponible et peut être
utilisée avec l'application.
Rubriques associées
•
Exemple de structure de fichiers SBO JavaBean page 42
Guide d'accès aux données
41
2
2
Création d'une connexion
A propos des connexions ODBC
•
Clés primaires disponibles page 116
Exemple de structure de fichiers SBO JavaBean
Cette section contient un exemple de fichier SBO JavaBean.
<DataBase Active="Yes" Name="Excel
Spreadsheet">
<JavaBean>
<ClassPath>
<Path>$ROOT$\\beans\\bean_excel.jar
</Path>
</ClassPath>
<Parameter Name="JavaBean Class">com.
businessobjects.beans.excel.Excel
</Parameter>
<Parameter Name="URL Format">$DATASOURCE$
</Parameter>
</JavaBean>
<Parameter Name="Family">Java Beans
</Parameter>
<Parameter Name="Description File">
bean_excel</Parameter>
<Parameter Name="Authentication Mode">
Bypass</Parameter>
<Parameter Name="Extensions">bean_excel,
javabean</Parameter>
</DataBase>
</DataBases>
A propos des connexions ODBC
Un ensemble de pilotes d'accès aux données est installé avec l'application
Business Objects. Vous pouvez utiliser ces pilotes d'accès aux données
pour créer des connexions aux bases de données.
Le logiciel Business Objects inclut également des fichiers de configuration
pour l'utilisation de pilotes ODBC comme moyen d'accès aux bases de
données. Pour utiliser ces pilotes, procédez comme suit :
• Procurez-vous le logiciel du pilote ODBC auprès de votre fournisseur de
base de données.
•
42
Modifiez les fichiers de configuration fournis.
Guide d'accès aux données
Création d'une connexion
Pour créer une connexion Generic ODBC
Pour obtenir la liste la plus récente des pilotes ODBC pris en charge, visitez
le site SAP Service MarketPlace à l'adresse http://service.sap.com/bosapsupport ou contactez votre représentant Business Objects.
Remarque :
La couche d'accès aux données fournit la connectivité Generic ODBC qui
permet d'établir une connexion à une source de données que
BusinessObjects Enterprise ne prend pas en charge explicitement.
A propos des connexions Generic ODBC sous UNIX
Le système d'exploitation Windows est fourni avec un gestionnaire de pilotes
ODBC standard. En revanche, UNIX ne propose aucune méthode de gestion
des pilotes. Les logiciels BusinessObjects vous permettent d'utiliser des
gestionnaires de pilotes DataDirect ou unixODBC pour les connexions
Generic ODBC sous UNIX.
Avant de créer une connexion Generic ODBC sous UNIX pour une base de
données spécifique, vous devez :
•
•
connaître la version du pilote ODBC
savoir si le pilote peut fonctionner avec le gestionnaire de pilotes
DataDirect ou unixODBC
Vous devez ensuite modifier les fichiers de configuration fournis et configurer
la source de données appropriée afin d'activer la connexion.
Remarque :
Vous ne pouvez configurer qu'une seule connexion lors d'une
implémentation ODBC.
Rubriques associées
•
•
Pour créer une connexion Generic ODBC page 43
Pour créer une connexion Generic ODBC3 page 45
Pour créer une connexion Generic ODBC
La procédure suivante explique comment configurer une connexion
Generic ODBC à une base de données en partant du principe que :
• Le pilote est de type ODBC2
• Le pilote prend en charge le gestionnaire de pilotes unixODBC
1. Accédez au répertoire contenant les fichiers odbc.sbo et odbc.prm.
Guide d'accès aux données
43
2
2
Création d'une connexion
Pour créer une connexion Generic ODBC
Les fichiers de configuration se trouvent dans le répertoire connectio
nserver-install-dir/connectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier odbc.sbo à modifier.
3. Recherchez la section suivante :
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc</Library>
<Library Platform="Unix">dbd_ddodbc</Library>
<!--Library Platform="Unix">dbd_wuxodbc</Library-->
<!--Library Platform="Unix">dbd_uxodbc</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadire
ct</Parameter>
...
</DataBases>
4. Commentez les deux premières lignes pour DataDirect et supprimez le
commentaire d'une des deux lignes suivantes. Veillez à placer la ligne
modifiée en haut de la section, afin qu'elle soit lue en premier. Commentez
l'élément <Parameter Name="CharSet Table" Platform="Unix">.
Remarque :
•
•
•
•
dbd_wddodbc indique le pilote Unicode ODBC2 basé sur DataDirect
dbd_ddodbc indique le pilote non-Unicode ODBC2 basé sur DataDirect
dbd_wuxodbc indique le pilote Unicode ODBC2 basé sur unixODBC
dbd_uxodbc indique le pilote non-Unicode ODBC2 basé sur unixODBC
5. Enregistrez le fichier odbc.sbo, puis fermez-le.
6. Utilisez un éditeur XML pour ouvrir le fichier odbc.prm à modifier.
7. Ajoutez ou mettez à jour les informations spécifiques à la base de
données.
Remarque :
Il est possible que le fichier odbc.prm ne contienne pas d'informations
sur les fonctions spécifiques de la base de données.
8. Enregistrez le fichier odbc.prm, puis fermez-le.
9. Installez les pilotes ODBC appropriés sur votre ordinateur UNIX.
10. Configurez la source de données en modifiant le fichier odbc.ini.
11. Enregistrez le fichier odbc.ini, puis fermez-le.
44
Guide d'accès aux données
Création d'une connexion
Pour créer une connexion Generic ODBC3
12. Exécutez l'Assistant de création de connexion. Le pilote ODBC que vous
avez configuré apparaît dans la liste des connexions disponibles sous
Générique. Sélectionnez le pilote ODBC et utilisez l'Assistant pour
configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion à la source de données
est disponible pour être utilisée via Generic ODBC avec le gestionnaire de
pilotes unixODBC.
Pour créer une connexion Generic ODBC3
La procédure suivante explique comment configurer une connexion
Generic ODBC à une base de données en partant du principe que :
• Le pilote est de type ODBC3
• Le pilote prend en charge le gestionnaire de pilotes unixODBC
1. Accédez au répertoire contenant les fichiers odbc.sbo et odbc.prm.
Les fichiers de configuration se trouvent dans le répertoire connectio
nserver-install-dir/connectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier odbc.sbo à modifier.
3. Recherchez la section suivante :
<DataBases>
<DataBase Active="Yes" Name="Generic ODBC3 datasource">
<Libraries>
...
<Library Platform="Unix">dbd_wddodbc3</Library>
<Library Platform="Unix">dbd_ddodbc3</Library>
<!--Library Platform="Unix">dbd_wuxodbc3</Library-->
<!--Library Platform="Unix">dbd_uxodbc3</Library-->
<!--Library Platform="Unix64">dbd_wux32odbc3</Library-->
<!--Library Platform="Unix64">dbd_ux32odbc3</Library-->
</Libraries>
<Parameter Name="Charset Table" Platform="Unix">datadire
ct</Parameter>
...
</DataBases>
4. Commentez les deux premières lignes pour DataDirect et supprimez le
commentaire d'une des quatre lignes suivantes. Veillez à placer la ligne
modifiée en haut de la section, afin qu'elle soit lue en premier. Commentez
l'élément <Parameter name="CharSet Table" Platform="Unix">.
Guide d'accès aux données
45
2
2
Création d'une connexion
Pour créer une connexion Generic ODBC3
Remarque :
•
•
dbd_wddodbc3 indique le pilote Unicode ODBC3 basé sur DataDirect
dbd_ddodbc3 indique le pilote non-Unicode ODBC3 basé sur
DataDirect
•
•
dbd_wuxodbc3 indique le pilote Unicode ODBC3 basé sur unixODBC
dbd_uxodbc3 indique le pilote non-Unicode ODBC3 basé sur
unixODBC
•
dbd_wux32odbc3 indique le pilote Unicode ODBC3 basé sur unixODBC
•
ayant une API 32 bits au lieu de 64 bits (disponible uniquement sur
les plateformes 64 bits)
dbd_ux32odbc3 indique le pilote non-Unicode ODBC3 basé sur
unixODBC ayant une API 32 bits au lieu de 64 bits (disponible
uniquement sur les plateformes 64 bits)
5. Enregistrez le fichier odbc.sbo, puis fermez-le.
6. Utilisez un éditeur XML pour ouvrir le fichier odbc.prm à modifier.
7. Ajoutez ou mettez à jour les informations spécifiques à la base de
données.
Remarque :
Il est possible que le fichier odbc.prm ne contienne pas d'informations
sur les fonctions spécifiques de la base de données.
8. Enregistrez le fichier odbc.prm, puis fermez-le.
9. Installez les pilotes ODBC appropriés sur votre ordinateur UNIX.
10. Configurez la source de données en modifiant le fichier odbc.ini.
11. Enregistrez le fichier odbc.ini, puis fermez-le.
12. Exécutez l'Assistant de création de connexion. Le pilote ODBC que vous
avez configuré apparaît dans la liste des connexions disponibles sous
Générique. Sélectionnez le pilote ODBC et utilisez l'Assistant pour
configurer la connexion.
Lorsque vous effectuez cette tâche, la connexion à Ingres est disponible
pour être utilisée via ODBC3 avec le gestionnaire de pilotes unixODBC.
46
Guide d'accès aux données
Création d'une connexion
au serveur de requêtes
Data Federator
3
3
Création d'une connexion au serveur de requêtes Data Federator
A propos des connexions au serveur de requêtes Data Federator
A propos des connexions au serveur de
requêtes Data Federator
Vous pouvez créer des connexions vers des tables déployées sur le serveur
de requêtes Data Federator afin d'utiliser ces tables avec une application
Business Objects.
Remarque :
Pour en savoir plus sur la connexion à BusinessObjects Data Federator, voir
le document Data Federator User Guide (Guide d'utilisation de
Data Federator) et le chapitre“”sur la connexion au serveur de requêtes
Data Federator à l'aide des pilotes JDBC/ODBC.
Ce chapitre décrit les autres paramètres à configurer sur le serveur de
requêtes Data Federator et certains paramètres de configuration de
Connection Server pour la création de connexions.
La méthode que vous utilisez pour configurer la connexion varie suivant que
vous utilisez JDBC ou ODBC pour la connexion. Avec des connexions ODBC,
la configuration dépend de l'application Business Objects que vous utilisez.
Le processus diffère si vous créez une connexion à utiliser avec
Web Intelligence Rich Client.
La méthode que vous utilisez pour créer la connexion dépend de l'application
que vous utilisez. En général, vous utilisez l'Assistant de création de
connexion pour créer la connexion. Pour en savoir plus, voir la documentation
de votre application.
Ce chapitre décrit également la configuration de l'Assistant de création de
connexion des applications Universe Designer et Web Intelligence qui est
requise pour créer des connexions.
Attention :
Business Objects recommande d'utiliser une connectivité JDBC pour
connecter les applications Business Objects au serveur de requêtes
Data Federator. La connectivité JDBC est uniquement prise en charge par
BusinessObjects Enterprise XI 3.0 et versions ultérieures et ne permet pas
d'établir de connexions à Desktop Intelligence. La connectivité JDBC est
disponible sur toutes les plateformes (Microsoft Windows, systèmes
d'exploitation UNIX et Linux).
48
Guide d'accès aux données
Création d'une connexion au serveur de requêtes Data Federator
Configuration de l'Assistant de création de connexion pour une connexion JDBC ou ODBC Data Federator
La version ODBC minimale que vous pouvez utiliser avec les informations
de connexion ci-après est la suivante BusinessObjects Data Federator XI
Release 2 SP1 MHF1. Si nécessaire, contactez votre revendeur
Business Objects pour obtenir des informations sur cette version et vous la
procurer. Le middleware ODBC Data Federator peut uniquement être utilisé
sous Microsoft Windows. L'utilisation d'une passerelle ODBC-JDBC
OpenAccess a par ailleurs une incidence sur les performances.
Rubriques associées
•
Configuration de l'Assistant de création de connexion pour une
connexion JDBC ou ODBC Data Federator page 49
• Configuration des connexions JDBC Data Federator page 50
• Configuration des connexions ODBC Data Federator page 51
• Configuration de définitions de connexion Web Intelligence Rich Client
à l'aide du middleware ODBC Data Federator page 54
Configuration de l'Assistant de création
de connexion pour une connexion JDBC
ou ODBC Data Federator
Pour créer une connexion au serveur de requêtes Data Federator, les
informations suivantes sont nécessaires. Contactez votre administrateur
BusinessObjects Data Federator pour obtenir ces informations :
• nom de serveur et port sur lequel le serveur de requêtes Data Federator
est exécuté
•
nom du catalogue sur le serveur de requêtes Data Federator
Dans l'Assistant de création de connexion, il s'agit du nom de la base de
données à laquelle vous vous connectez.
•
détails d'authentification pour l'installation du serveur de requêtes
Data Federator qui sert le catalogue auquel vous vous connectez
Dans l'écran Sélection du middleware de base de données de l'Assistant
de création de connexion, utilisez le middleware SAP BusinessObjects,
Data Federator, Pilotes JDBC ou Pilotes ODBC pour créer la connexion.
Guide d'accès aux données
49
3
3
Création d'une connexion au serveur de requêtes Data Federator
Configuration des connexions JDBC Data Federator
Voir la documentation de votre application pour en savoir plus sur l'utilisation
de l'Assistant de création de connexion une fois que vous avez apporté des
modifications à la configuration.
Remarque :
Pour configurer une connexion JDBC ou ODBC à un serveur de requêtes
Data Federator, vous devez procéder à quelques configurations
supplémentaires. Si vous utilisez Web Intelligence Rich Client, les
changements de configuration requis diffèrent de ceux requis par d'autres
applications Business Objects.
Configuration des connexions JDBC
Data Federator
Cette section décrit les modifications à apporter à la configuration de
Connection Server pour les connexions JDBC à toutes les applications
Business Objects.
Les informations de configuration de cette section se réfèrent au chemin
suivant :
• data-federator-drivers-install-dir\JdbcDriver : répertoire
d'installation racine du middleware JDBC Data Federator. Votre
administrateur a choisi ce répertoire lors de l'exécution du programme
d'installation de Data Federator.
• bo-install-dir : répertoire d'installation racine des applications
Business Objects.
Remarque :
Le cas échéant, vous pouvez modifier les fichiers dans un éditeur XML.
Après avoir apporté les modifications présentées ci-dessous à la
configuration, vous devez redémarrer le système pour que les changements
prennent effet.
50
Guide d'accès aux données
Création d'une connexion au serveur de requêtes Data Federator
Configuration des connexions ODBC Data Federator
Configuration de Connection Server pour une
connexion JDBC Data Federator
Remarque :
Cette rubrique concerne toutes les applications Business Objects qui utilisent
Connection Server.
Pour configurer Connection Server, vous devez modifier le fichier de
configuration : bo-install-dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\jdbc\jdbc.sbo
Pour configurer le fichier jdbc.sbo, ajoutez les lignes suivantes à la section
ClassPath ou modifiez-les comme suit :
<DataBase Active="Yes" Name="Data Federator Server">
<JDBCDriver>
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\JdbcDri
ver\\lib\\thindriver.jar</Path>
<Path>\\businessobjects-install-dir\\common\\4.0\\ja
va\\lib\\ebus405.jar</Path>
</ClassPath>
<Parameter Name="URL Format">jdbc:datafederator://$DATA
SOURCE$;catalog="$DATABASE$";commProtocol=EBUS</Para
meter>
</JDBCDriver>
...
</DataBase>
où businessobjects-install-dir représente le répertoire C:\Program
Files\Business Objects sous Microsoft Windows. Le fichier ebus405.jar
est fourni avec l'installation de BusinessObjects Enterprise.
Configuration des connexions ODBC
Data Federator
Cette section décrit les paramètres supplémentaires du serveur de requêtes
Data Federator et les changements à apporter à la configuration de
Connection Server pour les connexions ODBC à toutes les applications
Business Objects excepté Web Intelligence Rich Client.
Guide d'accès aux données
51
3
3
Création d'une connexion au serveur de requêtes Data Federator
Configuration des connexions ODBC Data Federator
Les informations de configuration de cette section se réfèrent aux chemins
suivants :
• data-federator-drivers-install-dir\OaJdbcBridge : répertoire
d'installation racine du middleware ODBC Data Federator. Votre
administrateur a choisi ce répertoire lors de l'exécution du programme
d'installation des pilotes Data Federator.
•
data-federator-drivers-install-dir\JdbcDriver : répertoire
d'installation racine du middleware JDBC Data Federator. Votre
administrateur a choisi ce répertoire lors de l'exécution du programme
d'installation de Data Federator.
•
bo-install-dir : répertoire d'installation racine des applications
Business Objects.
Remarque :
Le cas échéant, vous pouvez modifier les fichiers dans un éditeur XML.
Après avoir apporté les modifications présentées ci-dessous à la
configuration, vous devez redémarrer le système pour que les changements
prennent effet.
Rubriques associées
•
•
Configuration du middleware ODBC Data Federator page 52
Configuration de Connection Server pour une connexion ODBC
Data Federator page 53
Configuration du middleware ODBC Data Federator
Remarque :
Cette rubrique s'applique à toutes les applications Business Objects qui
utilisent Connection Server, excepté Web Intelligence Rich Client.
Pour configurer le middleware ODBC BusinessObjects Data Federator, vous
devez modifier le fichier openrda.ini. situé dans le répertoire suivant :
•
data-federator-drivers-install-dir\OaJdbcBridge\bin\iwinnt
Pour configurer le fichier openrda.ini, définissez les paramètres de la
section [JavaIp] comme suit :
52
Guide d'accès aux données
Création d'une connexion au serveur de requêtes Data Federator
Configuration des connexions ODBC Data Federator
•
CLASSPATH=data-federator-drivers-install-dir\OaJdbcBridge\oa
java\oasql.jar;data-federator-drivers-install-dir\JdbcDri
ver\thindriver.jar;bo-install-dir\BusinessObjects Enterprise
12.0\classes\ConnectionServer.jar
•
JVM_DLL_NAME=bo-install-dir\javasdk\jre\bin\client\jvm.dll
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.di
rectory=bo-install-dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer
Remarque :
Vérifiez le fichier openrda.ini pour vous assurer que ce chemin n'est
pas défini au moyen du paramètre Djava.endorsed.dirs. Si c'est le
cas, vous devez supprimer le chemin du paramètre Djava.endor
sed.dirs.
Configuration de Connection Server pour une
connexion ODBC Data Federator
Remarque :
Cette rubrique s'applique à toutes les applications Business Objects qui
utilisent Connection Server, excepté Web Intelligence Rich Client.
Pour configurer Connection Server, vous devez modifier le fichier de
configuration : bo-install-dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\cs.cfg
Pour configurer le fichier cs.cfg, définissez les paramètres situés sous la
balise JavaVM de la manière suivante :
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oa
java\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thi
ndriver.jar</Path>
</ClassPath>
Guide d'accès aux données
53
3
3
Création d'une connexion au serveur de requêtes Data Federator
Configuration de définitions de connexion Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator
Configuration de définitions de
connexion Web Intelligence Rich Client
à l'aide du middleware ODBC
Data Federator
Si vous créez des connexions Web Intelligence Rich Client utilisant le
middleware ODBC Data Federator, vous devez effectuer les changements
de configuration décrits dans cette section. Si la configuration n'est pas
correctement modifiée, la connexion génère des erreurs. Ce type de
connexion n'est pris en charge que par les environnements Windows.
Rappel :
Les détails ci-dessous concernent Web Intelligence Rich Client uniquement.
Pour créer des connexions qui utilisent le middleware ODBC Data Federator
avec Web Intelligence Rich Client, vous devez modifier les configurations
suivantes :
• Middleware ODBC
•
Connection Server
•
Clé de registre RichClient de Windows
Les informations de configuration de cette section se réfèrent aux chemins
suivants :
• data-federator-drivers-install-dir\OaJdbcBridge : répertoire
d'installation racine du middleware ODBC Data Federator. Votre
administrateur a choisi ce répertoire lors de l'exécution du programme
d'installation des pilotes Data Federator.
•
data-federator-drivers-install-dir\JdbcDriver : répertoire
d'installation racine du middleware JDBC Data Federator. Votre
administrateur a choisi ce répertoire lors de l'exécution du programme
d'installation de Data Federator.
•
bo-install-dir : répertoire d'installation racine des applications
Business Objects.
54
Guide d'accès aux données
Création d'une connexion au serveur de requêtes Data Federator
Configuration de définitions de connexion Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator
Remarque :
Le cas échéant, vous pouvez modifier les fichiers dans un éditeur XML.
Rubriques associées
•
Configuration du middleware ODBC Data Federator pour une connexion
Web Intelligence Rich Client page 55
• Configuration de Connection Server pour une connexion Web Intelligence
Rich Client à Data Federator page 56
• Définition de la clé de registre Web Intelligence Rich Client page 56
• Configuration de Connection Server pour des connexions
Web Intelligence Rich Client et Universe Designer à Data Federator
page 57
Configuration du middleware ODBC Data Federator
pour une connexion Web Intelligence Rich Client
Pour configurer le middleware ODBC Data Federator, vous devez modifier
le fichier openrda.ini situé dans le répertoire suivant :
•
data-federator-drivers-install-dir\OaJdbcBridge\bin\iwinnt
Pour configurer le fichier openrda.ini, définissez les paramètres de la
section [JavaIp] comme suit :
•
CLASSPATH=data-federator-drivers-install-dir\OaJdbcBridge\oa
java\oasql.jar;data-federator-drivers-install-dir\JdbcDri
ver\thindriver.jar;bo-install-dir\BusinessObjects Enterprise
12.0\classes\ConnectionServer.jar
•
JVM_DLL_NAME=bo-install-dir\javasdk\jre6\bin\client\jvm.dll
Remarque :
Web Intelligence Rich Client nécessite JDK 6.
•
JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.di
rectory=bo-install-dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer
Remarque :
Vérifiez le fichier openrda.ini pour vous assurer que ce chemin n'est
pas défini au moyen du paramètre Djava.endorsed.dirs. Si c'est le
Guide d'accès aux données
55
3
3
Création d'une connexion au serveur de requêtes Data Federator
Configuration de définitions de connexion Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator
cas, vous devez supprimer le chemin du paramètre Djava.endor
sed.dirs.
Configuration de Connection Server pour une
connexion Web Intelligence Rich Client à
Data Federator
Pour configurer Connection Server pour une connexion de Web Intelligence
Rich Client à Data Federator, vous devez modifier le fichier de configuration :
bo-install-dir\BusinessObjects Enterprise
12.0\win32_x86\dataAccess\connectionServer\cs.cfg
Pour configurer le fichier cs.cfg, définissez les paramètres situés sous la
balise JavaVM de la manière suivante :
<ClassPath>
<Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oa
java\\oasql.jar</Path>
<Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thi
ndriver.jar</Path>
</ClassPath>
Définition de la clé de registre
Web Intelligence Rich Client
Pour modifier la clé de registre Windows RichClient, utilisez l'outil regedit,
par exemple.
1. Dans le registre, recherchez la clé
HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite
12.0\default\WebIntelligence\RichClient.
2. Dans cette clé, ajoutez les valeurs suivantes à classpath. Comme pour
toutes les valeurs de clé de registre, elles doivent être séparées par un
point-virgule.
• data-federator-drivers-install-dir\OaJdbcBridge\oajava\oa
sql.jar
56
Guide d'accès aux données
Création d'une connexion au serveur de requêtes Data Federator
Configuration de définitions de connexion Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator
•
data-federator-drivers-install-dir\JdbcDriver\thindri
ver.jar
Configuration de Connection Server pour des
connexions Web Intelligence Rich Client et
Universe Designer à Data Federator
Il est possible d'utiliser une seule configuration pour créer une connexion
ODBC à Data Federator à partir de Universe Designer et de
Web Intelligence Rich Client. Outre les paramètres de configuration décrits
précédemment, suivez l'une des séries d'instructions ci-dessous :
• Procédez comme suit :
1. Exécutez l'outil regedit.
2. Dans le registre, recherchez la clé
HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite
12.0\default\ConnectionServer\Configuration.
3. Dans cette clé, ajoutez la valeur suivante à la valeur JVM Library :
bo-install-dir\javasdk\jre6\bin\client\jvm.dll.
•
Procédez comme suit :
1. Ouvrez le fichier cs.cfg pour le modifier.
2. Recherchez la balise JavaVM.
3. Définissez LibraryName sur le chemin de répertoire JVM spécifié
dans le fichier openrda.ini :
...
<JavaVM>
<LibraryName JNIVersion="JNI_VERSION_1_4">\\bo-installdir\\javasdk\\jre6\\bin\\client\\jvm.dll</LibraryName>
</JavaVM>
Attention :
Universe Designer et la passerelle OpenEdge doivent indiquer le même
chemin de répertoire JVM.
Guide d'accès aux données
57
3
3
Création d'une connexion au serveur de requêtes Data Federator
Configuration de définitions de connexion Web Intelligence Rich Client à l'aide du middleware ODBC
Data Federator
58
Guide d'accès aux données
Configuration des
paramètres globaux d'accès
aux données
4
4
Configuration des paramètres globaux d'accès aux données
A propos des paramètres globaux
A propos des paramètres globaux
Vous pouvez configurer les valeurs des paramètres globaux qui s'appliquent
à toutes les connexions. Vous pouvez ainsi améliorer les performances ou
résoudre certains problèmes de connexion.
Les paramètres globaux d'accès aux données se trouvent dans le fichier
cs.cfg. Il s'agit du fichier XML qui contient les paramètres de configuration
Connection Server et les paramètres de configuration par défaut qui
s'appliquent à tous les pilotes d'accès aux données.
Pour remplacer ces paramètres globaux, vous pouvez configurer des
paramètres dans le fichier .sbo de chacun des pilotes.
Rubriques associées
•
Configuration des paramètres du pilote page 76
A propos du fichier de configuration
cs.cfg
Dans un système Windows, le fichier cs.cfg est stocké à l'emplacement
suivant :
• connectionserver-install-dir \connectionServer
Dans le fichier cs.cfg, vous pouvez configurer les paramètres des sections
suivantes uniquement :
• Paramètres
Cette section définit les paramètres de configuration globale de
Connection Server, y compris les types d'accès client tels que CORBA.
Ces paramètres peuvent être remplacés par leurs équivalents dans le
fichier de configuration du pilote d'accès aux données <pilote>.sbo, où
<pilote>est le nom du pilote d'accès aux données auquel le fichier .sbo
correspond.
•
Paramètres par défaut du pilote
Ces paramètres s'appliquent à tous les pilotes d'accès aux données.
60
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Pour afficher et modifier le fichier cs.cfg
•
Distribution
Vous devez configurer les paramètres de cette section si vous utilisez
CORBA.
•
Traces
Vous pouvez définir des paramètres de trace qui permettent
l'enregistrement de l'activité de connexion via Connection Server dans
des fichiers journaux. Pour en savoir plus sur la création de traces,
reportez-vous aux notes de version.
La dernière section, Paramètres régionaux, définit le jeu de caractères du
système d'exploitation pour chaque langue disponible. Les paramètres de
cette section ne doivent pas être modifiés.
Pour afficher et modifier le fichier cs.cfg
Vous pouvez afficher et modifier les paramètres d'un fichier cs.cfg comme
suit :
1. Recherchez le répertoire où se trouve le fichier cs.cfg. Par exemple,
sous Windows :
connectionserver-install-dir\connectionServer\cs.cfg où co
nnectionserver-install-dir est l'emplacement d'installation du
logiciel Connection Server.
2. Ouvrez le fichier cs.cfg dans un éditeur XML.
3. Développez les sections concernées.
4. Pour définir les paramètres, ajoutez de nouveaux paramètres et de
nouvelles valeurs ou modifiez les valeurs existantes.
5. Vérifiez que le document est valide par rapport au DTD, puis enregistrez
le fichier et fermez-le.
Configuration des paramètres de pilote
par défaut
La section <DriverDefaults> du fichier cs.cfg contient les valeurs par défaut
appliquées à tous les pilotes d'accès aux données. Ces valeurs par défaut
Guide d'accès aux données
61
4
4
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
sont remplacées pour un pilote spécifique par les valeurs correspondantes
définies dans le fichier <driver>.sbo.
Pour en savoir plus sur les paramètres définissables par l'utilisateur, voir les
informations de référence sur les paramètres du fichier SBO.
Rubriques associées
•
•
•
Fichiers de configuration d'accès aux données page 76
Configuration des paramètres du pilote page 76
Catégories de paramètres SBO page 84
Configuration des paramètres globaux
La section <Settings> du fichier cs.cfg définit les paramètres qui
s'appliquent à tous les pilotes et ne peut être personnalisée pour chaque
pilote d'accès à distance. Certains paramètres peuvent être définis pour la
version Bibliothèque ou la version Serveur de Connection Server :
• bibliothèque
Dans ce mode, Connection Server fait partie du processus client.
•
serveur
Dans ce mode, Connection Server est un serveur CORBA avec accès à
distance. Dans ce mode, Connection Server sert deux types de clients
différents : HTTP et CORBA. Si votre environnement utilise le mode
Serveur, vous devez configurer certains paramètres de la section <Ser
ver> du fichier cs.cfg.
Les paramètres de <Settings> sont affichés dans l'ordre alphabétique. Pour
afficher ou modifier des paramètres, ouvrez le fichier cs.cfg dans un éditeur
XML et accédez à la section Settings, puis à la section Parameters. Dans
le fichier, chaque paramètre est défini dans la balise suivante :
<Parameter Name="parameter">value</Parameter>
où parameter est le nom du paramètre et value est la valeur attribuée au
paramètre.
Chaque paramètre figure avec les informations suivantes :
62
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
•
exemple de la façon dont le paramètre s'affiche dans le fichier XML.
Lorsqu'il est disponible en mode bibliothèque ou serveur, un exemple est
donné pour chaque cas
•
description du paramètre
•
valeurs possibles qui peuvent être définies pour le paramètre (si
applicable)
•
valeur par défaut pour le paramètre
Charset List Extension
<Parameter Name="CharSet List Extension">crs</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de jeux de caractères.
Par défaut
crs
Config File Extension
<Parameter Name="Config File Extension">sbo</Parameter>
Remarque :
Description
Par défaut
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de configuration générale.
sbo
Guide d'accès aux données
63
4
4
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
Description Extension
<Parameter Name="Description Extension">cod</Parameter>
Remarque :
Description
Par défaut
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de description des connexions.
cod
Enable Failed Load
<Parameter Name="Enable Failed Load">Yes</Parameter>
Description
Détermine l'opération effectuée en cas d'échec du
chargement. Le paramètre permet de choisir entre
une connexion qui fonctionne (même si certains pilotes sont défaillants) ou une erreur fatale sans aucune fonctionnalité si le chargement d'un pilote
échoue.
Yes : Connection Server génère une erreur fatale si
le chargement d'un pilote échoue.
Valeurs
No : Connection Server génère une erreur non fatale
si le chargement d'un pilote échoue.
Par défaut
64
Guide d'accès aux données
Oui
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
Rubriques associées
•
Load Drivers On Startup page 65
Load Drivers On Startup
Load Drivers On startup est disponible en mode Bibliothèque et Serveur.
Library
<Settings>
<Parameter Name="Load Drivers On Startup">No</Parameter>
...
<Library/>
Serveur
<Server>
<Parameter Name="Load Drivers On Startup">Yes</Parameter>
...
</Server>
Ces deux modes sont décrits ci-dessous.
Description
Détermine le mode de chargement des bibliothèques.
•
Yes : tous les pilotes installés sont chargés lors
de la phase d'initialisation.
•
No : les pilotes sont chargés à la demande.
Valeurs
Mode Bibliothèque : No
Par défaut
Mode serveur : Yes
Max Pool Time
Max Pool Time est disponible en mode Bibliothèque et Serveur.
Guide d'accès aux données
65
4
4
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
Library
<Settings>
<Parameter Name="Max Pool Time">-1</Parameter>
<Library/>
Serveur
<Server>
<Parameter Name="Max Pool Time">60</Parameter>
. . .
</Server>
Détermine la période de temps maximale pendant
laquelle une connexion peut rester inactive dans le
pool de connexions. Un pool de connexions est un
mécanisme utilisé par les pilotes d'accès aux données
pour réutiliser les connexions à la base de données
afin de tirer le meilleur parti des ressources système.
Vous pouvez définir Max Pool Time pour deux types
de déploiements de Connection Server :
Description
Bibliothèque : la valeur s'applique aux nœuds où
Connection Server est installé avec des produits
clients ou avec d'autres produits serveur.
Serveur : la valeur s'applique aux installations Connection Server de type serveur autonome. Pour en savoir
plus sur le déploiement de Connection Server sur un
nœud dédié, voir le Guide de planification du déploiement de BusinessObjects Enterprise.
Mode Bibliothèque : -1
Par défaut
Serveur : 60
66
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Configuration des paramètres globaux
-1 : pas de délai d'expiration, la connexion est maintenue pendant toute la durée de la session.
Valeurs
0 : connexion non gérée par le pool.
>0 : durée d'inactivité (en minutes).
SQL External Extension
<Parameter Name="SQL External Extension">rss</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers SQL externes.
Par défaut
rss
SQL Parameter Extension
<Parameter Name="SQL Parameter Extension">prm</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de paramètres SQL.
Par défaut
prm
Guide d'accès aux données
67
4
4
Configuration des paramètres globaux d'accès aux données
Configuration de la méthode d'accès
Strategies Extension
<Parameter Name="Strategies Extension">stg</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Définit l'extension des fichiers de stratégie.
Par défaut
stg
Configuration de la méthode d'accès
Dans le fichier cs.cfg, les paramètres de la section <Settings> contrôlent
la méthode d'accès.
Dans la section <Settings> :
•
Les paramètres de la section <Library> contrôlent le mode Bibliothèque.
La plupart des applications Business Objects utilisent Connection Server
en mode Bibliothèque.
•
Les paramètres de la section <Server> contrôlent l'accès CORBA.
Les paramètres définis dans les sections <Library> et <Server> remplacent
tous les paramètres définis ailleurs dans la section <Settings>. Par exemple,
avec CORBA, les paramètres définis dans la section <Server> peuvent
remplacer les paramètres définis ailleurs pour les applications utilisant l'accès
<Library>.
Les paramètres s'appliquant au mode bibliothèque sont les suivants :
• Load Drivers On Startup
• Max Pool Time
Les paramètres s'appliquant à l'accès CORBA sont les suivants :
• Load Drivers On Startup
68
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Configuration du filtre de pilote
Ce paramètre est défini par défaut sur Yes. Cela signifie que tous les
pilotes d'accès aux données sont chargés au démarrage de
Connection Server.
Attention :
Pour éviter les échecs de connexion, vous devez vous assurer que votre
environnement fournit tout le middleware nécessaire, sinon vous devrez
modifier la section <Settings> en incluant uniquement les couches
réseau et les bases de données dont vous avez besoin sous <ActiveDa
taSources>. Vous pouvez également définir Enable Failed Load sur
No.
•
•
Max Pool Time
Transient Object Timeout
Vous ne pouvez pas modifier la valeur du paramètre Transient Object
Timeout à partir du fichier cs.cfg, mais à partir de la CMC
BusinessObjects. Voir le Guide d'administration de
BusinessObjects Enterprise.
Rubriques associées
•
•
•
•
Configuration du filtre de pilote page 69
Load Drivers On Startup page 65
Enable Failed Load page 64
Max Pool Time page 65
Configuration du filtre de pilote
Vous pouvez configurer la section <ActiveDataSources> pour les scénarios
de déploiement complexes impliquant plusieurs serveurs de connexion en
mode serveur. Spécifiez les sources de données actives pour permettre aux
applications client de déterminer les pilotes que chaque serveur de connexion
de l'architecture charge et utilise. Pour en savoir plus sur les scénarios de
déploiement complexes, voir le Guide de planification du déploiement de
BusinessObjects Enterprise.
Dans le fichier cs.cfg, la section <ActiveDataSources> vous permet de
spécifier les couches réseau et les sources de données associées que
Connection Server doit utiliser et exposer. Cette section fonctionne en tant
que filtre des pilotes. Sous la section <ActiveDataSources>, les éléments
<NetworkLayer> indiquent les pilotes disponibles pour la connexion. Pour
Guide d'accès aux données
69
4
4
Configuration des paramètres globaux d'accès aux données
Configuration du filtre de pilote
chaque pilote, les éléments <DataBase> indiquent le nom des bases de
données auxquelles Connection Server peut se connecter.
Vous devez spécifier les sources de données actives pour la méthode d'accès
que vous avez définie. Cette méthode peut être le mode bibliothèque, le
mode d'accès serveur CORBA ou les deux.
Si vous n'indiquez pas de section <ActiveDataSources> ou si vous la laissez
vide, aucun filtre n'est appliqué. Connection Server charge tous les pilotes
disponibles.
Remarque :
Vous trouverez la liste des couches réseau disponibles dans le fichier dri
ver.cfg, situé dans le répertoire connectionserver-install-dir\conne
ctionServer\. Les noms de bases de données sont des expressions
régulières qui utilisent la syntaxe regexp GNU. Utilisez le format .* pour
remplacer un caractère quelconque. Pour en savoir plus sur les expressions
régulières, voir le site Web PERL, à l'adresse http://www.perl.com/doc/ma
nual/html/pod/perlre.html#Regular_Expressions.
L'exemple illustre une configuration où Connection Server rend les bases
de données suivantes disponibles :
• toute version de MS SQL Server via une couche réseau ODBC
• toute version de MS Access via une couche réseau ODBC
• Oracle 9 et Oracle 10 via une couche réseau Oracle OCI
Outre ces paramètres, vous devez configurer ceux de la section <Distribu
tion>.
<Server>
<Parameter Name="Load Drivers On Startup">Yes</Parameter>
<Parameter Name="Max Pool Time">60</Parameter>
<Parameter Name="Transient Object Timeout">60</Parameter>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
<DataBase Name="MS Access.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 10"/>
</NetworkLayer>
</ActiveDataSources>
70
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Configuration du filtre de pilote
</Server>
Rubriques associées
•
Configuration des protocoles d'accès CORBA page 73
Définition d'une connectivité par ordinateur
Dans le cas de scénarios de déploiement complexes, vous pouvez être
amené à définir une connectivité par type d'ordinateur, par exemple si vous
voulez connecter des applications BusinessObjects Enterprise à une base
de données Microsoft SQL Server installée sous Microsoft Windows et à
une base de données Oracle installée sur un ordinateur UNIX.
Pour éviter les échecs de connexion, vous devez choisir l'une des options
suivantes :
•
lors de l'installation du logiciel BusinessObjects Enterprise, spécifiez les
connectivités à déployer pour chaque type de base de données requis
(voir illustration ci-dessous).
Guide d'accès aux données
71
4
4
Configuration des paramètres globaux d'accès aux données
Configuration du filtre de pilote
•
lors de la configuration de Connection Server dans le fichier cs.cfg,
paramétrez la section <ActiveDataSources> sur le mode Bibliothèque
(section <Library>) comme pour le mode serveur (section <Server>).
Etant donné que les applications tentent d'abord d'établir des connexions
via des pilotes installés localement, vous devez configurer de la même
façon le filtre de pilote pour les deux modes. Par exemple :
<Library>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 8"/>
</NetworkLayer>
</ActiveDataSources>
</Library>
<Server>
<Parameter Name="Load Drivers On Startup">Yes</Parameter>
<Parameter Name="Max Pool Time">60</Parameter>
<Parameter Name="Transient Object Timeout">60</Parameter>
<ActiveDataSources>
<NetworkLayer Name="ODBC">
<DataBase Name="MS SQL Server.*$"/>
72
Guide d'accès aux données
Configuration des paramètres globaux d'accès aux données
Configuration des protocoles d'accès CORBA
</NetworkLayer>
<NetworkLayer Name="Oracle OCI">
<DataBase Name="Oracle 9"/>
<DataBase Name="Oracle 8"/>
</NetworkLayer>
</ActiveDataSources>
</Server>
Configuration des protocoles d'accès
CORBA
Si Connection Server est utilisé avec CORBA, vous devez définir les
paramètres suivants de la section <Distribution> du fichier cs.cfg.
La section <Protocols> contient les valeurs par défaut utilisées par
Connection Server pour traiter les requêtes émanant de clients CORBA ou
HTTP. Pour l'accès à CORBA, vous devez configurer la section comme suit :
<Protocol Name="CORBA" Active="Yes"/>
<Protocol Name="HTTP" Active="No"/>
Guide d'accès aux données
73
4
4
Configuration des paramètres globaux d'accès aux données
Configuration des protocoles d'accès CORBA
74
Guide d'accès aux données
Configuration des
paramètres du pilote
d'accès aux données
5
5
Configuration des paramètres du pilote d'accès aux données
Configuration des paramètres du pilote
Configuration des paramètres du pilote
Pour configurer l'accès aux données d'un pilote d'accès aux données
spécifique, vous pouvez modifier la configuration des fichiers de paramètres
XML du pilote.
Remarque :
Le fichier Readme associé à chaque application Business Objects utilisant
Connection Server contient des informations sur les utilitaires de ligne de
commande qui permettent de vérifier la configuration du pilote d'accès aux
données et du SGBDR. Ces utilitaires peuvent générer des fichiers journaux
sur l'activité du serveur Web Intelligence. Consultez le fichier Readme de
cette version pour obtenir des instructions sur l'utilisation de ces utilitaires.
Rubriques associées
•
A propos des paramètres globaux page 60
Fichiers de configuration d'accès aux données
Les fichiers de configuration suivants contrôlent la configuration du pilote
d'accès aux données de chacune des connexions définies :
•
Le fichier cs.cfg définit les paramètres globaux qui s'appliquent à toutes
les connexions.
•
Il existe un fichier de configuration pour chaque pilote d'accès aux
données. Ces fichiers sont appelés <pilote>.sbo, où <pilote> est
la couche réseau de base de données à laquelle s'applique le fichier de
configuration.
Les paramètres définis dans la section Paramètres des fichiers cs.cfg
sont remplacés par les paramètres correspondants des fichiers de
configuration de pilote d'accès aux données : <pilote>.sbo.
Les fichiers de configuration se trouvent aux emplacements suivants, où
connectionserver-install-dir est le répertoire d'installation du logiciel
Connection Server.
•
76
Le fichier cs.cfg est stocké dans le répertoire suivant :
Guide d'accès aux données
Configuration des paramètres du pilote d'accès aux données
Configuration des paramètres du pilote
connectionserver-install-dir\connectionServer\
•
Chaque fichier .sbo se trouve dans un sous-répertoire appelé d'après la
couche réseau de base de données. Par exemple, dans le cas de bases
de données Oracle :
connectionserver-install-dir\connectionServer\oracle
Rubriques associées
•
•
•
A propos des paramètres globaux page 60
Fichiers SBO installés page 77
Configuration des paramètres de pilote par défaut page 61
Fichiers SBO installés
Les fichiers <pilote>.sbo suivants sont installés par défaut.
Pour obtenir la liste la plus récente des pilotes pris en charge, visitez le site
Web de SAP Service MarketPlace à l'adresse service.sap.com/bosap-support
ou contactez votre représentant Business Objects.
Pilote d'accès aux données
Fichier SBO
Essbase
essbase.sbo
db2.sbo
IBM DB2
iseries.sbo
Informix
informix.sbo
Guide d'accès aux données
77
5
5
Configuration des paramètres du pilote d'accès aux données
Configuration des paramètres du pilote
Pilote d'accès aux données
Fichier SBO
JDBC fournit les pilotes JDBC d'accès aux bases de données. Consultez le site Web de SAP Service MarketPlace ou le fichier jdbc.sbo afin jdbc.sbo
de connaître les bases de données
prises en charge pour les connexions
JDBC.
Microsoft SQL Server
odbc.sbo
Microsoft Analysis Services
oledb_olap.sbo
MySQL
Remarque :
La base de données MySQL 5 est disponible sur toutes les plateformes,
avec une prise en charge Unicode.
Assurez-vous que vous utilisez MyS- odbc.sbo
QL Connector/ODBC 5.1.4 ou version
ultérieure pour vous connecter à cette
base de données. Si vous utilisez une
version antérieure du pilote sous Unix,
vous rencontrerez des erreurs au moment de l'exécution.
78
ODBC
odbc.sbo
Oracle
oracle.sbo
Red Brick
odbc.sbo
Guide d'accès aux données
Configuration des paramètres du pilote d'accès aux données
Configuration des paramètres du pilote
Pilote d'accès aux données
Fichier SBO
SAP
sap.sbo
Sybase
sybase.sbo
Teradata
teradata.sbo
Pour afficher et modifier un fichier SBO
Attention :
Avant d'ouvrir un fichier SBO, faites une copie de sauvegarde. Certains
paramètres de configuration ne doivent pas être modifiés. Si vous modifiez
ou supprimez ces paramètres, vous risquez de provoquer un
dysfonctionnement des applications Business Objects.
Pour afficher ou modifier un fichier SBO, vous pouvez l'ouvrir comme suit :
1. Placez-vous dans le répertoire qui contient le fichier SBO du pilote d'accès
aux données cible.
2. Ouvrez le fichier SBO dans un éditeur XML.
3. Développez les sections concernées.
4. Recherchez la balise correspondant à la valeur à modifier et faites les
modifications nécessaires.
Le format des paramètres est le suivant : <Parameter Name="parame
ter">value</Parameter> où parameter est le nom du paramètre et
value est la valeur attribuée au paramètre.
5. Vérifiez la validité du fichier par rapport au fichier DTD, puis enregistrez
et fermez le fichier.
Guide d'accès aux données
79
5
5
Configuration des paramètres du pilote d'accès aux données
Configuration de l'accès aux données pour les pilotes ODBC DataDirect
Configuration de l'accès aux données
pour les pilotes ODBC DataDirect
L'accès aux données prend en charge l'utilisation de pilotes ODBC de marque
DataDirect 5.3 pour les bases de données MS SQL Server sur toutes les
plateformes UNIX. Ces pilotes de marque DataDirect sont fournis lors de
l'installation de BusinessObjects Enterprise et ne peuvent être utilisés qu'avec
des applications Business Objects comme Web Intelligence,
Desktop Intelligence et Crystal Reports.
Les middleware et pilotes suivants sont disponibles uniquement pour les
plateformes UNIX :
•
MS SQL Server 2000 SP4
Fonctionne avec le pilote DataDirect ODBC pour MS SQL Server 5.3 ou
DataDirect ODBC pour MS SQL Server 5.3.
•
MS SQL Server 2005 SP2
Fonctionne avec le pilote DataDirect ODBC pour MS SQL Server 5.3 ou
DataDirect ODBC pour MS SQL Server 5.3.
Vous trouverez les pilotes de marque DataDirect dans le répertoire boeinstall-dir/enterprise115/solaris_sparc/odbc, où boe-installdir représente le répertoire d'installation de BusinessObjects Enterprise.
Attention :
Pour utiliser le pilote de marque, vous devez vous assurer que l'accès aux
données est correctement configuré.
Pour activer l'utilisation de pilotes de marque
DataDirect
Remarque :
La section suivante concerne uniquement les bases de données MS SQL
Server 2000 SP4 et MS SQL Server 2005 SP2.
L'accès aux données prend en charge l'utilisation de pilotes ODBC
DataDirect 5.3 pour les bases de données MS SQL Server sur toutes les
plateformes UNIX. Ces pilotes peuvent être sans marque ou avec marque.
80
Guide d'accès aux données
Configuration des paramètres du pilote d'accès aux données
Configuration de l'accès aux données pour les pilotes ODBC DataDirect
Les paramètres par défaut de Connection Server permettent au pilote ODBC
sans marque de fonctionner en transparence avec vos paramètres de
configuration actuels. Si vous avez déjà déployé un pilote dans votre
environnement, vous pourrez installer le pilote n'ayant pas de marque sans
avoir à modifier la configuration.
1. Accédez au répertoire contenant le fichier odbc.sbo.
Sous UNIX, ce fichier de configuration se trouve dans le répertoire co
nnectionserver-install-dir/connectionServer/odbc.
2. Utilisez un éditeur XML pour ouvrir le fichier odbc.sbo à modifier.
3. Recherchez la section DataBase appropriée.
Le paramètre Use DataDirect OEM Driver de la section DataBase est
défini sur No par défaut. Cela signifie que l'accès aux données est
configuré par défaut pour fonctionner avec les pilotes sans marque.
4. Définissez le paramètre Use DataDirect OEM Driver de la section Da
taBase appropriée sur Yes.
Connection Server peut établir une connexion aux bases de données
MS SQL Server avec des pilotes ODBC de marque DataDirect.
Exemple :
Vous trouverez ci-dessous un extrait du fichier odbc.sbo par défaut.
<DataBases>
<DataBase Active="Yes" Name="MS SQL Server 2005">
<Libraries>
...
</Libraries>
<Parameter Name="Family">Microsoft</Parameter>
...
<Parameter Name="Use DataDirect OEM Driver" Plat
form="Unix">No</Parameter>
...
</DataBase>
</DataBases>
Guide d'accès aux données
81
5
5
Configuration des paramètres du pilote d'accès aux données
Configuration de l'accès aux données pour les pilotes ODBC DataDirect
82
Guide d'accès aux données
Paramètres SBO –
Informations de référence
6
6
Paramètres SBO – Informations de référence
Catégories de paramètres SBO
Catégories de paramètres SBO
Dans ce guide, les paramètres de configuration sont classés selon les
catégories suivantes. Chaque catégorie représente une base de données
possédant un fichier sbo distinct.
•
Défaut
•
Informix
•
JavaBean
•
JDBC
•
ODBC
•
OLE DB
•
OLE DB OLAP
•
Sybase ASE/CTLIB
Chaque paramètre figure avec les informations suivantes :
•
exemple de la façon dont le paramètre apparaît dans le fichier XML
•
description du paramètre
•
valeurs possibles qui peuvent être définies pour le paramètre
•
valeur par défaut pour le paramètre
Structure du fichier SBO
Il existe un fichier <pilote>.sbo pour chaque couche réseau de base de
données prise en charge. Chaque fichier <pilote>.sbo est divisé en
sections :
84
Guide d'accès aux données
Paramètres SBO – Informations de référence
Structure du fichier SBO
Section File
Description
Defaults
Cette section contient les paramètres de configuration par défaut qui s'appliquent à tous les middleware de base de données utilisant le pilote
d'accès aux données. Ces paramètres remplacent
les ensembles de valeurs correspondants du
middleware de base de données.
Guide d'accès aux données
85
6
6
Paramètres SBO – Informations de référence
Structure du fichier SBO
Section File
Description
Cette section contient une sous-section pour chacun des middleware de base de données pris en
charge par le pilote d'accès aux données. Le paramètre Active spécifie si la prise en charge du
middleware est activée ou non.
Les valeurs sont YES et NO.
Chaque section consacrée à un middleware peut
contenir les paramètres suivants :
• Name : noms des middleware pris en charge
par le pilote d'accès aux données. Les valeurs
de noms de middleware définies ici apparaissent dans la page Sélection du middleware de
base de données dans l'Assistant de création
de connexion.
•
Aliases : noms des versions antérieures des
middleware qui ne sont plus officiellement pris
en charge par le pilote d'accès aux données,
mais qui sont encore utilisés. Vous pouvez
ajouter un paramètre alias pour une version de
middleware antérieure de sorte que les connexions existantes utilisent plutôt le pilote
d'accès aux données actuel. Vous pouvez définir en guise de paramètres du nouvel alias,
les paramètres de configuration spécifiques à
l'ancien middleware. Vous pouvez créer de
nouvelles connexions à l'aide de l'alias.
•
Parameters : paramètres de configuration avec
des valeurs qui s'appliquent spécifiquement à
un middleware. Les valeurs définies pour les
paramètres répertoriés ici prévalent sur les
valeurs définies pour les mêmes paramètres
dans la section Defaults.
Databases
86
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Paramètres SBO par défaut
Les paramètres SBO par défaut sont définis dans le fichier cs.cfg ou dans
la section Defaults du fichier SBO.
Rubriques associées
•
Catégories de paramètres SBO page 84
Array Bind Available
<Parameter Name="Array Bind Available">True</Parameter>
Description
Spécifie si la base de données prend en charge Array
Binds.
True : la base de données prend en charge Array Binds.
Valeurs
False : la base de données ne prend pas en charge
Array Binds.
Par défaut
False
Array Bind Size
<Parameter Name="Array Bind Size">5</Parameter>
Description
Spécifie le nombre de lignes exportées avec chaque
commande INSERT.
Guide d'accès aux données
87
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Valeurs
Nombre entier qui spécifie le nombre de lignes exportées avec chaque commande INSERT.
Par défaut
Valeur définie dans le fichier cs.cfg.
Array Fetch disponible
<Parameter Name="Array Fetch Available">True</Parameter>
Description
Spécifie si la méthode Array Fetch est prise en charge.
True : la méthode Array Fetch est prise en charge.
Valeurs
False : la méthode Array Fetch n'est pas prise en
charge.
Par défaut
Valeur définie dans le fichier cs.cfg.
Array Fetch Size
<Parameter Name="Array Fetch Size">10</Parameter>
88
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Description
Spécifie le nombre de lignes extraites avec chaque
méthode Array Fetch. Le nombre optimal dépend des
performances du système :
• Si le chiffre est peu élevé, le système extrait plus
souvent de petits volumes de données. Cela peut
avoir une incidence sur les performances.
•
Valeurs
Si le chiffre est élevé, le système effectue moins
d'extractions mais chaque opération demande
davantage de mémoire.
Nombre entier qui spécifie le nombre de lignes extraites avec chaque Array Fetch.
l : spécifie que l'Array Fetch est désactivé.
Par défaut
Valeur définie dans le fichier cs.cfg.
Taille maximale du nom de catalogue
<Parameter Name="Catalog Name Max Size">1024</Parameter>
Description
Spécifie la longueur maximale en caractères du nom
de catalogue d'une base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom de catalogue d'une base de données.
Par défaut
La valeur définie dans le middleware de base de données.
Guide d'accès aux données
89
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Séparateur de catalogue
<Parameter Name="Catalog Separator">-</Parameter>
Description
Spécifie le caractère de séparation utilisé entre les
identificateurs.
Valeurs
Le caractère de séparation à utiliser.
Par défaut
Si aucun caractère n'est spécifié, Connection Server
utilise le séparateur spécifié dans le middleware de
base de données.
Jeu de caractères
<Parameter Name="CharSet">UTF8</Parameter>
Description
Spécifie le jeu de caractères des données renvoyées
par le middleware de base de données.
UTF8 : format de transformation UCS/Unicode 8 bits
Valeurs
UCS2 : UCS 2 bits
Par défaut
90
Guide d'accès aux données
Si aucun caractère n'est spécifié, Connection Server
utilise le séparateur spécifié dans le middleware de
base de données.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Taille maximale du nom de colonne
<Parameter Name="Column Name Max Size">1024</Parameter>
Description
Spécifie la taille maximale en caractères du nom de
colonne d'une base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom de colonne d'une base de données.
Par défaut
La valeur définie dans le middleware de base de données.
Connexion partageable
<Parameter Name="Connection Shareable">False</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Indique si une connexion peut être partagée entre
différents utilisateurs. Fonctionne conjointement avec
le paramètre Connexion partagée.
True : la connexion peut être partagée entre plusieurs
utilisateurs.
Valeurs
False : la connexion ne peut pas être partagée entre
les utilisateurs.
Par défaut
False
Guide d'accès aux données
91
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Rubriques associées
•
Connexion partagée page 104
Coût estimé disponible
<Parameter Name="Cost Estimate Available">False</Parameter>
Description
Spécifie si le middleware de base de données prend
en charge l'estimation du coût.
True : le middleware prend en charge l'estimation du
coût.
Valeurs
False : le middleware ne prend pas en charge l'estimation du coût.
Par défaut
False
Description File
<Parameter Name="Description File">oracle</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
92
Guide d'accès aux données
Spécifie le nom du fichier dans lequel se trouvent les
étiquettes de champs d'entrée de l'assistant de connexion.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Capacités du pilote
<Parameter Name="Driver Capabilities">Procedures , Query</Para
meter>
La capacité du pilote à accéder ou non aux procédures et requêtes stockées dans le logiciel de base
de données. Ce paramètre est généralement défini à
l'aide de l'Assistant de création de connexion. Vous
pouvez inclure les deux valeurs dans le paramètre.
Description
Remarque :
Ce paramètre doit être défini sur Procedures pour un
pilote JavaBean. Pour les applications Business Objects, la fonctionnalité d'un pilote JavaBean est définie
en tant que procédures stockées.
Procedures : le pilote peut accéder aux procédures
d'extraction des données définies dans le logiciel de
la base de données.
Valeurs
Query : le pilote peut accéder aux requêtes d'extraction des données définies dans le logiciel de base de
données.
Par défaut
Procedures
Caractère d'échappement
<Parameter Name="Escape Character">-</Parameter>
Guide d'accès aux données
93
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Description
Spécifie le caractère d'échappement à utiliser dans
les chaînes de caractères spéciaux, comme les
schémas.
Valeurs
Le caractère à utiliser comme caractère d'échappement.
Par défaut
Si aucun caractère n'est spécifié, Connection Server
extrait la valeur du middleware.
Extensions
<Parameter Name="Extensions"></Parameter>
Description
Remarque :
La configuration de ce paramètre ne doit pas être modifiée.
Family
<Parameter Name="Family">Sybase</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
94
Guide d'accès aux données
Spécifie la famille de moteur de base de données affichée dans la page Sélection du middleware de base
de données dans l'Assistant de création de connexion.
L'ensemble de middleware qui correspond à la licence
est affiché sur cette page dans une vue arborescente.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Facteur de taille de champ
<Parameter Name="Field Size Factor ">1</Parameter>
Remarque :
Cette valeur ne doit pas être modifiée.
Description
La valeur à utiliser pour calculer la taille du contenu
renvoyé, exprimée en caractères de champs lorsque
le contenu renvoyé est en octets. Utilisé uniquement
pour DB2.
Forcer l'exécution
<Parameter Name="Force Execute">Never</Parameter>
Description
Spécifie si la requête SQL est exécutée ou non avant
l'extraction des résultats. Ce paramètre est pris en
charge par les éléments suivants :
• ODBC
• OLE
• DB
• JDBC
Never : la requête SQL n'est jamais exécutée avant
l'extraction des résultats.
Valeurs
Procedures : l'exécution n'a lieu que pour les procédures stockées.
Always : la requête SQL est systématiquement exécutée avant l'extraction des résultats.
Guide d'accès aux données
95
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Par défaut
Never
Casse de l'identificateur
<Parameter Name="Identifier Case">LowerCase</Parameter>
Description
Spécifie comment la base de données gère le comportement de casse des identificateurs simples.
LowerCase : les identificateurs doivent être en minuscules.
UpperCase : les identificateurs doivent être en majuscules.
Valeurs
MixedCase : les identificateurs peuvent être en minuscules et en majuscules.
SensitiveCase : les identificateurs respectent la distinction majuscules/minuscules.
Par défaut
Si ce paramètre n'est pas spécifié, Connection Server
extrait l'information du middleware de base de données.
Chaîne de signal des identificateurs
<Parameter Name="Identifier Quote String">-</Parameter>
Description
96
Guide d'accès aux données
Spécifie le caractère utilisé pour signaler les identificateurs.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Valeurs
Le caractère utilisé pour signaler les identificateurs.
Par défaut
Si ce paramètre n'est pas spécifié, Connection Server
extrait l'information du middleware de base de données.
Clause d'échappement LIKE
<Parameter Name="Identifier Case">True</Parameter>
Description
Spécifie si l'utilisation du caractère d'échappement
est prise en charge par la clause LIKE.
True : l'utilisation du caractère d'échappement est
prise en charge par la clause LIKE.
Valeurs
False : l'utilisation du caractère d'échappement n'est
pas prise en charge par la clause LIKE.
Par défaut
Si ce paramètre n'est pas spécifié, Connection Server
extrait l'information du middleware de base de données.
Paramètres régionaux
<Parameter Name="Locale">en_us</Parameter>
Description
Spécifie le paramètre régional du middleware.
Guide d'accès aux données
97
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Valeurs
Le paramètre régional du middleware.
• La langue est spécifiée selon la norme ISO-639.
• Le pays est spécifié selon la norme ISO-3166.
Par exemple, en_US pour l'anglais des Etats-Unis.
Par défaut
Si ce paramètre n'est pas spécifié, Connection Server
extrait l'information du middleware de base de données.
Nombre maximal de lignes disponibles
<Parameter Name="Max Rows Available">True</Parameter>
Description
Spécifie si le pilote prend en charge la fonction Nombre max. de lignes extraites pour limiter le nombre
maximal de lignes pouvant être extraites d'une source
de données.
True : le pilote prend en charge la fonction Nombre
max. de lignes extraites.
Valeurs
False : le pilote ne prend pas en charge la fonction
Nombre max. de lignes extraites.
Par défaut
False
Optimize Execute
<Parameter Name="Optimize Execute">False</Parameter>
98
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Description
Spécifie si Connection Server optimise ou non l'exécution des requêtes SQL. Ce paramètre n'est pris en
charge que par les pilotes Oracle et ODBC.
True : spécifie que l'exécution des requêtes SQL est
optimisée lorsque c'est possible.
Valeurs
False : spécifie que l'exécution des requêtes SQL
n'est pas optimisée.
Par défaut
False
Propriétaires disponibles
<Parameter Name="Owners Available">True</Parameter>
Description
Spécifie si la base de données cible prend ou non en
charge les propriétaires.
True : spécifie que la base de données cible prend
en charge les propriétaires.
Valeurs
False : spécifie que la base de données cible ne
prend pas en charge les propriétaires.
Par défaut
Non spécifié : la valeur est extraite du middleware de
base de données.
Guide d'accès aux données
99
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Cryptage du mot de passe
<Parameter Name="Password Encryption">True</Parameter>
Description
Indique si le mécanisme de cryptage du mot de passe
spécifié dans le middleware doit être utilisé pour le
mot de passe saisi dans la boîte de dialogue Détails
sur la connexion. Ce paramètre est uniquement utilisé avec Sybase. Il se trouve dans la section Defaults
pour des raisons de compatibilité avec les versions à
venir.
True : spécifie que le mécanisme de cryptage de mot
de passe du middleware est utilisé.
Valeurs
False : spécifie que le mécanisme de cryptage de
mot de passe du middleware n'est pas utilisé.
Par défaut
Vrai
Taille maximale du nom de procédure
<Parameter Name="Procedure Name Max Size">1024</Parameter>
100
Description
Spécifie la longueur maximale en caractères du nom
de procédure d'une base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom de procédure d'une base de données.
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Par défaut
La valeur définie dans le middleware de base de données.
Taille maximale du nom de paramètre de procédure
<Parameter Name="Procedure Parameter Name Max Size">1024</Para
meter>
Description
Spécifie la longueur maximale en caractères du nom
du paramètre de procédure d'une base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom du paramètre de procédure d'une base
de données.
Par défaut
La valeur définie dans le middleware de base de données.
Qualificateurs disponibles
<Parameter Name="Qualifiers Available">True</Parameter>
Description
Spécifie si les qualificateurs sont pris en charge ou
non.
Guide d'accès aux données
101
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
True : spécifie que les qualificateurs sont pris en
charge.
Valeurs
False : spécifie que les qualificateurs ne sont pas pris
en charge.
Par défaut
Non spécifié. Connection Server extrait les informations du middleware de base de données.
Expiration de la requête disponible
<Parameter Name="Query TimeOut Available">True</Parameter>
Description
Spécifie si le middleware de base de données prend
en charge ou non l'expiration de la requête, c'est-àdire si une requête en cours d'exécution peut être
annulée après un certain délai.
True : spécifie que le middleware de base de données
prend en charge l'expiration de la requête.
Valeurs
False : spécifie que le middleware de base de données ne prend pas en charge l'expiration de la requête.
Par défaut
False
Casse d'identificateur entre guillemets
<Parameter Name="Quoted Identifier Case Available">True</Para
meter>
102
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Description
Spécifie comment la base de données gère la casse
des identificateurs entre guillemets.
LowerCase : les identificateurs entre guillemets
doivent être en minuscules.
UpperCase : les identificateurs entre guillemets
doivent être en majuscules.
Valeurs
MixedCase : les identificateurs entre guillemets
peuvent être en minuscules et en majuscules.
SensitiveCase : les identificateurs entre guillemets
respectent la distinction majuscules/minuscules.
Par défaut
Non spécifié. Connection Server extrait les informations du middleware de base de données.
Taille maximale du nom de schéma
<Parameter Name="Schema Name Max Size">1024</Parameter>
Description
Spécifie la longueur maximale en caractères du nom
de schéma de la base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom de schéma de la base de données.
Par défaut
La valeur définie dans le middleware de base de données.
Guide d'accès aux données
103
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Connexion partagée
<Parameter Name="Shared Connection">True</Parameter>
Description
Indique si la demande de pool de connexions est
partagée. Fonctionne conjointement avec le paramètre
Connexion partageable. N'est pas pris en compte
si le paramètre Max Pool Time de cs.cfg est défini
sur 0.
True : la connexion est partagée.
Valeurs
False : la connexion n'est pas partagée.
Par défaut
False
Rubriques associées
•
•
Max Pool Time page 65
Connexion partageable page 91
Fichier SQL externe
<Parameter Name="SQL External File">filename</Parameter>
Remarque :
Ne modifiez pas cette valeur.
Description
104
Guide d'accès aux données
Le fichier SQL externe renferme des informations de
configuration utilisées par la couche d'accès aux données.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
SQL Parameter File
<Parameter Name="SQL Parameter File">oracle</Parameter>
Le nom du fichier qui stocke les paramètres de la base
de données. Ce fichier porte l'extension .prm
Description
Vous devez vous assurer que ce fichier se trouve
dans le même répertoire que le fichier de configuration
des données (fichier .sbo).
Guide d'accès aux données
105
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
datafederator pour BusinessObjects Data Federator
neoview pour HP Neoview
essbase pour Hyperion Essbase
db2iseries pour IBM DB2 iSeries
db2udb pour IBM DB2
informix pour Informix
ingres pour Ingres
access pour Microsoft Access
sqlsrv pour Microsoft SQL Server 2000
mysql pour MySQL
Valeurs
netezza pour Netezza Server
openaccess pour OpenAccess
oracle pour Oracle
postgresql pour Greenplum et PostgreSQL
progress pour Progress 10
redbrick pour Red Brick Decision Server
sybase pour Sybase
asiq pour Sybase ASIQ
ssa pour Sybase SQL Anywhere
teradata pour Teradata
Par défaut
106
Guide d'accès aux données
Valeurs de la liste.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Connexion unique disponible
<Parameter Name="SSO Available">False</Parameter>
Description
Spécifie si la connexion unique est prise en charge
ou non.
True : la connexion unique est prise en charge.
Valeurs
False: la connexion unique n'est pas prise en charge.
Par défaut
False
Strategies File
<Parameter Name="Strategies File">oracle</Parameter>
Description
Spécifie le nom sans extension du fichier de stratégie
(.stg). Ce fichier contient les stratégies externes que
Universe Designer utilise pour la création automatique
d'univers. Les fichiers de stratégie se trouvent dans
le même répertoire que le fichier .sbo.
db2 pour les pilotes d'accès aux données DB2.
informix pour Informix.
Valeurs
oracle pour Oracle.
sybase pour Sybase.
teradata pour Teradata.
Guide d'accès aux données
107
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Par défaut
Voir les valeurs ci-dessus.
Taille maximale du nom de table
<Parameter Name="Table Name Max Size">1024</Parameter>
Description
Spécifie la longueur maximale en caractères du nom
de table d'une base de données.
Valeurs
Un entier spécifiant la longueur maximale en caractères du nom de table d'une base de données.
Par défaut
La valeur définie dans le middleware de base de données.
Mode de transaction disponible
<Parameter Name="Transactional Available">Yes</Parameter>
Spécifie si les opérations SQL exécutées sur la base
de données sont traitées comme transactions groupées ou individuelles.
Description
108
Guide d'accès aux données
Par défaut, ce paramètre ne figure pas dans le fichier
.sbo. Ajoutez-le au fichier .sbo si le pilote d'accès
aux données ne prend pas en charge le mode de
transaction.
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Yes : les opérations exécutées sur la base de données
sont traitées en tant que groupe lorsqu'elles sont validées.
Valeurs
No : chaque instruction SQL est immédiatement validée. Concrètement, l'option Autocommit est désactivée.
Remarque :
N'utilisez pas de pilote avec Transactional Avai
lable=No pour accéder au référentiel Business Objects.
Par défaut
Yes. Valeur définie dans le fichier cs.cfg.
Mode de transaction
<Parameter Name="Transaction Mode">AutoCommit</Parameter>
Description
Spécifie le mode de transaction employé par la base
de données.
AutoCommit : les instructions sont automatiquement
enregistrées à l'issue d'une requête.
Valeurs
Transactional : un appel explicite exécute ou renvoie
l'instruction à l'issue de la requête.
Par défaut
En l'absence de spécification, la valeur est extraite
du middleware de base de données.
Guide d'accès aux données
109
6
6
Paramètres SBO – Informations de référence
Paramètres SBO par défaut
Type
<Parameter Name="Type">Relational</Parameter>
Spécifie le type de la source de données.
Description
Remarque :
Ne modifiez pas ce paramètre.
Version
<Parameter Name="Version">Relational</Parameter>
Spécifie la version de la base de données.
Description
Remarque :
Ne modifiez pas ce paramètre.
Taille maximale des données XML
<Parameter Name="XML Max Size">2048</Parameter>
110
Description
Spécifie la taille maximale autorisée pour les données
XML.
Valeurs
La taille des données XML maximale autorisée, en
octets.
Par défaut
Ce paramètre dépend de la base de données.
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO d'Informix
Paramètres SBO d'Informix
Ces paramètres s'appliquent au fichier SBO d'Informix. Ils servent à définir
la connexion à une base de données Informix.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\informix\informix.sbo.
Remarque :
En plus des paramètres SBO, vous devez modifier le fichier ODBC.ini pour
Informix dans un environnement Unix.
Rubriques associées
•
•
V5toV6DriverName page 112
Pour modifier le fichier ODBC.INI Informix page 111
Pour modifier le fichier ODBC.INI Informix
Pour pouvoir utiliser la couche d'accès aux données avec une base de
données Informix dans un environnement UNIX, vous devez modifier la
configuration Unicode. Les informations de configuration peuvent se trouver
à l'un des deux emplacements suivants :
• Le fichier .odbc.ini situé dans votre répertoire racine.
•
Le fichier spécifié par la variable d'environnement ODBCINI.
1. Repérez le fichier ODBC.ini ou le fichier spécifié par la variable
d'environnement ODBCINI et ouvrez-le dans un éditeur de texte.
2. Dans ce fichier, repérez la section [ODBC].
3. Ajoutez la ligne suivante à la section [ODBC] :
UNICODE=UTF-8
4. Enregistrez le fichier et fermez-le.
Guide d'accès aux données
111
6
6
Paramètres SBO – Informations de référence
Paramètres SBO d'Informix
Exemple : Section ODBC après configuration
Ce code est un exemple de la section ODBC après ajout des informations
correctes :
[ODBC]
UNICODE=UTF-8
V5toV6DriverName
<Parameter Name="V5toV6DriverName">{Informix 3.34 32 BIT}</Pa
rameter>
Description
Spécifie la règle de conversion d'Informix Connect en
Informix ODBC. La valeur de ce paramètre détermine
quel pilote Informix est utilisé pour définir le nom de
la source de données ODBC (DSN) sans la chaîne
de connection.
Valeurs
Le nom exact du pilote Informix installé sur l'ordinateur.
Par défaut
Valeur définie dans le fichier cs.cfg.
Unicode
<Parameter Name="Unicode">CharSet</Parameter>
112
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO JavaBean
Description
Spécifie si le pilote d'accès aux données peut bénéficier de la configuration Unicode du middleware client.
Ce paramètre apparaît comme paramètre par défaut
du pilote dans le fichier cs.cfg. Sa valeur s'applique
à tous les pilotes d'accès aux données. Par défaut,
ce paramètre ne figure pas dans le fichier SBO. Pour
remplacer la valeur par défaut, ajoutez-la à la section
Defaults du fichier SBO pour le pilote d'accès aux
données cible.
UTF8 : encodage du format de transformation
UCS/Unicode 8 bits.
Valeurs
CharSet : encodage du jeu de caractères.
UCS2 : encodage du jeu de caractères 2 bits Universal Character Set.
Par défaut
Valeur définie dans le fichier cs.cfg.
Paramètres SBO JavaBean
Ces paramètres s'appliquent au fichier SBO de JavaBean. Ils servent à définir
la connexion à JavaBean.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\javabean\javaean.sbo.
Classe JavaBean
<Parameter Name="JavaBean Class">string</Parameter>
Guide d'accès aux données
113
6
6
Paramètres SBO – Informations de référence
Paramètres SBO JavaBean
Description
Définit le point d'entrée du JavaBean que l'application
Business Objects utilise. Le point d'entrée est la définition d'une classe Java allant de l'interface Bean
spécifiée au package com.businessobjects.
Valeurs
Le nom de classe JavaBean d'une classe complète.
Par défaut
Aucune.
Format d'URL
<Parameter Name="URL Format ">string</Parameter>
Spécifie le format de l'URL.
Description
La spécification JDBC n'indique pas le format de la
chaîne de connexion qu'elle requiert. Les fournisseurs
utilisent différents types de formats d'URL. En voici
quelques exemples :
• Fournisseur MySQL :
jdbc:mysql://$DATASOURCE$/$DATABASE$
•
Fournisseur Oracle :
jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$
114
Valeurs
Le format de l'URL
Par défaut
Aucune
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO JDBC
Paramètres SBO JDBC
Ces paramètres s'appliquent au fichier SBO de JDBC. Ils servent à définir la
connexion JDBC.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\jdbc\jdbc.sbo.
Clés étrangères disponibles
<Parameter Name="ForeignKeys Available">True</Parameter>
Description
Spécifie si les clés étrangères
peuvent être extraites.
True : les clés étrangères peuvent
être extraites.
Valeurs
False : les clés étrangères ne
peuvent pas être extraites.
Par défaut
True
Classe JDBC
<Parameter Name="JDBC Class">string</Parameter>
Description
La classe Java complète du pilote JDBC.
Guide d'accès aux données
115
6
6
Paramètres SBO – Informations de référence
Paramètres SBO ODBC
Valeurs
Dépend du fournisseur/de la source de données, par
exemple :
• oracle.jdbc : OracleDriver pour Oracle
•
Par défaut
com.ibm.db2.jcc.DB2Driver : pour DB2
Aucune.
Clés primaires disponibles
<Parameter Name="PrimaryKey Available">True</Parameter>
Description
Spécifie si les clés primaires peuvent être extraites
ou non.
True : les clés primaires peuvent être extraites.
Valeurs
False : les clés primaires ne peuvent pas être extraites.
Par défaut
True
Paramètres SBO ODBC
Ces paramètres s'appliquent au fichier SBO d'ODBC. Ils servent à définir la
connexion SBO ODBC.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\odbc\odbc.sbo.
116
Guide d'accès aux données
Paramètres SBO – Informations de référence
Paramètres SBO ODBC
Statut de connexion disponible
<Parameter Name="Connection Status Available">True</Parameter>
Description
Spécifie si le middleware peut ou non détecter les
connexions incorrectes.
True : le middleware peut détecter les connexions
incorrectes.
Valeurs
False : le middleware ne peut pas détecter les connexions incorrectes.
Par défaut
La valeur définie dans le middleware.
Chaîne vide
<Parameter Name="Empty String">NullString</Parameter>
Description
Spécifie si certaines fonctions telles que les tables
SQL reçoivent une chaîne vide ou un pointeur nul
pour remplacer les paramètres manquants.
NullString : spécifie qu'un pointeur nul est utilisé.
Valeurs
EmptyString : spécifie qu'une chaîne vide est utilisée.
Par défaut
EmptyString
Guide d'accès aux données
117
6
6
Paramètres SBO – Informations de référence
Paramètres SBO ODBC
Forcer la fermeture de l'instruction
<Parameter Name="Force Close Statement">True</Parameter>
Description
Spécifie que l'instruction SQL doit être fermée une
fois l'exécution terminée.
True : l'instruction SQL est fermée après l'exécution.
Valeurs
False : l'instruction SQL n'est pas fermée après
l'exécution.
Native Int64 Available
<Parameter Name="Native Int64 Available">False</Parameter>
Description
Spécifie si le middleware peut gérer directement les
entiers 64 bits.
True : spécifie que le middleware gère les entiers
64 bits.
Valeurs
False : la couche d'accès aux données émule les
méthodes Int64.
Par défaut
118
Guide d'accès aux données
True
Paramètres SBO – Informations de référence
Paramètres SBO ODBC
ODBC Cursors
<Parameter Name="ODBC Cursors">No</Parameter>
Description
Spécifie si le pilote d'accès aux données utilise la bibliothèque de curseurs ODBC.
Yes : le pilote d'accès aux données utilise la bibliothèque de curseurs ODBC.
Valeurs
No : le pilote d'accès aux données n'utilise pas la bibliothèque de curseurs ODBC.
Par défaut
Valeur définie dans le fichier cs.cfg.
SQLDescribeParam disponible
<Parameter Name="SQLDescribeParam Available">True</Parameter>
Description
Spécifie si le mécanisme SQLDescribeParam Availableest disponible.
True : spécifie que le mécanisme SQLDescribeParam
Available est disponible.
Valeurs
False : spécifie que le mécanisme SQLDescribeParam Available n'est pas disponible.
Par défaut
La valeur définie dans le middleware de base de données.
Guide d'accès aux données
119
6
6
Paramètres SBO – Informations de référence
Paramètres SBO ODBC
SQLMoreResults disponible
<Parameter Name="SQLMoreResults Available">True</Parameter>
Description
Spécifie si le mécanisme SQLMoreResults Available
est pris en charge ou non.
True : spécifie que le mécanisme SQLMoreResults
Available est pris en charge.
Valeurs
False : spécifie que le mécanisme SQLMoreResults
Available n'est pas pris en charge.
Par défaut
La valeur définie dans le middleware.
Utilisation du pilote OEM DataDirect
<Parameter Name="Use DataDirect OEM Driver">No</Parameter>
Description
Indique si les connexions aux bases de données MS
SQL Server utilisent des pilotes ODBC de marque
DataDirect.
Yes : la connexion utilise le pilote de marque.
Valeurs
No : la connexion n'utilise pas le pilote de marque.
Par défaut
120
Guide d'accès aux données
No
Paramètres SBO – Informations de référence
Paramètres SBO OLE DB
Rubriques associées
•
Configuration de l'accès aux données pour les pilotes ODBC DataDirect
page 80
Paramètres SBO OLE DB
Ces paramètres s'appliquent au fichier SBO d'OLE DB. Ils servent à définir
la connexion SBO OLE DB.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\oledb\oledb.sbo.
Enumerator CLSID
<Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Parame
ter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Indique l'ID de classe de l'énumérateur OLEDB. Ce
paramètre est utilisé seulement avec OLEDB.
Provider CLSID
<Parameter Name="Provider CLSID">MSDASQL</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Indique l'ID de classe du fournisseur OLEDB. Ce paramètre est utilisé seulement avec OLEDB.
Guide d'accès aux données
121
6
6
Paramètres SBO – Informations de référence
Paramètres SBO OLE DB OLAP
Paramètres SBO OLE DB OLAP
Ces paramètres s'appliquent au fichier SBO OLE_DB OLAP. Ils servent à
définir la connexion SBO OLE DB pour OLAP.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\sqlsrv_as\oledb_olap.sbo.
MSOlap CLSID
<Parameter Name="MSOlap CLSID">msolap.4</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Indique l'ID de classe du fournisseur OLEDB. Ce paramètre est utilisé avec OLEDB OLAP uniquement.
Sybase ASE/CTLIB
Ces paramètres s'appliquent au fichier SBO de Sybase ASE/CTLIB. Ils
servent à définir la connexion Sybase ASE/CTLIB.
Ils sont définis dans le fichier \\connectionserver-install-dir\connec
tionServer\sybase\sybase.sbo.
Identificateur entre guillemets
<Parameter Name="Quoted Identifier">True</Parameter>
Description
122
Guide d'accès aux données
Spécifie si les identificateurs entre guillemets sont pris
en charge ou non.
Paramètres SBO – Informations de référence
Sybase ASE/CTLIB
True : les identificateurs entre guillemets sont pris en
charge.
Valeurs
False : les identificateurs entre guillemets ne sont pas
pris en charge.
Par défaut
La valeur définie dans le middleware.
Guide d'accès aux données
123
6
6
Paramètres SBO – Informations de référence
Sybase ASE/CTLIB
124
Guide d'accès aux données
Configuration des
paramètres de génération
SQL
7
7
Configuration des paramètres de génération SQL
A propos des paramètres de génération SQL
A propos des paramètres de génération
SQL
Les paramètres de génération SQL contrôlent les requêtes SQL générées
pour extraire le contenu d'un univers.
Les paramètres de génération SQL peuvent être définis pour opérer à
plusieurs niveaux :
• Au niveau de l'univers : ils sont définis lors de la création ou de la
modification d'un univers.
• Au niveau de la base de données : ces paramètres sont définis dans le
fichier PRM pour la base de données. Ils sont remplacés par les
paramètres correspondants du fichier PRM au niveau de l'univers.
Pour visualiser les opérateurs de date, les autres opérateurs et les fonctions
disponibles pour le pilote d'accès aux données, ouvrez le fichier <pilote>.prm
dans un éditeur XML.
A propos des fichiers PRM
Les fichiers .prm contiennent des paramètres qui contrôlent la façon dont
les applications Business Objects génèrent le SQL. Un fichier .prm
correspond à chaque pilote de base de données. Les fichiers .prm permettent
aux facteurs dépendant de la base de données de contrôler la façon dont
un univers génère le SQL, en fonction de la connexion et de la base de
données associées.
Vous pouvez également configurer certains paramètres de génération SQL
lorsque vous vous trouvez dans l'univers. Les paramètres définis depuis
l'univers lui-même remplacent ceux du fichier .prm.
Le fichier .prm de chaque pilote se trouve dans le répertoire connectionser
ver-install-dir\connectionServer\<SGBDR>, où <SGBDR> représente le
nom de la base de données.
Les fichiers <pilote>.prm suivants sont disponibles :
126
Guide d'accès aux données
Configuration des paramètres de génération SQL
A propos des fichiers PRM
Pilote d'accès aux doFichiers PRM
nnées
Fichiers PRM de texte
d'aide (Anglais)
Datafederator
datafederator.prm
datafederatoren.prm
Essbase
essbase.prm
essbaseen.prm
HSQLDB
hsqldn.prm
hsqldben.prm
db2udb.prm
db2udben.prm
db2mvs.prm
db2mvsen.prm
db2iseries.prm
db2iseriesen.prm
Informix
informix.prm
informixen.prm
Javabean
javabean.prm
javabeanen.prm
JDBC
jdbc.prm
jdbcen.prm
IBM DB2
sqlsrv7.prm pour SQL
Server 7 et 2000.
Microsoft SQL Server
sqlsrv.prm pour SQL
sqlsrv7en.prm
Server 2005.
sqlsrven.prm
sqlsrv_as.rm
pour Analysis Services.
Microsoft Jet
msjet.prm
msjeten.prm
MySQL
mysql.prm
mysqlen.prm
Guide d'accès aux données
127
7
7
Configuration des paramètres de génération SQL
A propos des fichiers PRM
Pilote d'accès aux doFichiers PRM
nnées
Fichiers PRM de texte
d'aide (Anglais)
Neoview
neoview.prm
neoviewen.prm
Netezza
netezza.prm
netezzaen.prm
odbc.prm
odbcen.prm
access.prm
accessen.prm
Open
open.prm
openen.prm
Open Access
openaccess.prm
openaccessen.prm
ODBC
oracle9.prm pour
Oracle 9.
Oracle
oracle9en.prm
Oracle 10 et versions
supérieures.
oracleen.prm
PostgreSQL
postgresql.prm
postgresqlen.prm
Progress
progress.prm
progressen.prm
Red Brick
redbrick.prm
redbricken.prm
asiq.prm
asiqen.prm
sybase11.prm
sybase11en.prm
sybase.prm
sybaseen.prm
Sybase
128
oracle.prm pour
Guide d'accès aux données
Configuration des paramètres de génération SQL
A propos des fichiers PRM
Pilote d'accès aux doFichiers PRM
nnées
Fichiers PRM de texte
d'aide (Anglais)
SAP
sap.prm
sapen.prm
Teradata
teradata.prm
teradataen.prm
Les fichiers <pilote>.prm sont au format XML. Utilisez un éditeur XML pour
visualiser et modifier les valeurs de ces fichiers si nécessaire.
Structure du fichier de paramètres PRM
Il existe un fichier <pilote>.prm pour chaque middleware de SGBDR pris en
charge. Chaque fichier <pilote>.prm est divisé en sections : Chaque section
contient des paramètres dont les valeurs sont définies par défaut :
Section File
Description
Configuration
Les paramètres SQL utilisés pour créer et optimiser un
univers, par exemple COMMA, OUTERJOINS_GENERATION, REVERSE_TABLE_WEIGHT. Ces paramètres ne
sont pas directement disponibles dans les produits Business Objects. Ils sont décrits dans ce chapitre.
Les opérateurs de date disponibles dans Universe DesiDateOperations gner, Desktop Intelligence et Web Intelligence, par exemple YEAR, QUARTER, MONTH.
Operators
Les opérateurs disponibles dans Universe Designer, Desktop Intelligence et Web Intelligence, par exemple ADD,
SUBSTRACT, MULTIPLY.
Guide d'accès aux données
129
7
7
Configuration des paramètres de génération SQL
A propos des fichiers PRM
Section File
Description
Les fonctions disponibles dans Universe Designer, Desktop Intelligence et Web Intelligence, par exemple Average,
Sum, Variance.
Le texte d'aide qui s'affiche lorsque des fonctions de cette
section sont sélectionnées dans Universe Designer, Desktop Intelligence et Web Intelligence figure dans le fichier
<pilote><langue>.prm, par exemple oracleen.prm. Ce fichier se trouve dans le même répertoire que le fichier
<pilote>.prm. Vous pouvez l'ouvrir pour voir les descriptions de toutes les fonctions disponibles dans le fichier <pilote>.prm.
La section Function a les sous-sections suivantes :
• Group : indique si l'utilisation de cette fonction dans
une requête génère une clause group by.
•
True (vrai) indique que la requête génère une
clause group by.
•
False (faux) indique que la requête ne génère pas
de clause group by.
Fonctions
130
Guide d'accès aux données
•
ID : dans Reporter, il s'agit du nom qui s'affiche dans
la liste de fonctions.
•
InMacro : dans Reporter cependant, si la valeur est
True, la fonction est répertoriée dans la liste de fonctions Objets personnels ; si elle est définie sur False,
la fonction n'est pas répertoriée.
•
Type : type de données de la fonction.
•
Arguments : arguments acceptés par la fonction.
Une fonction peut disposer d'un maximum de quatre
arguments, et tout argument supplémentaire n'est pas
pris en compte.
•
SQL : syntaxe SQL pour la fonction.
Configuration des paramètres de génération SQL
Pour afficher et modifier un fichier PRM
Remarque :
Seule la section Configuration est documentée ici. Les paramètres de la
section Configuration peuvent être modifiés pour optimiser les requêtes
exécutées sur des univers avec le pilote d'accès aux données cible.
Rubriques associées
•
Pour afficher et modifier un fichier texte d'aide sur les fonctions page 131
Pour afficher et modifier un fichier PRM
Vous pouvez afficher, modifier et ajouter des paramètres à un fichier PRM
de la façon suivante :
1. Placez-vous dans le répertoire qui contient le fichier PRM du pilote d'accès
aux données cible. Les fichiers PRM sont stockés ici :
connectionserver-install-dir\connectionServer\<sgb
dr>\<pilote>.prm
2.
3.
4.
5.
Ouvrez un fichier <pilote>.prm dans un éditeur XML.
Développez les sections concernées.
Définissez les valeurs en les entrant dans la balise appropriée.
Enregistrez le fichier et fermez-le.
Pour afficher et modifier un fichier texte
d'aide sur les fonctions
Le texte d'aide qui s'affiche en dessous de chaque fonction quand elle est
sélectionnée dans Universe Designer est géré dans un fichier XML distinct.
Vous pouvez modifier et ajouter du texte pour décrire une fonction en
modifiant le fichier <pilote><langue>.prm. Il y a un fichier de texte d'aide
pour chaque version linguistique des produits Business Objects installés.
Le texte d'aide apparaît quand une fonction stockée dans le fichier PRM est
sélectionnée dans Universe Designer :
Quand vous ajoutez une fonction au fichier PRM, vous devez ajoutez le texte
d'aide pour la nouvelle fonction dans le fichier <pilote><langue>.prm
approprié. Par exemple, si vous ajoutez une fonction au fichier oracle.prm,
Guide d'accès aux données
131
7
7
Configuration des paramètres de génération SQL
Pour modifier le texte d'aide d'une fonction PRM
vous devez aussi ajouter le nom de la fonction et son texte d'aide au fichier
oracleen.prm, si vous utilisez la version en anglais de Universe Designer.
Pour modifier le texte d'aide d'une
fonction PRM
1. Placez-vous dans le répertoire qui contient le fichier de langue PRM du
pilote d'accès aux données cible. Les fichiers de langue PRM sont stockés
ici :
connectionserver-installdir\connectionServer\<rdbms>\<pilote><langue>.prm
Par exemple, oracleen.prm.
2. Ouvrez un fichier <pilote><langue>.prm dans un éditeur XML.
3. Développez la section Messages.
4. Procédez comme suit pour ajouter du texte d'aide à une nouvelle fonction :
• Ajoutez une nouvelle section pour la fonction. La façon la plus simple
de le faire consiste à copier l'entrée d'une fonction existante et à la
coller dans la section Function. Modifiez ensuite le texte de la nouvelle
fonction.
•
Saisissez le texte d'aide pour la fonction.
5. Pour afficher ou modifier le texte d'aide d'une fonction existante, procédez
comme suit :
• Développez la section Function.
•
Développez la section Message pour la fonction.
•
Modifiez le texte d'aide.
6. Enregistrez le fichier et fermez-le.
132
Guide d'accès aux données
Paramètres PRM –
Informations de référence
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Informations de référence pour la
configuration des fichiers PRM
Les paramètres SQL de configuration sont répertoriés par ordre alphabétique.
Pour afficher les fonctions, les opérateurs de date et les autres opérateurs
disponibles, ouvrez un fichier <pilote>.prm dans un éditeur XML. Chaque
paramètre est défini dans la balise suivante :
<Parameter Name="parameter "> value</Parameter>
où paramètre est le nom du paramètre et valeur est la valeur attribuée au
paramètre.
Chaque paramètre figure avec les informations suivantes :
•
exemple de la façon dont le paramètre apparaît dans le fichier XML
•
description du paramètre
•
valeurs possibles qui peuvent être définies pour le paramètre
•
valeur par défaut pour le paramètre
Remarque :
Certains paramètres de configuration ne doivent pas être modifiés. Ces
paramètres ont des valeurs définies pour une utilisation interne dans les
solutions Business Objects. Ces paramètres sont décrits dans cette section,
mais un avertissement indique qu'il ne faut pas en modifier les valeurs. Vous
ne devez pas modifier ces paramètres. Avant de modifier un ou plusieurs
autres fichiers PRM, il est recommandé d'effectuer une copie de sauvegarde
du fichier PRM.
BACK_QUOTE_SUPPORTED
<Parameter Name="BACK_QUOTE_SUPPORTED">Y</Parameter>
Description
134
Guide d'accès aux données
Spécifie si les noms de table ou de colonne contenant
des espaces ou des caractères spéciaux sont entourés de guillemets ( ' ).
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Y : encadre le nom de table et de colonne de guillemets ( ' ).
Valeurs
N : n'encadre pas les noms de tables et de colonnes
avec des guillemets ( ' ).
Par défaut
Y
Résultat
Table name=`Ma table`
CASE_SENSITIVE
<Parameter Name="CASE_SENSITIVE">N</Parameter>
Description
Spécifie si la base de données fait la distinction entre
les majuscules et les minuscules. Paramètre utilisé
avec Oracle.
Y : spécifie que la base de données fait la distinction
entre les majuscules et les minuscules.
Valeurs
N : spécifie que la base de données ne fait pas la distinction entre les majuscules et les minuscules.
Par défaut
N
CHECK_OWNER_STATE
<Parameter Name="CHECK_OWNER_STATE">N</Parameter>
Guide d'accès aux données
135
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Description
Spécifie si le SQL vérifie que la base de données
prend en charge le classement des tables par nom
de propriétaire.
Y : le SQL vérifie si la base de données prend en
charge le classement des tables par nom de propriétaire.
Valeurs
N : le SQL ne vérifie pas si la base de données prend
en charge le classement des tables par nom de propriétaire.
Par défaut
Y
CHECK_QUALIFIER_STATE
<Parameter Name="CHECK_QUALIFIER_STATE">N</Parameter>
Description
Spécifie si le SQL vérifie que la base de données
prend en charge le classement des tables par qualificateur.
Y : vérifie si la base de données prend en charge le
classement des tables par qualificateur.
Valeurs
N : ne vérifie pas si la base de données prend en
charge le classement des tables par qualificateur.
Par défaut
136
Guide d'accès aux données
Y
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
COMMA
<Parameter Name="COMMA">||' '||</Parameter>
Spécifie l'opérateur de concaténation de la base de
données, utilisé pour remplacer une virgule pour les
objets ayant la syntaxe suivante :
Description
Tab.Col1, Tab.Col2.
Le paramètre est utilisé avec tous les pilotes d'accès
aux données.
||' '||
Valeurs
+' '+
Par défaut
||' '||
Résultat
Tab.Col1||' '||Tab.Col2
CONCAT
<Parameter Name="CONCAT">||</Parameter>
Description
Spécifie l'opérateur de concaténation. Le paramètre
est utilisé avec tous les pilotes d'accès aux données.
||
Valeurs
+
Guide d'accès aux données
137
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Par défaut
||
CONSTANT_SAMPLING_SUPPORTED
CONSTANT_SAMPLING_SUPPORTED
Description
Spécifie si la base de données prend en charge
l'échantillonnage aléatoire.
Yes : la base de données prend en charge l'échantillonnage aléatoire.
Valeurs
No : la base de données ne prend pas en charge
l'échantillonnage aléatoire.
Par défaut
Yes
DATABASE_DATE_FORMAT
<Parameter Name="DATABASE_DATE_FORMAT">DD-MM-YYYY
HH24:MI:SS</Parameter>
138
Description
Pour Oracle uniquement. Spécifie les formats d'entrée
par défaut pour la date et pour l'heure qui sont stockés
sur le serveur.
Valeurs
DD-MM-YYYY HH24:MI:SS
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Par défaut
DD-MM-YYYY HH24:MI:SS
DATATYPE_BLOB
Name="Datatype_Blob">LONGVARCHAR</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Type de données de base de données de la colonne
pour les objets Blob. Ce paramètre n'est pas utilisé
dans cette version. Il est présent pour des raisons de
compatibilité avec les versions à venir.
DATATYPE_DOUBLE
<Parameter Name="Datatype_Double"> : la valeur dépend de la base de
données.
Remarque :
Description
Ne modifiez pas ce paramètre.
Type de données de base de données de la colonne
pour les objets Date (commande CREATE table)
DATATYPE_DTM
<Parameter Name="Datatype_Dtm">DATE</Parameter>
Guide d'accès aux données
139
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Remarque :
Description
Ne modifiez pas ce paramètre.
Type de données de base de données de la colonne
pour les objets Date (commande CREATE table)
DATATYPE_INT
<Parameter Name="Datatype_Int">NUMBER</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Type de données de base de données de la colonne
pour les objets Numeric (commande CREATE table)
DATATYPE_NULL
<Parameter Name="Datatype_Null"/>
Remarque :
Description
Ne modifiez pas ce paramètre.
Syntaxe SQL de base de données pour les valeurs
nulles (commande INSERT)
DATATYPE_STRING
<Parameter Name="Datatype_String">VARCHAR2</Parameter>
140
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Remarque :
Ne modifiez pas ce paramètre.
Description
Type de données de base de données de la colonne
pour les objets Character et Long (commande
CREATE table)
DATE_WITHOUT_QUOTE
<Parameter Name="DATE_WITHOUT_QUOTE">Y</Parameter>
Description
Spécifie la prise en charge des dates sans guillemets
simples dans la syntaxe SQL.
Le paramètre est utilisé avec MS Access.
Valeurs
Y : les dates ne sont pas placées entre guillemets simples.
N : les dates sont placées entre guillemets simples.
Par défaut
Y
DELIMIT_IDENTIFIERS
<Parameter Name="DELIMIT_IDENTIFIERS">YES</Parameter>
Description
Spécifie si les guillemets définis dans le paramètre
IDENTIFIER_DELIMITER servent à entourer les noms
de tables et de colonnes.
Guide d'accès aux données
141
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
YES : le délimiteur spécifié dans IDENTIFIER_DELIMITER est utilisé.
Valeurs
NO : le délimiteur spécifié dans IDENTIFIER_DELIMITER n'est pas utilisé.
Par défaut
YES
Résultat
Table name="ma_table"
EXT_JOIN
<Parameter Name="EXT_JOIN">YES</Parameter>
Spécifie si des jointures externes sont prises en
charge.
Description
Ce paramètre est utilisé par tous les pilotes d'accès
aux données.
YES : la base de données prend en charge les jointures externes.
142
Valeurs
NO : la base de données ne prend pas en charge les
jointures externes. La case à cocher Jointure externe
de la boîte de dialogue Modifier la jointure de Universe Designer s'affiche en grisé.
Par défaut
YES
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
EXT_JOIN_INVERT
<Parameter Name="EXT_JOIN_INVERT">YES</Parameter>
Spécifie comment afficher un symbole de jointure
externe dans une expression de jointure.
Description
Ce paramètre est utilisé avec IBM DB2, Informix,
Oracle et Teradata.
YES : lorsque vous cliquez sur Jointure externe dans
la boîte de dialogue Modifier la jointure de Universe Designer, le symbole de jointure externe apparaît en position inversée dans une expression de jointure.
Valeurs
NO : lorsque vous cliquez sur Jointure externe dans
la boîte de dialogue Modifier la jointure de Universe Designer, le symbole de jointure externe apparaît du même côté que celui où vous avez créé la jointure externe.
Par défaut
YES
EXTERN_SORT_EXCLUDE_DISTINCT
<Parameter Name="EXTERN_SORT_EXCLUDE_DISTINCT">Y</Parameter>
Description
Spécifie si l'application génère ou non une instruction
SELECT DISTINCT quand une requête contient une
clause ORDER BY.
Guide d'accès aux données
143
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Y : aucune instruction SELECT DISTINCT n'est générée quand la requête contient une clause ORDER BY.
Valeurs
N : une instruction DISTINCT est générée quand la
requête contient une clause ORDER BY.
Par défaut
Y
GROUPBY_EXCLUDE_COMPLEX
Parameter Name="GROUPBY_EXCLUDE_COMPLEX">N</Parameter>
Description
Spécifie si la base de données permet la saisie de
formules, d'alias ou d'index dans les clauses GROUP
BY.
Le paramètre est utilisé avec IBM DB2.
Valeurs
Y : spécifie que la base de données ne permet pas
la saisie de formules, d'alias ou d'index dans les
clauses GROUP BY. Si vous exécutez une requête
contenant des indicateurs et des objets complexes
(par exemple, avec la fonction de sous-chaîne ou
l'opérateur de concaténation), votre application affiche
le message d'erreur suivant : La base de données
ne vous permet pas d'effectuer des agrégations avec l'objet <nom_objet>.
N : spécifie que la base de données permet la saisie
de formules, d'alias ou d'index dans les clauses
GROUP BY.
Par défaut
144
Guide d'accès aux données
N
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
GROUPBY_WITH_ALIAS
<Parameter Name="GROUPBY_WITH_ALIAS">Y</Parameter>
Description
Spécifie si la base de données peut créer une clause
GROUP BY dans l'instruction SELECT.
Le paramètre est utilisé avec Red Brick.
Valeurs
Y : permet de créer une clause GROUP BY dans l'instruction SELECT. Un alias est utilisé pour remplacer,
par exemple, une instruction T1.col + T2.col
+...Tn.col n .col .
N : ne permet pas de créer une clause GROUP BY dans
l'instruction SELECT.
Par défaut
Y
GROUPBY_WITHOUT_CONSTANT
<Parameter Name="GROUPBY_WITHOUT_CONSTANT">Y</Parameter>
Description
Spécifie si vous autorisez ou non l'ajout d'objets dont
la définition SQL est une constante dans une clause
GROUP BY. Le paramètre est utilisé par IBM DB2 et
Microsoft SQL Server
Guide d'accès aux données
145
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Y : spécifie que vous pouvez ajouter tout objet de type
constante à la requête, mais il ne se trouvera pas
dans la clause GROUP BY.
Valeurs
N : spécifie que vous pouvez insérer tous les objets
d'une requête (c'est-à-dire sans fonction d'agrégat)
dans une clause GROUP BY.
Par défaut
Y
GROUPBYCOL
<Parameter Name="GROUPBYCOL">NO</Parameter>
Description
Spécifie si une clause GROUP BY accepte des entiers
pour les noms de colonnes.
YES : spécifie qu'une clause GROUP BY accepte de
remplacer un nom de colonne par un index de colonne
de l'instruction SELECT.
Valeurs
NO : spécifie qu'une clause GROUP BY n'accepte
pas de remplacer un nom de colonne par un index de
colonne de l'instruction SELECT.
Par défaut
NO
IDENTIFIER_DELIMITER
<Parameter Name="IDENTIFIER_DELIMITER">"</Parameter>
146
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Indique que :
•
•
Description
les noms de tables ou de colonnes contenant des
espaces ou des caractères spéciaux sont entourés
de guillemets doubles si le paramètre
BACK_QUOTE_SUPPORTED est activé.
quels que soient les caractères qui les composent,
les noms de tables et de colonnes sont entourés de
guillemets si le paramètre DELIMIT_IDENTIFIERS
est activé.
Pour utiliser ce paramètre, BACK_QUOTE_SUPPORTED ou DELIMIT_IDENTIFIERS doit être défini sur
YES. Il s'agit de la valeur par défaut des deux paramètres.
" : Les noms de table ou de colonne contenant des
espaces ou des caractères spéciaux sont entourés
de guillemets doubles.
Valeurs
' : Les noms de table ou de colonne contenant des
espaces ou des caractères spéciaux sont entourés
de guillemets simples. Cette valeur peut être utilisée
seulement avec Microsoft Access.
Par défaut
"
Résultat
Table name="Ma Table"
IF_NULL
<Parameter Name="IF_NULL">NO</Parameter>
Guide d'accès aux données
147
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Description
Spécifie une fonction basée sur deux paramètres. Si
la valeur du premier paramètre est nulle, le second
est utilisé.
Valeurs
Dépend de la base de données.
Par défaut
Dépend de la base de données.
INTERSECT
<Parameter Name="INTERSECT">INTERSECT</Parameter>
Description
Spécifie si la base de données prend en charge
l'opérateur ensembliste INTERSECT.
INTERSECT : la base de données prend en charge
l'opérateur ensembliste INTERSECT.
Valeurs
pas de valeur : la base de données ne prend pas en
charge l'opérateur ensembliste INTERSECT. Dans
ce cas, deux requêtes sont générées.
Par défaut
INTERSECT
KEY_INFO_SUPPORTED
<Parameter Name="KEY_INFO_SUPPORTED">Y</Parameter>
148
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Description
Valeurs
Spécifie si vous pouvez extraire des définitions de
clés primaires et secondaires à partir du compte de
base de données.
Y : spécifie que la base de données vous permet
d'extraire des définitions de clés primaires et secondaires à partir du compte de base de données. Ce
paramètre permet à Universe Designer d'afficher les
clés dans le volet Structure.
N : spécifie que la base de données ne vous permet
pas d'extraire des définitions de clés primaires et secondaires à partir du compte de base de données.
Par défaut
Y
LEFT_OUTER
<Parameter Name="LEFT_OUTER">$(+)</Parameter>
<Parameter Name="LEFT_OUTER">$*</Parameter>
Description
Spécifie la prise en charge des jointures externes
gauches.
$(+) Cette syntaxe est utilisée avec Oracle. $ représente une expression de jointure.
Valeurs
$* Cette syntaxe est utilisée avec Sybase, MS SQL
Server et Red Brick. $ représente une expression de
jointure.
Par défaut
Voir les valeurs ci-dessus.
Guide d'accès aux données
149
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
LENMAXFORCOLUMNNAME
<Parameter Name="LenMaxForColumnName">30</Parameter>
Remarque :
Ne modifiez pas ce paramètre.
Description
Longueur maximale pour un nom de colonne (le nom
d'objet est proposé par défaut) (commande CREATE
table)
LENMAXFORTABLENAME
<Parameter Name="LenMaxForTableName">30</Parameter>
Remarque :
Description
Ne modifiez pas ce paramètre.
Longueur maximale pour le type de données des colonnes VARCHAR (commande CREATE table).
LENMAXFORVARCHAR
<Parameter Name="LenMaxForVarchar">254</Parameter>
Remarque :
Description
150
Guide d'accès aux données
Ne modifiez pas ce paramètre.
Longueur maximale pour le type de données des colonnes VARCHAR (commande CREATE table).
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
MINUS
<Parameter Name="MINUS">MINUS</Parameter>
Description
Spécifie si la base de données prend en charge
l'opérateur ensembliste MINUS.
MINUS Spécifie que la base de données prend en
charge l'opérateur ensembliste MINUS.
Valeurs
EXCEPT Spécifie que la base de données prend en
charge l'opérateur ensembliste MINUS.
pas de valeur Spécifie que la base de données ne
prend pas en charge l'opérateur ensembliste MINUS.
Dans ce cas, deux requêtes sont générées.
Par défaut
MINUS
NO_DISTINCT
<Parameter Name="NO_DISTINCT">Y</Parameter>
Description
Indique si la base de données prend en charge le mot
clé DISTINCT.
Ce paramètre est utilisé avec MS Access.
Guide d'accès aux données
151
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Y : spécifie que la base de données ne prend pas en
charge le mot clé DISTINCT. Ce comportement désactive :
• l'option Valeurs distinctes qui s'affiche lorsque
vous cliquez sur le bouton Valeurs dans l'assistant
de création d'univers.
Valeurs
•
la fonction Countdistinct qui s'affiche lorsque vous
créez une condition avec l'opérande Calcul dans
l'Editeur de requête.
N : spécifie que la base de données prend en charge
le mot clé DISTINCT.
Par défaut
Y
NULL_IN_SELECT_SUPPORTED
<Parameter Name="NULL_IN_SELECT_SUPPORTED">Yes</Parameter>
Description
Spécifie si la base de données prend en charge les
colonnes NULL dans l'instruction SELECT.
Yes : les colonnes NULL sont prises en charge dans
l'instruction SELECT.
Valeurs
No : les colonnes NULL ne sont pas prises en charge
dans l'instruction SELECT.
Yes
Par défaut
152
Guide d'accès aux données
No pour les bases de données Teradata, DB2, Informix et Red Brick qui n'acceptent pas la valeur NULL
pour les colonnes.
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
OLAP_CLAUSE
<Parameter Name="OLAP_CLAUSE">WHEN</Parameter>
Description
Spécifie si les applications Business Objects génèrent
une clause WHEN ou QUALIFY si une fonction figurant dans le paramètre RISQL_Functions est utilisée
dans une condition. Ce paramètre doit être utilisé avec
la clause GROUPBY.
WHEN : génère une clause WHEN si une fonction figurant dans le paramètre RISQL_Functions est utilisée dans une condition. C'est la valeur par défaut
pour les bases de données Red Brick.
Valeurs
QUALIFY : génère une clause QUALIFY si une fonction figurant dans le paramètre RISQL_Functions est
utilisée dans une condition. Il s'agit de la valeur par
défaut pour les bases de données Teradata.
Par défaut
Voir les valeurs ci-dessus.
OUTERJOINS_GENERATION
<Parameter Name="OUTERJOINS_GENERATION">ANSI92</Parameter>
Ce paramètre contrôle le comportement par défaut de la génération de
jointures externes. Vous pouvez le définir de deux façons :
• la génération de jointures externes est conforme à la spécification ANSI92
•
la génération de jointures externes est la même que pour les versions
précédentes de Universe Designer
Guide d'accès aux données
153
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Remarque :
Le paramètre OUTERJOINS_GENERATION du fichier PRM est lié au paramètre
d'univers ANSI92 de la manière suivante :
•
Si le paramètre OUTERJOINS_GENERATION du fichier PRM est défini sur
ANSI92 et le paramètre d'univers ANSI92 sur NO, le paramètre de PRM
remplace le paramètre d'univers et les jointures externes suivent le
comportement ANSI92.
•
Si le paramètre OUTERJOINS_GENERATION du fichier PRM est défini sur
USUAL, le paramètre d'univers ANSI92 est prioritaire et les jointures
externes suivent ou non le comportement ANSI92 selon que le paramètre
d'univers ANSI92 est défini sur YES ou sur NO.
Spécifie la syntaxe SQL pour les jointures externes.
La valeur ANSI92 génère une jointure externe dans
la clause FROM. D'autres valeurs génèrent la jointure
externe dans la clause WHERE.
Description
154
Guide d'accès aux données
Quand vous modifiez ce paramètre, vérifiez les propriétés des jointures pour vous assurer que l'expression de la jointure externe est valide et que les cardinalités sont correctes. ANSI92 ne prend pas en charge
la personnalisation manuelle dans la syntaxe de jointure.
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Les valeurs principales pour OUTERJOINS_GENERATION
sont les suivantes :
• ANSI92 : le comportement par défaut des jointures
externes est conforme à la norme ANSI92, quelle
que soit la valeur du paramètreANSI92 de Universe Designer.
Valeurs
•
No : les jointures externes ne sont pas prises en
charge.
•
USUAL : le comportement par défaut des jointures
externes est le même que pour les versions précédentes de Universe Designer. Ce comportement
est remplacé si le paramètre ANSI92 de Universe Designer est défini sur Yes.
Les paramètres disponibles varient en fonction de la
base de données. Reportez-vous aux valeurs par
défaut ci-dessous.
ANSI_92 : valeur par défaut pour Oracle, SQL Server 2005 et Sybase.
DB2 : valeur par défaut pour IBM DB2.
FULL_ODBC : peut être utilisée avec Microsoft SQL Server.
Par défaut
INFORMIX : valeur par défaut pour Informix.
INGRES : valeur par défaut pour Teradata.
NO : valeur par défaut pour ODBC.
USUAL : valeur par défaut pour Neoview, Netezza,
Red Brick et SQL Server 2000.
Guide d'accès aux données
155
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Exemples de paramètres pour OUTERJOINS_GENERATION
Paramètre = USUAL:
FROM T1, T2
WHERE T1.col1(+) = T2.col2
Paramètre = DB2:
FROM T2 LEFT OUTER JOIN T1
ON T1.col1 = T2.col2
Paramètre = ODBC:
FROM {oj T1 LEFT OUTER JOIN T2 ON T1.col1=T2.col2}
Where (T2.col3 = T3.col1)
Paramètre = INFORMIX:
FROM T2
OUTER T1
WHERE T1.col1=T2.col2
Paramètre = FULL-ODBC:
FROM {oj T1 RIGHT OUTER JOIN T2 ON T2.col2=T1.col1
T2 INNER JOIN 3 on T2.col3 = T3.col1}
Paramètre = ANSI_92:
SELECT DISTINCT
t1.col1,
t2.col2
FROM
(t1 RIGHT OUTER JOIN t2 ON (t1.col1=t2.col2) )
Utilisation d'OUTERJOINS avec Oracle
Le paramètre OUTERJOINS_GENERATION par défaut, ANSI92, peut affecter
le comportement d'univers existants quel que soit le paramètre du niveau
univers pour ANSI92.
Pour paramétrer vos univers Oracle existants de sorte qu'ils se comportent
comme dans les versions précédentes de Universe Designer :
156
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
1. Dans le fichier PRM, vérifiez que le paramètre OUTERJOINS_GENERATION
est défini sur USUAL.
2. Dans le fichier PRM, définissez les paramètres LEFT_OUTER et
RIGHT_OUTER sur $(+).
Pour en savoir plus sur les paramètres SQL des univers et les fichiers PRM
dans les versions antérieures de Universe Designer, voir le Guide du
Designer.
Rubriques associées
•
•
•
LEFT_OUTER page 149
RIGHT_OUTER page 162
A propos des paramètres de génération SQL page 126
OVER_CLAUSE
<Parameter Name="OVER_CLAUSE">Y</Parameter>
Description
Autorise les solutions Business Objects à inclure des
fonctions RISQL lors de la génération de SQL. Les
fonctions RISQL prises en charge par la base de données sont indiquées dans le paramètre RISQL_FU
NCTIONS.
Y : les applications peuvent inclure des fonctions RI
SQL lors de la génération de SQL.
Valeurs
N : les applications ne peuvent pas inclure de fonctions RISQL lors de la génération de SQL.
Par défaut
Y
Guide d'accès aux données
157
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
OWNER
<Parameter Name="OWNER">Y</Parameter>
Description
Spécifie si la base de données autorise la préfixation
des tables avec le nom de propriétaire.
Y : spécifie que la base de données prend en charge
la préfixation des tables avec le nom de propriétaire.
Valeurs
N : spécifie que la base de données ne prend pas en
charge la préfixation des tables avec le nom de propriétaire.
Par défaut
Y
PERCENT_RANK_SUPPORTED
<Parameter Name="PERCENT_RANK_SUPPORTED">Yes</Parameter>
Description
Spécifie si la base de données prend en charge la
fonction analytique Classement par pourcentage.
Yes : la base de données prend en charge la fonction
analytique Classement par pourcentage.
Valeurs
No : la base de données ne prend pas en charge la
fonction analytique Classement par pourcentage.
Par défaut
158
Guide d'accès aux données
Yes
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
PREFIX_SYS_TABLE
<Parameter Name="PREFIX_SYS_TABLE">RBW_</Parameter>
<Parameter Name="PREFIX_SYS_TABLE">MSys</Parameter>
Description
Spécifie si les tables système sont affichées dans
Universe Designer. Ce paramètre se trouve dans les
fichiers access.prm et redbrick.prm.
MSys : spécifie que les tables système MS Access
sont masquées dans la liste de tables de Universe Designer. Valeur par défaut pour MS Access.
Valeurs
RBW_ : spécifie que les tables système Red Brick
sont masquées dans la liste de tables de Universe Designer. Valeur par défaut pour Red Brick.
Aucune valeur : spécifie que les tables système de la
base de données sont affichées dans la liste de tables
de Universe Designer.
Par défaut
Voir les valeurs ci-dessus.
QUALIFIER
<Parameter Name="QUALIFIER">N</Parameter>
Description
Spécifie si la base de données autorise la préfixation
des tables avec le nom de qualificateur.
Guide d'accès aux données
159
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Y : spécifie que la base de données prend en charge
la préfixation des tables avec le nom de qualificateur.
Valeurs
N : spécifie que la base de données ne prend pas en
charge la préfixation des tables avec le nom de qualificateur.
Par défaut
Dépendant des SGBDR.
QUOTE_OWNER
<Parameter Name="QUOTE_OWNER">Y</Parameter>
Description
Valeurs
Spécifie si le nom de propriétaire doit ou non être
placé entre guillemets simples. Utilisé seulement par
Informix.
Y : spécifie que les noms de tables sont préfixés par
un nom de propriétaire entre guillemets simples.
Obligatoire pour une base données Informix conforme
à ANSI. Sinon, Informix convertit le nom du propriétaire en majuscules.
N : spécifie que les noms de tables ne sont pas préfixés par un nom de propriétaire entre guillemets simples.
Par défaut
Y
SELECT Alias.col (<Alias> est un alias local)
Résultat
FROM 'Owner'.table.col Alias
160
Guide d'accès aux données
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
RANK_SUPPORTED
<Parameter Name="RANK_SUPPORTED">Yes</Parameter>
Description
Spécifie si la base de données prend en charge la
fonction analytique Classement.
Yes : la base de données prend en charge la fonction
analytique Classement.
Valeurs
No : la base de données ne prend pas en charge la
fonction analytique Classement.
Par défaut
Yes
REFRESH_COLUMNS_TYPE
<Parameter Name="REFRESH_COLUMNS_TYPE">O</Parameter>
Description
Indique comment les colonnes sont actualisées.
O : les colonnes sont actualisées par nom de propriétaire. C'est la valeur par défaut avec Oracle.
Valeurs
Q : les colonnes sont actualisées par nom de qualificateur. C'est la valeur par défaut avec Red Brick, Sybase, MS SQL Server et MS Access.
T : les colonnes sont actualisées par nom de table.
Par défaut
Voir les valeurs ci-dessus.
Guide d'accès aux données
161
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
REVERSE_TABLE_WEIGHT
<Parameter Name="REVERSE_TABLE_WEIGHT">Y</Parameter>
Description
Spécifie dans quel ordre les tables doivent être générées. Ce paramètre est utilisé avec Oracle. Ce paramètre peut également être utilisé avec certaines
autres bases de données, éventuellement avec une
inversion de Y et de N.
Ce paramètre n'est pas pris en charge avec Teradata.
N : spécifie que les tables doivent être générées en
commençant par la plus grande pour terminer par la
plus petite.
Valeurs
Y : spécifie que les tables doivent être générées en
commençant par la plus petite pour terminer par la
plus grande.
Par défaut
Y
RIGHT_OUTER
<Parameter Name="RIGHT_OUTER">$(+)</Parameter>
<Parameter Name="RIGHT_OUTER">*$</Parameter>
Description
162
Guide d'accès aux données
Spécifie la syntaxe des jointures externes droites.
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
$(+): Utilisé avec Oracle. $ représente une expression
de jointure.
Valeurs
*$ : utilisé avec Sybase, MS SQL Server et Red Brick.
$ représente une expression de jointure.
Par défaut
Voir les valeurs ci-dessus.
RISQL_FUNCTIONS
<Parameter Name="RISQL_FUNCTIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Pa
rameter>
Description
Donne la liste des fonctions RISQL prises en charge
par la base de données.
•
Liste par défaut d'Oracle : RANK,SUM,AVG,COU
NT,MIN,MAX,RATIO_TO_REPORT,CUME_DI
ST,CORR,DENSE_RANK,FIRST_VALUE,LAST_VA
LUE,LAG,LEAD,NTILE,PERCENT_RANK,PERCEN
TILE_CONT,PERCENTILE_DISC,ROW_NUM
BER,CORR,COVAR_POP,COVAR_SAMP,RE
GR_SLOPE,REGR_INTERCEPT,REGR_COUNT,RE
GR_R2,REGR_AVGX,REGR_AVGY,REGR_SXX,RE
GR_SYY,REGR_SXY,STDDEV,STDDEV_POP,STD
DEV_SAMP,VAR_POP,VAR_SAMP,VARIANCE
Valeurs
•
Liste par défaut d'IBM DB2 : RANK,SUM,AVG,COU
NT,MIN,MAX
•
Liste par défaut de Teradata :
CSUM,MAVG,MDIFF,MLINREG,MSUM,RANK,QUANTILE
•
Liste par défaut de Red Brick : CUME,MOVIN
GAVG,MOVINGSUM,RANK,RATIOTOREPORT,TERTILE
Guide d'accès aux données
163
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Par défaut
Voir les valeurs ci-dessus.
SEED_SAMPLING_SUPPORTED
<Parameter Name="SEED_SAMPLING_SUPPORTED">Yes</Parameter>
Description
Spécifie si la base de données prend en charge la
capacité d'échantillonnage basée sur la valeur de
départ.
Yes : la base de données prend en charge l'échantillonnage basé sur la valeur de départ.
Valeurs
No : la base de données ne prend pas en charge
l'échantillonnage basé sur la valeur de départ.
Par défaut
No
SORT_BY_NO
<Parameter Name="SORT_BY_NO">NO</Parameter>
Description
164
Guide d'accès aux données
Spécifie si les utilisateurs sont autorisés à trier des
colonnes (représentées comme objets de l'univers)
qui ne font pas partie de l'instruction SELECT.
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Valeurs
YES : spécifie que les utilisateurs ne sont pas autorisés à trier des colonnes si elles ne font pas partie de
l'instruction SELECT. Quand ce paramètre est défini
sur YES, le bouton Gérer les tris apparaît grisé dans
l'Editeur de requête.
NO : spécifie que les utilisateurs sont autorisés à trier
des colonnes même si elles ne font pas partie de l'instruction SELECT.
Par défaut
NO
UNICODE_PATTERN
<Parameter Name="UNICODE_PATTERN">UNISTR($)</Parameter>
SQL Server et Oracle seulement.
Description
S'applique seulement quand le paramètre de génération de SQL de l'univers UNICODE_STRINGS a la
valeur Y. Toutes les conditions basées sur des
chaînes sont alors formatées avec cette valeur de
chaîne.
Microsoft SQL Server : N$
Par défaut
Oracle : UNISTR($)
Exemple
UNICODE_PATTERN=N$
Guide d'accès aux données
165
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
UNION
<Parameter Name="UNION">UNION</Parameter>
Description
Spécifie si la base de données prend en charge
l'opérateur ensembliste UNION.
UNION : la base de données prend en charge l'opérateur ensembliste UNION.
Valeurs
pas de valeur : la base de données ne prend pas en
charge l'opérateur ensembliste UNION. Dans ce cas,
deux requêtes sont générées.
Par défaut
UNION
USER_INPUT_DATE_FORMAT
<Parameter Name="USER_INPUT_DATE_FORMAT">'dd-MM-yyyy
HH:mm:ss'</Parameter>
Description
166
Guide d'accès aux données
Spécifie les formats par défaut pour la date et pour
l'heure générés dans la clause WHERE d'un script
SQL.
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
{\d 'yyyy-mm-dd'} Il s'agit du format de date par défaut
pour ODBC.
'DD-MM-YYYY HH:MM:SS' Il s'agit des formats par
défaut pour la date et pour l'heure avec Oracle.
'MM/JJ/AAAA' Il s'agit du format de date par défaut
avec Informix.
Valeurs
'yyyy-mm-dd HH:mm:ss' Ce sont les formats par défaut de la date et de l'heure avec MS SQL Server et
la plupart des serveurs IBM DB2.
'mm/dd/yyyy hh:m:s am/pm' Il s'agit des formats de
date et d'heure par défaut pour Sybase.
'yyyy-mm-dd' Il s'agit du format de date par défaut
pour une passerelle Sybase.
Remarque :
Si vous devez utiliser des variables d'heure ou d'horodate
pour ODBC, vous devez remplacer la valeur du format
de date par défaut par :{\t 'hh:mm:ss'} ou {\t\s 'yyyy-mmdd hh:mm:ss'} dans le fichier odbc.sbo.
Par défaut
Voir les valeurs ci-dessus.
USER_INPUT_NUMERIC_SEPARATOR
<Parameter Name="USER_INPUT_NUMERIC_SEPARATOR">.</Parameter>
Description
Spécifie le séparateur décimal par défaut utilisé dans
le script SQL généré.
Valeurs
'.'
Guide d'accès aux données
167
8
8
Paramètres PRM – Informations de référence
Informations de référence pour la configuration des fichiers PRM
Par défaut
168
Guide d'accès aux données
'.'
Conversion de données –
Informations de référence
9
9
Conversion de données – Informations de référence
Conversion de données
Conversion de données
Ce chapitre contient les tables de conversion de données pour chaque
SGBDR pris en charge. Business Objects prend en charge quatre types de
données :
•
date
•
caractère
•
nombre
•
texte long
Les tables de conversion de données sont disponibles pour les SGBDR
suivants :
•
IBM DB2
•
Informix
•
Microsoft SQL Server
•
Oracle
•
Red Brick
•
Sybase
•
Teradata
Remarque :
Les tables de conversion de données pour les autres SGBDR pris en charge
seront disponibles dans les prochaines mises à jour du guide d'accès aux
données.
IBM DB2
Le tableau suivant présente les types de données internes d'IBM DB2 et
leur équivalent dans les solutions Business Objects :
170
Guide d'accès aux données
Conversion de données – Informations de référence
Conversion de données
Données de type IBM DB2
Données de type Business Objects
CLOB
TEXTE LONG
CARACTERE
CARACTERE
DATE
DATE
DECIMAL
NUMERIQUE
DOUBLE
NUMERIQUE
FLOAT
NUMERIQUE
INTEGER
NUMERIQUE
LONG VARCHAR
TEXTE LONG
NUMERIC
NUMERIQUE
SMALLINT
NUMERIQUE
TIME
DATE
TIMESTAMP
DATE
VARCHAR
CARACTERE
Guide d'accès aux données
171
9
9
Conversion de données – Informations de référence
Conversion de données
Informix
Le tableau suivant présente les types de données internes d'Informix et leur
équivalent dans les solutions Business Objects :
172
Données de type Informix
Données de type BusinessObjects
CHAR
CARACTERE
DATE
DATE
DATETIME
DATE
DECIMAL
NUMERIQUE
FLOAT
NUMERIQUE
INTEGER
NUMERIQUE
MONEY
NUMERIQUE
NCHAR
CARACTERE
NVARCHAR
CARACTERE
SERIAL
NUMERIQUE
SMALLINT
NUMERIQUE
Guide d'accès aux données
Conversion de données – Informations de référence
Conversion de données
Données de type Informix
Données de type BusinessObjects
SMALLFLOAT
NUMERIQUE
TEXT
TEXTE LONG
VARCHAR
CARACTERE
Microsoft SQL Server
Le tableau suivant présente les types de données internes de Microsoft SQL
Server et leur équivalent Business Objects.
Données de type Microsoft SQL
Server
Données de type Business Objects
BIT
NUMERIQUE
BOOLEAN
NUMERIQUE
CHAR
CARACTERE
DATETIME
DATE
DECIMAL
NUMERIQUE
FLOAT
NUMERIQUE
Guide d'accès aux données
173
9
9
Conversion de données – Informations de référence
Conversion de données
Données de type Microsoft SQL
Server
Données de type Business Objects
INT
NUMERIQUE
MONEY
NUMERIQUE
NUMERIC
NUMERIQUE
REAL
NUMERIQUE
SMALLDATETIME
DATE
SMALLINT
NUMERIQUE
SMALLMONEY
NUMERIQUE
TEXT
CARACTERE
TINYINT
NUMERIQUE
VARCHAR
CARACTERE
Oracle
Le tableau suivant présente les types de données internes d'Oracle et leur
équivalent dans les solutions Business Objects :
174
Guide d'accès aux données
Conversion de données – Informations de référence
Conversion de données
Données de type Oracle
Données de type Business Objects
CHAR
CARACTERE
CLOB
TEXTE LONG
DATE
DATE
FLOAT
NUMERIQUE
INTEGER
NUMERIQUE
LONG
TEXTE LONG
NUMERIQUE
NUMERIQUE
VARCHAR
CARACTERE
VARCHAR2
CARACTERE
Red Brick
Le tableau suivant présente les types de données internes de Red Brick et
leur équivalent Business Objects.
Guide d'accès aux données
175
9
9
Conversion de données – Informations de référence
Conversion de données
Données de type Red Brick
Données de type Business Objects
CHAR
CARACTERE
DATE
DATE
DECIMAL
NUMERIQUE
FLOAT
NUMERIQUE
INTEGER
NUMERIQUE
NUMERIC
NUMERIQUE
SMALLINT
NUMERIQUE
TIME
DATE
TIMESTAMP
DATE
Pour ajouter une prise en charge de TIME et de
TIMESTAMP dans une clause WHERE
Les objets qui utilisent les types de données TIME et TIMESTAMP ne sont
pas pris en charge dans la clause WHERE pour les requêtes exécutées sur
une base de données Red Brick. Vous pouvez définir les propriétés d'un
objet d'un univers pour qu'il prenne en charge l'utilisation de TIME et de
TIMESTAMP dans la clause WHERE de la façon suivante :
176
Guide d'accès aux données
Conversion de données – Informations de référence
Conversion de données
Pour une prise en charge des objets du type de données TIME ou
TIMESTAMP dans la clause WHERE :
1. Dans Universe Designer, cliquez deux fois sur un objet dans le volet
Univers.
La boîte de dialogue de modification des propriétés de l'objet s'affiche.
2.
3.
4.
5.
Cliquez sur l'onglet Définition.
Sélectionnez Date dans la liste déroulante Type.
Cliquez sur l'onglet Avancé.
Dans la zone de texte Format de la base de données, saisissez ceci :
Pour...
Type
la prise en charge de TIME
HH:MM:SS
la prise en charge de TIMESTAMP MM/DD/YYYY HH:MM:SS
6. Cliquez sur OK.
Sybase
Le tableau suivant présente les types de données internes de Sybase et leur
équivalent dans les solutions Business Objects :
Données de type Sybase
Données de type Business Objects
BIT
NUMERIQUE
CHAR
CARACTERE
DATETIME
DATE
Guide d'accès aux données
177
9
9
Conversion de données – Informations de référence
Conversion de données
Données de type Sybase
Données de type Business Objects
DECIMAL
NUMERIQUE
FLOAT
NUMERIQUE
INT
NUMERIQUE
MONEY
NUMERIQUE
NUMERIC
NUMERIQUE
REAL
NUMERIQUE
SMALLDATETIME
DATE
SMALLINT
NUMERIQUE
SMALLMONEY
NUMERIQUE
TINYINT
NUMERIQUE
VARCHAR
CARACTERE
Teradata
Le tableau suivant présente les types de données internes de Teradata et
leur équivalent dans les solutions Business Objects :
178
Guide d'accès aux données
Conversion de données – Informations de référence
Conversion de données
Données de type Teradata
Données de type Business Objects
DATE
DATE
DECIMAL
NUMERIQUE
FLOAT
NUMERIQUE
INTEGER
NUMERIQUE
SMALLINT
NUMERIQUE
BYTEINT
NUMERIQUE
DATETIME
DATE
VARCHAR
CARACTERE
Guide d'accès aux données
179
9
9
Conversion de données – Informations de référence
Conversion de données
180
Guide d'accès aux données
Informations
supplémentaires
A
A
Informations supplémentaires
Ressources d'inforEmplacement
mations
Informations sur le
produit SAP Busine- http://www.sap.com
ssObjects
Sélectionnez http://help.sap.com > SAP BusinessObjects.
Vous pouvez accéder à la toute dernière documentation relative aux produits SAP BusinessObjects et à
leur déploiement sur le portail SAP Help Portal. Il est
également possible de télécharger des versions PDF
ou des bibliothèques HTML installables.
SAP Help Portal
182
Guide d'accès aux données
Certains guides résident sur SAP Service Marketplace
et ne sont, par conséquent, pas disponibles sur le
portail SAP Help Portal. Le portail d'aide répertorie
ces guides et propose un lien vers SAP Service Marketplace. Les clients qui bénéficient d'un contrat de
maintenance disposent d'un ID utilisateur pour accéder
à ce site. Pour obtenir un identifiant, contactez votre
support technique.
Informations supplémentaires
Ressources d'inforEmplacement
mations
http://service.sap.com/bosap-support > Documentation
•
•
Guides d'installation : https://service.sap.com/bosapinstguides
Notes de version : http://service.sap.com/releasenotes
SAP Service Marketplace comprend certains guides
d'installation, guides de migration et de mise à niveau,
guides de déploiement, notes de version et des docuSAP Service Marketments concernant les plates-formes prises en charge.
place
Les clients qui bénéficient d'un contrat de maintenance
disposent d'un ID utilisateur pour accéder à ce site.
Pour obtenir un identifiant, contactez votre support
technique. Si vous êtes redirigé vers SAP Service
Marketplace à partir du site SAP Help Portal, utilisez
le menu situé dans le panneau de navigation à gauche
pour sélectionner la catégorie contenant la documentation que vous souhaitez consulter.
Ressources à l'atten- https://boc.sdn.sap.com/
tion des dévelophttps://www.sdn.sap.com/irj/sdn/businessobjects-sdk
peurs
library
https://www.sdn.sap.com/irj/boc/businessobjects-ar
Articles SAP Busine- ticles
ssObjects sur SAP
Community Network Ces articles étaient précédemment appelées notes
techniques.
https://service.sap.com/notes
Remarques
Ces remarques étaient précédemment appelées des
articles de la base de connaissances.
Forums sur SAP
https://www.sdn.sap.com/irj/scn/forums
Community Network
Guide d'accès aux données
183
A
A
Informations supplémentaires
Ressources d'inforEmplacement
mations
http://www.sap.com/services/education
Formation
Nous pouvons vous fournir un module de formation
qui réponde à vos besoins et convienne à votre style
d'apprentissage préféré, sous forme de stage traditionnel ou de séminaires plus ciblés.
http://service.sap.com/bosap-support
Support client en
ligne
Le site SAP Support Portal présente des informations
sur les programmes et services de support technique.
Il propose également des liens vers de nombreuses
informations techniques ainsi que des téléchargements. Les clients qui bénéficient d'un contrat de maintenance disposent d'un ID utilisateur pour accéder à ce
site. Pour obtenir un identifiant, contactez votre support
technique.
http://www.sap.com/services/bysubject/businessobje
ctsconsulting
Conseil
184
Guide d'accès aux données
Les consultants peuvent vous accompagner dans votre
démarche, depuis la phase initiale d'analyse jusqu'à
la phase finale de livraison de votre projet de déploie
ment. Ils peuvent vous faire bénéficier de leur expertise
en matière de bases de données relationnelles et
multidimensionnelles, de connectivité, d'outils de co
nception de base de données et de technologie d'inté
gration personnalisée.
Index
A
C
accès aux données
fichiers globaux 15
fichiers installés 14
fichiers utilisés par les pilotes 15
aide
fichiers PRM 131
aide, cscheck 21
ANSI92, syntaxe SQL 153
architecture du système 13
architecture système 13
Array Bind Available 87
Array Bind Size 87
Array Fetch disponible 88
Array Fetch Size 88
Assistant de création de connexion
configurer pour Data Federator 49
C++, pilotes 42
Capacités du pilote 93
Caractère d'échappement 93
Case_Sensitive 135
CASE_SENSITIVE 135
Casse d'identificateur entre guillemets 102
Casse de l'identificateur 96
CFG, fichier
ActiveDataSources, section 69
Charset List Extension 63
Config File Extension 63
DataBase, élément 69
Description Extension 64
DriverDefaults, section 61
Enable Failed Load 64
informations de référence sur les
paramètres de configuration 62
Load Drivers On Startup 65
Max Pool Time 65
modifier 61
NetworkLayer, élément 69
paramètres de la section Protocols 73
section Distribution 73
section Library 68
section Server 68
SQL External Extension 67
SQL Parameter Extension 67
Strategies Extension 68
visualiser 61
Chaîne de signal des identificateurs 96
Charset List Extension 63
CHECK_OWNER_STATE 135
CHECK_QUALIFIER_STATE 136
B
BACK_QUOTE_SUPPORTED 134
Base de connaissances 65
base de données, accès à la
configurer 69
installation 71
base de données, vérification de l'accès 33
bases de données
prises en charge 24
bases de données prises en charge, liste 24
Blob_Comparison 135
Boundary_Weight_Table 135
Business Objects
services de conseil 65
services de formation 65
Guide d'accès aux données
185
Index
Classpath
créer une connexion JavaBean 41
créer une connexion JDBC 37
clé primaire disponible 116
clés étrangères disponibles 115
COMMA 137
CONCAT 137
Config File Extension 63
configuration requise
connexions 20
version minimale de Data Federator 48
configuration, fichiers
catégories de paramètres 84
exemple de fichier SBO JavaBean 42
fichiers SBO installés 77
Connection Server
à propos des paramètres globaux 60
configurer l'accès aux données pour les
pilotes de marque DataDirect 80
configurer la méthode d'accès 68
configurer les paramètres globaux 62
configurer les paramètres par défaut du
pilote 61
configurer pour un déploiement complexe
69
configurer pour une connexion de Web
Intelligence à Data Federator 56
configurer pour une connexion JDBC à
Data Federator 51
configurer pour une connexion ODBC à
Data Federator 53
configurer pour une connexion ODBC à
Universe Designer et Web Intelligence
Rich Client 57
créer des connexions Generic JDBC 38
créer des connexions Generic ODBC 43
créer des connexions Generic ODBC3 45
créer des connexions JDBC 37
créer une connexion JavaBean 41
déboguer au démarrage 68
définition 12
en mode serveur autonome 73
186
Guide d'accès aux données
Connexion partageable 91
Connexion partagée 104
Connexion unique disponible 107
connexion, composants 12
connexions
configuration requise pour créer 20
créer Data Federator 48
connexions JavaBean
à propos de 40
créer 41
couches réseau
prises en charge 24
sélectionner 69
vérifier la connectivité avec le middleware
31
vérifier le middleware disponible 28
Coût estimé disponible 92
Cryptage du mot de passe 100
cs.cfg
à propos de 60
cscheck
accéder à l'aide 21
exécuter 22
liste de fonctions 23
syntaxe 23
Cumulative_Object_Where 92
D
Data Federator
à propos de la création de connexions 48
configurer pour une connexion ODBC 52
configurer pour une connexion ODBC à Web
Intelligence Rich Client 55
répertoire d'installation 51
version requise 48
DATABASE_DATE_FORMAT 138
DataDirect 80
DATATYPE_BLOB 139
DATATYPE_DOUBLE 139
DATATYPE_DTM 139
DATATYPE_INT 140
Index
DATATYPE_NULL 140
DATATYPE_STRING 140
DATE_WITHOUT_QUOTE 141
DELIMIT_IDENTIFIERS 141
Description Extension 64
Description File 92
Distribution
fichier CFG 73
Driver defaults
fichier CFG 61
driveren.prm, paramètres
Blob_Comparison 135
Boundary_Weight_Table 135
Case_Sensitive 135
Cumulative_Object_Where 92
Ext_Join 142
Intersect 148
Left_Outer 149
Max_Inlist_Values 151
Minus 151
OLAP_Clause 153
Quote_Owner 160
Refresh_Columns_Type 161
E
EBUS 51
Empty String 117
Enable Failed Load 64
enseignement. Voir formation 65
Enumerator CLSID 121
Expiration de la requête disponible 102
Ext_Join 142
EXT_JOIN 142
EXT_JOIN_INVERT 143
Extensions 94
EXTERN_SORT_EXCLUDE_DISTINCT 143
FORCE_SORTED_LOV
paramètre d'univers 138
Forcer l'exécution 95
Forcer la fermeture de l'instruction 118
G
Generic JDBC, source de données 38
Generic ODBC, source de données 43
Generic ODBC3, source de données 45
globaux
fichiers d'accès aux données 15
GROUPBY_EXCLUDE_COMPLEX 144
GROUPBY_WITH_ALIAS 145
GROUPBY_WITHOUT_CONSTANT 145
GROUPBYCOL 146, 147, 152, 158, 161,
164
I
IBM DB2
types de données 170
Identificateur entre guillemets 122
IDENTIFIER_DELIMITER 146
Informix
Modification du fichier ODBC.ini 111
types de données 172
Unicode 112
V5toV6DriverName 112
Informix, paramètres de configuration 111
installation
fichiers installés 14
répertoire Data Federator 51
vérifier le pilote d'accès aux données 30
installation, répertoire
emplacement 60
Intersect 148
INTERSECT 148
F
Family 94
Fichier SQL externe 104
Guide d'accès aux données
187
Index
J
JavaBean
Classe JavaBean 113
Format d'URL 114
JavaBean, classe 113
JavaBean, exemple de fichier SBO 42
JavaBean, paramètres SBO 113
JDBC
Classe JDBC 115
Clé primaire disponible 116
clés étrangères disponibles 115
générique 38
JDBC, classe 115
JDBC, connexions
créer 37
JDBC,connexions
à propos de 36
jdbc.sbo 37
jeu de caractères 90
K
KEY_INFO_SUPPORTED 148
L
Left_Outer 149
LEFT_OUTER 149
LENMAXFORCOLUMNNAME 150
LENMAXFORTABLENAME 150
LENMAXFORVARCHAR 150
LIKE, clause d'échappement 97
Load Drivers On Startup 65
Lock Mode 119
LongVarcharNotSupported 119
M
Max Pool Time 65
Max_Inlist_Values 151
188
Guide d'accès aux données
middleware
vérifier la connectivité avec la couche
réseau 31
vérifier la disponibilité sur un ordinateur 28
Minus 151
MINUS 151
mode Bibliothèque 68
Mode de transaction 109
mode du serveur 68
MS SQL Server 80
MSOlap CLSID 122
N
Native Int64 Available 118
NO_DISTINCT 151
Nombre maximal de lignes disponibles 98
O
ODBC
Chaîne vide 117
exposer une couche de base de données
en mode serveur 73
Forcer la fermeture de l'instruction 118
Generic ODBC2 43
Generic ODBC3 45
Native Int64 Available 118
ODBC Cursors 119
pilotes DataDirect 80
SQLDescribeParam disponible 119
SQLMoreResults disponible 120
Statut de connexion disponible 117
utiliser le pilote OEM DataDirect 120
ODBC Cursors 119
ODBC, connexions
à propos de 42
OLAP_Clause 153
OLAP_CLAUSE 153
OLE DB
Enumerator CLSID 121
Provider CLSID 121
Index
OLE DB OLAP
MSOlap CLSID 122
Optimize Execute 98
Oracle
exemple de vérification de la connectivité
33
types de données 174
OUTERJOINS_GENERATION 153
OVER_CLAUSE 157
OWNER 158
P
paramètres
informations de référence sur les
paramètres des fichiers CFG 62
Paramètres régionaux 97
paramètres SQL
liste dans les fichiers PRM 134
paramètres, configuration des types 60
pilote.sbo, paramètres
Lock Mode 119
LongVarcharNotSupported 119
pilotes
DataDirect 80
vérifier la disponibilité sur un ordinateur 30
vérifier la validation 30
pilotes d'accès aux données
à propos de 13
configurer les paramètres 76
fichiers PRM 126
fichiers utilisés par 15
rechercher les pilotes installés 25
sélectionner 69
vérifier la disponibilité sur un ordinateur 30
vérifier la validation 30
pilotes de marque 80
pilotes Java 36
ping, vérifier l'accès à la base de données 33
PREFIX_SYS_TABLE 159
prise en charge des couches réseau, liste 24
PRM, fichier
liste de référence 134
liste des fichiers 126
référence 126
PRM, fichiers
à propos du texte d'aide des fonctions 131
BACK_QUOTE_SUPPORTED 134
CASE_SENSITIVE 135
CHECK_OWNER_STATE 135
CHECK_QUALIFIER_STATE 136
COMMA 137
CONCAT 137
DATABASE_DATE_FORMAT 138
DATATYPE_BLOB 139
DATATYPE_DOUBLE 139
DATATYPE_DTM 139
DATATYPE_INT 140
DATATYPE_NULL 140
DATATYPE_STRING 140
DATE_WITHOUT_QUOTE 141
DELIMIT_IDENTIFIERS 141
EXT_JOIN 142
EXT_JOIN_INVERT 143
EXTERN_SORT_EXCLUDE_DISTINCT
143
GROUPBY_EXCLUDE_COMPLEX 144
GROUPBY_WITH_ALIAS 145
GROUPBY_WITHOUT_CONSTANT 145
GROUPBYCOL 146, 147, 152, 158,
161, 164
IDENTIFIER_DELIMITER 146
INTERSECT 148
KEY_INFO_SUPPORTED 148
LEFT_OUTER 149
LENMAXFORCOLUMNNAME 150
LENMAXFORTABLENAME 150
LENMAXFORVARCHAR 150
MINUS 151
modifier 131
modifier le texte d'aide 132
NO_DISTINCT 151
OLAP_CLAUSE 153
Guide d'accès aux données
189
Index
PRM, fichiers (suite)
OUTERJOINS_GENERATION 153
OVER_CLAUSE 157
OWNER 158
PREFIX_SYS_TABLE 159
QUALIFIER 159
QUOTE_OWNER 160
REFRESH_COLUMNS_TYPE 161
REVERSE_TABLE_WEIGHT 162
RIGHT_OUTER=$(+) 162
RISQL_FUNCTIONS 163
SORT_BY_NO 164
structure 129
UNICODE_PATTERN 165
UNION 166
USER_INPUT_DATE_FORMAT 166
USER_INPUT_NUMERIC_SEPARATOR
167
visualiser 131
procédures stockées
à propos des connexions JavaBean 40
Propriétaires disponibles 99
Protocols
fichier CFG 73
Provider CLSID 121
Q
Qualificateurs disponibles 101
QUALIFIER 159
Quote_Owner 160
QUOTE_OWNER 160
R
Red Brick
prise en charge de TIME dans WHERE 176
types de données 175
Refresh_Columns_Type 161
REFRESH_COLUMNS_TYPE 161
REVERSE_TABLE_WEIGHT 162
RIGHT_OUTER=$(+) 162
190
Guide d'accès aux données
RISQL_FUNCTIONS 163
S
SBO, fichiers
Array Bind Available 87
Array Bind Size 87
Array Fetch disponible 88
Array Fetch Size 88
Capacités du pilote 93
Caractère d'échappement 93
Casse d'identificateur entre guillemets 102
Casse de l'identificateur 96
catégories de paramètres 84
Chaîne de signal des identificateurs 96
Chaîne vide 117
Classe JavaBean 113
Classe JDBC 115
Clause d'échappement LIKE 97
Clé primaire disponible 116
clés étrangères disponibles 115
configurer une connexion JDBC 37
Connexion partageable 91
Connexion partagée 104
Connexion unique disponible 107
Coût estimé disponible 92
Cryptage du mot de passe 100
Description File 92
Enumerator CLSID 121
Expiration de la requête disponible 102
Extensions 94
Facteur de taille de champ 95
Family 94
Fichier SQL externe 104
Forcer l'exécution 95
Forcer la fermeture de l'instruction 118
Format d'URL 114
Identificateur entre guillemets 122
installé 77
jeu de caractères 90
Mode de transaction 109
modifier 79
Index
SBO, fichiers (suite)
MSOlap CLSID 122
Native Int64 Available 118
Nombre maximal de lignes disponibles 98
ODBC Cursors 119
Optimize Execute 98
paramètres des bases de données 84
paramètres par défaut 84
Paramètres régionaux 97
Propriétaires disponibles 99
Provider CLSID 121
Qualificateurs disponibles 101
Séparateur de catalogue 90
SQL Parameter File 105
SQLDescribeParam disponible 119
SQLMoreResults disponible 120
Statut de connexion disponible 117
Strategies File 107
structure 84
Taille maximale des données XML 110
Taille maximale du nom de catalogue 89
Taille maximale du nom de colonne 91
Taille maximale du nom de paramètre de
procédure 101
Taille maximale du nom de procédure 100
Taille maximale du nom de schéma 103
Taille maximale du nom de table 108
Transaction Available 108
Type 110
Unicode 112
utiliser le pilote OEM DataDirect 120
V5toV6DriverName 112
Version 110
visualiser 79
Séparateur de catalogue 90
SORT_BY_NO 164
SQL External Extension 67
SQL Parameter Extension 67
SQL Parameter File 105
SQL Server
types de données 173
SQLDescribeParam disponible 119
SQLMoreResults disponible 120
Statut de connexion disponible 117
Strategies Extension 68
Strategies File 107
Sybase
exemple de vérification de la connectivité
33
Identificateur entre guillemets 122
types de données 177
T
Tables de conversion 170
Taille de champ, facteur 95
Taille maximale des données XML 110
Taille maximale du nom de catalogue 89
Taille maximale du nom de colonne 91
Taille maximale du nom de paramètre de
procédure 101
Taille maximale du nom de procédure 100
Taille maximale du nom de schéma 103
Taille maximale du nom de table 108
Teradata
types de données 178
Transaction Available 108
Transient Object Timeout 68
Type 110
types de données
IBM DB2 170
Informix 172
Oracle 174
Red Brick 175
SQL Server 173
Sybase 177
Teradata 178
U
Unicode 112
UNICODE_PATTERN 165
UNION 166
Guide d'accès aux données
191
Index
univers, paramètres
FORCE_SORTED_LOV 138
URL, format 114
USER_INPUT_DATE_FORMAT 166
USER_INPUT_NUMERIC_SEPARATOR 167
utiliser le pilote OEM DataDirect 120
V
V5toV6DriverName 112
192
Guide d'accès aux données
vérifier l'accès à la base de données 33
version 110
W
Web Intelligence Rich Client
à propos de la création de connexions 54
définir une clé de registre 56
">