AlisQI (préversion)
Intégrez votre QMS à votre ERP, MES, PLM, instruments, capteurs ou site web à l’aide des outils de connectivité d’AlisQI.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | AlisQI Support |
| URL | https://help.alisqi.com/ |
| Messagerie électronique | support@alisqi.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | AlisQI BV |
| Site internet | https://www.alisqi.com |
| Politique de confidentialité | https://www.alisqi.com/en/privacy-statement |
| Catégories | Gestion de l’entreprise |
AlisQI
Intégrez votre QMS à votre ERP, MES, PLM, instruments, capteurs ou site web à l’aide des outils de connectivité d’AlisQI.
Éditeur : AlisQI B.V.
Prerequisites
Pour utiliser ce connecteur, vous aurez besoin des éléments suivants :
- Un compte avec AlisQI.
- Une fois que vous êtes inscrit et que vous disposez d’une application, obtenez la clé API à partir du portail en ligne ; vous allez utiliser cette clé pour authentifier vos demandes à partir de notre connecteur AlisQI.
Opérations prises en charge
Le connecteur prend en charge les opérations suivantes :
Obtenir des résultats ou des données
/getResultsde référence : obtenir des résultats (qualité) à partir de jeux d’analyse ou de données de référence à partir de listes de sélection.Obtenir tous les jeux d’analyse ou listes
/getAllSetsde sélection : obtenir une liste de (tous) jeux d’analyse ou listes de sélection.Créer ou mettre à jour des résultats ou des données
/storeResultsde référence : créez ou mettez à jour des résultats de qualité dans des jeux d’analyse ou des données de référence dans des listes de sélection.Obtenir des statistiques descriptives pour les champs
/getStatisticsdu jeu d’analyse : obtenez des statistiques descriptives pour les champs de jeu d’analyse numérique de votre choix.Obtenir des statistiques de capacité pour les champs
/getSpecificationEvaluationdu jeu d’analyse : obtenez des statistiques détaillées sur l’évaluation des spécifications et la fonctionnalité de produit et de processus pour les champs numériques d’un jeu d’analyse.Obtenir les versions
/getSpecificationVersionde spécification : Obtenir (a) la ou les versions de spécification d’un jeu d’analyse.Créez une nouvelle version
/storeSpecificationVersionde spécification : créez (a) une ou plusieurs versions de spécification pour un jeu d’analyse.Obtenez la structure d’un jeu d’analyse ou d’une liste
/getSetDefinitionde sélection : obtenez la définition structurelle d’un jeu d’analyse ou de listes de sélection.
Obtention des informations d’identification
Tous les appels d’API sont soumis à l’authentification. Pour appeler les points de terminaison de l’API AlisQI, les développeurs doivent créer un jeton d’authentification.
L’API prend en charge la spécification d’authentification du porteur.
Chaque jeton est connecté à un seul utilisateur. L’autorisation Lecture, Insertion et Mise à jour dont dispose cet utilisateur pour les jeux d’analyse (via son groupe d’utilisateurs), s’applique également aux appels d’API. Pour plus d’informations sur la gestion des utilisateurs et des autorisations dans AlisQI.
Les jetons d’authentification d’API peuvent être créés dans le hub d’intégration dans l’application. Nous vous recommandons d’utiliser des jetons dédiés par scénario d’intégration.
Sinon, si la méthode d’authentification du porteur n’est pas disponible, les demandes peuvent être authentifiées à l’aide du paramètre
&accessToken=abc...123d’URL accessToken.
Problèmes connus et limitations
Filtres : les opérations avec un paramètre de filtre attendent une chaîne JSON qui représente le filtre. Utilisez le hub d’intégration dans l’application pour générer un filtre et copier la chaîne JSON.
Dates : toutes les dates et heures sont au format UTC (formaté en tant que
yyyy-mm-dd hh:mm:ss), et toutes les chaînes sont encodées à l’aide de UTF-8.Mise en cache : l’opération getResults prend en charge la validation du cache à l’aide d’ETag et d’en-têtes Last-Modified. Nous vous recommandons d’activer la mise en cache sur les clients et d’effectuer des demandes conditionnelles pour réduire la latence, la charge du serveur et l’utilisation de l’énergie.
Limites d’utilisation : auparavant, nous avons constaté une dégradation des performances en raison de la surcharge de l’API. Pour protéger la stabilité de nos limites d’utilisation de la plateforme, appliquez l’API. Ces limites sont conçues pour empêcher les charges non souhaitées sur nos systèmes d’intégrations d’API mal configurées ou d’abus. La limite de débit par défaut est de 30 appels par minute. Cela s’applique aux opérations de lecture et d’écriture. Les demandes qui atteignent la limite de débit auront un code d’état .
429 Too many requests
Toutes les réponses incluent les en-têtes suivants avec des nombres explicites sur les limites et les appels restants :
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit -Retry-After
Pour déboguer des problèmes dans vos scénarios d’intégration qui sont ou peuvent être causés par des limites de débit, consultez cette liste de contrôle :
- Consultez votre spécialiste de l’intégration pour inspecter les appels d’API et retourner des en-têtes.
- Ouvrez votre hub d’intégration AlisQI pour en savoir plus sur la limite de débit concrète appliquée à votre installation.
- Inspectez le journal d’API dans le hub d’intégration AlisQI pour déterminer le nombre de requêtes par minute.
- Inspectez les en-têtes de retour de demande d’API pour voir s’ils contiennent le
429 Too many requestscode d’état. - Inspectez les en-têtes de retour de demande d’API individuels pour évaluer le
X-RateLimit-* headers. - Déterminez si vous pouvez améliorer l’intégration en réduisant les demandes en double ou en combinant plusieurs résultats dans un seul appel storeResults. N’hésitez pas à contacter le support AlisQI pour discuter des fonctionnalités de notre API concernant la mise en cache et le traitement de plusieurs résultats.
- Si votre scénario d’intégration est optimisé mais nécessite légitimement plus d’appels par minutes, contactez le support AlisQI pour discuter des possibilités d’augmenter la limite.
Instructions de déploiement
Utilisez ces instructions pour déployer ce connecteur en tant que connecteur personnalisé dans Microsoft Flow et PowerApps.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
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.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Créer ou mettre à jour des résultats ou des données de référence |
Créez ou mettez à jour des résultats de qualité dans des jeux d’analyse ou des données de référence dans des listes de sélection. |
| Créer une version de spécification |
Créez (a) une ou plusieurs versions de spécification pour un jeu d’analyse. |
| Obtenir des résultats ou des données de référence |
Obtenez des résultats (qualité) à partir de jeux d’analyse ou de données de référence à partir de listes de sélection. |
| Obtenir des statistiques de capacité pour les champs du jeu d’analyse |
Obtenez des statistiques détaillées sur l’évaluation des spécifications et la fonctionnalité de produit et de processus pour les champs numériques d’un jeu d’analyse. |
| Obtenir des statistiques descriptives pour les champs du jeu d’analyse |
Obtenez des statistiques descriptives pour les champs de jeu d’analyse numérique de votre choix. |
| Obtenir la structure d’un jeu d’analyse ou d’une liste de sélection |
Obtenez la définition structurelle d’un jeu d’analyse ou de listes de sélection. |
| Obtenir les versions de spécification |
Obtenir (a) la ou les versions de spécification d’un jeu d’analyse. |
| Obtenir tous les jeux d’analyse ou listes de sélection |
Obtenez une liste des ensembles d’analyse (tous) ou des listes de sélection. |
Créer ou mettre à jour des résultats ou des données de référence
Créez ou mettez à jour des résultats de qualité dans des jeux d’analyse ou des données de référence dans des listes de sélection.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | string |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Results
|
results | True | string |
Objet JSON sous forme de chaîne. |
|
Champ clé
|
keyField | string |
Recherchez et modifiez les résultats existants en fonction de la valeur de ce champ. |
|
|
Modifier uniquement
|
editOnly | string |
Utilisez (uniquement) conjointement avec keyField. |
|
|
Ajouter des options de liste
|
addListOptions | string |
Indicateur pour ajouter de nouvelles options à des listes. |
Créer une version de spécification
Créez (a) une ou plusieurs versions de spécification pour un jeu d’analyse.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | string |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Spécifications
|
specs | True | string |
Objet JSON sous forme de chaîne. |
|
Valeur d’index
|
indexValue | string |
Valeur du champ d’index. |
|
|
Heure de début
|
startDateTime | string |
Format aaaa -mm-dd hh :mm :ss ou unix stimestamp. |
|
|
Reason
|
reason | string |
Raison de la modification de la spécification. |
Retours
- response
- boolean
Obtenir des résultats ou des données de référence
Obtenez des résultats (qualité) à partir de jeux d’analyse ou de données de référence à partir de listes de sélection.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | integer |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Limit
|
limit | integer |
Spécifiez le nombre maximal d’enregistrements que vous souhaitez recevoir, jusqu’à une limite de 10 000. |
|
|
Décalage
|
offset | integer |
Choisissez une position de départ pour les résultats, utile pour la pagination des données (valeur par défaut 0). |
|
|
Trier
|
sort | string |
Déterminez l’ordre de vos données par un champ et une direction, comme date :desc pour la première fois la plus récente. |
|
|
Filter
|
filter | string |
Utilisez une chaîne au format JSON pour affiner les données que vous demandez, en fonction de conditions spécifiques. |
|
|
Fields
|
fields | string |
Liste séparée par des virgules avec les points de données spécifiques à retourner. |
|
|
Inclure des pièces jointes
|
includeAttachments | boolean |
Marquez true si vous souhaitez inclure des pièces jointes de fichier avec vos données, sinon laissez false. |
|
|
Inclure l’ID
|
includeId | boolean |
Définissez la valeur true si vous souhaitez obtenir les numéros d’enregistrement uniques du système pour vos données, ce qui facilite la gestion ou la référence. |
|
|
Inclure la date de dernière modification
|
includeLastModificationDate | boolean |
Activez cette option pour obtenir la dernière date de modification de chaque élément de données, ce qui est idéal pour le suivi des dernières mises à jour. |
Obtenir des statistiques de capacité pour les champs du jeu d’analyse
Obtenez des statistiques détaillées sur l’évaluation des spécifications et la fonctionnalité de produit et de processus pour les champs numériques d’un jeu d’analyse.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | integer |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Fields
|
fields | True | string |
Liste séparée par des virgules avec les points de données spécifiques à retourner. |
|
Limit
|
limit | integer |
Nombre maximal de résultats à prendre en compte. |
|
|
Filter
|
filter | string |
Utilisez une chaîne au format JSON pour affiner les données que vous demandez, en fonction de conditions spécifiques. |
Obtenir des statistiques descriptives pour les champs du jeu d’analyse
Obtenez des statistiques descriptives pour les champs de jeu d’analyse numérique de votre choix.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | integer |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Fields
|
fields | True | string |
Liste séparée par des virgules avec les points de données spécifiques à retourner. |
|
Limit
|
limit | integer |
Nombre maximal de résultats à prendre en compte. |
|
|
Filter
|
filter | string |
Utilisez une chaîne au format JSON pour affiner les données que vous demandez, en fonction de conditions spécifiques. |
Obtenir la structure d’un jeu d’analyse ou d’une liste de sélection
Obtenez la définition structurelle d’un jeu d’analyse ou de listes de sélection.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | integer |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Seuls les champs actifs
|
onlyActiveFields | boolean |
Indique s’il faut afficher uniquement les champs actifs. |
|
|
Accept
|
Accept | True | string |
Accept |
Obtenir les versions de spécification
Obtenir (a) la ou les versions de spécification d’un jeu d’analyse.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Définir l’ID
|
setId | True | integer |
Entrez l’ID unique du jeu d’analyse qui vous intéresse (historiquement appelé maskid dans les URL). |
|
Valeur d’index
|
indexValue | string |
Obtenez la version actuelle de la spécification pour cette valeur d’index. |
Obtenir tous les jeux d’analyse ou listes de sélection
Obtenez une liste des ensembles d’analyse (tous) ou des listes de sélection.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Sous-domaine à utiliser pour la requête. |
|
Groups
|
groups | string |
Entrez des ID de groupe ou des noms pour rechercher des groupes spécifiques, utilisez « Listes de sélection » pour obtenir tout. |
|
|
Names
|
names | string |
Entrez les noms des jeux d’analyse ou des listes de sélection que vous souhaitez récupérer. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
pièce d'identité
|
id | integer |
pièce d'identité |
|
nom
|
name | string |
nom |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
Définitions
boolean
Il s’agit du type de données de base « boolean ».