Veri Erişimini İşleme

Veri Kaynağı İşlevleri

Data Bağlan or, M Kitaplığı'ndaki bir veri kaynağı işlevinin davranışını sarmalar ve özelleştirir. Örneğin, BIR REST API uzantısı HTTP istekleri yapmak için Web.Contents işlevini kullanır. Şu anda, genişletilebilirliği desteklemek için sınırlı bir veri kaynağı işlevleri kümesi etkinleştirilmiştir.

• Web.Contents
• OData.Feed
• Odbc.DataSource
• AdoDotNet.DataSource
• OleDb.DataSource

Örnek:

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

Veri Kaynağı Türü

Uzantınızda olarak shared işaretlenmiş işlevler, işleve Veri Kaynağı tanım kaydının adıyla değişmez DataSource.Kind değer özniteliği eklenerek belirli bir veri kaynağıyla ilişkilendirilebilir. Veri Kaynağı kaydı, veri kaynağınız tarafından desteklenen kimlik doğrulama türlerini ve temel marka bilgilerini (görünen ad/etiket gibi) tanımlar. Kaydın adı benzersiz tanımlayıcısı olur.

Aynı veri kaynağıyla ilişkilendirilmiş her işlevin ad, tür ve sıra dahil olmak üzere aynı gerekli işlev parametrelerine sahip olması gerekir. (Veri Kaynağı Türü amaçları doğrultusunda, bir parametre işaretliyse optional veya meta verileri içeriyorsa DataSource.Path = falsegerekli kabul edilmez.)

Belirli bir Veri Kaynağı Türünün işlevleri yalnızca bu Türle ilişkili kimlik bilgilerini kullanabilir. Kimlik bilgileri, işlevin gerekli parametrelerinin birleşimine göre bir arama gerçekleştirilerek çalışma zamanında tanımlanır. Kimlik bilgilerinin nasıl tanımıldığı hakkında daha fazla bilgi için bkz . Veri Kaynağı Yolları.

Örnek:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Özellikler

Aşağıdaki tabloda Veri Kaynağı tanım kaydınızın alanları listelemektedir.

Alan	Tür	Ayrıntılar
Kimlik Doğrulaması	Kayıt	Veri kaynağınız tarafından desteklenen bir veya daha fazla kimlik doğrulaması türünü belirtir. En az bir tür gereklidir. Her tür, Power Query kimlik bilgisi isteminde bir seçenek olarak görüntülenir. Daha fazla bilgi için bkz . Kimlik Doğrulama Türleri.
Etiket	text	(isteğe bağlı) Kimlik bilgileri iletişim kutularındaki bu uzantı için kolay görünen ad.
SupportsEncryption	Mantıksal	(isteğe bağlı) Doğru olduğunda, kullanıcı arabirimi şifrelenmiş bir bağlantı kullanarak veri kaynağına bağlanma seçeneğini sunar. Bu genellikle şifrelenmemiş geri dönüş mekanizmasına (genellikle ODBC veya ADO.NET tabanlı kaynaklar) sahip veri kaynakları için kullanılır.

Kullanıcı arabiriminde yayımla

Veri Kaynağı tanım kaydına benzer şekilde Yayımla kaydı, Power Query kullanıcı arabirimine Veri Al iletişim kutusunda bu uzantıyı kullanıma sunmak için gereken bilgileri sağlar.

Örnek:

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Özellikler

Aşağıdaki tabloda Yayımla kaydınızın alanları listelemektedir.

Alan	Tür	Ayrıntılar
ButtonText	listele	Metin öğelerinin listesi. İlk öğe, Power BI Veri Al iletişim kutusunda veri kaynağının simgesinin yanında görüntülenen adı tanımlar. İkinci öğe (isteğe bağlı), önceki ad fareyle üzerine geldiğinde görüntülenecek araç ipucunu tanımlar.
Kategori	text	Uzantının Veri Al iletişim kutusunda görüntülenmesi gereken yer. Şu anda özel iletim içeren tek kategori değerleri ve Database'tirAzure. Diğer tüm değerler Diğer kategorisinin altında kalır.
Beta	Mantıksal	(isteğe bağlı) True olarak ayarlandığında, kullanıcı arabirimi bağlayıcı adınızın yanında bir Önizleme/Beta tanımlayıcısı ve bağlayıcı uygulamasının hataya neden olan değişikliklere tabi olduğuna ilişkin bir uyarı iletişim kutusu görüntüler.
LearnMoreUrl	text	(isteğe bağlı) Bu veri kaynağı veya bağlayıcı hakkında daha fazla bilgi içeren web sitesinin URL'si.
SupportsDirectQuery	Mantıksal	(isteğe bağlı) Uzantınız için Doğrudan Sorgu'yu etkinleştirir.
SourceImage	Kayıt	(isteğe bağlı) İkili görüntülerin listesini içeren bir kayıt (Extension.Contents yöntemi kullanılarak uzantı dosyasından kaynaklanmıştır). Kayıt, her biri kendi listesine sahip iki alan (Icon16, Icon32) içerir. Her simge farklı boyutta olmalıdır.
SourceTypeImage	Kayıt	(isteğe bağlı) SourceImage'a benzer şekilde, çok sayıda hazır bağlayıcının kuralı dışında sağ alt köşede kaynağa özgü simge bulunan bir sayfa simgesi görüntülemektir. SourceTypeImage için farklı bir simge kümesine sahip olmak isteğe bağlıdır; çoğu uzantı her iki alan için de aynı simge kümesini yeniden kullanır.