Tek başına Q&Görsel ekleme

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 bu özellik hakkında daha fazla bilgi edinin.

Q&A ekleme

Bir uygulamaya Power BI içeriği eklerken, 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'yı eklerken ILoadQnaConfigurationtü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ümleri 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:

  • Veri Kümeleri - Grup Veri Kümesi Alma
  • Veri Kümeleri - Grup Veri Kümelerini Alma

  Not

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

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

  • Veri Kümeleri - Grup Veri Kümesi Alma
  • Veri Kümeleri - Grup Veri Kümelerini Alma

• 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 ekleniyorsanız (verilerin sahibi kullanıcıdır) models.TokenType.Aad kullanın.
  • Müşterileriniz için ekleniyorsanız models.TokenType.Embed kullanın (verilerin sahibi uygulamadır).

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

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

• viewMode - Ekli 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 belirtin. API bu soruyu ve görselini görüntüler.

Bu örnekte Q&A'nın nasıl ekli olduğu 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

ResultOnly viewMode kullanır ve bir soru sağlarsanız, görüntülenen soruyu değiştirmek için setQuestion yöntemini kullanabilirsiniz. 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ısetQuestion yöntemini şu şekilde tanımlar:

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

Interactive viewMode kullanırsanız, görüntülenen görsel değiştiğinde API uygulamanızı bilgilendirebilir. Görsel güncelleştirilmiş giriş sorgusuna yanıt olarak her değiştiğinde, katıştırılmış 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.

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

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

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

Dikkat edilmesi gerekenler ve 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.

İlgili içerik

• Rapor ekleme
• Rapor görseli ekleme
• Daha iyi performans için bootstrap kullanma