FHIR Bulk Data

• Вы создаёте клиент для массовой передачи данных, которому необходимо инициировать экспорт, опрашивать статус и загружать файлы NDJSON с FHIR-сервера.
• Вы реализуете серверную поддержку $export и вам нужно разобраться в требованиях соответствия, структуре манифеста или объявлениях CapabilityStatement.
• Вам нужно фильтровать большие экспорты по типу ресурса, диапазону дат или критериям поиска FHIR с использованием таких параметров, как _type, _since или _typeFilter.
• Вы интегрируете SMART Backend Services (учётные данные клиента OAuth 2.0 + JWT) для защищённого межсерверного массового доступа.

• Вам нужно получать отдельные FHIR-ресурсы через стандартный REST — используйте вместо этого общий FHIR-навык.
• Ваш сценарий использования предполагает потоковую передачу данных в реальном или почти реальном времени, а не пакетный экспорт.
• Вы работаете с проприетарным форматом массового экспорта, который не соответствует HL7 Bulk Data Access IG.

Проведёт вас через каждый этап жизненного цикла массового экспорта: начальный запрос, обработку ответа 202 Accepted, опрос статуса с заголовками Retry-After и X-Progress, разбор манифеста, загрузку файлов и очистку с помощью DELETE.

Охватывает Patient/$export (все пациенты), Group/[id]/$export (область когорты) и [base]/$export (системный уровень), включая информацию о том, когда использовать каждую из них и как область применения влияет на результат.

Подробное руководство по всем поддерживаемым параметрам: _outputFormat, _since, _until, _type, _elements, _typeFilter, includeAssociatedData, organizeOutputBy и allowPartialManifests.

Точные правила создания и обработки Newline Delimited JSON: один ресурс на строку, кодировка UTF-8, корректное завершение строк, отсутствие встроенных символов новой строки и правильный тип медиа (application/fhir+ndjson).

Объясняет поток клиентских учётных данных OAuth 2.0 с JWT-подтверждением, необходимым для массового серверного доступа, включая структуру запроса токена и использование токена-носителя (bearer token).

Охватывает интерпретацию OperationOutcome, ограничение частоты запросов (429 Too Many Requests), истечение срока действия токена (401), отсутствие задания (404), а также стратегии для устойчивых клиентов опроса в FHIR Bulk Data.

Реализуйте клиент, который инициирует экспорт, опрашивает URL статуса с экспоненциальной задержкой, анализирует полный манифест и передаёт файлы NDJSON потоком для последующей обработки.

Настройте FHIR-сервер для поддержки $export, возврата корректных HTTP-ответов на каждом этапе рабочего процесса и объявления соответствия через CapabilityStatement.

Используйте Group/$export с параметрами _type, _since и _typeFilter для экспорта только тех типов ресурсов и временных диапазонов, которые необходимы для конкретного аналитического или исследовательского сценария использования.

Диагностируйте и устраняйте ошибки массового экспорта, интерпретируя ответы OperationOutcome, понимая семантику HTTP-статусов и обрабатывая граничные случаи, такие как частичные манифесты и постраничный вывод.