Libro di ricette di DSPL

Questo documento contiene un libro di ricette di DSPL e concetto canonico "ricette". Includono indicazioni stradali dettagliate per una vasta gamma di che vanno oltre le funzionalità linguistiche di base descritte nel Tutorial e Guida per gli sviluppatori. I contenuti di seguito presuppone la conoscenza dei documenti precedenti, quindi assicurati di leggerli tutti prima di iniziare la tua "cucina".

Ogni ricetta inizia con un obiettivo seguito da un elenco specifico di passaggi per seguire. Molti includono anche snippet DSPL o link a esempi esterni. Se hai feedback su una ricetta o vorresti suggerirne altre, pubblica un messaggio nel forum DSPL.

Ricette di base

Specifica dei nomi visualizzati

Obiettivo

Associare un "nome visualizzato" con ogni istanza di una (dimensione) concetto. Questi nomi verranno visualizzati nell'interfaccia utente di Public Data Explorer gli ID istanza del concetto, che sono in genere più corti e difficili capire.

Passaggi

  1. Fai in modo che il tuo concept venga esteso entity:entity.
  2. Aggiungi una colonna name alla definizione del concetto associata .
  3. Compila quest'ultima con il nome di ogni istanza.

Note

  • Non è necessario definire esplicitamente una proprietà name in i metadati concettuali; questa definizione viene inclusa automaticamente estendere entity:entity.
  • Puoi anche aggiungere description e info_url per fornire descrizioni e URL a livello di istanza, rispettivamente.

Creazione di gerarchie concettuali

Obiettivo

Crea una gerarchia dei concetti relativi alle dimensioni. Questi elementi appariranno nella UI di Public Data Explorer come struttura ad albero, che consente agli utenti di comprendere i raggruppamenti e passare da una all'altra.

Passaggi

  1. Definisci un "padre" concetto (ad es. region).
  2. Definisci un account secondario concetto (ad es. subregion).
  3. Aggiungi una proprietà nel file secondario che faccia riferimento all'elemento principale e includa la proprietà Attributo isParent: 
    <property concept="..." isParent="true"/>
     in cui i punti sono sostituiti dall'ID principale.
  4. Nella tabella di definizione del file secondario, aggiungi una colonna che faccia riferimento alla principale.
  5. Per ogni istanza secondaria, compila la seconda con un'istanza valida il concetto principale.

Note

  • Visualizza la relazione country / state nella set di dati tutorial per un esempio.
  • Ogni ID principale a cui fa riferimento l'elemento secondario deve essere nel codice una tabella di definizione. In caso contrario, l'importatore genererà un errore.
  • Il concetto di genitore e figlio può essere lo stesso (vale a dire un autoriferimento nella gerarchia). Visualizza il concetto di business nella Set di dati US Retail Sales per vedere un esempio.

Categorizzazione delle istanze concettuali

Obiettivo

Crea categorie per le istanze concettuali che verranno visualizzate come opzioni nei selettori di colore di Public Data Explorer.

Passaggi

  1. Definisci una "categoria" concetto (ad es. income_level).
  2. Definisci un account secondario concetto (ad es. country).
  3. Aggiungi una proprietà nell'asset secondario che faccia riferimento al concetto di categoria e include un oggetto name elemento: 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    , in cui il primo insieme di punti viene sostituito dall'ID concetto di categoria e dalla il secondo insieme viene sostituito dal nome visualizzato desiderato per la proprietà (ad es. "Livello di reddito").
  4. Nella tabella di definizione del file secondario, aggiungi una colonna che faccia riferimento alla concetto di categoria.
  5. Per ogni istanza secondaria, compila la seconda con un'istanza valida il concetto di categoria.

Note

  • Un concetto può avere più proprietà che fungono da categorie. in questo in questo caso, l'utente li vedrà tutti come opzioni nei selettori dei colori.
  • Una delle categorie può anche essere padre ai fini della organizzare le istanze in modo gerarchico nella UI. Vedi i precedenti per i dettagli.

Specifica l'ordinamento per le istanze concettuali

Obiettivo

Specifica l'ordinamento per le istanze di un concetto. Questo ordine viene utilizzato quando che elenca le istanze nel menu di navigazione sinistro di Public Data Explorer pagine di visualizzazione.

Passaggi

  1. Fai in modo che il tuo concept si espanda di entity:entity o di uno dei suoi di minori (ad es. geo:location).
  2. Aggiungi un attributo entity_order ai metadati del concetto.
  3. Imposta il valore del precedente su uno tra ALPHA o TABLE; il primo farà sì che le istanze vengano elencate dell'ordine dei nomi visualizzati, mentre quest'ultimo manterrà le istanze nello stesso ordine in cui appaiono nella tabella di definizione dei concetti.

