AlisQI (versão prévia)
Integre seu QMS ao seu ERP, MES, PLM, instrumentos, sensores ou site usando as ferramentas de conectividade do AlisQI.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do AlisQI |
| URL | https://help.alisqi.com/ |
| support@alisqi.com |
| Metadados do conector | |
|---|---|
| Publicador | AlisQI BV |
| Site | https://www.alisqi.com |
| Política de privacidade | https://www.alisqi.com/en/privacy-statement |
| Categorias | Gestão de empresas |
AlisQI
Integre seu QMS ao seu ERP, MES, PLM, instrumentos, sensores ou site usando as ferramentas de conectividade do AlisQI.
Publicador: AlisQI B.V.
Pré-requisitos
Para usar esse conector, você precisará do seguinte:
- Uma conta com AlisQI.
- Depois de se inscrever e tiver um aplicativo, obtenha a Chave de API no portal online; você usará essa chave para autenticar suas solicitações do nosso conector AlisQI.
Operações com suporte
O conector dá suporte às seguintes operações:
Obter resultados ou dados
/getResultsmestres: obter resultados (de qualidade) de conjuntos de análise ou dados mestres de listas de seleção.Obter todos os conjuntos de análise ou listas
/getAllSetsde seleção: obtenha uma lista de (todos) conjuntos de análise ou listas de seleção.Criar ou atualizar resultados ou dados
/storeResultsmestres: crie ou atualize resultados de qualidade em conjuntos de análise ou dados mestres em listas de seleção.Obter estatísticas descritivas para campos
/getStatisticsdo conjunto de análise: obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha.Obter estatísticas de funcionalidade para campos
/getSpecificationEvaluationdo conjunto de análise: obtenha estatísticas detalhadas da avaliação de especificação e da funcionalidade de produto e processo para os campos numéricos de um conjunto de análises.Obter versões
/getSpecificationVersionde especificação: obter (a) versões de especificação para um conjunto de análises.Crie uma nova versão
/storeSpecificationVersionde especificação: crie (a) novas versões de especificação para um conjunto de análises.Obtenha a estrutura de um conjunto de análises ou lista de
/getSetDefinitionseleção: obtenha a definição estrutural de um conjunto de análises ou listas de seleção.
Obtendo credenciais
Todas as chamadas à API estão sujeitas à autenticação. Para invocar os pontos de extremidade da API alisQI, os desenvolvedores precisam criar um token de autenticação.
A API dá suporte à especificação de autenticação do portador.
Cada token está conectado a um único usuário. A permissão Ler, Inserir e Atualizar que esse usuário tem para conjuntos de análise (por meio de seu grupo de usuários), também se aplica a invocações de API. Mais informações sobre o gerenciamento de usuários e permissões no AlisQI.
Os tokens de autenticação de API podem ser criados no hub de integração no aplicativo. É recomendável usar tokens dedicados por cenário de integração.
Como alternativa, se o método de autenticação do portador não estiver disponível, as solicitações poderão ser autenticadas usando o parâmetro
&accessToken=abc...123de URL accessToken.
Problemas e limitações conhecidos
Filtros: as operações com um parâmetro de filtro esperam uma cadeia de caracteres JSON que representa o filtro. Use o hub de integração no aplicativo para criar um filtro e copiar a cadeia de caracteres JSON.
Datas: todas as datas e horas estão em UTC (formatado como
yyyy-mm-dd hh:mm:ss) e todas as cadeias de caracteres são codificadas usando UTF-8.Cache: a operação getResults dá suporte à validação de cache usando cabeçalhos ETag e Last-Modified. Recomendamos habilitar o cache em clientes e fazer solicitações condicionais para reduzir a latência, a carga do servidor e o uso de energia.
Limites de uso: anteriormente, vimos degradação de desempenho devido à sobrecarga da API. Para proteger a estabilidade dos limites de uso da plataforma, aplique-se à API. Esses limites são projetados para impedir que cargas indesejadas em nossos sistemas sejam violadas ou de integrações de API configuradas incorretamente. O limite de taxa usa como padrão 30 chamadas por minuto. Isso se aplica às operações de leitura e gravação. As solicitações que atingirem o limite de taxa terão um código de status de
429 Too many requests.
Todas as respostas incluem os seguintes cabeçalhos com números explícitos nos limites e chamadas restantes:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
Para depurar problemas em seus cenários de integração que são ou podem ser causados por limites de taxa, confira esta lista de verificação:
- Consulte o especialista em integração para inspecionar as chamadas à API e retornar cabeçalhos.
- Abra o hub de integração do AlisQI para saber mais sobre o limite de taxa concreto aplicado à sua instalação.
- Inspecione o log de API no hub de integração do AlisQI para determinar o número de solicitações por minuto.
- Inspecione os cabeçalhos de retorno da solicitação de API para ver se eles contêm o código de
429 Too many requestsstatus. - Inspecione cabeçalhos de retorno de solicitação de API individuais para avaliar o
X-RateLimit-* headers. - Avalie se você pode melhorar a integração reduzindo solicitações duplicadas ou combinando vários resultados em uma única chamada storeResults. Fique à vontade para entrar em contato com o suporte do AlisQI para discutir os recursos da nossa API em relação ao cache e ao processamento de vários resultados.
- Se o cenário de integração for otimizado, mas legitimamente exigir mais chamadas por minutos, entre em contato com o suporte do AlisQI para discutir as possibilidades para elevar o limite.
Instruções de implementação
Use estas instruções para implantar esse conector como conector personalizado no Microsoft Flow e no PowerApps.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para esta api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Criar ou atualizar resultados ou dados mestres |
Crie ou atualize os resultados de qualidade em conjuntos de análise ou dados mestres em listas de seleção. |
| Criar uma nova versão de especificação |
Crie (a) novas versões de especificação para um conjunto de análises. |
| Obter a estrutura de um conjunto de análise ou lista de seleção |
Obtenha a definição estrutural de um conjunto de análises ou listas de seleção. |
| Obter estatísticas de funcionalidade para campos do conjunto de análise |
Obtenha estatísticas detalhadas da avaliação de especificação e da capacidade do produto e do processo para os campos numéricos de um conjunto de análises. |
| Obter estatísticas descritivas para campos do conjunto de análise |
Obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha. |
| Obter resultados ou dados mestres |
Obtenha resultados (de qualidade) de conjuntos de análise ou dados mestres de listas de seleção. |
| Obter todos os conjuntos de análise ou listas de seleção |
Obtenha uma lista de (todos) conjuntos de análise ou listas de seleção. |
| Obter versões de especificação |
Obtenha (a) versões de especificação para um conjunto de análises. |
Criar ou atualizar resultados ou dados mestres
Crie ou atualize os resultados de qualidade em conjuntos de análise ou dados mestres em listas de seleção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | string |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Results
|
results | True | string |
Objeto JSON como uma cadeia de caracteres. |
|
Campo chave
|
keyField | string |
Localize e modifique os resultados existentes com base no valor desse campo. |
|
|
Somente edição
|
editOnly | string |
Use (somente) em conjunto com keyField. |
|
|
Adicionar opções de lista
|
addListOptions | string |
Sinalizar para adicionar novas opções a listas. |
Criar uma nova versão de especificação
Crie (a) novas versões de especificação para um conjunto de análises.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | string |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Especificações
|
specs | True | string |
Objeto JSON como uma cadeia de caracteres. |
|
Valor do índice
|
indexValue | string |
O valor do campo de índice. |
|
|
Hora da Data de Início
|
startDateTime | string |
Formatado como yyyyy-mm-dd hh:mm:ss ou unix stimestamp. |
|
|
Reason
|
reason | string |
O motivo para alterar a especificação. |
Retornos
- response
- boolean
Obter a estrutura de um conjunto de análise ou lista de seleção
Obtenha a definição estrutural de um conjunto de análises ou listas de seleção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | integer |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Somente campos ativos
|
onlyActiveFields | boolean |
Se os campos ativos devem ser mostrados apenas no momento. |
|
|
Aceitar
|
Accept | True | string |
Aceitar |
Obter estatísticas de funcionalidade para campos do conjunto de análise
Obtenha estatísticas detalhadas da avaliação de especificação e da capacidade do produto e do processo para os campos numéricos de um conjunto de análises.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | integer |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Fields
|
fields | True | string |
Lista separada por vírgulas com os pontos de dados específicos que você deseja retornar. |
|
Limit
|
limit | integer |
O número máximo de resultados a serem considerados. |
|
|
Filter
|
filter | string |
Use uma cadeia de caracteres formatada em JSON para restringir os dados que você está solicitando, com base em condições específicas. |
Obter estatísticas descritivas para campos do conjunto de análise
Obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | integer |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Fields
|
fields | True | string |
Lista separada por vírgulas com os pontos de dados específicos que você deseja retornar. |
|
Limit
|
limit | integer |
O número máximo de resultados a serem considerados. |
|
|
Filter
|
filter | string |
Use uma cadeia de caracteres formatada em JSON para restringir os dados que você está solicitando, com base em condições específicas. |
Obter resultados ou dados mestres
Obtenha resultados (de qualidade) de conjuntos de análise ou dados mestres de listas de seleção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | integer |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Limit
|
limit | integer |
Especifique o número máximo de registros que você deseja receber, até um limite de 10.000. |
|
|
Offset
|
offset | integer |
Escolha uma posição inicial para os resultados, útil para paginar por meio de dados (o padrão é 0). |
|
|
Classificar
|
sort | string |
Determine a ordem de seus dados por um campo e direção, como date:desc para o primeiro mais recente. |
|
|
Filter
|
filter | string |
Use uma cadeia de caracteres formatada em JSON para restringir os dados que você está solicitando, com base em condições específicas. |
|
|
Fields
|
fields | string |
Lista separada por vírgulas com os pontos de dados específicos que você deseja retornar. |
|
|
Incluir anexos
|
includeAttachments | boolean |
Marque true se você quiser incluir anexos de arquivo com seus dados, caso contrário, deixe como false. |
|
|
Incluir ID
|
includeId | boolean |
Defina como true se você quiser obter os números de registro exclusivos do sistema para seus dados, facilitando o gerenciamento ou a referência. |
|
|
Incluir Data da Última Modificação
|
includeLastModificationDate | boolean |
Ative para obter a data da última alteração para cada parte dos dados, o que é ótimo para acompanhar as atualizações mais recentes. |
Obter todos os conjuntos de análise ou listas de seleção
Obtenha uma lista de (todos) conjuntos de análise ou listas de seleção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Groups
|
groups | string |
Insira IDs ou nomes de grupo para localizar grupos específicos, use 'Listas de seleção' para obter tudo. |
|
|
Names
|
names | string |
Insira os nomes dos conjuntos de análise ou listas de seleção que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
nome
|
name | string |
nome |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
Obter versões de especificação
Obtenha (a) versões de especificação para um conjunto de análises.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
O subdomínio a ser usado para a solicitação. |
|
Definir ID
|
setId | True | integer |
Insira a ID exclusiva do conjunto de análises no qual você está interessado (historicamente conhecido como maskid em URLs). |
|
Valor do índice
|
indexValue | string |
Obtenha a versão de especificação atual para esse valor de índice. |
Definições
boolean
Esse é o tipo de dados básico 'booleano'.