Książka kucharska DSPL

Ten dokument zawiera książkę kucharską z przydatnymi pojęciami związanymi z DSPL i koncepcją kanoniczną „przepisy”. Znajdziesz tam szczegółowe wskazówki dotyczące zadań, które wykraczają poza podstawowe funkcje językowe opisane w Samouczek i Przewodnik dla programistów. Treść poniżej zakłada znajomość poprzednich dokumentów, należy więc koniecznie zapoznać się z zanim zaczniesz gotowanie.

Każdy przepis zaczyna się od celu, po którym następuje konkretna lista kroków obserwuj. Wiele z nich zawiera też fragmenty kodu DSPL lub linki do przykładów zewnętrznych. Jeśli chcesz podzielić się opinią na temat przepisu lub zaproponować innym wiadomość na forum DSPL.

Podstawowe przepisy

Określanie wyświetlanych nazw

Cel

Powiąż „wyświetlaną nazwę” z każdym wystąpieniem elementu (wymiar) koncepcją działania. Nazwy te pojawią się w interfejsie Eksploratora danych publicznych zamiast identyfikatorów instancji pojęć, które są zwykle krótsze i trudniejsze dla użytkowników zrozumieć.

Kroki

  1. Dodaj do koncepcji rozszerzenia entity:entity.
  2. Dodaj kolumnę name do definicji powiązanego pojęć tabeli.
  3. Wypełnij tę ostatnią właściwość nazwą każdego wystąpienia.

Uwagi

  • Nie trzeba bezpośrednio definiować właściwości name w: metadane pomysłu; ta definicja jest automatycznie uwzględniana podczas przedłuż okres entity:entity.
  • Możesz też dodać description i info_url z opisami na poziomie instancji i adresami URL.

Tworzenie hierarchii pojęć

Cel

Utwórz hierarchię koncepcji (wymiarów). Będą się one wyświetlać w Interfejs Eksploratora danych w postaci drzewa umożliwiający użytkownikom zrozumienie grupowania i poruszać się między nimi.

Kroki

  1. Zdefiniuj „element nadrzędny” koncepcja (np. region).
  2. Zdefiniuj „element podrzędny” koncepcja (np. subregion).
  3. Dodaj w elemencie podrzędnym właściwość, która odwołuje się do elementu nadrzędnego i zawiera Atrybut isParent: 
    <property concept="..." isParent="true"/>
    , gdzie kropki są zastępowane identyfikatorem elementu nadrzędnego.
  4. W tabeli definicji dotyczącej elementu podrzędnego dodaj kolumnę, która odwołuje się do elementu nadrzędnego.
  5. W przypadku każdej instancji podrzędnej wypełnij tę drugą prawidłową instancją pojęcie nadrzędnego.

Uwagi

  • Zobacz zależność country / state w zbiór danych samouczka dla przykład.
  • Każdy identyfikator elementu nadrzędnego, do którego odwołuje się identyfikator podrzędny, musi być w tabeli definicji. W przeciwnym razie importer zwróci błąd.
  • Element nadrzędny i element podrzędny mogą być tym samym pojęciem (tzn. odnosić się do siebie hierarchii). Zapoznaj się z koncepcją business w Zbiór danych o sprzedaży detalicznej w Stanach Zjednoczonych .

Kategoryzacja instancji pojęć

Cel

Utwórz kategorie dla instancji pojęć, które będą się wyświetlać jako opcje w selektorach kolorów Public Data Explorer.

Kroki

  1. Zdefiniuj „kategorię” koncepcja (np. income_level).
  2. Zdefiniuj „element podrzędny” koncepcja (np. country).
  3. Dodaj w elemencie podrzędnym właściwość, która odwołuje się do koncepcji kategorii, oraz zawiera Element name: 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    , gdzie pierwszy zestaw kropek zostaje zastąpiony identyfikatorem kategorii, a sekwencją wartości drugi zestaw zostaje zastąpiony odpowiednią wyświetlaną nazwą usługi. (np. „Poziom dochodu”).
  4. W tabeli definicji dotyczącej elementu podrzędnego dodaj kolumnę, która odwołuje się do koncepcja kategorii.
  5. W przypadku każdej instancji podrzędnej wypełnij tę drugą prawidłową instancją koncepcją kategorii.

Uwagi

  • Pojęcie może mieć wiele właściwości, które służą jako kategorie. tego procesu użytkownicy zobaczą je wszystkie jako opcje w selektorach kolorów.
  • Jedna z kategorii może być również nadrzędnym na potrzeby hierarchiczną porządkowanie instancji w interfejsie. Zobacz poprzednie .

Określanie kolejności sortowania dla instancji pojęć

Cel

Określ kolejność sortowania instancji koncepcji. To zamówienie jest używane, gdy listę instancji w panelu nawigacyjnym po lewej stronie Public Data Explorer; stronach wizualizacji.

Kroki

  1. Spraw, aby Twój pomysł stanowił rozszerzenie elementu entity:entity lub jednego z dzieci (np. geo:location).
  2. Dodaj atrybut entity_order do metadanych projektu.
  3. Ustaw wartość poprzedniej wartości na jedną z tych wartości: ALPHA lub TABLE pierwszy powoduje wyświetlenie instancji kolejność wyświetlanych nazw, podczas gdy ta druga zachowa wystąpienia w takiej samej kolejności, w jakiej występują w tabeli definicji pojęć.

