Pour afficher les propriétés d'un document. Business Objects Web Intelligence Java

Utilisation des documents

24

Pour purger les données d'un document

Pour afficher les propriétés d'un document

• Cliquez avec le bouton droit de la souris sur un rapport à l'extérieur des composants de rapport et sélectionnez Propriétés du document dans le menu ou cliquez sur ... en regard de la propriété Général > Propriétés

du document de l'onglet Données.

Pour purger les données d'un document

1.

Cliquez sur Purger les données dans la barre d'outils principale.

Web Intelligence purge les données du document.

2.

Si le document contient plusieurs requêtes et que vous voulez purger les données d'une requête spécifique, cliquez sur la flèche à droite du bouton

Purger les données et sélectionnez Purger <Nom de la requête> dans le menu.

Web Intelligence purge les données de la requête.

Liaison vers d'autres documents

Liaison vers d'autres documents

Vous pouvez définir les cellules des documents Web Intelligence en tant que liens hypertexte. Les liens hypertexte Web Intelligence sont semblables aux liens hypertexte Internet, en ce sens qu'ils permettent d'ouvrir une autre page Web lorsque vous naviguez.

Lorsque vous cliquez sur une cellule contenant un lien hypertexte,

Web Intelligence ouvre le document cible spécifié dans le lien. Ce document cible peut être un document Web Intelligence, un document Crystal Reports, un site Internet ou une ressource quelconque accessible via un lien hypertexte.

Les liens hypertexte sont statiques ou dynamiques. Un lien hypertexte statique est toujours lié de façon identique au même document. En revanche, la liaison établie par un lien hypertexte dynamique dépend des données du document contenant le lien.

298 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Vous pouvez créer différents types de liens hypertexte :

• Une cellule dont le texte constitue le texte du lien.

• Une cellule à laquelle est associé un lien hypertexte.

• Un lien vers un autre document du CMS.

Texte de cellule défini comme lien hypertexte

Lorsque le texte d'une cellule est défini en tant que lien hypertexte, ce texte de cellule devient le texte même du lien hypertexte. Par exemple, si vous définissez comme lien hypertexte une cellule individuelle contenant le texte http://www.businessobjects.com

, vous accédez au site Business Objects lorsque vous cliquez sur la cellule.

Cette technique est particulièrement indiquée dans le cas de liens hypertexte statiques pour lesquels le texte de la cellule ne change jamais et est toujours lié de façon identique à la même ressource.

Remarque :

Vous pouvez transformer ces liens en liens hypertexte dynamiques en utilisant le langage des formules Web Intelligence pour modifier le texte de cellule à partir de données de rapport.

Pour définir le texte d'une cellule comme lien hypertexte

1.

Saisissez le texte du lien hypertexte dans la cellule.

2.

Si vous utilisez Web Intelligence en mode interactif, cliquez avec le bouton droit de la souris sur la cellule et sélectionnez Lien hypertexte > Lire

le contenu comme lien hypertexte dans le menu.

Remarque :

Vous pouvez également cliquer avec le bouton droit de la souris sur la cellule et sélectionner Format > Cellule dans le menu pour afficher la boîte de dialogue "Format des cellules", puis sélectionner Lire le contenu

comme et Lien hypertexte dans la liste.

3.

Si vous utilisez l'éditeur de rapport Java, cliquez sur la cellule, puis attribuez à la propriété de cellule Affichage > Lire contenu de cellule

comme la valeur Lien hypertexte.

Création de rapports à l'aide de l'Editeur de rapport Java 299

Utilisation des documents

24

Liaison vers d'autres documents

Lien hypertexte associé à une cellule

Lorsque vous associez un lien hypertexte à une cellule, vous définissez un lien hypertexte utilisé par Web Intelligence pour atteindre le document source lorsque l'utilisateur clique sur la cellule. Le texte de la cellule ne constitue pas, en soi, le lien hypertexte.

Cette technique de création de liens hypertexte dynamiques est la mieux adaptée, pour plusieurs raisons :

• Elle a été spécialement conçue pour les paramètres des liens hypertexte dynamiques.

• Elle évite d'utiliser la syntaxe complexe des liens hypertexte : le lien hypertexte est défini à l'aide d'une interface graphique, puis créé et géré en arrière-plan par Web Intelligence.

• Elle permet de définir un texte de lien hypertexte différent de celui de la cellule.

Pour ajouter un lien hypertexte à une cellule

1.

Cliquez sur la cellule avec le bouton droit de la souris et sélectionnez

Lien hypertexte > Nouveau pour afficher la boîte de dialogue "Créer un lien hypertexte".

2.

Sélectionnez Lien vers une page Web à gauche de la boîte de dialogue.

(Web Intelligence Interactive uniquement.)

3.

Saisissez ou collez le texte du lien hypertexte dans la case.

4.

