Language	Title	Date
en	-	-
fr	-	-
es	-	-

Wiki source code of Broadcasting : envoi massif de flux personnalisés

Last modified by Aurelie Bertrand on 2025/02/07 10:14

version	line-number	content
1.1	1	{{ddtoc/}}
	2
	3	----
	4
32.2	5	Le broadcasting permet l’export massif de flux ou rapports personnalisés sur des serveurs de documents ou des adresses email à l’aide de variables de session. Chaque destinataire reçoit le rapport filtré (à partir d'une [[fabrique de document>>doc:Digdash.user_guide.studio.Create_flow.builders.WebHome]], par exemple) avec uniquement les données qui le concerne.
1.1	6
38.1	7	Cet export peut se faire de manière programmée. Vous pouvez, par exemple, envoyer automatiquement chaque 1er du mois les indicateurs des ventes de chaque région à chaque responsable concerné.
7.3	8
42.1	9	Dans ce tutoriel, nous allons voir un cas de configuration du broadcasting pour un envoi massif de flux personnalisés par email. Le contenu reçu par les destinataires sera filtré selon le pays défini pour ceux-ci.
1.1	10
32.2	11	Pour cela, nous allons tout d'abord créer un flux de découpage afin de définir quel contenu va être envoyé à quel destinataire. Ce flux de découpage va prendre la forme d'un tableau avec une colonne contenant les destinataires et une ou plusieurs colonnes permettant de filtrer le contenu à envoyer.
	12
	13	Nous allons ensuite personnaliser le flux (graphique ou fabrique de document) à envoyer afin de pouvoir filtrer le contenu envoyé.
	14
	15	Enfin, nous allons configurer un appareil de sortie email dédié au brodacasting que nous assignerons au flux à exporter.
	16
7.4	17	= Prérequis =
	18
	19	Il est nécessaire de disposer une licence incluant le broadcasting.
	20
32.2	21	(% class="box infomessage" %)
	22	(((
41.1	23	(% style="color:#2c3e50" %)La licence broadcasting n'est pas nécessaire dans le cas d'une personnalisation utilisateur seulement (Live security, par exemple).
32.2	24	)))
1.1	25
44.1	26	= Étape 1 : Créer un flux de découpage =
1.1	27
32.2	28	(% class="box infomessage" %)
	29	(((
42.1	30	💡(% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) (% style="color:#2c3e50; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Il est conseillé de placer le flux de découpage dans le même rôle que le flux à exporter.
32.2	31	)))
2.1	32
47.1	33	Comme évoqué précédemment, le flux de découpage prend la forme d'un tableau avec une colonne contenant les destinataires et une ou plusieurs colonnes permettant de filtrer le contenu à envoyer. Vous devez ainsi disposer d'un modèle de données contenant ces informations. Vous pouvez consulter la page [[Tableau>>doc:Digdash.user_guide.studio.Create_flow.Flow_types_and_configuration.Flow_type_table.Table.WebHome]] pour plus de détails sur la création d'un tableau.
32.2	34
34.2	35	Le nom des colonnes sera utilisé comme variable de session et l(% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)es valeurs contenues dans la colonne seront utilisées comme valeurs pour la variable de session.
32.2	36
34.2	37	(% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Dans notre exemple, nous disposons d'une liste de destinataires avec un pays associé pour chacun.
50.1	38	[[image:Recipient_list_FR.png]]
32.2	39
34.2	40	(% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Ainsi :
32.2	41
55.1	42	* [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="-webkit-text-decoration-skip:none; color:#1155cc; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration-skip-ink:none; text-decoration:underline; white-space:pre-wrap" %)__destinataire1@mail.com__>>path:mailto:destinataire1@mail.com\|\|style="text-decoration:none"]](% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) recevra le flux avec la valeur France sur le filtre pays
	43	* [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="-webkit-text-decoration-skip:none; color:#1155cc; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration-skip-ink:none; text-decoration:underline; white-space:pre-wrap" %)__destinataire2@mail.com__>>path:mailto:destinataire1@mail.com\|\|style="text-decoration:none"]](% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) recevra le flux avec la valeur Canada sur le filtre pays
	44	* [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="-webkit-text-decoration-skip:none; color:#1155cc; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration-skip-ink:none; text-decoration:underline; white-space:pre-wrap" %)__destinataire3@mail.com__>>path:mailto:destinataire1@mail.com\|\|style="text-decoration:none"]](% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) recevra le flux avec la valeur Royaume-Uni sur le filtre pays
	45	* [[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="-webkit-text-decoration-skip:none; color:#1155cc; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration-skip-ink:none; text-decoration:underline; white-space:pre-wrap" %)__destinataire4@mail.com__>>path:mailto:destinataire1@mail.com\|\|style="text-decoration:none"]](% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %) recevra le flux avec la valeur États-Unis sur le filtre pays
