Création de paramètres HTTP dans le pilote XML

  1. Dans l'écran Paramètres HTTP, cliquez sur Ajouter une propriété.
  2. Dans l'écran Modifier la valeur de la propriété, saisissez un nom pour le paramètre dans le champ Propriété.
  3. Saisissez une formule de paramètre sous la forme d'une fonction @Prompt dans le champ Valeur.

    Voir Formules de paramètres pour en savoir plus sur la syntaxe de la fonction @Prompt.

Formules de paramètres

Les formules de paramètres sont créées à l'aide de la fonction @Prompt. Cette fonction est utile lorsque vous souhaitez forcer une restriction dans le flux XML sans définir à l'avance la valeur de la condition.

La syntaxe de la fonction se présente comme suit :

@Prompt('message','type',[lov],[MONO|MULTI],[FREE|CONSTRAINED])

Syntaxe Description

'message'

Ce paramètre correspond au texte du message d'invite. Le texte doit être entouré de guillemets simples ; par exemple, 'Choisir une région', 'Sélectionner une période' ou 'Choisir une salle'. Le texte s'affiche dans la boîte d'invite une fois la connexion terminée.

'type'

Ce paramètre décrit le type de données renvoyé par la fonction. Il peut s'agir de l'un des types suivants :

  • 'A' pour alphanumérique
  • 'N' pour nombre
  • 'D' pour date

Le type de données spécifié doit être entouré de guillemets simples.

lov

Ce paramètre fournit une liste de valeurs (lov, list of values). La liste est figée dans le code ; c'est-à-dire que vous la créez en saisissant les valeurs séparées. Chaque valeur est entourée de guillemets simples et les différentes valeurs sont séparées par des virgules. La liste complète est entourée d'accolades. Par exemple, {'Australie', 'France', 'Japon', 'Royaume-Uni', 'Etats-Unis'}. Ce paramètre est facultatif.

MONO

Les utilisateurs ne peuvent sélectionner qu'une seule valeur dans la liste. MONO est la valeur par défaut pour la paire MONO|MULTI. Ce paramètre est facultatif.

MULTI

Les utilisateurs peuvent sélectionner plusieurs valeurs dans la liste. MONO est la valeur par défaut pour la paire MONO|MULTI. Ce paramètre est facultatif.

FREE

Les utilisateurs peuvent saisir la valeur de leur choix, mais ils peuvent également sélectionner une valeur dans la liste. FREE est la valeur par défaut de la paire FREE|CONSTRAINED. Ce paramètre est facultatif.

CONSTRAINED

Les utilisateurs doivent sélectionner une valeur dans la liste. FREE est la valeur par défaut de la paire FREE|CONSTRAINED. Ce paramètre est facultatif.

Remarque :    Pour chacun des paramètres facultatifs, si vous omettez un argument, vous devez toujours entrer les virgules comme séparateurs.

Connexion à une source de données XML

Pour choisir XML comme source de données
  1. Dans Crystal Reports, dans le menu Fichier, cliquez sur Nouveau.
  2. Cliquez sur en utilisant l'Assistant Etat.
  3. Dans la liste Choisir un assistant, cliquez sur Standard, puis cliquez sur OK.
  4. Dans l'écran Données de l'Assistant de création d'état, cliquez deux fois sur Créer une nouvelle connexion.
  5. Cliquez deux fois sur XML.

    La boîte de dialogue XML s'affiche.

  6. Choisissez un type d'accès à la source de données XML :
  7. Identifiez le fichier XML auquel vous souhaitez vous connecter en suivant la procédure de l'une de ces sections :
Pour se connecter à une source de données locale
  1. Si vous choisissez Utiliser la source de données locale, saisissez le chemin complet ainsi que le nom du fichier XML ou utilisez le bouton situé en regard du champ pour rechercher le fichier.
  2. Choisissez Spécifier le fichier schéma si vous souhaitez appliquer un schéma au fichier XML que vous avez sélectionné.

    Vous devez sélectionner cette option et spécifier un schéma sauf si le fichier XML contient des informations de schéma intégrées.

    Remarque :    La définition de l'emplacement et du nom du schéma s'effectue à l'écran suivant.

  3. Cliquez sur Suivant.

    En fonction de la sélection effectuée à l'étape précédente, soit un écran s'affiche pour spécifier votre schéma, soit vous pouvez cliquer sur le bouton Terminer.

  4. Pour spécifier un fichier schéma, choisissez Utiliser le schéma local ou Utiliser le schéma HTTP(S) et remplissez le champ adjacent.
  5. Cliquez sur Suivant, puis sur Terminer.
