Partager via

Questions et réponses (Q&R) dans l’analytique incorporée Power BI

  • Article

L’analytique incorporée Power BI vous offre un moyen d’incorporer Q&A dans une application. Vos utilisateurs peuvent poser des questions en utilisant le langage naturel et recevoir des réponses immédiates sous la forme de visuels tels que des graphiques ou des tableaux.

GIF animé de la vue Power BI Embedded, qui montre comment incorporer un exemple de question Q&A.

Il existe deux modes pour intégrer la fonctionnalité Q&R dans votre application : interactif et résultats uniquement. Le mode Interactif vous permet de taper des questions et de les afficher dans le visuel. Si vous avez une question enregistrée ou une question définie que vous souhaitez afficher, vous pouvez utiliser le mode "résultat uniquement" en intégrant la question dans votre configuration d'intégration.

Voici un exemple de code JavaScript :

// Embed configuration used to describe the what and how to embed.
// This object is used when calling powerbi.embed within the JavaScript API.
// You can find more information at https://github.com/Microsoft/PowerBI-JavaScript/wiki/Embed-Configuration-Details.
var config= {
    type: 'qna',
    tokenType:   models.TokenType.Embed | models.TokenType.Aad,
    accessToken: access token value,
    embedUrl:    https://app.powerbi.com/qnaEmbed (groupId to be appended as query parameter if required),
    datasetIds:  array of requested data set ids (at the moment we support only one dataset),
    viewMode:    models.QnaMode.Interactive | models.QnaMode.ResultOnly,
    question:    optional parameter for Explore mode (QnaMode.Interactive) and mandatory for Render Result mode (QnaMode.ResultOnly)
};

// Get a reference to the embedded QNA HTML element
var qnaContainer = $('#qnaContainer')[0];

// Embed the QNA and display it within the div container.
var qna = powerbi.embed(qnaContainer, config);

Définir la question

Si vous utilisez mode résultat avec une question définie, vous pouvez injecter d’autres questions dans le cadre. La réponse à la nouvelle question remplacera immédiatement le résultat précédent. Un nouveau visuel est rendu correspondant à la nouvelle question.

Un exemple de cette utilisation serait une liste de questions fréquemment posées. L'utilisateur pourrait examiner les questions et les voir répondues dans la même partie intégrée.

extrait de code pour l’utilisation du Kit de développement logiciel (SDK) JS :

// Get a reference to the embedded Q&A HTML element
var qnaContainer = $('#qnaContainer')[0];

// Get a reference to the embedded Q&A.
qna = powerbi.get(qnaContainer);

qna.setQuestion("This year sales")
    .then(function (result) {
        …….
    })
    .catch(function (errors) {
        …….
    });

Événement rendu visuel

Pour le mode interactif , l'application peut être notifiée par un événement de modification des données chaque fois que le visuel rendu change pour viser la requête d'entrée mise à jour au fur et à mesure de la saisie.

L’écoute de l’événement visualRendered vous permet d’enregistrer les questions à utiliser ultérieurement.

extrait de code pour l’utilisation du Kit de développement logiciel (SDK) JS :

// Get a reference to the embedded Q&A HTML element
var qnaContainer = $('#qnaContainer')[0];

// Get a reference to the embedded Q&A.
qna = powerbi.get(qnaContainer);

// qna.off removes a given event listener if it exists.
qna.off("visualRendered");

// qna.on will add an event listener.
qna.on("visualRendered", function(event) {
     …….
});

Incorporer un jeton

Créez un jeton d'intégration à partir d'un modèle sémantique pour démarrer une section de Q&R. Pour plus d’informations, consultez Opération Génération de jeton.

Contenu connexe

Essayez le laboratoire d'analytique intégrée Power BI

Plus de questions ? Demander à la communauté Power BI