複数コール統合

リリースバージョン: Xanadu

更新日 2024年08月01日

所要時間：1分

複数のコール (または複数のページ) の統合スクリプトは少し複雑です。データを取得するには、データソースを複数回呼び出す必要があります。

単一コール統合と同様に、複数コール統合にも retrieveData() が実装されている必要があります。retrieveData() の本体では、統合は VulnerabilityIntegrationBase によって提供される hasMoreData() および setNextRunParameters() メソッドを使用します。

hasMoreData() メソッドは、VulnerabilityIntegrationController に、より多くのデータをプルするためのプロセスを挿入するよう指示する単一のブール値を受け入れます。hasMoreData() に true を渡すと、次のプロセスにコンテキストを提供するために setNextRunParameters() が呼び出されます。

setNextRunParameters() メソッドは、次に retrieveData() を呼び出す際に使用されるコンテキスト情報を提供する単一のオブジェクトを受け入れます。このオブジェクトは、後続の retrieveData() の呼び出しにステータスを渡すために使用されます。ユースケースの例としては、現在のページ番号とページサイズを示すオブジェクトを Web サービスに渡すことが挙げられます。

複数コール統合の場合、各 retrieveData() コールが最初に現在のプロセスパラメーターをチェックします。_getProcessParameters() メソッドは、すべての VulnerabilityIntegrationBase に、前のプロセスで設定されたパラメーターを取得する利便性として提供されます。パラメーターがない場合は、最初のプロセスであることを示します。

次のスクリーンショットは、複数コール統合スクリプトのサンプルを示しています。このスクリプトでは、単一コール統合の例を拡張して、基本的なページネーションをサポートする REST エンドポイントの呼び出しを示しています。1 ページのデータを取得し、取得するデータがまだあることを認識して、次のプロセスに取得するページを指示する方法を示しています。