Cliquez sur Analyser pour extraire les paramètres du lien hypertexte dans la zone Personnaliser les paramètres d'URL (invisible tant que vous n'avez pas cliqué sur Analyser).

Les liens hypertexte dynamiques comportent des paramètres dont les valeurs peuvent changer. Les paramètres apparaissent sous forme de portions nom=valeur

à la fin du lien hypertexte, après le point d'interrogation. Par exemple, l'URL http://salesandproductreport/default.asp?reportname=products comprend un paramètre, nomrapport

, dont la valeur est "produits".

Après avoir cliqué sur Analyser, chaque paramètre s'affiche sur une ligne : le nom du paramètre figure à gauche et sa valeur à droite. La partie statique du lien hypertexte (sans les paramètres) apparaît dans la section

Principale.

300 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

5.

Pour demander à Web Intelligence de fournir comme valeurs de paramètre des données issues de formules ou de variables, cliquez sur la flèche en regard de chaque valeur de paramètre et sélectionnez une option.

Option Description

Générer une formule

Vous générez une formule dans l'Editeur de formule pour que son résultat serve de valeur de paramètre.

Sélectionner un objet

Vous choisissez l'objet dans la liste de la boîte de dialogue

"Sélectionner un objet" pour que sa valeur serve de valeur de paramètre.

Remarque :

Lorsque vous modifiez un paramètre, Web Intelligence modifie toute la syntaxe du lien hypertexte dans la zone en haut de l'écran.

6.

Pour ajouter ou supprimer un paramètre, modifiez la syntaxe du lien hypertexte puis cliquez sur Analyser.

Remarque :

Vous ne pouvez ni ajouter ni supprimer de paramètre directement dans la liste des paramètres de la zone Paramètres d'URL . Vous devez modifier directement la syntaxe de l'URL.

7.

Cliquez sur la flèche en regard de Contenu de cellule pour modifier le texte affiché dans la cellule du lien hypertexte et choisissez l'une des options.

Option Description

Générer une formule

Vous générez une formule dans l'Editeur de formule pour que son résultat serve de contenu de cellule.

Sélectionner un objet

Vous choisissez l'objet dans la liste de la boîte de dialogue

"Sélectionner un objet" pour que sa valeur serve de contenu de cellule.

8.

Saisissez le texte de l'info-bulle dans la zone Info-bulle ou générez une info-bulle dynamique en utilisant les options Générer une formule ou

Sélectionner une variable.

Création de rapports à l'aide de l'Editeur de rapport Java 301

Utilisation des documents

24

Liaison vers d'autres documents

Option Description

Générer une formule

Vous générez une formule dans l'Editeur de formule pour que son résultat serve d'info-bulle.

Sélectionner un objet

Vous choisissez l'objet dans la liste de la boîte de dialogue

"Sélectionner un objet" pour que sa valeur serve d'info-bulle.

L'info-bulle s'affiche lorsque vous placez le curseur de la souris sur la cellule contenant le lien hypertexte.

9.

Cliquez sur la flèche en regard de Fenêtre cible pour définir l'affichage de l'URL cible.

Option

Fenêtre active

Nouvelle fenêtre

Description

L'URL cible remplace le document Web Intelligence contenant le lien hypertexte dans la fenêtre active.

L'URL cible s'ouvre dans une nouvelle fenêtre du navigateur.

Lien vers un autre document du CMS

Pour établir une liaison vers un autre document du CMS, utilisez la boîte de dialogue "Créer un lien hypertexte" (Web Intelligence Interactive uniquement).

Lorsque vous créez le lien, Web Intelligence génère une formule à l'aide de la fonction

OpenDocument

, à partir des choix effectués dans la boîte de dialogue.

Remarque :

Vous pouvez utiliser directement la fonction

OpenDocument en saisissant la syntaxe dans une cellule.

Reporting d'URL à l'aide d'openDocument

Le reporting d'URL à l'aide d'openDocument fournit un accès via URL à plusieurs types de document en transmettant une chaîne d'URL à un serveur

BusinessObjects Enterprise. openDocument fournit les commandes qui permettent de contrôler la création et l'affichage des rapports.

302 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Vous pouvez utiliser openDocument dans BusinessObjects Enterprise pour créer des liens inter-système vers et depuis les types de document suivants :

• .wid : documents Web Intelligence

• .rep : documents Desktop Intelligence

• .rpt : rapports Crystal

• .car : rapports OLAP Intelligence

Structuration d'une URL openDocument

Les sections suivantes expliquent comment utiliser la fonction openDocument et structurer l'URL.

Une URL openDocument est généralement structurée comme suit : http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?<parameter1>&<parameter2>&...&<parameterN>

La syntaxe exacte du paramètre

<platformSpecific> dépend de votre implémentation :

• Pour les implémentations Java, utilisez openDocument.jsp

à la place du paramètre

<platformSpecific>

.

• Pour les implémentations .NET, utilisez opendocument.aspx

