Les liens vers les pages de tableau de bord permettent aux autres utilisateurs d'accéder facilement aux données.
Vous pouvez créer des liens vers des pages de tableau de bord si votre entreprise vous y autorise. Vous pouvez ainsi, par exemple, enregistrer un lien en tant que signet ou envoyer un lien à d'autres utilisateurs dans un message électronique.
Vous pouvez créer deux types de liens : les liens de type signet et les liens avec invite. Les sections suivantes décrivent ces liens :
Pour plus d'informations sur la création de liens vers les pages de tableau de bord, reportez-vous à Création de liens vers des pages de tableau de bord.
Vous pouvez créer un lien vers une page de tableau de bord et ses états.
Un lien de type signet est une URL qui capture le chemin d'accès à une page de tableau de bord et à tous les aspects de l'état de cette page, par exemple :
http://localhost/10.1.3.2/saw.dll?Dashboard&_scid=7ndOC-SjmWo&PortalPath=%2Fusers%2Fadministrator%2F_portal&Page=p2&PageIdentifier=7fsg0r2sdssvgen4&BookmarkState=r78an1mbj0fj4lmqhdjfndvvai
Après avoir créé un lien de type signet, vous pouvez :
enregistrer le lien en tant que signet, de façon à revenir précisément au même contenu de page ultérieurement ;
copier le lien et l'envoyer à d'autres utilisateurs, qui peuvent afficher le contenu exact que vous visualisez, à condition qu'ils disposent des mêmes autorisations que vous et qu'ils aient accès à la page.
Lorsque vous créez un lien de type signet, l'état de la page de tableau de bord est enregistré dans le catalogue sous la forme d'un objet signet masqué sur une durée définie par votre entreprise. La valeur par défaut est de 30 jours. Adressez-vous à l'administrateur pour connaître la durée spécifiée par votre entreprise. Comme l'état de la page est enregistré lorsque vous créez un lien de type signet, vous pouvez continuer à en modifier le contenu après la création du lien.
Les liens avec invite renvoient vers des présentations de tableau de bord simplifiées.
Un lien avec invite capture le chemin d'accès à une page de tableau de bord et à une présentation simplifiée des invites de tableau de bord, par exemple :
<Content Path>&Action=Navigate&col1="Products"."P1 Product"&val1="Bluetooth Adaptor"&psa1="A - Sample Sales"
Lorsque vous créez un lien avec invite, vous pouvez le manipuler manuellement ou par le biais d'un programme, par exemple en ajoutant des valeurs différentes aux invites. Avec un lien avec invite, vous ne pouvez pas capturer tous les aspects de l'état de la page comme avec un lien de type signet. Cela est dû au fait que vous ne pouvez pas répliquer l'état exact des paramètres sans invite.
Une URL qui capture le chemin vers une page de tableau de bord et une présentation simplifiée des invites de tableau de bord peut également être construite manuellement plutôt que d'être créée par un lien avec invite. Pour plus d'informations, reportez-vous à Integrator's Guide for Oracle Business Intelligence Enterprise Edition..
Pour plus d'informations sur la manipulation des liens avec invite, reportez-vous aux rubriques suivantes :
Les liens avec invite doivent respecter les règles de syntaxe de base, tel que décrit ci-dessous.
La syntaxe de base d'un lien avec invite est la suivante :
<Chemin du contenu>&Action=Navigate&col1&op1&val1&col2&op2&val2&var3&op3&val3…
où le chemin du contenu est l'une de ces URL de base :
http://<obiee url path>/saw.dll?Dashboard&PortalPath=<dashboard path> http://<obiee url path>/saw.dll?Dashboard&PortalPath=<dashboard path>&Page=<page name> http://<obiee url path>/saw.dll?PortalGo&path=<analysis or prompt path> http://<obiee url path>/saw.dll?Go&path=<analysis or prompt path>
Vous pouvez modifier les liens avec invite à l'aide de paramètres.
Les paramètres que vous pouvez utiliser pour modifier les liens avec invite sont les suivants :
&Action= : spécifie l'action associée au lien avec invite. Les valeurs valides sont les suivantes :
Naviguer : accède à la page de tableau de bord.
Imprimer : formate les résultats pour impression au format PDF, sans contrôle de pagination, lien actif, etc.
Télécharger : télécharge les résultats vers Microsoft Excel.
Vous ne pouvez pas utiliser les options Imprimer et Télécharger si l'argument viewState existe. Pour plus d'informations, reportez-vous à Integrator's Guide for Oracle Business Intelligence Enterprise Edition.
&col#= : identifie la colonne utilisée dans une invite de colonne.
Exemple :
&col1="EASTERN REGION"
&var#= : identifie la variable utilisée dans une invite de variable ou une variable définie par une invite de colonne.
La portée de toutes les variables est la page de tableau de bord par défaut, sauf si vous référencez la variable de façon explicite.
Exemple utilisant la portée par défaut contrôlée par le paramètre facultatif &P1= :
&var1="myRegion"
Exemple de définition explicite sur la portée du tableau de bord :
&var1=dashboard.variables['myRegion']
Exemple de définition explicite sur la portée de la page de tableau de bord :
&var1=dashboard.currentPage.variables['myRegion']
Si vous devez définir la portée du tableau de bord et de la page de tableau de bord, placez les deux variables dans l'URL.
Vous ne pouvez pas définir une variable de session avec ce paramètre. En revanche, vous pouvez remplacer une variable de session en définissant une variable de demande. Par exemple, vous pouvez remplacer NQ_SESSION.REGION_VAR en définissant la variable de demande suivante :
&var1=requestVariables['REGION_VAR']
Paramètres de valeur suivants :
&val#= : indique la valeur d'une invite.
Exemple :
&val1="EASTERN REGION"
&valgrp#= : définit la valeur d'une invite sur le chemin de catalogue d'un groupe personnalisé.
Exemple :
&valgrp1="/shared/folder/myCustomGroup"
&valsv#= : définit la valeur d'une invite sur une variable de serveur.
Exemple :
&valsv1="SALESREGION"
Les paramètres val# et valgrp# peuvent être présents ensemble, mais pas avec le paramètre valsv#. En d'autres termes, l'invite peut disposer de n'importe quelle combinaison de paramètres val# et valgrp#, mais ne peut pas disposer à la fois de valsv# et de val#.
&cov#= : définit la variable d'une invite de colonne qui définit également une variable.
Exemple :
&var1=myRegion&cov1="Markets"."Region"&val1="EASTERN.REGION"+"WESTERN REGION"
&op#= : (facultatif) indique l'opérateur, par exemple égal à (eq).
Utilisez les mêmes opérateurs qu'avec l'URL Exécuter. Pour obtenir la liste des opérateurs, reportez-vous à Navigation Parameters dans le manuel Integrator's Guide for Oracle Business Intelligence Enterprise Edition.
Exemple :
&col1="Markets"."Region"&val1="EASTERN REGION"+"WESTERN REGION"&op1=in
&psa#= : (facultatif) identifie le domaine principal d'une invite.
Utilisez ce paramètre si une invite exige que les types de données des valeurs soient correctement identifiés par domaine.
Exemple :
&var1=myRegion&cov1="Markets"."Region"&val1="EASTERN REGION"+"WESTERN REGION"&psa1=Paint
Si un lien avec invite inclut plusieurs domaines, spécifiez les invites qui n'identifient aucun domaine en premier (par exemple, &psa1="Products"."P1 Products") et celles qui en identifient un en dernier (par exemple, &psa2="B-Sample Target"."Products"."P1 Products").
&formulause#= : détermine si une valeur d'invite est une valeur de code ou une valeur d'affichage (dans un référentiel configuré pour la fonctionnalité à deux colonnes).
Si vous n'utilisez pas ce paramètre, le système considère que la valeur est une valeur d'affichage.
Exemple :
&var1=myRegion&cov1="Markets"."Region"&val1="2"+"3"&formulause1=code
Pour les invites utilisant des colonnes hiérarchiques :
&hierid#= : (obligatoire) identifie l'ID de hiérarchie.
&dimid#= : (obligatoire) identifie l'ID de dimension.
&tblnm#= : (obligatoire) identifie le nom de table.
Exemple :
&col1="Products"."Products Hierarchy"&hierid1=Products Hierarchy&dimid1=H1 Products&tblnm1="Products"&val1="*"+"all"&psa1="A - Sample Sales"
S'il existe plusieurs valeurs sur plusieurs niveaux, vous devez développer la syntaxe des valeurs. Pour connaître la procédure, reportez-vous à Développement de la syntaxe des valeurs.
&P1= : définit la portée de tous les paramètres de lien avec invite. Les valeurs valides sont les suivantes :
tableau de bord
dashboardPage (par défaut si la portée n'est pas fournie)
rapport
Ce paramètre affecte les filtres et les variables du lien avec invite.
Exemple :
&P1=dashboard
Les liens avec invite peuvent être modifiés de différentes manières.
Les instructions de manipulation des liens avec invite sont les suivantes :
Utilisez n'importe quelle combinaison de paramètres &col#= et &var#= et numérotez-les consécutivement de 1 à N. Par exemple, vous pouvez utiliser var1, col2, col3 ou col1, var2, col3.
Utilisez le signe plus (+) pour séparer les valeurs.
Utilisez les paramètres indépendants de l'environnement local suivants pour la date, l'heure et l'horodatage :
Pour le format de date :
YYYY-MM-DD
Pour le format d'heure :
hh24:mm:ss
Pour le format d'horodatage (fuseau horaire attendu : UTC) :
YYYY-MM-DD hh24:mm:ss
Veillez à encoder l'URL correctement. Tous les navigateurs ou plates-formes n'autorisent pas les URL sans échappement. Par exemple, encodez un guillemet (") avec %22, un caractère non imprimable avec %20, etc.
La longueur en caractères prise en charge pour les URL varie en fonction des navigateurs. Si une URL est plus longue que la longueur prise en charge, elle est tronquée. La solution de contournement consiste à utiliser un lien de type signet ou un autre navigateur qui prend en charge une longueur plus importante.
Vous pouvez omettre les guillemets s'il n'existe aucun espace au sein des valeurs.
Astuce :
Pour construire rapidement et correctement une URL manuelle, accédez à une page de tableau de bord avec les invites correspondantes, appliquez les valeurs d'invite voulues, créez un lien avec invite pour générer l'URL avec invite, puis utilisez l'URL en tant que modèle.