Condividi tramite

Incorporare un oggetto visivo Q autonomo&A

  • Articolo

Mancia

Provare a incorporare un Q&A o sperimentare con le API client nella sezione Esplorare le API della Power BI Embedded Analytics Playground.

Questo articolo illustra i passaggi per l'incorporamento di un oggetto visivo Q autonomo&A nell'applicazione.

Questa funzionalità consente agli utenti di porre domande. Ricevono quindi risposte immediate sotto forma di oggetti visivi come grafici o grafici. Altre informazioni su questa funzionalità in Creare un oggetto visivo Q&A in Power BI.

'immagine animata che mostra la funzionalità Q e A incorporata. Quando un utente modifica la domanda, i dati visivi cambiano.

Come incorporare Q&A

Quando si incorpora il contenuto di Power BI in un'app, si usa un oggetto di configurazione per definire il contenuto che si sta incorporando e per specificare le impostazioni del contenuto. Passare quindi l'oggetto all'API.

Quando si incorpora Q&A, usare un oggetto di configurazione di tipo ILoadQnaConfiguration:

interface ILoadQnaConfiguration {
    accessToken: string;
    datasetIds: string[];
    embedUrl: string;
    question?: string; 
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.QnaMode;
}

Questa interfaccia contiene le proprietà seguenti:

  • accessToken: token che consente di accedere ai dati di Power BI da incorporare. Per altre informazioni sui token di accesso, vedere Informazioni sulle diverse soluzioni di incorporamento.

  • datasetIds: ID dei set di dati che definiscono gli schemi di dati usati dal Q&A incorporato. Per ottenere i set di dati, è possibile usare un'API Set di dati. Di seguito sono riportati due esempi:

    Nota

    Attualmente è possibile configurare un solo set di dati.

  • embedUrl: URL del set di dati per il Q&A che si sta incorporando. Questo URL diventa l'origine dell'elemento iframe HTML che contiene il Q incorporato&A. In particolare, l'API assegna l'URL all'attributo src dell'iframe. È possibile usare un'API set di dati per ottenere questo URL. Di seguito sono riportati due esempi:

  • question: domanda che determina la visualizzazione visualizzata dall'API. Questa proprietà viene utilizzata solo in modalità risultato.

  • tokenType: tipo di token che consente di accedere ai dati di Power BI da incorporare.

    • Usare models.TokenType.Aad se si esegue l'incorporamento per l'organizzazione (l'utente è proprietario dei dati).
    • Usa models.TokenType.Embed se stai incorporando per i tuoi clienti (l'app possiede i dati).

    Per altre informazioni, vedere Informazioni sulle diverse soluzioni di incorporamento.

  • type: tipo di contenuto che si sta incorporando. Usare 'qna' per Q&A.

  • viewMode: modalità del Q&A incorporato. Sono disponibili due modalità:

    • Interactive: l'utente può immettere domande. L'API visualizza le domande e aggiorna l'oggetto visivo di conseguenza.
    • ResultOnly Specificare una domanda specifica. L'API visualizza la domanda e il relativo oggetto visivo.

Questo esempio illustra come incorporare Q&A:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    datasetIds: [aDatasetID],
    embedUrl: anEmbedUrl,
    question: aTextQuestion,
    tokenType: aTokenType,
    type: 'qna',
    viewMode: QnaMode.ResultOnly
};
 
// Get a reference to the HTML element that contains the embedded Q&A.
let embedContainer = $('#embedContainer')[0];
 
// Embed the Q&A.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Modificare la domanda visualizzata

Se si usa un viewMode di ResultOnly e si fornisce una domanda, è possibile usare il metodo setQuestion per modificare la domanda visualizzata. L'API modifica quindi l'oggetto visivo visualizzato.

È possibile usare questo metodo per un elenco di domande frequenti. Quando l'utente esamina le domande, è possibile visualizzare le risposte all'interno dell'elemento incorporato.

La classe Qna di PowerBI Java Script definisce il metodo come segue:

setQuestion(question: string): Promise<void>

Il parametro question contiene una domanda in formato testo.

In questo esempio viene illustrato come usare questo metodo per modificare la domanda visualizzata:

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

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

// Change the displayed question.
await qna.setQuestion("This year sales");

Acquisire le domande degli utenti

Se usi un viewMode di Interactive, l'API può inviare una notifica all'app quando cambia l'oggetto visivo visualizzato. Ogni volta che l'oggetto visivo cambia in risposta a una query di input aggiornata, il componente incorporato genera un evento visualRendered. Se l'app è in ascolto di questo tipo di evento, il codice può rispondere alla nuova query.

Ad esempio, è possibile registrare le domande immesse dagli utenti. Queste domande possono essere usate in un secondo momento per scopi di intelligenza artificiale o telemetria.

Usare codice simile a queste righe per ascoltare visualRendered eventi:

qna.on("visualRendered", function(event) {
    ...
});

Per altre informazioni sull'ascolto degli eventi, vedere Come gestire gli eventi.

Limitazioni

Il Q&A incorporato usa schemi di dati. Attualmente è possibile configurare solo uno schema, non più schemi.

Contenuto correlato