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/ |
| 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
/getResultsmestres: 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 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. 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'.