Skip to contents

HPRIM XML est le standard français d’échange de données entre logiciels hospitaliers, publié par Interop’Santé. hprimxml écrit ces messages à partir de tables (data.frames ou tibbles) et les relit vers les mêmes tables. Les schémas XSD officiels (versions 1.03a à 2.4) sont embarqués : ils fixent l’ordre des éléments, distinguent attributs et éléments, et servent à valider chaque fichier.

Cette vignette fait le tour du package en quelques minutes. Les vignettes suivantes détaillent chaque thème.

Écrire un premier séjour

Un message PMSI se construit à partir de tables reliées par evt_id (le séjour, donc le fichier) et rum_id (le RUM). Il suffit ici de deux tables, evenements et rum, les diagnostics étant donnés en colonnes du RUM.

evenements <- tibble(
  evt_id = "S000001", ipp = "123456789", sexe = "F",
  date_naissance = as.Date("1960-04-02"),
  nda = "240000001", venue_date_entree = as.Date("2024-05-02")
)

rum <- tibble(
  evt_id = "S000001", rum_id = 1L, um = "1201",
  um_date_entree = as.Date("2024-05-02"), um_mode_entree = "8",
  dp = "I21.0", das = "E11.9, I10"
)

entete <- list(version = "2.00", emetteur = "DIM", destinataire = "DPI",
               date_heure_production = as.POSIXct("2024-05-03 08:00:00", tz = "UTC"))

fichiers <- write_evenements_pmsi(evenements, rum, entete = entete, out_dir = "sortie",
                                  xmlns = NULL)
fichiers
#> [1] "sortie/S000001.xml"

Un fichier par séjour, nommé d’après evt_id. Le message est validé contre le XSD avant d’être écrit : un message invalide n’est pas déposé. Voici le RUM produit :

      <rum action="creation">
        <dateAction>2024-05-02T00:00:00</dateAction>
        <identifiant>
          <emetteur>1</emetteur>
        </identifiant>
        <uniteMedicale>
          <code>1201</code>
          <entree mode="8">
            <date>2024-05-02</date>
          </entree>
        </uniteMedicale>
        <diagnostics>
          <diagnosticPrincipal>
            <codeCim10>I210</codeCim10>
          </diagnosticPrincipal>
          <diagnosticsSignificatifs>
            <diagnosticSignificatif>
              <codeCim10>E119</codeCim10>
            </diagnosticSignificatif>
            <diagnosticSignificatif>
              <codeCim10>I10</codeCim10>
            </diagnosticSignificatif>
          </diagnosticsSignificatifs>
        </diagnostics>
      </rum>

L’ordre des éléments, les attributs (action, mode) et le format des dates viennent du XSD ; le point des codes CIM-10 est retiré.

Valider

hprim_validate(fichiers)
#> character(0)

Un vecteur vide : le fichier est conforme. Sur un fichier qui ne l’est pas, on obtient la liste des erreurs (voir la vignette Validation).

Relire

t <- read_evenements_pmsi("sortie")
names(t)
#> [1] "evenements"  "rum"         "diagnostics" "actes_ccam"
t$rum[, c("evt_id", "rum_id", "um", "um_date_entree", "um_mode_entree")]
#> # A tibble: 1 × 5
#>   evt_id  rum_id um    um_date_entree um_mode_entree
#>   <chr>    <int> <chr> <date>         <chr>         
#> 1 S000001      1 1201  2024-05-02     8
t$diagnostics
#> # A tibble: 3 × 4
#>   evt_id  rum_id type  code 
#>   <chr>    <int> <chr> <chr>
#> 1 S000001      1 DP    I210 
#> 2 S000001      1 DAS   E119 
#> 3 S000001      1 DAS   I10

Les fonctions de lecture renvoient les tables qu’attendent les fonctions d’écriture, avec des colonnes typées (Date, POSIXct, hms, entiers). Ce qu’on lit se réécrit tel quel.

Messages atomiques et dépôts .ok

Chaque message a une unité atomique, l’objet qui porte l’attribut action : le RUM pour le PMSI (par_rum = TRUE), l’acte pour le serveur d’actes (par_acte = TRUE), le diagnostic pour les états patient (par_diagnostic = TRUE). Un message atomique peut être accepté, rejeté ou renvoyé seul. En production, on dépose souvent un fichier par RUM, accompagné d’un marqueur .ok vide posé une fois le fichier complet. L’identifiant du message est le nom du fichier.

write_evenements_pmsi(evenements, rum, entete = entete, out_dir = "depot",
                      xmlns = NULL, par_rum = TRUE, fichier_ok = TRUE)
list.files("depot")
#> [1] "S000001_1.ok"  "S000001_1.xml"
suivi_depots("depot")[, c("evt_id", "complet")]
#> # A tibble: 1 × 2
#>   evt_id    complet
#>   <chr>     <lgl>  
#> 1 S000001_1 TRUE

Côté destinataire, read_evenements_pmsi("depot", exiger_ok = TRUE) ne lit que les dépôts terminés.

Les autres messages

Le serveur d’actes (write_evenements_serveur_actes()) et les états patient (write_evenements_etat_patient(), diagnostics ou IGS2) fonctionnent de la même façon, avec leurs propres tables.

Tout message, sous forme de liste

Sous les tables, deux fonctions génériques lisent et écrivent n’importe quel message HPRIM XML sous forme de liste R :

msg <- hprim_parse_xml(fichiers)
msg$evenementsPMSI$evenementPMSI[[1]]$rss$rum[[1]]$uniteMedicale$code
#> [1] "1201"

hprim_to_xml(msg) réécrit la liste ; l’ordre des éléments vient du XSD.

Carte des fonctions

besoin fonctions vignette
écrire depuis des tables write_evenements_pmsi(), write_evenements_serveur_actes(), write_evenements_etat_patient() Écriture
relire vers des tables read_evenements_pmsi(), read_evenements_serveur_actes(), read_evenements_etat_patient() Lecture
contrôler un message hprim_validate(), argument validate_xsd Validation
écrire des messages atomiques arguments par_rum, par_acte, par_diagnostic Écriture
suivre des dépôts suivi_depots(), arguments fichier_ok et exiger_ok Écriture, Lecture
actes NGAP (consultations, forfaits, biologie) argument actes_ngap, table actes_ngap Écriture, Lecture
anonymiser des fichiers pour les tests hprim_anonymiser(), hprim_pseudonyme() Lecture
inspecter ou retoucher un message iter_evenements_*(), hprim_parse_xml(), hprim_to_xml() Arbres intermédiaires

Le package est le portage R de pyhprimxml : mêmes tables, mêmes options, et fichiers identiques octet pour octet.