Compartir a través de

AlisQI (versión preliminar)

Integre su QMS con su ERP, MES, PLM, instrumentos, sensores o sitio web mediante las herramientas de conectividad de AlisQI.

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

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Soporte técnico de AlisQI
URL https://help.alisqi.com/
Correo Electrónico support@alisqi.com
Metadatos del conector
Publicador AlisQI BV
Sitio web https://www.alisqi.com
Directiva de privacidad https://www.alisqi.com/en/privacy-statement
Categorías Gestión empresarial

AlisQI

Integre su QMS con su ERP, MES, PLM, instrumentos, sensores o sitio web mediante las herramientas de conectividad de AlisQI.

Publicador: AlisQI B.V.

Prerrequisitos

Para usar este conector, necesitará lo siguiente:

  • Una cuenta con AlisQI.
  • Una vez que se haya registrado y tenga una aplicación, obtenga la clave de API desde el portal en línea; usará esta clave para autenticar sus solicitudes desde nuestro conector AlisQI.

Operaciones admitidas

El conector admite las siguientes operaciones:

  • Obtener resultados o datos /getResults maestros: obtener (calidad) resultados de conjuntos de análisis o datos maestros de listas de selección.

  • Obtener todos los conjuntos de análisis o listas /getAllSetsde selección: obtener una lista de (todos) conjuntos de análisis o listas de selección.

  • Crear o actualizar resultados o datos /storeResultsmaestros: cree o actualice los resultados de calidad en conjuntos de análisis o datos maestros en listas de selección.

  • Obtener estadísticas descriptivas para los campos /getStatisticsdel conjunto de análisis: obtenga estadísticas descriptivas para los campos de conjuntos de análisis numéricos que prefiera.

  • Obtener estadísticas de funcionalidad para los campos /getSpecificationEvaluationdel conjunto de análisis: obtenga estadísticas detalladas de la capacidad de evaluación y proceso de especificación para los campos numéricos de un conjunto de análisis.

  • Obtener versiones /getSpecificationVersionde especificación: obtener (a) versiones de especificación para un conjunto de análisis.

  • Crear una nueva versión /storeSpecificationVersionde especificación: cree (a) nuevas versiones de especificación para un conjunto de análisis.

  • Obtener la estructura de un conjunto de análisis o una lista /getSetDefinitionde selección: obtenga la definición estructural de un conjunto de análisis o listas de selección.

Obtención de credenciales

  • Todas las llamadas API están sujetas a autenticación. Para invocar los puntos de conexión de la API AlisQI, los desarrolladores deben crear un token de autenticación.

  • La API admite la especificación de autenticación bearer.

  • Cada token está conectado a un único usuario. El permiso Leer, Insertar y Actualizar que este usuario tiene para conjuntos de análisis (a través de su grupo de usuarios), también se aplica a las invocaciones de API. Más información sobre la administración de permisos y usuarios en AlisQI.

  • Los tokens de autenticación de API se pueden crear en el centro de integración desde la aplicación. Se recomienda usar tokens dedicados por escenario de integración.

  • Como alternativa, si el método de autenticación Bearer no está disponible, las solicitudes se pueden autenticar mediante el parámetro &accessToken=abc...123accessToken URL .

Problemas conocidos y limitaciones

  • Filtros: las operaciones con un parámetro de filtro esperan una cadena JSON que representa el filtro. Use el centro de integración en la aplicación para crear un filtro y copiar la cadena JSON.

  • Fechas: todas las fechas y horas están en UTC (con yyyy-mm-dd hh:mm:ssel formato ), y todas las cadenas se codifican mediante UTF-8.

  • Almacenamiento en caché: la operación getResults admite la validación de caché mediante ETag y encabezados Last-Modified. Se recomienda habilitar el almacenamiento en caché en los clientes y realizar solicitudes condicionales para reducir la latencia, la carga del servidor y el uso de energía.

  • Límites de uso: anteriormente hemos visto una degradación del rendimiento debido a la sobrecarga de la API. Para proteger la estabilidad de nuestros límites de uso de la plataforma se aplican a la API. Estos límites están diseñados para evitar cargas no deseadas en nuestros sistemas de integraciones de API mal configuradas o abusos. El límite de velocidad tiene como valor predeterminado 30 llamadas por minuto. Esto se aplica a las operaciones de lectura y escritura. Las solicitudes que alcanzan el límite de velocidad tendrán un código de estado de 429 Too many requests.

