Partilhar via


AlisQI (Pré-visualização)

Integre o seu SGQ com o seu ERP, MES, PLM, instrumentos, sensores ou website usando as ferramentas de conectividade do AlisQI.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte AlisQI
URL https://help.alisqi.com/
Email support@alisqi.com
Metadados do conector
Editora AlisQI BV
Sítio Web https://www.alisqi.com
Política de privacidade https://www.alisqi.com/en/privacy-statement
Categorias Gestão de Empresas

AlisQI

Integre o seu SGQ com o seu ERP, MES, PLM, instrumentos, sensores ou website usando as ferramentas de conectividade do AlisQI.

Editora: AlisQI B.V.

Pré-requisitos

Para usar esse conector, você precisará do seguinte:

  • Uma conta no AlisQI.
  • Depois de se inscrever e ter uma aplicação, obtenha a chave API no portal online; você usará essa chave para autenticar suas solicitações do nosso conector AlisQI.

Operações suportadas

O conector suporta as seguintes operações:

  • Obter resultados ou dados /getResults mestres: obtenha resultados (de qualidade) de conjuntos de análise ou dados mestre de listas de seleção.

  • Obter todos os conjuntos de análise ou listas /getAllSetsde seleção : Obtenha uma lista de (todos) os 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 mestre em listas de seleção.

  • Obter estatísticas descritivas para campos /getStatisticsde conjunto de análise : Obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha.

  • Obter estatísticas de capacidade para campos /getSpecificationEvaluationde conjunto de análise: Obtenha estatísticas detalhadas de avaliação de especificações e capacidade de produto e processo para campos numéricos de um conjunto de análise.

  • Obter versões /getSpecificationVersionde especificação: Obtenha a(s) versão(ões) de especificação para um conjunto de análise.

  • Criar uma nova versão /storeSpecificationVersionde especificação : Crie (a) nova(s) versão(ões) de especificação para um conjunto de análise.

  • Obter a estrutura de um conjunto de análise ou lista /getSetDefinitionde seleção : Obtenha a definição estrutural de um conjunto de análise ou listas de seleção.

Obtenção de credenciais

  • Todas as chamadas de API estão sujeitas a autenticação. Para invocar os pontos de extremidade da API AlisQI, os desenvolvedores precisam criar um token de autenticação.

  • A API suporta a especificação de autenticação do portador.

  • Cada token é conectado a um único usuário. A permissão Ler, Inserir e Atualizar que este 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 usuário e gerenciamento de permissões no AlisQI.

  • Os tokens de autenticação de API podem ser criados no hub de integração no aplicativo. Recomendamos o uso de tokens dedicados por cenário de integração.

  • Como alternativa, se o método de autenticação Bearer não estiver disponível, as solicitações poderão ser autenticadas usando o parâmetro &accessToken=abc...123accessToken URL .

Problemas conhecidos e limitações

  • 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 (formatadas como yyyy-mm-dd hh:mm:ss), e todas as cadeias de caracteres são codificadas usando UTF-8.

  • Cache: A operação getResults suporta a 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 do desempenho devido à sobrecarga da API. Para salvaguardar a estabilidade da nossa plataforma, os limites de utilização aplicam-se à API. Esses limites são projetados para evitar cargas indesejadas em nossos sistemas de integrações de API mal configuradas ou abuso. O limite de tarifa padrão é de 30 chamadas por minuto. Isso se aplica a 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, consulte esta lista de verificação:

  • Consulte seu especialista em integração para inspecionar as chamadas de API e os cabeçalhos de retorno.
  • Abra seu hub de integração AlisQI para saber mais sobre o limite de taxa de concreto aplicado à sua instalação.
  • Inspecione o log da API no hub de integração do AlisQI para determinar o número de solicitações por minuto.
  • Inspecione os cabeçalhos de retorno de solicitação de API para ver se eles contêm o código de 429 Too many requests status.
  • 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. Sinta-se à vontade para entrar em contato com o suporte do AlisQI para discutir os recursos de nossa API em relação ao cache e processamento de vários resultados.
  • Se o seu cenário de integração estiver otimizado, mas exigir legitimamente mais chamadas por minuto, entre em contato com o suporte do AlisQI para discutir as possibilidades de aumentar o limite.

Instruções de implantação

Use estas instruções para implantar esse conector como conector personalizado no Microsoft Flow e no PowerApps.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Criar ou atualizar resultados ou dados mestre

Crie ou atualize resultados de qualidade em conjuntos de análise ou dados mestre em listas de seleção.

Criar uma nova versão de especificação

