Région de Bruxelles-Capitale Fichiers XML de collecte de données 2/04/20121

Agenda du 2 avril Introduction 2.Solution Technique de collecte 3.Structures XML 4.Périodes de collectes 5.Nom de fichier 6.Documentation 7.Vues schématiques des XSD 8.Exemples XML 2/04/2012CLIO2

1.Introduction : Aperçu de la solution globale Pouvoirs Locaux STESUD ADEHIS Sherazade SD Works Staging Area Operational Data Store E-DWH Data Marts Oracle DB Sema n-tic Layer BO Universe Metadata Layer Security Layer XML files SFTP Statistiques 2/04/2012CLIO3

2.Solution Technique de collecte Le XML permet de structurer l'information dans des fichiers-texte sous une forme plus robuste que les fichiers binaires ou tabulaires. Les structures que devront suivre les différents fichiers XML seront formalisées dans des fichiers XSD. Ils seront utilisés pour valider les fichiers XML envoyés par les pouvoirs locaux. 2/04/2012CLIO4

3.Structures XML Nous aurons 4 structures XML représentées par 4 fichiers XSD : Données trimestrielles pour un agent clio_workforce_trimestrial.xsd Données annuelles pour les agents clio_workforce_annual.xsd Données trimestrielles pour le cadre statutaire approuvé clio_organization.xsd clio_organization.xsd Données trimestrielles pour les mandataires clio_workforce_trimestrial_representative.xsd clio_workforce_trimestrial_representative.xsd 2/04/2012CLIO5

4.Périodes de collectes trimestrielle (le dernier jour du mois qui suit la fin du trimestre) Un fichier pour le Cadre Un fichier pour les Agents Un fichier pour les Mandataires annuelle (fin avril de l’année suivante au plus tard) Un fichier pour les Agents reprenant leurs données financières Données du Trimestre 4 de l’année précédente Données du Trimestre 1 de l’année en cours et données annuelles de l’année précédente Données du Trimestre 2 de l’année en cours Données du Trimestre 3 de l’année en cours 2/04/2012CLIO6

5.Nom de fichier.xml le numéro du trimestre (1 digit) Si celui-ci est égal à 0 cela sera le rapport annuel. le code de l’institution (3 digit) l’année (4 digit) le type de données : WORKFORCE (effectif), ORGANIZATION (cadre), REPRESENTATIVE (mandataire), FINANCIAL (données financières) XXXXXXXXXXXXXX_ III_YYYY_ T 2/04/2012CLIO7

6.Documentation Un fichier ‘word’ de documentation sera fourni et définit les directives techniques à suivre dans le cadre de la collecte des données et est structuré en 3 chapitres principaux: Le chapitre Exemples XML défini des scénarios d’exemples et les fichiers XML correspondants qui permettent une meilleure compréhension des données attendues.Exemples XML Le chapitre Description des Template XSD décrit les règles à suivre concernant les données qui seront contenues dans les fichiers XML.Description des Template XSD Le chapitre Introduction donne un aperçu des modalités de transferts des fichiers XML.Introduction 2/04/2012CLIO8

7.Vues schématiques des XSD Données trimestrielles pour le cadre statutaire approuvé: 2/04/2012CLIO9

7.Vues schématiques des XSD Données trimestrielles pour un agent 2/04/2012CLIO10

7.Vues schématiques des XSD Données trimestrielles pour un agent/carrière 2/04/2012CLIO11

7.Vues schématiques des XSD Données trimestrielles pour les mandataires 2/04/2012CLIO12

7.Vues schématiques des XSD Données trimestrielles pour les mandataires/carrière 2/04/2012CLIO13

7.Vues schématiques des XSD Données annuelles pour les agents 2/04/2012CLIO14

7.Vues schématiques des XSD Données annuelles pour les agents/coût annuel 2/04/2012CLIO15

7.Vues schématiques des XSD Chaque élément recevant une valeur pourra suivre des règles de validation suivant les validations XSD disponibles dans la documentation. Exemple: Données annuelles pour les agents/coût annuel Valeur entre et Se compose de 3 ou 5 chiffres Se compose de 2 chiffres 2/04/2012CLIO16

8. Exemples XML Dans la documentation technique on retrouvera des exemples XML basés sur des scénarios fictifs pour chacun des fichiers de la collecte. Ces exemples permettent une meilleure compréhension des données attendues. Un mandataire est élu en octobre 2012 à Woluwe Saint Lambert comme Conseiller Communal sur la liste «GESTION COMMUNALE». Durant son mandat à la date du 12 juillet 2017, il décide de siéger de manière indépendante. En 2018 il n’est pas réélu mais en octobre 2024 sur la liste LB il est élu conseiller et devient échevin. Lors du décès du bourgmestre en fonction le devient en janvier Il est réélu en avril 2030 et prend sa pension en mars Scénario d’exemple pour un mandataire 2/04/2012CLIO17

