Aracılığıyla paylaş

Veri Erişimini İşleme

Veri Kaynağı İşlevleri

Veri Bağlayıcısı , 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.

Example:

[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ızdaki shared olarak işaretlenmiş işlevler, bir Veri Kaynağı tanım kaydının adıyla sabit DataSource.Kind nitelik eklenerek belirli bir veri kaynağı ile 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 optional ile işaretli ise veya meta verileri DataSource.Path = false içeriyorsa gerekli 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ı.

Example:

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

Özellikler

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

Veri Alanı Türü Ayrıntılar
Authentication 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 Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin. (isteğe bağlı) Kimlik bilgileri iletişim kutularındaki bu uzantı için kullanıcı dostu görünen ad.
ŞifrelemeyiDestekler mantıklı (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.

Example:

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.

Veri Alanı Türü Ayrıntılar
Düğme Metni liste 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 Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin. Uzantının Veri Al iletişim kutusunda görüntülenmesi gereken yer. Şu anda özel işleme tabi olan tek kategori değerleri Azure ve Database'dir. Diğer tüm değerler Diğer kategorisinin altında kalır.
Beta sürümü mantıklı (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 Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin. (isteğe bağlı) Bu veri kaynağı veya bağlayıcı hakkında daha fazla bilgi içeren web sitesinin URL'si.
SupportsDirectQuery mantıklı (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.
KaynakTipiGörüntü kayıt (isteğe bağlı) SourceImage'e benzer şekilde, birçok hazır bağlayıcının konvansiyonu, sağ alt köşede kaynağa özgü bir simgenin olduğu bir sayfa simgesi göstermektir. 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.
  • Last updated on