Skip to contents

Un fichier par événement. evenements : patient, venue, intervention, et le repère : date_observation, heure_observation (élément dateObservation), ou recueil_id, recueil_date, recueil_heure, recueil_uf (élément recueil : date et UF où les états ont été observés, le repère le plus précis) ; les colonnes-chemins sont relatives à la racine du message (ex. igs2/@age). diagnostics : une ligne par diagnostic, evt_id, type (dp, dr, da, ds, dd, fpc, mm, ae), code, et en option date_action, action.

Usage

write_evenements_etat_patient(
  evenements,
  diagnostics = NULL,
  entete = NULL,
  out_dir,
  filename = "{evt_id}.xml",
  version = NULL,
  xmlns = HPRIM_NS,
  encoding = "UTF-8",
  validate_xsd = "error",
  colmap = NULL,
  identifiant_egal_nom_fichier = TRUE,
  fichier_ok = FALSE,
  par_diagnostic = FALSE
)

Arguments

evenements, diagnostics

Tables.

entete

Liste : emetteur, destinataire, et en option version, mode_traitement, acquittement_attendu, commentaire, date_heure_production, emetteur_categorie, destinataire_categorie. Chaque clé peut aussi être une colonne de evenements (prioritaire).

out_dir

Dossier de sortie.

filename

Gabarit ("{evt_id}.xml") ou fonction ligne -> nom.

version

Version du schéma ; sinon entete$version ou colonne version, sinon 2.4.

xmlns

HPRIM_NS (défaut), NULL (pas de namespace) ou "" (xmlns="").

encoding

Encodage des fichiers.

validate_xsd

"error" (défaut), "warn" ou FALSE.

colmap

Renommage de colonnes list(ancien = "nouveau").

identifiant_egal_nom_fichier

L'identifiantMessage est le nom du fichier sans extension (défaut) ; une colonne identifiant_message contradictoire est une erreur.

fichier_ok

Dépose un .ok vide une fois chaque .xml écrit intégralement.

par_diagnostic

Un message par diagnostic (unité atomique) au lieu d'un par événement. Le contexte (patient, venue, repère) est répété ; evt_id vaut {evt_id}_{rang}, et le gabarit filename dispose aussi de {evt_origine} et {rang}.

Value

Les chemins écrits (invisible).

Details

Le XSD impose un repère (intervention, dateObservation ou recueil) et un contenu exclusif : diagnostics, ou IGS2, ou dépendances… En 2.4, un élément <divers/> est émis.

Unité atomique des états patient (pour les diagnostics) : le diagnostic, porteur de l'attribut action et d'un identifiant. par_diagnostic = TRUE écrit un message par diagnostic. L'IGS2, unique par message, est atomique par construction.

Examples

# Les exemples écrivent dans un dossier temporaire
ancien <- setwd(tempdir())
# IGS2 détaillé dans un message états patient (evenementsServeurEtatsPatient).
# Des mesures brutes (pires valeurs des 24 premières heures), on déduit pour chaque item
# la classe attendue par le XSD (attribut de <igs2>) et ses points, puis le score global.
# Un fichier par patient : l'élément <igs2> n'est pas répétable dans un message.
library(hprimxml)
library(tibble)

ts <- function(x) as.POSIXct(x, tz = "UTC")

entete <- list(
  version = "2.00",                     # version HPRIM XML des messages
  emetteur = "REA",
  destinataire = "DIM",
  date_heure_production = ts("2024-03-06 09:00:00")
)

# Pires valeurs des 24 premières heures, une ligne par patient
mesures <- tibble(
  evt_id = c("IGS240001", "IGS240002"),
  age = c(67, 82),
  frequence_cardiaque = c(128, 105),    # /min
  pas = c(85, 210),                     # pression artérielle systolique, mmHg
  temperature = c(38.2, 39.4),          # °C
  ventile = c(TRUE, FALSE),             # ventilation mécanique ou CPAP
  pao2_fio2 = c(180, NA),               # mmHg, si ventilé
  diurese = c(0.8, 1.6),                # L/24 h
  uree = c(18, 8),                      # mmol/L
  leucocytes = c(14, 22),               # 10³/mm³
  kaliemie = c(4.1, 5.4),               # mmol/L
  natremie = c(132, 147),               # mmol/L
  hco3 = c(17, 22),                     # mmol/L
  bilirubine = c(25, 110),              # µmol/L
  ictere = c(FALSE, TRUE),              # la bilirubine ne compte que si ictère
  glasgow = c(13, 15),
  maladie_chronique = c("aucune", "cancerMetastatique"),
  mode_admission = c("medecine", "chirUrgente")
)

