$questionnaire-packageFHIR-Operation für HealthLake

Bei diesem $questionnaire-package Vorgang wird ein umfangreiches Paket abgerufen, das einen FHIR-Fragebogen und all seine Abhängigkeiten enthält, die für das Rendern und Verarbeiten des Fragebogens erforderlich sind. Bei diesem Vorgang wird der Implementierungsleitfaden für Da Vinci Documentation Templates and Rules (DTR) implementiert, der ein dynamisches Rendern von Formularen für Dokumentationsanforderungen in Arbeitsabläufen im Gesundheitswesen ermöglicht.

Funktionsweise

Anwendungsfälle

API-Endpunkt

POST /datastore/{datastoreId}/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json

Anforderungsparameter

Eingabeparameter

Der Anfragetext muss eine FHIR-Parameter-Ressource mit den folgenden Parametern enthalten:

Regeln für die Parametervalidierung

Mindestens EINE der folgenden Angaben muss angegeben werden (zusätzlich zu den erforderlichen Angabencoverage):

Gültige Anforderungskombinationen:

Beispielanforderung

POST /datastore/example-datastore/r4/Questionnaire/$questionnaire-package  
Content-Type: application/fhir+json  
Authorization: Bearer <your-token>  
  
{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": {  
        "resourceType": "Coverage",  
        "id": "example-coverage",  
        "status": "active",  
        "beneficiary": {  
          "reference": "Patient/example-patient"  
        },  
        "payor": [{  
          "reference": "Organization/example-payer"  
        }],  
        "class": [{  
          "type": {  
            "coding": [{  
              "system": "http://terminology.hl7.org/CodeSystem/coverage-class",  
              "code": "group"  
            }]  
          },  
          "value": "12345"  
        }]  
      }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0"  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "id": "example-service-request",  
        "status": "active",  
        "intent": "order",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660",  
            "display": "Continuous positive airway pressure ventilation (CPAP)"  
          }]  
        },  
        "subject": {  
          "reference": "Patient/example-patient"  
        }  
      }  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-01-01T00:00:00Z"  
    }  
  ]  
}

Reaktionsformat

Erfolgreiche Antwort (200 OK)

Die Operation gibt eine FHIR-Parameter-Ressource zurück, die ein oder mehrere Paketpakete enthält. Jedes Package beinhaltet:

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "PackageBundle",  
      "resource": {  
        "resourceType": "Bundle",  
        "id": "questionnaire-package-example",  
        "meta": {  
          "profile": ["http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/DTR-QPackageBundle"]  
        },  
        "type": "collection",  
        "timestamp": "2024-03-15T10:30:00Z",  
        "entry": [  
          {  
            "fullUrl": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
            "resource": {  
              "resourceType": "Questionnaire",  
              "id": "home-oxygen-therapy",  
              "url": "http://example.org/fhir/Questionnaire/home-oxygen-therapy",  
              "version": "2.0",  
              "status": "active",  
              "title": "Home Oxygen Therapy Documentation",  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "type": "choice",  
                  "answerValueSet": "http://example.org/fhir/ValueSet/oxygen-diagnoses"  
                }  
              ]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/Library/oxygen-prepopulation",  
            "resource": {  
              "resourceType": "Library",  
              "id": "oxygen-prepopulation",  
              "url": "http://example.org/fhir/Library/oxygen-prepopulation",  
              "version": "1.0",  
              "type": {  
                "coding": [{  
                  "system": "http://terminology.hl7.org/CodeSystem/library-type",  
                  "code": "logic-library"  
                }]  
              },  
              "content": [{  
                "contentType": "text/cql",  
                "data": "bGlicmFyeSBPeHlnZW5QcmVwb3B1bGF0aW9u..."  
              }]  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
            "resource": {  
              "resourceType": "ValueSet",  
              "id": "oxygen-diagnoses",  
              "url": "http://example.org/fhir/ValueSet/oxygen-diagnoses",  
              "status": "active",  
              "expansion": {  
                "timestamp": "2024-03-15T10:30:00Z",  
                "contains": [  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J44.0",  
                    "display": "COPD with acute lower respiratory infection"  
                  },  
                  {  
                    "system": "http://hl7.org/fhir/sid/icd-10",  
                    "code": "J96.01",  
                    "display": "Acute respiratory failure with hypoxia"  
                  }  
                ]  
              }  
            }  
          },  
          {  
            "fullUrl": "http://example.org/fhir/QuestionnaireResponse/example-prepopulated",  
            "resource": {  
              "resourceType": "QuestionnaireResponse",  
              "id": "example-prepopulated",  
              "questionnaire": "http://example.org/fhir/Questionnaire/home-oxygen-therapy|2.0",  
              "status": "in-progress",  
              "subject": {  
                "reference": "Patient/example-patient"  
              },  
              "basedOn": [{  
                "reference": "ServiceRequest/example-service-request"  
              }],  
              "item": [  
                {  
                  "linkId": "1",  
                  "text": "Patient diagnosis",  
                  "answer": [{  
                    "valueCoding": {  
                      "system": "http://hl7.org/fhir/sid/icd-10",  
                      "code": "J44.0",  
                      "display": "COPD with acute lower respiratory infection"  
                    }  
                  }]  
                }  
              ]  
            }  
          }  
        ]  
      }  
    },  
    {  
      "name": "Outcome",  
      "resource": {  
        "resourceType": "OperationOutcome",  
        "issue": [{  
          "severity": "information",  
          "code": "informational",  
          "details": {  
            "text": "Successfully retrieved questionnaire package"  
          }  
        }]  
      }  
    }  
  ]  
}

