Co marquage avec service public.fr

Co marquage avec service public.fr Évolution du flux Vos droits et démarche De la version 2.2 à la version 2.3 Direction de l information légale et administrative Suivi du document Version date Remarque 1.0 14/10/2013 1/20

1 Sommaire 1 Sommaire...2 2 Présentation générale...3 2.1 Rappel des dernières évolutions du flux...3 2.2 Objectif général de la version 2.3...3 2.3 Diffusion en parallèle des deux versions du flux : v2.2 et v2.3...3 3 Détail des évolutions du modèle de données...4 3.1 Éléments obsolètes et supprimés...4 3.2 Élément déprécié...4 3.3 Ajout des attributs d audience manquants...4 3.4 Correction de l élément Source des blocs OuSAdresser...5 3.5 Fiche à liens externes...5 3.6 Propriété «en cours de mise à jour»...6 3.7 Balises d intentionnalité...6 3.8 ServiceEnLigne ajout des numéros de la notice liée...7 3.9 Balises Abreviation et Definition dans ServiceComplementaire...7 3.10 Liste numérotées...7 3.11 Indices et exposants...8 3.12 Balises internes au Paragraphe...9 3.13 Tableaux...10 4 Autres évolutions liées à l accessibilité...11 4.1 SiteInternetPublic...11 4.2 Sigles et acronymes...11 5 Evolutions de l architecture du flux...13 5.1 Fichiers supprimés...13 5.2 Nouveau fichiers...13 6 Fichiers fournis en exemple...18 7 Références...20 7.1 Schéma et documentation...20 7.2 Accès aux données flux V2.2...20 7.3 Accès aux données flux V2.3...20 2/20

2 Présentation générale Le flux Vos droits et démarches évolue à l automne 2013 en passant de la version 2.2 à la version 2.3. 2.1 Rappel des dernières évolutions du flux La version 2.2 du flux a été mise à disposition en juillet 2012. Cf. article publié le 06.07.2012 sur le blog des partenaires de service public.fr : http://communaute.servicepublic.fr/?p=1593 Le changement d outil de production des données (Copéria), fin novembre 2012 a eu également un impact sur les contenus mis à disposition, sans modification du modèle de données. Cf. article du 28.11.2012 sur le blog des partenaires de service public.fr : http://communaute.service public.fr/?p=1658 2.2 Objectif général de la version 2.3 Le passage du flux V2.3 permet : L enrichissement du modèle documentaire pour répondre au besoin éditorial La correction d anomalies présentes dans le flux v2.2 L ajout de nouveaux fichiers XML à l export La suppression des fichiers XML obsolètes Le nettoyage et la «modularisation» du schéma dont une partie est commune avec le flux de la «Base de connaissance» du renseignement téléphonique («39 39»). 2.3 Diffusion en parallèle des deux versions du flux : v2.2 et v2.3 IMPORTANT De façon à permettre l adaptation progressive des solutions de rediffusion, les deux flux seront mis à disposition parallèlement. Le flux v2.2 sera mis à jour et diffusé 6 mois après mise à disposition du nouveau flux v2.3. Il disparaîtra ensuite. Le flux v2.2 diffusera les nouveaux éléments du flux v2.3 mais de manière «dégradée». Il n est cependant pas possible de diffuser certains de ces nouveaux éléments sans risque de créer du contresens à l affichage, comme les tableaux fusionnés pour lesquels l usager sera renvoyé vers service public.fr. C est pourquoi, il est conseillé aux rediffuseurs de migrer rapidement vers cette nouvelle version du flux et c est également pourquoi il n est pas souhaitable de le maintenir le flux v2.2 plus de 6 mois après évolution. 3/20

3 Détail des évolutions du modèle de données 3.1 Éléments obsolètes et supprimés Les balises suivantes ne sont pas ou plus alimentées et sont supprimées du flux v2.3 : Balise Introduction/Description Paragraphe/PartieLocale CentreDeContact (élément transformé en élément OuSAdresser de type «centre de contact») Publication/Montant (élément transformé en Valeur et amené à évoluer ensuite) Dans l élément LienInterne l attribut @nature (Ressource, Noeud,Fiche) est supprimé. La nature peut être déduite du type. 3.2 Élément déprécié L identifiant des sous dossiers, bien que «déprécié» depuis fin 2011, a posé problème avec le l export v2.2 issu de Coperia 2 (identifiant mouvant, syntaxe singulière,...). Le sous dossier n est pas un élément de structure : il ne fait pas l objet d un export de fichier XML la liste des sous dossiers d un dossier ne le devrait pas faire l objet d une page HTML de navigation à la rediffusion. Il n est pas possible de produire, dans Copéria 2, un identifiant unique et pérenne. Il a été décidé de conserver cet attribut en l état pour la version 2.3. L objectif étant de le supprimer dans la prochaine version majeure du schéma. 3.3 Ajout des attributs d audience manquants Le poly attachement est possible grâce à l attribut @audience. Cet attribut est manquant sur certaines balises dans le flux v2.2, ce qui crée des erreurs 404 à la diffusion. Le flux v2.3 ajoute l attribut @audience sur les éléments : QuestionReponse pourensavoirplus 4/20