à la place du paramètre

<platformSpecific>

.

L'URL est construite à l'aide des paramètres répertoriés dans

Présentation des paramètres openDocument

page 306

Paramètres de jointure

Paramètres de jointure avec une esperluette (&). Ne placez pas d'espace autour de l'esperluette. Par exemple : sType=wid&sDocName=Sales2003

L'esperluette est toujours requise entre les paramètres.

Espaces et caractères spéciaux dans les valeurs de paramètre

Etant donné que certains navigateurs ne peuvent pas interpréter les espaces, les paramètres du lien ne peuvent pas contenir d'espaces ou d'autres caractères spéciaux nécessitant un encodage d'URL. Pour éviter une interprétation incorrecte des caractères spéciaux, vous pouvez définir une chaîne URL encodée dans la base de données source pour remplacer le

Création de rapports à l'aide de l'Editeur de rapport Java 303

Utilisation des documents

24

Liaison vers d'autres documents

caractère spécial par une séquence d'échappement. Cela permettra à la base de données d'ignorer le caractère spécial et d'interpréter correctement la valeur de paramètre. Notez que certains RDBMS possèdent des fonctions qui vous permettent de remplacer un caractère spécial par un autre.

En créant une séquence d'échappement pour le signe plus (+), vous pouvez indiquer à la base de données d'interpréter le signe plus en tant qu'espace.

Dans ce cas, un titre de document Rapport des ventes pour 2003 serait spécifié dans le paramètre DocName comme suit :

&sDocName=Rap port+des+ventes+pour+2003&

Cette syntaxe empêche la base de données d'interpréter incorrectement les espaces dans le titre.

Espaces à la fin des valeurs de paramètre

Supprimez les espaces à la fin des valeurs de paramètre et des noms d'invite.

Ne les remplacez pas par le signe plus (+). Le visualiseur ne sait peut-être pas interpréter le signe plus (+) comme partie du nom d'invite ou comme un espace. Par exemple, si le nom d'invite affiche :

Select a City:_

(où _ représente un espace), saisissez le texte suivant dans le lien : lsSSelect+a+City:=Paris où les espaces dans le nom d'invite sont remplacés par le signe plus, et l'espace à la fin est supprimé.

Pour en savoir plus sur les paramètres d'invite du lien, voir

Présentation des paramètres openDocument

page 306 .

Majuscules

Tous les paramètres openDocument respectent la casse.

Limite de longueur du lien

L'URL encodée ne peut pas comporter plus de 2 083 caractères.

304 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Valeurs de paramètre dans les liens aux sous-rapports

Vous ne pouvez pas transmettre de valeurs de paramètre à un sous-rapport d'un rapport Crystal cible.

Utilisation du paramètre lsS avec les rapports OLAP Intelligence

Si le document cible est un rapport OLAP Intelligence (.car), vous pouvez utiliser le paramètre IsS pour spécifier des invites. Les paramètres sont transmis en tant que chaîne URL encodée utilisant le nom unique du paramètre défini dans le rapport OLAP Intelligence.

Exemple : Ouverture d'un rapport à une page spécifique

Si

23CAA3C1-8DBB-4CF3-BA%2CB8%2CD7%2CF0%2C68%2CEF%2C9C%2C6F est le nom unique d'URL pour le paramètre de page dans le rapport OLAP

Intelligence, utilisez l'URL suivante pour ouvrir le rapport OLAP Intelligence

à la page 2 : http://<servername>:<port>/OpenDocument/<platform

Specific>?sType=car&sIDType=InfoObject&iDocID=440&lsS23CAA3C1-

8DBB-4CF3-BA%2CB8%2CD7%2CF0%2C68%2CEF%2C9C%2C6F=2

Exemple : Ouverture d'un paramètre de cube

Si

8401682C-9B1D-4850-8B%2C5E%2CD9%2C1F%2C20%2CF8%2C1%2C62 est le nom unique d'URL pour le paramètre de type cube ouvrant le cube d'entrepôt dans le catalogue FoodMart 2000 sur MSAS, utilisez l'URL suivante pour ouvrir ce paramètre : http://<servername>:<port>/OpenDocument/<platform

Specific>?sType=car&sIDType=InfoObject&lsS8401682C-9B1D-4850-

8B%2C5E%2CD9%2C1F%2C20%2CF8%2C1%2C62=CATALOG%3DFood

Mart%202000,CUBE%3Dwarehouse&iDocID=616

Utilisation du paramètre lsM avec les rapports OLAP Intelligence

Si le document cible est un rapport OLAP Intelligence (.car), vous pouvez utiliser le paramètre IsM pour spécifier des invites. Les paramètres sont transmis en tant que chaîne URL encodée utilisant le nom unique du paramètre défini dans le rapport OLAP Intelligence.

Création de rapports à l'aide de l'Editeur de rapport Java 305

Utilisation des documents

24

Liaison vers d'autres documents

