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 I10Les 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 TRUECô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.