3.4 Correction de l élément Source des blocs OuSAdresser L élément source des OuSAdresser est actuellement improprement exporté dans la balise OuSAdresser/RessourceWeb/Source quand une ressource web existe. Ce n est pas systématique et incorrect sur le plan documentaire. Le flux v2.3 : ajoute la balise OuSAdresser/Source supprime la balise OuSAdresser/RessourceWeb/Source devenue inutile. Schéma Eléments / Attributs Commentaire Structure 3.5 Fiche à liens externes Dans le flux v2.2, pour les fiches avec liens externes, les LiensExternes ne sont plus publiés directement dans le bloc Texte et on leur ajoute des attributs notamment pour l accessibilité. Evolution flux v2.3 On crée un élément LienExterneCommenté, contenant un champ de commentaire (bloc de texte enrichi) associé à un LienExterne. On ajoute les attributs nécessaire à l accessibilité : @format, @poids et @langue. Ces nouveaux attributs seront «dégradés» dans le flux v2.2, placés dans le titre entre parenthèses. Remarques : Il existe deux types de liens externes : o site web, pour lesquels on précisera les attributs la langue o document, pour lesquels on précisera les attributs de poids, format et langue. Les liens externes font l objet d un export XML. 5/20

Schéma Eléments / Attributs Commentaire Structure LienExterne/ @commentairelien LienExterne/@lang LienExterne/@poids LienExterne/@format Dans le flux v2.2, les informations sont ajoutées, en mode «dégradé», à la suite du titre entre parenthèses. L attribut peut prendre la valeur conforme aux standards ISO639 ou RFC1766. Exemple : «fr». Pour la gestion de l accessibilité. Description textuelle du poids du document lié. Exemple : «100 kilo octets» ou «100 Ko» Description textuelle du format du document lié. Exemple : «format PDF» 3.6 Propriété «en cours de mise à jour» Dans le flux 2.2, l information «en cours de mise à jour» est placée dans dc:subject. Évolution flux 2.3 : on ajoute l attribut @statut = «encoursdemiseajour» aux éléments Publication et ServiceComplémentaire. Par défaut l attribut est absent. 3.7 Balises d intentionnalité Dans le flux v2.2 les éléments d intentionnalité (à savoir, attention, à noter...) ne sont pas modélisés explicitement. On crée un chapitre ou sous chapitre avec le type correspondant. Évolution flux 2.3 : on crée les balises ASavoir, Attention et ANoter. Les balises d intentionnalité sont autorisées en descendantes directes des balises : Texte Introduction (qui est enrichie par ailleurs en y permettant les sigles et acronymes) 6/20

3.8 ServiceEnLigne ajout des numéros de la notice liée Une notice explicative peut être liée à un CERFA (Centre d enregistrement et de révision des formulaires administratifs). Elle porte elle même un numéro de CERFA. Le flux v2.3 ajoute les attributs NoticeLiee/@numerocerfa et NoticeLiee/@autrenumero. Dans le flux v2.2 le numéro CERFA est publié dans l attribut commentairelien. 3.9 Balises Abreviation et Definition dans ServiceComplementaire Les différentes zones de texte des services complémentaires peuvent contenir des définitions ou des abréviations. Le flux v2.3 ajoute : les balises ServiceComplementaire/Abreviation et ServiceComplementaire/Definition ; Schéma Eléments / Attributs Commentaire Structure Abréviation/@type [«sigle» «acronyme»] 3.10 Liste numérotées Flux v2.2 Seules les listes «à puce» existent dans le schéma v2.2. Le flux v2.3 permet l utilisation des listes ordonnées en ajoutant un attribut Liste/@type. Dans le flux v2.2, les listes numérotées sont «dégradées» en listes à puces. 7/20