Comme c'était le cas pour le paramètre lsS, les paramètres lsM sont

également transmis en tant que chaîne URL encodée à l'aide du nom unique du paramètre défini dans le rapport OLAP Intelligence.

Exemple : Ouverture d'un rapport

http://<servername>:<port>/OpenDocument/<platform

Specific>?sType=car&sIDType=InfoObject&lsMADC216EA-D9A5-42B5-

AE%2C21%2C84%2CA9%2CF9%2C6E%2C31%2C7=[%5BCustomers%5D.%5BCoun try%5D.%26%5BMexico%5D],[%5BCustomers%5D.%5BCoun try%5D.%26%5BCanada%5D]&iDocID=544

Il s'agit d'un paramètre de type memberset qui ouvre un rapport comportant

Clients > Pays > Mexique et Clients > Pays > Canada dans la vue.

Présentation des paramètres openDocument

Cette section fournit une brève description d'openDocument et inclut une liste des paramètres disponibles. Des détails sur les paramètres disponibles, leurs utilisations spécifiques et des exemples pertinents sont également fournis.

Remarque :

Le document contenant le lien openDocument est appelé le document parent et il réside sur le système parent. Le document vers lequel le lien pointe est appelé le document cible et il réside sur le système cible.

Tableau 24-2 : Paramètres de plateforme

Paramètre

iDocID

page 310

Description

Identificateur du document.

sDocName

page 310

sIDType

page 311

Nom du document.

Type d'objet Crystal.

306 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Paramètre

sKind

sPath sType

token

page 311 page 312 page 312 page 313

Description

Type de fichier du document Desktop Intelligence cible.

Noms du dossier et du sous-dossier contenant le document cible.

Type de fichier du rapport ou document cible.

Jeton de connexion valide pour la session

CMS en cours.

Tableau 24-3 : Paramètres d'entrée

Paramètre Description

lsC

page 314

lsM[NAME]

lsR[NAME]

lsS[NAME]

page 315 page 316 page 317

Définit une invite contextuelle s'il y a une ambiguïté au cours de la génération du SQL

(documents Business Objects et Web Intelligence uniquement).

Définit plusieurs valeurs pour une invite.

[NOM] est le texte de l'invite.

Définit une plage de valeurs pour une invite.

[NOM] est le texte de l'invite.

Définit une valeur pour une invite unique.

[NOM] est le texte de l'invite.

Création de rapports à l'aide de l'Editeur de rapport Java 307

Utilisation des documents

24

Liaison vers d'autres documents

Paramètre Description

sInstance

page 318

sPartContext

page 318

Indique l'instance spécifique du rapport cible

à ouvrir.

Dans Crystal Reports, une partie de rapport est associée à un contexte de données.

sRefresh

page 319

Indique si l'actualisation doit être forcée à l'ouverture du rapport ou du document cible.

sReportMode

page 320

Pour les cibles Crystal uniquement, indique si le lien doit ouvrir le rapport cible intégral ou uniquement la partie de rapport indiquée dans sReportPart

.

sReportName

page 320

Indique le rapport à ouvrir si le document cible contient plusieurs rapports.

sReportPart

page 321

Indique la partie spécifique du rapport cible

à ouvrir.

Tableau 24-4 : Paramètres de sortie

Paramètre Description

NAII

page 322

Force l'affichage de la page de sélection d'invite.

308 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Paramètre Description

sOutputFormat

page 323

Indique le format d'ouverture du document cible.

sViewer

sWindow

page 323 page 324

Indique le visualiseur de rapport sélectionné

(CR et CA uniquement).

Indique si le rapport cible doit être ouvert dans la fenêtre de navigateur active ou si une nouvelle fenêtre doit être ouverte.

Paramètres de plateforme openDocument

Cette section décrit les paramètres de plateforme openDocument disponibles et propose des exemples d'utilisation des commandes.

Une URL openDocument est généralement structurée comme suit : http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?<parameter1>&<parameter2>&...&<parameterN>

La syntaxe exacte du paramètre

<platformSpecific> dépend de votre implémentation :

• Pour les implémentations Java, utilisez openDocument.jsp

à la place du paramètre

<platformSpecific>

.

• Pour les implémentations .NET, utilisez opendocument.aspx

à la place du paramètre

<platformSpecific>

.

Remarque :

Les variables sont indiquées entre chevrons. Vous devez les remplacer par la valeur de ces variables. Par exemple, vous devez utiliser le nom du serveur

à la place de

<servername> lorsqu'il figure dans les exemples de code ci-dessous et vous devez utiliser le numéro de port à la place de

<port>

.

Création de rapports à l'aide de l'Editeur de rapport Java 309

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

iDocID

iDocID

Description

Identificateur du document.

Obligatoire ?

Valeurs

Oui*

Identificateur du document (InfoObjectID).

Remarque :

* sDocName ou iDocID est obligatoire.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010

