Administrar la compatibilidad de puerta de enlace

Probar conexión

Los modos Personal y Estándar de la puerta de enlace de datos local admiten conectores personalizados.

Ambos modos de puerta de enlace admiten la importación. Direct Query solo se admite en modo estándar. Actualmente, OAuth para conectores personalizados a través de puertas de enlace solo admite administradores de puerta de enlace, no otros usuarios del origen de datos.

Para admitir la actualización programada a través de la puerta de enlace de datos local, el conector debe implementar un controlador TestConnection. La función se llama cuando el usuario está configurando las credenciales para su origen y se utiliza para comprobar que son válidas. El Tipo de origen de datos establece el manejador TestConnection en un registro. Tiene la firma siguiente:

(dataSourcePath) as list => ...

Donde dataSourcePath es el valor del Ruta de acceso del origen de datos para la función, y el valor devuelto es una lista compuesta por:

• El nombre de la función que se va a llamar (esta función debe marcarse como #sharedy normalmente es la función de origen de datos principal).
• Uno o varios argumentos para pasar a tu función.

Si la invocación de la función da como resultado un error, TestConnection falla y la credencial no se guarda.

Ejemplo: Conector sin argumentos requeridos

El siguiente fragmento de código implementa TestConnection para un origen de datos sin parámetros necesarios (como el que se encuentra en el tutorial de TripPin). Los conectores sin parámetros necesarios ( denominados Singletons) no necesitan ninguna entrada proporcionada por el usuario para probar una conexión (que no sea las credenciales). En este caso, el dataSourcePath valor es igual al nombre del tipo de origen de datos y puede omitirlo.

La TripPin.Contents función se invoca sin ningún otro parámetro.

TripPin = [
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin"
];

Ejemplo: Conector con un parámetro de dirección URL

Si la función de origen de datos tiene un único parámetro necesario del tipo Uri.Type, su dataSourcePath valor es igual a la dirección URL proporcionada por el usuario. En el fragmento de código siguiente se muestra la implementación de TestConnection del ejemplo de GitHub.

GithubSample = [
    TestConnection = (dataSourcePath) => {"GithubSample.Contents", dataSourcePath},
    Authentication = [
        OAuth = [
            StartLogin = StartLogin,
            FinishLogin = FinishLogin,
            Label = Extension.LoadString("AuthenticationLabel")
        ]
    ]
];

Ejemplo: Conector con parámetros necesarios

Si la función de origen de datos tiene varios parámetros o un único parámetro que no es url, el dataSourcePath valor es una cadena JSON que contiene los parámetros. El siguiente fragmento de código procede del ejemplo DirectQueryForSQL .

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"
];