Schéma Eléments / Attributs Commentaire Publication.xsd Liste/@type [«numero» «puce»] Puce par défaut. 3.11 Indices et exposants Le flux v2.3 permet l utilisation d indices et exposants en ajoutant les balises Paragraphe/Indice et Paragraphe/Exposant qui n existaient pas dans le flux v2.2. Dans le flux v2.2, ces nouvelles balises sont «dégradées» en mode texte (exemples «x indice 2» ou «x exposant 2»). Schéma Eléments / Attributs Commentaire Publication.xsd 8/20

3.12 Balises internes au Paragraphe Le flux v2.3 ajoute les balises : Paragraphe/Expression Paragraphe/TermeEtranger Paragraphe/Variable Ces balises peuvent être imbriquées. Elles n avaient pas d équivalent en v2.2. Dans l export v2.2 ces balises sont simplement supprimées. Schéma Eléments / Attributs Commentaire Publication.xsd Attribut TermeEtranger/@langue La balise TermeEtranger possède un attribut de langue exporté au format ISO639 ou RFC1766. Exemple : «fr» 9/20

3.13 Tableaux Le flux v2.3 ajoute la possibilité de fusionner des cellules de tableau. Par ailleurs, des champs sont ajoutés pour améliorer l accessibilité en diffusion ATTENTION Le schéma v2.2 ne permet pas d exporter les cellules fusionnées. Les tableaux avec cellules fusionnées ne peuvent pas être publiés en «mode dégradé» ce qui risquerait d introduire des contresens. Il a été décidé, dans le cas d un tableau complexe, de fournir un lien permettant de consulter le tableau complexe sur service public.fr. Le tableau ne sera pas diffusé sur le site local. Exemple : <Paragraphe>Consulter le tableau «<LienExterne URL="http://www.servicepublic.fr/particuliers/F31553.xhtml">Légende du tableau</lienexterne>»</paragraphe> Elément / attribut Opération / commentaire Tableau/Resume Tableau/Titre Tableau/@langue Ajout de l élément pour l accessibilité en diffusion. Les résumés seront ajoutés progressivement par la rédaction. Ajout de l élément pour l accessibilité en diffusion. Les titres seront ajoutés progressivement par la rédaction. Ajout de l attribut pour l accessibilité en diffusion. 10/20

Tableau/Colonne/@largeur Tableau/Cellule/ @fusionhorizontale @fusionverticale Ajout de l attribut pour permettre d affiner l affichage en diffusion. La largeur est exprimée en nombre de caractères maximum à afficher (proches des em de CSS). Permet la fusion des cellules. Des exemples sont disponibles dans les fichiers XML livrés en exemple. 4 Autres évolutions liées à l accessibilité 4.1 SiteInternetPublic Elément / attribut Opération / commentaire Publication/SiteInternetPublic Ajout de l attribut @langue 4.2 Sigles et acronymes Les sigles et acronymes sont fournis dans un bloc de texte sous forme des balises LienInterne et développés en fin de fichier dans des balises Abreviation. Il est nécessaire de les distinguer. Le flux 2.3 ajoute : Les valeurs «Sigle» et «Acronyme» pour l élément LienInterne/@type. La valeur Abreviation n est plus utilisée. L attribut Abreviation/@type = [Sigle Acronyme] qui n existait pas en v2.2. Elément / attribut Opération / commentaire LienInterne/@type = [Sigle Acronyme] Code XML v2.3 <LienInterne type="sigle" LienPublication="R30178">Terme sigle</lieninterne> <LienInterne type="acronyme" LienPublication="R30179">Terme acronyme</lieninterne> @type="abréviation" n est plus utilisé dans le LienInterne en v2.3 11/20

Abreviation/@type = [Sigle Acronyme] Code XML v2.3 <Abreviation ID="R30178" type="sigle"> <Titre>Terme sigle</titre> <Texte> <Paragraphe>Sigle développé</paragraphe> </Texte> </Abreviation> <Abreviation ID="R30179" type="acronyme"> <Titre>Terme acronyme</titre> <Texte> <Paragraphe>Acronyme développé</paragraphe> </Texte> </Abreviation> 12/20

