AlisQI (プレビュー)
AlisQIの接続ツールを使用して、QMSをERP、MES、PLM、計測器、センサー、またはウェブサイトと統合します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | AlisQI サポート |
| URL | https://help.alisqi.com/ |
| support@alisqi.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | AlisQI BV |
| Website | 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仕様バージョンの取得: 分析セットの仕様バージョンを取得します。新しい仕様バージョンの作成
/storeSpecificationVersion: 分析セットの新しい仕様バージョンを作成します。解析セットまたは選択リストの構造を取得
/getSetDefinition: 解析セットまたは選択リストの構造定義を取得します。
資格情報の取得
すべての API 呼び出しは認証の対象となります。 AlisQI API エンドポイントを呼び出すには、開発者が認証トークンを作成する必要があります。
API では、 ベアラー認証仕様がサポートされています。
各トークンは 1 人のユーザーに接続されます。 このユーザーが (そのユーザー グループを介して) 分析セットに対して持っている読み取り、挿入、更新のアクセス許可は、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 統合や不正使用からシステム上の望ましくない負荷を防ぐために設計されています。 レート制限の既定値は、1 分あたり 30 回です。 これは、読み取り操作と書き込み操作の両方に適用されます。 レート制限に達した要求には、
429 Too many requestsの状態コードが含まれます。
すべての応答には、制限と残りの呼び出しに関する明示的な番号を含む次のヘッダーが含まれます。
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Retry-After
レート制限によって発生する可能性がある、または原因となる可能性がある統合シナリオの問題をデバッグするには、次のチェックリストを参照してください。
- API 呼び出しとリターン ヘッダーを調べるには、統合スペシャリストに問い合わせてください。
- AlisQI 統合ハブを開いて、インストールに適用される具体的なレート制限について学習します。
- AlisQI 統合ハブの API ログを調べて、1 分あたりの要求数を確認します。
- API 要求のリターン ヘッダーを調べて、
429 Too many requests状態コードが含まれているかどうかを確認します。 - 個々の API 要求のリターン ヘッダーを調べて、
X-RateLimit-* headersを評価します。 - 重複する要求を減らすか、複数の結果を組み合わせて 1 つの storeResults 呼び出しで統合を改善できるかどうかを評価します。 複数の結果のキャッシュと処理に関する API の機能については、AlisQI サポートにお問い合わせください。
- 統合シナリオが最適化されていても、1 分あたりの呼び出しが正当に必要な場合は、AlisQI サポートに連絡して、制限を引き上げる可能性について説明してください。
デプロイの手順
このコネクタをカスタム コネクタとして Microsoft Flow および PowerApps にデプロイするには、 次の手順に従 ってください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | この API の API キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべての分析セットまたは選択リストを取得する |
(すべての) 分析セットまたは選択リストの一覧を取得します。 |
| 仕様バージョンを取得する |
(a) 分析セットの仕様バージョンを取得します。 |
| 分析セット フィールドの機能統計を取得する |
分析セットの数値フィールドの仕様評価と製品とプロセスの機能の詳細な統計情報を取得します。 |
| 分析セット フィールドの説明的な統計情報を取得する |
選択した数値分析セット フィールドの説明的な統計情報を取得します。 |
| 分析セットまたは選択リストの構造を取得する |
解析セットまたは選択リストの構造定義を取得します。 |
| 新しい仕様バージョンを作成する |
(a) 分析セットの新しい仕様バージョンを作成します。 |
| 結果またはマスター データを作成または更新する |
選択リストの分析セットまたはマスター データで品質結果を作成または更新します。 |
| 結果またはマスター データを取得する |
選択リストから分析セットまたはマスター データから結果を取得 (品質) します。 |
すべての分析セットまたは選択リストを取得する
(すべての) 分析セットまたは選択リストの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
Groups
|
groups | string |
グループ ID または名前を入力して特定のグループを検索し、[選択リスト] を使用してすべてを取得します。 |
|
|
Names
|
names | string |
取得する分析セットまたは選択リストの名前を入力します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | integer |
id |
|
名前
|
name | string |
名前 |
|
groupId
|
groupId | integer |
groupId |
|
groupName
|
groupName | string |
groupName |
|
topLevelMenu
|
topLevelMenu | string |
topLevelMenu |
仕様バージョンを取得する
(a) 分析セットの仕様バージョンを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | integer |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
インデックス値
|
indexValue | string |
このインデックス値の現在の仕様バージョンを取得します。 |
分析セット フィールドの機能統計を取得する
分析セットの数値フィールドの仕様評価と製品とプロセスの機能の詳細な統計情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | integer |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
Fields
|
fields | True | string |
返される特定のデータ ポイントを含むコンマ区切りリスト。 |
|
極限
|
limit | integer |
考慮する結果の最大数。 |
|
|
Filter
|
filter | string |
JSON 形式の文字列を使用して、特定の条件に基づいて要求するデータを絞り込みます。 |
分析セット フィールドの説明的な統計情報を取得する
選択した数値分析セット フィールドの説明的な統計情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | integer |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
Fields
|
fields | True | string |
返される特定のデータ ポイントを含むコンマ区切りリスト。 |
|
極限
|
limit | integer |
考慮する結果の最大数。 |
|
|
Filter
|
filter | string |
JSON 形式の文字列を使用して、特定の条件に基づいて要求するデータを絞り込みます。 |
分析セットまたは選択リストの構造を取得する
解析セットまたは選択リストの構造定義を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | integer |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
アクティブなフィールドのみ
|
onlyActiveFields | boolean |
現在アクティブなフィールドのみを表示するかどうかを指定します。 |
|
|
Accept
|
Accept | True | string |
Accept |
新しい仕様バージョンを作成する
(a) 分析セットの新しい仕様バージョンを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
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
結果またはマスター データを作成または更新する
選択リストの分析セットまたはマスター データで品質結果を作成または更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | string |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
結果
|
results | True | string |
文字列としての JSON オブジェクト。 |
|
キー フィールド
|
keyField | string |
このフィールドの値に基づいて既存の結果を検索および変更します。 |
|
|
編集のみ
|
editOnly | string |
keyField と組み合わせて (のみ) 使用します。 |
|
|
リスト オプションの追加
|
addListOptions | string |
リストに新しいオプションを追加するフラグ。 |
結果またはマスター データを取得する
選択リストから分析セットまたはマスター データから結果を取得 (品質) します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブドメイン
|
subdomain | True | string |
要求に使用するサブドメイン。 |
|
ID の設定
|
setId | True | integer |
関心のある分析セットの一意の ID を入力します (URL では、従来は maskid と呼ばれます)。 |
|
極限
|
limit | integer |
受信するレコードの最大数 (上限は 10,000) を指定します。 |
|
|
オフセット
|
offset | integer |
結果の開始位置を選択します。データのページングに役立ちます (既定値は 0)。 |
|
|
ソート
|
sort | string |
フィールドと方向によってデータの順序を決定します (最新の最初の date:desc など)。 |
|
|
Filter
|
filter | string |
JSON 形式の文字列を使用して、特定の条件に基づいて要求するデータを絞り込みます。 |
|
|
Fields
|
fields | string |
返される特定のデータ ポイントを含むコンマ区切りリスト。 |
|
|
添付ファイルを含める
|
includeAttachments | boolean |
データに添付ファイルを含める場合は true、それ以外の場合は false のままにします。 |
|
|
含める ID
|
includeId | boolean |
データのシステムの一意のレコード番号を取得し、管理や参照を容易にする場合は true に設定します。 |
|
|
最終変更日を含める
|
includeLastModificationDate | boolean |
オンにすると、各データの最後の変更日が取得されます。これは、最新の更新を追跡するのに最適です。 |
定義
ブーリアン
これは基本的なデータ型 'boolean' です。