Skip to contents

Un fichier par séjour, ou par RUM avec par_rum = TRUE. Unité atomique du PMSI : le RUM, seul porteur de l'attribut action et d'un identifiant. Mêmes tables, mêmes colonnes et même sortie (octet pour octet) que write_evenements_pmsi() du package Python pyhprimxml.

Usage

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

Arguments

evenements, rum, diagnostics, actes_ccam

Tables décrites ci-dessus.

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

par_rum

Un fichier par RUM ; evt_id vaut alors {evt_id}_{rum_id} et le gabarit dispose aussi de {rss_id} et {rum_id}.

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.

actes

Ancien nom de actes_ccam, encore accepté avec un avertissement.

Value

Les chemins écrits (invisible).

Details

Tables (data.frame ou tibble) :

  • evenements : une ligne par séjour. Obligatoires : evt_id, ipp, sexe, date_naissance, nda, venue_date_entree.

  • rum : une ligne par RUM. Obligatoires : evt_id, rum_id, um, um_date_entree, um_mode_entree. Diagnostics possibles en colonnes dp, dr, das, dad (das et dad : colonne liste ou chaîne séparée par des virgules).

  • diagnostics : format long, evt_id, rum_id, type (DP, DR, DAS, DAD), code.

  • actes_ccam : une ligne par acte CCAM, evt_id, rum_id, code, phase, activite.

Toute colonne dont le nom contient / ou commence par @ est une colonne-chemin, relative au noeud que décrit la table (ex. patient/@anonyme, @classant).

Examples

# Les exemples écrivent dans un dossier temporaire
ancien <- setwd(tempdir())
# Séjour avec mutation : entrée par les urgences en cardiologie (UM 1201), puis mutation
# en médecine (UM 3405), sortie au domicile. Un RSS de deux RUM, écrit sans namespace,
# d'abord en un fichier par séjour, puis en RUM unitaires (un fichier par RUM).
library(hprimxml)
library(tibble)

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

entete <- list(
  version = "2.00",                     # version HPRIM XML des messages
  emetteur = "DIM",
  destinataire = "DPI",
  date_heure_production = ts("2024-03-10 08:00:00")   # par défaut : maintenant
)

# Une ligne par séjour
evenements <- tibble(
  evt_id = "S240001",                   # -> S240001.xml, identifiantMessage S240001
  ipp = "190101337",
  sexe = "F",
  date_naissance = as.Date("1958-03-12"),
  nda = "240000123",
  venue_date_entree = as.Date("2024-03-04"),
  venue_heure_entree = hms::as_hms("10:20:00"),
  venue_date_sortie = as.Date("2024-03-09"),
  rss_emetteur = "240000123"
)

# Une ligne par RUM
rum <- tibble(
  evt_id = "S240001",
  rum_id = 1:2,
  rum_emetteur = c("S240001_1", "S240001_2"),   # identifiant XML du RUM
  um = c("1201", "3405"),
  um_date_entree = as.Date(c("2024-03-04", "2024-03-06")),
  um_heure_entree = hms::as_hms(c("10:20:00", "14:00:00")),
  um_mode_entree = c("8", "6"),         # domicile, puis mutation
  um_provenance = c("5", "1"),          # urgences, puis MCO
  um_date_sortie = as.Date(c("2024-03-06", "2024-03-09")),
  um_mode_sortie = c("6", "8"),         # mutation, puis domicile
  um_destination = c("1", NA),          # vers MCO
  `medecinResponsable/noRPPS` = c("10003456789", "10009876543")
)

# Une ligne par diagnostic (le point des codes CIM-10 est retiré à l'écriture)
diagnostics <- tibble(
  evt_id = "S240001",
  rum_id = c(1L, 1L, 1L, 1L, 2L, 2L, 2L),
  type = c("DP", "DAS", "DAS", "DAS", "DP", "DAS", "DAS"),
  code = c("I21.0", "E11.9", "I10", "E78.0", "I50.1", "N18.3", "E11.9")
)

# Une ligne par acte CCAM
actes_ccam <- tibble(
  evt_id = "S240001",
  rum_id = c(1L, 1L, 2L),
  code = c("DEQP003", "ZBQK002", "DEQP003"),
  phase = 0L,
  activite = 1L,
  date_realisation = ts(c("2024-03-04 10:45:00", "2024-03-04 11:30:00", "2024-03-06 15:00:00"))
)