Arbeitsablauf bei der Bedienung

Wie wird Ihre Anfrage HealthLake bearbeitet

HealthLake Führt bei $questionnaire-package Ihrem Anruf die folgenden Schritte aus:

Ergebnis: Ein vollständiges, eigenständiges Paket, das zum Rendern bereit ist.

Fehlermeldungen

400 Bad Request (400 Ungültige Anfrage)

Wird zurückgegeben, wenn die Überprüfung der Anfrage fehlschlägt.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "error",  
    "code": "required",  
    "details": {  
      "text": "At least one of 'questionnaire' or 'order' must be provided along with 'coverage'"  
    }  
  }]  
}

424 Fehlgeschlagene Abhängigkeit

Wird zurückgegeben, wenn eine abhängige Ressource nicht abgerufen werden kann.

{  
  "resourceType": "OperationOutcome",  
  "issue": [{  
    "severity": "warning",  
    "code": "not-found",  
    "details": {  
      "text": "Referenced Library 'http://example.org/fhir/Library/missing-library' could not be retrieved"  
    }  
  }]  
}

401 Nicht autorisiert

Wird zurückgegeben, wenn Anmeldeinformationen fehlen oder ungültig sind.

403 Forbidden

Wird zurückgegeben, wenn der authentifizierte Benutzer nicht berechtigt ist, auf die angeforderten Ressourcen zuzugreifen.

406 Nicht akzeptabel

Wird zurückgegeben, wenn der angeforderte Inhaltstyp nicht bereitgestellt werden kann.

409 Conflict (409 Konflikt)

Wird zurückgegeben, wenn ein Versions- oder Parallelitätskonflikt vorliegt.

410 Verschwunden

Wird zurückgegeben, wenn die angeforderte Ressource dauerhaft gelöscht wurde.

429 Zu viele Anfragen

Wird zurückgegeben, wenn die Ratenlimits überschritten werden.

500 Internal Server Error

Wird zurückgegeben, wenn ein unerwarteter Serverfehler auftritt.

501 Nicht implementiert

Wird zurückgegeben, wenn der angeforderte Vorgang noch nicht implementiert ist.

Validierungsregeln

Überprüfung von Eingaben

QuestionnaireResponse Validierung

Deduplizierung von Ressourcen

Leistungsspezifikationen

Erforderliche Berechtigungen

Um den $questionnaire-package Vorgang verwenden zu können, stellen Sie sicher, dass Ihre IAM-Rolle über Folgendes verfügt:

SMART auf FHIR-Zielfernrohren

Erforderliche Mindestbereiche:

Wichtige Hinweise zur Implementierung

Strategie zum Abruf von Ressourcen

Priorität bei der Identifizierung des Fragebogens:

Auflösung von Abhängigkeiten

CQL-Bibliotheken:

ValueSets:

QuestionnaireResponse Vorbevölkerung

Die Operation kann in folgenden Fällen eine QuestionnaireResponse mit bereits ausgefüllten Daten zurückgeben:

Suchkriterien für QuestionnaireResponse:

Die Filterung der Ressourcen wurde geändert

Wenn der changedSince Parameter bereitgestellt wird:

Mehrere Paketpakete

Der Vorgang kann mehrere Paketpakete zurückgeben, wenn:

Jedes Package ist eigenständig mit allen erforderlichen Abhängigkeiten.

Häufige Anwendungsfälle

Anwendungsfall 1: Dokumentation zur vorherigen Autorisierung

