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

Présentation au sujet: "Région de Bruxelles-Capitale Fichiers XML de collecte de données 2/04/20121."— Transcription de la présentation:

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

2 Agenda du 2 avril 2014 1.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

3 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

4 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

5 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

6 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

7 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

8 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

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

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

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

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

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

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

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

16 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 -50000 et 50000 Se compose de 3 ou 5 chiffres Se compose de 2 chiffres 2/04/2012CLIO16

17 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 2026. Il est réélu en avril 2030 et prend sa pension en mars 2031. Scénario d’exemple pour un mandataire 2/04/2012CLIO17

18 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

19 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

20 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

21 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

22 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

23 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 2028. Scénario d’exemple XML pour un mandataire Fichiers: 2/04/2012CLIO23

24 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

25 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

26 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

27 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

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

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

30 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

31 2/04/2012CLIO31