Arbres intermédiaires et listes

library(hprimxml)
library(tibble)

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 :

  1. iter_evenements_*() : tables → un arbre par événement ;
  2. hprim_to_xml() : arbre → XML, dans l’ordre du XSD ;
  3. dépôt du fichier (nom, identifiant du message, validation, .ok).

Manipuler ces arbres sert à inspecter un message avant de l’écrire, à le retoucher, ou à traiter un message que les tables ne couvrent pas.

Convention des listes

C’est la même que celle du dictionnaire du package Python :

  • une seule clé à la racine : l’élément racine, par exemple list(evenementsPMSI = list(...)) ;
  • attributs et éléments enfants sont des clés de la même liste nommée ; le préfixe @ est accepté mais facultatif, c’est le XSD qui tranche ;
  • un élément répété est une liste non nommée (rum = list(list(...), list(...))), ou un vecteur pour un élément simple (modificateur = c("7", "J")) ;
  • un élément à contenu simple portant des attributs utilise la clé #text ;
  • l’ordre des clés n’a pas d’importance.

Inspecter les arbres : 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       : NULL

Avec par_rum = TRUE, on obtient un arbre par RUM :

length(iter_evenements_pmsi(evenements, rum, entete = entete, par_rum = TRUE))
#> [1] 2

Retoucher un arbre avant de l’écrire

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.

arbre$evenementsPMSI$enteteMessage$commentaireMesage <- "faute de frappe"
hprim_to_xml(arbre)
#> Error:
#> ! evenementsPMSI/enteteMessage : clés inconnues du XSD 2.4 : commentaireMesage

Lire un message en liste : 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"

Retoucher un message reçu

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).