Pour se connecter à une source de données HTTP(S)
  1. Si vous choisissez Utiliser la source HTTP(S), saisissez l'URL qui pointe vers votre fichier XML.

    Vous pouvez utiliser HTTP ou HTTPS pour définir votre URL.

  2. Choisissez Spécifier le fichier schéma si vous souhaitez appliquer un schéma au fichier XML que vous avez sélectionné.

    Vous devez sélectionner cette option et spécifier un schéma sauf si le fichier XML contient des informations de schéma intégrées.

    Remarque :    La définition de l'emplacement et du nom du schéma s'effectue dans un prochain écran.

  3. Cliquez sur Suivant.
  4. Entrez des informations d'authentification si nécessaire, puis cliquez à nouveau sur Suivant.

    En fonction de la sélection effectuée à l'étape 2, un écran s'affiche pour spécifier votre schéma ou pour définir les paramètres HTTP. S'il s'agit de l'écran des paramètres HTTP, passez à l'étape 6.

  5. Pour spécifier un fichier schéma, choisissez Utiliser le schéma local ou Utiliser le schéma HTTP(S) et remplissez le champ adjacent.
  6. Dans l'écran Paramètres HTTP, créez les paramètres qui peuvent être ajoutés à votre URL pour limiter les résultats renvoyés dans votre fichier XML.
  7. Cliquez sur Terminer lorsque vous avez terminé vos opérations dans l'écran Paramètres HTTP.
Pour se connecter à une source de données Web Service
  1. Si vous choisissez Utiliser la source de données Web Service, cliquez sur Suivant pour continuer.
  2. Pour spécifier l'emplacement d'un fichier de services Web, choisissez Utiliser le WSDL local ou Utiliser HTTP(S) WSDL et remplissez le champ adjacent.
  3. Cliquez sur Suivant.

    En fonction de la sélection effectuée à l'étape précédente, un écran s'affiche pour spécifier votre service Web, les ports et les méthodes ou pour définir l'authentification pour l'URL du service Web. S'il s'agit de l'écran permettant de définir le service Web, les ports et les méthodes, passez à l'étape 5.

  4. Entrez des informations d'authentification si nécessaire, puis cliquez sur Suivant.
  5. Dans l'écran Web Service, port et méthode, choisissez un service, un port et une méthode à partir des listes.
  6. Cliquez sur Terminer.

Une fois la table créée à partir de la source de données XML, vous pouvez l'utiliser pour créer un état Crystal de la même façon que vous le feriez pour toute autre source de données. Pour en savoir plus sur la création des états Crystal, voir le Guide de l'utilisateur de Crystal Reports.

Référence du paramètre CRDB_JavaServer.ini

Voir Composants requis pour l'emplacement du fichier CRDB_JavaServer.ini.

Les paramètres qui apparaissent dans le fichier CRDB_JavaServer.ini dépendent des pilotes que vous installez. Par exemple, si vous n'installez pas le pilote XML natif, les paramètres [CRDB_XML] ne s'affichent pas. Le fichier CRDB_JavaServer.ini peut contenir tous les paramètres suivants :

Nom du paramètre Description

Path

La valeur de paramètre Path contient le répertoire de votre exécutable Java. Si plusieurs versions du Java Runtime Environment sont installées, ce paramètre pointe vers la version que vous souhaitez utiliser ; par exemple :

PATH=C:\apps\j2sdk1.4.2\bin

Les informations de chemin peuvent également être configurées en tant que variable d'environnement utilisateur ou système. Dans ce cas, si JAVA_HOME est défini en tant que variable, vous pouvez utiliser ${JAVA_HOME} comme décrit dans l'exemple suivant :

PATH=${JAVA_HOME}\bin

Classpath

La valeur de paramètre Classpath contient une liste des chemins de classe permettant d'accéder aux fichiers .jar suivants :

  • CRDBJavaServer.jar
  • Tous les fichiers .jar du pilote JDBC spécifiques à la base de données

    Pour le pilote JDBC Oracle, par exemple, le chemin de classe du fichier ojdbc14.jar est requis.

Les informations de chemin de la classe peuvent également être configurées en tant que variable d'environnement utilisateur ou système. Si cette variable n'est pas définie, cela équivaut à CLASSPATH=${CLASSPATH}.

Les variables d'environnement peuvent également être incluses dans un chemin mixte, comme illustré dans l'exemple suivant :

classpath=c:\java\lib\xerces.jar;${CommonProgramFiles}"/Crystal Decisions/2.5/bin/CRDBJavaServer.jar";${CLASSPATH}

Remarque :    Lorsque vous utilisez des chemins de classe avec des noms de dossiers et/ou de fichiers longs et contenant des espaces, assurez-vous de les entourer de guillemets. Par exemple, "C:\Program Files\Common Files\Crystal Decisions\2.5\bin\CRDBJavaServer.jar".

IORFileLocation

La valeur de paramètre IORFileLocation fournit un répertoire temporaire au pilote JDBC. Cet emplacement doit exister et être accessible au système ; autrement, le pilote ne fonctionnera pas.

JavaServerTimeout

Le paramètre JavaServerTimeout spécifie la durée maximale pendant laquelle votre serveur Java continuera à traiter votre requête jusqu'à son arrêt. La valeur par défaut est 1 800 secondes (30 minutes).

