URL: https://linuxfr.org/users/epeios/journaux/dpkq-un-piocheur-de-donnees
Title: dpkq, un piocheur de données.
Authors: Claude SIMON
Date: 2015年07月01日T10:21:13+02:00
License: CC By-SA
Tags: xml, xsl, epeios, c++ et base_de_données
Score: 14
Dans le cadre de la mise à jour des utilitaires que j'ai développés, après vous avoir présenté [xppq](http://linuxfr.org/users/epeios/journaux/xppq-ou-une-autre-approche-de-la-gestion-des-arguments-de-la-ligne-de-commande) et [tmcq](http://linuxfr.org/users/epeios/journaux/tmcq-un-convertisseur-de-timecodes), voici maintenant [dpkq](http://q37.info/computing/epeios/tools/dpkq/).
`dpkq` est un piocheur de données basé sur le *framework* *Epeios*. Il pioche au hasard une fiche dans une table stockée dans un fichier XML, et l'écrit dans un autre fichier XML, en l'associant à un fichier XSL de manière à pouvoir l'afficher dans un navigateur Web avec une mise en forme HTML.
Cette description étant loin d'être d'une limpidité exemplaire (désolé, mais je n'en ai pas trouvé de meilleure...), je vais tenter de l'éclaircir en vous détaillant, à titre d’exemple, l'usage pour lequel j'ai développé cet utilitaire.
Étant musicien, je suis naturellement amené à travailler des partitions (musicales, hein, pas celles de mes disques durs). Pour faciliter l'organisation de mes sessions de travail, j'ai écrit un ensemble de fichiers XML contenant les tables suivantes :
- *Composers* : contient les fiches relatives aux compositeurs,
- *Instrumentations* : il se trouve que je joue, et du piano, et de l'orgue ; contient donc des fiches permettant d'affecter une instrumentation à une œuvre musicale donnée,
- *Collections* : certaines œuvres sont regroupées sous forme de recueils ; les fiches de cette table font référence à une fiche *instrumentation* et généralement à une fiche *composer*,
- *Pieces* : les œuvres proprement dites ; les fiches font référence, soit à une fiche *collection*, soit à une fiche *composer* et une fiche *instrumentation*,
- *Movements* : certaines pièces sont décomposées en mouvements ; les fiches font référence à une fiche *piece*,
- *Voices* : pour le œuvres pour piano à 4 mains (pour distinguer la voix *primo* et la voix *secundo*) ; les fiches font référence, soit à une fiche *piece*, soit à une fiche *movement*,
- *Elements* : contient les fiches sur les partition proprement dites ; les fiches font référence, soit à une fiche *piece*, soit à une fiche *movement*, soit à une fiche *voice*,
- *Segments* : chaque fiche fait référence à un fiche *element*, en lui adjoignant une mesure de début, ainsi qu'une mesure de fin.
La notion de *faire référence à une fiche* est apparentée à la notion de relationnel d'une base de données relationnelle.
Les segments sont en fait répartis dans trois tables différentes. Une table contient les segments des partitions que je suis en train de déchiffrer, une autre ceux sur lesquels, après avoir été déchiffrés, je travaille la musicalité, et une troisième les segments des partitions travaillées que je rejoue régulièrement pour éviter de les oublier. J'ai installé `dpkq` sur une tablette, et, lors d'une session de travail, je le lance sur l'un des groupes de segments, et `dpkq` me génère alors un fichier XML qui est affiché dans un navigateur Web sous forme de page HTML. Celle-ci contient toutes les informations sur un segment tiré au hasard parmi tous les segments de la table concernée, notamment les mesures du segment, ainsi que les images des pages de la partition contenant ces mesures.
Bien sûr, `dpkq` peut être utilisé dans un tout autre contexte et avec des données de toute autre nature...
Un jeu complet et fonctionnel de fichiers de test, ainsi que des détails sur le fonctionnement de `dpkq`, sont présents sur la page dédiée : [http://q37.info/computing/epeios/tools/dpkq/](http://q37.info/computing/epeios/tools/dpkq/) (en).
Voici le contenu de quelques-uns de ces fichiers (les directives préfixées par `dpk:` sont les directives traitées par `dpkq`, les directives préfixées par `xpp:` sont des directives destinées au [préprocesseur XML](http://q37.info/computing/epeios/tools/xppq/) (en) :
La table *Composers* (`composers_.xml`) :
```xml
<?xml version="1.0" encoding="utf-8"?>
<xpp:bloc xmlns:dpk="http://q37.info/ns/dpk" xmlns:xpp="http://q37.info/ns/xpp">
	<dpk:table label="Composers">
		<dpk:content DefaultRecordLabelTag="Surname">
			<composer dpk:label="Bach JC">
				<surname>Bach</surname>
				<firstnames>Johann Christian</firstnames>
			</composer>
			<composer dpk:label="Bach JS">
				<surname>Bach</surname>
				<firstnames>Johann Sebastian</firstnames>
			</composer>
			<composer>
				<surname>Beethoven</surname>
				<firstnames>Ludwig Van</firstnames>
			</composer>
			<composer>
				<surname>Brahms</surname>
				<firstnames>Johannes</firstnames>
			</composer>
			<composer>
				<surname>Chopin</surname>
				<firstnames>Frédéric</firstnames>
			</composer>
			<composer>
				<surname>Debussy</surname>
				<firstnames>Claude</firstnames>
			</composer>
			<composer>
				<surname>Fauré</surname>
				<firstnames>Gabriel</firstnames>
			</composer>
			<composer>
				<surname>Gershwin</surname>
				<firstnames>George</firstnames>
			</composer>
			<composer>
				<surname>Granados</surname>
				<firstnames>Enrique</firstnames>
			</composer>
			<composer>
				<surname>Grieg</surname>
				<firstnames>Edvard</firstnames>
			</composer>
			<composer>
				<surname>Liszt</surname>
				<firstnames>Franz</firstnames>
			</composer>
			<composer dpk:label="Mendelssohn">
				<surname>Mendelssohn Bartholdy</surname>
				<firstnames>Felix</firstnames>
			</composer>
			<composer>
				<surname>Mozart</surname>
				<firstnames>Wolfgang Amadeus</firstnames>
			</composer>
			<composer>
				<surname>Perterson</surname>
				<firstnames>Oscar</firstnames>
			</composer>
			<composer>
				<surname>Prokofiev</surname>
				<firstnames>Sergueï</firstnames>
			</composer>
			<composer>
				<surname>Rachmaninov</surname>
				<firstnames>Sergueï</firstnames>
			</composer>
			<composer>
				<surname>Ravel</surname>
				<firstnames>Maurice</firstnames>
			</composer>
			<composer>
				<surname>Schubert</surname>
				<firstnames>Franz</firstnames>
			</composer>
			<composer>
				<surname>Schumann</surname>
				<firstnames>Robert</firstnames>
			</composer>
			<composer>
				<surname>Simon</surname>
				<firstnames>Claude</firstnames>
			</composer>
			<composer>
				<surname>Tchaïkovski</surname>
				<firstnames>Piotr Ilitch</firstnames>
			</composer>
			<composer>
				<surname>Widor</surname>
				<firstnames>Charles-Marie</firstnames>
			</composer>
		</dpk:content>
	</dpk:table>
</xpp:bloc>
```
et le fichier encapsulant cette table (`Composers.xml` ; il n'est pas donné pour les autres tables, car présentant peu de différences) : 
```xml
<?xml version="1.0" encoding="utf-8"?>
<dpk:data xmlns:dpk="http://q37.info/ns/dpk" xmlns:xpp="http://q37.info/ns/xpp">
	<xpp:expand href="/index.cgi/contrast/httpS://linuxfr.org/users/epeios/journaux/composers_.xml"/>
</dpk:data>
```
La table *Instrumentations* (`instrumentations_.xml`) :
```xml
<?xml version="1.0" encoding="utf-8"?>
<xpp:bloc xmlns:dpk="http://q37.info/ns/dpk/" xmlns:xpp="http://q37.info/ns/xpp">
	<dpk:table label="Instrumentations">
		<dpk:content>
			<instrumentation dpk:label="2 hands">
				<name>Piano two hands</name>
			</instrumentation>
			<instrumentation dpk:label="4 hands">
				<name>Piano four hands</name>
			</instrumentation>
			<instrumentation dpk:label="Classical">
				<name>Classical organ</name>
			</instrumentation>
			<instrumentation dpk:label="Hammond">
				<name>Hammond organ</name>
			</instrumentation>
		</dpk:content>
	</dpk:table>
</xpp:bloc>
```
Et enfin, la table *Collections* (`collections_.xml`), dont les fiches font référence à des fiches des deux tables précédentes :
```xml
<?xml version="1.0" encoding="utf-8"?>
<xpp:bloc xmlns:dpk="http://q37.info/ns/dpk" xmlns:xpp="http://q37.info/ns/xpp">
	<xpp:expand href="/index.cgi/contrast/httpS://linuxfr.org/users/epeios/journaux/composers_.xml"/>
	<xpp:expand href="/index.cgi/contrast/httpS://linuxfr.org/users/epeios/journaux/instrumentations_.xml"/>
	<dpk:table label="Collections">
		<dpk:aliases label="%RL%" TableLabel="Instrumentations"/>
		<dpk:aliases label="%RL%" TableLabel="Composers">
			<dpk:alias label="C" TableLabel="Composers"/>
		</dpk:aliases>
		<dpk:content DefaultRecordLabelTag="Title">
			<collection dpk:label="Corner">
				<dpk:insert RecordAlias="Debussy"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Children's Corner</title>
			</collection>
			<collection dpk:label="Romances">
				<dpk:insert TableAlias="C" RecordLabel="Fauré"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>3 Romances sans Paroles</title>
				<opus>17</opus>
			</collection>
			<collection dpk:label="Fantaisies">
				<dpk:insert RecordAlias="Brahms"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>7 Fantaisies</title>
				<opus>116</opus>
			</collection>
			<collection dpk:label="Saisons">
				<dpk:insert RecordAlias="Tchaïkovski"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Les Saisons</title>
				<opus>37a</opus>
			</collection>
			<collection dpk:label="Preludes 1">
				<dpk:insert RecordAlias="Debussy"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Préludes - Premier livre</title>
			</collection>
			<collection dpk:label="Lyriques 12">
				<dpk:insert RecordAlias="Grieg"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Pièces lyriques</title>
				<opus>12</opus>
			</collection>
			<collection dpk:label="Arabesques">
				<dpk:insert RecordAlias="Debussy"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>2 arabesques</title>
				<opus Catalogue="L">66</opus>
			</collection>
			<collection>
				<dpk:insert RecordAlias="Schumann"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Albumblätter</title>
				<opus>124</opus>
			</collection>
			<collection dpk:label="Preludes 28">
				<dpk:insert RecordAlias="Chopin"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>24 préludes</title>
				<opus>28</opus>
			</collection>
			<collection dpk:label="Espagnoles">
				<dpk:insert RecordAlias="Granados"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>12 danses espagnoles</title>
			</collection>
			<collection dpk:label="Sentimentales">
				<dpk:insert RecordAlias="Schubert"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Valses sentimentales</title>
				<opus>50</opus>
				<opus Catalogue="D">779</opus>
			</collection>
			<collection>
				<dpk:insert RecordAlias="Liszt"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Consolations</title>
				<opus Catalogue="S">172</opus>
			</collection>
			<collection dpk:label="Mazurkas 4">
				<dpk:insert RecordAlias="Chopin"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>4 Mazurkas</title>
				<opus>17</opus>
			</collection>
			<collection dpk:label="Liebesträume">
				<dpk:insert RecordAlias="Liszt"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Liebesträume</title>
				<opus Catalogue="S/G">541</opus>
			</collection>
			<collection dpk:label="Faschingsschwank">
				<dpk:insert RecordAlias="Schumann"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Faschingsschwank aus Wien</title>
				<opus>26</opus>
			</collection>
			<collection dpk:label="Piano bar">
				<dpk:insert RecordAlias="2 hands"/>
				<title>Best of piano bar</title>
			</collection>
			<collection dpk:label="Liebeslieder">
				<dpk:insert RecordAlias="Brahms"/>
				<dpk:insert RecordAlias="4 hands"/>
				<title>Liebeslieder Waltzes</title>
				<opus>52a</opus>
			</collection>
			<collection dpk:label="Sonates120">
				<dpk:insert RecordAlias="Brahms"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Sonates pour clarinette et piano</title>
				<opus>120</opus>
			</collection>
			<collection dpk:label="Jazz Hammond">
				<dpk:insert RecordAlias="Hammond"/>
				<title>Home Organist Library Volume 7 - Jazz Pieces</title>
			</collection>
			<collection dpk:label="Big Band Hammond">
				<dpk:insert RecordAlias="Hammond"/>
				<title>Big Band Specials for Organ</title>
			</collection>
			<collection dpk:label="Oye">
				<dpk:insert RecordAlias="Ravel"/>
				<dpk:insert RecordAlias="4 hands"/>
				<title>Ma mère l'Oye</title>
			</collection>
			<collection dpk:label="PJazzExercises">
				<dpk:insert RecordAlias="Perterson"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Jazz exercises</title>
			</collection>
			<collection dpk:label="Chopin69">
				<dpk:insert RecordAlias="Chopin"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>2 valses</title>
				<opus>69</opus>
			</collection>
			<collection dpk:label="Brahms118">
				<dpk:insert RecordAlias="Brahms"/>
				<dpk:insert RecordAlias="2 hands"/>
				<title>Six pieces for Piano</title>
				<opus>118</opus>
			</collection>
		</dpk:content>
	</dpk:table>
</xpp:bloc>
```
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="httpS://linuxfr.org/users/epeios/journaux/dpkq-un-piocheur-de-donnees.md">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="httpS://linuxfr.org/users/epeios/journaux/dpkq-un-piocheur-de-donnees.md" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>