9.Parcours détaillé de la documentation Navigation dans le document et détail des règles de validations. Parcours de l’exemple XML suivant le scénario «Effectif Trimestriel Mandataire ». 2/04/2012CLIO18

9.Parcours détaillé de la documentation Pour chacun des éléments du fichier XML on retrouvera les différents champs décrit ci-dessous: Diagramme: Représentation visuelle de l’entité décrite permettant une visualisation schématique Exemples : 2/04/2012CLIO19

9.Parcours détaillé de la documentation Type : Cette zone décrit le type de données auquel l’entité appartient. Les types de données possibles sont : Une date Un nombre entier Un nombre décimal Une chaîne de caractères Tout autre type XML prédéfini dans ce document Pour un type simple défini dans le document il y aura un hyperlien vers le chapitre si rapportant. En plus du type nous aurons également une information indiquant si le champ est obligatoire ou optionnel. On mentionnera également le nombre de fois où une entité peut survenir dans le fichier xml. Exemple : xs:unsignedShort Obligatoire Maximum une occurrence 2/04/2012CLIO20

9.Parcours détaillé de la documentation Utilisé par: Ce champ sera disponible dans le cadre d’un type défini dans le document donne l’information sur les entités qui utilisent ce type. L’objet défini dans cette section aura un hyperlien vers le chapitre s’ y rapportant. Description: Description du champ permettant une compréhension business de celui-ci. Parent: Enfants: Disponible suivant l’entité visualisée, elle donnera un hyperlien vers l’entité parente. Exemple : Dans le cas de l’entité HomeCountryCode du schéma ci-dessus. HomeLocationRepresentativeType Disponible suivant l’entité visualisée, elle donnera un hyperlien vers l(es) entité(s) enfant(s). Exemple : Dans le cas de l’entité HomeLocationRepresentativeType du schéma ci-dessus. HomeCountryCode HomePostalCode 2/04/2012CLIO21

9.Parcours détaillé de la documentation Validations: Défini les règles de validations que l’entité décrite devra suivre : valeurs minimales, maximales, pattern (format structuré à suivre comme un numéro national), doivent se retrouver dans une liste déterminée… Exemples : 2/04/2012CLIO22

9.Parcours détaillé de la documentation Un mandataire est élu en octobre 2012 à Woluwe Saint Lambert comme Conseiller Communal sur la liste «GESTION COMMUNALE». Durant son mandat à la date du 12 juillet 2017, il décide de siéger de manière indépendante. En 2018 il n’est pas réélu mais en octobre 2024 sur la liste LB il est élu conseiller et devient échevin. Lors du décès du bourgmestre en fonction en janvier 2026 il devient ?????????. Il prend sa pension en janvier Scénario d’exemple XML pour un mandataire Fichiers: 2/04/2012CLIO23

9.Parcours détaillé de la documentation Un mandataire est élu en octobre 2012 à Woluwe Saint Lambert comme Conseiller Communal sur la liste «GESTION COMMUNALE». Contenu du fichier REPRESENTATIVE _018_2012_4.xml : 2/04/2012CLIO24

9.Parcours détaillé de la documentation Durant son mandat à la date du 12 juillet 2017, il décide de siéger de manière indépendante. Contenu partiel du fichier REPRESENTATIVE _018_2017_3.xml: 2/04/2012CLIO25

9.Parcours détaillé de la documentation En 2018 il n’est pas réélu mais en octobre 2024 sur la liste LB il est élu conseiller et devient échevin. Contenu partiel du fichier REPRESENTATIVE _018_2024_4.xml: 2/04/2012CLIO26

9.Parcours détaillé de la documentation Lors du décès du bourgmestre en fonction en janvier 2026 il devient ????????. Contenu partiel du fichier REPRESENTATIVE _018_2026_1.xml: 2/04/2012CLIO27

9.Parcours détaillé de la documentation Il prend sa pension en janvier Contenu partiel du fichier REPRESENTATIVE _018_2028_1.xml: 2/04/2012CLIO28

Upload / Download des fichiers CLIO Serveur FTP BODS COM 004 CPAS 102 … COM 001 WINSCP CLIO DWH WINSCP 2/04/2012CLIO29

Caractéristiques Utilisation de l’outil WINSCP (ou autre client FTP) pour charger les données sur le serveur MINERVE Chaque utilisateur a accès à son propre container en lecture et écriture Chaque container contient deux folders : INBOX pour les fichiers éventuellement reçus OUTBOX pour l’envoi de fichiers vers BPL 2/04/2012CLIO30

2/04/2012CLIO31