Entre les tables et le fichier XML, chaque message passe par un arbre : une liste R imbriquée qui décrit le message. Les fonctions d’écriture enchaînent trois étapes :
iter_evenements_*() : tables → un arbre par événement
;hprim_to_xml() : arbre → XML, dans l’ordre du XSD
;.ok).Manipuler ces arbres sert à inspecter un message avant de l’écrire, à le retoucher, ou à traiter un message que les tables ne couvrent pas.
C’est la même que celle du dictionnaire du package Python :
list(evenementsPMSI = list(...)) ;@ est accepté mais facultatif, c’est le XSD
qui tranche ;rum = list(list(...), list(...))), ou un vecteur pour un
élément simple (modificateur = c("7", "J")) ;#text ;iter_evenements_*()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 = 1:2, um = c("1201", "3405"),
um_date_entree = as.Date(c("2024-05-02", "2024-05-04")), um_mode_entree = c("8", "6"),
dp = c("I21.0", "I50.1"))
entete <- list(emetteur = "DIM", destinataire = "DPI",
date_heure_production = as.POSIXct("2024-05-06 08:00:00", tz = "UTC"))
arbres <- iter_evenements_pmsi(evenements, rum, entete = entete)
length(arbres)
#> [1] 1
names(arbres[[1]])
#> [1] "evt" "tree"Chaque élément contient la ligne d’événement (evt) et
l’arbre du message (tree) :
arbre <- arbres[[1]]$tree
str(arbre$evenementsPMSI$evenementPMSI$rss$rum[[1]], max.level = 2)
#> List of 8
#> $ action : chr "creation"
#> $ dateAction : Date[1:1], format: "2024-05-02"
#> $ identifiant :List of 2
#> ..$ emetteur : int 1
#> ..$ recepteur: NULL
#> $ uniteMedicale:List of 3
#> ..$ code : chr "1201"
#> ..$ entree:List of 4
#> ..$ sortie: NULL
#> $ diagnostics :List of 1
#> ..$ diagnosticPrincipal:List of 1
#> $ actes : NULL
#> $ igs2 : NULL
#> $ seance : NULLAvec par_rum = TRUE, on obtient un arbre par RUM :
L’arbre est une liste ordinaire : on peut la modifier, puis l’écrire
avec hprim_to_xml(). Ici, on passe le message en mode test
et on ajoute un commentaire :
arbre$evenementsPMSI$enteteMessage$modeTraitement <- "test"
arbre$evenementsPMSI$enteteMessage$commentaireMessage <- "Envoi de test"
xml <- hprim_to_xml(arbre, xmlns = NULL, validate_xsd = "error") <enteteMessage modeTraitement="test">
<identifiantMessage>S000001</identifiantMessage>
<dateHeureProduction>2024-05-06T08:00:00</dateHeureProduction>
<emetteur>
<agents>
<agent categorie="application">
<code>DIM</code>
</agent>
</agents>
</emetteur>
<destinataire>
<agents>
<agent categorie="application">
<code>DPI</code>
</agent>
</agents>
</destinataire>
<commentaireMessage>Envoi de test</commentaireMessage>
</enteteMessage>L’ordre des éléments vient du XSD, quel que soit l’ordre d’ajout des
clés. Une clé inconnue du XSD est refusée (strict = TRUE,
par défaut) : une faute de frappe ne passe pas inaperçue.
hprim_parse_xml()hprim_parse_xml() lit n’importe quel message HPRIM XML
en liste, en s’appuyant sur le XSD : les éléments répétables sont
toujours des listes non nommées, même avec un seul
élément, et les valeurs sont typées.
Le XSD décide de ce qui est une liste. Dans un message PMSI,
evenementPMSI est répétable : c’est une liste d’événements,
même s’il n’y en a qu’un. Dans un message serveur d’actes,
evenementServeurActe ne l’est pas : c’est directement
l’événement. acteCCAM, lui, est répétable.
f <- system.file("extdata", "actes_00001.xml", package = "hprimxml")
msg <- hprim_parse_xml(f)
evt <- msg$evenementsServeurActes$evenementServeurActe # un seul événement : pas de [[1]]
actes_ccam <- evt$actesCCAM$acteCCAM # liste d'actes
length(actes_ccam)
#> [1] 4
actes_ccam[[1]]$codeActe
#> [1] "EBLA003"
class(actes_ccam[[1]]$execute$date)
#> [1] "Date"Pour un traitement que les tables ne couvrent pas, on lit le message en liste, on le modifie, puis on le réécrit. Ici, on remplace le code de l’unité fonctionnelle exécutante de chaque acte :
msg$evenementsServeurActes$evenementServeurActe$actesCCAM$acteCCAM <- lapply(
msg$evenementsServeurActes$evenementServeurActe$actesCCAM$acteCCAM,
function(a) {
a$executant$uniteFonctionnelle$code <- "9999"
a
}
)
hprim_write_xml(msg, "actes_modifies.xml", validate_xsd = "warn")
#> Warning: XML non conforme au XSD :
#> Element '{http://www.hprim.org/hprimXML}agent': Missing child element(s). Expected is ( {http://www.hprim.org/hprimXML}code ). <executant>
<medecins>
<medecinExecutant principal="oui">
<medecin>
<identification>
<code>01234567</code>
</identification>
</medecin>
</medecinExecutant>
</medecins>
<uniteFonctionnelle>
<code>9999</code>
</uniteFonctionnelle>
</executant>hprim_to_xml(msg, drop_empty = FALSE) conserve les
éléments vides : relu puis réécrit ainsi, un fichier redonne exactement
l’original (à la mise en forme près).