AlisQI(미리 보기)
AlisQI의 연결 도구를 사용하여 QMS를 ERP, MES, PLM, 계측기, 센서 또는 웹 사이트와 통합합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | AlisQI 지원 |
| URL | https://help.alisqi.com/ |
| 전자 메일 | support@alisqi.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | AlisQI BV |
| 웹 사이트 | https://www.alisqi.com |
| 개인 정보 보호 정책 | https://www.alisqi.com/en/privacy-statement |
| 카테고리 | 경영 관리 |
AlisQI
AlisQI의 연결 도구를 사용하여 QMS를 ERP, MES, PLM, 계측기, 센서 또는 웹 사이트와 통합합니다.
게시자: AlisQI B.V.
필수 조건
이 커넥터를 사용하려면 다음이 필요합니다.
- AlisQI를 사용하는 계정입니다.
- 등록하고 애플리케이션이 있으면 온라인 포털에서 API 키를 가져옵니다. 이 키를 사용하여 AlisQI 커넥터에서 요청을 인증합니다.
지원되는 작업
커넥터는 다음 작업을 지원합니다.
결과 또는 마스터 데이터
/getResults가져오기: 선택 목록에서 분석 집합 또는 마스터 데이터에서 결과를 가져옵니다(품질).모든 분석 집합 또는 선택 목록
/getAllSets가져오기: (모든) 분석 집합 또는 선택 목록 목록을 가져옵니다.결과 또는 마스터 데이터
/storeResults만들기 또는 업데이트: 선택 목록의 분석 집합 또는 마스터 데이터에서 품질 결과를 만들거나 업데이트합니다.분석 집합 필드에
/getStatistics대한 설명 통계 가져오기: 선택한 숫자 분석 집합 필드에 대한 설명 통계를 가져옵니다.분석 집합 필드에 대한 기능 통계 가져오기: 분석 집합의 숫자 필드에
/getSpecificationEvaluation대한 사양 평가 및 제품 및 프로세스 기능에 대한 자세한 통계를 가져옵니다.사양 버전
/getSpecificationVersion가져오기: 분석 집합에 대한 (a) 사양 버전을 가져옵니다.새 사양 버전
/storeSpecificationVersion만들기: 분석 집합에 대한 (a) 새 사양 버전을 만듭니다.분석 집합 또는 선택 목록
/getSetDefinition의 구조를 가져옵니다. 분석 집합 또는 선택 목록의 구조적 정의를 가져옵니다.
자격 증명 가져오기
모든 API 호출에는 인증이 적용됩니다. AlisQI API 엔드포인트를 호출하려면 개발자가 인증 토큰을 만들어야 합니다.
API는 전달자 인증 사양을 지원합니다.
각 토큰은 단일 사용자에 연결됩니다. 이 사용자가 분석 집합에 대해 가지고 있는 읽기, 삽입 및 업데이트 권한(사용자 그룹을 통해)도 API 호출에 적용됩니다. AlisQI의 사용자 및 권한 관리에 대한 자세한 정보입니다.
API 인증 토큰은 앱 내 통합 허브에서 만들 수 있습니다. 통합 시나리오당 전용 토큰을 사용하는 것이 좋습니다.
또는 전달자 인증 방법을 사용할 수 없는 경우 accessToken URL 매개 변수
&accessToken=abc...123를 사용하여 요청을 인증할 수 있습니다.
알려진 문제 및 제한 사항
필터: 필터 매개 변수를 사용하는 작업에는 필터를 나타내는 JSON 문자열이 필요합니다. 앱 내 통합 허브 를 사용하여 필터를 빌드하고 JSON 문자열을 복사합니다.
날짜: 모든 날짜와 시간은 UTC(형식 지정
yyyy-mm-dd hh:mm:ss)이며 모든 문자열은 UTF-8을 사용하여 인코딩됩니다.캐싱: getResults 작업은 ETag 및 Last-Modified 헤더를 사용하여 캐시 유효성 검사를 지원합니다. 클라이언트에서 캐싱을 사용하도록 설정하고 조건부 요청을 통해 대기 시간, 서버 부하 및 에너지 사용량을 줄이는 것이 좋습니다.
사용량 제한: 이전에는 API 오버로드로 인해 성능이 저하되었습니다. 플랫폼 사용량 한도의 안정성을 보호하기 위해 API에 적용됩니다. 이러한 제한은 시스템에서 원치 않는 부하가 잘못 구성된 API 통합 또는 남용을 방지하도록 설계되었습니다. 속도 제한은 기본적으로 분당 30개의 호출입니다. 이는 읽기 및 쓰기 작업 모두에 적용됩니다. 속도 제한에 도달한 요청에는 상태 코드
429 Too many requests가 있습니다.
모든 응답에는 제한 및 나머지 호출에 명시적 숫자가 있는 다음 헤더가 포함됩니다.
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
속도 제한으로 인해 발생하거나 발생할 수 있는 통합 시나리오의 문제를 디버그하려면 다음 검사 목록을 참조하세요.
- API 호출 및 반환 헤더를 검사하려면 통합 전문가에게 문의하세요.
- 설치에 적용되는 구체적인 속도 제한에 대해 알아보려면 AlisQI 통합 허브를 엽니다.
- AlisQI 통합 허브에서 API 로그를 검사하여 분당 요청 수를 확인합니다.
- API 요청 반환 헤더를 검사하여 상태 코드가
429 Too many requests포함되어 있는지 확인합니다. - 개별 API 요청 반환 헤더를 검사하여 .
X-RateLimit-* headers - 중복 요청을 줄이거나 단일 storeResults 호출에서 여러 결과를 결합하여 통합을 개선할 수 있는지 평가합니다. 여러 결과 캐싱 및 처리와 관련하여 API의 기능을 논의하기 위해 AlisQI 지원에 문의하세요.
- 통합 시나리오가 최적화되었지만 합법적으로 분당 더 많은 호출이 필요한 경우 AlisQI 지원에 문의하여 제한을 높일 수 있는 가능성을 논의하세요.
배포 지침
Microsoft Flow 및 PowerApps에서 이 커넥터를 사용자 지정 커넥터로 배포하려면 다음 지침을 사용하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 결과 또는 마스터 데이터 가져오기 |
선택 목록에서 분석 집합 또는 마스터 데이터에서 (품질) 결과를 가져옵니다. |
| 결과 또는 마스터 데이터 만들기 또는 업데이트 |
선택 목록의 분석 집합 또는 마스터 데이터에서 품질 결과를 만들거나 업데이트합니다. |
| 모든 분석 집합 또는 선택 목록 가져오기 |
(모든) 분석 집합 또는 선택 목록 목록을 가져옵니다. |
| 분석 집합 또는 선택 목록의 구조 가져오기 |
분석 집합 또는 선택 목록의 구조적 정의를 가져옵니다. |
| 분석 집합 필드에 대한 기능 통계 가져오기 |
분석 집합의 숫자 필드에 대한 사양 평가 및 제품 및 프로세스 기능에 대한 자세한 통계를 가져옵니다. |
| 분석 집합 필드에 대한 설명 통계 가져오기 |
선택한 숫자 분석 집합 필드에 대한 설명 통계를 가져옵니다. |
| 사양 버전 가져오기 |
분석 집합에 대한 (a) 사양 버전을 가져옵니다. |
| 새 사양 버전 만들기 |
분석 집합에 대한 (a) 새 사양 버전을 만듭니다. |
결과 또는 마스터 데이터 가져오기
선택 목록에서 분석 집합 또는 마스터 데이터에서 (품질) 결과를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | integer |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
한계
|
limit | integer |
받을 최대 레코드 수를 최대 10,000개까지 지정합니다. |
|
|
상쇄
|
offset | integer |
결과에 대한 시작 위치를 선택합니다. 데이터를 페이징하는 데 유용합니다(기본값은 0). |
|
|
Sort
|
sort | string |
가장 최근의 첫 번째 날짜:desc와 같은 필드 및 방향을 기준으로 데이터의 순서를 결정합니다. |
|
|
Filter
|
filter | string |
JSON 형식 문자열을 사용하여 특정 조건에 따라 요청하는 데이터의 범위를 좁힐 수 있습니다. |
|
|
Fields
|
fields | string |
반환하려는 특정 데이터 요소를 사용하여 쉼표로 구분된 목록입니다. |
|
|
첨부 파일 포함
|
includeAttachments | boolean |
데이터와 함께 파일 첨부 파일을 포함하려면 true로 표시하고, 그렇지 않으면 false로 둡니다. |
|
|
ID 포함
|
includeId | boolean |
데이터에 대한 시스템의 고유한 레코드 번호를 얻으려면 true로 설정하여 관리하거나 참조하기 쉽습니다. |
|
|
마지막 수정 날짜 포함
|
includeLastModificationDate | boolean |
각 데이터의 마지막 변경 날짜를 설정하면 가장 최근 업데이트를 추적하는 데 적합합니다. |
결과 또는 마스터 데이터 만들기 또는 업데이트
선택 목록의 분석 집합 또는 마스터 데이터에서 품질 결과를 만들거나 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | string |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
Results
|
results | True | string |
JSON 개체를 문자열로 지정합니다. |
|
키 필드
|
keyField | string |
이 필드의 값에 따라 기존 결과를 찾아 수정합니다. |
|
|
편집 전용
|
editOnly | string |
keyField와 함께 사용(전용). |
|
|
목록 옵션 추가
|
addListOptions | string |
목록에 새 옵션을 추가하려면 플래그를 지정합니다. |
모든 분석 집합 또는 선택 목록 가져오기
(모든) 분석 집합 또는 선택 목록 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
Groups
|
groups | string |
그룹 ID 또는 이름을 입력하여 특정 그룹을 찾습니다. '선택 목록'을 사용하여 모두 가져옵니다. |
|
|
Names
|
names | string |
검색할 분석 집합 또는 선택 목록의 이름을 입력합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
아이디
|
id | integer |
아이디 |
|
이름
|
name | string |
이름 |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
분석 집합 또는 선택 목록의 구조 가져오기
분석 집합 또는 선택 목록의 구조적 정의를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | integer |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
활성 필드만
|
onlyActiveFields | boolean |
현재 활성 필드만 표시할지 여부입니다. |
|
|
Accept
|
Accept | True | string |
Accept |
분석 집합 필드에 대한 기능 통계 가져오기
분석 집합의 숫자 필드에 대한 사양 평가 및 제품 및 프로세스 기능에 대한 자세한 통계를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | integer |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
Fields
|
fields | True | string |
반환하려는 특정 데이터 요소를 사용하여 쉼표로 구분된 목록입니다. |
|
한계
|
limit | integer |
고려할 최대 결과 수입니다. |
|
|
Filter
|
filter | string |
JSON 형식 문자열을 사용하여 특정 조건에 따라 요청하는 데이터의 범위를 좁힐 수 있습니다. |
분석 집합 필드에 대한 설명 통계 가져오기
선택한 숫자 분석 집합 필드에 대한 설명 통계를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | integer |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
Fields
|
fields | True | string |
반환하려는 특정 데이터 요소를 사용하여 쉼표로 구분된 목록입니다. |
|
한계
|
limit | integer |
고려할 최대 결과 수입니다. |
|
|
Filter
|
filter | string |
JSON 형식 문자열을 사용하여 특정 조건에 따라 요청하는 데이터의 범위를 좁힐 수 있습니다. |
사양 버전 가져오기
분석 집합에 대한 (a) 사양 버전을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | integer |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
인덱스 값
|
indexValue | string |
이 인덱스 값의 현재 사양 버전을 가져옵니다. |
새 사양 버전 만들기
분석 집합에 대한 (a) 새 사양 버전을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
요청에 사용할 하위 도메인입니다. |
|
ID 설정
|
setId | True | string |
관심 있는 분석 집합의 고유 ID를 입력합니다(지금까지 URL에서 maskid라고 함). |
|
사양
|
specs | True | string |
JSON 개체를 문자열로 지정합니다. |
|
인덱스 값
|
indexValue | string |
인덱스 필드 값입니다. |
|
|
시작 날짜 시간
|
startDateTime | string |
yyyy-mm-dd hh:mm:ss 또는 unix stimestamp로 형식이 지정됩니다. |
|
|
이유
|
reason | string |
사양을 변경하는 이유입니다. |
반환
- response
- boolean
정의
불리언
기본 데이터 형식 'boolean'입니다.