Hue Datagate (préversion)

Datagate est une plateforme de gestion des données Software-as-a-Service à partir d’applications Works qui fournit aux utilisateurs une méthode simplifiée pour le stockage, la gestion et la génération d’insights à partir de leurs données métier. Ce connecteur vous permet de tirer parti de vos données métier sur Datagate à partir de Power Platform.

Ce connecteur est disponible dans les produits et régions suivants :

Datagate est une plateforme de gestion des données Software-as-a-Service à partir d’applications Works qui fournit aux utilisateurs une méthode simplifiée pour le stockage, la gestion et la génération d’insights à partir de leurs données métier. Il peut servir de plateforme centralisée pour stocker des données et gérer

Ce connecteur fournit une API pour vous permettre d’accéder à vos données métier sur Datagate à partir de Power Platform.

Prerequisites

Pour utiliser ce connecteur, vous avez besoin des éléments suivants :

• une clé API Datagate avec accès à l’API OData.
• informations d’identification d’un rôle Datagate (ID de rôle, secret de rôle) avec accès à la table souhaitée.
• Compte d’utilisateur Datagate, pour accéder au générateur de requêtes sur Datagate.

Comment obtenir des informations d’identification

Il existe deux couches d’authentification et d’autorisation pour accéder à une table sur Datagate, à savoir la clé d’API Datagate et le rôle Datagate. Vous trouverez ci-dessous des étapes simplifiées pour obtenir les informations d’identification de clé API Datagate et de rôle Datagate. Pour plus d’informations, consultez le manuel Datagate sur @SUPPORT, ou contactez nos consultants.

Pour obtenir la clé API Datagate :

1. Connectez-vous à l’écran Datagate.
2. Accédez à la page Gestion des clés d’API. Le bouton Clé API est disponible dans la barre de navigation gauche de la page. Cliquez sur l’icône de clé et sélectionnez « Gestion des clés API » pour accéder à la page Gestion des clés API.
3. Cliquez sur le bouton Créer une clé API en haut à droite de la page.
4. La page Modifier l’API s’affiche avec des champs vides.
5. Dans la section Informations sur la clé API, renseignez la description souhaitée.
6. Sélectionnez les autorisations souhaitées pour accorder la clé API.
7. Cliquez sur le bouton « Enregistrer la clé API » en haut à droite de la page pour créer la clé API souhaitée.

Pour obtenir les informations d’identification de rôle Datagate :

1. Connectez-vous à l’écran Datagate.
2. Accédez à la page Gestion des rôles. Le lien Gestion des rôles est disponible dans la barre de navigation gauche de la page. Cliquez sur l’icône de tableau et sélectionnez « Gestion des rôles » pour accéder à la page Gestion des rôles.
3. Cliquez sur le bouton Créer un rôle en haut à droite de la page.
4. La page Créer un rôle s’affiche.
5. Dans la section informations sur le rôle, renseignez le nom du rôle souhaité et sélectionnez le type d’autorisation.
6. Sélectionnez les autorisations souhaitées pour donner le rôle dans le schéma ou la liste de tables.
7. Cliquez sur le bouton « Enregistrer le rôle » en haut à droite de la page pour créer un rôle et obtenir les informations d’identification de rôle souhaitées.

Bien démarrer avec votre connecteur

Il existe actuellement une API disponible pour l’utilisation, l’API OData, qui autoriserait l’accès en lecture aux données de table sur Datagate. Par le biais de la requête OData Datagate, vous pouvez définir les colonnes à sélectionner, trier l’ordre, les paramètres requis sont la chaîne de requête et les informations d’identification de rôle d’un rôle qui a accès à la table. Reportez-vous à la section précédente « Comment obtenir des informations d’identification » pour connaître les étapes permettant d’acquérir les informations d’identification de clé API et de rôle requises. Pour obtenir une chaîne de requête, reportez-vous aux étapes suivantes.

1. Dans l’écran Datagate, recherchez la table souhaitée dans la page Liste des tables.
2. Ouvrez la page Visionneuse de données de la table souhaitée.
3. Définissez les paramètres souhaités et copiez la chaîne de requête résultante.

Envoyer un rapport quotidien par e-mail

À l’aide du connecteur Datagate, créez un flux Power qui envoie automatiquement un rapport de ventes quotidien

1. Préparez la clé API à utiliser. (Reportez-vous à la section précédente « Comment obtenir des informations d’identification »)
2. Préparer le rôle (ID de rôle et secret de rôle). (Reportez-vous à la section précédente « Comment obtenir des informations d’identification »)
3. Obtenez la requête de la table de sortie.
4. Créez un flux cloud planifié.
5. Définissez la planification souhaitée.
6. Vérifiez que le jeu de planifications est correct.
7. Ajoutez une étape pour obtenir l’heure de date actuelle et convertissez du fuseau horaire UTC au fuseau horaire souhaité.
8. Ajouter l’étape de l’API OData. Il est possible de générer des chaînes de requête dynamiques en insérant des variables dans la chaîne de requête.
9. Ajouter une étape de conversion JSON. Générez le schéma à l’aide d’un exemple de charge utile JSON.
10. Ajoutez une étape pour créer une table HTML.
11. Ajoutez une étape pour envoyer un e-mail, puis entrez le corps de l’e-mail souhaité, puis enregistrez le connecteur. Vous pouvez choisir de tester le flux en l’exécutant manuellement.
12. L’e-mail est envoyé au format suivant selon la planification définie.

Problèmes connus et limitations

La taille maximale des données pouvant être retournées est de 6 Mo par appel d’API.

Si la taille du jeu de données demandée est supérieure à 6 Mo, l’appel d’API retourne une erreur « 413 Payload Too Large ».

Erreurs courantes et solutions

Il n’existe actuellement qu’une seule API sur le connecteur, l’API OData. Voici quelques-unes des erreurs possibles qui peuvent être rencontrées lors de l’utilisation de l’API.

200 OK

« relation « public_view.table_name » n’existe pas »

La table n’existe peut-être plus. Vérifiez si la table est accessible via la visionneuse de données de Datagate.

« Impossible d’analyser le filtre (XXX) » (ligne X, colonne X) »

Il existe un problème avec la requête fournie. Vérifiez si la requête a été copiée correctement à partir de l’écran Datagate.

413 Charge utile trop grande

Il existe une limite de 6 Mo pour la taille de charge utile de l’API OData. Définissez une limite inférieure au nombre de lignes en définissant le paramètre « limit » dans la requête OData.

500 Erreur interne du serveur

Impossible d’établir la connexion au serveur. Vérifiez auprès de nos consultants si le problème persiste.

Questions fréquentes (FAQ)

Voici les questions courantes des utilisateurs Datagate. Pour les questions non abordées ici ou pour plus d’informations, reportez-vous au manuel Datagate disponible sur la plateforme Works Applications @SUPPORT , sinon contactez nos consultants.

Comment obtenir des données de table externes à partir du connecteur ?

Accédez à la page de visionneuse de données de la table externe souhaitée et obtenez la chaîne de requête appropriée à partir du générateur de requêtes.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

Actions

OData API