CDS Hooks sur Epic et Cerner : patient-view, order-select, order-sign

Réponse directe

la patient-view, la order-select et la order-sign sont des points de flux de travail différents. Une carte de guidage s'affiche ; une suggestion est un changement FHIR exploitable. La préchargement correspond aux données que le DSE peut envoyer afin que le service reste rapide.

Hooks et cartes : contrat d’échange

CDS Hooks est un modèle JSON sur HTTPS : les POST du DSE (client CDS) vers {baseUrl}/cds-services/{id} lorsqu'un hook de workflow nommé se déclenche. Fixez la version du Spécification des CDS Hooks et les pages d'accroche pour patient-view, order-select et order-sign. La découverte est GET {baseUrl}/cds-services.

Ce n'est pas le même article que L'IA dans les flux de travail cliniques (modèle de comportement à l'intérieur du DSE) ou Epic contre Cerner (particularités des plateformes). Les deux fournisseurs exposent les CDS Hooks ; les noms de hook et le schéma de la carte constituent le contrat portable.

Carte versus suggestion versus lien :

Les jetons de préchargement sont {{context.patientId}} (et d'autres champs de contexte primitifs de premier niveau). Exemple de fragment de découverte :

{
  "hook": "order-sign",
  "id": "example-pgx",
  "description": "Example pharmacogenomics check on sign (de-identified).",
  "prefetch": {
    "patient": "Patient/{{context.patientId}}",
    "medications": "MedicationRequest?patient={{context.patientId}}"
  }
}

Si les données requises ne sont ni en préchargement ni autorisées fhirServer, le service répond 412 Échec de la condition préalable. Ne bloquez pas le DSE pendant quelques secondes pendant que vous parcourez toutes les pages du dossier.

Pièges d'identification

CDS Hooks est une plomberie d’aide à la décision. Il ne s’agit pas d’une autorisation pour administrer un traitement, un dosage ou un diagnostic. La sortie du modèle qui modifie une ordonnance nécessite toujours un clinicien et, lorsque le logiciel est un dispositif médical, un propriétaire réglementaire - voir le Guide du logiciel MDR si cette question est ouverte.

Jeux de données de test

Désidentifié. L'identifiant Patient example-p n'est pas une personne.

Découverte (tronquée) :

{
  "services": [
    {
      "hook": "patient-view",
      "id": "static-patient-greeter",
      "title": "Static example",
      "description": "Returns a static info card.",
      "prefetch": {
        "patientToGreet": "Patient/{{context.patientId}}"
      }
    }
  ]
}

demande de patient-view (tronquée) :

{
  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
  "hook": "patient-view",
  "fhirServer": "https://ehr.example.org/fhir",
  "context": {
    "userId": "Practitioner/example-pract",
    "patientId": "example-p",
    "encounterId": "example-enc"
  },
  "prefetch": {
    "patientToGreet": {
      "resourceType": "Patient",
      "id": "example-p",
      "gender": "female",
      "birthDate": "1977-04-12",
      "active": true
    }
  }
}

Carte d’information (aucune suggestion) :

{
  "cards": [
    {
      "summary": "Example info card — not clinical advice.",
      "indicator": "info",
      "source": { "label": "Example CDS Service" },
      "links": [
        {
          "label": "Open example SMART app",
          "url": "https://app.example.org/launch",
          "type": "smart"
        }
      ]
    }
  ]
}

Forme de suggestion sur le order-sign (ressource tronquée, il ne s'agit pas d'une véritable commande de médicament) :

{
  "cards": [
    {
      "summary": "Example: replace the draft order (fixture).",
      "indicator": "warning",
      "source": { "label": "Example CDS Service" },
      "selectionBehavior": "at-most-one",
      "suggestions": [
        {
          "label": "Apply example update",
          "actions": [
            {
              "type": "update",
              "description": "Update the draft ServiceRequest identifier only.",
              "resource": {
                "resourceType": "ServiceRequest",
                "id": "draft-order-1",
                "status": "draft",
                "intent": "order",
                "subject": { "reference": "Patient/example-p" }
              }
            }
          ]
        }
      ]
    }
  ]
}

Tests minimaux :

1. patient-view avec préchargement présente : 200, carte d'information ≤ 1, budget de latence que le DSE applique réellement.
2. patient-view avec clé de préchargement omise — soit 200 avec une carte plus étroite, soit 412 ; ne jamais bloquer le parcours.
3. order-select avec deux selections — la carte parle uniquement des brouillons sélectionnés.
4. suggestion de order-sign acceptée ou rejetée (API de rétroaction si le DSE l'envoie).
5. Même service enregistré sur un bac à sable Epic et un bac à sable Oracle Health : comparez les champs obligatoires du brouillon MedicationRequest.

Modes de défaillance et restauration

Désactivez un service dangereux lors de sa découverte (supprimez-le de {baseUrl}/cds-services) plutôt que de renvoyer des cartes critiques que vous ne pouvez pas prendre en charge. La restauration consiste à : désenregistrer le hook, conserver le flux de travail DSE natif, ne rien rejouer – CDS Hooks est consultatif, sauf si vous l'avez accepté. systemActions.

Service associé

Si vous avez besoin de CDS Hooks connectés à Oracle Health / Cerner (et des mêmes cartes testées contre Epic), c'est-à-dire Intégration Cerner. Pour une étude technique ciblée de CDS Hooks, utilisez formulaire de contact projet.

Cette page ne constitue pas un conseil clinique, ni une certification CDS Hooks, ni un partenariat avec un fournisseur de DSE. Les cartes vides sont une réponse réussie.