Tek başına Q&Görsel ekleme

  • Makale

İpucu

Q&A eklemeyi deneyin veya Power BI Embedded Analytics Oyun Alanı'nınAPI'lerimizi keşfedin bölümünde istemci API'lerimizle denemeler yapın.

Bu makale, uygulamanıza tek başına Q&A görseli ekleme adımlarını kapsar.

Bu özellik, kullanıcıların soru sorması için bir yol sağlar. Daha sonra grafikler veya grafikler gibi görseller biçiminde anında yanıtlar alırlar. Power BI'da Q&A görseli oluşturma bölümünde bu özellik hakkında daha fazla bilgi edinin.

Eklenmiş Q ve A özelliğini gösteren animasyonlu görüntü. Kullanıcı soruyu değiştirdiğinde görsel verileri değişir.

Q&A ekleme

Bir uygulamaya Power BI içeriği eklediğinizde, eklediğiniz içeriği tanımlamak ve içeriğin ayarlarını belirtmek için bir yapılandırma nesnesi kullanırsınız. Ardından bu nesneyi API'ye geçirirsiniz.

Q&A eklerken ILoadQnaConfiguration türünde bir yapılandırma nesnesi kullanın:

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

Bu arabirim aşağıdaki özellikleri içerir:

  • accessToken - Eklediğiniz Power BI verilerine erişmenizi sağlayan belirteç. Erişim belirteçleri hakkında daha fazla bilgi edinmek için bkz. Farklı ekleme çözümlerini anlama .

  • datasetIds - Eklenmiş Q&A'nın kullandığı veri şemalarını tanımlayan veri kümelerinin kimlikleri. Veri kümelerini almak için Veri Kümeleri API'sini kullanabilirsiniz. İki örnek şunlardır:

    Not

    Şu anda yalnızca bir veri kümesi yapılandırabilirsiniz.

  • embedUrl - Eklediğiniz Q&A için veri kümesinin URL'si. Bu URL, eklenmiş Q&A'yi içeren HTML iframe öğesinin kaynağı olur. Özellikle, API URL'yi özniteliğine srciframeatar. Bu URL'yi almak için Bir Veri Kümeleri API'si kullanabilirsiniz. İki örnek şunlardır:

  • question - API'nin görüntülediği görselleştirmeyi belirleyen soru. Bu özellik yalnızca sonuç modunda kullanılır.

  • tokenType - Eklediğiniz Power BI verilerine erişmenizi sağlayan belirteç türü.

    • Kuruluşunuz için içerik ekliyorsanız kullanın models.TokenType.Aad (verilerin sahibi kullanıcıdır).
    • Müşterileriniz için içerik ekliyorsanız kullanın models.TokenType.Embed (verilerin sahibi uygulamadır).

    Daha fazla bilgi için bkz. Farklı ekleme çözümlerini anlama .

  • type - Eklediğiniz içerik türü. Q&A için kullanın 'qna' .

  • viewMode - Eklenmiş Q&A modu. İki mod kullanılabilir:

    • Interactive - Kullanıcı soruları girebilir. API soruları görüntüler ve görseli uygun şekilde güncelleştirir.
    • ResultOnly Belirli bir soru sağlayacaksınız. API bu soruyu ve görselini görüntüler.

Bu örnekte, Q&A ekleme gösterilmektedir:

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

Görüntülenen soruyu değiştirme

bir viewModeResultOnly kullanır ve soru sağlarsanız, görüntülenen soruyu değiştirmek için yöntemini kullanabilirsiniz setQuestion . Ardından API, görüntülenen görseli değiştirir.

Sık sorulan soruların listesi için bu yöntemi kullanabilirsiniz. Kullanıcı soruların üzerinden geçerken, ekli öğenin içinde yanıtları görüntüleyebilirsiniz.

PowerBI JavaScript Qna sınıfı yöntemini şu şekilde tanımlar setQuestion :

setQuestion(question: string): Promise<void>

question parametresi metin biçiminde bir soru içerir.

Bu örnekte, görüntülenen soruyu değiştirmek için bu yöntemin nasıl kullanılacağı gösterilmektedir:

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

Kullanıcılarınızın sorularını yakalama

kullanıyorsanız viewModeInteractive, görüntülenen görsel değiştiğinde API uygulamanızı bilgilendirebilir. Görsel güncelleştirilmiş bir giriş sorgusuna yanıt olarak her değiştiğinde, eklenmiş bileşen bir visualRendered olay yayar. Uygulamanız bu tür bir olayı dinlerse kodunuz yeni sorguyu yanıtlayabilir.

Örneğin, kullanıcıların girdiği soruları kaydedebilirsiniz. Bu soruları daha sonra yapay zeka veya telemetri amacıyla kullanabilirsiniz.

Olayları dinlemek visualRendered için şu satırlar gibi bir kod kullanın:

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

Olayları dinleme hakkında daha fazla bilgi için bkz. Olayları işleme .

Sınırlamalar

Ekli Q&A veri şemalarını kullanır. Şu anda birden çok şema değil, yalnızca bir şema yapılandırabilirsiniz.

Sonraki adımlar

Rapor ekleme

Rapor görseli ekleme

Daha iyi performans için bootstrap kullanma