Igor Octaviano
c4ff2c2f09
Add the ability to merge two different series queries to generate a complete study query result. Provides basic support for other types of merges, but those aren't yet added as full features.
93 lines
3.0 KiB
JavaScript
93 lines
3.0 KiB
JavaScript
import retrieveMetadataFiltered from './utils/retrieveMetadataFiltered.js';
|
|
import RetrieveMetadata from './wado/retrieveMetadata.js';
|
|
|
|
const moduleName = 'RetrieveStudyMetadata';
|
|
// Cache for promises. Prevents unnecessary subsequent calls to the server
|
|
const StudyMetaDataPromises = new Map();
|
|
|
|
/**
|
|
* Retrieves study metadata.
|
|
*
|
|
* @param {Object} dicomWebClient The DICOMWebClient instance to be used for series load
|
|
* @param {string} StudyInstanceUID The UID of the Study to be retrieved
|
|
* @param {boolean} enableStudyLazyLoad Whether the study metadata should be loaded asynchronously.
|
|
* @param {Object} [filters] Object containing filters to be applied on retrieve metadata process
|
|
* @param {string} [filters.seriesInstanceUID] Series instance uid to filter results against
|
|
* @param {array} [filters.SeriesInstanceUIDs] Series instance uids to filter results against
|
|
* @param {function} [sortCriteria] Sort criteria function
|
|
* @param {function} [sortFunction] Sort function
|
|
*
|
|
* @returns {Promise} that will be resolved with the metadata or rejected with the error
|
|
*/
|
|
export function retrieveStudyMetadata(
|
|
dicomWebClient,
|
|
StudyInstanceUID,
|
|
enableStudyLazyLoad,
|
|
filters,
|
|
sortCriteria,
|
|
sortFunction,
|
|
dicomWebConfig = {}
|
|
) {
|
|
// @TODO: Whenever a study metadata request has failed, its related promise will be rejected once and for all
|
|
// and further requests for that metadata will always fail. On failure, we probably need to remove the
|
|
// corresponding promise from the "StudyMetaDataPromises" map...
|
|
|
|
if (!dicomWebClient) {
|
|
throw new Error(`${moduleName}: Required 'dicomWebClient' parameter not provided.`);
|
|
}
|
|
if (!StudyInstanceUID) {
|
|
throw new Error(`${moduleName}: Required 'StudyInstanceUID' parameter not provided.`);
|
|
}
|
|
|
|
const promiseId = `${dicomWebConfig.name}:${StudyInstanceUID}`;
|
|
|
|
// Already waiting on result? Return cached promise
|
|
if (StudyMetaDataPromises.has(promiseId)) {
|
|
return StudyMetaDataPromises.get(promiseId);
|
|
}
|
|
|
|
let promise;
|
|
|
|
if (filters && filters.SeriesInstanceUIDs) {
|
|
promise = retrieveMetadataFiltered(
|
|
dicomWebClient,
|
|
StudyInstanceUID,
|
|
enableStudyLazyLoad,
|
|
filters,
|
|
sortCriteria,
|
|
sortFunction
|
|
);
|
|
} else {
|
|
// Create a promise to handle the data retrieval
|
|
promise = new Promise((resolve, reject) => {
|
|
RetrieveMetadata(
|
|
dicomWebClient,
|
|
StudyInstanceUID,
|
|
enableStudyLazyLoad,
|
|
filters,
|
|
sortCriteria,
|
|
sortFunction
|
|
).then(function (data) {
|
|
resolve(data);
|
|
}, reject);
|
|
});
|
|
}
|
|
|
|
// Store the promise in cache
|
|
StudyMetaDataPromises.set(promiseId, promise);
|
|
|
|
return promise;
|
|
}
|
|
|
|
/**
|
|
* Delete the cached study metadata retrieval promise to ensure that the browser will
|
|
* re-retrieve the study metadata when it is next requested.
|
|
*
|
|
* @param {String} StudyInstanceUID The UID of the Study to be removed from cache
|
|
*/
|
|
export function deleteStudyMetadataPromise(StudyInstanceUID) {
|
|
if (StudyMetaDataPromises.has(StudyInstanceUID)) {
|
|
StudyMetaDataPromises.delete(StudyInstanceUID);
|
|
}
|
|
}
|