HUE Datagate (Vorschau)

Datagate ist eine Software-as-a-Service-Datenverwaltungsplattform aus Works Applications, die Benutzern eine optimierte Methode zum Speichern, Verwalten und Generieren von Erkenntnissen aus ihren Geschäftsdaten bietet. Mit diesem Connector können Sie Ihre Geschäftsdaten auf Datagate von der Power Platform nutzen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Datagate ist eine Software-as-a-Service-Datenverwaltungsplattform aus Works Applications, die Benutzern eine optimierte Methode zum Speichern, Verwalten und Generieren von Erkenntnissen aus ihren Geschäftsdaten bietet. Sie kann als zentrale Plattform zum Speichern und Verwalten von Daten dienen.

Dieser Connector stellt eine API für den Zugriff auf Ihre Geschäftsdaten auf Datagate von der Power Platform bereit.

Voraussetzungen

Um diesen Connector zu verwenden, benötigen Sie die folgenden Elemente:

• einen Datagate-API-Schlüssel mit Zugriff auf die OData-API.
• Anmeldeinformationen einer Datagate-Rolle (Rollen-ID, Rollengeheimnis) mit Zugriff auf die gewünschte Tabelle.
• Datagate-Benutzerkonto, um auf den Abfrage-Generator auf Datagate zuzugreifen.

So erhalten Sie Anmeldeinformationen

Es gibt zwei Ebenen der Authentifizierung und Autorisierung für den Zugriff auf eine Tabelle in Datagate, nämlich die Datagate-API-Schlüssel- und Datagate-Rolle. Im Folgenden finden Sie vereinfachte Schritte zum Abrufen der Datagate-API-Schlüssel- und Datagate-Rollenanmeldeinformationen. Weitere Informationen finden Sie im Datagate-Handbuch unter @SUPPORT, oder wenden Sie sich an unsere Berater.

So rufen Sie Datagate-API-Schlüssel ab:

1. Melden Sie sich auf dem Datagate-Bildschirm an.
2. Wechseln Sie zur Seite "API-Schlüsselverwaltung". Die Schaltfläche "API-Schlüssel" ist auf der linken Navigationsleiste der Seite verfügbar. Klicken Sie auf das Schlüsselsymbol, und wählen Sie "API-Schlüsselverwaltung" aus, um zur API-Schlüsselverwaltungsseite zu navigieren.
3. Klicken Sie oben rechts auf der Seite auf die Schaltfläche "API-Schlüssel erstellen".
4. Die Seite "API bearbeiten" wird mit leeren Feldern angezeigt.
5. Füllen Sie im Abschnitt "API Key info" die gewünschte Beschreibung aus.
6. Wählen Sie die gewünschten Berechtigungen aus, um den API-Schlüssel zu erteilen.
7. Klicken Sie oben rechts auf der Seite auf die Schaltfläche "API-Schlüssel speichern", um den gewünschten API-Schlüssel zu erstellen.

So rufen Sie Datagate-Rollenanmeldeinformationen ab:

1. Melden Sie sich auf dem Datagate-Bildschirm an.
2. Wechseln Sie zur Rollenverwaltungsseite. Der Link "Rollenverwaltung" ist auf der linken Navigationsleiste der Seite verfügbar. Klicken Sie auf das Tabellensymbol, und wählen Sie "Rollenverwaltung" aus, um zur Rollenverwaltungsseite zu navigieren.
3. Klicken Sie oben rechts auf der Seite auf die Schaltfläche "Rolle erstellen".
4. Die Seite "Rolle erstellen" wird angezeigt.
5. Geben Sie im Abschnitt "Rolleninformationen" den gewünschten Rollennamen ein, und wählen Sie den Berechtigungstyp aus.
6. Wählen Sie die gewünschten Berechtigungen aus, um der Rolle aus der Schema- oder Tabellenliste zuzuweisen.
7. Klicken Sie oben rechts auf der Seite auf die Schaltfläche "Rolle speichern", um eine neue Rolle zu erstellen und die gewünschten Rollenanmeldeinformationen abzurufen.

Erste Schritte mit Ihrem Connector

Derzeit ist eine API für die Verwendung verfügbar, die OData-API, die Lesezugriff auf Tabellendaten auf Datagate ermöglicht. Über die Datagate-OData-Abfrage können Sie festlegen, welche Spalten ausgewählt, sortiert werden sollen, Die erforderlichen Parameter sind die Abfragezeichenfolge und Rollenanmeldeinformationen einer Rolle, die Zugriff auf die Tabelle hat. Im vorherigen Abschnitt "Abrufen von Anmeldeinformationen" finden Sie die Schritte zum Abrufen der erforderlichen API-Schlüssel- und Rollenanmeldeinformationen. Informationen zum Abrufen einer Abfragezeichenfolge finden Sie in den folgenden Schritten.

