AlisQI (preview)
Integreer uw QMS met uw ERP, MES, PLM, instrumenten, sensoren of website met behulp van de connectiviteitstools van AlisQI.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | AlisQI-ondersteuning |
| URL | https://help.alisqi.com/ |
| E-mailen | support@alisqi.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | AlisQI BV |
| Webpagina | https://www.alisqi.com |
| Privacybeleid | https://www.alisqi.com/en/privacy-statement |
| Categorieën | Bedrijfsbeheer |
AlisQI
Integreer uw QMS met uw ERP, MES, PLM, instrumenten, sensoren of website met behulp van de connectiviteitstools van AlisQI.
Uitgever: AlisQI B.V.
Vereiste voorwaarden
Als u deze connector wilt gebruiken, hebt u het volgende nodig:
- Een account met AlisQI.
- Zodra u zich hebt geregistreerd en u een toepassing hebt, haalt u de API-sleutel op uit de onlineportal. u gebruikt deze sleutel om uw aanvragen van onze AlisQI-connector te verifiëren.
Ondersteunde bewerkingen
De connector ondersteunt de volgende bewerkingen:
Resultaten of hoofdgegevens
/getResultsophalen: Haal (kwaliteit) resultaten op uit analysesets of hoofdgegevens uit selectielijsten.Alle analysesets of selectielijsten
/getAllSetsophalen: Een lijst met (alle) analysesets of selectielijsten ophalen.Resultaten of hoofdgegevens
/storeResultsmaken of bijwerken: kwaliteitsresultaten maken of bijwerken in analysesets of hoofdgegevens in selectielijsten.Beschrijvende statistieken ophalen voor velden voor analysesets
/getStatistics: beschrijvende statistieken ophalen voor numerieke analysesetvelden van uw keuze.Mogelijkheidsstatistieken ophalen voor velden voor analysesets
/getSpecificationEvaluation: gedetailleerde statistieken over specificatieevaluatie en product- en procesmogelijkheden voor de numerieke velden van een analyseset ophalen.Specificatieversies
/getSpecificationVersionophalen: Specificatieversies ophalen (a) voor een analyseset.Maak een nieuwe specificatieversie
/storeSpecificationVersion: maak (a) nieuwe specificatieversies voor een analyseset.De structuur van een analyseset of selectielijst
/getSetDefinitionophalen: Haal de structurele definitie van een analyseset of selectielijsten op.
Referenties verkrijgen
Alle API-aanroepen zijn onderworpen aan verificatie. Om de AlisQI API-eindpunten aan te roepen, moeten ontwikkelaars een verificatietoken maken.
De API ondersteunt de Bearer-verificatiespecificatie.
Elk token is verbonden met één gebruiker. De machtiging Lezen, Invoegen en Bijwerken die deze gebruiker heeft voor analysesets (via de gebruikersgroep), is ook van toepassing op API-aanroepen. Meer informatie over het beheer van gebruikers en machtigingen in AlisQI.
API-verificatietokens kunnen worden gemaakt in de integratiehub in de app. U wordt aangeraden toegewezen tokens per integratiescenario te gebruiken.
Als de Bearer-verificatiemethode niet beschikbaar is, kunnen aanvragen ook worden geverifieerd met behulp van de parameter
&accessToken=abc...123accessToken-URL.
Bekende problemen en beperkingen
Filters: Bewerkingen met een filterparameter verwachten een JSON-tekenreeks die het filter vertegenwoordigt. Gebruik de integratiehub in de app om een filter te bouwen en de JSON-tekenreeks te kopiëren.
Datums: Alle datums en tijden zijn in UTC (opgemaakt als
yyyy-mm-dd hh:mm:ss) en alle tekenreeksen worden gecodeerd met UTF-8.Caching: De getResults-bewerking ondersteunt cachevalidatie met behulp van ETag en Last-Modified headers. We raden u aan caching in te schakelen op clients en voorwaardelijke aanvragen te maken om latentie, serverbelasting en energieverbruik te verminderen.
Gebruikslimieten: eerder hebben we prestatievermindering gezien vanwege overbelasting van de API. Om de stabiliteit van onze platformgebruikslimieten te waarborgen, zijn deze van toepassing op de API. Deze limieten zijn ontworpen om te voorkomen dat ongewenste belastingen op onze systemen onjuist geconfigureerde API-integraties of misbruiken. De frequentielimiet is standaard ingesteld op 30 aanroepen per minuut. Dit geldt zowel voor lees- als schrijfbewerkingen. Aanvragen die de frequentielimiet bereiken, hebben een statuscode van
429 Too many requests.
Alle antwoorden bevatten de volgende headers met expliciete nummers voor de limieten en resterende aanroepen:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
Als u problemen wilt opsporen in uw integratiescenario's die wel of niet kunnen worden veroorzaakt door frequentielimieten, gaat u door deze controlelijst:
- Neem contact op met uw integratiespecialist om de API-aanroepen te inspecteren en headers te retourneren.
- Open uw AlisQI-integratiehub voor meer informatie over de betonsnelheidslimiet die op uw installatie is toegepast.
- Inspecteer het API-logboek in de AlisQI-integratiehub om het aantal aanvragen per minuut te bepalen.
- Inspecteer de API-aanvraag retourheaders om te zien of deze de
429 Too many requestsstatuscode bevatten. - Inspecteer afzonderlijke API-aanvraag retourheaders om het
X-RateLimit-* headerste beoordelen. - Bepaal of u de integratie kunt verbeteren door dubbele aanvragen te verminderen of door meerdere resultaten te combineren in één storeResults-aanroep. Neem gerust contact op met AlisQI-ondersteuning om de mogelijkheden van onze API te bespreken met betrekking tot caching en verwerking van meerdere resultaten.
- Als uw integratiescenario is geoptimaliseerd, maar legitiem meer oproepen per minuut vereist, neemt u contact op met AlisQI-ondersteuning om mogelijkheden te bespreken om de limiet te verhogen.
Implementatie-instructies
Gebruik deze instructies om deze connector te implementeren als aangepaste connector in Microsoft Flow en PowerApps.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| API-sleutel | beveiligde string | De API-sleutel voor deze API | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Alle analysesets of selectielijsten ophalen |
Een lijst met (alle) analysesets of selectielijsten ophalen. |
| Beschrijvende statistieken ophalen voor velden van analysesets |
Haal beschrijvende statistieken op voor numerieke analysesetvelden van uw keuze. |
| De structuur van een analyseset of selectielijst ophalen |
Haal de structurele definitie van een analyseset of selectielijsten op. |
| Een nieuwe specificatieversie maken |
Maak (a) nieuwe specificatieversies voor een analyseset. |
| Mogelijkheidsstatistieken ophalen voor velden voor analysesets |
Krijg uitgebreide statistieken over specificatie-evaluatie en product- en procesmogelijkheden voor de numerieke velden van een analyseset. |
| Resultaten of hoofdgegevens maken of bijwerken |
Kwaliteitsresultaten maken of bijwerken in analysesets of hoofdgegevens in selectielijsten. |
| Resultaten of hoofdgegevens ophalen |
Resultaten ophalen (kwaliteit) uit analysesets of hoofdgegevens uit selectielijsten. |
| Specificatieversies ophalen |
Haal (a) specificatieversies op voor een analyseset. |
Alle analysesets of selectielijsten ophalen
Een lijst met (alle) analysesets of selectielijsten ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Groups
|
groups | string |
Voer groeps-id's of namen in om specifieke groepen te zoeken, gebruik Selectielijsten om alles op te halen. |
|
|
Names
|
names | string |
Voer de namen in van analysesets of selectielijsten die u wilt ophalen. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
identiteitskaart
|
id | integer |
identiteitskaart |
|
naam
|
name | string |
naam |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
menu topLevel
|
topLevelMenu | string |
menu topLevel |
Beschrijvende statistieken ophalen voor velden van analysesets
Haal beschrijvende statistieken op voor numerieke analysesetvelden van uw keuze.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | integer |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Fields
|
fields | True | string |
Door komma's gescheiden lijst met de specifieke gegevenspunten die u wilt retourneren. |
|
Limit
|
limit | integer |
Het maximum aantal resultaten dat u moet overwegen. |
|
|
Filter
|
filter | string |
Gebruik een tekenreeks met JSON-indeling om de gegevens te beperken die u aanvraagt, op basis van specifieke voorwaarden. |
De structuur van een analyseset of selectielijst ophalen
Haal de structurele definitie van een analyseset of selectielijsten op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | integer |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Alleen actieve velden
|
onlyActiveFields | boolean |
Hiermee wordt aangegeven of alleen actieve velden moeten worden weergegeven. |
|
|
Accepteren
|
Accept | True | string |
Accepteren |
Een nieuwe specificatieversie maken
Maak (a) nieuwe specificatieversies voor een analyseset.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | string |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Specs
|
specs | True | string |
JSON-object als een tekenreeks. |
|
Indexwaarde
|
indexValue | string |
De waarde van het indexveld. |
|
|
Begindatumtijd
|
startDateTime | string |
Opgemaakt als jjjj-mm-dd uu:mm:ss of unix-stimestamp. |
|
|
Reden
|
reason | string |
De reden voor het wijzigen van de specificatie. |
Retouren
- response
- boolean
Mogelijkheidsstatistieken ophalen voor velden voor analysesets
Krijg uitgebreide statistieken over specificatie-evaluatie en product- en procesmogelijkheden voor de numerieke velden van een analyseset.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | integer |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Fields
|
fields | True | string |
Door komma's gescheiden lijst met de specifieke gegevenspunten die u wilt retourneren. |
|
Limit
|
limit | integer |
Het maximum aantal resultaten dat u moet overwegen. |
|
|
Filter
|
filter | string |
Gebruik een tekenreeks met JSON-indeling om de gegevens te beperken die u aanvraagt, op basis van specifieke voorwaarden. |
Resultaten of hoofdgegevens maken of bijwerken
Kwaliteitsresultaten maken of bijwerken in analysesets of hoofdgegevens in selectielijsten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | string |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Results
|
results | True | string |
JSON-object als een tekenreeks. |
|
Sleutelveld
|
keyField | string |
Bestaande resultaten zoeken en wijzigen op basis van de waarde van dit veld. |
|
|
Alleen bewerken
|
editOnly | string |
Gebruik (alleen) in combinatie met keyField. |
|
|
Lijstopties toevoegen
|
addListOptions | string |
Vlag toevoegen om nieuwe opties toe te voegen aan lijsten. |
Resultaten of hoofdgegevens ophalen
Resultaten ophalen (kwaliteit) uit analysesets of hoofdgegevens uit selectielijsten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | integer |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Limit
|
limit | integer |
Geef het maximum aantal records op dat u wilt ontvangen, tot een limiet van 10.000. |
|
|
Offset
|
offset | integer |
Kies een beginpositie voor de resultaten, handig voor het bladeren door gegevens (standaard ingesteld op 0). |
|
|
Sorteren
|
sort | string |
Bepaal de volgorde van uw gegevens op basis van een veld en richting, zoals date:desc voor de meest recente eerste. |
|
|
Filter
|
filter | string |
Gebruik een tekenreeks met JSON-indeling om de gegevens te beperken die u aanvraagt, op basis van specifieke voorwaarden. |
|
|
Fields
|
fields | string |
Door komma's gescheiden lijst met de specifieke gegevenspunten die u wilt retourneren. |
|
|
Bijlagen opnemen
|
includeAttachments | boolean |
Markeer waar als u bestandsbijlagen met uw gegevens wilt opnemen, anders laat u deze staan als onwaar. |
|
|
Id opnemen
|
includeId | boolean |
Ingesteld op waar als u de unieke recordnummers van het systeem voor uw gegevens wilt ophalen, zodat u deze eenvoudiger kunt beheren of ernaar kunt verwijzen. |
|
|
Datum van laatste wijziging opnemen
|
includeLastModificationDate | boolean |
Schakel deze optie in om de laatste wijzigingsdatum voor elk stukje gegevens op te halen, wat handig is voor het bijhouden van de meest recente updates. |
Specificatieversies ophalen
Haal (a) specificatieversies op voor een analyseset.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Het subdomein dat moet worden gebruikt voor de aanvraag. |
|
Id instellen
|
setId | True | integer |
Voer de unieke id in van de analyseset waarin u geïnteresseerd bent (historisch bekend als maskid in URL's). |
|
Indexwaarde
|
indexValue | string |
De huidige specificatieversie voor deze indexwaarde ophalen. |
Definities
booleaan
Dit is het basisgegevenstype 'Booleaanse waarde'.