Remarque :

Pour obtenir l'ID du document, accédez au document dans la CMC. La page des propriétés du document contient l'ID du document et le CUID.

Utilisez cette valeur pour le paramètre iDocID

.

Syntaxe

sDocName

Description

sDocName

Obligatoire ?

Valeurs

Nom de document sans extension

Si plusieurs documents portent le même nom, utilisez iDocID pour spécifier celui qui convient.

Oui* Nom du document.

Remarque :

* sDocName ou iDocID est obligatoire.

310 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Syntaxe

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+200

sIDType

Description Obligatoire ?

Valeurs

sIDType

Type d'identificateur d'objet du CMS (Central

Management Server).

Oui*

•

CUID

•

GUID

•

RUID

•

ParentID

•

InfoObjectID

(par défaut)

Syntaxe

Remarque :

*Obligatoire si la cible est un rapport Crystal ou un rapport OLAP Intelligence

( sType=rpt ou sType=car

) dans un lot d'objets. Sinon, utilisez sPath et sDocName

.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?iDocID=2010&sIDType=CUID

sKind

Description Obligatoire ?

Valeurs

sKind

Type de fichier du document Desktop Intelligence cible.

Oui*

•

FullClient

Création de rapports à l'aide de l'Editeur de rapport Java 311

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

Remarque :

*Obligatoire uniquement si la cible est un document Desktop Intelligence.

Sinon, utilisez sType

.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sKind=FullClient

sPath

Description Obligatoire ?

Valeurs

sPath

Noms du dossier et du sous-dossier contenant le document cible.

Oui*

Dossier et/ou sous-dossier :

[folder],[subfolder]

Syntaxe

sType

Remarque :

*Obligatoire uniquement si une valeur est spécifiée pour sDocName et qu'elle n'est pas unique.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2005

sType

Description

Type de fichier du rapport ou document cible.

Obligatoire ?

Valeurs

Oui

• wid

• rpt

• car

312 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Syntaxe

Remarque :

Ce paramètre est ignoré lorsque le document est agnostique.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid

token

Description Obligatoire ?

Valeurs

token

Jeton de connexion valide pour la session

CMS en cours.

Non

Jeton de connexion pour la session CMS en cours.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=Sales+in+2003&token=<logonToken>

Paramètres d'entrée openDocument

Cette section décrit les paramètres d'entrée openDocument disponibles et propose des exemples d'utilisation des commandes.

Une URL openDocument est généralement structurée comme suit : http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?<parameter1>&<parameter2>&...&<parameterN>

La syntaxe exacte du paramètre

<platformSpecific> dépend de votre implémentation :

• Pour les implémentations Java, utilisez openDocument.jsp

à la place du paramètre

<platformSpecific>

.

• Pour les implémentations .NET, utilisez opendocument.aspx

à la place du paramètre

<platformSpecific>

.

Création de rapports à l'aide de l'Editeur de rapport Java 313

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

Remarque :

Les variables sont indiquées entre chevrons. Vous devez les remplacer par la valeur de ces variables. Par exemple, vous devez utiliser le nom du serveur

à la place de

<servername> lorsqu'il figure dans les exemples de code ci-dessous et vous devez utiliser le numéro de port à la place de

<port>

.

lsC

Description Obligatoire ?

Valeurs

lsC

Définit une invite contextuelle s'il y a une ambiguïté au cours de la génération du SQL

(documents Business

Objects et Web Intelligence uniquement).

Non

Remarque :

Non pris en charge par

OLAP Intelligence

Une valeur d'invite qui résout l'ambiguïté dans la génération SQL.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010&lsC=Sales

314 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Syntaxe

lsM[NAME]

Description

lsM[NAME]

Spécifie plusieurs valeurs pour une invite.

[NOM] est le texte de l'invite.

Obligatoire ?

Valeurs

Non

• Plusieurs valeurs d'invite, séparées par une virgule. Si la cible est un rapport Crystal, chaque valeur doit

être placée entre crochets. Si la cible est un rapport OLAP

Intelligence, utilisez la clause MDX WITH

(voir

Utilisation du paramètre lsS avec les rapports OLAP Intelligence

page 305 et

Utilisation du paramètre lsM avec les rapports OLAP Intelligence

page 305).

• no_value

(uniquement pour les paramètres facultatifs)

Remarque :

Vous pouvez supprimer un paramètre facultatif de l'invite en le définissant sur no_value dans la chaîne de requête openDocument. Si vous ne renseignez pas un paramètre facultatif de la chaîne de requête openDocument, une valeur de paramètre par défaut sera appliquée.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=rpt&sDocName=SalesReport&lsM

Select+Cities=[Paris],[London]

Création de rapports à l'aide de l'Editeur de rapport Java 315

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

lsR[NAME]

Description

lsR[NAME]

Définit une plage de valeurs pour une invite.

[NOM] est le texte de l'invite.

Non

