Données POST

L'action crée une API de sortie pour faire passer les données des tableaux de bord vers un système d'inclusion, par exemple une application Web externe.

La structure de données de l'API est constituée de l'ID de tableau de bord, de l'ID de widget externe indiqué (ID de l'URL, voir : Utiliser une sélection URL dynamique), des noms des coordonnées sélectionnées (colonnes), des valeurs des coordonnées sélectionnées et du nom de l'événement déclenchant le push des données de sortie. Voir l'exemple de structure de données de sortie MZNG ci-dessous.

Procédure

  1. Créez un tableau de bord ou ouvrez un tableau de bord dans l'éditeur de tableaux de bord.

  2. Cliquez sur un widget de graphique inséré qui prend en charge les actions. Le dialogue des propriétés correspondant s'affiche.

  3. Cliquez sur l'onglet Action.

  4. Sélectionnez l'événement de déclenchement d'action dans le menu déroulant Déclencher.

    Les actions disponibles dépendent du widget sélectionné.

  5. Activez l'option Données post.

    Si vous désactivez l'option, l'action n'est pas supprimée, mais désactivée en mode d'affichage.

  6. Cliquez sur Configure pour définir la configuration d'action.

    1. Sélectionnez les coordonnées que vous souhaitez ajouter aux données de sortie.

      Les coordonnées sélectionnées sont ajoutées aux données de sortie, qui sont affichées dans la case Aperçu des données de sortie.

    2. Cliquez sur Enregistrer action.

Vos paramètres sont appliqués et votre action est définie pour le widget sélectionné.

Exemple

La structure des données de sortie est comme suit :

{

"dashboardGUID": "d216bf4a-bd12-476d-aa5d-2a07a3efd4bf",

"outbound Widgets": [

{

"extId": "widget2",

"outboundData": [

{ "name": "ARTIST",

"value": "Bob Dylan",

"type": "TEXT"

},

{

"name": "PRICE",

"value": "11.0",

"type": "NUMERIC"

}

],

"trigger": "onSelectionChange"

}

]

}

Le déclenchement de l'action Données POST envoie les données de sortie configurées au moyen d'événements window.postMessage(). Pour recevoir les événements dans un système d'inclusion, une fonction d'écouteur doit être mise en place comme dans l'exemple ci-dessous :

function listener(event){

// L'origine de la fenêtre qui a envoyé le message

// lorsque postMessage a été appelé

// Format : protocol ://host:port var origin = event.origin

// Une référence vers l'objet de fenêtre qui a envoyé le message var source = event.source;

// L'objet de données posté var data = event.data;

}

if (window.addEventListener){ addEventListener("message", listener, false) } else { attachEvent("onmessage", listener) }