Modifications pour le document Paramètres des URL pour l'intégration Web

Modifié par Aurelie Bertrand le 2025/03/14 15:45

Depuis la version 1.1
modifié par jhurst
sur 2020/07/21 11:35
Commentaire de modification : Imported from XAR
À la version 10.1
modifié par Aurelie Bertrand
sur 2025/03/14 15:45
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Auteur du document
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.jhurst
1 +xwiki:XWiki.aureliebertranddigdashbiz
Tags
... ... @@ -1,0 +1,1 @@
1 +Tableau de bord|Flux|Filtre
Contenu
... ... @@ -2,6 +2,11 @@
2 2  
3 3  ----
4 4  
5 +(% class="box infomessage" %)
6 +(((
7 +**Prérequis : **Les propositions d'intégration d'objets DigDash (tableaux de bord, pages, flux, etc.) dans des iframe nécessitent de mettre en place ces balises iframe au sein de pages HTML, elles-mêmes distribuées par un serveur Web.
8 +)))
9 +
5 5  (% class="wikigeneratedid" id="HIntroduction" %)
6 6  Dans ce document, nous présentons des URLs fonctionnant dans le contexte suivant :
7 7  
... ... @@ -21,11 +21,14 @@
21 21  * **user**=<user> Utilisateur à authentifier
22 22  * **pass**=<password> Mot de passe pour l’utilisateur
23 23  * **domain**=<domainname> Nom du domaine DigDash Enterprise (Exemple : ddenterpriseapi)
24 -* **server**=<server URL> URL du domaine DigDash Enterprise (Exemple : http:~/~/localhost:8080)
29 +* **server**=<server URL> URL du domaine DigDash Enterprise (Exemple : [[http:~~/~~/localhost:8080)>>http://localhost:8080)]]
30 +* **defaultPage**=<pageId> Identifiant de la page que l'utilisateur souhaite afficher par défaut à la place de la première page (voir note ci-dessous pour plus de détails)
25 25  * **hideBanner**=<true|false> Cache (true) ou montre (false) la barre de titre
26 26  * **hideFilters**=<true|false> Cache (true) ou montre (false) la barre de filtres
33 +* **hideNavigationMenu**=<true|false> => Active (true) ou désactive (false) le menu de navigation (Vertical ou Onglets).
34 +* **useHistory**=<true|false> Désactive (false) l'historique de navigation. Le menu de navigation dans l'historique en haut à droite n'est plus visible.
27 27  * <nomVariable>=<valeurVariable> Spécifie la valeur de la variable nomVariable
28 -* <filterselection> Voir le paragraphe V ci-dessous
36 +* <filterselection> Voir le paragraphe Filtres ci-dessous
29 29  
30 30  Exemple :
31 31  
... ... @@ -36,9 +36,17 @@
36 36  
37 37  (% class="box infomessage" %)
38 38  (((
39 -Note : Vous pouvez aussi utiliser un mécanisme d'authentification server-side pour éviter les paramètres user/pass dans l'URL. Consulter le document [[Anonymisation des Urls>>doc:Digdash.customization.anonymisation_url.WebHome]]
47 +**Identifiant de la page (pageId)**
48 +Cet identifiant est visible dans l'Éditeur de tableau de bord dans le menu contextuel de la page (affiché via un clic droit sur le titre de l'onglet de la page).
49 +Deux identifiants sont affichés, l'un est unique et non modifiable (uid), l'autre est "calculé" en fonction du nom du rôle et de la page (ces 2 éléments étant modifiables, l'identifiant peut donc changer et le paramètre ne plus être efficace).
50 +Les 2 identifiants sont utilisables par l'utilisateur pour ce paramètre.
40 40  )))
41 41  
53 +(% class="box infomessage" %)
54 +(((
55 +**Note** : Vous pouvez aussi utiliser un mécanisme d'authentification server-side pour éviter les paramètres user/pass dans l'URL. Consulter le document [[Anonymisation des Urls>>doc:Digdash.customization.anonymisation_url.WebHome]].
56 +)))
57 +
42 42  = Pages de tableaux de bord =
43 43  
44 44  Vous pouvez intégrer une page ou toutes les pages d’un tableau de bord d’un rôle ou d’un utilisateur dans une iframe.
... ... @@ -57,7 +57,7 @@
57 57  * **hideBanner**=<true|false> Cache (true) ou montre (false) la barre de titre
58 58  * **hideFilters**=<true|false> Cache (true) ou montre (false) la barre de filtres
59 59  * <nomVariable>=<valeurVariable> Spécifie la valeur de la variable nomVariable
60 -* <filterselection> Voir le paragraphe V ci-dessous
76 +* <filterselection> Voir le paragraphe  Filtres ci-dessous
61 61  
62 62  Exemple :
63 63  
... ... @@ -71,7 +71,7 @@
71 71  Note : Vous pouvez aussi utiliser un mécanisme d'authentification server-side pour éviter les paramètres user/pass dans l'URL. Consulter le document [[Anonymisation des Urls>>doc:Digdash.customization.anonymisation_url.WebHome]]
72 72  )))
73 73  
74 -= Flux d’information =
90 += {{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} d’information =
75 75  
76 76  Vous pouvez intégrer un flux d’information (composant graphique) de votre portefeuille d’informations dans une iframe.
77 77  
... ... @@ -86,7 +86,7 @@
86 86  * **pass**=<password> Mot de passe pour l’utilisateur
87 87  * **hideFilters**=<true|false> Cache (true) ou montre (false) la barre de filtres
88 88  * {{id name="_GoBack"/}}<nomVariable>=<valeur> Spécifie la valeur de la variable nomVariable
89 -* <filterselection> Voir le paragraphe V ci-dessous
105 +* <filterselection> Voir le paragraphe Filters ci-dessous
90 90  
91 91  Exemple :
92 92  
... ... @@ -108,7 +108,7 @@
108 108  
109 109  * NomDimension=ValeurFiltre
110 110  
111 -Si la dimension contient une hiérarchie ou plus, vous pouvez sélectionnez la hiérarchie et le niveau souhaités en ajoutant :
127 +Si la dimension contient une hiérarchie ou plus, vous pouvez sélectionner la hiérarchie et le niveau souhaités en ajoutant :
112 112  
113 113  * **H**<DimensionName>=NomHierarchie
114 114  * **L**<DimensionName>=NiveauHierarchie
... ... @@ -119,3 +119,13 @@
119 119  (((
120 120  http:~/~/ddsrv:8080/ddenterpriseapi/viewflow?flowId=2340fd0&user=user1&pass=pass1&Geo=France&HGeo=Geography&LGeo=Country
121 121  )))
138 +
139 += Contraintes de sécurité =
140 +
141 +Certains navigateurs, par exemple Chrome à partir de sa version 80, peuvent refuser de transmettre des cookies provenant d'une page intégrée par une iframe, si cette iframe n'a pas le même domaine que la page l'incluant. Une erreur apparait alors dans la console du navigateur, à propos d'un attribute //SameSite //qui n'est pas défini.
142 +
143 +L'attribut //SameSite// ne peut pas être défini sur un cookie non sécurisé. Donc le cookie doit aussi avoir un attribut //Secure //pour permettre de définir //SameSite=None//. Et l'attribut //Secure// ne peut être défini que si la connexion est en HTTPS.
144 +
145 +Donc, en conséquence, intégrer une page de tableaux de bord, ou une page viewflow, en tant qu'iframe,** si l'iframe et la page l'incluant ont des domaines différents**, nécessite d'utiliser une connexion HTTPS, et de configurer les cookies.
146 +
147 +Le document Mozilla suivant explique cette contrainte : [[https:~~/~~/developer.mozilla.org/fr/docs/Web/HTTP/Headers/Set-Cookie/SameSite>>url:https://developer.mozilla.org/fr/docs/Web/HTTP/Headers/Set-Cookie/SameSite]]
1624965167471-356.png
Auteur
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.aureliebertranddigdashbiz
Taille
... ... @@ -1,0 +1,1 @@
1 +83.8 KB
Contenu