| Title: | Écriture et lecture de fichiers HPRIM XML |
|---|---|
| Description: | Écriture et lecture de messages HPRIM XML (standard d'interopérabilité français, Interop'Santé) depuis et vers des tables (data.frames, tibbles) : PMSI (RSS MCO), serveur d'actes, états patient. Guidé par les schémas XSD officiels embarqués (versions 1.03a à 2.4). Portage R du package Python pyhprimxml : mêmes tables, mêmes options, sortie XML identique octet pour octet. |
| Authors: | Guillaume Pressiat [aut, cre] |
| Maintainer: | Guillaume Pressiat <[email protected]> |
| License: | AGPL (>= 3) |
| Version: | 0.3.0 |
| Built: | 2026-11-15 12:00:17 UTC |
| Source: | https://github.com/GuillaumePressiat/hprimxml |
Chaque fichier est lu, anonymisé et réécrit dans out_dir sous un nom pseudonymisé, avec
sa propre transformation aléatoire : rien ne relie deux fichiers anonymisés. À graine égale,
les fichiers produits sont identiques, octet pour octet, à ceux de anonymiser() dans
pyhprimxml.
hprim_anonymiser(sources, out_dir, graine = NULL, encoding = "UTF-8")hprim_anonymiser(sources, out_dir, graine = NULL, encoding = "UTF-8")
sources |
Fichier(s), dossier ou motif glob. |
out_dir |
Dossier de sortie. |
graine |
Rend le résultat reproductible (même graine, même fichier source -> même fichier anonymisé). Réservé à la doc et aux tests ; sans graine, chaque appel donne un résultat différent. |
encoding |
Encodage des fichiers écrits. |
Règles :
à l'intérieur d'un fichier, tout reste cohérent : une même valeur donne le même remplacement partout dans le fichier ;
noms et prénoms (patient, professionnels) sont remplacés par des noms français plausibles
(faker), le prénom selon le sexe du patient ; nomNaissance reste égal à nomUsuel quand
ils l'étaient ;
les identifiants (patient, venue, RSS, RUM, actes, intervention, recueil, message), les adresses et les commentaires gardent leur longueur et leur nature de caractères, pour que les fichiers restent conformes au XSD ;
toutes les dates d'un fichier sont décalées d'un même nombre de jours, tiré au hasard (durées et âges conservés) ; les heures ne changent pas ;
les codes et les attributs (sexe, mode, action…) ne sont jamais modifiés ;
le nom de fichier est pseudonymisé comme l'identifiant du message ; un .ok présent à
côté du fichier source est reproduit.
Ce n'est pas une anonymisation au sens du RGPD : les fichiers restent des données de santé, où codes rares, durées ou unités peuvent permettre des recoupements. Usage : tests locaux.
Les chemins des fichiers anonymisés (invisible).
f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") a <- hprim_anonymiser(f, out_dir = tempfile()) read_evenements_pmsi(a)$evenements[, c("ipp", "nom_usuel", "prenom", "date_naissance")]f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") a <- hprim_anonymiser(f, out_dir = tempfile()) read_evenements_pmsi(a)$evenements[, c("ipp", "nom_usuel", "prenom", "date_naissance")]
Voir hprim_anonymiser() pour les règles.
hprim_anonymiser_message(tree, cle, jours = NULL)hprim_anonymiser_message(tree, cle, jours = NULL)
tree |
Liste renvoyée par |
cle |
Clé de transformation (propre à un fichier dans |
jours |
Décalage des dates ; par défaut |
La liste anonymisée.
Versions de schémas HPRIM XML embarquées
hprim_available_versions()hprim_available_versions()
Vecteur des versions disponibles ("1.03a" à "2.4").
hprim_available_versions()hprim_available_versions()
Entre -365 et +365 jours, jamais nul ; identique au decalage_jours() de pyhprimxml.
hprim_decalage_jours(cle)hprim_decalage_jours(cle)
cle |
Clé secrète. |
Nombre de jours.
Tirés de listes de noms et prénoms français courants embarquées dans le package (les mêmes
que dans pyhprimxml). Une même valeur et une même clé donnent le même remplacement. Le
prénom est féminin si sexe == "F", masculin si "M", sinon tiré des deux listes.
hprim_faux_nom(valeur, cle) hprim_faux_prenom(valeur, cle, sexe = NULL)hprim_faux_nom(valeur, cle) hprim_faux_prenom(valeur, cle, sexe = NULL)
valeur |
Valeur d'origine. |
cle |
Clé de transformation (propre à un fichier dans |
sexe |
Sexe du patient ( |
Un nom, ou un prénom.
hprim_faux_nom("MARTIN", cle = "k") hprim_faux_prenom("JEANNE", cle = "k", sexe = "F")hprim_faux_nom("MARTIN", cle = "k") hprim_faux_prenom("JEANNE", cle = "k", sexe = "F")
Valeur par défaut de l'argument xmlns des fonctions d'écriture.
HPRIM_NSHPRIM_NS
An object of class character of length 1.
Lecture guidée par 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 d'après le
XSD (Date, POSIXct en UTC, hms, integer ; le reste et les attributs en
texte). Le namespace est ignoré. Le résultat est accepté tel quel par
hprim_to_xml(), et a la même forme que le dictionnaire de parse_xml() en
Python.
hprim_parse_xml(source, version = NULL, typed = TRUE)hprim_parse_xml(source, version = NULL, typed = TRUE)
source |
Chemin de fichier, chaîne XML ou vecteur raw. |
version |
Version du schéma ; par défaut l'attribut |
typed |
|
Les dateTime sont lus en UTC sans décalage : l'heure écrite dans le fichier
est conservée, et réécrite à l'identique.
Liste list(racine = list(...)).
f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") msg <- hprim_parse_xml(f) rum <- msg$evenementsPMSI$evenementPMSI[[1]]$rss$rum length(rum) rum[[2]]$dateActionf <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") msg <- hprim_parse_xml(f) rum <- msg$evenementsPMSI$evenementPMSI[[1]]$rss$rum length(rum) rum[[2]]$dateAction
Même longueur, même nature de caractères : chiffre -> chiffre, majuscule -> majuscule,
minuscule -> minuscule ; ponctuation et espaces conservés ; tout autre caractère -> X.
Calculé par HMAC-SHA256 avec la clé : identique au pseudonyme() de pyhprimxml. C'est la
fonction de base de hprim_anonymiser(), qui tire une clé aléatoire par fichier.
hprim_pseudonyme(valeur, cle)hprim_pseudonyme(valeur, cle)
valeur |
Valeur(s) à pseudonymiser. |
cle |
Clé secrète. |
Vecteur de pseudonymes.
hprim_pseudonyme("190101337", cle = "ma-cle")hprim_pseudonyme("190101337", cle = "ma-cle")
La liste suit la même convention que le dictionnaire du package Python pyhprimxml (format xmltodict) :
une seule clé : l'élément racine ;
attributs et éléments enfants sont des clés de la même liste nommée
(préfixe @ accepté mais facultatif : le XSD tranche) ;
un élément répété est une liste non nommée (ou un vecteur atomique) ;
un élément à contenu simple portant des attributs utilise la clé #text.
hprim_to_xml( tree, version = NULL, xmlns = HPRIM_NS, encoding = "UTF-8", pretty = TRUE, drop_empty = TRUE, strict = TRUE, validate_xsd = FALSE )hprim_to_xml( tree, version = NULL, xmlns = HPRIM_NS, encoding = "UTF-8", pretty = TRUE, drop_empty = TRUE, strict = TRUE, validate_xsd = FALSE )
tree |
Liste |
version |
Version du schéma ; par défaut l'attribut |
xmlns |
|
encoding |
Encodage déclaré ( |
pretty |
Indentation (deux espaces, mise en forme de libxml2). |
drop_empty |
Supprime éléments et attributs vides ( |
strict |
Erreur si une clé ne correspond à rien dans le XSD (sinon avertissement). |
validate_xsd |
|
L'ordre des clés n'a pas d'importance : les enfants sont émis dans l'ordre du
XSD. Le document est construit et mis en forme par xml2 (libxml2), comme lxml en Python :
la sortie est identique, octet pour octet, à celle de to_xml().
Le message XML (chaîne UTF-8), déclaration comprise.
f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") msg <- hprim_parse_xml(f) cat(substr(hprim_to_xml(msg, xmlns = NULL), 1, 200))f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") msg <- hprim_parse_xml(f) cat(substr(hprim_to_xml(msg, xmlns = NULL), 1, 200))
La variante de schéma (avec ou sans namespace) est choisie d'après le message lui-même.
hprim_validate(x, version = NULL)hprim_validate(x, version = NULL)
x |
Message : chaîne XML, chemin de fichier, vecteur raw ou document xml2. |
version |
Version du schéma ; par défaut l'attribut |
Vecteur des erreurs, vide si le message est conforme. Si le XSD officiel de la
version est lui-même invalide (cas du XSD PMSI 1.06), une erreur de classe
hprim_schema_error est levée : la validation est impossible avec cette version.
f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") hprim_validate(f)f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") hprim_validate(f)
Écrire un message HPRIM XML dans un fichier
hprim_write_xml(tree, path, encoding = "UTF-8", ...)hprim_write_xml(tree, path, encoding = "UTF-8", ...)
tree |
Liste |
path |
Fichier de sortie. |
encoding |
Encodage du fichier. |
... |
Autres options de |
Le chemin écrit (invisible).
Arbres des messages evenementsServeurEtatsPatient, un par événement
iter_evenements_etat_patient( evenements, diagnostics = NULL, entete = NULL, version = NULL, colmap = NULL, par_diagnostic = FALSE )iter_evenements_etat_patient( evenements, diagnostics = NULL, entete = NULL, version = NULL, colmap = NULL, par_diagnostic = FALSE )
evenements, diagnostics
|
Tables. |
entete |
Liste : |
version |
Version du schéma ; sinon |
colmap |
Renommage de colonnes |
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é ; |
Arbres (format liste) des messages evenementsPMSI, un par événement ou par RUM
iter_evenements_pmsi( evenements, rum, diagnostics = NULL, actes_ccam = NULL, entete = NULL, version = NULL, colmap = NULL, par_rum = FALSE )iter_evenements_pmsi( evenements, rum, diagnostics = NULL, actes_ccam = NULL, entete = NULL, version = NULL, colmap = NULL, par_rum = FALSE )
evenements, rum, diagnostics, actes_ccam
|
Tables décrites ci-dessus. |
entete |
Liste : |
version |
Version du schéma ; sinon |
colmap |
Renommage de colonnes |
par_rum |
Un fichier par RUM ; |
Liste d'éléments list(evt = ligne, tree = arbre).
evenements <- data.frame(evt_id = "S1", ipp = "123", sexe = "F", date_naissance = as.Date("1960-01-01"), nda = "240000001", venue_date_entree = as.Date("2024-05-02")) rum <- data.frame(evt_id = "S1", rum_id = 1L, um = "1201", um_date_entree = as.Date("2024-05-02"), um_mode_entree = "8", dp = "I21.0") arbres <- iter_evenements_pmsi(evenements, rum, entete = list(emetteur = "DIM", destinataire = "DPI")) str(arbres[[1]]$tree$evenementsPMSI$evenementPMSI$rss$rum[[1]], max.level = 1) cat(hprim_to_xml(arbres[[1]]$tree, xmlns = NULL))evenements <- data.frame(evt_id = "S1", ipp = "123", sexe = "F", date_naissance = as.Date("1960-01-01"), nda = "240000001", venue_date_entree = as.Date("2024-05-02")) rum <- data.frame(evt_id = "S1", rum_id = 1L, um = "1201", um_date_entree = as.Date("2024-05-02"), um_mode_entree = "8", dp = "I21.0") arbres <- iter_evenements_pmsi(evenements, rum, entete = list(emetteur = "DIM", destinataire = "DPI")) str(arbres[[1]]$tree$evenementsPMSI$evenementPMSI$rss$rum[[1]], max.level = 1) cat(hprim_to_xml(arbres[[1]]$tree, xmlns = NULL))
Arbres des messages evenementsServeurActes, un par événement
iter_evenements_serveur_actes( evenements, actes_ccam = NULL, actes_ngap = NULL, entete = NULL, version = NULL, colmap = NULL, par_acte = FALSE )iter_evenements_serveur_actes( evenements, actes_ccam = NULL, actes_ngap = NULL, entete = NULL, version = NULL, colmap = NULL, par_acte = FALSE )
evenements, actes_ccam, actes_ngap
|
Tables ( |
entete |
Liste : |
version |
Version du schéma ; sinon |
colmap |
Renommage de colonnes |
par_acte |
Un message par acte (unité atomique) au lieu d'un par événement. Le
contexte (patient, venue, intervention) est répété ; |
Lire des messages evenementsServeurEtatsPatient vers des tables
read_evenements_etat_patient( sources, extra = NULL, version = NULL, exiger_ok = FALSE )read_evenements_etat_patient( sources, extra = NULL, version = NULL, exiger_ok = FALSE )
sources |
Fichier(s), dossier, motif glob ou vecteur raw. |
extra |
Colonnes-chemins supplémentaires, par table :
|
version |
Forcer une version de schéma. |
exiger_ok |
Ne lire que les |
Liste de tibbles evenements, diagnostics.
f <- system.file("extdata", "etat_patient_00001.xml", package = "hprimxml") t <- read_evenements_etat_patient(f) t$diagnostics # un IGS2 se relit par des colonnes-chemins (voir l'exemple de write_evenements_etat_patient) # read_evenements_etat_patient("sortie/igs2", extra = list(evenements = c("igs2/@age", "igs2/valeurGlobale")))f <- system.file("extdata", "etat_patient_00001.xml", package = "hprimxml") t <- read_evenements_etat_patient(f) t$diagnostics # un IGS2 se relit par des colonnes-chemins (voir l'exemple de write_evenements_etat_patient) # read_evenements_etat_patient("sortie/igs2", extra = list(evenements = c("igs2/@age", "igs2/valeurGlobale")))
Inverse de write_evenements_pmsi() : mêmes tables, mêmes colonnes. evt_id est le nom
du fichier sans extension ; rum_id le rang du RUM dans le RSS.
read_evenements_pmsi( sources, extra = NULL, version = NULL, exiger_ok = FALSE, format_diagnostics = c("long", "colonnes") )read_evenements_pmsi( sources, extra = NULL, version = NULL, exiger_ok = FALSE, format_diagnostics = c("long", "colonnes") )
sources |
Fichier(s), dossier, motif glob ou vecteur raw. |
extra |
Colonnes-chemins supplémentaires, par table :
|
version |
Forcer une version de schéma. |
exiger_ok |
Ne lire que les |
format_diagnostics |
|
Liste de tibbles evenements, rum, diagnostics, actes_ccam.
f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") t <- read_evenements_pmsi(f) t$rum[, c("evt_id", "rum_id", "rum_emetteur", "um", "um_date_entree")] t$diagnostics # diagnostics en colonnes de `rum`, et un attribut sans colonne dédiée t <- read_evenements_pmsi(f, format_diagnostics = "colonnes", extra = list(rum = "@classant")) t$rum[, c("rum_id", "dp", "dr", "das", "@classant")]f <- system.file("extdata", "pmsi_00001.xml", package = "hprimxml") t <- read_evenements_pmsi(f) t$rum[, c("evt_id", "rum_id", "rum_emetteur", "um", "um_date_entree")] t$diagnostics # diagnostics en colonnes de `rum`, et un attribut sans colonne dédiée t <- read_evenements_pmsi(f, format_diagnostics = "colonnes", extra = list(rum = "@classant")) t$rum[, c("rum_id", "dp", "dr", "das", "@classant")]
Lire des messages evenementsServeurActes vers des tables
read_evenements_serveur_actes( sources, extra = NULL, version = NULL, exiger_ok = FALSE )read_evenements_serveur_actes( sources, extra = NULL, version = NULL, exiger_ok = FALSE )
sources |
Fichier(s), dossier, motif glob ou vecteur raw. |
extra |
Colonnes-chemins supplémentaires, par table :
|
version |
Forcer une version de schéma. |
exiger_ok |
Ne lire que les |
Liste de tibbles evenements, actes_ccam (CCAM), actes_ngap (NGAP, avec une colonne
liste nabm).
f <- system.file("extdata", "actes_00001.xml", package = "hprimxml") t <- read_evenements_serveur_actes(f) t$evenements[, c("evt_id", "ipp", "nda", "intervention_id")] t$actes_ccam[, c("evt_id", "acte_id", "code", "date_execution", "medecin")]f <- system.file("extdata", "actes_00001.xml", package = "hprimxml") t <- read_evenements_serveur_actes(f) t$evenements[, c("evt_id", "ipp", "nda", "intervention_id")] t$actes_ccam[, c("evt_id", "acte_id", "code", "date_execution", "medecin")]
Protocole : l'émetteur dépose le .xml, puis, une fois celui-ci écrit intégralement,
un .ok vide de même nom (fichier_ok = TRUE des fonctions d'écriture). Le
destinataire ne traite un .xml qu'une fois son .ok présent (exiger_ok = TRUE des
fonctions de lecture).
suivi_depots(fichiers, extension_ok = ".ok")suivi_depots(fichiers, extension_ok = ".ok")
fichiers |
Dossier, motif glob ou vecteur de |
extension_ok |
Extension des marqueurs. |
Tibble : evt_id, fichier, date_xml, complet, date_ok. Les .ok sans
.xml correspondant sont ajoutés avec fichier manquant et complet faux.
ancien <- setwd(tempdir()) evenements <- data.frame(evt_id = "S1", ipp = "123", sexe = "F", date_naissance = as.Date("1960-01-01"), nda = "240000001", venue_date_entree = as.Date("2024-05-02")) rum <- data.frame(evt_id = "S1", 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")) write_evenements_pmsi(evenements, rum, entete = list(emetteur = "DIM", destinataire = "DPI"), out_dir = "depot", par_rum = TRUE, fichier_ok = TRUE) file.remove("depot/S1_2.ok") # dépôt « en cours » suivi_depots("depot")[, c("evt_id", "complet")] read_evenements_pmsi("depot", exiger_ok = TRUE)$evenements$evt_id setwd(ancien)ancien <- setwd(tempdir()) evenements <- data.frame(evt_id = "S1", ipp = "123", sexe = "F", date_naissance = as.Date("1960-01-01"), nda = "240000001", venue_date_entree = as.Date("2024-05-02")) rum <- data.frame(evt_id = "S1", 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")) write_evenements_pmsi(evenements, rum, entete = list(emetteur = "DIM", destinataire = "DPI"), out_dir = "depot", par_rum = TRUE, fichier_ok = TRUE) file.remove("depot/S1_2.ok") # dépôt « en cours » suivi_depots("depot")[, c("evt_id", "complet")] read_evenements_pmsi("depot", exiger_ok = TRUE)$evenements$evt_id setwd(ancien)
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.
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 )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 )
evenements, diagnostics
|
Tables. |
entete |
Liste : |
out_dir |
Dossier de sortie. |
filename |
Gabarit ( |
version |
Version du schéma ; sinon |
xmlns |
|
encoding |
Encodage des fichiers. |
validate_xsd |
|
colmap |
Renommage de colonnes |
identifiant_egal_nom_fichier |
L'identifiantMessage est le nom du fichier sans
extension (défaut) ; une colonne |
fichier_ok |
Dépose un |
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é ; |
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.
Les chemins écrits (invisible).
# 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" ) # IGS2 : classe et points de chaque item, par patient print(controle, width = Inf) igs2$valeurGlobale setwd(ancien)# 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" ) # IGS2 : classe et points de chaque item, par patient print(controle, width = Inf) igs2$valeurGlobale setwd(ancien)
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.
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 )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 )
evenements, rum, diagnostics, actes_ccam
|
Tables décrites ci-dessus. |
entete |
Liste : |
out_dir |
Dossier de sortie. |
filename |
Gabarit ( |
version |
Version du schéma ; sinon |
xmlns |
|
encoding |
Encodage des fichiers. |
validate_xsd |
|
colmap |
Renommage de colonnes |
par_rum |
Un fichier par RUM ; |
identifiant_egal_nom_fichier |
L'identifiantMessage est le nom du fichier sans
extension (défaut) ; une colonne |
fichier_ok |
Dépose un |
actes |
Ancien nom de |
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).
Les chemins écrits (invisible).
# 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) rum_relu setwd(ancien)# 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) rum_relu setwd(ancien)
Un fichier par événement. evenements : patient, venue (nda, venue_*), intervention
(intervention_*, demande_*). actes_ccam : une ligne par acte CCAM, avec evt_id,
acte_id, code, activite, phase, date_execution, medecin et en option
heure_execution, uf, medecin_principal, quantite, action, facturable, valide,
modificateurs, extension_pmsi, extension_documentaire, association_non_prevue.
write_evenements_serveur_actes( evenements, actes_ccam = NULL, actes_ngap = 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_acte = FALSE, actes = NULL )write_evenements_serveur_actes( evenements, actes_ccam = NULL, actes_ngap = 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_acte = FALSE, actes = NULL )
evenements, actes_ccam, actes_ngap
|
Tables ( |
entete |
Liste : |
out_dir |
Dossier de sortie. |
filename |
Gabarit ( |
version |
Version du schéma ; sinon |
xmlns |
|
encoding |
Encodage des fichiers. |
validate_xsd |
|
colmap |
Renommage de colonnes |
identifiant_egal_nom_fichier |
L'identifiantMessage est le nom du fichier sans
extension (défaut) ; une colonne |
fichier_ok |
Dépose un |
par_acte |
Un message par acte (unité atomique) au lieu d'un par événement. Le
contexte (patient, venue, intervention) est répété ; |
actes |
Ancien nom de |
Unité atomique du serveur d'actes : l'acte (acteCCAM), porteur de l'attribut
action et d'un identifiant. par_acte = TRUE écrit un message par acte.
actes_ngap : une ligne par acte NGAP (consultation, forfait technique, biologie), avec
evt_id, acte_id, lettre_cle, coefficient, date_execution, medecin et en option
heure_execution, uf, quantite, denombrement, nabm (codes NABM : colonne liste ou
chaîne séparée par des virgules), montant_total, numero_forfait_technique,
numero_agrement_appareil, action, facturable, valide. Un message peut porter des
actes CCAM, des actes NGAP, ou les deux ; par_acte découpe les deux.
Les chemins écrits (invisible).
# Les exemples écrivent dans un dossier temporaire ancien <- setwd(tempdir()) # Régénère data/xml_tests/actes/00001.xml : une intervention et quatre actes CCAM. 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 = "oui", commentaire = "HPRIM-TEST", date_heure_production = ts("2024-01-01 01:01:01") ) # Une ligne par événement : patient, venue, intervention et demande evenements <- tibble( evt_id = "00001_acte", 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", `venue/@prive` = "non", intervention_id = "000000000001", intervention_date_debut = as.Date("2024-01-01"), intervention_heure_debut = hms::as_hms("08:10:00"), intervention_date_fin = as.Date("2024-01-01"), intervention_heure_fin = hms::as_hms("09:00:00"), intervention_uf = "4321", demande_date = as.Date("2023-12-25"), demande_heure = hms::as_hms("02:30:00"), demande_uf = "4321" ) # Une ligne par acte CCAM actes_ccam <- tibble( evt_id = "00001_acte", acte_id = c("121212", "121213", "121214", "121215"), code = c("EBLA003", "YYYY033", "EPLF002", "NFKA006"), activite = 1L, phase = 0L, date_execution = as.Date("2024-01-01"), heure_execution = hms::as_hms("08:10:00"), medecin = "01234567", uf = "4321", quantite = "1", # nombre5 : chaîne de chiffres dans le XSD facturable = "oui", valide = "oui" ) fichiers <- write_evenements_serveur_actes( evenements, actes_ccam, entete = entete, out_dir = "sortie/actes", # -> sortie/actes/00001_acte.xml validate_xsd = "warn" ) fichiers setwd(ancien)# Les exemples écrivent dans un dossier temporaire ancien <- setwd(tempdir()) # Régénère data/xml_tests/actes/00001.xml : une intervention et quatre actes CCAM. 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 = "oui", commentaire = "HPRIM-TEST", date_heure_production = ts("2024-01-01 01:01:01") ) # Une ligne par événement : patient, venue, intervention et demande evenements <- tibble( evt_id = "00001_acte", 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", `venue/@prive` = "non", intervention_id = "000000000001", intervention_date_debut = as.Date("2024-01-01"), intervention_heure_debut = hms::as_hms("08:10:00"), intervention_date_fin = as.Date("2024-01-01"), intervention_heure_fin = hms::as_hms("09:00:00"), intervention_uf = "4321", demande_date = as.Date("2023-12-25"), demande_heure = hms::as_hms("02:30:00"), demande_uf = "4321" ) # Une ligne par acte CCAM actes_ccam <- tibble( evt_id = "00001_acte", acte_id = c("121212", "121213", "121214", "121215"), code = c("EBLA003", "YYYY033", "EPLF002", "NFKA006"), activite = 1L, phase = 0L, date_execution = as.Date("2024-01-01"), heure_execution = hms::as_hms("08:10:00"), medecin = "01234567", uf = "4321", quantite = "1", # nombre5 : chaîne de chiffres dans le XSD facturable = "oui", valide = "oui" ) fichiers <- write_evenements_serveur_actes( evenements, actes_ccam, entete = entete, out_dir = "sortie/actes", # -> sortie/actes/00001_acte.xml validate_xsd = "warn" ) fichiers setwd(ancien)