Gestione dell'accesso ai dati

Funzioni origine dati

Un Connessione or dati esegue il wrapping e personalizza il comportamento di una funzione dell'origine dati nella libreria M. Ad esempio, un'estensione per un'API REST userebbe la funzione Web.Contents per effettuare richieste HTTP. Attualmente, è stato abilitato un set limitato di funzioni di origine dati per supportare l'estendibilità.

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

Esempio:

[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;

Tipologia di origine dati

Le funzioni contrassegnate come shared nell'estensione possono essere associate a un'origine dati specifica includendo un DataSource.Kind attributo letterale nella funzione con il nome di un record di definizione dell'origine dati. Il record origine dati definisce i tipi di autenticazione supportati dall'origine dati e le informazioni di personalizzazione di base, ad esempio il nome visualizzato/etichetta. Il nome del record diventa l'identificatore univoco.

Ogni funzione associata alla stessa origine dati deve avere gli stessi parametri di funzione richiesti, tra cui nome, tipo e ordine. Ai fini del tipo di origine dati, un parametro non viene considerato obbligatorio se è contrassegnato optional o se i relativi metadati contengono DataSource.Path = false.

Le funzioni per un tipo di origine dati specifico possono usare solo le credenziali associate a tale tipo. Le credenziali vengono identificate in fase di esecuzione eseguendo una ricerca in base alla combinazione dei parametri obbligatori della funzione. Per altre informazioni sulla modalità di identificazione delle credenziali, vedere Percorsi origine dati.

Esempio:

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

Proprietà

Nella tabella seguente sono elencati i campi per il record di definizione dell'origine dati.

Pubblica nell'interfaccia utente

Analogamente al record di definizione dell'origine dati, il record Publish fornisce all'interfaccia utente di Power Query le informazioni necessarie per esporre questa estensione nella finestra di dialogo Recupera dati.

Esempio:

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

Proprietà

Nella tabella seguente sono elencati i campi per il record publish.