Manuale dell'accesso ai dati BusinessObjects XI 3.1 Service Pack 2 Copyright © 2009 SAP® BusinessObjects™. Tutti i diritti riservati. SAP BusinessObjects e i relativi loghi, 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® e Xcelsius® sono marchi o marchi registrati di Business Objects, società del gruppo SAP e/o delle società affiliate negli Stati Uniti e/o in altri Paesi. SAP® è un marchio registrato di SAP AG in Germania e/o in altri Paesi. Tutti gli altri nomi citati nel presente documento sono marchi dei rispettivi proprietari. 2009-05-27 Sommario Capitolo 1 Introduzione all'accesso ai dati 11 Informazioni su Connection Server...........................................................12 Componenti di una connessione...............................................................12 Informazioni sull'architettura del sistema.............................................13 Informazioni sui driver di accesso ai dati.............................................13 Informazioni sui file di configurazione per l'accesso ai dati.......................14 Informazioni sul file di configurazione globale cs.cfg...........................15 Informazioni sui file di configurazione dei driver *.sbo.........................15 Capitolo 2 Creazione di una connessione 19 Requisiti di connessione............................................................................20 Controllo della configurazione delle connessioni.......................................20 Visualizzazione della guida relativa allo strumento cscheck ...............21 Per eseguire lo strumento cscheck......................................................22 Strumento di controllo (cscheck) - Panoramica della funzione............23 Strumento cscheck - Funzione list.......................................................24 Strumento cscheck - Funzione driverssearch......................................25 Strumento cscheck - Funzione find......................................................26 Strumento cscheck - Funzione middleware.........................................28 Strumento cscheck - Funzione accessdriver.......................................29 Strumento cscheck - Funzione connectivity.........................................31 Strumento cscheck - Funzione ping ....................................................33 Informazioni sulle connessioni JDBC .......................................................35 Creazione di una connessione JDBC .......................................................36 Struttura file di esempio SBO JDBC.....................................................37 Per creare una connessione JDBC generica............................................38 Manuale dell'accesso ai dati 3 Sommario Struttura file di esempio SBO JDBC generico......................................39 Informazioni sulle connessioni JavaBean..................................................40 Per creare una connessione JavaBean.....................................................40 Struttura file di esempio SBO JavaBean .............................................41 Informazioni sulle connessioni ODBC.......................................................42 Per creare una connessione ODBC generica...........................................43 Per creare una connessione ODBC3 generica.........................................44 Capitolo 3 Creazione di una connessione a Data Federator Query Server 47 Informazioni sulle connessioni a Data Federator Query Server................48 Configurazione della procedura guidata Nuova connessione per una connessione JDBC o ODBC a Data Federator.........................................49 Configurazione delle connessioni JDBC Data Federator..........................50 Configurazione di Connection Server per una connessione JDBC a Data Federator..............................................................................................50 Configurazione delle connessioni ODBC Data Federator.........................51 Configurazione del middleware ODBC Data Federator ......................52 Configurazione di Connection Server per una connessione ODBC a Data Federator..............................................................................................53 Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator..................................53 Configurazione del middleware ODBC Data Federator per una connessione Web Intelligence Rich Client...........................................55 Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator............................................56 Impostazione della chiave di registro di Web Intelligence Rich Client .56 Configurazione di Connection Server per connessioni di Web Intelligence Rich Client e Universe Designer a Data Federator..............................57 Capitolo 4 Configurazione dei parametri globali di accesso ai dati 59 Informazioni sui parametri globali..............................................................60 Informazioni sul file di configurazione cs.cfg.............................................60 4 Manuale dell'accesso ai dati Sommario Per visualizzare e modificare il file cs.cfg..................................................61 Configurazione dei parametri predefiniti dei driver....................................61 Configurazione dei parametri delle impostazioni globali...........................62 Charset List Extension.........................................................................63 Config File Extension...........................................................................63 Description Extension...........................................................................63 Enable Failed Load..............................................................................64 Load Drivers On Startup.......................................................................65 Max Pool Time......................................................................................65 SQL External Extension.......................................................................67 SQL Parameter Extension....................................................................67 Strategies Extension............................................................................68 Configurazione del metodo di accesso......................................................68 Configurazione del filtro del driver.............................................................69 Impostazione di una connettività per computer....................................71 Configurazione dei protocolli di accesso CORBA.....................................72 Capitolo 5 Configurazione dei parametri dei driver di accesso ai dati 73 Configurazione dei parametri del driver.....................................................74 File di configurazione per l'accesso ai dati...........................................74 File SBO installati.................................................................................75 Per visualizzare e modificare un file SBO............................................77 Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect..................................................................................................77 Per abilitare l'uso di driver DataDirect con marchio.............................78 Capitolo 6 Riferimento ai parametri SBO 81 Categorie parametri SBO..........................................................................82 Struttura dei file SBO.................................................................................82 Parametri SBO predefiniti..........................................................................85 Manuale dell'accesso ai dati 5 Sommario Array Bind Available.............................................................................85 Array Bind Size.....................................................................................85 Array Fetch Available...........................................................................86 Dimensioni array fetch..........................................................................86 Catalog Name Max Size.......................................................................87 Catalog Separator................................................................................87 Charset.................................................................................................88 Column Name Max Size.......................................................................88 Connection Shareable..........................................................................89 Cost Estimate Available.......................................................................89 Description File.....................................................................................90 Driver Capabilities................................................................................90 Escape Character.................................................................................91 Extensions............................................................................................91 Family...................................................................................................92 Field Size Factor..................................................................................92 Force Execute......................................................................................92 Identifier Case......................................................................................93 Identifier Quote String..........................................................................94 LIKE Escape Clause............................................................................95 Impostazioni internazionali...................................................................95 Max Rows Available.............................................................................96 Optimize Execute.................................................................................96 Owners Available.................................................................................97 Password Encryption............................................................................97 Procedure Name Max Size..................................................................98 Procedure Parameter Name Max Size................................................99 Qualifiers Available...............................................................................99 Query TimeOut Available...................................................................100 Quoted Identifier Case.......................................................................100 Schema Name Max Size....................................................................101 6 Manuale dell'accesso ai dati Sommario Shared Connection.............................................................................101 SQL External File...............................................................................102 SQL Parameter File............................................................................102 SSO Available....................................................................................104 Strategies File....................................................................................104 Table Name Max Size........................................................................105 Transactional Available......................................................................105 Transaction Mode...............................................................................106 Tipo.....................................................................................................107 Versione.............................................................................................107 XML Max Size....................................................................................107 Parametri SBO Informix...........................................................................108 Per modificare il file ODBC.INI di Informix.........................................108 V5toV6DriverName............................................................................109 Unicode..............................................................................................109 Parametri SBO JavaBean........................................................................110 JavaBean Class.................................................................................110 Formato URL......................................................................................111 Parametri SBO JDBC..............................................................................112 ForeignKeys Available........................................................................112 JDBC Class........................................................................................112 PrimaryKey Available.........................................................................113 Parametri SBO ODBC.............................................................................113 Connection Status Available..............................................................114 Empty String.......................................................................................114 Force Close Statement.......................................................................115 Native Int64 Available.........................................................................115 ODBC Cursors...................................................................................115 SQLDescribeParam Available............................................................116 SQLMoreResults Available................................................................116 Use DataDirect OEM Driver...............................................................117 Manuale dell'accesso ai dati 7 Sommario Parametri SBO OLE DB..........................................................................118 Enumerator CLSID.............................................................................118 Provider CLSID..................................................................................118 Parametri SBO OLAP OLE DB................................................................119 MSOlap CLSID...................................................................................119 Sybase ASE/CTLIB.................................................................................119 Quoted Identifier.................................................................................119 Capitolo 7 Configurazione dei parametri di generazione SQL 121 Informazioni sui parametri di generazione SQL......................................122 Informazioni sui file PRM.........................................................................122 Struttura dei file dei parametri PRM...................................................125 Per visualizzare e modificare un file PRM...............................................127 Per visualizzare e modificare un file di testo della guida alle funzioni.....127 Modifica del testo della guida per una funzione del file PRM..................128 Capitolo 8 Riferimento ai parametri PRM 129 Riferimento alla configurazione dei file PRM...........................................130 BACK_QUOTE_SUPPORTED..........................................................130 CASE_SENSITIVE.............................................................................131 CHECK_OWNER_STATE..................................................................131 CHECK_QUALIFIER_STATE.............................................................132 COMMA..............................................................................................133 CONCAT............................................................................................133 CONSTANT_SAMPLING_SUPPORTED...........................................134 DATABASE_DATE_FORMAT............................................................134 DATATYPE_BLOB..............................................................................135 DATATYPE_DOUBLE........................................................................135 DATATYPE_DTM...............................................................................135 DATATYPE_INT.................................................................................136 8 Manuale dell'accesso ai dati Sommario DATATYPE_NULL..............................................................................136 DATATYPE_STRING .........................................................................136 DATE_WITHOUT_QUOTE ...............................................................137 DELIMIT_IDENTIFIERS.....................................................................137 EXT_JOIN..........................................................................................138 EXT_JOIN_INVERT...........................................................................138 EXTERN_SORT_EXCLUDE_DISTINCT...........................................139 GROUPBY_EXCLUDE_COMPLEX...................................................139 GROUPBY_WITH_ALIAS..................................................................140 GROUPBY_WITHOUT_CONSTANT.................................................141 GROUPBYCOL..................................................................................142 IDENTIFIER_DELIMITER..................................................................142 IF_NULL.............................................................................................143 INTERSECT.......................................................................................144 KEY_INFO_SUPPORTED.................................................................144 LEFT_OUTER....................................................................................145 LENMAXFORCOLUMNNAME...........................................................146 LENMAXFORTABLENAME...............................................................146 LENMAXFORVARCHAR....................................................................146 MINUS................................................................................................147 NO_DISTINCT...................................................................................147 NULL_IN_SELECT_SUPPORTED....................................................148 OLAP_CLAUSE.................................................................................149 OUTERJOINS_GENERATION...........................................................149 OVER_CLAUSE.................................................................................153 OWNER..............................................................................................153 PERCENT_RANK_SUPPORTED......................................................154 PREFIX_SYS_TABLE........................................................................154 QUALIFIER........................................................................................155 QUOTE_OWNER...............................................................................156 RANK_SUPPORTED.........................................................................156 Manuale dell'accesso ai dati 9 Sommario REFRESH_COLUMNS_TYPE...........................................................157 REVERSE_TABLE_WEIGHT.............................................................157 RIGHT_OUTER..................................................................................158 RISQL_FUNCTIONS..........................................................................159 SEED_SAMPLING_SUPPORTED.....................................................159 SORT_BY_NO...................................................................................160 UNICODE_PATTERN........................................................................161 UNION................................................................................................161 USER_INPUT_DATE_FORMAT........................................................162 USER_INPUT_NUMERIC_SEPARATOR..........................................163 Capitolo 9 Riferimento per la conversione dei tipi di dati 165 Conversione dei tipi di dati ......................................................................166 IBM DB2.............................................................................................166 Informix...............................................................................................168 Microsoft SQL Server.........................................................................169 Oracle.................................................................................................170 Red Brick............................................................................................171 Per aggiungere il supporto per TIME e TIMESTAMP in una clausola WHERE..............................................................................................172 Sybase...............................................................................................173 Teradata.............................................................................................174 10 Appendice A Ulteriori informazioni 177 Indice 181 Manuale dell'accesso ai dati Introduzione all'accesso ai dati 1 1 Introduzione all'accesso ai dati Informazioni su Connection Server Informazioni su Connection Server Connection Server è il software di accesso ai dati che gestisce la connessione tra l'applicazione BusinessObjects e l'origine dati. Connection Server consente alle applicazioni quali Universe Designer e Web Intelligence di connettersi a un'origine dati ed eseguire query nei confronti di essa. Connection Server non è dotato di un'interfaccia utente. È possibile creare e amministrare le connessioni dall'interfaccia utente delle applicazioni oppure modificando i file di configurazione di Connection Server. • Creazione delle connessioni: creare le connessioni utilizzando la procedura guidata di connessione. • Ottimizzazione dell'accesso ai dati: è possibile ottimizzare la modalità in cui i dati transitano da Connection Server modificando i file di configurazione di accesso ai dati. Si tratta di file in formato XML installati con Connection Server. È possibile impostare i valori dei parametri da applicare a un driver specifico di accesso ai dati o a tutti i driver di accesso ai dati installati. Componenti di una connessione Una connessione di accesso ai dati è costituita dai seguenti componenti: • Connection Server è il software che gestisce la connessione tra l'applicazione e l'origine dati. Ad esempio, Connection Server gestisce le richieste di dati provenienti dall'applicazione. 12 • Un driver di accesso ai dati è il componente software specifico del database che gestisce la connessione tra Connection Server e il middleware del database. • I file di configurazione definiscono i parametri per configurare la connessione tra: • l'applicazione e Connection Server • l'applicazione e il driver di accesso ai dati • Connection Server il driver di accesso ai dati Manuale dell'accesso ai dati Introduzione all'accesso ai dati Componenti di una connessione Informazioni sull'architettura del sistema Il seguente diagramma descrive in dettaglio dove vengono installati Connection Server e i driver di accesso ai dati in una configurazione BusinessObjects Enterprise. Informazioni sui driver di accesso ai dati I driver di accesso ai dati consentono la connessione tra Connection Server e un'origine dati. Un database richiede un driver di accesso ai dati per consentire l'accesso da un'applicazione Business Objects. Le applicazioni Business Objects includono driver di accesso ai dati che è possibile utilizzare per configurare le connessioni ai database. I driver di accesso ai dati inclusi possono dipendere dalla licenza in uso. Manuale dell'accesso ai dati 13 1 1 Introduzione all'accesso ai dati Informazioni sui file di configurazione per l'accesso ai dati Per poter creare una connessione a un database per il quale non si dispone dei relativi driver, è necessario per prima cosa ottenere i driver richiesti. Per ottenere un driver sono disponibili le seguenti opzioni: • Contattare il rappresentante Business Objects di fiducia per determinare se è disponibile un driver e se si dispone della licenza per utilizzarlo. • Utilizzare il DDK (Driver Development Kit) per sviluppare un driver da utilizzare. Per i dettagli, contattare il rappresentante Business Objects di fiducia. Quando si crea una nuova connessione, si seleziona il driver di accesso ai dati adatto all'origine dati di destinazione. Ad esempio, se si accede a un database Oracle 10g, è necessario installare il middleware adeguato (client Oracle 10g), quindi il driver di accesso ai dati Oracle BusinessObjects. Per un elenco aggiornato dei driver di accesso ai dati supportati, visitare il sito del Service Marketplace di SAP all'indirizzo http://service.sap.com/bosapsupport o contattare il rappresentante Business Objects di fiducia. Per ulteriori informazioni su DDK, consultare Data Access Driver Java SDK Developer Guide all'indirizzo http://boc.sdn.sap.com. Informazioni sui file di configurazione per l'accesso ai dati I file di configurazione di accesso ai dati vengono installati con BusinessObjects Enterprise. I file di configurazione possono essere suddivisi in due livelli: • Livello globale: il file di configurazione cs.cfg viene applicato a tutte le connessioni. • Livello driver: per ogni driver specifico esiste un file di configurazione *.sbo. Oltre ai file di configurazione che controllano una connessione, ciascun driver di accesso ai dati contiene un file di configurazione .prm associato. Questi file vengono utilizzati dalle applicazioni quali Universe Designer. I file .prm controllano in che modo un'applicazione genera codice SQL in base alle funzionalità del software di database. 14 Manuale dell'accesso ai dati Introduzione all'accesso ai dati Informazioni sui file di configurazione per l'accesso ai dati Nota: In questo manuale, la variabile dir-installazione-connectionserver è il percorso principale di installazione dei file di accesso ai dati utilizzati dalle applicazioni BusinessObjects. In Microsoft Windows, per impostazione predefinita dir-installazione-connectionserver è: C:\Programmi\Business Objects\BusinessObjects Enterprise 12.0\win32_x86\dataAccess. Avvertenza: Nei file di configurazione di accesso ai dati, utilizzare il segno escape \ con la barra rovesciata \ nei percorsi dei file se il software BusinessObjects Enterprise viene distribuito su una piattaforma Microsoft Windows. Informazioni sul file di configurazione globale cs.cfg Il file di configurazione globale cs.cfg utilizzato da tutti i driver di accesso ai dati è installato nel seguente percorso: • connectionserver-install-dir \connectionServer Il file cs.cfg contiene i parametri che vengono applicati a tutti i driver di accesso ai dati installati. Argomenti correlati • Informazioni sui parametri globali a pagina 60 Informazioni sui file di configurazione dei driver *.sbo I file di configurazione utilizzati dai driver di accesso ai dati vengono installati nel seguente percorso: • in un sistema Windows: connectionserver-install-dir \connectionServer\RDBMS • in un sistema Unix: connectionserver-install-dir /RDBMS/connectionServer Manuale dell'accesso ai dati 15 1 1 Introduzione all'accesso ai dati Informazioni sui file di configurazione per l'accesso ai dati dove RDBMS è il nome della tecnologia di database che utilizza il file di configurazione. I file elencati di seguito contengono parametri riguardanti i driver di accesso ai dati installati. File specifico di È possibile modiDescrizione driver ficarlo? <driver>.sbo <driver>.prm 16 Manuale dell'accesso ai dati Esempio Sì Esiste un file .sbo per ogni protocollo di rete supportato o middleware del database utilizzato per il collegaoracle.sbo mento a un database. Definisce la configurazione della connessione specifica per ciascun database. Sì Definisce i parametri che determinano il modo in oracle.prm cui un'applicazione genera l'SQL. Introduzione all'accesso ai dati Informazioni sui file di configurazione per l'accesso ai dati File specifico di È possibile modiDescrizione driver ficarlo? <driver><lin gua>.cod No Esempio Contiene le informazioni relative alle definizioni della connessione. Definisce i campi visualizzati quando viene oracleen.cod creata una nuova connessione. Nota: Questi file non devono essere modificati. Argomenti correlati • • • Categorie parametri SBO a pagina 82 Riferimento alla configurazione dei file PRM a pagina 130 Informazioni sui parametri di generazione SQL a pagina 122 Manuale dell'accesso ai dati 17 1 1 Introduzione all'accesso ai dati Informazioni sui file di configurazione per l'accesso ai dati 18 Manuale dell'accesso ai dati Creazione di una connessione 2 2 Creazione di una connessione Requisiti di connessione Requisiti di connessione In questa sezione sono illustrati i requisiti per la creazione di una connessione. • Verificare che la piattaforma sia del tipo supportato per le connessioni Business Objects. • Verificare che il middleware del database sia installato correttamente e di essere in grado di accedere al database tramite il computer o un server. • Verificare di essere in possesso di tutte le informazioni necessarie per accedere al database, ad esempio il nome di accesso e la password per il database. • Installare la soluzione Business Objects da utilizzare, incluso il driver di accesso dati appropriato. • Verificare che tutti i servizi siano stati avviati correttamente. • Fare riferimento al documento Leggimi accluso alla soluzione Business Objects per verificare eventuali modifiche alla configurazione necessarie all'ambiente e al software in uso. • Fare riferimento alle note sulla versione relative all'accesso ai dati per cercare eventuali modifiche alla configurazione che potrebbero influire sull'ambiente in uso. Nota: è possibile utilizzare lo strumento cscheck per controllare l'infrastruttura e stabilire se è adatta per essere utilizzata con le applicazioni Business Objects. Argomenti correlati • Controllo della configurazione delle connessioni a pagina 20 Controllo della configurazione delle connessioni Il software Connection Server include una utilità della riga di comando che è possibile utilizzare per controllare l'infrastruttura delle connessioni alle origini dati. È possibile utilizzare lo strumento cscheck per controllare in qualsiasi momento il middleware dei client e i driver di accesso ai dati. 20 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni Nota: i risultati dei controlli eseguiti sono validi per il computer locale, dal quale viene eseguito lo strumento. Lo strumento cscheck viene installato nella directory seguente: dir-ins tallazione-connectionserver/connectionServer/tools Per eseguire lo strumento cscheck, è necessario utilizzare una console dei comandi (DOS o Shell). L'output viene visualizzato sullo schermo. È possibile reindirizzare l'output in un file in formato XML oppure sopprimere l'output per utilizzare lo strumento in uno script. Con lo strumento cscheck è possibile eseguire le funzioni seguenti sul computer locale: • restituire i dettagli di tutte le connettività; ovvero i database e i livelli di rete che l'installazione è in grado di supportare • restituire i dettagli di tutti i driver di accesso ai dati installati sul computer locale • restituire i dettagli di tutte le connettività installate sul computer locale • verificare la validità dell'installazione del middleware per un livello di rete e un client di database specifici • verificare la validità dell'installazione dei driver di accesso ai dati per un livello di rete e un client di database specifici • verificare se è possibile stabilire la connessione a un database specifico Argomenti correlati • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck Lo strumento cscheck consente di: • visualizzare la guida generale relativa all'utilità cscheck • visualizzare la guida relativa a ciascuna funzione specifica dello strumento cscheck Manuale dell'accesso ai dati 21 2 2 Creazione di una connessione Controllo della configurazione delle connessioni La guida può essere visualizzata in qualsiasi lingua scelta al momento dell'installazione della soluzione Business Objects. Per visualizzare la guida generale dello strumento cscheck, utilizzare la sintassi seguente: Figura 2 - 1: Sintassi per visualizzare la guida del comando cscheck --help|h --language|l { lingua } Per visualizzare la guida di una funzione, utilizzare la sintassi seguente, dove nomefunzione è il nome della funzione di cui si desidera visualizzare la guida e lingua è la lingua in cui si desidera visualizzare la guida: Figura 2 - 2: Sintassi per visualizzare la guida della funzione cscheck --help|h { nomefunzione }--language|l{ lingua } Esempio: Per visualizzare la guida in inglese dello strumento cscheck, utilizzare il comando seguente: cscheck --help Per visualizzare la guida in francese relativa alla funzione connectivity, utilizzare il comando seguente: cscheck --language fr --help connectivity Per eseguire lo strumento cscheck È possibile eseguire lo strumento cscheck in qualsiasi momento dopo aver installato il software della soluzione Business Objects. 1. Aprire una console dei comandi. 2. Passare alla directory in cui è installato lo strumento. 3. Immettere cscheck con i parametri corretti per trovare le informazioni desiderate. 4. Visualizzare le informazioni restituite. Argomenti correlati • 22 Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni Strumento di controllo (cscheck) - Panoramica della funzione Da una console dei comandi, utilizzare il comando cscheck con la funzione e gli argomenti appropriati per restituire i risultati desiderati. Il comando cscheck ha la struttura seguente. Alcuni dei parametri sono facoltativi. Figura 2 - 3: sintassi del comando cscheck cscheck --language|l { lingua output }--xml|x--mute|m nome funzioneopzioni funzione La prima parte del comando controlla il formato dell'output: • <lingua output> oppure l seguito dalla lingua specificata nello standard ISO-639. Questa operazione è facoltativa. La lingua predefinita è l'inglese. • --xml oppure x specifica che l'output è in formato XML. Questa operazione è facoltativa. Per impostazione predefinita, l'output è in formato testo visualizzato sullo schermo. • --mute specifica che non deve essere generato alcun output. Utilizzare questo parametro se lo strumento viene utilizzato in uno script per controllare lo stato restituito. Questa operazione è facoltativa. Per impostazione predefinita, l'output viene generato. La parte rimanente del comando è costituita dalla funzione e dai relativi argomenti. <nome funzione> può avere i valori seguenti. Ciascuna funzione prevede una sintassi breve che può essere utilizzata al posto del nome completo della funzione: • list o lt • driverssearch o ds • find o fd • middleware o mw • accessdriver o ad • connectivity o ct Manuale dell'accesso ai dati 23 2 2 Creazione di una connessione Controllo della configurazione delle connessioni • ping o pg Argomenti correlati • • • • • • • Strumento cscheck - Funzione accessdriver a pagina 29 Strumento cscheck - Funzione connectivity a pagina 31 Strumento cscheck - Funzione driverssearch a pagina 25 Strumento cscheck - Funzione find a pagina 26 Strumento cscheck - Funzione list a pagina 24 Strumento cscheck - Funzione middleware a pagina 28 Strumento cscheck - Funzione ping a pagina 33 Strumento cscheck - Funzione list Questa funzione restituisce un elenco dei livelli di rete e moduli di gestione del database supportati. Ad esempio, è possibile utilizzare questa funzione per determinare i valori corretti da utilizzare con le altre funzioni dello strumento cscheck. Nota: Questa funzione restituisce l'elenco completo dei driver di accesso ai dati e middleware supportati, inclusi quelli che non devono essere necessariamente installati sul computer. Figura 2 - 4: Sintassi della funzione list cscheck |list||lt| Esempio: Il comando seguente elenca tutti i livelli di rete e moduli di gestione del database supportati dalla soluzione Business Objects installata sul computer corrente. cscheck list Di seguito viene riportato un estratto dell'elenco dei risultati. Oracle Client Oracle 9 Oracle 10 Oracle 11 24 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni Sybase Open Client Sybase Adaptive Server 12 Sybase Adaptive Server 15 Informix ODBC Driver 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 ... Argomenti correlati • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione driverssearch Questa funzione restituisce un elenco dei driver di accesso ai dati installati. Figura 2 - 5: Sintassi della funzione driverssearch cscheck |driverssearch||ds| Esempio: Il comando seguente elenca tutti i driver di accesso ai dati installati sul computer. cscheck driverssearch Di seguito viene riportato un estratto dell'elenco dei risultati. This access driver is installed: Oracle OCI access driver Client layer: Oracle Client Database engine(s): Oracle 9 Oracle 10 Manuale dell'accesso ai dati 25 2 2 Creazione di una connessione Controllo della configurazione delle connessioni Oracle 11 This access driver is installed: Sybase Open Client access driver Client layer: Sybase Open Client 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 ... Argomenti correlati • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione find Questa funzione elenca i tipi di connettività disponibili, ovvero i middleware e i client di database a cui è possibile accedere dal computer locale. Le operazioni richieste sono: • tipi di connettività disponibili sul computer locale • tipi di connettività disponibili utilizzando il livello di comunicazione CORBA • tipi di connettività disponibili utilizzando il livello di comunicazione HTTP • Tipi di connettività Java disponibili sul computer locale Figura 2 - 6: Sintassi della funzione find cscheck |find||fd| -m { modalità di accesso Connection Server } 26 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni Tabella 2 - 1: Parametri di input della funzione La modalità con cui l'applicazione client accede a Connection Server: • local: elenca i tipi di connettività disponibili sul computer locale. Modalità di accesso Connection Server (-m) • corba: elenca i tipi di connettività disponibili utilizzando CORBA. • http: elenca i tipi di connettività disponibili utilizzando HTTP. • java: elenca i tipi di connettività Java disponibili sul computer locale. • extended: elenca i tipi di connettività local, java e corba. Esempio: Ricerca dei tipi di connettività locali Il comando seguente restituisce un elenco dei driver di accesso ai dati sul computer locale che possono essere caricati dal Connection Server. cscheck find –m local Di seguito viene riportato un estratto dell'elenco dei risultati. 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 Informix ODBC Driver Informix Dynamic Server 7.3 Informix Dynamic Server 2000 Informix Dynamic Server 10 Manuale dell'accesso ai dati 27 2 2 Creazione di una connessione Controllo della configurazione delle connessioni 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 ... Esempio: Ricerca dei tipi di connettività al server CORBA Il comando seguente restituisce un elenco dei driver di accesso ai dati disponibili da un server CORBA. cscheck find –m corba Argomenti correlati • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione middleware Per un livello di rete e un client di database forniti, questa funzione ricerca un'installazione valida di un middleware client. Per controllare il middleware e il driver di accesso ai dati per un livello di rete e un client di database forniti, è possibile utilizzare la funzione connectivity. Figura 2 - 7: Sintassi della funzione middleware cscheck |middleware||mw|-c { livello di rete }-d{ cliente di database } 28 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni Tabella 2 - 2: Parametri di input della funzione livello di rete (-c) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente ricerca un'installazione valida del middleware Oracle Client 9 sul computer locale. Crea un file di output in formato XML: c:\re sult.xml cscheck --xml middleware -c "Oracle Client" -d "Oracle 9" > c:\result.xml Se il middleware non è installato correttamente, il risultato sarà il seguente: 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. Argomenti correlati • • • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione connectivity a pagina 31 Strumento cscheck - Funzione accessdriver a pagina 29 Strumento cscheck - Funzione accessdriver Per un livello di rete e un client di database forniti, questa funzione ricerca un'installazione valida di un driver di accesso ai dati. Per controllare il Manuale dell'accesso ai dati 29 2 2 Creazione di una connessione Controllo della configurazione delle connessioni middleware e il driver di accesso ai dati per un livello di rete e un client di database forniti, è possibile utilizzare la funzione connectivity. Figura 2 - 8: Sintassi della funzione accessdriver cscheck |accessdriver||ad|-c{ livello di rete }-d{ cliente di database } Tabella 2 - 3: Parametri di input della funzione livello di rete ( -c ) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente ricerca un'installazione valida di un driver di accesso ai dati Oracle 9 e visualizza l'output in lingua francese: cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle 9" Se la lingua francese non è installata, il risultato sarà il seguente: The language specified is not installed. Please use an instal led language. English ([en]). Esempio: Il comando seguente controlla la presenza di un'installazione valida del driver di accesso ai dati Oracle 9: cscheck ad -c "Oracle Client" -d "Oracle 9" Il risultato è il seguente: Starting to check the access driver component installation... Begin AND operator... Config Directory... success. 30 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni %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. Argomenti correlati • • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione list a pagina 24 Strumento cscheck - Funzione connectivity Per il livello di rete e il client di database forniti, questa funzione controlla se il middleware e i driver di accesso ai dati siano entrambi validi. È possibile controllare questi elementi singolarmente utilizzando le funzioni middleware e accessdriver. È possibile utilizzare la funzione ping per controllare se è possibile stabilire la connessione a un database specifico. Figura 2 - 9: Sintassi della funzione connectivity cscheck |connectivity||ct|-c{ livello di rete }-d{ cliente di database } Tabella 2 - 4: Parametri di input della funzione livello di rete (-c) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. Manuale dell'accesso ai dati 31 2 2 Creazione di una connessione Controllo della configurazione delle connessioni client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente controlla il middleware del client Oracle installato e il driver di accesso ai dati Oracle 9. Il comando scrive l'output in un file di testo: c:\result.txt . cscheck -l en connectivity -c "Oracle Client" -d "Oracle 9">c:\result.txt Se il middleware non è installato correttamente, il risultato sarà il seguente: 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. %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. Argomenti correlati • 32 Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Manuale dell'accesso ai dati Creazione di una connessione Controllo della configurazione delle connessioni • • • • • Visualizzazione della guida relativa allo strumento cscheck a pagina 21 Strumento cscheck - Funzione find a pagina 26 Strumento cscheck - Funzione accessdriver a pagina 29 Strumento cscheck - Funzione middleware a pagina 28 Strumento cscheck - Funzione ping a pagina 33 Strumento cscheck - Funzione ping Questa funzione tenta di accedere a un database specifico utilizzando i dettagli forniti. Figura 2 - 10: Sintassi della funzione ping cscheck ping|pg|-m{ modalità di accesso Connection Server }-c{ livello di rete }-d{ cliente di database }-u{ nome utente }-p{ password }-s{ origine dati }-t{ database }-r{ nome host }-j{ PID } Tabella 2 - 5: Parametri di input della funzione La modalità con cui l'applicazione client accede a Connection Server: • local: Connection Server è in esecuzione sul computer locale. Modalità di accesso Connection Server (-m) livello di rete (-c) • corba: Connection Server è in esecuzione su un server CORBA. • http: Connection Server è in esecuzione su un server HTTP. • java: Connection Server utilizza un driver di accesso ai dati Java sul computer locale. La connessione al middleware del database da controllare, restituita dalla funzione find. Manuale dell'accesso ai dati 33 2 2 Creazione di una connessione Controllo della configurazione delle connessioni client di database (-d) Il tipo di database, restituito dalla funzione find. nome utente (-u) Un nome utente valido per il database. password (-p) La password associata al nome utente. origine dati (-s) Il server in cui è in esecuzione il database. database (-t) Il server di database. nome host (-r) Per la modalità CORBA, il computer in cui risiede Connection Server. PID (-i) Per la modalità CORBA, il numero di processo del Connection Server a cui eseguire il ping. Esempio: Ping a un database Oracle Il comando seguente controlla l'accesso per: • Modalità di accesso Connection Server: local, ovvero il database viene eseguito sul computer locale. 34 • Livello di rete: Oracle Client • Database: Oracle 8.1 • Origine dati: Harlaxton • Nome utente: efashion Manuale dell'accesso ai dati Creazione di una connessione Informazioni sulle connessioni JDBC • Password: X2345 cscheck ping -m local -c "Oracle Client" -d "Oracle 8.1" -u "efashion" -p "X2345" -s "Harlaxton" Esempio: Ping a un database Sybase utilizzando CORBA Il comando seguente controlla l'accesso per: • Modalità di accesso Connection Server: CORBA, ovvero Connection Server viene eseguito su un server CORBA. • Livello di rete: Sybase • Nome utente: syadmin • Password: password • Origine dati: Sybase Adaptive Server 15 • Database: SY1 • Host database: sybasehost • ID processo: 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 Argomenti correlati • • Strumento di controllo (cscheck) - Panoramica della funzione a pagina 23 Strumento cscheck - Funzione find a pagina 26 Informazioni sulle connessioni JDBC Quando si installa il software dell'applicazione Business Objects, viene installato un insieme di driver di accesso ai dati. È possibile utilizzare i driver di accesso ai dati per creare connessioni ai database. Manuale dell'accesso ai dati 35 2 2 Creazione di una connessione Creazione di una connessione JDBC Il software Business Objects include inoltre file di configurazione per consentire l'utilizzo di driver JDBC per accedere ai database. Per utilizzare i driver, è necessario: • Ottenere il software dei driver Java dal fornitore di database. • Modificare i file di configurazione forniti. Nota: La connettività JDBC è disponibile per BusinessObjects Enterprise XI 3.0 e versioni successive. Avvertenza: Web Intelligence Rich Client non supporta la connettività JDBC nella modalità a 3 livelli. Per un elenco aggiornato dei driver JDBC supportati, visitare il sito del Service Marketplace di SAP all'indirizzo Web http://service.sap.com/bosap-support o contattare il rappresentante BusinessObjects di fiducia. Nota: Il livello di accesso ai dati fornisce connettività JDBC generica per creare una connessione a un'origine dati che BusinessObjects Enterprise non supporta direttamente. Argomenti correlati • • Creazione di una connessione JDBC a pagina 36 Per creare una connessione JDBC generica a pagina 38 Creazione di una connessione JDBC Per creare una connessione JDBC: • Ottenere il software dei driver JDBC necessari per il database e copiare i file nel sistema. Questi file sono disponibili dal fornitore del database. Il software dei driver consiste in genere di uno o più file jar. Annotare i dettagli del percorso di installazione per questi file. • Verificare di disporre dei dettagli di accesso al database, ad esempio dettagli di connessione e password. Per creare una connessione JDBC, utilizzare la seguente procedura: 1. Verificare se il driver richiede DLL aggiuntive e assicurarsi che siano accessibili da parte del sistema. Ad esempio, il driver JDBC di SQL Server 36 Manuale dell'accesso ai dati Creazione di una connessione Creazione di una connessione JDBC 2005 utilizza DLL aggiuntive. La directory relativa a queste DLL deve essere inclusa nella variabile di ambiente PATH. 2. Individuare la directory contenente il file jdbc.sbo. Ad esempio, in Micro soft Windows, i file di configurazione si trovano nella directory dir-ins tallazione-connectionserver\connectionServer\jdbc. 3. Utilizzare un editor XML per aprire il file jdbc.sbo da modificare. 4. Aggiungere i dettagli del file .jar all'area ClassPath. Includere i nomi di percorso completi quando si specificano questi file, ad esempio: <Path>C:\\JDBC Drivers\MSSQLSERVER2000\ msutil.jar</Path> Nota: Questi file devono essere installati sul computer che esegue l'applicazione. Per i dettagli, consultare le informazioni della struttura del file jdbc.sbo di esempio. 5. Individuare il parametro Driver Capabilities e verificare che sia impostato su Procedure o su Queries. In caso contrario, il driver JDBC non è disponibile dall'assistente Nuova connessione. 6. Salvare e chiudere il file .sbo. 7. Eseguire la procedura guidata Nuova connessione. Il driver JDBC configurato viene visualizzato nell'elenco delle connessioni disponibili. Selezionare il driver JDBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione è disponibile per essere utilizzata. Argomenti correlati • • Struttura file di esempio SBO JDBC a pagina 37 Requisiti di connessione a pagina 20 Struttura file di esempio SBO JDBC Esempio della sezione del file SBO JDBC che è necessario modificare. Questo file SBO è valido per Microsoft SQL Server 2000. <DataBase Active="Yes" Name="MS SQL Server 2000"> ... Manuale dell'accesso ai dati 37 2 2 Creazione di una connessione Per creare una connessione JDBC generica <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> Per creare una connessione JDBC generica La procedura seguente mostra come configurare una connessione JDBC generica a un database. Per creare una connessione JDBC generica: • Ottenere il software dei driver JDBC necessari per il database e copiare in file nel sistema. Il file .jar deve essere installato sul computer che esegue l'applicazione Business Objects. • Verificare di disporre dei dettagli di accesso al database, ad esempio dettagli di connessione e password. Per creare una connessione JDBC, utilizzare la seguente procedura: 1. Accedere alla directory che contiene il file jdbc.sbo e jdbc.prm. Ad esempio, in Microsoft Windows, i file di configurazione si trovano nella directory dir-installazione-connectionserver\connectionSer ver\jdbc. 2. Utilizzare un editor XML per aprire il file jdbc.sbo da modificare. 3. Aggiungere i dettagli del file .jar all'area ClassPath. Includere i nomi di percorso completi quando si specificano questi file. Impostare la classe del driver JDBC e il formato URL tramite i parametri appropriati. Per i dettagli, consultare le informazioni della struttura del file jdbc.sbo di esempio. 4. Salvare e chiudere il file jdbc.sbo. 5. Utilizzare un editor XML per aprire il file jdbc.prm da modificare. 6. Aggiungere o aggiornare le informazioni specifiche del database. 38 Manuale dell'accesso ai dati Creazione di una connessione Per creare una connessione JDBC generica Nota: Il file jdbc.prm potrebbe non contenere informazioni sulle specifiche funzioni del database. 7. Salvare e chiudere il file jdbc.prm. 8. Eseguire la procedura guidata Nuova connessione. Il driver JDBC configurato viene visualizzato nell'elenco delle connessioni disponibili in Generico. Selezionare il driver JDBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione all'origine dati è disponibile per essere utilizzata tramite JDBC. Nota: È possibile configurare una sola connessione tramite un'implementazione JDBC generica. Argomenti correlati • Informazioni sui file PRM a pagina 122 Struttura file di esempio SBO JDBC generico Esempio della sezione del file SBO JDBC che è necessario modificare. Questo file SBO è valido per l'origine dati JDBC generica e per il database Ingres. Nota: Il driver Ingres JDBC è costituito dal file iijdbc.jar. La classe com.ingres.jdbc.IngresDriver implementa l'interfaccia 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> Manuale dell'accesso ai dati 39 2 2 Creazione di una connessione Informazioni sulle connessioni JavaBean Nota: $DATASOURCE$ è <host>:<porta> o <host>:<porta>/<database>. Informazioni sulle connessioni JavaBean Gli sviluppatori possono creare JavaBean che forniscono l'accesso alle origini dati. È possibile creare connessioni tramite questi JavaBean. Per stabilire una connessione JavaBean, gli sviluppatori che creano il JavaBean forniranno: • i file .jar necessari • qualsiasi altro file richiesto da JavaBean • tutti i dettagli di configurazione specifici richiesti dal driver JavaBean In un driver JavaBean, le procedure di recupero dei dati sono configurate come stored procedure. Quando si configura una connessione JavaBean, è necessario selezionare la casella di controllo Filtra livello di rete stored procedure nella schermata Selezione del middleware del database della procedura guidata Nuova connessione. In caso contrario, la procedura guidata Nuova connessione non visualizzerà i driver JavaBean disponibili. Per creare una connessione JavaBean Per creare una connessione JavaBean, utilizzare la seguente procedura: 1. Utilizzare un editor XML per aprire il file javabeans.sbo da modificare. Ad esempio, in Microsoft Windows, i file di configurazione si trovano nella directory dir-installazione-connectionserver\connectio nServer\javabean. 2. Aggiungere i dettagli del file .jar all'area ClassPath. Includere i nomi di percorso completi quando si specificano questi file. Nota: Questi file devono essere installati sul computer che esegue l'applicazione Business Objects. Per i dettagli, consultare le informazioni della struttura del file Java Bean.sbo di esempio. 3. Salvare e chiudere il file .sbo. 40 Manuale dell'accesso ai dati Creazione di una connessione Per creare una connessione JavaBean 4. Eseguire le altre attività di configurazione specificate dallo sviluppatore JavaBean. 5. Eseguire la procedura guidata Nuova connessione. L'origine dati JavaBean configurata dovrebbe essere visualizzata nell'elenco delle connessioni disponibili. Selezionare l'origine dati JavaBeans e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione è disponibile per essere utilizzata con un'applicazione. Argomenti correlati • • Struttura file di esempio SBO JavaBean a pagina 41 PrimaryKey Available a pagina 113 Struttura file di esempio SBO JavaBean Questa sezione contiene un esempio di file 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> Manuale dell'accesso ai dati 41 2 2 Creazione di una connessione Informazioni sulle connessioni ODBC Informazioni sulle connessioni ODBC Quando si installa il software dell'applicazione Business Objects, viene installato un insieme di driver di accesso ai dati. È possibile utilizzare i driver di accesso ai dati per creare connessioni ai database. Il software Business Objects include inoltre file di configurazione per consentire l'utilizzo di driver ODBC per accedere ai database. Per utilizzare questi driver, effettuare quanto riportato di seguito: • Ottenere il software del driver ODBC dal fornitore di database. • Modificare i file di configurazione forniti. Per un elenco aggiornato dei driver ODBC supportati, visitare il sito del Service Marketplace di SAP all'indirizzo http://service.sap.com/bosap-support o contattare il rappresentante BusinessObjects di fiducia. Nota: Il livello di accesso ai dati fornisce connettività ODBC generica per creare una connessione a un'origine dati che BusinessObjects Enterprise non supporta direttamente. Informazioni sulle connessioni ODBC generiche Il sistema operativo Microsoft Windows viene fornito con una gestione driver ODBC standard. UNIX invece non fornisce alcun metodo standard per la gestione dei driver. Il software Business Objects consente di utilizzare metodi di gestione driver DataDirect o unixODBC per connessioni ODBC generiche in UNIX. Prima di creare una connessione ODBC generica in UNIX per un database generico, è necessario identificare quanto segue: • • la versione del driver ODBC se il driver supporta la gestione driver DataDirect o unixODBC Modificare quindi i file di configurazione forniti e configurare l'origine dati corrispondente per abilitare la connessione. Nota: È possibile configurare una sola connessione tramite un'implementazione ODBC generica. 42 Manuale dell'accesso ai dati Creazione di una connessione Per creare una connessione ODBC generica Argomenti correlati • • Per creare una connessione ODBC generica a pagina 43 Per creare una connessione ODBC3 generica a pagina 44 Per creare una connessione ODBC generica La procedura seguente mostra come configurare una connessione ODBC generica a un database tenendo presente quanto segue: • Il driver è ODBC2 • il driver supporta la gestione driver unixODBC 1. Accedere alla directory contenente il file odbc.sbo e odbc.prm. I file di configurazione si trovano nella directory dir-installazioneconnectionserver/connectionServer/odbc. 2. Utilizzare un editor XML per aprire il file odbc.sbo da modificare. 3. Individuare la seguente sezione: <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. Aggiungere un commento alle prime due righe di DataDirect e rimuovere il commento da una delle due righe successive. Verificare di aver inserito la riga dalla quale viene rimosso il commento nella parte superiore della sessione, in modo che venga letta prima. Rimuovere il commento dell'elemento <Parameter Name="CharSet Table" Platform="Unix">. Nota: • • dbd_wddodbc2 specifica il driver ODBC2 Unicode basato su DataDirect dbd_ddodbc2 specifica il driver ODBC2 non Unicode basato su DataDirect Manuale dell'accesso ai dati 43 2 2 Creazione di una connessione Per creare una connessione ODBC3 generica • • dbd_wuxodbc2 specifica il driver ODBC2 Unicode basato su unixODBC dbd_uxodbc2 specifica il driver ODBC2 non Unicode basato su unixODBC 5. Salvare e chiudere il file odbc.sbo. 6. Utilizzare un editor XML per aprire il file odbc.prm da modificare. 7. Aggiungere o aggiornare le informazioni specifiche del database. Nota: Il file odbc.prm potrebbe non contenere informazioni sulle specifiche funzioni del database. 8. Salvare e chiudere il file odbc.prm. 9. Installare i driver ODBC corrispondenti sul computer UNIX. 10. Configurare l'origine dati modificando il file odbc.ini. 11. Salvare e chiudere il file odbc.ini. 12. Eseguire la procedura guidata Nuova connessione. Il driver ODBC configurato viene visualizzato nell'elenco delle connessioni disponibili in Generico. Selezionare il driver ODBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione all'origine dati è disponibile per essere utilizzata tramite ODBC generico con la gestione driver unixODBC. Per creare una connessione ODBC3 generica La procedura seguente mostra come configurare una connessione ODBC generica a un database tenendo presente quanto segue: • il driver è ODBC3 • il driver supporta la gestione driver unixODBC 1. Accedere alla directory contenente il file odbc.sbo e odbc.prm. I file di configurazione si trovano nella directory dir-installazioneconnectionserver/connectionServer/odbc. 2. Utilizzare un editor XML per aprire il file odbc.sbo da modificare. 44 Manuale dell'accesso ai dati Creazione di una connessione Per creare una connessione ODBC3 generica 3. Individuare la seguente sezione: <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. Aggiungere un commento alle prime due righe di DataDirect e rimuovere il commento da una delle quattro righe successive. Verificare di aver inserito la riga dalla quale viene rimosso il commento nella parte superiore della sessione, in modo che venga letta prima. Rimuovere il commento dall'elemento <Parameter name="CharSet Table" Platform="Unix">. Nota: • • dbd_wddodbc3 specifica il driver ODBC3 Unicode basato su DataDirect dbd_ddodbc3 specifica il driver ODBC3 non Unicode basato su DataDirect • • dbd_wuxodbc3 specifica il driver ODBC3 Unicode basato su unixODBC dbd_uxodbc3 specifica il driver ODBC3 non Unicode basato su unixODBC • dbd_wux32odbc3 specifica il driver ODBC3 Unicode basato su • unixODBC con API a 32 bit anziché a 64 bit (disponibile solo su piattaforme a 64 bit) dbd_ux32odbc3 specifica il driver ODBC3 non Unicode basato su unixODBC con API a 32 bit anziché a 64 bit (disponibile solo su piattaforme a 64 bit) 5. Salvare e chiudere il file odbc.sbo. 6. Utilizzare un editor XML per aprire il file odbc.prm da modificare. 7. Aggiungere o aggiornare le informazioni specifiche del database. Nota: Il file odbc.prm potrebbe non contenere informazioni sulle specifiche funzioni del database. Manuale dell'accesso ai dati 45 2 2 Creazione di una connessione Per creare una connessione ODBC3 generica 8. Salvare e chiudere il file odbc.prm. 9. Installare i driver ODBC corrispondenti sul computer UNIX. 10. Configurare l'origine dati modificando il file odbc.ini. 11. Salvare e chiudere il file odbc.ini. 12. Eseguire la procedura guidata Nuova connessione. Il driver ODBC configurato viene visualizzato nell'elenco delle connessioni disponibili in Generico. Selezionare il driver ODBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione a Ingres è disponibile per essere utilizzata tramite ODBC3 con la gestione driver unixODBC. 46 Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server 3 3 Creazione di una connessione a Data Federator Query Server Informazioni sulle connessioni a Data Federator Query Server Informazioni sulle connessioni a Data Federator Query Server È possibile creare connessioni a tabelle distribuite in Data Federator Query Server, per utilizzare tali tabelle con un'applicazione Business Objects. Nota: Per ulteriori informazioni sulla connessione a BusinessObjects Data Federator, vedere il Manuale dell'utente di Data Federator e il capitolo relativo alla “connessione a Data Federator Query Server utilizzando i driver JDBC/ODBC”. Questo capitolo descrive le impostazioni aggiuntive da applicare a Data Federator Query Server e i dettagli di configurazione da utilizzare nel Connection Server per creare le connessioni. Il metodo da utilizzare per configurare la connessione varia a seconda che sia stato utilizzato JDBC o ODBC per la connessione. Con le connessioni ODBC, la configurazione dipende dall'applicazione Business Objects utilizzata. Il processo varia nel caso in cui venga creata una connessione da utilizzare con Web Intelligence Rich Client. Il metodo da utilizzare per creare la connessione dipende dall'applicazione utilizzata. Solitamente, per creare la connessione, si utilizza la procedura guidata Nuova connessione relativa all'applicazione. Per ulteriori informazioni, consultare la documentazione utente relativa all'applicazione. Questo capitolo mostra anche la configurazione da applicare nella procedura guidata Nuova connessione delle applicazioni Universe Designer e Web Intelligence, affinché sia possibile creare le connessioni. Avvertenza: Business Objects consiglia di utilizzare una connettività JDBC per connettere le applicazioni Business Objects a Data Federator Query Server. La connettività JDBC è supportata solo in BusinessObjects Enterprise XI 3.0 e versioni successive e non consente connessioni a Desktop Intelligence. La connettività JDBC è disponibile su tutte le piattaforme (Microsoft Windows, UNIX flavors e Linux). La versione ODBC minima che è possibile utilizzare con i seguenti dettagli di configurazione è BusinessObjects Data Federator XI Release 2 SP1 48 Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server Configurazione della procedura guidata Nuova connessione per una connessione JDBC o ODBC a Data Federator MHF1. Se necessario, contattare il proprio rappresentante di vendita Business Objects per ulteriori informazioni sulla versione e su come ottenerla. Il middleware ODBC Data Federator può essere utilizzato solo in Microsoft Windows e l'uso di un bridge OpenAccess ODBC-JDBC ha un certo impatto sulle prestazioni. Argomenti correlati • Configurazione della procedura guidata Nuova connessione per una connessione JDBC o ODBC a Data Federator a pagina 49 • Configurazione delle connessioni JDBC Data Federator a pagina 50 • Configurazione delle connessioni ODBC Data Federator a pagina 51 • Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator a pagina 53 Configurazione della procedura guidata Nuova connessione per una connessione JDBC o ODBC a Data Federator Per creare una connessione a Data Federator Query Server, è necessario reperire le informazioni seguenti. Consultare l'amministratore di BusinessObjects Data Federator per ottenere le informazioni seguenti: • il nome del server e la porta su cui è in esecuzione il server Data Federator. • il nome del catalogo in Data Federator Query Server Nella procedura guidata Nuova connessione è possibile immettere questo nome come nome del database al quale ci sta connettendo. • i dettagli di autenticazione per l'installazione di Data Federator Query Server che serve il catalogo al quale ci si sta connettendo. Nella procedura guidata Nuova connessione, dalla schermata Selezione del middleware del database, per creare la connessione è possibile utilizzare il middleware SAP BusinessObjects, Data Federator Server, driver JDBC o driver ODBC. Per informazioni su come utilizzare la procedura guidata Nuova connessione una volta apportate le modifiche alla configurazione, consultare la documentazione dell'applicazione. Manuale dell'accesso ai dati 49 3 3 Creazione di una connessione a Data Federator Query Server Configurazione delle connessioni JDBC Data Federator Nota: Per configurare una connessione JDBC o ODBC a un Data Federator Query Server, è necessario effettuare ulteriori operazioni di configurazione. Se si utilizza Web Intelligence Rich Client, le modifiche alla configurazione necessarie sono diverse da quelle utilizzate da altre applicazioni Business Objects. Configurazione delle connessioni JDBC Data Federator In questa sezione sono contenute le modifiche alla configurazione di Connection Server per le connessioni JDBC a tutte le applicazioni Business Objects. I dettagli di configurazione riportati in questa sezione fanno riferimento al seguente percorso: • dir-installazione-driver-data-federator\JdbcDriver: la directory di installazione principale del middleware JDBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione di Data Federator. • dir-installaz-bo: la directory di installazione principale delle applicazioni Business Objects. Nota: Modificare i file utilizzando un editor XML per essere certi che i file siano corretti. Dopo aver apportato le modifiche alla configurazione mostrate di seguito, riavviare il sistema per rendere effettive le modifiche. Configurazione di Connection Server per una connessione JDBC a Data Federator Nota: questo argomento è valido per tutte le applicazioni Business Objects che utilizzano Connection Server. 50 Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server Configurazione delle connessioni ODBC Data Federator Per configurare Connection Server, è necessario modificare il file di configurazione: dir-installaz-bo\BusinessObjects Enterprise 12.0\win32_x86\dataAccess\connectionServer\jdbc\jdbc.sbo Per configurare il file jdbc.sbo, aggiungere o modificare le righe seguenti all'area ClassPath, come segue: <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=&quot;$DATABASE$&quot;;commProtocol=EBUS</Para meter> </JDBCDriver> ... </DataBase> dove dir-installazione-businessobjects indica la directory C:\Programmi\Business Objects in Microsoft Windows. Il file ebus405.jar viene fornito con BusinessObjects Enterprise. Configurazione delle connessioni ODBC Data Federator In questa sezione sono contenute le impostazioni aggiuntive di Data Federator Query Server e le modifiche alla configurazione di Connection Server per le connessioni ODBC a tutte le applicazioni Business Objects, ad eccezione di Web Intelligence Rich Client. I dettagli di configurazione riportati in questa sezione fanno riferimento ai seguenti percorsi: • dir-installazione-driver-data-federator\OaJdbcBridge: la directory di installazione principale del middleware ODBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione dei driver di Data Federator. • dir-installazione-driver-data-federator\JdbcDriver: la directory di installazione principale del middleware JDBC Data Federator. Manuale dell'accesso ai dati 51 3 3 Creazione di una connessione a Data Federator Query Server Configurazione delle connessioni ODBC Data Federator L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione di Data Federator. • dir-installaz-bo: la directory di installazione principale delle applicazioni Business Objects. Nota: Modificare i file utilizzando un editor XML per essere certi che i file siano corretti. Dopo aver apportato le modifiche alla configurazione mostrate di seguito, riavviare il sistema per rendere effettive le modifiche. Argomenti correlati • • Configurazione del middleware ODBC Data Federator a pagina 52 Configurazione di Connection Server per una connessione ODBC a Data Federator a pagina 53 Configurazione del middleware ODBC Data Federator Nota: questo argomento è valido per tutte le applicazioni Business Objects che utilizzano Connection Server, ad eccezione di Web Intelligence Rich Client. Per configurare il middleware BusinessObjects ODBC Data Federator, è necessario modificare il file openrda.ini. Questo file è installato nella seguente directory: • dir-installaz-driver-data-federator\OaJdbcBridge\bin\iwinnt Per configurare il file openrda.ini, impostare i parametri nella sezione [JavaIp], come segue: 52 • CLASSPATH=dir-installaz-driver-data-federator\OaJdbcBridge\oa java\oasql.jar;dir-installaz-driver-data-federator\JdbcDri ver\thindriver.jar;dir-installaz-bo\BusinessObjects Enter prise 12.0\classes\ConnectionServer.jar • JVM_DLL_NAME=dir-installaz-bo\javasdk\jre\bin\client\jvm.dll Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator • JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.di rectory=dir-installaz-bo\BusinessObjects Enterprise 12.0\win32_x86\dataAccess\connectionServer Nota: Controllare il file openrda.ini per assicurare che questo percorso non sia impostato utilizzando il parametro Djava.endorsed.dirs. Se lo è, è necessario rimuovere il percorso dal parametro Djava.endorsed.dirs. Configurazione di Connection Server per una connessione ODBC a Data Federator Nota: questo argomento è valido per tutte le applicazioni Business Objects che utilizzano Connection Server, ad eccezione di Web Intelligence Rich Client. Per configurare Connection Server, è necessario modificare il file di configurazione: dir-installaz-bo\BusinessObjects Enterprise 12.0\win32_x86\dataAccess\connectionServer\cs.cfg Per configurare il file cs.cfg, impostare i parametri sotto il tag JavaVM, come segue: <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> Configurazione delle definizioni di connessione Web Intelligence Rich Client Manuale dell'accesso ai dati 53 3 3 Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator che utilizzano il middleware ODBC Data Federator Quando si creano connessioni Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator, è necessario apportare le modifiche alla configurazione descritte in questa sezione. Senza le necessarie correzioni alla configurazione, la connessione genera errori. Questo tipo di connessione è supportata solo in un ambiente Windows. Promemoria: Le informazioni che seguono fanno riferimento solo a Web Intelligence Rich Client. Per creare connessioni che utilizzano il middleware ODBC Data Federator per l'utilizzo con Web Intelligence Rich Client, è necessario modificare le configurazioni di: • Middleware ODBC • Connection Server • Chiave di registro Windows RichClient I dettagli di configurazione riportati in questa sezione fanno riferimento ai seguenti percorsi: • dir-installazione-driver-data-federator\OaJdbcBridge: la directory di installazione principale del middleware ODBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione dei driver di Data Federator. • dir-installazione-driver-data-federator\JdbcDriver: la directory di installazione principale del middleware JDBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione di Data Federator. • dir-installaz-bo: la directory di installazione principale delle applicazioni Business Objects. Nota: Modificare i file utilizzando un editor XML per essere certi che i file siano corretti. 54 Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator Argomenti correlati • Configurazione del middleware ODBC Data Federator per una connessione Web Intelligence Rich Client a pagina 55 • Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator a pagina 56 • Impostazione della chiave di registro di Web Intelligence Rich Client a pagina 56 • Configurazione di Connection Server per connessioni di Web Intelligence Rich Client e Universe Designer a Data Federator a pagina 57 Configurazione del middleware ODBC Data Federator per una connessione Web Intelligence Rich Client Per configurare il middleware ODBC Data Federator, è necessario modificare il file openrda.ini. Questo file è installato nella seguente directory: • dir-installaz-driver-data-federator\OaJdbcBridge\bin\iwinnt Per configurare il file openrda.ini, impostare i parametri nella sezione [JavaIp], come segue: • CLASSPATH=dir-installaz-driver-data-federator\OaJdbcBridge\oa java\oasql.jar;dir-installaz-driver-data-federator\JdbcDri ver\thindriver.jar;dir-installaz-bo\BusinessObjects Enter prise 12.0\classes\ConnectionServer.jar • JVM_DLL_NAME=dir-installaz-bo\javasdk\jre6\bin\client\jvm.dll Nota: Web Intelligence Rich Client richiede JDK 6. • JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.di rectory=dir-installaz-bo\BusinessObjects Enterprise 12.0\win32_x86\dataAccess\connectionServer Nota: Controllare il file openrda.ini per assicurare che questo percorso non sia impostato utilizzando il parametro Djava.endorsed.dirs. Se lo è, è necessario rimuovere il percorso dal parametro Djava.endorsed.dirs. Manuale dell'accesso ai dati 55 3 3 Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator Per configurare Connection Server per una connessione Web Intelligence Rich Client a Data Federator, è necessario modificare i file di configurazione: dir-installaz-bo\BusinessObjects Enterprise 12.0\win32_x86\dataAccess\connectionServer\cs.cfg Per configurare il file cs.cfg, impostare i parametri sotto il tag JavaVM, come segue: <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> Impostazione della chiave di registro di Web Intelligence Rich Client Per modificare la chiave di registro di Windows RichClient, utilizzare uno strumento quale regedit. 1. Nel registro di sistema, individuare la chiave HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\default\WebIntelligence\RichClient. 2. In questa chiave, aggiungere i seguenti valori al valore classpath. Come per tutti i valori delle chiavi di registro, i valori devono essere separati dal carattere punto e virgole (;). • dir-installaz-driver-data-federator\OaJdbcBridge\oajava\oa sql.jar • 56 dir-installaz-driver-data-federator\JdbcDriver\thindri ver.jar Manuale dell'accesso ai dati Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator Configurazione di Connection Server per connessioni di Web Intelligence Rich Client e Universe Designer a Data Federator È possibile utilizzare una singola configurazione per creare una connessione ODBC a Data Federator da Universe Designer e Web Intelligence Rich Client. Oltre alle impostazioni di configurazione descritte in precedenza, attenersi a una delle procedure riportate di seguito: • Effettuare quanto segue 1. Eseguire lo strumento regedit. 2. Nel registro di sistema, individuare la chiave HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\default\ConnectionServer\Configuration. 3. In questa chiave, aggiungere il valore seguente al valore di JVM Li brary: dir-installaz-bo\javasdk\jre6\bin\client\jvm.dll. • Effettuare quanto segue 1. Aprire il file cs.cfg per la modifica. 2. Individuare il tag JavaVM. 3. Impostare LibraryName sullo stesso percorso di directory JVM specificato nel openrda.ini: ... <JavaVM> <LibraryName JNIVersion="JNI_VERSION_1_4">\\bo-installdir\\javasdk\\jre6\\bin\\client\\jvm.dll</LibraryName> </JavaVM> Avvertenza: Universe Designer e il bridge OpenEdge devono specificare lo stesso percorso di directory JVM. Manuale dell'accesso ai dati 57 3 3 Creazione di una connessione a Data Federator Query Server Configurazione delle definizioni di connessione Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator 58 Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati 4 4 Configurazione dei parametri globali di accesso ai dati Informazioni sui parametri globali Informazioni sui parametri globali È possibile configurare valori di parametri globali, validi per tutte le connessioni. I parametri globali consentono di migliorare le prestazioni o risolvere problemi di connessione. I parametri globali di accesso ai dati vengono gestiti nel file cs.cfg. Si tratta di un file XML contenente i parametri di configurazione di Connection Server nonché i parametri di configurazione predefiniti applicabili a tutti i driver di accesso ai dati. Per ignorare le impostazioni globali, è possibile configurare le impostazioni nel file .sbo di ciascun driver. Argomenti correlati • Configurazione dei parametri del driver a pagina 74 Informazioni sul file di configurazione cs.cfg In un sistema Windows, il file cs.cfg è archiviato nel seguente percorso: • connectionserver-install-dir \connectionServer Nel file cs.cfg è possibile configurare i parametri solo nelle seguenti sezioni: • Impostazioni In questa sezione vengono definiti i parametri di configurazione globali di Connection Server, inclusi i tipi di accesso client quali CORBA. È possibile ignorare questi parametri utilizzando le impostazioni corrispondenti nel file di configurazione del driver di accesso ai dati: <driver>.sbo, dove <driver> è il nome del driver di accesso ai dati al quale è correlato il file .sbo. • DriverDefaults Questi parametri si applicano a tutti i driver di accesso ai dati. • 60 Distribuzione Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Per visualizzare e modificare il file cs.cfg Configurare le impostazioni nella presente sezione se si utilizza CORBA. • Analisi È possibile impostare i parametri di traccia che consentono la registrazione dell'attività di connessione tramite i file log Connection Server. Consultare le note sulla versione per informazioni sulla generazione di tracce. La sezione rimanente Impostazioni internazionali definisce il charset per ogni lingua disponibile. I parametri di questa sezione non devono essere modificati. Per visualizzare e modificare il file cs.cfg È possibile visualizzare e modificare i parametri di un file cs.cfg nel seguente modo: 1. Individuare la directory contenente il file cs.cfg. Ad esempio, in un sistema Windows: connectionserver-install-dir\connectionServer\cs.cfg dove connectionserver-install-dir è il percorso in cui è installato il software Connection Server. 2. Aprire il file cs.cfg in un editor XML. 3. Espandere le sezioni come necessario. 4. Impostare i parametri aggiungendo nuovi parametri o valori o modificando i valori dei parametri esistenti. 5. Verificare che il documento sia valido rispetto al DTD, quindi salvare e chiudere il file. Configurazione dei parametri predefiniti dei driver La sezione <DriverDefaults> del file cs.cfg contiene i valori predefiniti che vengono applicati a tutti i driver di accesso ai dati. Tali valori predefiniti vengono sostituiti per un driver specifico dai valori corrispondenti impostati nel file <driver>.sbo. Per informazioni sui parametri che è possibile impostare consultare il riferimento ai parametri del file SBO. Manuale dell'accesso ai dati 61 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali Argomenti correlati • • • File di configurazione per l'accesso ai dati a pagina 74 Configurazione dei parametri del driver a pagina 74 Categorie parametri SBO a pagina 82 Configurazione dei parametri delle impostazioni globali La sezione <Settings> del file cs.cfg definisce le impostazioni valide per tutti i driver e che non possono essere personalizzate per singoli driver di accesso ai dati. Alcune impostazioni possono essere definite per la versione delle librerie o per la versione dei server di Connection Server: • libreria In questa modalità Connection Server è incluso nel processo client. • server In questa modalità, Connection Server è un server CORBA a cui si accede in remoto. In questa modalità, Connection Server viene utilizzato da due tipi di client, HTTP e CORBA. Se nel proprio ambiente viene utilizzata la modalità server, è necessario configurare alcuni parametri nella sezione <Server> del file cs.cfg. I parametri <Settings> sono elencati in ordine alfabetico. Per visualizzare o modificare i parametri, aprire il file cs.cfg in un editor XML e accedere alla sezione Settings, quindi alla sezione Parameters. Nel file, ogni parametro è definito nel seguente tag: <Parameter Name="parametro">valore</Parameter> dove parametro indica il nome del parametro e valore indica il valore attribuito al parametro. Ogni parametro viene visualizzato con le seguenti informazioni: 62 • esempio di come è visualizzato il parametro nel file XML - se il parametro è disponibile nella modalità libreria e server, viene mostrato un esempio in ogni modalità • descrizione del parametro • valori che è possibile impostare per il parametro (se applicabile) Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali • valore predefinito per il parametro Charset List Extension <Parameter Name="CharSet List Extension">crs</Parameter> Nota: Descrizione Non modificare questa impostazione. Definisce l’estensione dei file di set di caratteri. Predefinita crs Config File Extension <Parameter Name="Config File Extension">sbo</Parameter> Nota: Descrizione Predefinita Non modificare questa impostazione. Definisce l’estensione del file per i file di configurazione generali. sbo Description Extension <Parameter Name="Description Extension">cod</Parameter> Manuale dell'accesso ai dati 63 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali Nota: Descrizione Predefinita Non modificare questa impostazione. Definisce l’estensione dei file di descrizione delle connessioni. cod Enable Failed Load <Parameter Name="Enable Failed Load">Yes</Parameter> Descrizione Determina l'azione da intraprendere quando il caricamento di un driver non riesce. Il tag parameter consente di scegliere se si desidera utilizzare comunque una connessione senza tutti i driver in esecuzione oppure che venga generato un errore irreversibile senza alcuna funzionalità quando il caricamento di un driver non riesce. Yes: Connection Server genera un errore irreversibile quando il caricamento di un driver non riesce. Valori No: Connection Server genera un errore non irreversibile quando il caricamento di un driver non riesce. Predefinita Sì Argomenti correlati • 64 Load Drivers On Startup a pagina 65 Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali Load Drivers On Startup Load Drivers On Startup è valido tanto per la modalità Libreria che per la modalità Server. Libreria <Settings> <Parameter Name="Load Drivers On Startup">No</Parameter> ... <Library/> Server <Server> <Parameter Name="Load Drivers On Startup">Yes</Parameter> ... </Server> Tali modalità vengono descritte di seguito. Descrizione Determina il modo in cui vengono caricate le librerie. • Yes: tutti i driver installati vengono caricati durante la fase di inizializzazione. • No: i driver vengono caricati su richiesta. Valori Modalità Libreria No Predefinita Modalità Server: Yes Max Pool Time Max Pool Time è disponibile per la modalità Libreria e la modalità Server. Manuale dell'accesso ai dati 65 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali Libreria <Settings> <Parameter Name="Max Pool Time">-1</Parameter> <Library/> Server <Server> <Parameter Name="Max Pool Time">60</Parameter> . . . </Server> Stabilisce il periodo massimo che una connessione non utilizzata può rimanere inattiva nel connection pool. Un connection pool è un meccanismo utilizzato dai driver di accesso ai dati per riutilizzare le connessioni al database al fine di sfruttare al meglio le risorse del sistema. È possibile impostare Max Pool Time per due tipi di implementazione Connection Server: Descrizione Libreria: il valore è applicabile ai nodi su cui è installato Connection Server con un prodotto desktop o con altri prodotti server. Server: il valore è applicabile alle installazioni server autonome di Connection Server. Per informazioni sull'implementazione di Connection Server su un nodo dedicato, consultare il BusinessObjects Enterprise Deployment Planning Guide. Modalità Libreria: -1 Predefinita Server: 60 66 Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri delle impostazioni globali -1: nessun timeout, connessione attiva durante l'intera sessione. Valori 0: connessione non gestita dal pool. >0: durata di inattività (in minuti). SQL External Extension <Parameter Name="SQL External Extension">rss</Parameter> Nota: Descrizione Non modificare questa impostazione. Definisce l’estensione del file per i file SQL esterni. Predefinita rss SQL Parameter Extension <Parameter Name="SQL Parameter Extension">prm</Parameter> Nota: Descrizione Predefinita Non modificare questa impostazione. Definisce l’estensione del file per i file dei parametri SQL. prm Manuale dell'accesso ai dati 67 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione del metodo di accesso Strategies Extension <Parameter Name="Strategies Extension">stg</Parameter> Nota: Descrizione Non modificare questa impostazione. Definisce l’estensione del file per i file di strategia. Predefinita stg Configurazione del metodo di accesso In cs.cfg, i parametri della sezione <Settings> controllano il metodo di accesso. Nella sezione <Settings>: • I parametri della sezione <Library> controllano la modalità Libreria. La maggior parte delle applicazioni Business Objects utilizza Connection Server in modalità Libreria. • I parametri della sezione <Server> controllano l'accesso CORBA. I parametri definiti in <Library> o <Server> hanno precedenza su qualsiasi definizione di parametro impostata in altre parti della sezione <Settings>. In CORBA, ad esempio, i parametri definiti nella sezione <Server> possono ignorare i parametri impostati in altre aree per applicazioni che utilizzano l'accesso <Library>. Le impostazioni applicate alla modalità libreria sono: • Load Drivers On Startup • Max Pool Time Le impostazioni applicate all'accesso CORBA sono: • Load Drivers On Startup 68 Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Configurazione del filtro del driver Il valore predefinito di questo parametro è Yes. Questo significa che tutti i driver di accesso ai dati vengono caricati all'avvio di Connection Server. Avvertenza: per evitare errori di connessione, è necessario verificare che l'ambiente fornisca tutti i middleware necessari, in caso contrario è necessario modificare la sezione <Settings> includendo solo i livelli di rete e i database necessari in <ActiveDataSources>. È anche possibile impostare Enable Failed Load su No. • • Max Pool Time Transient Object Timeout Non è possibile modificare il valore di Transient Object Timeout dal file cs.cfg ma dalla Central Management Console BusinessObjects. Consultare il Manuale dell’amministratore di BusinessObjects Enterprise. Argomenti correlati • • • • Configurazione del filtro del driver a pagina 69 Load Drivers On Startup a pagina 65 Enable Failed Load a pagina 64 Max Pool Time a pagina 65 Configurazione del filtro del driver È possibile configurare la sezione<ActiveDataSources> per affrontare scenari di distribuzione complessi che riguardano più Connection Server impostati in modalità server. Specificare le origini dati attive per aiutare le applicazioni client a stabilire i driver che vengono caricati e utilizzati da ciascun Connection Server dell'architettura. Per ulteriori informazioni sugli scenari di distribuzione complessi, consultare il Manuale della pianificazione della distribuzione di BusinessObjects Enterprise. In cs.cfg, la sezione <ActiveDataSources> aiuta a specificare i livelli di rete e le origini dati associate che devono essere utilizzati ed esposti da Connection Server. Questa sezione funziona come un filtro per i driver. Sotto la sezione <ActiveDataSources>, gli elementi <NetworkLayer> elencano i driver disponibili per la connessione. Per ciascun driver, gli elementi <Data Base> elencano i nomi dei database ai quali Connection Server è in grado di connettersi. Manuale dell'accesso ai dati 69 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione del filtro del driver È possibile specificare le origini dati attive per i metodi di accesso che sono stati definiti, ovvero, la Libreria, la modalità di accesso al server CORBA, o entrambe. Se non viene specificata alcuna sezione <ActiveDataSources> o se questa viene lasciata vuota, non viene elaborato alcun filtro. Connection Server carica tutti i driver disponibili. Nota: è possibile trovare l'elenco dei livelli di rete disponibili nel file driver.cfg che si trova nella directory dir-installazione-connectionserver\conne ctionServer\. I nomi di database sono espressioni regolari che utilizzano la sintassi regexp GNU. Utilizzare il criterio .* per trovare una corrispondenza per qualsiasi carattere. Per ulteriori informazioni sulle espressioni regolari, consultare il sito Web PERL all'indirizzo http://www.perl.com/doc/manual/ht ml/pod/perlre.html#Regular_Expressions. Questo esempio illustra una configurazione in cui Connection Server rende disponibili i seguenti database: • qualsiasi versione di MS SQL Server tramite livello di rete ODBC • qualsiasi versione di MS Access tramite livello di rete ODBC • Oracle 9 e Oracle 10 tramite livello di rete Oracle OCI Oltre a queste, è necessario configurare le impostazioni nella sezione <Dis tribution>. <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> </Server> 70 Manuale dell'accesso ai dati Configurazione dei parametri globali di accesso ai dati Configurazione del filtro del driver Argomenti correlati • Configurazione dei protocolli di accesso CORBA a pagina 72 Impostazione di una connettività per computer In scenari di distribuzione complessi, è possibile impostare una connettività per ciascun tipo di computer, ad esempio è possibile connettere applicazioni BusinessObjects Enterprise a un database MS SQL Server installato su un computer Microsoft Windows e a un database Oracle installato su un computer UNIX. Per evitare errori di connessione, è necessario eseguire una delle operazioni seguenti: • quando si installa il software BusinessObjects Enterprise, specificare le connettività da distribuire per ogni tipo di database, come illustrato nell'immagine seguente. • quando si configura il Connection Server nel file cs.cfg, impostare la sezione <ActiveDataSources> per la modalità libreria (sezione <Libra ry>) analogamente alla modalità server (sezione <Server>). Manuale dell'accesso ai dati 71 4 4 Configurazione dei parametri globali di accesso ai dati Configurazione dei protocolli di accesso CORBA Poiché le applicazioni tentano subito di stabilire le connessioni tramite i driver installati in locale, è opportuno configurare il filtro driver allo stesso modo per entrambe le modalità. Ad esempio: <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.*$"/> </NetworkLayer> <NetworkLayer Name="Oracle OCI"> <DataBase Name="Oracle 9"/> <DataBase Name="Oracle 8"/> </NetworkLayer> </ActiveDataSources> </Server> Configurazione dei protocolli di accesso CORBA È necessario impostare i seguenti parametri nella sezione <Distribution> del file cs.cfg quando si utilizza Connection Server con CORBA. La sezione <Protocols> contiene i valori predefiniti che Connection Server utilizza per elaborare le richieste in arrivo dai client CORBA o HTTP. Per l'accesso CORBA, configurare la sezione come descritto di seguito: <Protocol Name="CORBA" Active="Yes"/> <Protocol Name="HTTP" Active="No"/> 72 Manuale dell'accesso ai dati Configurazione dei parametri dei driver di accesso ai dati 5 5 Configurazione dei parametri dei driver di accesso ai dati Configurazione dei parametri del driver Configurazione dei parametri del driver Per configurare l'accesso ai dati per un particolare driver di accesso ai dati, è possibile modificare i file dei parametri XML del driver per modificare le impostazioni dei parametri. Nota: Per ogni applicazione Business Objects che utilizza Connection Server, il file Leggimi associato contiene informazioni sulle utilità della riga di comando che è possibile utilizzare per controllare la configurazione del motore RDBMS e del driver di accesso ai dati. Tali utilità sono in grado di creare file di registro che tengono traccia delle attività del server Web Intelligence. Consultare il file Leggimi della versione per istruzioni sull'esecuzione di queste utilità. Argomenti correlati • Informazioni sui parametri globali a pagina 60 File di configurazione per l'accesso ai dati I file di configurazione seguenti controllano le configurazioni dei driver di accesso ai dati per ciascuna connessione definita: • Il file cs.cfg definisce i parametri globali che vengono applicati a tutte le connessioni. • Per ogni driver di accesso ai dati esiste un file di configurazione separato. Il nome dei file è <driver>.sbo, dove <driver> è il livello di rete del database a cui viene applicato il file di configurazione. I parametri impostati nella sezione Settings del file cs.cfg vengono sostituiti dalle impostazioni corrispondenti nei file di configurazione dei driver di accesso ai dati (<driver>.sbo). I file di configurazione si trovano nei percorsi seguenti, dove connection server-install-dir è la directory in cui è installato il software Connection Server. • Il file cs.cfg si trova nella directory seguente: connectionserver-install-dir\connectionServer\ 74 Manuale dell'accesso ai dati Configurazione dei parametri dei driver di accesso ai dati Configurazione dei parametri del driver • Ciascun file .sbo si trova in una sottodirectory di questa directory e il nome segue il livello di rete del database. Ad esempio, per i database Oracle: connectionserver-install-dir\connectionServer\oracle Argomenti correlati • • • Informazioni sui parametri globali a pagina 60 File SBO installati a pagina 75 Configurazione dei parametri predefiniti dei driver a pagina 61 File SBO installati I seguenti file <driver>. sbo vengono installati per impostazione predefinita. Per un elenco aggiornato dei driver supportati, visitare il sito Web SAP Service MarketPlace all'indirizzo service.sap.com/bosap-support, oppure contattare il rappresentante Business Objects di fiducia. Driver di accesso ai dati file SBO Essbase essbase.sbo db2.sbo IBM DB2 iseries.sbo Informix informix.sbo JDBC fornisce driver JDBC per i database. Visitare il sito Web SAP Service MarketPlace, oppure controllare jdbc.sbo il file jdbc.sbo per informazioni sui database supportati per le connessioni JDBC. Manuale dell'accesso ai dati 75 5 5 Configurazione dei parametri dei driver di accesso ai dati Configurazione dei parametri del driver Driver di accesso ai dati file SBO Microsoft SQL Server odbc.sbo Microsoft Analysis Services oledb_olap.sbo MySQL Nota: il database MySQL 5 è disponibile su tutte le piattaforme, con supporto Unicode. Accertarsi di utilizzare MySQL odbc.sbo Connector/ODBC 5.1.4 o versione successiva per la connessione a questo database. Se si utilizza una versione precedente del driver in Unix, verranno generati errori in fase di esecuzione. 76 ODBC odbc.sbo Oracle oracle.sbo Red Brick odbc.sbo SAP sap.sbo Sybase sybase.sbo Teradata teradata.sbo Manuale dell'accesso ai dati Configurazione dei parametri dei driver di accesso ai dati Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect Per visualizzare e modificare un file SBO Avvertenza: Prima di aprire un file SBO, eseguire una copia di backup del file. Alcuni parametri di configurazione non devono essere modificati. La modifica o l'eliminazione di tali parametri può compromettere il corretto funzionamento delle applicazioni Business Objects. È possibile aprire un file SBO a scopo di visualizzazione o modifica nel modo seguente: 1. Individuare la directory contenente il file SBO del driver di accesso ai dati di destinazione. 2. Aprire il file SBO in un editor XML. 3. Espandere le sezioni come necessario. 4. Individuare il tag appropriato per il valore da modificare, quindi modificare il valore. I parametri vengono visualizzati nel seguente formato: <Parameter Name="parametro">valore</Parameter> doveparametro è il nome del parametro e valore è il valore assegnato al parametro. 5. Verificare che il file sia valido con DTD, salvarlo e chiuderlo. Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect L'accesso ai dati supporta l'utilizzo di driver ODBC DataDirect 5.3 con marchio per database MS SQL Server su tutte le piattaforme UNIX. I driver DataDirect con marchio vengono forniti come parte del software BusinessObjects Enterprise e possono essere utilizzati solo con le applicazioni Business Objects quali Web Intelligence, Desktop Intelligence e Crystal Reports. Il middleware e i driver indicati di seguito sono disponibili solo per piattaforme UNIX: • MS SQL Server 2000 SP4 Può essere utilizzato con driver ODBC DataDirect per MS SQL Server 5.3 o con driver ODBC DataDirect con marchio MS SQL Server 5.3. • MS SQL Server 2005 SP2 Manuale dell'accesso ai dati 77 5 5 Configurazione dei parametri dei driver di accesso ai dati Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect Può essere utilizzato con driver ODBC DataDirect per MS SQL Server 5.3 o con driver ODBC DataDirect con marchio MS SQL Server 5.3. È possibile trovare i file del driver DataDirect con marchio nella directory dir-install-boe/enterprise115/solaris_sparc/odbc, dove dirinstallaz-boe è la directory di installazione di BusinessObjects Enterprise. Avvertenza: Per utilizzare il driver con marchio, è necessario accertarsi che l'accesso ai dati sia configurato correttamente. Per abilitare l'uso di driver DataDirect con marchio Nota: La sezione seguente fa riferimento solo ai database MS SQL Server 2000 SP4 e MS SQL Server 2005 SP2. L'accesso ai dati supporta l'utilizzo di driver ODBC DataDirect 5.3 per database MS SQL Server su tutte le piattaforme UNIX. Questi driver possono essere senza marchio o con marchio. Le impostazioni predefinite di Connection Server consentono il corretto funzionamento dei driver ODBC senza marchio con le impostazioni di configurazione correnti. Se è già stato distribuito un driver nell'ambiente, sarà possibile installare il driver senza marchio senza alcuna modifica di configurazione. 1. Individuare la directory contenente il file odbc.sbo. In UNIX il file di configurazione si trova nella directory dir-installa zione-connectionserver/connectionServer/odbc. 2. Utilizzare un editor XML per aprire il file odbc.sbo da modificare. 3. Individuare la sezione DataBase appropriata. Il parametro Use DataDirect OEM Driver della sezione Database è impostato su No per impostazione predefinita. Ciò significa che l'accesso ai dati è configurato per il funzionamento con driver senza marchio per impostazione predefinita. 4. Impostare il parametro Use DataDirect OEM Driver della sezione Da taBase appropriata su Yes. Connection Server è in grado di stabilire la connessione ai database MS SQL Server con i driver DataDirect ODBC con marchio. 78 Manuale dell'accesso ai dati Configurazione dei parametri dei driver di accesso ai dati Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect Esempio: Di seguito viene riportato un estratto del file odbc.sbo predefinito. <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> Manuale dell'accesso ai dati 79 5 5 Configurazione dei parametri dei driver di accesso ai dati Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect 80 Manuale dell'accesso ai dati Riferimento ai parametri SBO 6 6 Riferimento ai parametri SBO Categorie parametri SBO Categorie parametri SBO Nel presente manuale, i parametri di configurazione sono elencati nelle seguenti categorie. Ogni categoria rappresenta un database che dispone di un file sbo distinto. • Impostazioni predefinite • Informix • JavaBean • JDBC • ODBC • OLE DB • OLAP OLE DB • Sybase ASE/CTLIB Ogni parametro viene visualizzato con le seguenti informazioni: • esempio di visualizzazione del parametro nel file XML • descrizione del parametro • valori che è possibile impostare per il parametro • valore predefinito per il parametro Struttura dei file SBO Esiste un file <driver>.sbo per ciascun livello di rete del database supportato. Ogni file <driver>.sbo è suddiviso nelle seguenti sezioni: 82 Manuale dell'accesso ai dati Riferimento ai parametri SBO Struttura dei file SBO Sezione del file Descrizione Defaults Questa sezione contiene i parametri di configurazione predefiniti validi per tutto il middleware del database che utilizza il driver di accesso ai dati. Tali parametri sovrascrivono eventuali valori corrispondenti impostati nel middleware del database. Manuale dell'accesso ai dati 83 6 6 Riferimento ai parametri SBO Struttura dei file SBO Sezione del file Descrizione Questa sezione contiene una sottosezione per ciascun middleware del database supportato dal driver di accesso ai dati. Il parametro Active specifica se il supporto middleware è attivato. I valori sono YES o NO. Ciascuna sezione del middleware può contenere i seguenti parametri: • Name: nomi dei middleware supportati dal driver di accesso ai dati. I valori dei nomi dei middleware impostati in questa sezione appaiono nella pagina Selezione del middleware del database nella procedura guidata Nuova connessione. • Alias: nomi delle versioni precedenti del middleware non più supportati ufficialmente, ma ancora utilizzati. È possibile aggiungere un parametro alias per una versione precedente del middleware in modo che le connessioni esistenti possano utilizzare il driver di accesso ai dati corrente. È possibile impostare i parametri di configurazione specifici dei middleware precedenti come parametri del nuovo alias. Inoltre, è possibile creare nuove connessioni usando l'alias. • Parameters: parametri di configurazione con valori applicabili specificamente ad un middleware. I valori impostati per i parametri elencati in questa sezione sovrascrivono i valori impostati per gli stessi parametri nella sezione De faults. Databases 84 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Parametri SBO predefiniti I parametri SBO predefiniti si definiscono nel file cs.cfg oppure nella sezione Defaults del file SBO. Argomenti correlati • Categorie parametri SBO a pagina 82 Array Bind Available <Parameter Name="Array Bind Available">True</Parameter> Descrizione Specifica se il database supporta gli array bind. True: il database supporta gli array bind. Valori False: il database non supporta gli array bind. Predefinita False Array Bind Size <Parameter Name="Array Bind Size">5</Parameter> Descrizione Specifica il numero di righe esportate tramite il comando INSERT. Valori Un intero che specifica il numero di righe recuperate con ciascunINSERT. Manuale dell'accesso ai dati 85 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Predefinita Valore impostato nel file cs.cfg. Array Fetch Available <Parameter Name="Array Fetch Available">True</Parameter> Descrizione Specifica se il metodo Array Fetch è supportato. True: il metodo Array Fetch è supportato. Valori False: il metodo Array Fetch non è supportato. Predefinita Valore impostato nel file cs.cfg. Dimensioni array fetch <Parameter Name="Array Fetch Size">10</Parameter> Descrizione Specifica il numero di righe di dati recuperate con ciascun metodo Array Fetch. Il numero ottimale dipende dalle prestazioni del sistema: • Se il numero è basso, il sistema recupera piccole quantità di dati molte volte. Ciò può compromettere le prestazioni del sistema. • 86 Manuale dell'accesso ai dati Se il numero è alto, il sistema esegue poche operazioni di recupero, ma richiede maggiore memoria per ciascuna di esse. Riferimento ai parametri SBO Parametri SBO predefiniti Valori Un intero che specifica il numero di righe recuperate con ciascunarray fetch. 1: specifica che l'array fetchè disattivato. Predefinita Valore impostato nel file cs.cfg. Catalog Name Max Size <Parameter Name="Catalog Name Max Size">1024</Parameter> Descrizione Specifica la lunghezza massima in caratteri del nome catalogo di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome catalogo di un database. Predefinito Valore impostato nel middleware del database. Catalog Separator <Parameter Name="Catalog Separator">-</Parameter> Descrizione Specifica il carattere separatore utilizzato tra gli identificatori. Valori Carattere separatore da utilizzare. Manuale dell'accesso ai dati 87 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Predefinito Se non viene specificato, Connection Server utilizza il separatore utilizzato nel middleware del database. Charset <Parameter Name="CharSet">UTF8</Parameter> Descrizione Specifica il set di caratteri dei dati restituiti dal middleware del database. UTF8: UCS a 8 bit/Unicode Transformation Format Valori UCS2: Universal Character Set a 2 byte Predefinito Se non viene specificato, Connection Server utilizza il separatore utilizzato nel middleware del database. Column Name Max Size <Parameter Name="Column Name Max Size">1024</Parameter> 88 Descrizione Specifica la lunghezza massima in caratteri del nome colonna di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome colonna di un database. Predefinito Valore impostato nel middleware del database. Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Connection Shareable <Parameter Name="Connection Shareable">False</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica se una connessione è condivisibile tra diversi richiedenti. Viene utilizzato insieme al parametro Shared Connection. True: la connessione può essere condivisa tra più utenti. Valori False: la connessione non può essere condivisa tra gli utenti Predefinito False Argomenti correlati • Shared Connection a pagina 101 Cost Estimate Available <Parameter Name="Cost Estimate Available">False</Parameter> Descrizione Specifica se il middleware del database supporta la stima di costi. True: il middleware supporta la stima di costi. Valori False: il middleware non supporta la stima di costi. Manuale dell'accesso ai dati 89 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Predefinito False Description File <Parameter Name="Description File">oracle</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica il nome del file contenente le etichette dei campi di immissione della creazione guidata nuova connessione. Driver Capabilities <Parameter Name="Driver Capabilities">Procedures , Query</Para meter> Funzionalità del driver, ovvero se è in grado di accedere a stored procedure e query disponibili nel software del database. Questo parametro viene in genere impostato utilizzando la procedura guidata Nuova connessione. Nel parametro è possibile includere entrambi i valori. Descrizione Nota: Questo parametro deve essere impostato su Proce dures nel caso di un driver JavaBean. Per quanto riguarda le applicazioni Business Objects, la funzionalità di un driver JavaBean viene definita come stored procedure. 90 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Valori Procedures: il driver è in grado di accedere alle procedure di recupero dei dati definite nel software del database. Query: il driver è in grado di accedere alle query di recupero dei dati definite nel software del database. Predefinito Procedures Escape Character <Parameter Name="Escape Character">-</Parameter> Descrizione Specifica il carattere da utilizzare per le stringhe di uscita dei caratteri speciali, ad esempio i motivi. Valori Carattere da utilizzare come carattere di uscita. Predefinito Se non viene specificato, Connection Server recupera il valore dal middleware. Extensions <Parameter Name="Extensions"></Parameter> Descrizione Nota: Non modificare le impostazioni di questo parametro. Manuale dell'accesso ai dati 91 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Family <Parameter Name="Family">Sybase</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica la famiglia del motore di database da visualizzare nella pagina Selezione del middleware del database della procedura guidata Nuova connessione. L'insieme del middleware che corrisponde alla licenza dell'utente viene visualizzato in questa pagina in una struttura ad albero. Field Size Factor <Parameter Name="Field Size Factor ">1</Parameter> Nota: Non modificare questo valore. Descrizione Valore da utilizzare per calcolare le dimensioni del contenuto restituito, espresso in caratteri di campo quando il contenuto viene restituito in byte. Viene utilizzato solo in DB2. Force Execute <Parameter Name="Force Execute">Never</Parameter> 92 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Descrizione Specifica se la query SQL viene eseguita prima di recuperare i risultati. Supporta i seguenti valori: • ODBC • OLE • DB • JDBC Never: la query SQL non viene mai eseguita prima di recuperare i risultati. Valori Procedures: viene eseguita solo per stored procedure. Always: la query SQL viene eseguita sempre prima di recuperare i risultati. Predefinito Never Identifier Case <Parameter Name="Identifier Case">LowerCase</Parameter> Descrizione Specifica in che modo il database gestisce il comportamento delle maiuscole/minuscole degli identificatori semplici. Manuale dell'accesso ai dati 93 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti LowerCase: gli identificatori devono essere in minuscolo. UpperCase: gli identificatori devono essere in maiuscolo. Valori MixedCase: gli identificatori possono essere in maiuscolo e minuscolo. SensitiveCase: gli identificatori distinguono le maiuscole e minuscole. Predefinito Se non si specifica questa impostazione, Connection Server recupera le informazioni dal middleware del database. Identifier Quote String <Parameter Name="Identifier Quote String">-</Parameter> 94 Descrizione Specifica il carattere utilizzato per racchiudere gli identificatori tra virgolette. Valori Carattere utilizzato per racchiudere gli identificatori tra virgolette. Predefinito Se non si specifica questa impostazione, Connection Server recupera le informazioni dal middleware del database. Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti LIKE Escape Clause <Parameter Name="Identifier Case">True</Parameter> Descrizione Specifica se la clausola LIKE supporta l'utilizzo del carattere di uscita. True: la clausola LIKE supporta l'utilizzo del carattere di uscita. Valori False: la clausola LIKE non supporta l'utilizzo del carattere di uscita. Predefinito Se non si specifica questa impostazione, Connection Server recupera le informazioni dal middleware del database. Impostazioni internazionali <Parameter Name="Locale">it_it</Parameter> Descrizione Specifica le impostazioni internazionali del middleware. Valori Impostazioni internazionali del middleware. • la lingua è specificata nello standard ISO-639 • il paese è specificato nello standard ISO-3166 Ad esempio: it_IT per Italiano (Italia). Manuale dell'accesso ai dati 95 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Predefinito Se non si specifica questa impostazione, Connection Server recupera le informazioni dal middleware del database. Max Rows Available <Parameter Name="Max Rows Available">True</Parameter> Descrizione Specifica se il driver supporta la funzione N. max di righe per limitare il numero massimo di righe che è possibile recuperare da un'origine dati. True: il driver supporta la funzione N. max di righe. Valori False: il driver non supporta la funzione N. max di righe. Predefinito False Optimize Execute <Parameter Name="Optimize Execute">False</Parameter> Descrizione 96 Manuale dell'accesso ai dati Specifica se Connection Server ottimizza l'esecuzione delle query SQL. Questo parametro è supportato solo dai driver Oracle e ODBC. Riferimento ai parametri SBO Parametri SBO predefiniti True: specifica che l'esecuzione delle query SQL viene ottimizzata laddove possibile. Valori False: l'esecuzione delle query SQL non viene ottimizzata. Predefinito False Owners Available <Parameter Name="Owners Available">True</Parameter> Descrizione Specifica se il database di destinazione supporta i proprietari. True: specifica che il database di destinazione supporta i proprietari. Valori False: specifica che il database di destinazione non supporta i proprietari. Predefinito Se non viene specificato, il valore viene recuperato dal middleware del database. Password Encryption <Parameter Name="Password Encryption">True</Parameter> Manuale dell'accesso ai dati 97 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Descrizione Specifica se utilizzare il metodo di cifratura della password del middleware per la password immessa nella finestra di dialogo Dettagli della connessione. Questo parametro viene utilizzato solo con Sybase ed è incluso nella sezione Impostazioni predefinite per la compatibilità con le versioni successive. True: specifica l'uso del metodo di cifratura della password del middleware. Valori False : specifica che il metodo di cifratura della password del middleware non deve essere utilizzato. Predefinita True Procedure Name Max Size <Parameter Name="Procedure Name Max Size">1024</Parameter> 98 Descrizione Specifica la lunghezza massima in caratteri del nome procedura di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome procedura di un database. Predefinito Valore impostato nel middleware del database. Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Procedure Parameter Name Max Size <Parameter Name="Procedure Parameter Name Max Size">1024</Para meter> Descrizione Specifica la lunghezza massima in caratteri del nome parametro procedura di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome parametro procedura di un database. Predefinito Valore impostato nel middleware del database. Qualifiers Available <Parameter Name="Qualifiers Available">True</Parameter> Descrizione Specifica se i qualificatori sono supportati. True: specifica che i qualificatori sono supportati. Valori False: specifica che i qualificatori non sono supportati. Predefinito Non specificato Connection Server recupera queste informazioni dal middleware del database. Manuale dell'accesso ai dati 99 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Query TimeOut Available <Parameter Name="Query TimeOut Available">True</Parameter> Descrizione Specifica se il middleware del database supporta il timeout della query, ovvero se è possibile annullare l'esecuzione di una query dopo che è trascorso un determinato periodo di tempo. True: specifica che il middleware del database supporta il timeout della query. Valori False: specifica che il middleware del database non supporta il timeout della query. Predefinito False Quoted Identifier Case <Parameter Name="Quoted Identifier Case Available">True</Para meter> Descrizione 100 Manuale dell'accesso ai dati Specifica in che modo il database gestisce le maiuscole/minuscole degli identificatori tra virgolette. Riferimento ai parametri SBO Parametri SBO predefiniti LowerCase: gli identificatori tra virgolette devono essere in minuscolo. UpperCase: gli identificatori tra virgolette devono essere in maiuscolo. Valori MixedCase: gli identificatori tra virgolette possono essere in maiuscolo e minuscolo. SensitiveCase: gli identificatori tra virgolette distinguono le maiuscole e minuscole. Predefinito Non specificato Connection Server recupera le informazioni dal middleware. Schema Name Max Size <Parameter Name="Schema Name Max Size">1024</Parameter> Descrizione Specifica la lunghezza massima in caratteri del nome dello schema di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome dello schema di un database. Predefinito Valore impostato nel middleware del database. Shared Connection <Parameter Name="Shared Connection">True</Parameter> Manuale dell'accesso ai dati 101 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Descrizione Specifica se la connessione richiesta di un connection pool è condivisa. Viene utilizzato insieme al parametro Connection Shareable. Non viene preso in considerazione se il parametro Max Pool Time di cs.cfg è impostato su 0. True: la connessione è condivisa. Valori False: la connessione non è condivisa. Predefinito False Argomenti correlati • • Max Pool Time a pagina 65 Connection Shareable a pagina 89 SQL External File <Parameter Name="SQL External File">nomefile</Parameter> Nota: Descrizione Non modificare questo valore. Il file esterno SQL contiene dettagli di configurazione utilizzati dal livello di accesso ai dati. SQL Parameter File <Parameter Name="SQL Parameter File">oracle</Parameter> 102 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Il nome del file in cui sono memorizzati i parametri del database. L'estensione di questo file è .prm. Descrizione Verificare che tale file si trovi nella stessa directory del file di configurazione dei dati (file .sbo). datafederator per BusinessObjects Data Federator neoview per HP Neoview essbase per Hyperion Essbase db2iseries per IBM DB2 iSeries db2udb per IBM DB2 informix per Informix ingres per Ingres access per Microsoft Access sqlsrv per Microsoft SQL Server 2000 mysql per MySQL Valori netezza per Netezza Server openaccess per OpenAccess oracle per Oracle postgresql per Greenplum e PostgreSQL progress per Progress 10 redbrick per Red Brick Decision Server sybase per Sybase asiq per Sybase ASIQ ssa per Sybase SQL Anywhere teradata per Teradata Manuale dell'accesso ai dati 103 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Predefinita I valori indicati. SSO Available <Parameter Name="SSO Available">False</Parameter> Descrizione Specifica se Single Sign On è supportato. True: Single Sign On è supportato. Valori False: Single Sign On non è supportato. Predefinito False Strategies File <Parameter Name="Strategies File">oracle</Parameter> Descrizione 104 Manuale dell'accesso ai dati Specifica il nome, senza estensione, del file di strategia (.stg). Questo file contiene le strategie esterne utilizzate da Universe Designer per la creazione automatica degli universi. I file di strategia vengono salvati nella stessa directory del file .sbo. Riferimento ai parametri SBO Parametri SBO predefiniti db2 per i driver di accesso ai dati DB2. informix per Informix. Valori oracle per Oracle. sybase per Sybase. teradata per Teradata. Predefinita Vedere i valori di cui sopra. Table Name Max Size <Parameter Name="Table Name Max Size">1024</Parameter> Descrizione Specifica la lunghezza massima in caratteri del nome tabella di un database. Valori Intero che specifica la lunghezza massima in caratteri del nome tabella di un database. Predefinito Valore impostato nel middleware del database. Transactional Available <Parameter Name="Transactional Available">Yes</Parameter> Manuale dell'accesso ai dati 105 6 6 Riferimento ai parametri SBO Parametri SBO predefiniti Specifica se le operazioni SQL eseguite a fronte del database hanno luogo come transazioni in blocco o in modo individuale. Descrizione Per impostazione predefinita, questo parametro non è elencato nel file .sbo. Aggiungere il parametro al file .sbo se il driver di accesso ai dati non supporta la modalità per transazioni. Yes: le operazioni a fronte del database sono eseguite in blocco quando vengono inviate. Valori No: ogni istruzione SQL viene immediatamente inviata. In questo modo, l'invio automatico è disattivato. Nota: Non utilizzare un driver con Transactional Avai lable=No per accedere al repository Business Objects. Predefinito Yes. Valore impostato nel file cs.cfg. Transaction Mode <Parameter Name="Transaction Mode">AutoCommit</Parameter> Descrizione Specifica la modalità di transazione utilizzata dal database. AutoCommit: le istruzioni vengono salvate automaticamente dopo il completamento di una richiesta. Valori Transactional: dopo il completamento, una chiamata esplicita completa o esegue il rollback dell'istruzione. 106 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO predefiniti Predefinito Se non viene specificato, il valore viene recuperato dal middleware del database. Tipo <Parameter Name="Type">Relational</Parameter> Specifica il tipo di origine dati. Descrizione Nota: Questo parametro non deve essere modificato. Versione <Parameter Name="Version">Relational</Parameter> Specifica la versione del database. Descrizione Nota: Questo parametro non deve essere modificato. XML Max Size <Parameter Name="XML Max Size">2048</Parameter> Descrizione Specifica le dimensioni massime consentite per i dati XML. Manuale dell'accesso ai dati 107 6 6 Riferimento ai parametri SBO Parametri SBO Informix Valori Dimensioni massime per i dati XML, in byte. Predefinito Varia in base al database. Parametri SBO Informix Questi parametri si applicano al file SBO Informix e vengono utilizzati per definire la connessione a un database Informix. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\informix\informix.sbo. Nota: Oltre ai parametri SBO, per Informix in ambiente Unix è necessario modificare il file ODBC.INI. Argomenti correlati • • V5toV6DriverName a pagina 109 Per modificare il file ODBC.INI di Informix a pagina 108 Per modificare il file ODBC.INI di Informix Per utilizzare il livello di accesso ai dati con un database Informix in un ambiente UNIX, è necessario modificare la configurazione Unicode. Le informazioni di configurazione si possono trovare nelle seguenti posizioni: • File .odbc.ini nella home directory. • File specificato dalla variabile di ambiente ODBCINI. 1. Individuare il file ODBC.INI o il file specificato dalla variabile di ambiente ODBCINI e aprirlo in un editor di testo. 2. Nel file, individuare la sezione [ODBC]. 3. Aggiungere la seguente riga alla sezione [ODBC]: UNICODE=UTF-8 4. Chiudere e salvare il file. 108 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO Informix Esempio: Sezione ODBC con la configurazione aggiunta Questo codice è un esempio di sezione ODBC con le informazioni corrette aggiunte: [ODBC] UNICODE=UTF-8 V5toV6DriverName <Parameter Name="V5toV6DriverName">{Informix 3.34 32 BIT}</Pa rameter> Descrizione Specifica la regola di conversione da Informix Connecta Informix ODBC. Il valore di questo parametro determina il driver Informix utilizzato per definire il nome origine dati (DSN, Data Source Name) ODBC senza la stringa di connessione. Valori Nome esatto del driver Informix installato sul computer. Predefinita Valore impostato nel file cs.cfg. Unicode <Parameter Name="Unicode">CharSet</Parameter> Manuale dell'accesso ai dati 109 6 6 Riferimento ai parametri SBO Parametri SBO JavaBean Descrizione Specifica se il driver di accesso può utilizzare la configurazione Unicode del middleware cliente. Questo parametro appare come predefinito del driver nel file cs.cfg. Il relativo valore è applicabile a tutti i driver di accesso ai dati. Per impostazione predefinita, questo parametro non è elencato nel file SBO. Se si desidera sovrascrivere il valore predefinito, aggiungerlo alla sezione Defaults del file SBO per il driver di accesso ai dati di destinazione. UTF8: codifica UCS/Unicode Transformation Format a 8 bit. Valori CharSet: codifica del set di caratteri. UCS2: codifica Universal Character Set a 2 byte. Predefinita Valore impostato nel file cs.cfg. Parametri SBO JavaBean Questi parametri si applicano al file SBO JavaBean e vengono utilizzati per definire una connessione JavaBean. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\javabean\javaean.sbo. JavaBean Class <Parameter Name="JavaBean Class">stringa</Parameter> 110 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO JavaBean Descrizione Definisce il punto d'ingresso del JavaBean utilizzato dall'applicazione Business Objects. Il punto d'ingresso è la definizione di una classe java che si estende dall'interfaccia Bean specificata tramite il pacchetto com.businessobjects. Valori Nome classe JavaBean completo. Predefinito Nessuno. Formato URL <Parameter Name="URL Format ">stringa</Parameter> Specifica il formato dell'URL. Descrizione La specifica JDBC non indica il formato della stringa di connessione richiesta. I fornitori utilizzano tipi diversi di formati dell'URL, ad esempio: • Fornitore MySQL: jdbc:mysql://$DATASOURCE$/$DATABASE$ • Fornitore Oracle: jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$ Valori Formato dell'URL Predefinito Nessuno Manuale dell'accesso ai dati 111 6 6 Riferimento ai parametri SBO Parametri SBO JDBC Parametri SBO JDBC Questi parametri si applicano al file SBO JDBC e vengono utilizzati per definire una connessione JDBC. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\jdbc\jdbc.sbo. ForeignKeys Available <Parameter Name="ForeignKeys Available">True</Parameter> Descrizione Specifica se è possibile recuperare le chiavi esterne. True: è possibile recuperare le chiavi esterne. Valori False: non è possibile recuperare le chiavi esterne. Predefinito True JDBC Class <Parameter Name="JDBC Class">stringa</Parameter> Descrizione 112 Manuale dell'accesso ai dati Classe java completa del driver JDBC. Riferimento ai parametri SBO Parametri SBO ODBC Valori Dipende dal fornitore o fonte dati, ad esempio: • oracle.jdbc: driver Oracle per Oracle • Predefinito com.ibm.db2.jcc.DB2Driver: per DB2 Nessuno. PrimaryKey Available <Parameter Name="PrimaryKey Available">True</Parameter> Descrizione Specifica se è possibile recuperare le chiavi primarie. True: è possibile recuperare le chiavi primarie. Valori False: non è possibile recuperare le chiavi primarie. Predefinito True Parametri SBO ODBC Questi parametri si applicano al file SBO ODBC e vengono utilizzati per definire una connessione SBO ODBC. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\odbc\odbc.sbo. Manuale dell'accesso ai dati 113 6 6 Riferimento ai parametri SBO Parametri SBO ODBC Connection Status Available <Parameter Name="Connection Status Available">True</Parameter> Descrizione Specifica se il middleware è in grado di rilevare una connessione errata. True: il middleware è in grado di rilevare una connessione errata. Valori False: il middleware non è in grado di rilevare una connessione errata. Predefinito Valore impostato nel middleware. Empty String <Parameter Name="Empty String">NullString</Parameter> Descrizione Specifica che determinate funzioni, ad esempio le tabelle SQL, ricevono una stringa vuota o un puntatore nullo per sostituire i parametri mancanti. NullString: specifica che viene utilizzata una stringa null. Valori EmptyString: specifica che viene utilizzata una stringa vuota. Predefinito 114 Manuale dell'accesso ai dati EmptyString Riferimento ai parametri SBO Parametri SBO ODBC Force Close Statement <Parameter Name="Force Close Statement">True</Parameter> Descrizione Specifica che l'istruzione SQL viene chiusa dopo il completamento dell'esecuzione. True: l'istruzione SQL viene chiusa dopo l'esecuzione. Valori False: l'istruzione SQL non viene chiusa dopo l'esecuzione. Native Int64 Available <Parameter Name="Native Int64 Available">False</Parameter> Descrizione Valori Indica se il middleware è in grado di gestire direttamente gli interi a 64 bit. True: specifica che il middleware è in grado di gestire gli interi a 64 bit. False: il livello di accesso ai dati emula i metodi Int64. Predefinito True ODBC Cursors <Parameter Name="ODBC Cursors">No</Parameter> Manuale dell'accesso ai dati 115 6 6 Riferimento ai parametri SBO Parametri SBO ODBC Descrizione Specifica se la libreria di cursori ODBC viene utilizzata dal driver di accesso ai dati. Yes: la libreria di cursori ODBC viene utilizzata dal driver di accesso ai dati. Valori No: la libreria di cursori ODBC non viene utilizzata dal driver di accesso ai dati. Predefinita Valore impostato nel file cs.cfg. SQLDescribeParam Available <Parameter Name="SQLDescribeParam Available">True</Parameter> Descrizione Specifica se è disponibile il metodo SQLDescribeParam Available. True: specifica che il metodo SQLDescribeParam Available è disponibile. Valori False: specifica che il metodo SQLDescribeParam Available non è disponibile. Predefinito Valore impostato nel middleware del database. SQLMoreResults Available <Parameter Name="SQLMoreResults Available">True</Parameter> 116 Manuale dell'accesso ai dati Riferimento ai parametri SBO Parametri SBO ODBC Descrizione Specifica se il metodo SQLMoreResults Available è supportato. True: specifica che il metodo SQLMoreResults Available è supportato. Valori False: specifica che il metodo SQLMoreResults Available non è supportato. Predefinito Valore impostato nel middleware. Use DataDirect OEM Driver <Parameter Name="Use DataDirect OEM Driver">No</Parameter> Descrizione Specifica se le connessioni ai database MS SQL Server utilizzano i driver DataDirect ODBC con marchio. Yes: la connessione utilizza il driver con marchio. Valori No: la connessione non utilizza il driver con marchio. Predefinita No Argomenti correlati • Configurazione dell'accesso ai dati per driver con marchio ODBC DataDirect a pagina 77 Manuale dell'accesso ai dati 117 6 6 Riferimento ai parametri SBO Parametri SBO OLE DB Parametri SBO OLE DB Questi parametri si applicano al file SBO OLE DB e vengono utilizzati per definire una connessione SBO OLE DB. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\oledb\oledb.sbo. Enumerator CLSID <Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Parame ter> Nota: Non modificare questo parametro. Descrizione Specifica l'ID classe dell'enumeratore OLEDB. Questo parametro viene utilizzato soltanto con OLEDB. Provider CLSID <Parameter Name="Provider CLSID">MSDASQL</Parameter> Nota: Non modificare questo parametro. Descrizione 118 Manuale dell'accesso ai dati Specifica l'ID classe del provider OLEDB. Questo parametro viene utilizzato soltanto con OLEDB. Riferimento ai parametri SBO Parametri SBO OLAP OLE DB Parametri SBO OLAP OLE DB Questi parametri si applicano al file SBO OLAP OLE_DB e vengono utilizzati per definire una connessione SBO OLE DB per OLAP. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\sqlsrv_as\oledb_olap.sbo. MSOlap CLSID <Parameter Name="MSOlap CLSID">msolap.4</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica l'ID classe del provider OLEDB. Questo parametro viene utilizzato solo con OLAP OLEDB Sybase ASE/CTLIB Questi parametri si applicano al file SBO Sybase ASE/CTLIB e vengono utilizzati per definire una connessione Sybase ASE/CTLIB. Questi parametri vengono definiti nel file \\dir-installazione-connectio nserver\connectionServer\sybase\sybase.sbo. Quoted Identifier <Parameter Name="Quoted Identifier">True</Parameter> Descrizione Specifica se gli identificatori tra virgolette sono supportati. Manuale dell'accesso ai dati 119 6 6 Riferimento ai parametri SBO Sybase ASE/CTLIB True: gli identificatori tra virgolette sono supportati. 120 Valori False: gli identificatori tra virgolette non sono supportati. Predefinito Valore impostato nel middleware. Manuale dell'accesso ai dati Configurazione dei parametri di generazione SQL 7 7 Configurazione dei parametri di generazione SQL Informazioni sui parametri di generazione SQL Informazioni sui parametri di generazione SQL I parametri di generazione SQL controllano le query generate per recuperare il contenuto di un universo. È possibile impostare i parametri di generazione SQL: • a livello di universo: i parametri vengono impostati quando si crea o si modifica un universo • a livello di database: i parametri vengono impostati nel file PRM per il database - questi parametri vengono sostituiti da qualsiasi altra impostazione corrispondente del file PRM a livello di universo Per il driver di accesso ai dati sono disponibili operatori data, altri operatori e funzioni a cui è possibile accedere aprendo il file <driver>.prm in un editor XML. Informazioni sui file PRM I file .prm contengono i parametri che controllano il modo in cui le applicazioni Business Objects generano il codice SQL. Per ogni driver di database esiste un file .prm corrispondente. I file .prm consentono a fattori dipendenti dal database di controllare in che modo un universo genera il codice SQL, in base alla connessione e al database al quale è associato. È possibile anche configurare i parametri di generazione SQL dall'interno di un universo. Le impostazioni che vengono definite in un universo sostituiscono le impostazioni presenti nel file .prm. Il file .prm di ogni driver si trova nella directory dir-installazione-conne ctionserver\connectionServer\<RDBMS>, dove <RDBMS> è il nome del database. Sono disponibili i seguenti file <driver>.prm: 122 Manuale dell'accesso ai dati Configurazione dei parametri di generazione SQL Informazioni sui file PRM Driver di accesso ai dati File PRM File di testo guida PRM (inglese) 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 per SQL Server 7 e 2000. Microsoft SQL Server sqlsrv.prm per SQL sqlsrv7en.prm Server 2005. sqlsrven.prm sqlsrv_as.rm per i servizi di analisi. Microsoft Jet msjet.prm msjeten.prm MySQL mysql.prm mysqlen.prm Manuale dell'accesso ai dati 123 7 7 Configurazione dei parametri di generazione SQL Informazioni sui file PRM Driver di accesso ai dati File PRM File di testo guida PRM (inglese) 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 per Oracle 9. Oracle oracle9en.prm 10 e versioni successive. 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 124 oracle.prm per Oracle Manuale dell'accesso ai dati Configurazione dei parametri di generazione SQL Informazioni sui file PRM Driver di accesso ai dati File PRM File di testo guida PRM (inglese) SAP sap.prm sapen.prm Teradata teradata.prm teradataen.prm I file <driver>.prm sono in formato XML. Se necessario, utilizzare un editor XML per visualizzare e modificare i valori contenuti in questi file. Struttura dei file dei parametri PRM Per ogni middleware RDBMS supportato esiste un file <driver>.prm. Ogni file <driver> .prm è suddiviso nelle seguenti sezioni: ogni sezione contiene parametri per cui sono impostati dei valori predefiniti: Sezione del file Descrizione Parametri SQL utilizzati per la creazione e l'ottimizzazione di un universo, ad esempio, COMMA, OUTERJOINS_GENERATION, REVERSE_TABLE_WEIGHT. Questi paraConfigurazione metri non sono disponibili direttamente per nessun prodotto Business Objects e vengono descritti nel presente capitolo. Gli operatori data disponibili in Universe Designer, DeskDateOperations top Intelligence e Web Intelligence, ad esempio YEAR, QUARTER, MONTH. Operatori Gli operatori disponibili in Universe Designer, Desktop Intelligence e Web Intelligence, ad esempio ADD, SUBSTRACT, MULTIPLY. Manuale dell'accesso ai dati 125 7 7 Configurazione dei parametri di generazione SQL Informazioni sui file PRM Sezione del file Descrizione Le funzioni disponibili in Universe Designer, Desktop Intelligence e Web Intelligence, ad esempio Media, Somma, Varianza. Il testo guida visualizzato quando si selezionano le funzioni di questa sezione in Universe Designer, Desktop Intelligence e Web Intelligence è contenuto nel file <driver><lingua>.prm, ad esempio oracleen.prm. Questo file si trova nella stessa directory del file <driver>.prm. È possibile aprirlo per visualizzare le descrizioni di tutte le funzioni disponibili nel file <driver>.prm. La sezione Function contiene le seguenti sottosezioni: • Group: indica se l'uso di questa funzione in una query genera una clausola group by. Funzioni 126 Manuale dell'accesso ai dati • True indica che la query genera una clausola group by. • False indica che la query non genera una clausola group by. • ID: in Reporter, si tratta del nome visualizzato nell'elenco delle funzioni. • InMacro: in Reporter, se questo valore è True, la funzione viene riportata nell'elenco delle funzioni Oggetti utente e se è False la funzione non viene riportata in tale elenco. • Type: tipo dati della funzione. • Arguments: argomenti accettati dalla funzione. Una funzione può avere al massimo quattro argomenti ed eventuali altri argomenti non vengono presi in considerazione. • SQL: sintassi SQL per la funzione. Configurazione dei parametri di generazione SQL Per visualizzare e modificare un file PRM Nota: in questo capitolo viene riportato solo il contenuto della sezione Configurazione. I parametri della sezione Configurazione possono essere modificati per ottimizzare le query a fronte degli universi che utilizzano il driver di accesso ai dati di destinazione. Argomenti correlati • Per visualizzare e modificare un file di testo della guida alle funzioni a pagina 127 Per visualizzare e modificare un file PRM È possibile visualizzare, modificare e aggiungere i parametri ad un file PRM nel seguente modo: 1. Individuare la directory contenente il file PRM del driver di accesso ai dati di destinazione. I file PRM si trovano nella directory: dir-installazione-connectionserver\connectionServer\<rdb ms>\<driver>.prm 2. 3. 4. 5. Aprire un file <driver>.prm in un editor XML. Espandere le sezioni come necessario. Impostare i valori immettendo il valore nel tag appropriato. Salvare e chiudere il file. Per visualizzare e modificare un file di testo della guida alle funzioni Il testo guida visualizzato per ogni funzione quando selezionata in Universe Designer viene conservato in un file XML separato. È possibile modificare e aggiungere testo descrittivo per una funzione modificando il file <driver>.<lingua>.prm. Per ogni lingua dei prodotti Business Objects installati è presente un file di testo guida. Il testo guida viene visualizzato quando una funzione memorizzata nel file PRM viene selezionata in Universe Designer: Quando si aggiunge una funzione al file RPM, è necessario aggiungere il testo della guida per la nuova funzione nel file <driver><lingua>.prm Manuale dell'accesso ai dati 127 7 7 Configurazione dei parametri di generazione SQL Modifica del testo della guida per una funzione del file PRM appropriato. Ad esempio, se si aggiunge una funzione al file oracle.prm, è necessario aggiungere in questo file anche il nome della funzione e il testo della guida per la funzione, se si sta utilizzando la versione in inglese di Universe Designer. Modifica del testo della guida per una funzione del file PRM 1. Individuare la directory contenente il file di lingua PRM del driver di accesso ai dati di destinazione. I file di lingua PRM si trovano nella directory: connectionserver-installdir\connectionServer\<rdbms>\<driver><language>.prm Ad esempio, oracleen.prm. 2. Aprire un file <driver><lingua>.prm in un editor XML. 3. Espandere la sezione Messages. 4. Per aggiungere del testo guida per una nuova funzione, effettuare quanto segue: • Aggiungere una nuova sezione per una funzione. Il modo più semplice per eseguire tale operazione è di copiare una funzione esistente nella sezione Function. Quindi, modificare il testo della nuova funzione. • Immettere il testo guida per la funzione. 5. Per visualizzare o modificare del testo guida di una funzione esistente, effettuare quanto segue: • Espandere la sezione Function. • Espandere la sezione Message per una funzione. • Modificare il testo guida come necessario. 6. Salvare e chiudere il file. 128 Manuale dell'accesso ai dati Riferimento ai parametri PRM 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Riferimento alla configurazione dei file PRM I parametri SQL della sezione Configurazione sono elencati in ordine alfabetico. Per visualizzare le funzioni, gli operatori delle date e gli altri operatori disponibili, aprire il file <driver>.prm in un editor XML. Ogni parametro viene definito nel seguente tag: <Parameter Name="parametro "> valore</Parameter> dove parameter indica il nome del parametro e value indica il valore attribuito al parametro. Ogni parametro viene visualizzato con le seguenti informazioni: • esempio di visualizzazione del parametro nel file XML • descrizione del parametro • valori che è possibile impostare per il parametro • valore predefinito per il parametro Nota: alcuni parametri di configurazione non devono essere modificati. Tali parametri dispongono di valori impostati per essere utilizzati internamente nelle soluzioni Business Objects e vengono descritti nella presente sezione, ma contengono un messaggio che indica di non modificare il valore. Non modificare questi parametri. Prima di modificare i parametri del file PRM, è necessario creare una copia di backup del file PRM. BACK_QUOTE_SUPPORTED <Parameter Name="BACK_QUOTE_SUPPORTED">Y</Parameter> Descrizione 130 Manuale dell'accesso ai dati Specifica se racchiudere o meno i nomi di tabelle o colonne contenenti spazi o caratteri speciali in virgolette semplici. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Y: racchiude tra virgolette semplici il nome delle tabelle e delle colonne. Valori N: non racchiude tra virgolette semplici il nome delle tabelle e delle colonne. Predefinita Y Risultato Nome tabella=`My Table` CASE_SENSITIVE <Parameter Name="CASE_SENSITIVE">N</Parameter> Descrizione Specifica se il database riconosce le maiuscole e le minuscole. Parametro utilizzato con Oracle. Y: specifica che il database riconosce l’uso delle maiuscole e delle minuscole. Valori N: specifica che il database non riconosce l’uso delle maiuscole e delle minuscole. Predefinita N CHECK_OWNER_STATE <Parameter Name="CHECK_OWNER_STATE">N</Parameter> Manuale dell'accesso ai dati 131 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Descrizione Specifica se il codice SQL verifica se il database supporta la classificazione delle tabelle in base al nome del proprietario. Y: il codice SQL verifica se il database supporta la classificazione delle tabelle in base al nome del proprietario. Valori N: il codice SQL non verifica se il database supporta la classificazione delle tabelle in base al nome del proprietario. Predefinita Y CHECK_QUALIFIER_STATE <Parameter Name="CHECK_QUALIFIER_STATE">N</Parameter> Descrizione Specifica se il codice SQL verifica se il database supporta la classificazione in base al qualificatore. Y: verifica se il database supporta la classificazione delle tabelle in base al qualificatore. Valori N: non verifica se il database supporta la classificazione delle tabelle in base al qualificatore. Predefinita 132 Manuale dell'accesso ai dati Y Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM COMMA <Parameter Name="COMMA">||' '||</Parameter> Specifica l’operatore di concatenamento del database usato per sostituire una virgola per gli oggetti che presentano la seguente sintassi: Descrizione Tab.Col1, Tab.Col2. Il parametro viene utilizzato con tutti i driver di accesso ai dati. ||' '|| Valori +' '+ Predefinita ||' '|| Risultato Tab.Col1||' '||Tab.Col2 CONCAT <Parameter Name="CONCAT">||</Parameter> Descrizione Specifica l’operatore di concatenamento. Il parametro viene utilizzato con tutti i driver di accesso ai dati. || Valori + Manuale dell'accesso ai dati 133 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Predefinita || CONSTANT_SAMPLING_SUPPORTED CONSTANT_SAMPLING_SUPPORTED Descrizione Specifica se il database supporta il campionamento casuale. Sì: il database supporta il campionamento casuale. Valori No: il database non supporta il campionamento casuale. Predefinita Yes DATABASE_DATE_FORMAT <Parameter Name="DATABASE_DATE_FORMAT">DD-MM-YYYY HH24:MI:SS</Parameter> 134 Descrizione Solo per Oracle. Specifica i formati di data e ora predefiniti memorizzati sul server. Valori DD-MM-YYYY HH24:MI:SS Predefinita DD-MM-YYYY HH24:MI:SS Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM DATATYPE_BLOB Name="Datatype_Blob">LONGVARCHAR</Parameter> Nota: Non modificare questo parametro. Descrizione Tipi di dati database colonne per oggetto Blob. Questo parametro non viene utilizzato in questa versione. È incluso per la compatibilità con le versioni successive. DATATYPE_DOUBLE <Parameter Name="Datatype_Double">: i valori dipendono dal the database. Nota: Descrizione Non modificare questo parametro. Tipi di dati database colonne per oggetto Date (comando tabella CREATE) DATATYPE_DTM <Parameter Name="Datatype_Dtm">DATE</Parameter> Nota: Descrizione Non modificare questo parametro. Tipi di dati database colonne per oggetto Date (comando tabella CREATE) Manuale dell'accesso ai dati 135 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM DATATYPE_INT <Parameter Name="Datatype_Int">NUMBER</Parameter> Nota: Descrizione Non modificare questo parametro. Tipi di dati database colonne per oggetto Numeric (comando tabella CREATE) DATATYPE_NULL <Parameter Name="Datatype_Null"/> Nota: Descrizione Non modificare questo parametro. Sintassi SQL del database per i valori nulli (comando INSERT) DATATYPE_STRING <Parameter Name="Datatype_String">VARCHAR2</Parameter> Nota: Descrizione 136 Manuale dell'accesso ai dati Non modificare questo parametro. Tipi di dati database colonne per oggetti Character e Long (comando tabella CREATE) Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM DATE_WITHOUT_QUOTE <Parameter Name="DATE_WITHOUT_QUOTE">Y</Parameter> Descrizione Specifica il supporto per le date senza virgolette singole nella sintassi SQL. Il parametro viene utilizzato con MS Access. Valori Y: le date non vengono racchiuse tra virgolette singole. N: le date vengono racchiuse tra virgolette singole. Predefinita Y DELIMIT_IDENTIFIERS <Parameter Name="DELIMIT_IDENTIFIERS">YES</Parameter> Descrizione Specifica se le virgolette impostate nel parametro IDENTIFIER_DELIMITER vengono utilizzate per racchiudere i nomi delle tabelle e delle colonne. YES: viene utilizzato il delimitatore specificato in IDENTIFIER_DELIMITER. Valori NO: il delimitatore specificato in IDENTIFIER_DELIMITER non viene utilizzato. Predefinita YES Manuale dell'accesso ai dati 137 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Risultato Nome tabella="my_table" EXT_JOIN <Parameter Name="EXT_JOIN">YES</Parameter> Specifica se sono supportati i join esterni. Descrizione Viene utilizzato con tutti i driver di accesso ai dati. YES: il database supporta i join esterni. Valori Predefinita NO : database non supporta join esterni. Le caselle di controllo Join esterno nella finestra di dialogo Modifica join di Universe Designer non sono disponibili. YES EXT_JOIN_INVERT <Parameter Name="EXT_JOIN_INVERT">YES</Parameter> Specifica come visualizzare un simbolo di join esterno in un’espressione di join. Descrizione Questo parametro viene utilizzato con IBM DB2, Informix, Oracle e Teradata. 138 Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM YES: quando si fa clic su una casella di controllo Join esterno nella finestra di dialogo Modifica join di Universe Designer, il simbolo di join esterno appare in posizione inversa in un'espressione di join. Valori NO: quando si fa clic su una casella di controllo Join esterno nella finestra di dialogo Modifica join di Universe Designer, il simbolo di join esterno appare sullo stesso lato in cui è stato creato il join esterno. Predefinita YES EXTERN_SORT_EXCLUDE_DISTINCT <Parameter Name="EXTERN_SORT_EXCLUDE_DISTINCT">Y</Parameter> Descrizione Specifica se l'applicazione genera un'istruzione SELECT DISTINCT quando una query contiene la clausola ORDER BY. Y: l'istruzione SELECT DISTINCT non viene generata se la query contiene una clausola ORDER BY. Valori N: l'istruzione DISTINCT viene generata se la query contiene una clausola ORDER BY. Predefinita Y GROUPBY_EXCLUDE_COMPLEX Parameter Name="GROUPBY_EXCLUDE_COMPLEX">N</Parameter> Manuale dell'accesso ai dati 139 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Descrizione Specifica se il database consente l’inserimento di formule, alias o indici nelle clausole GROUP BY. Il parametro viene utilizzato con IBM DB2. Valori Y: specifica che il database non consente l’inserimento di formule, alias o indici nelle clausole GROUP BY. Se si esegue una query contenente oggetti indicatore e oggetti complessi (ad esempio la funzione di sottostringa o l'operatore di concatenazione), nell'applicazione viene visualizzato il seguente messaggio di errore: Il database non consente di creare aggregazioni con l'oggetto <nome oggetto>. N: specifica che il database consente l’inserimento di formule, alias o indici nelle clausole GROUP BY. Predefinita N GROUPBY_WITH_ALIAS <Parameter Name="GROUPBY_WITH_ALIAS">Y</Parameter> Descrizione Specifica se il database può creare una clausola GROUP BY nell'istruzione SELECT. Il parametro viene utilizzato con Red Brick. 140 Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Valori Y: consente di creare una clausola GROUP BY nell'istruzione SELECT. È possibile utilizzare un alias, ad esempio, per sostituire un'istruzione T1.col + T2.col +...Tn.col n .col . N: non consente di creare una clausola GROUP BY nell'istruzione SELECT. Predefinita Y GROUPBY_WITHOUT_CONSTANT <Parameter Name="GROUPBY_WITHOUT_CONSTANT">Y</Parameter> Descrizione Specifica se viene autorizzata o meno l’aggiunta di oggetti con definizione SQL corrispondente a una costante in una clausola GROUP BY. Il parametro viene utilizzato con IBM DB2 e Microsoft SQL Server Y: specifica che è possibile aggiungere un qualsiasi oggetto costante alla query, che tuttavia non sarà presente nella clausola GROUP BY. Valori N: specifica che è possibile inserire tutti gli oggetti di una query (ad esempio, senza funzione di aggregazione) in una clausola GROUP BY. Predefinita Y Manuale dell'accesso ai dati 141 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM GROUPBYCOL <Parameter Name="GROUPBYCOL">NO</Parameter> Descrizione Specifica se una clausola GROUP BY accetta interi come nomi di colonna. YES: specifica che una clausola GROUP BY accetta un indice della colonna dall'istruzione SELECT anziché il nome della colonna. Valori NO: specifica che una clausola GROUP BY non accetta un indice della colonna dall'istruzione SELECT anziché il nome della colonna. Predefinita NO IDENTIFIER_DELIMITER <Parameter Name="IDENTIFIER_DELIMITER">"</Parameter> 142 Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Specifica che: • • Descrizione i nomi delle tabelle o colonne che contengono spazi o caratteri speciali devono essere racchiusi tra virgolette se il parametro BACK_QUOTE_SUPPORTED è attivato. i nomi delle tabelle o delle colonne, indipendentemente dai caratteri in essi contenuti, devono essere racchiusi tra virgolette se il parametro DELIMIT_IDENTIFIERS è attivato. Per utilizzare questo parametro, BACK_QUOTE_SUPPORTED o DELIMIT_IDENTIFIERS deve essere impostato su YES. Questo è il valore predefinito per entrambi i parametri. ": i nomi delle tabelle o delle colonne che contengono spazi o caratteri speciali sono racchiusi tra virgolette. Valori ': i nomi delle tabelle o delle colonne che contengono spazi o caratteri speciali sono racchiusi tra apici. Questo valore può essere usato solo con Microsoft Access. Predefinita " Risultato Nome tabella="My Table" IF_NULL <Parameter Name="IF_NULL">NO</Parameter> Descrizione Specifica una funzione che utilizza due parametri. Se il primo parametro restituisce NULL, viene utilizzato il valore del secondo parametro. Manuale dell'accesso ai dati 143 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Valori Dipende dal database. Predefinito Dipende dal database. INTERSECT <Parameter Name="INTERSECT">INTERSECT</Parameter> Descrizione Specifica se il database supporta l’operatore impostato INTERSECT. INTERSECT: : il database supporta l'operatore impostato INTERSECT. Valori nessun valore: il database non supporta l'operatore impostato INTERSECT. In questo caso, vengono generate due query. Predefinita INTERSECT KEY_INFO_SUPPORTED <Parameter Name="KEY_INFO_SUPPORTED">Y</Parameter> Descrizione 144 Manuale dell'accesso ai dati Specifica se è possibile recuperare definizioni di chiavi primarie e secondarie dall’account del database. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Valori Y: specifica che il database consente di recuperare definizioni di chiavi primarie e secondarie dall’account del database. Questo parametro consente a Universe Designer di visualizzare le chiavi nella finestra Struttura. N: specifica che il database non consente di recuperare definizioni di chiavi primarie e secondarie dall’account del database. Predefinita Y LEFT_OUTER <Parameter Name="LEFT_OUTER">$(+)</Parameter> <Parameter Name="LEFT_OUTER">$*</Parameter> Descrizione Specifica la sintassi dei join esterni sinistri. $(+) Questa sintassi viene utilizzata con Oracle. $ rappresenta un’espressione di join. Valori $* Questa sintassi viene utilizzata con Sybase, MS SQL Server e Red Brick. $ rappresenta un’espressione di join. Predefinita Vedere i valori di cui sopra. Manuale dell'accesso ai dati 145 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM LENMAXFORCOLUMNNAME <Parameter Name="LenMaxForColumnName">30</Parameter> Nota: Non modificare questo parametro. Descrizione Lunghezza massima per il nome delle colonne (per impostazione predefinita viene proposto il nome dell'oggetto) (comando tabella CREATE) LENMAXFORTABLENAME <Parameter Name="LenMaxForTableName">30</Parameter> Nota: Descrizione Non modificare questo parametro. Lunghezza massima del tipo di dati della colonna VARCHAR (comando di tabellaCREATE). LENMAXFORVARCHAR <Parameter Name="LenMaxForVarchar">254</Parameter> Nota: Descrizione 146 Manuale dell'accesso ai dati Non modificare questo parametro. Lunghezza massima del tipo di dati della colonna VARCHAR (comando di tabella (CREATE). Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM MINUS <Parameter Name="MINUS">MINUS</Parameter> Descrizione Specifica se il database supporta l’operatore impostato MINUS. MINUS Specifica che il database supporta l’operatore impostato MINUS. Valori EXCEPT Specifica che il database supporta l’operatore impostato MINUS. nessun valore Specifica che il database non supporta l’operatore impostato MINUS. In questo caso, vengono generate due query. Predefinita MINUS NO_DISTINCT <Parameter Name="NO_DISTINCT">Y</Parameter> Descrizione Specifica se il database supporta la parola chiave DISTINCT. Questo parametro viene utilizzato con MS Access. Manuale dell'accesso ai dati 147 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Y: specifica che il database non supporta la parola chiave DISTINCT. Questo comportamento implica la disattivazione di: • L'opzione Valori distinti che viene visualizzata quando si fa clic sul pulsante Valori nell'assistente Creazione rapida degli universi. Valori • La funzione ConteggioDistinto visualizzata al momento della creazione di una condizione con l'operando Calcolo nel Pannello delle query. N: specifica che il database non supporta la parola chiave DISTINCT. Predefinita Y NULL_IN_SELECT_SUPPORTED <Parameter Name="NULL_IN_SELECT_SUPPORTED">Yes</Parameter> Descrizione Specifica se il database supporta NULL come colonna nell'istruzione SELECT. Yes: NULL è supportato come colonna nell'istruzione SELECT. Valori No: NULL non è supportato come colonna nell'istruzione SELECT. Yes Predefinita 148 Manuale dell'accesso ai dati No per i database Teradata, DB2, Informix e Red Brick, che non supportano il valore NULL come colonna. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM OLAP_CLAUSE <Parameter Name="OLAP_CLAUSE">WHEN</Parameter> Descrizione Specifica se le applicazioni Business Objects devono generare una clausola WHEN o QUALIFY se una funzione elencata nel parametro RISQL_Functions viene utilizzata in una condizione. Tale parametro deve essere usato con la clausola GROUPBY. WHEN: genera una clausola WHEN se una funzione elencata nel parametro RISQL_Functions viene utilizzata in una condizione. Si tratta del valore predefinito per i database Red Brick. Valori QUALIFY: genera una clausola QUALIFY se una funzione elencata nel parametro RISQL_Functions viene utilizzata in una condizione. Si tratta del valore predefinito per i database Teradata. Predefinita Vedere i valori di cui sopra. OUTERJOINS_GENERATION <Parameter Name="OUTERJOINS_GENERATION">ANSI92</Parameter> Questo parametro controlla il comportamento predefinito della generazione del join esterno. È possibile impostare • Generazione del join esterno conforme alla specifica ANSI92. • La generazione del join esterno rimane invariata rispetto alle versioni precedenti di Universe Designer. Manuale dell'accesso ai dati 149 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Nota: Il parametro OUTERJOINS_GENERATION del file PRM è correlato all'impostazione ANSI92 dell'universo nel modo seguente: • Se il parametro OUTERJOINS_GENERATION del file PRM è impostato su ANSI92 e l'impostazione ANSI92 dell'universo ha il valore NO, il parametro PRM sovrascrive le impostazioni dell'universo e i join esterni sono conformi al comportamento della specifica ANSI92. • Se il parametro OUTERJOINS_GENERATION del file PRM è impostato su USUAL, l'impostazione ANSI92 dell'universo ha precedenza e i join esterni sono conformi alla specifica ANSI92 a seconda che l'impostazione ANSI92 dell'universo sia YES o NO. Specifica la sintassi SQL per i join esterni. Il valore ANSI 92 genera un join esterno nella clausola FROM. Gli altri valori generano il join esterno nella clausola WHERE. Descrizione 150 Manuale dell'accesso ai dati Quando si modifica questa impostazione, è necessario verificare le proprietà del join per accertarsi che l'espressione del join esterno sia valida e che le cardinalità siano corrette. ANSI92 non supporta alcuna personalizzazione manuale della sintassi del join. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM I valori prmari di OUTERJOINS_GENERATION sono: Valori • ANSI92: il comportamento del join esterno predefinito conforme allo standard ANSI92, a prescindere dal valore del parametro ANSI92 di Universe Designer. • No: i join esterni non sono supportati. • USUAL: il comportamento predefinito del join esterno è invariato rispetto alle versioni precedenti di Universe Designer. Questo comportamento viene ignorato se il parametro ANSI92 di Universe Designer è impostato su Yes. Sono disponibili altre opzioni a seconda del database. Vedere i valori predefiniti riportati di seguito. ANSI_92: valore predefinito per Oracle, SQL Server 2005 e Sybase. DB2: valore predefinito per IBM DB2. FULL_ODBC: può essere utilizzato con Microsoft SQL Server Predefinita INFORMIX: Valore predefinito per Informix. INGRES: valore predefinito per Teradata. NO: valore predefinito per ODBC. USUAL: valore predefinito per Neoview, Netezza, Red Brick, SQL Server 2000. Esempi di impostazioni del parametro OUTERJOINS_GENERATION Impostazione = USUAL: FROM T1, T2 WHERE T1.col1(+) = T2.col2 Manuale dell'accesso ai dati 151 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Impostazione = DB2: FROM T2 LEFT OUTER JOIN T1 ON T1.col1 = T2.col2 Impostazione = ODBC: FROM {oj T1 LEFT OUTER JOIN T2 ON T1.col1=T2.col2} Where (T2.col3 = T3.col1) Impostazione = INFORMIX: FROM T2 OUTER T1 WHERE T1.col1=T2.col2 Impostazione = FULL-ODBC: FROM {oj T1 RIGHT OUTER JOIN T2 ON T2.col2=T1.col1 T2 INNER JOIN 3 on T2.col3 = T3.col1} Impostazione = ANSI_92: SELECT DISTINCT t1.col1, t2.col2 FROM (t1 RIGHT OUTER JOIN t2 ON (t1.col1=t2.col2) ) Utilizzo di OUTERJOINS con Oracle L'impostazione predefinita di OUTERJOINS_GENERATION (ANSI92) può avere effetto sul comportamento di universi esistenti nonostante l'impostazione a livello di universo del parametro ANSI92. Per fare in modo che gli universi Oracle si comportino come nelle versioni precedenti di Universe Designer: 1. Nel file PRM, verificare che il parametro OUTERJOINS_GENERATION sia impostato su USUAL. 2. Nel file PRM, impostare i parametri LEFT_OUTER e RIGHT_OUTER su $(+) 152 Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Per ulteriori informazioni sui parametri SQL degli universi e sui file PRM inclusi nelle versioni precedenti di Universe Designer, consultare il Manuale di Designer. Argomenti correlati • • • LEFT_OUTER a pagina 145 RIGHT_OUTER a pagina 158 Informazioni sui parametri di generazione SQL a pagina 122 OVER_CLAUSE <Parameter Name="OVER_CLAUSE">Y</Parameter> Descrizione Consente alle applicazioni Business Objects di includere funzioni RISQL quando si generano SQL. Le funzioni RISQL supportate per il database sono elencate nel parametro RISQL_FUNCTIONS. Y: le applicazioni possono includere le funzioni RISQL quando si genera il codice SQL. Valori N: le applicazioni possono includere le funzioni RISQL quando si genera il codice SQL. Predefinita Y OWNER <Parameter Name="OWNER">Y</Parameter> Descrizione Specifica se il database supporta il nome del proprietario come prefisso delle tabelle. Manuale dell'accesso ai dati 153 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Y: specifica che il database consente di inserire il nome del proprietario prima del nome delle tabelle. Valori N: specifica che il database non permette di inserire il nome del proprietario prima del nome delle tabelle. Predefinita Y PERCENT_RANK_SUPPORTED <Parameter Name="PERCENT_RANK_SUPPORTED">Yes</Parameter> Descrizione Specifica se il database supporta la funzione analitica Rango percentuale. Yes: il database supporta la funzione analitica Rango percentuale. Valori No: il database non supporta la funzione analitica Rango percentuale. Predefinita Yes PREFIX_SYS_TABLE <Parameter Name="PREFIX_SYS_TABLE">RBW_</Parameter> <Parameter Name="PREFIX_SYS_TABLE">MSys</Parameter> 154 Manuale dell'accesso ai dati Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Descrizione Specifica se le tabelle di sistema vengono visualizzate in Universe Designer. Questo parametro si trova nel file access.prm e nel file redbrick.prm. MSys: specifica che le tabelle di sistema MS Access non vengono visualizzate nel browser delle tabelle di Universe Designer. Valore predefinito per MS Access. Valori RBW_: specifica che le tabelle di sistema Red Brick non vengono visualizzate nel browser delle tabelle di Universe Designer. Valore predefinito per Red Brick. nessun valore: specifica che le tabelle di sistema del database vengono visualizzate nel browser delle tabelle di Universe Designer. Predefinita Vedere i valori di cui sopra. QUALIFIER <Parameter Name="QUALIFIER">N</Parameter> Descrizione Specifica se il database supporta il nome qualificatore come prefisso delle tabelle. Y: specifica che il database permette di inserire il nome del qualificatore prima di quello delle tabelle. Valori N: specifica che il database non permette di inserire il nome del qualificatore prima di quello delle tabelle. Predefinita Dipende dall'RDBMS. Manuale dell'accesso ai dati 155 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM QUOTE_OWNER <Parameter Name="QUOTE_OWNER">Y</Parameter> Descrizione Valori Specifica se inserire il nome del proprietario tra virgolette singole. Utilizzato solo da Informix. Y: specifica che i nomi delle tabelle sono preceduti dal nome del proprietario racchiuso tra virgolette singole. Obbligatorio per i database Informix conformi ad ANSI. Diversamente, Informix converte il nome del proprietario in caratteri maiuscoli. N: specifica che i nomi delle tabelle non sono preceduti dal nome del proprietario racchiuso tra virgolette singole. Predefinita Y SELECT Alias.col (<Alias> è un alias locale) Risultato FROM 'Owner'.table.col Alias RANK_SUPPORTED <Parameter Name="RANK_SUPPORTED">Yes</Parameter> Descrizione 156 Manuale dell'accesso ai dati Specifica se il database supporta la funzione analitica Rango. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Sì: il database supporta la funzione analitica Rango. Valori No: il database non supporta la funzione analitica Rango. Predefinita Yes REFRESH_COLUMNS_TYPE <Parameter Name="REFRESH_COLUMNS_TYPE">O</Parameter> Descrizione Indica in che modo vengono aggiornate le colonne. O: le colonne vengono aggiornate in base al nome del proprietario. Si tratta del valore predefinito per Oracle. Valori Q: le colonne vengono aggiornate in base al nome del qualificatore. Si tratta del valore predefinito per Red Brick, Sybase, MS SQL Server e MS Access. T: le colonne vengono aggiornate in base al nome della tabella. Predefinita Vedere i valori di cui sopra. REVERSE_TABLE_WEIGHT <Parameter Name="REVERSE_TABLE_WEIGHT">Y</Parameter> Manuale dell'accesso ai dati 157 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Descrizione Specifica in quale ordine devono essere generate le tabelle. Questo parametro viene utilizzato con Oracle. Questo parametro può essere utilizzato anche con altri database, se possibile invertendo i valori Y e N. Questo parametro non è supportato da Teradata. N: specifica che le tabelle vengono generate a partire dalla più grande. Valori Y: specifica che le tabelle vengono generate a partire dalla più piccola. Predefinita Y RIGHT_OUTER <Parameter Name="RIGHT_OUTER">$(+)</Parameter> <Parameter Name="RIGHT_OUTER">*$</Parameter> Descrizione Specifica la sintassi dei join esterni destri. $(+): utilizzato con Oracle. $ rappresenta un’espressione di join. Valori *$: utilizzato con Sybase, MS SQL Server e Red Brick. $ rappresenta un’espressione di join. Predefinita 158 Manuale dell'accesso ai dati Vedere i valori di cui sopra. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM RISQL_FUNCTIONS <Parameter Name="RISQL_FUNCTIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Pa rameter> Descrizione Elenca le funzioni RISQL supportate dal database. • Elenco predefinito di 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 Valori • Elenco predefinito di BM DB2: RANK,SUM,AVG,COU NT,MIN,MAX • Elenco predefinito di Teradata: CSUM,MAVG,MDIFF,MLINREG,MSUM,RANK,QUANTILE • Elenco predefinito di Red Brick: CUME,MOVIN GAVG,MOVINGSUM,RANK,RATIOTOREPORT,TERTILE Predefinita Vedere i valori di cui sopra. SEED_SAMPLING_SUPPORTED <Parameter Name="SEED_SAMPLING_SUPPORTED">Yes</Parameter> Manuale dell'accesso ai dati 159 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Descrizione Specifica se il database supporta il campionamento casuale basato sul numero iniziale. Yes: il database supporta il campionamento basato sul numero iniziale. Valori No: il database non supporta il campionamento basato sul numero iniziale. Predefinita No SORT_BY_NO <Parameter Name="SORT_BY_NO">NO</Parameter> Descrizione Valori Specifica se gli utenti sono autorizzati ad ordinare le colonne (rappresentate come oggetti nell'universo) non incluse nell'istruzione SELECT. YES: specifica che gli utenti non sono autorizzati a ordinare le colonne se non sono incluse nell’istruzione SELECT. Quando questo parametro è impostato su YES, il pulsante Gestione ordinamento non è disponibile nel Pannello delle query. NO: specifica che gli utenti sono autorizzati a ordinare le colonne anche se non sono incluse nell’istruzione SELECT. Predefinita 160 Manuale dell'accesso ai dati NO Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM UNICODE_PATTERN <Parameter Name="UNICODE_PATTERN">UNISTR($)</Parameter> Relativo solo a SQL Server e Oracle. Descrizione Questo parametro è applicabile solo se il parametro UNICODE_STRINGS di generazione SQL degli universi è impostato su Y. Tutte le condizioni basate sulle stringhe vengono formattate con questo valore di stringa. Microsoft SQL Server: N$ Predefinita Oracle: UNISTR($) Esempio UNICODE_PATTERN=N$ UNION <Parameter Name="UNION">UNION</Parameter> Descrizione Specifica se il database supporta l’operatore impostato UNION. UNION: il database supporta l'operatore impostato UNION. Valori nessun valore: il database non supporta l'operatore impostato UNION. In questo caso, vengono generate due query. Manuale dell'accesso ai dati 161 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM Predefinita UNION USER_INPUT_DATE_FORMAT <Parameter Name="USER_INPUT_DATE_FORMAT">'dd-MM-yyyy HH:mm:ss'</Parameter> Descrizione Specifica i formati di data e ora predefiniti generati nella clausola WHERE di una procedura SQL. {\d 'yyyy-mm-dd'}: si tratta del formato di data predefinito per ODBC. 'DD-MM-YYYY HH:MM:SS': questi sono i formati di data e ora predefiniti in Oracle. 'MM/DD/YYYY': questo è il formato di data predefinito in Informix. Valori 'yyyy-mm-dd HH:mm:ss': questo è il formato di data e ora predefinito in MS SQL Server e per la maggior parte dei server IBM DB2. 'mm/dd/yyyy hh:m:s am/pm': si tratta del formato predefinito di data e ora per Sybase. 'yyyy-mm-dd': si tratta del formato di data predefinito per un gateway Sybase. Nota: se è necessario utilizzare variabili di tempo o dell'indicazione data e ora con ODBC, sostituire il valore predefinito del formato data con: {\t 'hh:mm:ss'} o {\t\s 'aaaa-mm-gg hh:mm:ss'} nel file odbc.sbo. Predefinita 162 Manuale dell'accesso ai dati Vedere i valori di cui sopra. Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM USER_INPUT_NUMERIC_SEPARATOR <Parameter Name="USER_INPUT_NUMERIC_SEPARATOR">.</Parameter> Descrizione Specifica il separatore dei decimali predefinito utilizzato nel codice SQL generato. Valori '.' Predefinita '.' Manuale dell'accesso ai dati 163 8 8 Riferimento ai parametri PRM Riferimento alla configurazione dei file PRM 164 Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Conversione dei tipi di dati In questo capitolo sono incluse le tabelle di conversione dei dati per ciascun sistema RDBMS supportato. I prodotti Business Objects supportano quattro tipi di dati: • date • carattere • numero • testo lungo Le tabelle di conversione dei dati sono disponibili per i seguenti sistemi RDBMS: • IBM DB2 • Informix • Microsoft SQL Server • Oracle • Red Brick • Sybase • Teradata Nota: Le tabelle di conversione dei dati per gli altri sistemi RDBMS supportati saranno disponibili negli aggiornamenti futuri del Manuale dell'accesso ai dati. IBM DB2 Nella tabella seguente sono elencati i tipi di dati interni IBM DB2 e il corrispettivo nelle soluzioni Business Objects: 166 Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati di IBM DB2 Tipo di dati di Business Objects CLOB DESCRIZIONE LUNGA CARATTERE CARATTERE DATA DATA DECIMAL NUMERICO DOUBLE NUMERICO FLOAT NUMERICO INTEGER NUMERICO LONG VARCHAR DESCRIZIONE LUNGA NUMERIC NUMERICO SMALLINT NUMERICO ORA DATA TIMESTAMP DATA VARCHAR CARATTERE Manuale dell'accesso ai dati 167 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Informix Nella tabella seguente sono elencati i tipi di dati interni Informix e il corrispettivo nelle soluzioni Business Objects: 168 Tipo di dati Informix Tipo di dati BusinessObjects CHAR CARATTERE DATA DATA DATETIME DATA DECIMAL NUMERICO FLOAT NUMERICO INTEGER NUMERICO MONEY NUMERICO NCHAR CARATTERE NVARCHAR CARATTERE SERIAL NUMERICO SMALLINT NUMERICO Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Informix Tipo di dati BusinessObjects SMALLFLOAT NUMERICO TESTO DESCRIZIONE LUNGA VARCHAR CARATTERE Microsoft SQL Server Nella seguente tabella vengono elencati i tipi di dati interni di Microsoft SQL Server e i relativi equivalenti Business Objects. Tipo di dati Microsoft SQL Server Tipo di dati di Business Objects BIT NUMERICO BOOLEAN NUMERICO CHAR CARATTERE DATETIME DATA DECIMAL NUMERICO FLOAT NUMERICO Manuale dell'accesso ai dati 169 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Microsoft SQL Server Tipo di dati di Business Objects INT NUMERICO MONEY NUMERICO NUMERIC NUMERICO REAL NUMERICO SMALLDATETIME DATA SMALLINT NUMERICO SMALLMONEY NUMERICO TESTO CARATTERE TINYINT NUMERICO VARCHAR CARATTERE Oracle Nella tabella seguente sono elencati i tipi di dati interni Oracle e il corrispettivo nelle soluzioni Business Objects: 170 Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Oracle Tipo di dati di Business Objects CHAR CARATTERE CLOB DESCRIZIONE LUNGA DATA DATA FLOAT NUMERICO INTEGER NUMERICO ESTESO DESCRIZIONE LUNGA NUMERICO NUMERICO VARCHAR CARATTERE ALFANUMERICO CARATTERE Red Brick Nella seguente tabella vengono elencati i tipi di dati interni Red Brick e i relativi equivalenti Business Objects. Manuale dell'accesso ai dati 171 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Red Brick Tipo di dati di Business Objects CHAR CARATTERE DATA DATA DECIMAL NUMERICO FLOAT NUMERICO INTEGER NUMERICO NUMERIC NUMERICO SMALLINT NUMERICO ORA DATA TIMESTAMP DATA Per aggiungere il supporto per TIME e TIMESTAMP in una clausola WHERE Gli oggetti che utilizzano i tipi di dati TIME e TIMESTAMP non sono supportati in una clausola WHERE per le query eseguite a fronte di un database Red Brick. È possibile impostare le proprietà di un oggetto in un universo affinché sia supportato l'utilizzo di TIME e TIMESTAMP nella clausola WHERE nel modo seguente: 172 Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Per il supporto di un oggetto con tipo di dati TIME o TIMESTAMP in una clausola WHERE: 1. In Universe Designer fare doppio clic su un oggetto nel riquadro Universo. Viene visualizzata la finestra di dialogo Modifica proprietà di. 2. 3. 4. 5. Fare clic sulla scheda Definizione. Selezionare Data nell'elenco a discesa Tipo. Fare clic sulla scheda Avanzate. Nella casella di testo Formato del database digitare le seguenti informazioni: Per... Tipo Supporto TIME HH:MM:SS Supporto TIMESTAMP MM/GG/AAAA HH:MM:SS 6. Fare clic su OK. Sybase Nella tabella seguente sono elencati i tipi di dati interni Sybase e il corrispettivo nelle soluzioni Business Objects. Tipo di dati Sybase Tipo di dati di Business Objects BIT NUMERICO CHAR CARATTERE DATETIME DATA Manuale dell'accesso ai dati 173 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Sybase Tipo di dati di Business Objects DECIMAL NUMERICO FLOAT NUMERICO INT NUMERICO MONEY NUMERICO NUMERIC NUMERICO REAL NUMERICO SMALLDATETIME DATA SMALLINT NUMERICO SMALLMONEY NUMERICO TINYINT NUMERICO VARCHAR CARATTERE Teradata Nella tabella seguente sono elencati i tipi di dati interni Teradata e il corrispettivo nelle soluzioni Business Objects. 174 Manuale dell'accesso ai dati Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati Tipo di dati Teradata Tipo di dati di Business Objects DATA DATA DECIMAL NUMERICO FLOAT NUMERICO INTEGER NUMERICO SMALLINT NUMERICO BYTEINT NUMERICO DATETIME DATA VARCHAR CARATTERE Manuale dell'accesso ai dati 175 9 9 Riferimento per la conversione dei tipi di dati Conversione dei tipi di dati 176 Manuale dell'accesso ai dati Ulteriori informazioni A A Ulteriori informazioni Informazioni Posizione Informazioni sul prodotto SAP Busines- http://www.sap.com sObjects Selezionare http://help.sap.com > SAP BusinessObjects. Nel portale della Guida in linea SAP è possibile accedere alla documentazione più aggiornata riguardante tutti i prodotti SAP BusinessObjects e la relativa distribuzione. È possibile scaricare le versioni PDF o le librerie HTML installabili. SAP Help Portal 178 Manuale dell'accesso ai dati Alcuni manuali sono memorizzati nel SAP Service Marketplace e non sono disponibili nel SAP Help Portal. Questi manuali sono elencati nell'Help Portal accompagnati da un collegamento al SAP Service Marketplace. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. Ulteriori informazioni Informazioni Posizione http://service.sap.com/bosap-support > Documentazione • • Guide all'installazione: https://service.sap.com/bosapinstguides Note sulla versione: http://service.sap.com/release notes Nel SAP Service Marketplace sono memorizzati alcuni documenti dei seguenti tipi: guide all'installazione, SAP Service Market- manuali di aggiornamento e migrazione, manuali della place distribuzione in rete, note sulla versione e documenti relativi alle piattaforme supportate. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. Se si viene reindirizzati al SAP Service Marketplace dal SAP Help Portal, utilizzare il menu nel riquadro di spostamento sulla sinistra per individuare la categoria contenente la documentazione a cui si desidera accedere. https://boc.sdn.sap.com/ Risorse per lo sviluphttps://www.sdn.sap.com/irj/sdn/businessobjects-sdk patore library Articoli su SAP Busi- https://www.sdn.sap.com/irj/boc/businessobjects-ar nessObjects relativi ticles a SAP Community Questi articoli erano conosciuti in precedenza come Network schede tecniche. https://service.sap.com/notes Note Queste note erano conosciute in precedenza come articoli di knowledge base. Manuale dell'accesso ai dati 179 A A Ulteriori informazioni Informazioni Posizione Forum su SAP Comhttps://www.sdn.sap.com/irj/scn/forums munity Network http://www.sap.com/services/education Formazione I pacchetti di formazione disponibili variano dal tradizionale apprendimento in classe ai seminari di e-learning mirati e sono in grado di soddisfare qualsiasi esigenza e stile di apprendimento. http://service.sap.com/bosap-support SAP Support Portal contiene informazioni sui programmi e i servizi del supporto tecnico. Inoltre, contiene Supporto tecnico in collegamenti a una vasta gamma di informazioni teclinea niche e download. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. http://www.sap.com/services/bysubject/businessobje ctsconsulting Consulenza 180 Manuale dell'accesso ai dati I consulenti sono a disposizione dei clienti dalla fase di analisi iniziale fino alla consegna del progetto di di stribuzione. Possono essere fornite consulenze su argomenti quali i database relazionali e multidimensio nali, la connettività, gli strumenti di progettazione del database e la tecnologia di incorporamento persona lizzata. Indice A accesso al database configurazione 69 installazione 71 accesso al database, controllo 33 ANSI92, sintassi SQL 149 architettura di sistema 13 architettura, sistema 13 Array Bind Available 85 Array Bind Size 85 Array Fetch Available 86 B BACK_QUOTE_SUPPORTED 130 Blob_Comparison 131 Boundary_Weight_Table 131 Business Objects servizi di consulenza 65 servizi di formazione 65 C Case_Sensitive 131 CASE_SENSITIVE 131 Catalog Name Max Size 87 Catalog Separator 87 CharSet 88 Charset List Extension 63 CHECK_OWNER_STATE 131 CHECK_QUALIFIER_STATE 132 ClassPath creazione di una connessione JavaBean 40 ClassPath (segue) creazione di una connessione JDBC 36 clausola LIKE Escape 95 Column Name Max Size 88 COMMA 133 componenti connessione 12 CONCAT 133 Config File Extension 63 Connection Server configurazione del metodo di accesso 68 configurazione dell'accesso ai dati per driver con marchio DataDirect 78 configurazione delle impostazioni globali 62 configurazione delle impostazioni predefinite del driver 61 configurazione di connessioni JDBC a Data Federator 50 configurazione di connessioni ODBC a Universe Designer e Web Intelligence Rich Client 57 configurazione per connessioni ODBC a Data Federator 53 configurazione per connessioni Web Intelligence a Data Federator 56 configurazione per distribuzione complessa 69 creazione di connessioni JDBC 36 creazione di connessioni JDBC generiche 38 creazione di connessioni ODBC generiche 43 creazione di connessioni ODBC3 generiche 44 creazione di una connessione JavaBean 40 debug all'avvio 68 Manuale dell'accesso ai dati 181 Indice Connection Server (segue) definizione 12 in modalità server standalone 72 informazioni sui parametri globali 60 Connection Shareable 89 Connection Status Available 114 connessioni creazione per Data Federator 48 requisiti per la creazione 20 connessioni JavaBean creazione 40 informazioni su 40 connessioni JDBC creazione 36 informazioni su 35 connessioni ODBC informazioni su 42 controllo dell'accesso al database 33 Cost Estimate Available 89 cs.cfg informazioni su 60 cscheck assistenza per l’uso 21 elenco delle funzioni 23 esecuzione 22 sintassi 23 Cumulative_Object_Where 90 D Data Federator configurazione di connessioni ODBC 52 configurazione di connessioni ODBC a Web Intelligence Rich Client 55 directory di installazione 51 informazioni sulla creazione di connessioni 48 versione richiesta 48 database elenco database supportati 24 database supportati, elenco 24 DATABASE_DATE_FORMAT 134 182 Manuale dell'accesso ai dati DataDirect 77 DATATYPE_BLOB 135 DATATYPE_DOUBLE 135 DATATYPE_DTM 135 DATATYPE_INT 136 DATATYPE_NULL 136 DATATYPE_STRING 136 DATE_WITHOUT_QUOTE 137 dati, accesso file al livello di driver 15 file globali 15 file installati 14 DELIMIT_IDENTIFIERS 137 Description Extension 63 Description File 90 dimensioni array fetch 86 directory di installazione percorso 60 Distribution file CFG 72 driver controllo della convalida 29 DataDirect 77 verifica della disponibilità in un computer 29 driver C++ 42 Driver Capabilities 90 driver con marchio 77 Driver defaults file CFG 61 driver di accesso ai dati configurazione dei parametri 74 controllo della convalida 29 file PRM 122 file utilizzati da 15 informazioni su 13 ricerca di componenti installati 25 selezione 69 verifica della disponibilità in un computer 29 driver Java 35 Indice E EBUS 50 Empty String 114 Enable Failed Load 64 Enumerator CLSID 118 Escape Character 91 Ext_Join 138 EXT_JOIN 138 EXT_JOIN_INVERT 138 Extensions 91 EXTERN_SORT_EXCLUDE_DISTINCT 139 F Family 92 Field Size Factor 92 file CFG Charset List Extension 63 Config File Extension 63 Description Extension 63 elemento DataBase 69 elemento NetworkLayer 69 Enable Failed Load 64 Load Drivers On Startup 65 Max Pool Time 65 modifica 61 parametri Protocols 72 riferimento ai parametri Settings 62 sezione ActiveDataSources 69 sezione Distribution 72 sezione DriverDefaults 61 sezione Library 68 sezione Server 68 SQL External Extension 67 SQL Parameter Extension 67 Strategies Extension 68 visualizzazione 61 file di configurazione categorie parametri 82 file SBO installati 75 SBO JavaBean, esempio 41 file PRM BACK_QUOTE_SUPPORTED 130 CASE_SENSITIVE 131 CHECK_OWNER_STATE 131 CHECK_QUALIFIER_STATE 132 COMMA 133 CONCAT 133 DATABASE_DATE_FORMAT 134 DATATYPE_BLOB 135 DATATYPE_DOUBLE 135 DATATYPE_DTM 135 DATATYPE_INT 136 DATATYPE_NULL 136 DATATYPE_STRING 136 DATE_WITHOUT_QUOTE 137 DELIMIT_IDENTIFIERS 137 elenco di file 122 elenco di riferimento 130 EXT_JOIN 138 EXT_JOIN_INVERT 138 EXTERN_SORT_EXCLUDE_DISTINCT 139 GROUPBY_EXCLUDE_COMPLEX 139 GROUPBY_WITH_ALIAS 140 GROUPBY_WITHOUT_CONSTANT 141 GROUPBYCOL 142, 143, 148, 154, 156, 159 IDENTIFIER_DELIMITER 142 informazioni su testo della guida alle funzioni 127 INTERSECT 144 KEY_INFO_SUPPORTED 144 LEFT_OUTER 145 LENMAXFORCOLUMNNAME 146 LENMAXFORTABLENAME 146 LENMAXFORVARCHAR 146 MINUS 147 modifica 127 modifica testo della guida 128 NO_DISTINCT 147 OLAP_CLAUSE 149 OUTERJOINS_GENERATION 149 Manuale dell'accesso ai dati 183 Indice file PRM (segue) OVER_CLAUSE 153 OWNER 153 PREFIX_SYS_TABLE 154 QUALIFIER 155 QUOTE_OWNER 156 REFRESH_COLUMNS_TYPE 157 REVERSE_TABLE_WEIGHT 157 riferimento 122 RIGHT_OUTER=$(+) 158 RISQL_FUNCTIONS 159 SORT_BY_NO 160 struttura 125 UNICODE_PATTERN 161 UNION 161 USER_INPUT_DATE_FORMAT 162 USER_INPUT_NUMERIC_SEPARATOR 163 visualizzazione 127 Force Close Statement 115 Force Execute 92 FORCE_SORTED_LOV parametri dell’universo 134 ForeignKeys Available 112 formazioneVedere formazione 65 G globali file di accesso ai dati 15 GROUPBY_EXCLUDE_COMPLEX 139 GROUPBY_WITH_ALIAS 140 GROUPBY_WITHOUT_CONSTANT 141 GROUPBYCOL 142, 143, 148, 154, 156, 159 guida file PRM 127 guida, cscheck 21 I IBM DB2 tipi di dati 166 Identifier Case 93 Identifier Quote String 94 IDENTIFIER_DELIMITER 142 impostazioni riferimento ai parametri CFG 62 Impostazioni internazionali 95 Informix modifica del file ODBC.ini 108 tipi di dati 168 Unicode 109 V5toV6DriverName 109 installazione controllo del driver di accesso ai dati 29 directory Data Federator 51 file installati 14 Intersect 144 INTERSECT 144 J JavaBean JavaBean Class 110 URL Format 111 JavaBean Class 110 JavaBean, parametri SBO 110 JDBC ForeignKeys Available 112 generico 38 JDBC Class 112 PrimaryKey Available 113 JDBC Class 112 jdbc.sbo 36 K KEY_INFO_SUPPORTED 144 Knowledge Base 65 184 Manuale dell'accesso ai dati Indice L O Left_Outer 145 LEFT_OUTER 145 LENMAXFORCOLUMNNAME 146 LENMAXFORTABLENAME 146 LENMAXFORVARCHAR 146 livelli di rete controllo della connettività con il middleware 31 elenco database supportati 24 selezione 69 verifica dei middleware disponibili 28 livelli di rete supportati, elenco 24 Load Drivers On Startup 65 LongVarcharNotSupported 115 ODBC Connection Status Available 114 driver DataDirect 77 Empty String 114 esposizione livello database in modalità server 72 Force Close Statement 115 Native Int64 Available 115 ODBC Cursors 115 ODBC2 generica 43 ODBC3 generica 44 SQLDescribeParam Available 116 SQLMoreResults Available 116 Use DataDirect OEM Driver 117 ODBC Cursors 115 OLAP OLE DB MSOlap CLSID 119 OLAP_Clause 149 OLAP_CLAUSE 149 OLE DB Enumerator CLSID 118 Provider CLSID 118 Optimize Execute 96 Oracle esempio di controllo della connettività 33 tipi di dati 170 origine dati JDBC generica 38 origine dati ODBC generica 43 origine dati ODBC3 generica 44 OUTERJOINS_GENERATION 149 OVER_CLAUSE 153 OWNER 153 Owners Available 97 M Max Pool Time 65 Max Rows Available 96 Max_Inlist_Values 147 middleware controllo della connettività con il livello di rete 31 verifica della disponibilità in un computer 28 Minus 147 MINUS 147 modalità bloccaggio 115 modalità libreria 68 modalità server 68 MS SQL Server 77 MSOlap CLSID 119 N Native Int64 Available 115 NO_DISTINCT 147 P parametri dell’universo FORCE_SORTED_LOV 134 parametri di configurazione Informix 108 Manuale dell'accesso ai dati 185 Indice parametri di driverit.prm Blob_Comparison 131 Boundary_Weight_Table 131 Case_Sensitive 131 Cumulative_Object_Where 90 Ext_Join 138 Intersect 144 Left_Outer 145 Max_Inlist_Values 147 Minus 147 OLAP_Clause 149 Quote_Owner 156 Refresh_Columns_Type 157 parametri driver.sbo LongVarcharNotSupported 115 modalità bloccaggio 115 parametro SQL elenco di file PRM 130 Password Encryption 97 ping, controllo dell'accesso al database 33 PREFIX_SYS_TABLE 154 PrimaryKey Available 113 procedura guidata Nuova connessione configurazione per Data Federator 49 Procedure Name Max Size 98 Procedure Parameter Name Max Size 99 Protocols file CFG 72 Provider CLSID 118 Q QUALIFIER 155 Qualifiers Available 99 Query TimeOut Available 100 Quote_Owner 156 QUOTE_OWNER 156 Quoted Identifier 119 Quoted Identifier Case 100 186 Manuale dell'accesso ai dati R Red Brick supporto di TIME in WHERE 172 supporto di TIMESTAMP in WHERE 172 tipi di dati 171 Refresh_Columns_Type 157 REFRESH_COLUMNS_TYPE 157 requisiti connessioni 20 versione minima di Data Federator 48 REVERSE_TABLE_WEIGHT 157 RIGHT_OUTER=$(+) 158 RISQL_FUNCTIONS 159 S SBO JavaBean, esempio 41 SBO, file Array Bind Available 85 Array Bind Size 85 Array Fetch Available 86 Catalog Name Max Size 87 Catalog Separator 87 categorie parametri 82 CharSet 88 clausola LIKE Escape 95 Column Name Max Size 88 configurazione di una connessione JDBC 36 Connection Shareable 89 Connection Status Available 114 Cost Estimate Available 89 Description File 90 dimensioni array fetch 86 Driver Capabilities 90 Empty String 114 Enumerator CLSID 118 Escape Character 91 Extensions 91 Family 92 Field Size Factor 92 Indice SBO, file (segue) Force Close Statement 115 Force Execute 92 ForeignKeys Available 112 Identifier Case 93 Identifier Quote String 94 Impostazioni internazionali 95 installati 75 JavaBean Class 110 JDBC Class 112 Max Rows Available 96 modifica 77 MSOlap CLSID 119 Native Int64 Available 115 ODBC Cursors 115 Optimize Execute 96 Owners Available 97 parametri Databases 82 parametri Defaults 82 Password Encryption 97 PrimaryKey Available 113 Procedure Name Max Size 98 Procedure Parameter Name Max Size 99 Provider CLSID 118 Qualifiers Available 99 Query TimeOut Available 100 Quoted Identifier 119 Quoted Identifier Case 100 Schema Name Max Size 101 Shared Connection 101 SQL External File 102 SQL Parameter File 102 SQLDescribeParam Available 116 SQLMoreResults Available 116 SSO Available 104 Strategies File 104 struttura 82 Table Name Max Size 105 Tipo 107 Transaction Available 105 Transaction Mode 106 Unicode 109 SBO, file (segue) URL Format 111 Use DataDirect OEM Driver 117 V5toV6DriverName 109 Versione 107 visualizzazione 77 XML Max Size 107 Schema Name Max Size 101 Shared Connection 101 SORT_BY_NO 160 SQL External Extension 67 SQL External File 102 SQL Parameter Extension 67 SQL Parameter File 102 SQL Server tipi di dati 169 SQLDescribeParam Available 116 SQLMoreResults Available 116 SSO Available 104 stored procedure informazioni sulle connessioni JavaBean 40 Strategies Extension 68 Strategies File 104 Sybase esempio di controllo della connettività 33 Quoted Identifier 119 tipi di dati 173 T tabelle di conversione 166 Table Name Max Size 105 Teradata tipi di dati 174 tipi di dati IBM DB2 166 Informix 168 Oracle 170 Red Brick 171 SQL Server 169 Sybase 173 Manuale dell'accesso ai dati 187 Indice tipi di dati (segue) Teradata 174 tipi di parametro, configurazione 60 tipo 107 Transaction Available 105 Transaction Mode 106 Transient Object Timeout 68 U Unicode 109 UNICODE_PATTERN 161 UNION 161 URL Format 111 Use DataDirect OEM Driver 117 USER_INPUT_DATE_FORMAT 162 USER_INPUT_NUMERIC_SEPARATOR 163 188 Manuale dell'accesso ai dati V V5toV6DriverName 109 Versione 107 W Web Intelligence Rich Client impostazione della chiave di registro 56 informazioni sulla creazione di connessioni 54 X XML Max Size 107