Vous pouvez imbriquer des visualisations dans des conteneurs externes, par exemple, une page HTML ou la page d'application d'un destinataire, et inclure des actions de données dans une visualisation. Une action de données imbriquée permet d'interagir avec la visualisation imbriquée dans le conteneur externe. Vous pouvez extraire un ensemble d'éléments de données utilisés dans une visualisation à partir d'un conteneur externe. Vous pouvez ajouter les actions de données incorporées de votre choix.
L'événement de publication permet aux applications externes de recevoir l'ensemble de valeurs d'élément de données dans la visualisation sélectionnée, ou contexte de visualisation. L'ensemble des valeurs de l'élément de données dans les visualisations sélectionnées ne doit pas être constitué de colonnes de mesure ou de colonnes masquées.
Le nom d'événement est fourni dans le conteneur externe et transmis lorsque vous publiez l'événement de contexte. Le contexte désigne l'ensemble des valeurs d'éléments de données à l'emplacement sélectionné dans la visualisation. Si l'action de données est utilisée dans plusieurs classeurs ou plusieurs éléments de données d'un classeur, indiquez un nom d'événement unique pour simplifier le suivi. Par exemple, si vous avez saisi DV Embedded Content DA1
comme nom d'action, vous pouvez entrer Event from DA1
dans le champ Nom de l'événement pour indiquer de quelle action de données provient l'événement.
Ce paramètre est particulièrement utile si la sélection de plusieurs points de données peut générer une erreur, par exemple, avec certaines API REST tierces.
Une fois le classeur enregistré, vous pouvez l'incorporer dans des conteneurs externes. Le conteneur externe affiche les visualisations incorporées. Lorsque vous cliquez sur la visualisation avec le bouton droit de la souris et qu'elle inclut des actions de données applicables, celles-ci sont affichées dans la visualisation sous forme de menu déroulant. Si vous cliquez sur une action de données incorporée, elle détermine les informations de contexte de la visualisation et transmet ces informations au service d'action de navigation en vue de leur traitement. Le service de navigation déclenche alors un événement avec les informations de charge utile de contexte. Vous pouvez vous abonner à cet événement pour recevoir la charge utile dans le callback d'événement et l'utiliser ailleurs.
Ce paramètre est particulièrement utile si la sélection de plusieurs points de données peut générer une erreur (par exemple, avec certaines API REST tierces).