# Barème IGS2 : attribut XSD -> mesure, bornes, points par classe XSD
# Source : grille et définitions de la SFAR, https://sfar.org/scores/igs2.php
# (Le Gall JR et coll., JAMA 1993; 270: 2957-2963). Recueil sur les 24 heures suivant
# l'admission : valeur la plus défavorable de chaque item ; Glasgow estimé avant sédation ;
# diurèse ramenée à 24 h si le séjour est plus court ; en cas d'arrêt cardiaque, FC 0,
# PAS 0 et Glasgow < 6. Unités : urée en mmol/L (seuils SFAR en g/L : 0,6 et 1,8),
# leucocytes en 10³/mm³, bilirubine en µmol/L (seuils en mg/L : 40 et 60).
# Les bornes sont fermées à gauche : 40 tombe dans « 40A59 ».
BAREME <- list(
  age = list("age", c(40, 60, 70, 75, 80),
             c(inferieurA40 = 0, `40A59` = 7, `60A69` = 12, `70A74` = 15, `75A79` = 16,
               superieurEgalA80 = 18)),
  frequenceCardiaque = list("frequence_cardiaque", c(40, 70, 120, 160),
             c(inferieurA40 = 11, `40A69` = 2, `70A119` = 0, `120A159` = 4, superieurEgalA160 = 7)),
  tensionArterielleSystolique = list("pas", c(70, 100, 200),
             c(inferieurA70 = 13, `70A99` = 5, `100A199` = 0, superieurEgalA200 = 2)),
  temperature = list("temperature", 39, c(inferieurA39 = 0, superieurEgalA39 = 3)),
  paO2_FIO2 = list("pao2_fio2", c(100, 200), c(inferieurA100 = 11, `100A199` = 9, superieurEgalA200 = 6)),
  diurese = list("diurese", c(0.5, 1), c(`inferieurA0,5` = 11, `0,5A0,999` = 4, superieurA1 = 0)),
  ureeSanguine = list("uree", c(10, 30), c(inferieurA10 = 0, `10A29,9` = 6, superieurA30 = 10)),
  leucocytes = list("leucocytes", c(1, 20), c(inferieurA1 = 12, `1A19,9` = 0, superieurEgalA20 = 3)),
  kaliemie = list("kaliemie", c(3, 5), c(inferieurA3 = 3, `3A4,9` = 0, superieurEgalA5 = 3)),
  natremie = list("natremie", c(125, 145), c(inferieurA125 = 5, `125A144` = 0, superieurEgalA145 = 1)),
  HCO3 = list("hco3", c(15, 20), c(inferieurA15 = 6, `15A19` = 3, superieurEgalA20 = 0)),
  bilirubine = list("bilirubine", c(68.4, 102.6),
             c(`inferieurA68,4` = 0, `68,4A102,5` = 4, `superieurA102,6` = 9)),
  scoreGlasgow = list("glasgow", c(6, 9, 11, 14),
             c(inferieurA6 = 26, `6A8` = 13, `9A10` = 7, `11A13` = 5, `14A18` = 0))
)
POINTS_QUALITATIFS <- list(
  maladieChronique = list("maladie_chronique",
             c(aucune = 0, cancerMetastatique = 9, maladieHematologiqueMaligne = 10, sida = 17)),
  modeAdmission = list("mode_admission", c(chirProgrammee = 0, medecine = 6, chirUrgente = 8))
)

# Classe d'une mesure : libelles[i] si bornes[i-1] <= mesure < bornes[i]
classer <- function(x, bornes, libelles) {
  as.character(cut(x, c(-Inf, bornes, Inf), labels = libelles, right = FALSE))
}

igs2 <- mesures
for (attr in names(BAREME)) {
  b <- BAREME[[attr]]
  classe <- classer(mesures[[b[[1]]]], b[[2]], names(b[[3]]))
  if (attr == "paO2_FIO2") classe <- ifelse(mesures$ventile, classe, "rien")  # ni ventilé ni CPAP
  if (attr == "bilirubine") classe <- ifelse(mesures$ictere, classe, "inferieurA68,4")  # non ictérique
  igs2[[attr]] <- classe
  igs2[[paste0("points_", attr)]] <- as.integer(c(b[[3]], rien = 0)[classe])
}
for (attr in names(POINTS_QUALITATIFS)) {
  q <- POINTS_QUALITATIFS[[attr]]
  igs2[[attr]] <- mesures[[q[[1]]]]
  igs2[[paste0("points_", attr)]] <- as.integer(q[[2]][mesures[[q[[1]]]]])
}
igs2$valeurGlobale <- as.integer(rowSums(igs2[grep("^points_", names(igs2))]))
attributs <- c(names(BAREME), names(POINTS_QUALITATIFS))

# Patient et venue, une ligne par message
evenements <- tibble(
  evt_id = c("IGS240001", "IGS240002"),
  ipp = c("190101337", "190101338"), sexe = c("M", "F"),
  date_naissance = as.Date(c("1956-05-14", "1941-11-02")),
  nda = c("240000123", "240000124"), venue_date_entree = as.Date("2024-03-05"),
  # repère du message : le recueil, avec sa date et l'UF de réanimation où les états ont
  # été observés (le récepteur retrouve ainsi le RUM, même un jour de mutation)
  recueil_id = c("REC240001", "REC240002"),
  recueil_date = as.Date("2024-03-06"),
  recueil_uf = "4501"
)

