Ερωτήσεις και απαντήσεις στην ενσωματωμένη λειτουργία ανάλυσης του Power BIQ&A in Power BI embedded analytics

Η ενσωματωμένη λειτουργία ανάλυσης του Power BI σάς παρέχει έναν τρόπο για να ενσωματώσετε τη δυνατότητα "Ερωτήσεις και απαντήσεις" σε μια εφαρμογή και να επιτρέψετε στους χρήστες να υποβάλουν ερωτήσεις χρησιμοποιώντας φυσική γλώσσα και να λάβουν άμεσες απαντήσεις με τη μορφή απεικονίσεων, όπως γραφήματα ή γραφικά.Power BI embedded analytics 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.

Μια αλληλεπιδραστική ερώτηση σε ένα ενσωματωμένο πλαίσιο στις "Ερωτήσεις και απαντήσεις"

Υπάρχουν δύο λειτουργίες για την ενσωμάτωση ερωτήσεων και απαντήσεων στην εφαρμογή σας: αλληλεπιδραστική και μόνο αποτέλεσμα.There are two modes for embedding Q&A within your application: interactive and result only. Η αλληλεπιδραστική λειτουργία σάς επιτρέπει να πληκτρολογήσετε ερωτήσεις και να τις εμφανίσετε μέσα στην απεικόνιση.Interactive mode allows you to type in questions and have them displayed within the visual. Εάν έχετε μια αποθηκευμένη ερώτηση ή μια ερώτηση συνόλου που θέλετε να εμφανιστεί, μπορείτε να χρησιμοποιήσετε τη μέθοδο μόνο αποτέλεσμα συμπληρώνοντας την ερώτηση στην ενσωματωμένη ρύθμιση παραμέτρων.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.

Ρίξτε μια ματιά στο πώς θα φαίνεται ο κώδικας 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);

Υποβολή ερώτησηςSet question

Εάν χρησιμοποιήσατε τη λειτουργία αποτελέσματος με μια συγκεκριμένη ερώτηση, μπορείτε να εισαγάγετε πρόσθετες ερωτήσεις μέσα στο πλαίσιο και να τις απαντήσετε αμέσως, αντικαθιστώντας το προηγούμενο αποτέλεσμα.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. Προκύπτει μια νέα απεικόνιση που αντιστοιχεί στη νέα ερώτηση.A new visual is rendered matching the new question.

Ένα παράδειγμα αυτής της χρήσης είναι μια λίστα με συνήθεις ερωτήσεις.One example of this usage would be a frequently asked question list. Ο χρήστης θα μπορούσε να δει τις ερωτήσεις και να τις απαντήσει μέσα στο ίδιο ενσωματωμένο τμήμα.The user could go through the questions and have them answered within the same embedded part.

Τμήμα κώδικα για χρήση του 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) {
        …….
    });

Οπτική απόδοση συμβάντοςVisual rendered event

Στην αλληλεπιδραστική μέθοδο, η εφαρμογή μπορεί να ειδοποιηθεί με ένα συμβάν αλλαγής δεδομένων κάθε φορά που η απεικόνιση που προκύπτει αλλάζει για να στοχεύσει το ενημερωμένο ερώτημα εισόδου κατά την πληκτρολόγηση.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.

Η ακρόαση του συμβάντος visualRendered σας επιτρέπει να αποθηκεύετε ερωτήσεις για μεταγενέστερη χρήση.Listening to the visualRendered event allows you to save questions for use later.

Τμήμα κώδικα για χρήση του 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) {
     …….
});

Διακριτικό ενσωμάτωσηςEmbed token

Για να δημιουργήσετε ένα διακριτικό ενσωμάτωσης από ένα σύνολο δεδομένων για να ξεκινήσετε ένα τμήμα ερωτήσεων και απαντήσεων.Create an embed token off of a dataset to start a Q&A part. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία διακριτικού.For more information, see Generate token.

Επόμενα βήματαNext steps

Για να δοκιμάσετε την ενσωμάτωση των ερωτήσεων και απαντήσεων, δείτε το Δείγμα ενσωμάτωσης JavaScript.To give Q&A embedding a try, check out the JavaScript embed sample.

Έχετε περισσότερες ερωτήσεις;More questions? Δοκιμάστε να ρωτήσετε την κοινότητα του Power BITry asking the Power BI Community