Livre de recettes DSPL

Ce document contient un livre de recettes sur la DSPL utile et les concepts canoniques "recettes". Ils fournissent des instructions détaillées pour les tâches qui vont au-delà des fonctionnalités de langage de base décrites dans les Tutoriel et guide du développeur. Le contenu ci-dessous suppose que vous avez connaissance des documents précédents. Veillez donc à lire attentivement avant de commencer votre "cuisine".

Chaque recette commence par un objectif suivi d’une liste spécifique d’étapes à suivre. Beaucoup incluent également des extraits DSPL ou des liens vers des exemples externes. Si vous vous avez des commentaires sur une recette ou vous souhaitez en suggérer d'autres, veuillez publier un message sur le forum DSPL.

Recettes de base

Spécifier des noms à afficher

Objectif

Associer un "nom à afficher" avec chaque instance d'une (dimension) concept. Ces noms apparaîtront dans l'interface utilisateur de Public Data Explorer au lieu de les ID d'instances de concept, qui sont généralement plus courts et plus difficiles à comprendre.

Étapes

  1. Faites en sorte que votre concept étende entity:entity.
  2. Ajouter une colonne name à la définition de concept associée tableau.
  3. Dans cette dernière propriété, indiquez le nom de chaque instance.

Remarques

  • Il n'est pas nécessaire de définir explicitement une propriété name dans les métadonnées de votre concept ; cette définition est automatiquement incluse lorsque vous étendez entity:entity.
  • Vous pouvez également ajouter description et info_url pour fournir respectivement des descriptions et des URL au niveau de l'instance.

Créer des hiérarchies de concepts

Objectif

Créer une hiérarchie des concepts (de dimension). Ceux-ci s'afficheront dans Interface utilisateur de Public Data Explorer sous forme d'arborescence, permettant aux utilisateurs de comprendre les regroupements et naviguer entre eux.

Étapes

  1. Définir un "parent" (par exemple, region).
  2. Définir un "enfant" (par exemple, subregion).
  3. Ajoutez dans l'élément enfant une propriété qui fait référence au parent et qui inclut l'élément Attribut isParent: 
    <property concept="..." isParent="true"/>
    où les points sont remplacés par l'ID parent.
  4. Dans la table de définition de l'élément enfant, ajoutez une colonne qui référence la parent.
  5. Pour chaque instance enfant, remplissez la deuxième avec une instance valide de le concept parent.

Remarques

  • Consultez la relation country / state dans ensemble de données du tutoriel pour en voici un exemple.
  • Chaque ID parent référencé à partir de l'enfant doit se trouver dans la méthode table de définition. Sinon, l'outil d'importation générera une erreur.
  • Le parent et l'enfant peuvent être le même concept (c'est-à-dire une référence à elle-même hiérarchie de ressources). Découvrez le concept business dans les Ensemble de données sur les ventes au détail aux États-Unis pour obtenir un exemple.

Catégoriser les instances de concept

Objectif

Créer des catégories pour les instances de concept qui s'afficheront en tant qu'options dans les sélecteurs de couleur de Public Data Explorer.

Étapes

  1. Définir une "catégorie" (par exemple, income_level).
  2. Définir un "enfant" (par exemple, country).
  3. Ajoutez dans l'élément enfant une propriété qui fait référence au concept de catégorie. inclut un Élément name: 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    où le premier ensemble de points est remplacé par l'ID de concept de la catégorie et le Le deuxième ensemble est remplacé par le nom à afficher souhaité pour votre propriété. (par exemple, "Niveau de revenu").
  4. Dans la table de définition de l'élément enfant, ajoutez une colonne qui référence la de catégorie supérieure.
  5. Pour chaque instance enfant, remplissez la deuxième avec une instance valide de le concept de catégorie.

Remarques

  • Un concept peut avoir plusieurs propriétés qui servent de catégories ; dans cette l'utilisateur les verra toutes en tant qu'options dans les sélecteurs de couleur.
  • L'une des catégories peut également être un parent pour les besoins d'organiser les instances de manière hiérarchique dans l'UI. Voir l'élément précédent pour en savoir plus.

Spécifier l'ordre de tri pour les instances de concept

Objectif

Spécifiez l'ordre de tri des instances d'un concept. Cet ordre est utilisé lorsque Liste des instances dans le menu de navigation de gauche de Public Data Explorer les pages de visualisation.

Étapes

  1. Faites en sorte que votre concept étende entity:entity ou l'un de ses enfants (par exemple, geo:location).
  2. Ajoutez un attribut entity_order aux métadonnées de votre concept.
  3. Définissez la valeur précédente sur ALPHA ou TABLE; le premier entraînera la liste des instances l'ordre de leurs noms à afficher, tandis que ce dernier conserve les instances dans le même ordre que celui présenté dans le tableau de définition des concepts.

Remarques

Recettes temporelles

Données trimestrielles