1.1	46
38.1	47	= Étape 2 : Personnaliser le flux à envoyer =
2.1	48
47.1	49	Nous considérons ici que nous disposons déjà du flux à envoyer. (% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Le flux utilisé pourra être une {{glossaryReference glossaryId="Glossary" entryId="fabrique de documents"}}fabrique de documents{{/glossaryReference}} afin d'obtenir un rapport avancé.(%%)
34.2	50	Consultez la page [[Créer un flux>>doc:Digdash.user_guide.studio.Create_flow.WebHome]] pour plus de détails.
1.1	51
36.2	52	(% style="color:#333333; font-family:Arial; font-size:10.5pt; font-style:normal; font-variant:normal; font-weight:400; text-decoration:none; white-space:pre-wrap" %)Le flux ou le cube (utilisé par le flux) doit être personnalisé avec la variable de session basée sur le nom de colonne permettant de filtrer le contenu. Dans notre exemple, nous utiliserons donc la variable de session //${session.pays}//.
1.1	53
35.2	54	(% style="font-family:Arial; white-space-collapse:preserve" %)Pour cela, il faut ouvrir le flux dans le Studio et ajouter une règle de filtre sur la dimension.
34.2	55	Ici, nous créons une règle de filtre sur la dimension //"pays" :
55.1	56	[[image:Rule_filter_FR.png\|\|alt="Règle filtre"]]//
4.1	57
46.1	58	Consultez la page [[Définir les axes>>doc:Digdash.user_guide.studio.Create_flow.Configure_flow.Flow_columns.WebHome]] et [[Créer un filtre>>doc:Digdash.user_guide.studio.Create_datamodel.configure_data_model.Configure_columns.Create_hierarchy.Create_set.WebHome\|\|anchor="Create_filter"]] pour en savoir plus sur les filtres.
34.2	59
35.2	60	Il est également possible de personnaliser la description du flux ou du cube, ou le nom des exportations.
34.2	61
35.1	62	= Étape 3 : (% style="color:inherit; font-family:inherit; font-size:29px" %)Créer un appareil de sortie(%%) =
4.1	63
37.1	64	Pour permettre l'envoi des emails, il faut ensuite configurer un appareil de sortie email qui sera dédié à ce broadcast. Pour cela :
7.2	65
36.2	66	1. Créez un nouvel Appareil email dans le Gestionnaire d'appareils du Studio. Consultez la page [[Gestionnaire d'appareils >>doc:Digdash.user_guide.studio.managers.devices.WebHome]]pour plus de détails.
	67	1. Dans l'onglet Propriétés, entrez le nom de l'appareil.
	68	1. Dans l'onglet Synchronisation, configurez le serveur email en indiquant comme destinataire la variable de session basée sur la colonne des destinataires du flux de découpage. Dans notre exemple, nous utiliserons donc //${session.destinataire}//.
55.1	69	[[image:Device_configuration_FR.png\|\|alt="Synchronisation"]]
36.2	70
	71	1. Dans l'onglet Corps du mail et pièce jointe, vous pouvez personnaliser le corps du mail.
47.1	72	1. Dans l'onglet Broadcasting, sélectionnez le flux de découpage : tapez les premières lettres du flux dans le champ {{glossaryReference glossaryId="Glossary" entryId="Flux"}}Flux{{/glossaryReference}} de découpage et sélectionnez le tableau créé à l'étape 1.
55.1	73	[[image:Device_configuration_broadcasting_tab_FR.png\|\|alt="Broadcasting"]]
9.2	74
37.1	75	= Étape 4 : Assigner l'appareil de sortie au flux à exporter =
9.2	76
41.1	77	Dans la liste des flux du Studio, sélectionnez le flux à envoyer aux destinataires puis dans l'onglet Appareils du panneau de droite, assignez l'appareil de sortie Broadcast en cochant la case correspondante.
9.2	78
37.1	79	(% class="box infomessage" %)
	80	(((
9.2	81	Il est recommandé d'attribuer seulement cet appareil de sortie (en plus du Dashboard) au rapport. Les autres appareils de sorties assignés au rapport seront ignorés lors de la synchronisation du rapport.
37.1	82	)))
9.2	83
55.1	84	[[image:Device_selection_FR.png\|\|alt="Appareil de sortie"]]
37.1	85
38.1	86	= Étape 5 : Exécuter le broadcast =
9.2	87
38.1	88	Le broadcast peut être exécutée de manière programmée. Pour cela, définissez une programmation de rafraîchissement pour le flux à envoyer : selon planification, sur évènement, etc. Le broadcast sera exécuté selon celui-ci.
45.1	89	Pour plus d'informations sur la programmation, consultez la page[[ Programmer les rafraîchissements>>doc:Digdash.user_guide.studio.Schedule_refresh.WebHome]].
9.2	90
27.1	91	Vous pouvez également exécuter le broadcast manuellement : cliquez-droit sur le flux à exporter dans la liste des flux du Studio puis, dans le menu, cliquez sur Synchroniser.
9.2	92
22.1	93	(% class="box infomessage" %)
	94	(((
32.2	95	L'ancienne [[page d'exécution du broadcast>>doc:.Page de broadcast.WebHome]] reste accessible depuis le Studio.
22.1	96	)))

Wiki source code of Broadcasting : envoi massif de flux personnalisés

Sommaire