Note

  • ALPHA è l'impostazione predefinita corrente, quindi se vuoi utilizzarla l'ordinamento, i passaggi precedenti sono facoltativi.
  • Consulta la entity:entity documentazione per un esempio.

Ricette del tempo

Dati trimestrali

Obiettivo

Visualizza i dati specificati a intervalli trimestrali.

Passaggi

  1. Converti tutti i trimestri dei dati della sezione in mesi (ad es. primo mese del trimestre).
  2. Considera questa dimensione come un time:month nella tua sezione XML.

Dati settimanali

Obiettivo

Visualizza i dati specificati a intervalli settimanali.

Passaggi

  1. Converti tutte le settimane dei dati della sezione in giorni (ad es. il primo giorno della settimana).
  2. Considera questa dimensione come un time:day nel tuo XML sezione.

Ricette geografiche

In uso: country o state concetti canonici

Obiettivo

Utilizza i concetti canonici country o state. importare tutti i valori di latitudine/longitudine e così via, in modo che non debbano definite all'interno del set di dati.

Passaggi

  1. Assicurati che tutti i riferimenti a paesi e/o stati USA nel tuo I file CSV dei dati delle sezioni sono ID validi del paese canonico e stato tabelle di definizione.
  2. Aggiungi geo:country e/o geo_us:state come dimensioni nelle sezioni corrispondenti.
  3. Assicurati che i nomi delle colonne corrispondano ai nomi delle colonne dei concetti precedenti (escluso il nome del set di dati importato, ad es. country) o, in caso contrario, includi mapDimension istruzioni nella definizione della sezione. Esempio: 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

Usare solo un sottoinsieme dei paesi canonici o stati

Obiettivo

Utilizza un sottoinsieme di un concetto geografico canonico in modo che solo questo sottoinsieme (e non l'elenco completo, ad esempio in tutti i Paesi del mondo) appare nella sezione Pubblico UI di Esplora dati.

Passaggi

  1. Definire un concetto locale che estenda il concetto del superinsieme. Esempio: 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. Nel file CSV della definizione dei concetti associato, includi solo gli ID dei concetto sovrainsieme che vuoi utilizzare. Esempio: 
    my_country_subset
FR  
MX
US

Note

  • Ogni istanza del concetto di sottoinsieme deve essere un'istanza valida del concetto di sovrainsieme; non puoi "espandere" il concetto con nuove di Compute Engine.

Definizione dei concetti geografici

Obiettivo

Crea concetti geografici personalizzati che siano esplorabili e mappabili, come quelle canoniche definite da Google.

Passaggi

  1. Crea un concetto che estenda geo:location.
  2. Nella tabella di definizione dei concetti associata, includi le colonne name, latitude e longitude.
  3. Compila le ultime proprietà per ogni istanza del concetto. il i valori di latitudine e longitudine sono in virgola mobile con la convenzione che segue N ed E sono positivi, mentre W e S sono negativi.

Note

  • Non è necessario includere esplicitamente name, latitude e longitude proprietà in definizione dei concetti poiché vengono inclusi automaticamente nell'estensione geo:location.
  • Controlla la definizione di state nel set di dati del tutorial per un esempio.

Ricette metriche e unitarie

Utilizzo delle percentuali

Obiettivo

Definisci un concetto (metrica) che sia una percentuale di altro.

Passaggi

  1. Fai in modo che il tuo concept venga esteso quantity:ratio.
  2. Imposta l'attributo is_percentage su true. 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. Se vuoi, imposta l'attributo percentage_of in base a cosa di cui questo concetto è una percentuale. Esempio: 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

currency unità in uso

Obiettivo

Definisci un concetto di (metrica) con unità di valuta (ad es. dollaro statunitense).

Passaggi

  1. Fai in modo che la metrica si espanda di quantity:quantity o di uno dei suoi valori minori, ad es. quantity:amount.
  2. Aggiungi un attributo unit che fa riferimento unit:currency e imposta il valore su un ID dal definizione di valuta associata . Esempio: 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

Creazione di un'unità personalizzata

Obiettivo

Crea un'unità personalizzata per una o più metriche.

Passaggi

  1. Crea un concetto che estenda unit:unit.
  2. Aggiungi le colonne unit_text e symbol al tabella di definizione associata. Facoltativamente, se vuoi regolare posizione del simbolo, puoi anche aggiungere un symbol_position colonna.
  3. Compila i valori delle ultime proprietà per ogni istanza del unità. CSV di esempio per "area" unità: 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. Per utilizzare l'unità appena creata in un concetto di (metrica), assicurati che la dimensione La seconda estende quantity:quantity o uno dei suoi figli. Poi, aggiungi un attributo che faccia riferimento al concetto di unità. Esempio: 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

Note

  • Se il concetto di unità ha una sola istanza, puoi omettere l'ID della tabella di definizione e i tag value in le metriche che la utilizzano.
  • Consulta la definizione della valuta canonica concept per un esempio completo.