# Un fichier par séjour : sortie/sejour/S240001.xml
write_evenements_pmsi(
  evenements, rum, diagnostics, actes_ccam,
  entete = entete, out_dir = "sortie/sejour", xmlns = NULL
)

# RUM unitaires, avec marqueur de dépôt complet :
# sortie/rum/S240001_1.xml puis S240001_1.ok, sortie/rum/S240001_2.xml puis S240001_2.ok
write_evenements_pmsi(
  evenements, rum, diagnostics, actes_ccam,
  entete = entete, out_dir = "sortie/rum", xmlns = NULL, par_rum = TRUE, fichier_ok = TRUE
)

# Relecture : les mêmes tables (ici, diagnostics en colonnes de `rum`)
relu <- read_evenements_pmsi("sortie/sejour", format_diagnostics = "colonnes")
rum_relu <- relu$rum[, c("evt_id", "rum_id", "rum_emetteur", "um", "dp", "das")]
# Trois façons équivalentes de fournir les diagnostics d'un RUM avec plusieurs DAS.
# Les trois écritures produisent exactement le même fichier XML.
library(hprimxml)
library(tibble)

entete <- list(
  version = "2.00",                     # version HPRIM XML des messages
  emetteur = "DIM",
  destinataire = "DPI",
  date_heure_production = as.POSIXct("2024-03-10 08:00:00", tz = "UTC")
)

evenements <- tibble(
  evt_id = "S240002", ipp = "190101338", sexe = "M",
  date_naissance = as.Date("1951-07-02"), nda = "240000124",
  venue_date_entree = as.Date("2024-03-04"), rss_emetteur = "240000124"
)

rum <- tibble(
  evt_id = "S240002", rum_id = 1L, um = "1201",
  um_date_entree = as.Date("2024-03-04"), um_mode_entree = "8"
)

# 1. Format long : une table `diagnostics`, une ligne par code
diagnostics <- tibble(
  evt_id = "S240002",
  rum_id = 1L,
  type = c("DP", "DAS", "DAS", "DAS", "DAS"),
  code = c("I21.0", "E11.9", "I10", "E78.0", "N18.3")
)
write_evenements_pmsi(evenements, rum, diagnostics, entete = entete, out_dir = "sortie/long")

# 2. Colonnes dans `rum`, DAS en colonne liste
rum_liste <- rum
rum_liste$dp <- "I21.0"
rum_liste$das <- list(c("E11.9", "I10", "E78.0", "N18.3"))
write_evenements_pmsi(evenements, rum_liste, entete = entete, out_dir = "sortie/liste")

# 3. Colonnes dans `rum`, DAS en chaîne séparée par des virgules
rum_chaine <- rum
rum_chaine$dp <- "I21.0"
rum_chaine$das <- "E11.9, I10, E78.0, N18.3"
write_evenements_pmsi(evenements, rum_chaine, entete = entete, out_dir = "sortie/chaine")

# Une chaîne se convertit aussi en liste d'une ligne : strsplit(rum_chaine$das, ", ")
fichiers <- lapply(c("long", "liste", "chaine"), function(f)
  readBin(file.path("sortie", f, "S240002.xml"), "raw", 1e6))
stopifnot(identical(fichiers[[1]], fichiers[[2]]), identical(fichiers[[1]], fichiers[[3]]))
list.files("sortie", recursive = TRUE)
#>  [1] "chaine/S240002.xml"          "etat_patient/00001_esep.xml"
#>  [3] "igs2/IGS240001.xml"          "igs2/IGS240002.xml"         
#>  [5] "liste/S240002.xml"           "long/S240002.xml"           
#>  [7] "rum/S240001_1.ok"            "rum/S240001_1.xml"          
#>  [9] "rum/S240001_2.ok"            "rum/S240001_2.xml"          
#> [11] "sejour/S240001.xml"         
rum_relu
#> # A tibble: 2 × 6
#>   evt_id  rum_id rum_emetteur um    dp    das      
#>   <chr>    <int> <chr>        <chr> <chr> <list>   
#> 1 S240001      1 S240001_1    1201  I210  <chr [3]>
#> 2 S240001      2 S240001_2    3405  I501  <chr [2]>
setwd(ancien)