HUE Datagate (preview)

Datagate is een Software-as-a-Service-gegevensbeheerplatform van Works Applications dat gebruikers een gestroomlijnde methode biedt voor het opslaan, beheren en genereren van inzichten op basis van hun bedrijfsgegevens. Met deze connector kunt u uw bedrijfsgegevens op Datagate gebruiken vanuit het Power Platform.

Deze connector is beschikbaar in de volgende producten en regio's:

Datagate is een Software-as-a-Service-gegevensbeheerplatform van Works Applications dat gebruikers een gestroomlijnde methode biedt voor het opslaan, beheren en genereren van inzichten op basis van hun bedrijfsgegevens. Het kan fungeren als een gecentraliseerd platform voor het opslaan van gegevens en het beheren van gegevens

Deze connector biedt een API voor toegang tot uw bedrijfsgegevens op Datagate vanuit het Power Platform.

Vereiste voorwaarden

Als u deze connector wilt gebruiken, hebt u het volgende nodig:

• een Datagate-API-sleutel met toegang tot OData-API.
• De referenties van een Datagate-rol (rol-id, rolgeheim) met toegang tot de gewenste tabel.
• Datagate-gebruikersaccount voor toegang tot de opbouwfunctie voor query's in Datagate.

Referenties ophalen

Er zijn twee lagen verificatie en autorisatie voor toegang tot een tabel in Datagate, namelijk de datagate-API-sleutel en de rol Datagate. Hieronder ziet u vereenvoudigde stappen om de referenties voor de Datagate-API-sleutel en de Datagate-rol te verkrijgen. Raadpleeg de Datagate-handleiding voor meer informatie of @SUPPORTneem contact op met onze consultants.

Datagate-API-sleutel verkrijgen:

1. Meld u aan bij het Datagate-scherm.
2. Ga naar de pagina API-sleutelbeheer. De knop API-sleutel is beschikbaar op de linkernavigatiebalk van de pagina. Klik op het sleutelpictogram en selecteer API Key Management om naar de pagina API-sleutelbeheer te gaan.
3. Klik op de knop API-sleutel maken rechtsboven op de pagina.
4. De pagina API bewerken wordt weergegeven met lege velden.
5. Vul in de sectie API-sleutelgegevens de gewenste beschrijving in.
6. Selecteer de gewenste machtigingen om de API-sleutel te verlenen.
7. Klik op de knop API-sleutel opslaan rechtsboven op de pagina om de gewenste API-sleutel te maken.

Gegevensgate-rolreferenties verkrijgen:

1. Meld u aan bij het Datagate-scherm.
2. Ga naar de pagina Rolbeheer. De koppeling Rolbeheer is beschikbaar op de linkernavigatiebalk van de pagina. Klik op het tabelpictogram en selecteer Rolbeheer om naar de pagina Rolbeheer te gaan.
3. Klik op de knop Rol maken rechtsboven op de pagina.
4. De pagina Rol maken wordt weergegeven.
5. Vul in de sectie Informatie over rollen de gewenste rolnaam in en selecteer het machtigingstype.
6. Selecteer de gewenste machtigingen om de rol uit het schema of de tabellijst te geven.
7. Klik op de knop Rol opslaan in de rechterbovenhoek van de pagina om een nieuwe rol te maken en de gewenste rolreferenties op te halen.

Aan de slag met uw connector

Er is momenteel één API beschikbaar voor gebruik, de OData-API, die leestoegang tot tabelgegevens op Datagate toestaat. Via de Datagate OData-query kunt u de kolommen instellen die moeten worden geselecteerd, sorteervolgorde, de vereiste parameters zijn de querytekenreeks en rolreferenties van een rol die toegang heeft tot de tabel. Raadpleeg de vorige sectie 'Referenties ophalen' voor de stappen voor het verkrijgen van de vereiste API-sleutel en rolreferenties. Raadpleeg de volgende stappen om een queryreeks te verkrijgen.

1. Zoek in het Datagate-scherm naar de gewenste tabel op de pagina Tabellenlijst.
2. Open de pagina Gegevensviewer van de gewenste tabel.
3. Stel de gewenste parameters in en kopieer de resulterende querytekenreeks.

Dagelijks rapport verzenden via e-mail

Met behulp van de Connector van Datagate maakt u een Power-stroom waarmee automatisch dagelijks een verkooprapport wordt verzonden

1. Bereid de API-sleutel voor die moet worden gebruikt. (Raadpleeg de vorige sectie 'Referenties ophalen')
2. Rol(rol-id en rolgeheim voorbereiden). (Raadpleeg de vorige sectie 'Referenties ophalen')
3. Haal de query voor de uitvoertabel op.
4. Maak een geplande cloudstroom.
5. Stel de gewenste planning in.
6. Controleer of de planningsset juist is.
7. Voeg een stap toe om de huidige datum/tijd op te halen en converteer deze van UTC-tijdzone naar de gewenste tijdzone.
8. Voeg de OData-API-stap toe. Het is mogelijk om dynamische queryreeksen te genereren door variabelen in de querytekenreeks in te voegen.
9. Voeg de stap JSON-conversie toe. Genereer het schema met behulp van een JSON-voorbeeldpayload.
10. Voeg een stap toe om een HTML-tabel te maken.
11. Voeg de stap toe om e-mail te verzenden en voer de gewenste hoofdtekst van de e-mail in en sla de connector op. U kunt ervoor kiezen om de stroom te testen door deze handmatig uit te voeren.
12. Het e-mailbericht wordt verzonden in de volgende indeling volgens de gedefinieerde planning.

Bekende problemen en beperkingen

De maximale grootte van retourneerde gegevens is 6 MB per API-aanroep.

Als de aangevraagde gegevensset groter is dan 6 MB, wordt de API-aanroep geretourneerd met de fout '413 Payload Too Large'.

Veelvoorkomende fouten en oplossingen

Er is momenteel slechts één API op de connector, de OData-API. Hier volgen enkele van de mogelijke fouten die kunnen worden weergegeven tijdens het gebruik van de API.

200 Akkoord

"relation "public_view.table_name" bestaat niet"

De tabel bestaat mogelijk niet meer. Controleer of de tabel toegankelijk is via de gegevensviewer van Datagate.

""Kan filter niet parseren (XXX)" (regel X, kolom X)"

Er is een probleem met de opgegeven query. Controleer of de query correct is gekopieerd uit het Datagate-scherm.

413 Nettolading te groot

Er geldt een limiet van 6 MB voor de nettoladinggrootte van de OData-API. Stel een lagere limiet in op het aantal rijen door de parameter 'limiet' in te stellen in de OData-query.

500 Interne Serverfout

De verbinding met de server kan niet tot stand worden gebracht. Neem contact op met onze consultants als het probleem zich blijft voordoen.

Veelgestelde vragen

Hier volgen veelgestelde vragen van Datagate-gebruikers. Voor vragen die hier niet worden behandeld of voor meer informatie raadpleegt u de Datagate-handleiding die beschikbaar is op het platform van Works Applications @SUPPORT . Neem anders contact op met onze consultants.

Hoe krijg ik externe tabelgegevens van de connector?

Open de pagina voor de gegevensviewer van de gewenste externe tabel en haal de relevante queryreeks op uit de opbouwfunctie voor query's.

Een verbinding maken

De connector ondersteunt de volgende authenticatietypen:

Verstek

Toepasbaar: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de Power-app met een andere gebruiker wordt gedeeld, wordt die andere gebruiker expliciet gevraagd om een nieuwe verbinding te maken.

Beperkingslimieten

Acties

OData-API