Domande e risposte in Power BI EmbeddedQ&A in Power BI Embedded

Power BI Embedded offre un modo per incorporare Domande e risposte in un'applicazione e per consentire agli utenti di porre domande usando il linguaggio naturale e ricevere risposte immediate sotto forma di oggetti visivi quali grafici o grafi.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.

Domanda interattiva di Domande e risposte in un frame incorporato

Sono disponibili due modalità per incorporare Domande e risposte nell'applicazione, ovvero interattiva e solo risultato.There are two modes for embedding Q&A within your application: interactive and result only. La modalità interattiva consente di digitare domande e visualizzarle nell'oggetto visivo.Interactive mode allows you to type in questions and have them displayed within the visual. Se è stata salvata una domanda o una domanda configurata da visualizzare, è possibile usare la modalità solo risultato popolando la domanda nella configurazione di incorporamento.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.

Il codice JavaScript avrà un aspetto simile al seguente.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);

Domanda configurataSet question

Se è stata usata la modalità solo risultato con una domanda configurata, è possibile inserire domande aggiuntive nel frame e ottenere immediatamente risposta sostituendo il risultato precedente.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. Viene eseguito il rendering di un nuovo oggetto visivo corrispondente alla nuova domanda.A new visual is rendered matching the new question.

Un esempio di questo utilizzo è costituito da un elenco di domande frequenti.One example of this usage would be a frequently asked question list. L'utente può esaminare le domande e ottenere risposte nella stessa parte incorporata.The user could go through the questions and have them answered within the same embedded part.

Frammento di codice per l'utilizzo di JS SDK: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) {
        …….
    });

Evento con rendering in oggetto visivoVisual rendered event

Per la modalità interattiva l'applicazione può ricevere notifiche con un evento di modifica di dati ogni volta che l'oggetto visivo con rendering viene modificato per adeguarsi alla query di input aggiornata durante la digitazione.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.

Rimanere in attesa dell'evento visualRendered consente di salvare le domande per un uso futuro.Listening to the visualRendered event allows you to save questions for use later.

Frammento di codice per l'utilizzo di JS SDK: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) {
     …….
});

Token di incorporamentoEmbed token

Creare un token di incorporamento da un set di dati per iniziare a creare una parte Domande e risposte.Create an embed token off of a dataset to start a Q&A part. Per altre informazioni, vedere Generate token for Q&A (Generare un token per Domande e risposte).For more information, see Generate token for Q&A.

Passaggi successiviNext steps

Per provare a usare l'incorporamento di Domande e risposte, vedere l'esempio di incorporamento di JavaScript.To give Q&A embedding a try, check out the JavaScript embed sample.

Altre domande?More questions? Provare a rivolgersi alla community di Power BITry asking the Power BI Community