Ağ Geçidi Desteğini İşleme

Makale
12/14/2023

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 #sharediş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.Typetek 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"
];

Aracılığıyla paylaş