Freigeben über

Verarbeitung des Datenzugriffs

Datenquellenfunktionen

Ein Datenconnector umschließt und passt das Verhalten einer Datenquellenfunktion in der M-Bibliothek an. Beispielsweise würde eine Erweiterung für eine REST-API die Web.Contents-Funktion verwenden, um HTTP-Anforderungen zu stellen. Derzeit wurde eine begrenzte Gruppe von Datenquellenfunktionen aktiviert, um die Erweiterbarkeit zu unterstützen.

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;

Datenquellentyp

Funktionen, die als shared in der Erweiterung gekennzeichnet sind, können einer bestimmten Datenquelle zugeordnet werden, indem sie ein DataSource.Kind Literal-Attribut für die Funktion mit dem Namen eines Datenquellendefinitionsdatensatzes einschließen. Das Datenquellenprotokoll definiert die von Ihrer Datenquelle unterstützten Authentifizierungstypen und grundlegende Brandinginformationen (z. B. Anzeigename/Bezeichnung). Der Name des Datensatzes wird zu seinem eindeutigen Bezeichner.

Jede Funktion, die derselben Datenquelle zugeordnet ist, muss über dieselben erforderlichen Funktionsparameter verfügen, einschließlich Name, Typ und Reihenfolge. (Für Zwecke der Datenquellenart gilt ein Parameter nicht als erforderlich, wenn er markiert optional ist oder seine Metadaten enthalten DataSource.Path = false.)

Funktionen für einen bestimmten Datentyp können nur Anmeldeinformationen verwenden, die diesem Typ zugeordnet sind. Zugangsdaten werden während der Laufzeit ermittelt, indem ein Nachschlagevorgang basierend auf der Kombination der für die Funktion erforderlichen Parameter ausgeführt wird. Weitere Informationen dazu, wie Anmeldeinformationen identifiziert werden, finden Sie unter Datenquellenpfade.

Example:

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

Eigenschaften

In der folgenden Tabelle sind die Felder für den Datenquellendefinitionsdatensatz aufgeführt.

Feld Typ Einzelheiten
Authentifizierung Datensatz (record) Gibt einen oder mehrere Authentifizierungstypen an, die von Ihrer Datenquelle unterstützt werden. Mindestens eine Art ist erforderlich. Jede Art wird als Option in der Power Query-Anmeldeinformationsaufforderung angezeigt. Weitere Informationen finden Sie unter Authentifizierungstypen.
Etikett Text (optional) Freundlicher Anzeigename für diese Erweiterung in Anmeldeinformationsdialogfeldern.
UnterstütztVerschlüsselung logisch (optional) Wenn true, stellt die Benutzeroberfläche die Option zum Herstellen einer Verbindung mit der Datenquelle mithilfe einer verschlüsselten Verbindung dar. Dies wird in der Regel für Datenquellen mit einem nicht verschlüsselten Fallbackmechanismus (im Allgemeinen ODBC- oder ADO.NET-basierten Quellen) verwendet.

Veröffentlichen in der Benutzeroberfläche

Ähnlich wie der Datensatz der Datenquellendefinition stellt der Veröffentlichen-Datensatz der Power Query-Benutzeroberfläche die Informationen bereit, die erforderlich sind, um diese Erweiterung im Dialogfeld Daten abrufen verfügbar zu machen.

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

Eigenschaften

In der folgenden Tabelle sind die Felder für Ihren Veröffentlichungsdatensatz aufgeführt.

Feld Typ Einzelheiten
ButtonText Liste Liste der Textelemente. Das erste Element definiert den Namen, der neben dem Symbol der Datenquelle im Power BI-Dialogfeld "Daten abrufen " angezeigt wird. Das zweite Element (optional) definiert die QuickInfo, die angezeigt wird, wenn der vorherige Name mit der Maus darübergefahren wird.
Kategorie Text Wo die Erweiterung im Dialogfeld "Daten abrufen " angezeigt werden soll. Derzeit sind die einzigen Kategoriewerte mit spezieller Behandlung Azure und Database. Alle anderen Werte werden unter der Kategorie "Sonstige" angezeigt.
Beta logisch (optional) Wenn dieser Wert auf "true" festgelegt ist, zeigt die Benutzeroberfläche neben dem Connector-Namen einen Vorschau-/Beta-Hinweis und ein Warnhinweis an, der darauf hinweist, dass die Implementierung des Connectors Änderungen unterworfen sein könnte, die die Funktionalität beeinträchtigen.
LearnMoreUrl Text (optional) URL zu Website, die weitere Informationen zu dieser Datenquelle oder zu diesem Connector enthält.
SupportsDirectQuery (Direktabfrage unterstützen) logisch (optional) Aktiviert Direct Query für Ihre Erweiterung.
SourceImage Datensatz (record) (optional) Ein Datensatz, der eine Liste von binären Bildern enthält, die mithilfe der Extension.Contents-Methode aus der Erweiterungsdatei bezogen werden. Der Datensatz enthält zwei Felder (Icon16, Icon32), die jeweils eine eigene Liste haben. Jedes Symbol sollte eine andere Größe aufweisen.
SourceTypeImage Datensatz (record) (optional) Ähnlich wie SourceImage, mit der Ausnahme, dass es bei vielen Standard-Connectors üblich ist, ein Blattsymbol mit dem quellspezifischen Symbol in der unteren rechten Ecke anzuzeigen. Ein anderer Satz von Symbolen für SourceTypeImage ist optional – viele Erweiterungen verwenden einfach denselben Satz von Symbolen für beide Felder.
  • Last updated on