Écrire des messages evenementsPMSI (RSS MCO) depuis des tables
Source:R/pmsi.R
write_evenements_pmsi.RdUn 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 optionversion,mode_traitement,acquittement_attendu,commentaire,date_heure_production,emetteur_categorie,destinataire_categorie. Chaque clé peut aussi être une colonne deevenements(prioritaire).- out_dir
Dossier de sortie.
- filename
Gabarit (
"{evt_id}.xml") ou fonction ligne -> nom.- version
Version du schéma ; sinon
entete$versionou colonneversion, sinon 2.4.- xmlns
HPRIM_NS(défaut),NULL(pas de namespace) ou""(xmlns="").- encoding
Encodage des fichiers.
- validate_xsd
"error"(défaut),"warn"ouFALSE.- colmap
Renommage de colonnes
list(ancien = "nouveau").- par_rum
Un fichier par RUM ;
evt_idvaut 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_messagecontradictoire est une erreur.- fichier_ok
Dépose un
.okvide une fois chaque.xmlécrit intégralement.- actes
Ancien nom de
actes_ccam, encore accepté avec un avertissement.
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 colonnesdp,dr,das,dad(dasetdad: 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)