AlisQI （預覽版）
使用 AlisQI 的連接工具將您的 QMS 與您的 ERP、MES、PLM、儀器、感測器或網站整合。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | AlisQI 支持 |
| URL | https://help.alisqi.com/ |
| support@alisqi.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 艾利斯奇 BV |
| 網站 | https://www.alisqi.com |
| 隱私策略 | https://www.alisqi.com/en/privacy-statement |
| 類別 | 商務管理 |
艾利斯奇
使用 AlisQI 的連接工具將您的 QMS 與您的 ERP、MES、PLM、儀器、感測器或網站整合。
發行商：AlisQI BV
先決條件
若要使用此聯結器，您將需要下列專案：
- 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 呼叫中合併多個結果來改善整合。 請隨時聯絡 AlisQI 支援人員，討論我們的 API 在快取和處理多個結果方面的功能。
- 如果您的整合案例已最佳化，但每分鐘需要更多呼叫，請聯絡 AlisQI 支援人員，討論提高限制的可能性。
部署指示
請使用 這些指示 ，在 Microsoft Flow 和 PowerApps 中將此連接器部署為自訂連接器。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得分析集或選取清單的結構 |
取得分析集或選取清單的結構定義。 |
| 取得分析集欄位的功能統計資料 |
取得分析集數值欄位的規格評估以及產品和製程能力的深入統計資料。 |
| 取得分析集欄位的描述性統計量 |
取得您選擇的數值分析集欄位的描述性統計量。 |
| 取得所有分析集或選取清單 |
取得 （所有） 分析集或選取清單的清單。 |
| 取得結果或主資料 |
從分析集取得 （品質） 結果，或從選取清單取得主資料。 |
| 取得規格版本 |
取得分析集的 （a） 規格版本。 |
| 建立或更新結果或主資料 |
在分析集中建立或更新品質結果，或在選取清單中建立或更新主資料。 |
| 建立新的規格版本 |
為分析集建立 （a） 新的規格版本。 |
取得分析集或選取清單的結構
取得分析集或選取清單的結構定義。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | integer |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
僅作用中欄位
|
onlyActiveFields | boolean |
是否只顯示目前使用中的欄位。 |
|
|
接受
|
Accept | True | string |
接受 |
取得分析集欄位的功能統計資料
取得分析集數值欄位的規格評估以及產品和製程能力的深入統計資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | integer |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
Fields
|
fields | True | string |
逗號分隔的列表，其中包含您要傳回的特定資料點。 |
|
限制
|
limit | integer |
要考慮的結果數目上限。 |
|
|
Filter
|
filter | string |
使用 JSON 格式的字串，根據特定條件縮小您請求的資料範圍。 |
取得分析集欄位的描述性統計量
取得您選擇的數值分析集欄位的描述性統計量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | integer |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
Fields
|
fields | True | string |
逗號分隔的列表，其中包含您要傳回的特定資料點。 |
|
限制
|
limit | integer |
要考慮的結果數目上限。 |
|
|
Filter
|
filter | string |
使用 JSON 格式的字串，根據特定條件縮小您請求的資料範圍。 |
取得所有分析集或選取清單
取得 （所有） 分析集或選取清單的清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
Groups
|
groups | string |
輸入群組 ID 或名稱以查找特定群組，使用“選擇列表”獲取所有群組。 |
|
|
Names
|
names | string |
輸入您要擷取的分析集或選取清單的名稱。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
識別碼
|
id | integer |
識別碼 |
|
名稱
|
name | string |
名稱 |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
取得結果或主資料
從分析集取得 （品質） 結果，或從選取清單取得主資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | integer |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
限制
|
limit | integer |
指定您要接收的記錄數目上限，上限為 10,000 筆。 |
|
|
Offset
|
offset | integer |
選擇結果的起始位置，對於分頁資料很有用（預設為 0）。 |
|
|
排序
|
sort | string |
按字段和方向確定數據的順序，例如最近的第一個日期：desc。 |
|
|
Filter
|
filter | string |
使用 JSON 格式的字串，根據特定條件縮小您請求的資料範圍。 |
|
|
Fields
|
fields | string |
逗號分隔的列表，其中包含您要傳回的特定資料點。 |
|
|
包括附件
|
includeAttachments | boolean |
如果您想要在資料中包含任何檔案附件，請將 true 標記為 true，否則保留為 false。 |
|
|
包含 ID
|
includeId | boolean |
如果您想要取得資料的系統唯一記錄號碼，請設定為 true，以便更輕鬆地管理或參考。 |
|
|
包括上次修改日期
|
includeLastModificationDate | boolean |
開啟以取得每項資料的最後變更日期，這對於追蹤最新更新非常有用。 |
取得規格版本
取得分析集的 （a） 規格版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | integer |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
指數值
|
indexValue | string |
取得此索引值的目前規格版本。 |
建立或更新結果或主資料
在分析集中建立或更新品質結果，或在選取清單中建立或更新主資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subdomain
|
subdomain | True | string |
要用於請求的子網域。 |
|
設定 ID
|
setId | True | string |
輸入您感興趣的分析集的唯一 ID （在 URL 中歷來稱為 maskid）。 |
|
Results
|
results | True | string |
JSON 物件做為字串。 |
|
關鍵欄位
|
keyField | string |
根據此欄位的值尋找和修改現有結果。 |
|
|
僅編輯
|
editOnly | string |
（僅）與 keyField 結合使用。 |
|
|
新增清單選項
|
addListOptions | string |
旗標以將新選項新增至清單。 |
建立新的規格版本
為分析集建立 （a） 新的規格版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 時間戳記。 |
|
|
原因
|
reason | string |
更改規格的原因。 |
傳回
- response
- boolean
定義
布爾值
這是基本資料類型「布林值」。