Ağ Geçidi Desteğini İşleme
Bağlantıyı Test Et
Özel Bağlan veya desteği, şirket içi veri ağ geçidinin hem Kişisel hem de Standart modlarında kullanılabilir. Her iki ağ geçidi modu da İçeri aktarmayı destekler. Doğrudan Sorgu yalnızca Standart modda desteklenir. Ağ geçitleri aracılığıyla özel bağlayıcılar için OAuth şu anda yalnızca ağ geçidi yöneticileri için desteklenmektedir ancak diğer veri kaynağı kullanıcıları için desteklenmemektedir.
Power BI Özel Veri Bağlan veya işlevselliği önizleme aşamasındayken Test Bağlan ion işlevini uygulama yöntemi büyük olasılıkla değişebilir.
Şirket içi veri ağ geçidi aracılığıyla zamanlanmış yenilemeyi desteklemek için bağlayıcınızın bir Test Bağlan ion işleyicisi uygulaması gerekir. kullanıcı kaynağınız için kimlik bilgilerini yapılandırırken işlev çağrılır ve geçerli olduğundan emin olmak için kullanılır. Test Bağlan ion işleyicisi Veri Kaynağı Türü kaydında ayarlanır ve aşağıdaki imzaya sahiptir:
(dataSourcePath) as list => ...
burada dataSourcePath
işlevinizin Veri Kaynağı Yolu değeri ve dönüş değeri şunlardan oluşan bir listedir:
- Çağrılacak işlevin adı (bu işlev olarak
#shared
işaretlenmelidir ve genellikle birincil veri kaynağı işlevinizdir). - İşlevinize geçirmek için bir veya daha fazla bağımsız değişken.
İşlevin çağrılması bir hatayla sonuçlanırsa Test Bağlan ion başarısız olarak kabul edilir ve kimlik bilgisi kalıcı olmaz.
Dekont
Yukarıda belirtildiği gibi, Test Bağlan ion tarafından sağlanan işlev adı bir shared
üye olmalıdır.
Örnek: Bağlan veya gerekli bağımsız değişkenler olmadan
Aşağıdaki kod parçacığı, gerekli parametreleri olmayan bir veri kaynağı için Test Bağlan ion uygular (TripPin öğreticisinde bulunan kod gibi). Gerekli parametresi olmayan Bağlan ('Singletons' olarak adlandırılır) bir bağlantıyı test etmek için kullanıcı tarafından sağlanan giriş gerekmez (kimlik bilgileri dışında). Bu durumda, dataSourcePath
değer Veri Kaynağı Türünün adına eşit olur ve yoksayılabilir.
İşlev TripPin.Contents
ek parametre olmadan çağrılır.
TripPin = [
TestConnection = (dataSourcePath) => { "TripPin.Contents" },
Authentication = [
Anonymous = []
],
Label = "TripPin"
];
Örnek: URL parametresiyle Bağlan
Veri kaynağı işlevinizin türünde Uri.Type
tek bir gerekli parametresi varsa, işlevi dataSourcePath
kullanıcı tarafından sağlanan URL'ye eşit olur. Aşağıdaki kod parçacığı github örneğinden Test Bağlan ion uygulamasını gösterir.
GithubSample = [
TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
Authentication = [
OAuth = [
StartLogin = StartLogin,
FinishLogin = FinishLogin,
Label = Extension.LoadString("AuthenticationLabel")
]
]
];
Örnek: gerekli parametrelerle Bağlan
Veri kaynağı işlevinizin birden çok parametresi veya URL olmayan tek bir parametresi varsa, dataSourcePath
değer parametreleri içeren bir JSON dizesi olur. Aşağıdaki kod parçacığı DirectQueryForSQL örneğinden gelir.
DirectSQL = [
TestConnection = (dataSourcePath) =>
let
json = Json.Document(dataSourcePath),
server = json[server],
database = json[database]
in
{ "DirectSQL.Database", server, database },
Authentication = [
Windows = [],
UsernamePassword = []
],
Label = "Direct Query for SQL"
];