Remarque :

Non pris en charge par

OLAP Intelligence

Obligatoire ?

Valeurs

• Une plage de valeurs pour l'invite, séparées par deux points (..). Si la cible est un rapport

Crystal, la plage doit

être placée entre crochets et/ou parenthèses (utilisez un crochet à côté d'une valeur pour l'inclure dans la plage, et des parenthèses pour l'exclure).

• no_value

(uniquement pour les paramètres facultatifs)

Remarque :

Vous pouvez supprimer un paramètre facultatif de l'invite en le définissant sur no_value dans la chaîne de requête openDocument. Si vous ne renseignez pas un paramètre facultatif de la chaîne de requête openDocument, une valeur de paramètre par défaut sera appliquée.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=rpt&sDocName=SalesReport&lsRTime+Per iod:=[2000..2004)

316 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Syntaxe

lsS[NAME]

Description

lsS[NAME]

Définit une valeur pour une invite unique.

[NOM] est le texte de l'invite.

Obligatoire ?

Valeurs

Non

• Une seule valeur d'invite (voir

Utilisation du paramètre lsS avec les rapports OLAP Intelligence

page 305 et

Utilisation du paramètre lsM avec les rapports OLAP Intelligence

page 305).

• no_value

(uniquement pour les paramètres facultatifs)

Remarque :

Vous pouvez supprimer un paramètre facultatif de l'invite en le définissant sur no_value dans la chaîne de requête openDocument. Si vous ne renseignez pas un paramètre facultatif de la chaîne de requête openDocument, une valeur de paramètre par défaut sera appliquée.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010&lsS

Select+a+City=Paris

Création de rapports à l'aide de l'Editeur de rapport Java 317

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

sInstance

Description

sInstance

Indique l'instance spécifique du rapport cible à ouvrir.

Obligatoire ?

Valeurs

Non

•

Utilisateur

(lien vers l'instance la plus récente de l'utilisateur actuel)

•

Dernier