1. Suchen Sie auf dem Datagate-Bildschirm auf der Tabellenlistenseite nach der gewünschten Tabelle.
2. Öffnen Sie die Datenanzeigeseite der gewünschten Tabelle.
3. Legen Sie die gewünschten Parameter fest, und kopieren Sie die resultierende Abfragezeichenfolge.

Täglichen Bericht per E-Mail senden

Erstellen Sie mithilfe des Datagate-Connectors einen Stromfluss, der täglich einen Verkaufsbericht sendet.

1. Bereiten Sie den zu verwendenden API-Schlüssel vor. (Weitere Informationen finden Sie im vorherigen Abschnitt "Abrufen von Anmeldeinformationen")
2. Vorbereiten der Rolle(Rollen-ID und geheimer Rollenschlüssel). (Weitere Informationen finden Sie im vorherigen Abschnitt "Abrufen von Anmeldeinformationen")
3. Rufen Sie die Abfrage für die Ausgabetabelle ab.
4. Erstellen Sie einen geplanten Cloudfluss.
5. Legen Sie den gewünschten Zeitplan fest.
6. Stellen Sie sicher, dass der Zeitplansatz korrekt ist.
7. Fügen Sie Schritt hinzu, um die aktuelle Uhrzeit abzurufen, und konvertieren Sie von der UTC-Zeitzone in die gewünschte Zeitzone.
8. Fügen Sie OData-API-Schritt hinzu. Es ist möglich, dynamische Abfragezeichenfolgen durch Einfügen von Variablen in die Abfragezeichenfolge zu generieren.
9. Fügen Sie den JSON-Konvertierungsschritt hinzu. Generieren Sie das Schema mithilfe einer JSON-Beispielnutzlast.
10. Fügen Sie Schritt zum Erstellen einer HTML-Tabelle hinzu.
11. Fügen Sie Schritt zum Senden von E-Mails hinzu, und geben Sie den gewünschten E-Mail-Textkörper ein, und speichern Sie dann den Connector. Sie können den Fluss testen, indem Sie ihn manuell ausführen.
12. Die E-Mail würde im folgenden Format im definierten Zeitplan gesendet.

Bekannte Probleme und Einschränkungen

Die maximale Größe der rückgabefähigen Daten beträgt 6 MB pro API-Aufruf.

Wenn die angeforderte Datasetgröße größer als 6 MB ist, wird der API-Aufruf mit einem Fehler "413 Payload Too Large" zurückgegeben.

Häufige Fehler und Abhilfemaßnahmen

Derzeit gibt es nur eine API für den Connector, die OData-API. Im Folgenden finden Sie einige der möglichen Fehler, die bei der Verwendung der API auftreten können.

200 OK (Anforderung erfolgreich)

"Relation "public_view.table_name" ist nicht vorhanden"

Die Tabelle ist möglicherweise nicht mehr vorhanden. Überprüfen Sie, ob auf die Tabelle über den Datenanzeiger von Datagate zugegriffen werden kann.

"Fehler beim Analysieren des Filters (XXX)" (Zeile X, Spalte X)"

Es gibt ein Problem mit der bereitgestellten Abfrage. Vergewissern Sie sich, ob die Abfrage korrekt vom Datagate-Bildschirm kopiert wurde.

413 Nutzlast zu groß

Es gibt eine Beschränkung von 6 MB für die Nutzlastgröße aus der OData-API. Legen Sie einen niedrigeren Grenzwert auf die Zeilenanzahl fest, indem Sie den Parameter "limit" in der OData-Abfrage festlegen.

500: Interner Serverfehler

Die Verbindung mit dem Server konnte nicht hergestellt werden. Wenden Sie sich an unsere Berater, wenn das Problem weiterhin besteht.

Häufig gestellte Fragen

Im Folgenden finden Sie häufig gestellte Fragen von Datagate-Benutzern. Für Fragen, die hier nicht behandelt werden oder um weitere Details zu erhalten, wenden Sie sich bitte an das Datagate-Handbuch, das auf der Plattform von Works Applications @SUPPORT zur Verfügung steht, sonst wenden Sie sich an unsere Berater.

Wie erhalte ich externe Tabellendaten aus dem Connector?

Greifen Sie auf die Datenanzeigeseite der gewünschten externen Tabelle zu, und rufen Sie die relevante Abfragezeichenfolge aus dem Abfrage-Generator ab.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Drosselungsgrenzwerte

Aktionen

OData-API