Crie (a) nova(s) versão(õ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 conjuntos de análise ou listas de seleção.

Obter estatísticas de capacidade para campos de conjunto de análise

Obtenha estatísticas detalhadas de avaliação de especificações e capacidade de produto e processo para os campos numéricos de um conjunto de análise.

Obter estatísticas descritivas para campos de conjunto de análise

Obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha.

Obter resultados ou dados mestre

Obtenha resultados (de qualidade) de conjuntos de análise ou dados mestre de listas de seleção.

Obter todos os conjuntos de análise ou listas de seleção

Obtenha uma lista de (todos) os conjuntos de análise ou listas de seleção.

Obter versões de especificação

Obtenha a(s) versão(ões) de especificação para um conjunto de análise.

Criar ou atualizar resultados ou dados mestre

Crie ou atualize resultados de qualidade em conjuntos de análise ou dados mestre em listas de seleção.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True string

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Results
results True string

Objeto JSON como uma cadeia de caracteres.

Campo-chave
keyField string

Encontre e modifique os resultados existentes com base no valor deste campo.

Editar Apenas
editOnly string

Use (apenas) em conjunto com keyField.

Adicionar opções de lista
addListOptions string

Sinalizar para adicionar novas opções às listas.

Criar uma nova versão de especificação

Crie (a) nova(s) versão(ões) de especificação para um conjunto de análises.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True string

Insira o ID exclusivo do conjunto de análise em que 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.

Data de início Hora
startDateTime string

Formatado como aaaa-mm-dd hh:mm:ss ou unix stimestamp.

Reason
reason string

A razão para alterar a especificação.

Devoluções

response
boolean

Obter a estrutura de um conjunto de análise ou lista de seleção

Obtenha a definição estrutural de conjuntos de análise ou listas de seleção.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True integer

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Apenas campos ativos
onlyActiveFields boolean

Se apenas os campos ativos no momento devem ser exibidos.

Aceitar
Accept True string

Aceitar

Obter estatísticas de capacidade para campos de conjunto de análise

Obtenha estatísticas detalhadas de avaliação de especificações e capacidade de produto e processo para os campos numéricos de um conjunto de análise.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True integer

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Campos
fields True string

Lista separada por vírgulas com os pontos de dados específicos que você deseja que sejam retornados.

Limite
limit integer

O número máximo de resultados a considerar.

Filter
filter string

Use uma cadeia de caracteres formatada em JSON para restringir os dados solicitados, com base em condições específicas.

Obter estatísticas descritivas para campos de conjunto de análise

Obtenha estatísticas descritivas para campos de conjunto de análise numérica de sua escolha.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True integer

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Campos
fields True string

Lista separada por vírgulas com os pontos de dados específicos que você deseja que sejam retornados.

Limite
limit integer

O número máximo de resultados a considerar.

Filter
filter string

Use uma cadeia de caracteres formatada em JSON para restringir os dados solicitados, com base em condições específicas.

Obter resultados ou dados mestre

Obtenha resultados (de qualidade) de conjuntos de análise ou dados mestre de listas de seleção.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True integer

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Limite
limit integer

Especifique o número máximo de registros que você deseja receber, até um limite de 10.000.

Compensação
offset integer

Escolha uma posição inicial para os resultados, útil para a paginação de dados (o padrão é 0).

Ordenar
sort string

Determine a ordem dos seus dados por um campo e direção, como date:desc para o mais recente primeiro.

Filter
filter string

Use uma cadeia de caracteres formatada em JSON para restringir os dados solicitados, com base em condições específicas.

Campos
fields string

Lista separada por vírgulas com os pontos de dados específicos que você deseja que sejam retornados.

Incluir anexos
includeAttachments boolean

Marque true se quiser incluir anexos de arquivo com seus dados, caso contrário, deixe como false.

Incluir ID
includeId boolean

Defina como true se 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) os conjuntos de análise ou listas de seleção.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Groups
groups string

Introduza IDs ou nomes de grupos para encontrar grupos específicos, utilize 'Listas de seleção' para obter tudo.

Names
names string

Insira os nomes dos conjuntos de análise ou listas de seleção que deseja recuperar.

Devoluções

Name 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(s) versão(ões) de especificação para um conjunto de análise.

Parâmetros

Name Chave Necessário Tipo Description
Subdomain
subdomain True string

O subdomínio a ser usado para a solicitação.

Definir ID
setId True integer

Insira o ID exclusivo do conjunto de análise em que você está interessado (historicamente conhecido como maskid em URLs).

Valor do índice
indexValue string

Obtenha a versão atual da especificação para este valor de índice.

Definições

Booleano

Este é o tipo de dados básico 'booleano'.