5 Evolutions de l architecture du flux 5.1 Fichiers supprimés Themes.xml Dans le flux v2.2, le fichier Themes.xml est exporté, mais sa structure n a pas changé depuis le flux v1. Il est aujourd hui obsolète. Il est supprimé dans le flux v2.3. Les informations qu il contient pourront être retrouvées dans le nouveau fichier arborescence.xml. Remarque : Le fichier est maintenu en l état dans le flux v2.2. Journal.xml Dans le flux v2.2 Le fichier Journal.xml est déjà exporté, mais ne possède pas de schéma correspondant. Sa structure n a pas changé depuis le flux. Il se base sur les dates de modification de l item principal (fiche). Les fichiers alors que les informations proviennent de plusieurs items (fil d Ariane, satellites externalisés,...). La date de modification de l item principal correspondant n est donc pas pertinente. Ce fichier n est pas utilisé par service public.fr. Il a donc été décidé de le supprimer dans le flux v2.3. Les rediffuseurs pourront se baser sur le fichier arborescence.xml pour déterminer eux mêmes le différentiel entre leur précédente intégration et le nouveau contenu à intégrer. Une feuille de transformation XSL est associée à chacun de ces nouveaux fichiers. 5.2 Nouveau fichiers Le flux v2.3 produits de nouveaux fichiers XML. Les fichiers sont publié par audience, dans chacun des répertoires «particuliers» «associations» et «professionnelsentreprises». En dehors du fichier arborescence, ces fichiers sont produits pour simplifier l affichage sur service public.fr. Arborescence.xml Ce fichier recense l ensemble des nœuds, fiches et ressources du document, dans une structure arborescente (en ne parcourant que les liens forts père fils). Elément / attribut Opération / commentaire Shéma @ID Identifiant de l item Forme [ F N R ] et suite de 1 à 5 chiffres Exemple F1042, N19803, R1 13/20

Attention : Les identifiants des sous dossiers sont de la forme «SD» suivi de 1 à 5 chiffres (exemple SD323). Ils ne sont pas pérennes et peuvent changer lors de la restructuration du nœud parent. @type Theme Sous theme Dossier Sous dossier Fiche d'information Fiche Question réponse Etc. @fichier = «oui non» Précise si l item fait l objet d un fichier XML à l export ou non @datedemodification Format ISO 8601 Exemple : 2013 06 13T12:50:24 Exemple de code <Arborescence > <dc:date xmlns:dc="http://purl.org/dc/elements/1.1/">2013 09 19T11:55:25</dc:date> <Item fichier="true" datedemodification="2013 06 13T12:50:24" ID="N19803" type="theme" audience="particuliers"> <Titre>Argent</Titre> <Item fichier="true" datedemodification="2013 03 15T07:17:49" ID="N20263" type="sous theme" audience="particuliers"> <Titre>Assurance</Titre> <Item fichier="true" datedemodification="2013 06 13T12:50:15" ID="N44" type="dossier" audience="particuliers"> <Titre>Assurance habitation</titre> <Item fichier="false" datedemodification="2013 06 13T12:50:15" ID="SD1" type="sous dossier"> <Titre>Vie du contrat</titre> <Item fichier="true" datedemodification="2013 03 15T15:43:17" ID="F2591" type="fiche d'information" audience="particuliers"> <Titre>Souscription d'un contrat d'assurance habitation</titre> <Item fichier="true" datedemodification="2013 07 02T12:04:35" ID="F1349" type="fiche d'information" audience="particuliers"> <Titre>Assurance du logement obligatoire du locataire</titre> </Item> Glossaire.xml Liste des définitions du glossaire appelées dans les différents satellites/fiches de l audience en cours. Schéma Exemple de code <Glossaire> <dc:date>2013 09 19T11:58:41</dc:date> <Definition ID="R3018"> <Titre>Abattement</Titre> </Definition> <Definition ID="R16145"> <Titre>Abrogation</Titre> 14/20

</Definition> <Definition ID="R2696"> <Titre>Acquittement</Titre> </Definition> Centres de contact Liste des items «Où S adresser» de type «Centre de contact» appelés dans les différents satellites/fiches de l audience en cours (en ne parcourant que les liens forts) ; Cet export ne concerne bien que les «Ou S adresser» de type «Centre de contact», et non plus largement les «Où S adresser» de type «National». Schéma Exemple de code <CentresDeContact > <dc:date>2013 09 19T11:58:41</dc:date> <Contact ID="R167"> <Titre>08 Victimes</Titre> </Contact> <Contact ID="R20657"> <Titre>3211 Services à la personne</titre> </Contact> 15/20

Dossiers Liste des dossiers pour l audience en cours. L élément Thème concerne le thème parent. Elément / attribut Opération / commentaire Structure Exemple de code <Dossiers > <dc:date>2013 09 19T11:58:41</dc:date> <Dossier ID="N44"> <Titre>Assurance habitation</titre> <Theme ID="N19803"> <Titre>Argent</Titre> </Theme> </Dossier> <Dossier ID="N32"> <Titre>Assurance automobile (véhicule)</titre> <Theme ID="N19803"> <Titre>Argent</Titre> </Theme> </Dossier> 16/20

