Handle pagination in FHIR search

[jenniferjiangkells]

Description

Context

Possible Implementation

# Handle paginated results
def process_all_patients(results: Bundle):
    for entry in results.entry:
        yield entry.resource

# Get first page
results = await gateway.search(Patient, {"family": "Smith"}, "epic")

# Process all pages
for patient in process_all_patients(results):
    print(f"Processing patient: {patient.id}")

# Get next page if available
if results.link:
    next_url = next((link.url for link in results.link if link.relation == "next"), None)
    if next_url:
        # Handle next page...
        pass

[RakinduM]

Hi @jenniferjiangkells, I would like to work on this issue. Could you assign it to me ?
And I would like to know more about context if the issue.

[jenniferjiangkells]

@RakinduM Hi thanks for your interest. Do you have any experience with FHIR APIs? You can take a look at the docs to start with - FHIR API FHIR Bundle Resource

[RakinduM]

Hi @jenniferjiangkells, I have experiences with API implementations but not specifically with FHIR. I've gone through the document, So this will be a good opportunity for me to learn while working on this issue.

[jenniferjiangkells]

@RakinduM Ah great, yes this would be a good issue for you then - it's pretty much just about implementing pagination to the search() operation according to the FHIR API specs. Google Healthcare API references has good resources for context too.

Relevant files:

• healthchain/gateway/fhir/sync.py - FHIRGateway.search()
• healthchain/gateway/fhir/aio.py - AsyncFHIRGateway.search()

I'll leave the implementation details up to you but maybe adding something like

• follow_pagination: bool = False - Auto-fetch all pages
• max_pages: Optional[int] = None - Safety limit

would be a good place to start. Let me know if you need anything else!

[RakinduM]

@jenniferjiangkells Thanks for the info, I'll start working on it.

[RakinduM]

Hi @jenniferjiangkells, I submitted a PR #153 with handling pagination in FHIRGateway.search(). Kindly could you give me a feedback on the work done ? In the meantime I'll finish working on AsyncFHIRGateway.search() :)

[RakinduM]

@jenniferjiangkells, I have added the pagination to AsyncFHIR as well.