(lien vers l'instance la plus récente du rapport))

•

Paramètre

(lien vers l'instance la plus récente du rapport avec les valeurs de paramètre correspondantes)

Remarque :

Utilisez ce paramètre conjointement avec sDocName

.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2003&sReport

Part=Part1&sInstance=User

Syntaxe

sPartContext

Description Obligatoire ?

Valeurs

sPartContext

Dans Crystal Reports, une partie de rapport est associée à un contexte de données.

Oui*

Contexte des données de la partie du rapport.

318 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Remarque :

*Obligatoire uniquement si une valeur est spécifiée pour sReportPart

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2005&sReport

Part=Part1&sPartContext=0-4-0

Syntaxe

sRefresh

Remarque :

Les paramètres sReportPart et sPartContext sont pris en charge par le visualiseur DHTML standard ( sViewer=html

). Le visualiseur DHTML n'affiche pas la première page du rapport, mais la page et le contexte dans lesquels se trouve la partie mise en surbrillance.

sRefresh

Description

Indique si l'actualisation doit être forcée à l'ouverture du rapport ou du document cible.

Obligatoire ?

Valeurs

Non

•

O

(force l'actualisation du document)

•

N

(notez que l'actualisation d'une fonctionnalité ouverte remplace cette valeur)

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010&sRefresh=Y

Création de rapports à l'aide de l'Editeur de rapport Java 319

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

sReportMode

Description

sReportMode

Obligatoire ?

Valeurs

Pour les cibles Crystal uniquement, indique si le lien doit ouvrir le rapport cible intégral ou uniquement la partie de rapport indiquée dans sReportPart

.

Non

•

Complet

•

Partie

Remarque :

Si ce paramètre n'est pas défini, la valeur par défaut est

Complet

. S'applique uniquement si une valeur est spécifiée pour sReportPart

.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2003&sReport

Part=Part1&sReportMode=Part

Syntaxe

sReportName

Description Obligatoire ?

Valeurs

sReportName

Indique le rapport à ouvrir si le document cible contient plusieurs rapports.

Non

Nom du rapport pour les documents Web Intelligence, sous-rapport pour Crystal Reports, pages pour les rapports

OLAP Intelligence.

Remarque :

Le premier rapport est utilisé par défaut si ce paramètre n'est pas défini.

320 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=Sales+in+2003&sReportName=Fir st+Report+Tab

Syntaxe

sReportPart

Description Obligatoire ?

Valeurs

sReportPart

Indique la partie spécifique du rapport cible à ouvrir.

Non

Nom de la partie du rapport.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2003&sReport

Part=Part1

Remarque :

Les paramètres sReportPart et sPartContext sont pris en charge par le visualiseur DHTML standard ( sViewer=html

). Le visualiseur DHTML n'affiche pas la première page du rapport, mais la page et le contexte dans lesquels se trouve la partie mise en surbrillance.

Paramètres de sortie openDocument

Cette section décrit les paramètres de sortie openDocument disponibles et propose des exemples d'utilisation des commandes.

Une URL openDocument est généralement structurée comme suit : http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?<parameter1>&<parameter2>&...&<parameterN>

La syntaxe exacte du paramètre

<platformSpecific> dépend de votre implémentation :

• Pour les implémentations Java, utilisez openDocument.jsp

à la place du paramètre

<platformSpecific>

.

Création de rapports à l'aide de l'Editeur de rapport Java 321

Utilisation des documents

24

Liaison vers d'autres documents

Syntaxe

NAII

• Pour les implémentations .NET, utilisez opendocument.aspx

à la place du paramètre

<platformSpecific>

.

Remarque :

Les variables sont indiquées entre chevrons. Vous devez les remplacer par la valeur de ces variables. Par exemple, vous devez utiliser le nom du serveur

à la place de

<servername> lorsqu'il figure dans les exemples de code ci-dessous et vous devez utiliser le numéro de port à la place de

<port>

.

NAII

Description

Force l'affichage de la page de sélection d'invite.

Remarque :

Pris en charge par les documents Web Intelligence uniquement.

Non

Obligatoire ?

Valeurs

•

•

O (toutes les invites dont les valeurs sont transmises avec lsS

, lsM ou lsR sont présélectionnées)

N (affiche uniquement les invites dont les valeurs sont transmises avec lsS

, lsM ou lsR

)

Exemple :

http:/<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010&NAII=Y

322 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

Syntaxe

sOutputFormat

Description

sOutputFormat

Indique le format d'ouverture du document cible.

Obligatoire ?

Valeurs

Non

•

H

(HTML)

•

P

(PDF)

•

E

(Excel)

•

W

(Word)

Syntaxe

Remarque :

HTML est utilisé par défaut si ce paramètre n'est pas défini.

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDocName=Sales+in+2003&sOut putFormat=E

sViewer

Description Obligatoire ?

Valeurs

sViewer

Indique le visualiseur utilisé pour visualiser le document.

Non

• html

• part

(rapports Crystal uniquement)

• actx

(rapports Crystal uniquement)

• java

(rapports Crystal uniquement)

Création de rapports à l'aide de l'Editeur de rapport Java 323

Utilisation des documents

24

Liaison vers d'autres documents

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDoc

Name=Sales+in+2003&sViewer=html

Exemple :

Remarque :

Afin d'utiliser les paramètres dans l'URL avec le visualiseur ActiveX,

:connect doit être ajouté à l'URL, suivi des paramètres.

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sPath=[Sales+Reports]&sDoc

Name=Sales+in+2003&sViewer=actx:connect&IsMCoun try=[Thailand],[Norway]

Syntaxe

sWindow

sWindow

Description

Indique si le rapport cible doit être ouvert dans la fenêtre de navigateur active ou si une nouvelle fenêtre doit être ouverte.

Obligatoire ?

Valeurs

Non

•

Même

(fenêtre du navigateur actuel)

•

Nouvelle

(une nouvelle fenêtre du navigateur est lancée)

Exemple :

http://<servername>:<port>/OpenDocument/opendoc/<platform

Specific>?sType=wid&sDocName=SalesReport&iDocID=2010&sWin dow=New

Liaison contextuelle de rapports

La fonction openDocument vous permet de créer des liens contextuels entre des rapports Crystal, des rapports OLAP Intelligence et des documents Web

Intelligence. Pour ce faire, vous devez construire une URL à l'aide de la

324 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24 syntaxe openDocument, puis insérer cette URL dans un rapport Crystal, un rapport OLAP Intelligence ou un document Web Intelligence.

La liaison contextuelle de rapports permet aux concepteurs de rapports de définir des associations entre des documents résidant dans un environnement

Crystal Reports (non géré) ou dans un environnement BusinessObjects

Enterprise (géré). Une fois ces associations créées, les utilisateurs suivent les chemins de navigation obtenus intégrés dans les documents liés.

Cette fonction permet d'appeler des documents Business Objects et Web

Intelligence depuis Crystal Reports et inversement. Elle se fonde sur une fonctionnalité qui permet à l'utilisateur d'effectuer les opérations suivantes :

• Liaison de documents Web Intelligence ou Business Objects dans le domaine document

• Liaison d'objets rapport dans Crystal Reports

Cliquez sur un des liens ci-dessous pour atteindre la section qui vous intéresse :

•

Pour insérer un lien dans un rapport Crystal

page 325

•

Pour créer un lien vers un autre rapport ou document à partir d'un rapport

OLAP Intelligence

page 326

•

Création de liens dans les documents Web Intelligence

page 327

Pour insérer un lien dans un rapport Crystal

Vous pouvez utiliser openDocument pour créer des liens hypertexte dans

Crystal Reports. Pour créer un lien vers un autre rapport ou document, utilisez l'onglet Lien hypertexte de l'Editeur de mise en forme.

1.

Ouvrez le rapport source dans Crystal Reports.

2.

Cliquez avec le bouton droit de la souris sur le champ dans lequel vous voulez insérer le lien openDocument et sélectionnez Mettre en forme dans le menu contextuel.

3.

Dans l'Editeur de mise en forme, sélectionnez l'onglet Lien hypertexte.

4.

Sélectionnez Un site Web sur Internet.

5.

Dans la zone "Informations sur le lien hypertexte", laissez le champ

Adresse du site Web vide, puis cliquez sur le bouton Editeur de formule

de mise en forme.

Création de rapports à l'aide de l'Editeur de rapport Java 325

Utilisation des documents

24

Liaison vers d'autres documents

6.

Saisissez le lien openDocument au format suivant :

"http://[openDocument parameters]"+{Ar ticle_lookup.Family_name} où [paramètres openDocument] sont décrits à la section

Présentation des paramètres openDocument

page 306 et {Article_lookup.Family_name} permet au rapport de transmettre des données dépendant du contexte.

Remarque :

Testez votre lien dans une fenêtre de navigateur avant de l'insérer dans un rapport ou un document.

7.

Cliquez sur Enregistrer et fermer pour quitter l'Atelier de formules.

8.

Cliquez sur OK dans l'Editeur de formule pour enregistrer le lien.

Pour créer un lien vers un autre rapport ou document à partir d'un rapport

OLAP Intelligence

Vous pouvez utiliser openDocument pour créer des liens hypertexte dans des rapports OLAP Intelligence.

1.

Ouvrez le rapport source dans le concepteur OLAP Intelligence.

2.

Dans le menu Outils, sélectionnez Gestionnaire d'actions.

3.

Cliquez sur Nouveau pour créer une action.

4.

Saisissez le nom de l'action.

5.

Sélectionnez la zone dans laquelle l'action (le lien) s'appliquera.

6.

Saisissez le lien openDocument en utilisant les paramètres et la syntaxe décrits dans le présent document.

Conseil :

Testez votre lien dans une fenêtre de navigateur avant de l'insérer dans un rapport ou un document.

7.

Cliquez sur OK pour enregistrer le lien.

8.

Fermez la boîte de dialogue Gestionnaire d'actions.

9.

Créez un bouton Analyse dans le rapport source.

10.

Cliquez avec le bouton droit de la souris sur ce bouton Analyse.

11.

Dans le menu déroulant, sélectionnez Propriétés, puis Modifier.

12.

Sélectionnez Lancer une action.

13.

Sélectionnez l'action qui correspond au lien openDocument créé aux

étapes 3 à 6.

326 Création de rapports à l'aide de l'Editeur de rapport Java

Utilisation des documents

Liaison vers d'autres documents

24

14.

Cliquez sur OK.

Création de liens dans les documents Web Intelligence

Vous pouvez définir dans un univers des objets qui permettent aux utilisateurs de Web Intelligence et BusinessObjects de créer des rapports dont les valeurs renvoyées comprennent des liens vers d'autres rapports et documents.

Lorsque ces rapports sont exportés vers le référentiel, les utilisateurs peuvent cliquer sur les valeurs renvoyées affichées sous forme de liens hypertexte pour ouvrir un autre document associé stocké dans le domaine document du référentiel. Vous créez ces liens en utilisant la fonction openDocument dans la définition d'un objet dans Designer.

Informations supplémentaires

Pour en savoir plus sur la création de liens dans les rapports Web

Intelligence, voir le guide Création de rapports à l'aide de l'Editeur de rapport

Java Web Intelligence.

Vous activez la liaison de rapports dans un univers en créant un objet (l'objet de liaison) dont les valeurs renvoyées sont identiques aux valeurs utilisées en entrée pour une invite dans un rapport existant (le rapport cible).

La fonction openDocument permet de renvoyer les valeurs de l'objet de liaison sous forme de liens hypertexte. Lorsque l'utilisateur clique sur le lien hypertexte, sa valeur est utilisée comme entrée d'invite dans le rapport cible.

Vous pouvez créer des documents avec l'objet de liaison comme avec n'importe quel autre objet. Les utilisateurs peuvent ensuite cliquer sur les liens hypertexte pour accéder à des documents plus détaillés associés à l'objet de liaison.

Pour créer un objet de liaison, utilisez la fonction openDocument dans l'instruction Select de l'objet. L'instruction Select d'un objet de liaison suit cet ordre :

'<a href="http://<servername>:<port>/OpenDocument/<platform

Specific>?sDocName=<document name>&sType=<document type>&iDocID=<document id>&lsS<prompt message>='+object

SELECT+'">'+object SELECT+'</a>'

L'opérateur de concaténation (+) s'applique aux bases de données Microsoft

Access. Utilisez l'opérateur approprié pour votre SGBDR cible.

Création de rapports à l'aide de l'Editeur de rapport Java 327