Finance:Récupération de données financières/Format d'un fichier de configuration

De Ensiwiki
Aller à : navigation, rechercher

Windows.png  Windows 

XDataFi

Développeurs Wilfried KOUASSI, Olivier MOLLANDIN, Adrien THAI


Cette page correspond au manuel utilisateur de l'application XDataFi réalisée dans le cadre de leur projet de spécialité par Wilfried KOUASSI, Olivier MOLLANDIN et Adrien THAI, du 21 mai au 15 juin 2012. Pour retourner à la page principale du projet, veuillez suivre le lien ci-dessous :
Récupération de données financières


L'interface de XDataFi peut être configurée de deux manières:

  • manuellement, en cliquant sur les boutons dédiés à cet effet
  • en important un fichier de configuration xml, dans lequel on spécifie les types de données que l'on veut observer.

Nous expliquons ici le format à respecter pour que le fichier de configuration soit bien pris en compte par l'application.


Exemple de fichier de configuration

Avant tout, voici un modèle de fichier de configuration:

      <?xml version="1.0" encoding ="UTF-8"?>
          <RecupData>
              <ListeIndex>
                  <Index>^FCHI</Index>
              </ListeIndex>
              <Composantes></Composantes>
              <Champs>
                  <Param>Open</Param>
                  <Param>Volume</Param>
              </Champs>
              <DateDebut>2010-06-20</DateDebut>
              <DateFin>2011-06-20</DateFin>
              <Source>
                  <ChoixSource>yahoo</ChoixSource> 
              </Source>
              <ExportParam>
                  <Xml>exportTest.xml</Xml>
              </ExportParam>
          </RecupData>


Ce fichier xml, une fois importé, permet d'extraire les données relatives à l'indice du CAC 40 (de symbole ^FCHI).
Les données voulues sont dans cet exemple les valeurs à l'ouverture (Open) et le volume.
L'extraction se fait entre le 20 Juin 2010 et le 20 Juin 2011, à partir de Yahoo! Finance.
Enfin, il est indiqué en fin de code un nom de fichier (exportTest.xml) entre les balises <ExportParam>. Il s'agit d'une spécification indiquant à l'application qu'il faut exporter directement les données extraites dans le fichier exportTest.xml.

Remarque: l'indentation du code n'est pas obligatoire, et ne sert ici qu'à mettre en valeur les différentes balises.

Balises obligatoires

Les balises à inclure obligatoirement dans le fichier de configuration sont:

  • <RecupData>...</RecupData>
    Ce sont les balises principales du fichier, qui contiendront l'ensemble des spécifications voulues
  • <ListeIndex>...</ListeIndex>
    Ces balises contiennent zéro ou plusieurs symboles dont on veut extraire les données (chaque symbole doit être placé entre des balises <Index>)
  • <Composantes>...</Composantes>
    Dans le cas où l'utilisateur veut extraire les données relatives à toutes les composantes d'un indice (par exemple, les cours des composantes du CAC 40), il peut écrire entre ces balises le symbole de l'indice dont il veut extraire les composantes.
    Remarque: Si c'est le cas, il faut uniquement remplir les balises <Composantes>, et pas les balises <Index>
  • <Champs>...</Champs>
    Entre ces balises, il faut indiquer les types de données que l'on veut extraire (High, Low, Open, Close, Volume)
  • <DateDebut>...</DateDebut>
    Permet de spécifier la date de début d'extraction.
  • <DateFin>...</DateFin>
    Idem pour la date de fin d'extraction.
  • <Source>...</Source>
    On y met la source à partir de laquelle on veut extraire les données.


Balises optionnelles

Les balises suivantes peuvent ne pas figurer dans votre fichier de configuration:

  • <Index>...</Index>
    Contenues entre les balises <ListeIndex>, ces balises doivent contenir les noms des symboles entreprises dont on veut extraire les données (et pas les noms !).
    On peut bien sûr mettre plusieurs de ces balises, pour extraire les données de plusieurs entreprises.
    Remarque: si aucune balise de ce type n'est présente dans le fichier, il n'y aura simplement pas d'extraction.
  • <Param>...</Param>
    Ces balises contiennent les types de données à extraire (High, Low, etc).
  • <ChoixSource>...</ChoixSource>
    Contenues entre les balises <Source>, ces balises contiennent le nom de la source (yahoo, yahoo_yql, google, euronext ou defaut). Plusieurs de ces balises peuvent figurer entre les balises <Source>. Dans ce cas, l'application effectuera une complétion de données entre les différentes sources.
    Remarque: Si aucune balise <ChoixSource> n'est présente, la source sera "defaut".
  • <ExportParam>...</ExportParam>
    Ces balises ne sont à inclure que si vous désirez exporter les donneés par la suite. Si c'est le cas, il faut y mettre l'adresse relative du fichier destiné à contenir les données extraites, avec son extension. Celle-ci peut-être .xml, .csv, .mdf ou .json.

Levée d'exception

Si l'une des balises obligatoire manque dans le fichier de configuration, une exception est levée et un message d'erreur apparaît, indiquant clairement la balise manquante.