Todas las respuestas incluyen los siguientes encabezados con números explícitos en los límites y las llamadas restantes:

  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit:Retry-After

Para depurar problemas en los escenarios de integración que son o pueden deberse a límites de velocidad, consulte esta lista de comprobación:

  • Consulte a su especialista en integración para inspeccionar las llamadas API y devolver encabezados.
  • Abra el centro de integración alisQI para obtener información sobre el límite de velocidad concreto aplicado a la instalación.
  • Inspeccione el registro de API en el centro de integración alisQI para determinar el número de solicitudes por minuto.
  • Inspeccione los encabezados devueltos de la solicitud de API para ver si contienen el código de 429 Too many requests estado.
  • Inspeccione los encabezados de devolución de solicitud de API individuales para evaluar .X-RateLimit-* headers
  • Evalúe si puede mejorar la integración reduciendo las solicitudes duplicadas o combinando varios resultados en una sola llamada storeResults. No dude en ponerse en contacto con el soporte técnico de AlisQI para analizar las funcionalidades de nuestra API sobre el almacenamiento en caché y el procesamiento de varios resultados.
  • Si su escenario de integración está optimizado pero requiere legítimamente más llamadas por minutos, póngase en contacto con el soporte técnico de AlisQI para discutir las posibilidades para aumentar el límite.

Instrucciones de implementación

Use estas instrucciones para implementar este conector como conector personalizado en Microsoft Flow y PowerApps.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

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.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Creación de una nueva versión de especificación

Cree (a) nuevas versiones de especificación para un conjunto de análisis.
Crear o actualizar resultados o datos maestros

Crear o actualizar resultados de calidad en conjuntos de análisis o datos maestros en listas de selección.
Obtención de estadísticas de funcionalidad para los campos del conjunto de análisis

Obtenga estadísticas detalladas de la capacidad de evaluación y proceso de especificación para los campos numéricos de un conjunto de análisis.
Obtención de estadísticas descriptivas para los campos del conjunto de análisis

Obtenga estadísticas descriptivas para los campos de conjuntos de análisis numéricos que prefiera.
Obtención de resultados o datos maestros

Obtiene (calidad) los resultados de conjuntos de análisis o datos maestros de listas de selección.
Obtener la estructura de un conjunto de análisis o una lista de selección

Obtiene la definición estructural de un conjunto de análisis o listas de selección.
Obtener todos los conjuntos de análisis o listas de selección

Obtenga una lista de (todos) conjuntos de análisis o listas de selección.
Obtener versiones de especificación

Obtiene (a) versiones de especificación para un conjunto de análisis.

Creación de una nueva versión de especificación

Id. de la operación:
CreateANewSpecificationVersion

Cree (a) nuevas versiones de especificación para un conjunto de análisis.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True string

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Especificaciones
 specs True string

Objeto JSON como una cadena.
Valor de índice
 indexValue string

Valor del campo de índice.
Fecha y hora de inicio
 startDateTime string

Con formato aaaa-mm-dd hh:mm:ss o unix stimestamp.
Motivo
 reason string

Motivo para cambiar la especificación.

Devoluciones

response
boolean

Crear o actualizar resultados o datos maestros

Id. de la operación:
CreateOrUpdateResultsOrMasterData

Crear o actualizar resultados de calidad en conjuntos de análisis o datos maestros en listas de selección.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True string

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Results
 results True string

Objeto JSON como una cadena.
Campo de clave
 keyField string

Busque y modifique los resultados existentes en función del valor de este campo.
Editar solo
 editOnly string

Use (solo) junto con keyField.
Agregar opciones de lista
 addListOptions string

Marca para agregar nuevas opciones a las listas.