# L'IGS2 passe par des colonnes-chemins relatives à la racine du message
evenements$`igs2/@action` <- "creation"
for (a in attributs) evenements[[paste0("igs2/@", a)]] <- igs2[[a]]
evenements$`igs2/dateAction` <- ts("2024-03-06 08:00:00")
evenements$`igs2/valeurGlobale` <- igs2$valeurGlobale

fichiers <- write_evenements_etat_patient(
  evenements, NULL,                     # pas de table de diagnostics ici
  entete = entete,
  out_dir = "sortie/igs2",              # -> sortie/igs2/IGS240001.xml, IGS240002.xml
  xmlns = NULL
)

# Contrôle : une ligne par item, avec la classe et les points de chaque patient
controle <- tibble(item = attributs)
for (i in seq_len(nrow(igs2))) {
  controle[[paste0("classe_", igs2$evt_id[i])]] <- unlist(igs2[i, attributs])
}
for (i in seq_len(nrow(igs2))) {
  controle[[paste0("points_", igs2$evt_id[i])]] <- unlist(igs2[i, paste0("points_", attributs)])
}
# Régénère data/xml_tests/etat_patient/00001.xml : diagnostics DP et DR.
library(hprimxml)
library(tibble)

ts <- function(x) as.POSIXct(x, tz = "UTC")

entete <- list(
  version = "2.00",                     # version HPRIM XML des messages
  emetteur = "TEST",
  destinataire = NULL,
  acquittement_attendu = "non",
  commentaire = "HPRIM-TEST",
  date_heure_production = ts("2024-01-01 01:01:01")
)

# Une ligne par événement : patient, venue, intervention
# (ici, les colonnes-chemins sont relatives à la racine du message)
evenements <- tibble(
  evt_id = "00001_esep",
  ipp = "123456789", ipp_recepteur = "123456789",
  sexe = "M", nom_usuel = "SANDWICK", prenom = "JOHN",
  date_naissance = as.Date("1970-01-01"),
  nda = "987654321", nda_recepteur = "987654321",
  venue_date_entree = as.Date("2024-01-01"), venue_heure_entree = hms::as_hms("08:00:00"),
  venue_uf_responsable = "4321",
  intervention_id = "000000000001", intervention_uf = "4321",
  `patient/@confidentiel` = "non", `venue/@prive` = "non",
  `patient/identifiant/emetteur/@etat` = "permanent",
  `patient/identifiant/emetteur/@portee` = "local",
  `patient/identifiant/emetteur/@referent` = "non",
  `patient/identifiant/recepteur/@etat` = "permanent",
  `patient/identifiant/recepteur/@portee` = "local",
  `patient/identifiant/recepteur/@referent` = "non"
)

# Une ligne par diagnostic ; type dans dp, dr, da, ds, dd, fpc, mm, ae
diagnostics <- tibble(
  evt_id = "00001_esep",
  type = c("dp", "dr"),
  code = c("Z511", "C10"),
  date_action = ts("2024-01-01 08:10:00")
)

fichiers <- write_evenements_etat_patient(
  evenements, diagnostics,
  entete = entete,
  out_dir = "sortie/etat_patient",      # -> sortie/etat_patient/00001_esep.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 ).
# IGS2 : classe et points de chaque item, par patient
print(controle, width = Inf)
#> # A tibble: 15 × 5
#>    item                        classe_IGS240001 classe_IGS240002  
#>    <chr>                       <chr>            <chr>             
#>  1 age                         60A69            superieurEgalA80  
#>  2 frequenceCardiaque          120A159          70A119            
#>  3 tensionArterielleSystolique 70A99            superieurEgalA200 
#>  4 temperature                 inferieurA39     superieurEgalA39  
#>  5 paO2_FIO2                   100A199          rien              
#>  6 diurese                     0,5A0,999        superieurA1       
#>  7 ureeSanguine                10A29,9          inferieurA10      
#>  8 leucocytes                  1A19,9           superieurEgalA20  
#>  9 kaliemie                    3A4,9            superieurEgalA5   
#> 10 natremie                    125A144          superieurEgalA145 
#> 11 HCO3                        15A19            superieurEgalA20  
#> 12 bilirubine                  inferieurA68,4   superieurA102,6   
#> 13 scoreGlasgow                11A13            14A18             
#> 14 maladieChronique            aucune           cancerMetastatique
#> 15 modeAdmission               medecine         chirUrgente       
#>    points_IGS240001 points_IGS240002
#>               <int>            <int>
#>  1               12               18
#>  2                4                0
#>  3                5                2
#>  4                0                3
#>  5                9                0
#>  6                4                0
#>  7                6                0
#>  8                0                3
#>  9                0                3
#> 10                0                1
#> 11                3                0
#> 12                0                9
#> 13                5                0
#> 14                0                9
#> 15                6                8
igs2$valeurGlobale
#> [1] 54 56
setwd(ancien)