Question:
Platform APIで検索すると、以下のエラーが発生するのはなぜですか?
Platform APIで検索すると、以下のエラーが発生するのはなぜですか?
未処理の例外です:DocuWare.Services.Http.Client.HttpClientRequestException:422 Unprocessable Entity (要求された検索結果数が、1リクエストあたりのシステム制限である10000を超えています。カウント値を下げ、結果のページングを使用してください)。
回答
Platform APIを介した1回の検索コールでリクエストできる検索結果は最大10,000件です。 大きすぎる検索クエリはクラウドシステムに負荷をかけすぎる可能性があり、作業プロセスに悪影響を及ぼしたり、検索クエリが拒否されたり する可能性があります。 これを防ぐには、以下の例と推奨事項を参照してください;
回答
Platform APIを介した1回の検索コールでリクエストできる検索結果は最大10,000件です。 大きすぎる検索クエリはクラウドシステムに負荷をかけすぎる可能性があり、作業プロセスに悪影響を及ぼしたり、検索クエリが拒否されたり する可能性があります。 これを防ぐには、以下の例と推奨事項を参照してください;
.NET API (C#)
ダイアログ式を使ってクエリを実行する例を更新しましたので、ご確認ください。
ダイアログ式を使ってクエリを実行する例を更新しましたので、ご確認ください。
REST API:
以下の呼び出しの count パラメーターの最大値は 10.000 です。
- /DocuWare/Platform/FileCabinets/{fileCabinetId}/Query/DialogExpression?dialogId={dialogId}&fields={fields}&sortOrder={sortOrder}&start={start}&count={count}。
- /DocuWare/Platform/FileCabinet/{fileCabinetId}/Query/FunctionExpression?fields={fields}&sortOrder={sortOrder}&start={start}&count={count}。
- /DocuWare/Platform/FileCabinet/{fileCabinetId}/Documents?q={q}&fields={fields}&sortOrder={sortOrder}&start={start}&msStart={msStart}&count={count}&format={format}&includeSuggestions={includeSuggestions}&csvDelimiter={csvDelimiter}&csvIsUtc={csvIsUtc}&calculateTotalCount={calculateTotalCount}。
- /DocuWare/Platform/FileCabinet/{fileCabinetId}/Query/Documents?q={q}&fields={fields}&sortOrder={sortOrder}&start={start}&count={count}&format={format}&additionalCabinets={additionalCabinets}&。encodingName={encodingName}&csvDelimiter={csvDelimiter}&csvIsUtc={csvIsUtc}&includeSuggestions={includeSuggestions}&calculateTotalCount={calculateTotalCount}。
countパラメータが許容値を超えた場合、以下の応答が返されます:
- ステータス・コード HTTPステータスコード422(処理不能エンティティ)
- 例外:SearchResultLimitExceededException
この場合、countパラメータを有効な値に調整してください。
すべての文書を受信し続けるには、複数の連続検索 (ページング) を使用してください。 start パラメータを使用して、全結果セットのどの文書から配信を開始するかを制御できます。
例については、更新されたPostmanコレクションをご確認ください。
KBAはクラウド組織のみに適用されます。
ご注意:この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。