Uwagi

  • Bieżącą domyślną opcją jest ALPHA, więc jeśli chcesz jej użyć zamówienia, powyższe czynności są opcjonalne.
  • Zobacz entity:entity w dokumentacji.

Przepisy na czas

Dane kwartalne

Cel

Wizualizacja danych określonych w odstępach kwartalnych.

Kroki

  1. Przekonwertuj wszystkie kwartały w danych wycinków na miesiące (np. w pierwszym miesiącu kwartału).
  2. Traktuj ten wymiar jako time:month w swoim wycinku Plik XML:

Dane tygodniowe

Cel

Wizualizacja danych określonych w odstępach tygodniowych.

Kroki

  1. Przekonwertuj wszystkie tygodnie w danych wycinków na dni (np. pierwszy dzień tygodnia).
  2. Traktuj ten wymiar jako time:day w pliku XML wycinka.

Przepisy geograficzne

Używasz country lub state koncepcje kanoniczne

Cel

Użyj kanonicznych koncepcji country lub state, importowanie wszystkich wartości szerokości i długości geograficznej itd., dzięki czemu nie trzeba zdefiniowane w zbiorze danych.

Kroki

  1. Upewnij się, że wszystkie odniesienia do krajów i/lub stanów USA w pliki CSV z danymi wycinków są prawidłowymi identyfikatorami z kanonicznego kraju oraz stan tabel definicji.
  2. Dodaj geo:country i/lub geo_us:state jako wymiarów w odpowiednich wycinkach.
  3. Upewnij się, że nazwy kolumn w tych kolumnach są takie same. poprzednich pojęć (bez nazwy zaimportowanego zbioru danych, np. country) lub, jeśli nie, uwzględnij mapDimension instrukcji w definicji wycinka. Przykład: 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

Wykorzystując tylko podzbiór krajów kanonicznych lub stany

Cel

Użyj podzbioru kanonicznego związku geograficznego, tak aby tylko ten podzbiór całą listę, np. wszystkich krajów na świecie) pojawia się w kolumnie Public Interfejs Eksploratora danych.

Kroki

  1. Zdefiniuj lokalną koncepcję, która rozszerza koncepcję nadzbioru. Przykład: 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. W pliku CSV z definicją powiązanego pojęć podaj tylko identyfikatory nadzbioru, którego chcesz użyć. Przykład: 
    my_country_subset
FR  
MX
US

Uwagi

  • Każde wystąpienie koncepcji podzbioru musi być prawidłową instancją koncepcja nadzbioru; nie można „rozwinąć” tę koncepcję z nowymi rozwiązaniami instancji.

Definiowanie własnych koncepcji geograficznych

Cel

Możesz opracować własne koncepcje geograficzne, które są możliwe do przeanalizowania i mapowania. na przykład kanoniczne, zdefiniowane przez Google.

Kroki

  1. Utwórz pomysł, który obejmuje rozszerzenie geo:location.
  2. W tabeli definicji powiązanego pojęć dodaj kolumny. name, latitude i longitude.
  3. Wypełnij pozostałe właściwości dla każdego wystąpienia Twojej koncepcji; wartości szerokości i długości geograficznej są liczbami zmiennoprzecinkowymi zgodnie z konwencją, że N i E są dodatnie, a W i S są ujemne.

Uwagi

  • Nie trzeba jednoznacznie podawać właściwości name, Usługi latitude i longitude w definicji pojęć, ponieważ są one automatycznie uwzględniane przy rozszerzaniu geo:location
  • Zobacz definicję właściwości state w zbiorze danych samouczka dla przykład.

Przepisy na metryki i miary

Używanie wartości procentowych

Cel

Zdefiniuj pojęcie (dane), które jest wartością procentową innej wartości.

Kroki

  1. Spraw, aby Twój pomysł stanowił rozszerzenie quantity:ratio.
  2. Ustaw atrybut is_percentage na true. 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. Opcjonalnie ustaw atrybut percentage_of na podstawie tego, stanowi odsetek. Przykład: 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

Używasz currency jednostek

Cel

Zdefiniuj pojęcie (dane) zawierające jednostki waluty (np. w dolarach amerykańskich).

Kroki

  1. Zmień zakres danych na quantity:quantity lub jeden z jego dzieci, np. quantity:amount
  2. Dodaj atrybut unit, który się odwołuje unit:currency i ustaw tę wartość na identyfikator z powiązana definicja waluty tabeli. Przykład: 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

Tworzenie jednostki niestandardowej

Cel

Utwórz jednostkę niestandardową dla co najmniej jednego rodzaju danych.

Kroki

  1. Utwórz pomysł, który obejmuje rozszerzenie unit:unit.
  2. Dodaj kolumny unit_text i symbol do powiązanej tabeli definicji. Opcjonalnie, jeśli chcesz dostosować pozycji symbolu, możesz też dodać symbol_position .
  3. Wpisz wartości tych ostatnich właściwości dla każdego wystąpienia . Przykładowy plik CSV dla „obszaru” jednostki: 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. Aby użyć nowo utworzonej jednostki w koncepcji danych (dane), upewnij się, która rozciąga się na quantity:quantity lub jedno z jego elementów podrzędnych. Następnie: dodaj atrybut odwołujący się do koncepcji jednostki. Przykład: 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

Uwagi

  • Jeśli schemat jednostki ma tylko jedno wystąpienie, możesz pominąć identyfikator. z jej tabeli definicji oraz tagów value w argumencie które z niej korzystają.
  • Zobacz definicję waluty kanonicznej Idea.