AlisQI (Vorschau)
Integrieren Sie Ihren QMS mit ihren ERP-, MES-, PLM-, Instrumenten-, Sensorik- oder Website-Tools von AlisQI.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | AlisQI Support |
| URL | https://help.alisqi.com/ |
| support@alisqi.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | AlisQI BV |
| Webseite | https://www.alisqi.com |
| Datenschutzrichtlinie | https://www.alisqi.com/en/privacy-statement |
| Kategorien | Unternehmensverwaltung |
AlisQI
Integrieren Sie Ihren QMS mit ihren ERP-, MES-, PLM-, Instrumenten-, Sensorik- oder Website-Tools von AlisQI.
Herausgeber: AlisQI B.V.
Voraussetzungen
Um diesen Connector verwenden zu können, benötigen Sie Folgendes:
- Ein Konto mit AlisQI.
- Nachdem Sie sich registriert haben und über eine Anwendung verfügen, rufen Sie den API-Schlüssel aus dem Onlineportal ab. Sie verwenden diesen Schlüssel, um Ihre Anfragen von unserem AlisQI-Connector zu authentifizieren.
Unterstützte Vorgänge
Der Connector unterstützt die folgenden Vorgänge:
Abrufen von Ergebnissen oder Stammdaten
/getResults: Abrufen (Qualitäts) Von Analysesätzen oder Masterdaten aus Auswahllisten.Abrufen aller Analysesätze oder Auswahllisten
/getAllSets: Abrufen einer Liste von (allen) Analysesätzen oder Auswahllisten.Erstellen oder Aktualisieren von Ergebnissen oder Stammdaten
/storeResults: Erstellen oder Aktualisieren von Qualitätsergebnissen in Analysesätzen oder Masterdaten in Auswahllisten.Erhalten Sie beschreibende Statistiken für Analysesatzfelder
/getStatistics: Erhalten Sie beschreibende Statistiken für numerische Analysesatzfelder Ihrer Wahl.Abrufen von Funktionsstatistiken für Analysesatzfelder
/getSpecificationEvaluation: Abrufen detaillierter Statistiken zur Spezifikationsauswertung und Produkt- und Prozessfunktion für die numerischen Felder eines Analysesatzes.Get specification versions
/getSpecificationVersion: Get (a) specification version(s) for an analysis set.Erstellen Sie eine neue Spezifikationsversion
/storeSpecificationVersion: Erstellen (a) neuer Spezifikationsversionen für einen Analysesatz.Rufen Sie die Struktur einer Analysesätze oder Auswahlliste
/getSetDefinitionab: Rufen Sie die strukturelle Definition einer Analysesätze oder Auswahllisten ab.
Abrufen von Anmeldeinformationen
Alle API-Aufrufe unterliegen der Authentifizierung. Um die AlisQI-API-Endpunkte aufzurufen, müssen Entwickler ein Authentifizierungstoken erstellen.
Die API unterstützt die Bearer-Authentifizierungsspezifikation.
Jedes Token ist mit einem einzelnen Benutzer verbunden. Die Berechtigung "Lesen", "Einfügen" und "Aktualisieren" für Analysesätze (über die Benutzergruppe) gilt auch für API-Aufrufe. Weitere Informationen zur Benutzer- und Berechtigungsverwaltung in AlisQI.
API-Authentifizierungstoken können im In-App-Integrationshub erstellt werden. Wir empfehlen die Verwendung dedizierter Token pro Integrationsszenario.
Wenn die Bearer-Authentifizierungsmethode nicht verfügbar ist, können Anforderungen auch mithilfe des AccessToken-URL-Parameters
&accessToken=abc...123authentifiziert werden.
Bekannte Probleme und Einschränkungen
Filter: Vorgänge mit einem Filterparameter erwarten eine JSON-Zeichenfolge, die den Filter darstellt. Verwenden Sie den In-App-Integrationshub , um einen Filter zu erstellen und die JSON-Zeichenfolge zu kopieren.
Datumsangaben: Alle Datums- und Uhrzeitangaben sind in UTC (formatiert als
yyyy-mm-dd hh:mm:ss) und alle Zeichenfolgen werden mit UTF-8 codiert.Zwischenspeichern: Der getResults-Vorgang unterstützt die Cacheüberprüfung mithilfe von ETag und Last-Modified Headern. Es wird empfohlen, zwischenspeichern auf Clients zu aktivieren und bedingte Anforderungen vorzunehmen, um Latenz, Serverlast und Energieverbrauch zu verringern.
Nutzungsgrenzwerte: Bisher haben wir aufgrund der Überladung der API Leistungsbeeinträchtigungen festgestellt. Um die Stabilität unserer Plattformnutzungsgrenzwerte zu gewährleisten, gelten sie für die API. Diese Grenzwerte dienen dazu, unerwünschte Belastungen unserer Systeme daran zu hindern, falsch konfigurierte API-Integrationen oder Missbrauch zu vermeiden. Der Satzgrenzwert gibt standardmäßig 30 Anrufe pro Minute an. Dies gilt sowohl für Lese- als auch Schreibvorgänge. Anforderungen, die den Satzgrenzwert erreichen, weisen einen Statuscode auf
429 Too many requests.
Alle Antworten enthalten die folgenden Kopfzeilen mit expliziten Nummern für die Grenzwerte und verbleibenden Aufrufe:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
Um Probleme in Ihren Integrationsszenarien zu debuggen, die durch Ratenbeschränkungen verursacht werden können, gehen Sie bitte in dieser Checkliste durch:
- Wenden Sie sich an Ihren Integrationsspezialisten, um die API-Aufrufe zu prüfen und Header zurückzugeben.
- Öffnen Sie Ihren AlisQI-Integrationshub, um mehr über das auf Ihre Installation angewendete konkrete Ratelimit zu erfahren.
- Überprüfen Sie das API-Protokoll im AlisQI-Integrationshub, um die Anzahl der Anforderungen pro Minute zu ermitteln.
- Überprüfen Sie die API-Anforderungsrücklaufheader, um festzustellen, ob sie den
429 Too many requestsStatuscode enthalten. - Überprüfen Sie einzelne API-Anforderungsrücklaufheader, um die Bewertung der
X-RateLimit-* headers. - Bewerten Sie, ob Sie die Integration verbessern können, indem Sie doppelte Anforderungen reduzieren oder mehrere Ergebnisse in einem einzelnen storeResults-Aufruf kombinieren. Wenden Sie sich gerne an die AlisQI-Unterstützung, um die Funktionen unserer API hinsichtlich Zwischenspeicherung und Verarbeitung mehrerer Ergebnisse zu besprechen.
- Wenn Ihr Integrationsszenario optimiert ist, aber legitimerweise mehr Anrufe pro Minuten erfordert, wenden Sie sich bitte an die AlisQI-Unterstützung, um Möglichkeiten zur Erhöhung des Grenzwerts zu besprechen.
Anweisungen zur Bereitstellung
Verwenden Sie diese Anweisungen , um diesen Connector als benutzerdefinierter Connector in Microsoft Flow und PowerApps bereitzustellen.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen aller Analysesätze oder Auswahllisten |
Dient zum Abrufen einer Liste von (allen) Analysesätzen oder Auswahllisten. |
| Abrufen aussagekräftiger Statistiken für Analysesatzfelder |
Erhalten Sie beschreibende Statistiken für numerische Analysesatzfelder Ihrer Wahl. |
| Abrufen der Struktur einer Analysesätze oder Auswahlliste |
Rufen Sie die strukturelle Definition einer Analysesätze oder Auswahllisten ab. |
| Abrufen von Ergebnissen oder Masterdaten |
Abrufen (Qualität) von Analysesätzen oder Stammdaten aus Auswahllisten. |
| Abrufen von Funktionsstatistiken für Analysesatzfelder |
Erhalten Sie detaillierte Statistiken zur Spezifikationsauswertung und Produkt- und Prozessfunktion für die numerischen Felder eines Analysesatzes. |
| Abrufen von Spezifikationsversionen |
Abrufen (a) der Spezifikationsversion(n) für einen Analysesatz. |
| Erstellen einer neuen Spezifikationsversion |
Erstellen (a) neuer Spezifikationsversionen für einen Analysesatz. |
| Erstellen oder Aktualisieren von Ergebnissen oder Masterdaten |
Erstellen oder Aktualisieren von Qualitätsergebnissen in Analysesätzen oder Stammdaten in Auswahllisten. |
Abrufen aller Analysesätze oder Auswahllisten
Dient zum Abrufen einer Liste von (allen) Analysesätzen oder Auswahllisten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Gruppen
|
groups | string |
Geben Sie Gruppen-IDs oder Namen ein, um bestimmte Gruppen zu finden, verwenden Sie "Auswahllisten", um alle abzurufen. |
|
|
Namen
|
names | string |
Geben Sie die Namen von Analysesätzen oder Auswahllisten ein, die Sie abrufen möchten. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
name
|
name | string |
name |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
Abrufen aussagekräftiger Statistiken für Analysesatzfelder
Erhalten Sie beschreibende Statistiken für numerische Analysesatzfelder Ihrer Wahl.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | integer |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Felder
|
fields | True | string |
Kommagetrennte Liste mit den spezifischen Datenpunkten, die zurückgegeben werden sollen. |
|
Limit
|
limit | integer |
Die maximale Anzahl der zu berücksichtigenden Ergebnisse. |
|
|
Filter
|
filter | string |
Verwenden Sie eine JSON-formatierte Zeichenfolge, um die angeforderten Daten basierend auf bestimmten Bedingungen einzugrenzen. |
Abrufen der Struktur einer Analysesätze oder Auswahlliste
Rufen Sie die strukturelle Definition einer Analysesätze oder Auswahllisten ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | integer |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Nur aktive Felder
|
onlyActiveFields | boolean |
Gibt an, ob derzeit aktive Felder angezeigt werden sollen. |
|
|
Akzeptieren
|
Accept | True | string |
Akzeptieren |
Abrufen von Ergebnissen oder Masterdaten
Abrufen (Qualität) von Analysesätzen oder Stammdaten aus Auswahllisten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | integer |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Limit
|
limit | integer |
Geben Sie die maximale Anzahl von Datensätzen an, die Sie empfangen möchten, bis zu einer Obergrenze von 10.000. |
|
|
Offset
|
offset | integer |
Wählen Sie eine Startposition für die Ergebnisse aus, die für das Ausblättern von Daten nützlich sind (Standardwert ist 0). |
|
|
Sortieren
|
sort | string |
Bestimmen Sie die Reihenfolge Ihrer Daten nach einem Feld und einer Richtung, z. B. "date:desc" für den letzten Ersten. |
|
|
Filter
|
filter | string |
Verwenden Sie eine JSON-formatierte Zeichenfolge, um die angeforderten Daten basierend auf bestimmten Bedingungen einzugrenzen. |
|
|
Felder
|
fields | string |
Kommagetrennte Liste mit den spezifischen Datenpunkten, die zurückgegeben werden sollen. |
|
|
Anlagen einschließen
|
includeAttachments | boolean |
Markieren Sie "true", wenn Sie Dateianlagen mit Ihren Daten einschließen möchten, andernfalls als "false" belassen. |
|
|
Einschließen-ID
|
includeId | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie die eindeutigen Datensatznummern des Systems für Ihre Daten abrufen möchten, sodass sie einfacher verwaltet oder referenzieren können. |
|
|
Datum der letzten Änderung einschließen
|
includeLastModificationDate | boolean |
Aktivieren Sie das Datum der letzten Änderung für jede Datenmenge, die sich hervorragend zum Nachverfolgen der neuesten Updates eignet. |
Abrufen von Funktionsstatistiken für Analysesatzfelder
Erhalten Sie detaillierte Statistiken zur Spezifikationsauswertung und Produkt- und Prozessfunktion für die numerischen Felder eines Analysesatzes.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | integer |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Felder
|
fields | True | string |
Kommagetrennte Liste mit den spezifischen Datenpunkten, die zurückgegeben werden sollen. |
|
Limit
|
limit | integer |
Die maximale Anzahl der zu berücksichtigenden Ergebnisse. |
|
|
Filter
|
filter | string |
Verwenden Sie eine JSON-formatierte Zeichenfolge, um die angeforderten Daten basierend auf bestimmten Bedingungen einzugrenzen. |
Abrufen von Spezifikationsversionen
Abrufen (a) der Spezifikationsversion(n) für einen Analysesatz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | integer |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Sollwert
|
indexValue | string |
Rufen Sie die aktuelle Spezifikationsversion für diesen Indexwert ab. |
Erstellen einer neuen Spezifikationsversion
Erstellen (a) neuer Spezifikationsversionen für einen Analysesatz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | string |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Brille
|
specs | True | string |
JSON-Objekt als Zeichenfolge. |
|
Sollwert
|
indexValue | string |
Der Indexfeldwert. |
|
|
Startdatum
|
startDateTime | string |
Formatiert als yyyy-mm-dd hh:mm:ss oder unix stimestamp. |
|
|
Ursache
|
reason | string |
Der Grund für die Änderung der Spezifikation. |
Gibt zurück
- response
- boolean
Erstellen oder Aktualisieren von Ergebnissen oder Masterdaten
Erstellen oder Aktualisieren von Qualitätsergebnissen in Analysesätzen oder Stammdaten in Auswahllisten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
Die Unterdomäne, die für die Anforderung verwendet werden soll. |
|
Id festlegen
|
setId | True | string |
Geben Sie die eindeutige ID des Analysesatzes ein, an dem Sie interessiert sind (historisch als Maskid in URLs bezeichnet). |
|
Ergebnisse
|
results | True | string |
JSON-Objekt als Zeichenfolge. |
|
Schlüsselfeld
|
keyField | string |
Suchen und Ändern vorhandener Ergebnisse basierend auf dem Wert dieses Felds. |
|
|
Nur bearbeiten
|
editOnly | string |
Verwenden Sie (nur) in Verbindung mit keyField. |
|
|
Listenoptionen hinzufügen
|
addListOptions | string |
Kennzeichnen, um Listen neue Optionen hinzuzufügen. |
Definitionen
boolean
Dies ist der grundlegende Datentyp "boolean".