Q&A in ingesloten analyses in Power BI

Ingesloten analyses in Power BI bieden u een manier om Q&A op te nemen in een toepassing. Uw gebruikers kunnen vragen stellen met behulp van natuurlijke taal en direct antwoorden krijgen in de vorm van visuele elementen, zoals grafieken of grafieken.

Er zijn twee modi voor het insluiten van Q&A in uw toepassing: alleen interactief en resultaat. In de interactieve modus kunt u vragen typen en deze weergeven in de visual. Als u een opgeslagen vraag of een setvraag hebt die u wilt weergeven, kunt u de resultatenmodus alleen gebruiken door de vraag in te vullen in de configuratie voor insluiten.

Hier volgt een voorbeeld van de JavaScript-code:

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

Vraag instellen

Als u de resultaatmodus met een ingestelde vraag gebruikt, kunt u meer vragen in het frame invoegen. Het antwoord op de nieuwe vraag vervangt onmiddellijk het vorige resultaat. Er wordt een nieuwe visual weergegeven die overeenkomt met de nieuwe vraag.

Een voorbeeld van dit gebruik is een lijst met veelgestelde vragen. De gebruiker kan de vragen doorlopen en deze laten beantwoorden binnen hetzelfde ingesloten onderdeel.

Codefragment voor JS SDK-gebruik:

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

Weergegeven visualgebeurtenis

Voor de interactieve modus kan de toepassing worden gewaarschuwd met een gebeurtenis die is gewijzigd in gegevens telkens wanneer de weergegeven visual wordt gewijzigd om de bijgewerkte invoerquery te richten terwijl deze wordt getypt.

Door naar de visualRendered-gebeurtenis te luisteren, kunt u vragen opslaan voor later gebruik.

Codefragment voor JS SDK-gebruik:

// 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 insluiten

Maak een insluittoken van een semantisch model om een Q&A-onderdeel te starten. Zie de bewerking voor het genereren van tokens voor meer informatie.

Gerelateerde inhoud

Q&A-insluiting uitproberen met het Voorbeeld van het insluiten van JavaScript

Meer vragen? Vraag het Power BI-community