Szenario: Ein Anbieter muss vor der Genehmigung Unterlagen für eine Sauerstofftherapie zu Hause sammeln.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Patient's insurance coverage */ }  
    },  
    {  
      "name": "order",  
      "resource": {  
        "resourceType": "ServiceRequest",  
        "code": {  
          "coding": [{  
            "system": "http://www.ama-assn.org/go/cpt",  
            "code": "94660"  
          }]  
        }  
      }  
    }  
  ]  
}

Ergebnis: Gibt ein Paket mit dem Fragebogen zur Sauerstofftherapie zurück, der bereits mit den Patientendaten und Diagnosecodes aus dem EHR ausgefüllt ist.

Anwendungsfall 2: Rufen Sie eine bestimmte Version des Fragebogens ab

Szenario: Ein Anbieter benötigt zur Einhaltung der Vorschriften eine bestimmte Version eines Fragebogens.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/dme-request|3.1.0"  
    }  
  ]  
}

Ergebnis: Gibt genau Version 3.1.0 des DME-Anforderungsfragebogens mit allen Abhängigkeiten zurück.

Anwendungsfall 3: Nach Updates suchen

Szenario: Ein Anbieter möchte überprüfen, ob Fragebogenressourcen seit dem letzten Abruf aktualisiert wurden.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "questionnaire",  
      "valueCanonical": "http://example.org/fhir/Questionnaire/medication-request"  
    },  
    {  
      "name": "changedSince",  
      "valueDateTime": "2024-03-01T00:00:00Z"  
    }  
  ]  
}

Ergebnis: Gibt nur Ressourcen zurück, die nach dem 1. März 2024 geändert wurden, oder ein leeres Paket, falls sich nichts geändert hat.

Anwendungsfall 4: Mehrere Bestellungen

Szenario: Ein Anbieter reicht mehrere Serviceanfragen ein, für die möglicherweise unterschiedliche Fragebögen erforderlich sind.

{  
  "resourceType": "Parameters",  
  "parameter": [  
    {  
      "name": "coverage",  
      "resource": { /* Coverage resource */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for imaging */ }  
    },  
    {  
      "name": "order",  
      "resource": { /* ServiceRequest for DME */ }  
    }  
  ]  
}

Ergebnis: Gibt mehrere Paketpakete zurück, eines für jeden zutreffenden Fragebogen.

Integration mit anderen Da Vinci IGs

Ermittlung der Deckungsanforderungen (CRD)

Workflow-Integration:

Support bei vorheriger Autorisierung (PAS)

Workflow-Integration:

Klinischer Data Exchange (CDex)

Workflow-Integration:

Anleitung zur Fehlerbehebung

Problem: Es wurde kein Fragebogen zurückgesendet

Mögliche Ursachen:

Lösungen:

Problem: Fehlende Abhängigkeiten im Package

Mögliche Ursachen:

Lösungen:

Problem: Leeres Package mit ChangedSince

Mögliche Ursachen:

Lösungen:

Problem: QuestionnaireResponse Nicht vorab ausgefüllt

Mögliche Ursachen:

Lösungen:

Best Practices

1. Verwenden Sie Canonical URLs mit Versionen

Geben Sie immer Versionsnummern an, wenn Sie bestimmte Fragebögen anfordern:

{  
  "name": "questionnaire",  
  "valueCanonical": "http://example.org/fhir/Questionnaire/dme|2.1.0"  
}

Warum: Sorgt für Konsistenz und verhindert unerwartete Änderungen, wenn Fragebögen aktualisiert werden.

2. Nutzen Sie ChangedSince für mehr Leistung

Verwenden Sie für häufig aufgerufene Fragebögen Folgendes, changedSince um die Datenübertragung zu minimieren:

{  
  "name": "changedSince",  
  "valueDateTime": "2024-03-10T15:30:00Z"  
}

Warum: Reduziert die Latenz und die Bandbreitennutzung, indem nur aktualisierte Ressourcen abgerufen werden.

3. Vollständige Deckungsinformationen einschließen

Geben Sie umfassende Angaben zum Umfang an, um sicherzustellen, dass der Fragebogen korrekt ausgewählt wird:

{  
  "name": "coverage",  
  "resource": {  
    "resourceType": "Coverage",  
    "beneficiary": { "reference": "Patient/123" },  
    "payor": [{ "reference": "Organization/payer-abc" }],  
    "class": [{ /* Group/plan information */ }]  
  }  
}

Warum: Hilft bei der HealthLake Identifizierung von zahlerspezifischen Fragebögen und Anforderungen.

Zugehörige -Vorgänge