Objectif

Visualisez les données spécifiées à intervalles trimestriels.

Étapes

  1. Convertissez tous les trimestres de vos données par secteur en mois (par exemple, le le premier mois du trimestre).
  2. Traiter cette dimension comme une time:month dans votre secteur XML.

Données hebdomadaires

Objectif

Visualisez les données spécifiées à intervalles hebdomadaires.

Étapes

  1. Convertissez toutes les semaines de vos données sur les tranches en jours (par exemple, la première jour de la semaine).
  2. Traitez cette dimension comme un time:day dans le code XML de votre secteur.

Geo Recipes

Avec country ou state concepts canoniques

Objectif

Utilisez les concepts canoniques country ou state. en important toutes les valeurs lat/long, etc., afin qu'elles n'aient pas à définies dans l'ensemble de données.

Étapes

  1. Assurez-vous que tous les pays et/ou États américains mentionnés dans votre Les fichiers CSV de données de tranches sont des ID valides pour le pays canonique et state (État) de définitions de table.
  2. Ajoutez geo:country et/ou geo_us:state en tant que dans les secteurs correspondants.
  3. Assurez-vous que les noms des colonnes correspondent aux noms des concepts précédents (à l'exception du nom de l'ensemble de données importé, par exemple, country) ou, si ce n'est pas le cas, inclure mapDimension dans votre définition de segment. Exemple: 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

Utiliser uniquement un sous-ensemble des pays ou critères canoniques états

Objectif

Utilisez un sous-ensemble d'un concept géographique canonique afin que seul ce sous-ensemble (et non la liste complète, par exemple tous les pays du monde) apparaît dans la section Interface utilisateur de l'explorateur de données

Étapes

  1. Définissez un concept local qui étend le concept de sur-ensemble. Exemple : 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. Dans le fichier CSV de définition de concept associé, n'incluez que les ID de sur-ensemble que vous souhaitez utiliser. Exemple : 
    my_country_subset
FR  
MX
US

Remarques

  • Chaque instance de votre concept de sous-ensemble doit être une instance valide du sur-ensemble, vous ne pouvez pas "développer" le concept avec de nouvelles Compute Engine.

Définir vos propres concepts géographiques

Objectif

Créez vos propres concepts géographiques, que vous pouvez explorer et mapper. comme les liens canoniques définis par Google.

Étapes

  1. Créez un concept qui étend geo:location.
  2. Dans le tableau de définition de concept associé, incluez les colonnes name, latitude et longitude.
  3. Renseignez ces dernières propriétés pour chaque instance de votre concept. la les valeurs de latitude et de longitude sont des nombres à virgule flottante, selon la convention N et E sont positives, et W et S sont négatives.

Remarques

  • Il n'est pas nécessaire d'inclure explicitement name, latitude et longitude dans votre définition de concept, car ils sont automatiquement inclus lors de l'extension geo:location
  • Consultez la définition de state dans l'ensemble de données du tutoriel pour découvrir à titre d'exemple.

Recettes de métriques et d'unités

Utiliser des pourcentages

Objectif

Définissez un concept (métrique) correspondant à un pourcentage d'autre chose.

Étapes

  1. Faites en sorte que votre concept étende quantity:ratio.
  2. Définissez l'attribut is_percentage sur true. 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. Vous pouvez également définir l'attribut percentage_of en fonction des éléments ce concept est un pourcentage. Exemple: 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

Utilisation d'unités currency

Objectif

Définir un concept (métrique) qui comporte des unités monétaires (par exemple, dollar américain).

Étapes

  1. Faire en sorte que votre métrique étende quantity:quantity ou l'une de ses enfants, par exemple quantity:amount
  2. Ajoutez un attribut unit qui référence unit:currency et définissez sa valeur sur un ID provenant de définition de la devise associée tableau. Exemple: 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

Créer une unité personnalisée

Objectif

Créez une unité personnalisée pour une ou plusieurs de vos métriques.

Étapes

  1. Créez un concept qui étend unit:unit.
  2. Ajoutez les colonnes unit_text et symbol à la table de définition associée. Si vous le souhaitez, vous pouvez aussi position du symbole, vous pouvez également ajouter un symbol_position .
  3. Renseignez les valeurs des dernières propriétés pour chaque instance de votre bloc d'annonces. Exemple de fichier CSV pour "area" unités: 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. Pour utiliser l'unité que vous venez de créer dans un concept (métrique), assurez-vous que le paramètre la dernière étend quantity:quantity ou l'un de ses enfants. Ensuite, ajoutez un attribut qui fait référence au concept du bloc d'annonces. Exemple: 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

Remarques

  • Si votre concept d'unité ne comporte qu'une seule instance, vous pouvez omettre l'ID de sa table de définitions, ainsi que les tags value dans les métriques qui les utilisent.
  • Voir la définition de la devise canonique concept pour obtenir un exemple complet.