Ressources en ligne Liste des services en ligne marqués comme «top consultation», c est à dire, les formulaires les plus demandés affichés sur http://www.service public.fr/formulaires/ Ce fichier sera exporté par audience. Elément / attribut Opération / commentaire Schéma @type Peut prendre les valeurs [Formulaire Téléservice Module de calcul Lettre type ] Exemple de code <Dossiers > <dc:date>2013 09 19T11:58:41</dc:date> <Dossier ID="N44"> <Titre>Assurance habitation</titre> <Theme ID="N19803"> <Titre>Argent</Titre> </Theme> </Dossier> <Dossier ID="N32"> <Titre>Assurance automobile (véhicule)</titre> <Theme ID="N19803"> <Titre>Argent</Titre> </Theme> </Dossier> 17/20

6 Fichiers fournis en exemple Des fichiers XML sont produits dans le but de tester les évolutions. Ils sont livrées en accompagnement ce document, en version 2.3 et 2.2 «dégradé» pour comparaison si nécessaire. Fichier Tests possibles F31553.xml Fiche d information Tests : Attribut en cours de mise à jour Enrichissements simples Tableaux avec fusions de cellules Listes numérotées, listes imbriquées Caractères spéciaux Indices et exposants Balises d intentionnalité (ASavoir, ANoter, Attention) Enrichissements et tableaux dans les balises d intentionnalité Balises Sigle et Acronymes Références dans les Définitions Valeur F31554.xml Fiche d information avec liens externes F31555.xml Question Réponse F31556.xml Fiche d information F31568.xml Fiche d information N31076.xml Thème N31077.xml Dossier R32451.xml PourEnSavoirPlus R32466.xml PourEnSavoirPlus R32454.xml Définition de glossaire Liens Externes de type document et site web Enrichissements dans le chapô VoirAussi vers une Fiche VoirAussi vers un Dossier Enrichissements Référence dan la Définition de glossaire Attribut de statut du document «encoursdemiseajour» Imbrications multiples de balises (Expression, Citation Terme étranger, Mise en évidence, etc.) Lien externe de type site web pour FILE (Fiche d information avec liens externes) CommentaireLien Langue Lien externe de type "document" pour FILE CommentaireLien Format Poids Langue Définition de glossaire (avec référence de type site web) CommentaireLien 18/20

R32472.xml Définition de glossaire R32463.xml Service en ligne R32467.xml R32468.xml Service en ligne R32470.xml Site internet public arborescence.xml centresdecontact.xml glossaire.xml ressourcesenligne.xml dossiers.xml Définition de glossaire (avec ref de type document) CommentaireLien Format Poids Langue Formulaire de type site web CommentaireLien Langue Notice liée au formulaire Numéro de cerfa CommentaireLien Format Poids Langue Formulaire de type document CommentaireLien Format Poids Langue Notice liée au formulaire Numéro de cerfa CommentaireLien Format Poids Langue Enrichissement dans le chapô 19/20

7 Références 7.1 Schéma et documentation Mise à disposition du schéma v2.3, de la documentation et des fichiers d exemple : http://www.service public.fr/apropos du site/informations techniques/001366.html 7.2 Accès aux données flux V2.2 Pas de changement. Répertoire pour les contenus de Vos droits et démarches pour les : «Particuliers» : http://lecomarquage.service public.fr/xml2v2/ «Associations» : http://lecomarquage.service public.fr/xmlassov2/ «Professionnels entreprises» : http://lecomarquage.service public.fr/xmlpmev2/ Les fichiers Zip sont accessibles dans le répertoire : http://lecomarquage.service public.fr/xml2v2/zipv2/ Les liens sont de la forme : vosdroitsaaaammjj n.zip Un fichier avec un suffixe «latest» (exemple vosdroist latest.zip) pointe vers la dernière archive pour chacun des 3 répertoires. 7.3 Accès aux données flux V2.3 Le flux v2.3 est accessible aux adresses suivantes : «Particuliers» http://lecomarquage.service public.fr/vdd/2.3/part/xml http://lecomarquage.service public.fr/vdd/2.3/part/zip «Associations» http://lecomarquage.service public.fr/vdd/2.3/asso/xml http://lecomarquage.service public.fr/vdd/2.3/asso/zip «Professionnels entreprises» http://lecomarquage.service public.fr/vdd/2.3/pro/xml http://lecomarquage.service public.fr/vdd/2.3/pro/zip Un fichier avec un suffixe «latest» (exemple vosdroist latest.zip) pointe vers la dernière archive pour chacun des 3 répertoires */zip. 20/20