JVMMaxHeap

Le paramètre JVMMaxHeap spécifie la quantité maximale de mémoire disponible que la JVM peut allouer pour l'exécution du serveur Java. Ce paramètre est défini sur 64 Mo de mémoire disponible par défaut. Augmentez cette valeur si vous devez traiter une quantité importante de données.

JVMMinHeap

Le paramètre JVMMinHeap spécifie la quantité minimale de mémoire disponible que la JVM peut allouer pour l'exécution du serveur Java. Ce paramètre est défini sur 32 Mo de mémoire disponible par défaut.

CacheRowSetSize

Le paramètre CacheRowSetSize spécifie le nombre de lignes à placer dans la mémoire cache. Ce paramètre est défini sur 100 lignes par défaut.

JDBCURL

La valeur de paramètre JDBCURL est l'URL de connexion JDBC par défaut qui s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données JDBC. Le format exact de l'URL de connexion est spécifique au serveur de base de données et est donné par le fournisseur du pilote de base de données.

Par exemple, l'URL de connexion pour le pilote JDBC Oracle est :

jdbc:oracle:thin:@<nomhôte>:<port>:<sid>

Où :

  • <nomhôte> représente l'adresse TCP/IP ou le nom de l'hôte TCP/IP du serveur auquel vous vous connectez.
  • <port> représente le numéro du port TCP/IP.
  • <sid> représente l'ID de la base de données Oracle.

JNDIURL

La valeur de paramètre JNDIURL est l'URL de connexion JNDI par défaut qui s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données JNDI. Le format exact de l'URL de connexion est spécifique au serveur de base de données et est donné par le fournisseur du pilote de base de données.

JDBCUserName

JDBCUserName est l'ID utilisateur par défaut qui s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données JDBC. Le pilote JDBC utilise l'ID utilisateur pour se connecter à la base de données.

JDBCDriverName

JDBCDriverName est le nom de classe complet par défaut du pilote JDBC qui s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données JDBC.

Par exemple, le nom de classe complet du pilote JDBC Oracle est :

oracle.jdbc.driver.OracleDriver

JNDIUserName

JNDIUserName est l'ID utilisateur par défaut qui s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données JNDI. Le pilote JDBC utilise l'ID utilisateur pour se connecter à la base de données.

JNDIConnectionFactory

Le paramètre JNDIConnectionFactory est le nom de la référence de connexion du serveur JNDI. Pour WebLogic, il s'agit de weblogic.jndi.WLInitialContextFactory. Pour WebSphere, il s'agit de com.ibm.websphere.naming.WsnInitialContextFactory.

JNDIInitContext

Le paramètre JNDIInitContext est le point de départ de la recherche du contexte JNDI sur le serveur JNDI. Par exemple, vous pouvez définir JNDIInitContext=/ pour WebLogic. Le paramètre démarre la recherche en haut de l'arborescence. Vous pouvez définir ce paramètre sur cell/nodes/localhost/servers/server1/jdbc pour WebSphere si vous avez créé la connexion dans ce nœud.

GenericJDBCDriverBehavior

Si vous utilisez un pilote JDBC générique à la place d'un pilote spécifique, le paramètre GenericJDBCDriverBehavior spécifie le pilote dont vous souhaitez émuler le comportement. L'émulation du comportement du pilote JDBC DB2 est définie par défaut. La conservation de ce paramétrage signifie que vous souhaitez rendre disponibles les fonctionnalités du pilote JDBC DB2 à l'utilisateur final. Les valeurs valides sont DB2, SQLServer et Oracle.

PREREADNBYTE

Le paramètre PREREADNBYTE détermine le nombre d'octets à lire à partir du document XML pour chaque lecture logique. Ce paramètre est utilisé pour améliorer l'efficacité et pour éviter la lecture des octets un par un ; cela équivaut à la taille de la lecture de bloc. La taille ne doit pas être trop petite (au moins 4096). Mais une valeur trop grande affecte l'utilisation de la mémoire. Par défaut, ce paramètre a la valeur 5 000.

XMLLOCALURL

La valeur de paramètre XMLLOCALURL est l'URL de connexion par défaut d'un fichier XML local. La valeur par défaut s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données XML.

SCHEMALOCALURL

La valeur de paramètre SCHEMALOCALURL est l'URL de connexion par défaut d'un fichier schéma local. La valeur par défaut s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données XML.

XMLHTTPURL

La valeur de paramètre XMLHTTPURL est l'URL de connexion par défaut d'un fichier XML HTTP. La valeur par défaut s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données XML utilisant HTTP(S).

SCHEMAHTTPURL

La valeur de paramètre SCHEMAHTTPURL est l'URL de connexion par défaut d'un fichier schéma HTTP. La valeur par défaut s'affichera dans Crystal Reports à la création d'une nouvelle connexion de données XML utilisant HTTP(S).


Business Objects
http://www.france.businessobjects.com/
Support technique
http://www.businessobjects.com/services/support/