HUE Datagate (versión preliminar)

Datagate es una plataforma de administración de datos de software como servicio de Aplicaciones de Works que proporciona a los usuarios un método optimizado para almacenar, administrar y generar información a partir de sus datos empresariales. Este conector le permite aprovechar los datos empresariales de Datagate desde Power Platform.

Este conector está disponible en los siguientes productos y regiones:

Datagate es una plataforma de administración de datos de software como servicio de Aplicaciones de Works que proporciona a los usuarios un método optimizado para almacenar, administrar y generar información a partir de sus datos empresariales. Puede servir como una plataforma centralizada para almacenar datos y administrarlos.

Este conector proporciona una API para acceder a los datos empresariales en Datagate desde Power Platform.

Prerrequisitos

Para usar este conector, necesitará los siguientes elementos:

• una clave de API de Datagate con acceso a la API de OData.
• Credenciales de un rol de Datagate (identificador de rol, secreto de rol) con acceso a la tabla deseada.
• Cuenta de usuario de Datagate para acceder al generador de consultas en Datagate.

Obtención de credenciales

Hay dos capas de autenticación y autorización para acceder a una tabla en Datagate, es decir, la clave de API de Datagate y el rol Datagate. A continuación se muestran los pasos simplificados para obtener las credenciales de rol Datagate API y Datagate. Para obtener más información, consulte el manual de Datagate en @SUPPORT, o póngase en contacto con nuestros consultores.

Para obtener la clave de API de Datagate:

1. Inicie sesión en la pantalla Datagate.
2. Vaya a la página API Key Management. El botón Clave de API estaría disponible en la barra de navegación izquierda de la página. Haga clic en el icono de clave y seleccione "API Key Management" para ir a la página API Key Management.
3. Haga clic en el botón Crear clave de API en la parte superior derecha de la página.
4. La página Editar API se mostrará con campos vacíos.
5. En la sección Información de clave de API, rellene la descripción deseada.
6. Seleccione los permisos deseados para conceder la clave de API.
7. Haga clic en el botón "Guardar clave de API" de la parte superior derecha de la página para crear la clave de API deseada.

Para obtener las credenciales de rol de Datagate:

1. Inicie sesión en la pantalla Datagate.
2. Vaya a la página Administración de roles. El vínculo Administración de roles estaría disponible en la barra de navegación izquierda de la página. Haga clic en el icono de tabla y seleccione "Administración de roles" para ir a la página Administración de roles.
3. Haga clic en el botón Crear rol en la parte superior derecha de la página.
4. Se mostrará la página Crear rol.
5. En la sección información del rol, rellene el nombre del rol deseado y seleccione el tipo de permiso.
6. Seleccione los permisos deseados para conceder el rol en la lista de esquemas o tablas.
7. Haga clic en el botón "Guardar rol" de la parte superior derecha de la página para crear un nuevo rol y obtener las credenciales de rol deseadas.

Introducción al conector

Actualmente hay una API disponible para su uso, la API de OData, que permitiría el acceso de lectura a los datos de tabla en Datagate. A través de la consulta OData de Datagate, puede establecer las columnas que se van a seleccionar, ordenar, ordenar los parámetros necesarios son la cadena de consulta y las credenciales de rol de un rol que tiene acceso a la tabla. Consulte la sección anterior "Cómo obtener credenciales" para conocer los pasos para adquirir las credenciales de rol y la clave de API necesarias. Para obtener una cadena de consulta, consulte los pasos siguientes.

1. En la pantalla Datagate, busque la tabla deseada en la página Lista de tablas.
2. Abra la página Visor de datos de la tabla deseada.
3. Establezca los parámetros deseados y copie la cadena de consulta resultante.

Enviar informe diario a través del correo electrónico

Con el conector de Datagate, cree un flujo de energía que envíe automáticamente un informe de ventas diariamente.

1. Prepare la clave de API que se va a usar. (Consulte la sección anterior "Cómo obtener credenciales")
2. Preparar role(id. de rol y secreto de rol). (Consulte la sección anterior "Cómo obtener credenciales")
3. Obtenga la consulta de la tabla de salida.
4. Cree un flujo de nube programado.
5. Establezca la programación deseada.
6. Compruebe que el conjunto de programación es correcto.
7. Agregue el paso para obtener la fecha y hora actual y convierta de zona horaria UTC a la zona horaria deseada.
8. Agregue el paso api de OData. Es posible generar cadenas de consulta dinámicas insertando variables en la cadena de consulta.
9. Agregue el paso de conversión JSON. Genere el esquema mediante una carga JSON de ejemplo.
10. Agregue el paso para crear una tabla HTML.
11. Agregue el paso para enviar correo electrónico y escriba el cuerpo del correo electrónico deseado y, a continuación, guarde el conector. Puede optar por probar el flujo ejecutándolo manualmente.
12. El correo electrónico se enviaría en el siguiente formato en la programación definida.

Problemas y limitaciones conocidos

El tamaño máximo de los datos devueltos es de 6 MB por llamada API.

Si el tamaño del conjunto de datos solicitado es mayor que 6 MB, la llamada API devolverá un error "413 Payload Too Large".

Errores y soluciones comunes

Actualmente solo hay una API en el conector, la API de OData. A continuación se muestran algunos de los posibles errores que se pueden enfrentar al usar la API.

200 Ok

"relation "public_view.table_name" no existe"

Es posible que la tabla ya no exista. Compruebe si la tabla es accesible a través del visor de datos de Datagate.

"No se pudo analizar el filtro (XXX)" (línea X, columna X)"

Hay algún problema con la consulta proporcionada. Confirme si la consulta se ha copiado correctamente de la pantalla de Datagate.

413 Carga demasiado grande

Hay un límite de 6 MB para el tamaño de carga de la API de OData. Establezca un límite inferior en el recuento de filas estableciendo el parámetro "limit" en la consulta OData.

Error interno del servidor 500

No se pudo establecer la conexión con el servidor. Consulte con nuestros consultores si el problema persiste.

Preguntas más frecuentes

A continuación se muestran preguntas comunes de los usuarios de Datagate. Para preguntas que no se tratan aquí o para obtener más detalles, consulte el manual de Datagate disponible en la plataforma de Works Applications @SUPPORT ; de lo contrario, póngase en contacto con nuestros consultores.

¿Cómo obtengo datos de tabla externos del conector?

Acceda a la página del visor de datos de la tabla externa deseada y obtenga la cadena de consulta correspondiente del generador de consultas.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Acciones

OData API