Obtención de estadísticas de funcionalidad para los campos del conjunto de análisis

Id. de la operación:
GetCapabilityStatisticsForAnalysisSetFields

Obtenga estadísticas detalladas de la capacidad de evaluación y proceso de especificación para los campos numéricos de un conjunto de análisis.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True integer

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Fields
 fields True string

Lista separada por comas con los puntos de datos específicos que desea devolver.
Limit
 limit integer

Número máximo de resultados que se deben tener en cuenta.
Filter
 filter string

Use una cadena con formato JSON para restringir los datos que solicita, en función de condiciones específicas.

Obtención de estadísticas descriptivas para los campos del conjunto de análisis

Id. de la operación:
GetDescriptiveStatisticsForAnalysisSetFields

Obtenga estadísticas descriptivas para los campos de conjuntos de análisis numéricos que prefiera.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True integer

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Fields
 fields True string

Lista separada por comas con los puntos de datos específicos que desea devolver.
Limit
 limit integer

Número máximo de resultados que se deben tener en cuenta.
Filter
 filter string

Use una cadena con formato JSON para restringir los datos que solicita, en función de condiciones específicas.

Obtención de resultados o datos maestros

Id. de la operación:
GetResultsOrMasterData

Obtiene (calidad) los resultados de conjuntos de análisis o datos maestros de listas de selección.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True integer

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Limit
 limit integer

Especifique el número máximo de registros que desea recibir, hasta un límite de 10 000.
Desplazar
 offset integer

Elija una posición inicial para los resultados, útil para paginar los datos (el valor predeterminado es 0).
Ordenar
 sort string

Determine el orden de los datos por un campo y dirección, como date:desc para el primero más reciente.
Filter
 filter string

Use una cadena con formato JSON para restringir los datos que solicita, en función de condiciones específicas.
Fields
 fields string

Lista separada por comas con los puntos de datos específicos que desea devolver.
Incluir datos adjuntos
 includeAttachments boolean

Marque true si desea incluir datos adjuntos de archivo con los datos; de lo contrario, deje como false.
Id. de inclusión
 includeId boolean

Establézcalo en true si desea obtener los números de registro únicos del sistema para los datos, lo que facilita la administración o referencia.
Incluir fecha de última modificación
 includeLastModificationDate boolean

Active para obtener la última fecha de cambio para cada fragmento de datos, que es excelente para realizar el seguimiento de las actualizaciones más recientes.

Obtener la estructura de un conjunto de análisis o una lista de selección

Id. de la operación:
GetTheStructureOfAnAnalysisSetsOrSelectionList

Obtiene la definición estructural de un conjunto de análisis o listas de selección.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True integer

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Solo campos activos
 onlyActiveFields boolean

Indica si solo se muestran los campos activos actualmente.
Aceptar
 Accept True string

Aceptar

Obtener todos los conjuntos de análisis o listas de selección

Id. de la operación:
GetAllAnalysisSetsOrSelectionLists

Obtenga una lista de (todos) conjuntos de análisis o listas de selección.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Groups
 groups string

Escriba identificadores de grupo o nombres para buscar grupos específicos, use "Listas de selección" para obtener todos.
Names
 names string

Escriba los nombres de conjuntos de análisis o listas de selección que desea recuperar.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
id
 id integer

id
nombre
 name string

nombre
groupId
 groupId integer

groupId
groupName
 groupName string

groupName
topLevelMenu
 topLevelMenu string

topLevelMenu

Obtener versiones de especificación

Id. de la operación:
GetSpecificationVersions

Obtiene (a) versiones de especificación para un conjunto de análisis.

Parámetros

Nombre Clave Requerido Tipo Description
Subdominio
 subdomain True string

Subdominio que se va a usar para la solicitud.
Establecer id.
 setId True integer

Escriba el identificador único del conjunto de análisis que le interesa (conocido históricamente como maskid en direcciones URL).
Valor de índice
 indexValue string

Obtenga la versión de especificación actual para este valor de índice.

Definiciones

boolean

Este es el tipo de datos básico "booleano".