Questions et réponses dans Power BI EmbeddedQ&A in Power BI Embedded

Power BI Embedded vous permet d’incorporer Questions et réponses dans une application et permet aux utilisateurs de poser des questions en utilisant un langage naturel, ainsi que de recevoir des réponses immédiates sous forme de visuels, par exemple des graphiques.Power BI Embedded offers you a way to incorporate Q&A into an application and allow your users to ask questions using natural language and receive immediate answers in the form of visuals like charts or graphs.

Question Interactive Questions et réponses dans une image incorporée

Il existe deux modes pour l’incorporation de Questions et réponses au sein de votre application : interactif et résultat uniquement.There are two modes for embedding Q&A within your application: interactive and result only. Le mode Interactif vous permet de taper des questions et de les afficher dans le visuel.Interactive mode allows you to type in questions and have them displayed within the visual. 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 remplissant la question dans la configuration de l’incorporation.If you have a saved question, or a set question you want to display, you can use the result only mode by populating the question in your embed config.

Voici à quoi ressemble le code JavaScript.Here is a look at what the JavaScript code will look like.

// 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);

Question définieSet question

Si vous avez utilisé le mode résultat avec une question définie, vous pouvez injecter des questions supplémentaires dans l’image et recevoir immédiatement une réponse qui remplace le résultat précédent.If you used result mode with a set question, you can inject additional questions into the frame and have them immediately answered replacing the previous result. Un nouveau visuel correspondant à la nouvelle question est affiché.A new visual is rendered matching the new question.

Un exemple de cette utilisation est une liste de questions fréquentes.One example of this usage would be a frequently asked question list. L’utilisateur peut parcourir les questions et obtenir des réponses au sein de la même partie incorporée.The user could go through the questions and have them answered within the same embedded part.

Extrait de code pour l’utilisation du SDK JS :Code snippet for JS SDK usage:

// 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 par un visuelVisual rendered event

Pour le mode interactif, l’application peut être avertie par un événement de modification des données chaque fois que le visuel affiché change de façon à refléter la requête d’entrée tapée.For interactive mode, the application can be notified with a data changed event each time the rendered visual changes to target the updated input query as it is being typed.

Écouter l’événement visualRendered vous permet d’enregistrer des questions pour une utilisation ultérieure.Listening to the visualRendered event allows you to save questions for use later.

Extrait de code pour l’utilisation du SDK JS :Code snippet for JS SDK usage:

// 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) {
     …….
});

Jeton d’incorporationEmbed token

Créez un jeton d’incorporation d’un jeu de données pour démarrer une partie Questions et réponses.Create an embed token off of a dataset to start a Q&A part. Pour plus d’informations, consultez Générer un jeton pour Questions et réponses.For more information, see Generate token for Q&A.

Étapes suivantesNext steps

Pour essayer l’incorporation dans Questions et réponses, consultez l’exemple d’incorporation JavaScript.To give Q&A embedding a try, check out the JavaScript embed sample.

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community