Sổ tay nấu ăn của DSPL

Tài liệu này chứa sổ tay nấu ăn về khái niệm chuẩn và DSPL hữu ích "công thức nấu ăn". Các báo cáo này cung cấp chỉ dẫn từng bước cho nhiều nhiệm vụ cao hơn và vượt ra ngoài các tính năng ngôn ngữ cơ bản được mô tả trong Hướng dẫn và Hướng dẫn cho nhà phát triển. Nội dung bên dưới giả định rằng bạn đã biết về các tài liệu trước đó, vì vậy, hãy nhớ đọc qua trước khi bắt đầu "nấu ăn".

Mỗi công thức bắt đầu với một mục tiêu, theo sau là một danh sách các bước cụ thể để theo dõi. Nhiều trang cũng bao gồm đoạn mã DSPL hoặc đường liên kết đến các ví dụ bên ngoài. Nếu bạn có bất kỳ phản hồi nào về một công thức hoặc muốn đề xuất công thức khác, vui lòng đăng một thông báo trong Diễn đàn DSPL.

Công thức cơ bản

Chỉ định tên hiển thị

Mục tiêu

Liên kết "tên hiển thị" với mỗi bản sao của một (phương diện) khái niệm. Những tên này sẽ xuất hiện trong giao diện người dùng Public Data Explorer thay vì mã thực thể của khái niệm, thường ngắn hơn và khó người dùng hơn hiểu.

Các bước

  1. Mở rộng khái niệm của bạn entity:entity.
  2. Thêm một cột name vào định nghĩa khái niệm có liên quan bảng.
  3. Điền tên của từng thực thể vào thuộc tính sau.

Ghi chú

  • Bạn không cần phải xác định rõ ràng thuộc tính name trong siêu dữ liệu khái niệm; định nghĩa này sẽ được tự động đưa vào khi bạn mở rộng entity:entity.
  • Bạn cũng có thể thêm description và info_url để cung cấp nội dung mô tả và URL ở cấp phiên bản tương ứng.

Tạo hệ phân cấp khái niệm

Mục tiêu

Tạo một hệ phân cấp các khái niệm (phương diện). Những thông tin này sẽ xuất hiện trong Giao diện người dùng của Trình khám phá dữ liệu công khai dưới dạng cây, giúp người dùng hiểu rõ về các nhóm và di chuyển giữa các trình duyệt.

Các bước

  1. Định nghĩa "mẹ" khái niệm (ví dụ: region).
  2. Định nghĩa "con" khái niệm (ví dụ: subregion).
  3. Thêm một thuộc tính trong phần tử con tham chiếu đến thuộc tính mẹ và bao gồm Thuộc tính isParent: 
    <property concept="..." isParent="true"/>
    trong đó các dấu chấm được thay thế bằng mã nhận dạng chính.
  4. Trong bảng định nghĩa cho phần tử con, hãy thêm một cột tham chiếu đến cha mẹ.
  5. Đối với mỗi thực thể con, hãy điền vào thực thể sau một thực thể hợp lệ là khái niệm gốc.

Ghi chú

  • Xem mối quan hệ country / state trong tập dữ liệu hướng dẫn để ví dụ về trường hợp này.
  • Mỗi mã nhận dạng mẹ được tham chiếu từ phần tử con đều phải nằm trong bảng định nghĩa. Nếu không, trình nhập sẽ tạo ra lỗi.
  • Phần tử mẹ và con có thể là cùng một khái niệm (tức là tự tham chiếu) phân cấp). Xem khái niệm về business trong Tập dữ liệu doanh số bán lẻ ở Hoa Kỳ để xem ví dụ về trường hợp này.

Phân loại các thực thể khái niệm

Mục tiêu

Tạo danh mục cho các thực thể khái niệm sẽ hiển thị dưới dạng các lựa chọn trong bộ chọn màu của Trình khám phá dữ liệu công khai.

Các bước

  1. Định nghĩa một "danh mục" khái niệm (ví dụ: income_level).
  2. Định nghĩa "con" khái niệm (ví dụ: country).
  3. Thêm một thuộc tính trong thành phần con tham chiếu đến khái niệm danh mục và bao gồm Phần tử name: 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    trong đó nhóm dấu chấm đầu tiên được thay thế bằng mã khái niệm danh mục và nhóm thứ hai được thay thế bằng tên hiển thị mong muốn cho tài sản của bạn (ví dụ: "Mức thu nhập").
  4. Trong bảng định nghĩa cho phần tử con, hãy thêm một cột tham chiếu đến khái niệm danh mục.
  5. Đối với mỗi thực thể con, hãy điền vào thực thể sau một thực thể hợp lệ là khái niệm danh mục.

Ghi chú

  • Một khái niệm có thể có nhiều thuộc tính được phân phát dưới dạng danh mục; trong nội dung này trường hợp, người dùng sẽ thấy tất cả nhận xét dưới dạng tuỳ chọn trong công cụ chọn màu.
  • Một trong các danh mục này cũng có thể là cấp độ gốc để sắp xếp các thực thể theo hệ phân cấp trong giao diện người dùng. Xem kết quả trước để biết thông tin chi tiết.

Chỉ định thứ tự sắp xếp cho các thực thể khái niệm

Mục tiêu

Chỉ định thứ tự sắp xếp cho các phiên bản của một khái niệm. Thứ tự này được sử dụng khi liệt kê các thực thể trong thành phần điều hướng bên trái của Public Data Explorer trực quan hoá dữ liệu.

Các bước

  1. Mở rộng khái niệm của bạn entity:entity hoặc một trong các khái niệm trẻ em (ví dụ: geo:location).
  2. Thêm thuộc tính entity_order vào siêu dữ liệu về khái niệm.
  3. Đặt giá trị trước thành một trong hai giá trị ALPHA hoặc TABLE; khiến các thực thể được liệt kê trong thứ tự tên hiển thị, trong khi tên hiển thị sẽ giữ lại các thực thể theo cùng thứ tự như trong bảng định nghĩa khái niệm.

Ghi chú

  • ALPHA là ứng dụng mặc định hiện tại, vì vậy nếu bạn muốn sử dụng giá trị này theo thứ tự, các bước trên là không bắt buộc.
  • Xem entity:entity để biết ví dụ.

Công thức tính thời gian

Dữ liệu hằng quý

Mục tiêu

Trình bày trực quan dữ liệu được chỉ định theo khoảng thời gian hằng quý.

Các bước

  1. Chuyển đổi tất cả các quý trong dữ liệu lát cắt của bạn thành các tháng (ví dụ: tháng đầu tiên của quý).
  2. Xem phương diện này là time:month trong phần của bạn XML.

Dữ liệu hằng tuần

Mục tiêu

Trình bày trực quan dữ liệu được chỉ định theo khoảng thời gian hằng tuần.

Các bước

  1. Chuyển đổi tất cả các tuần trong dữ liệu lát cắt của bạn thành ngày (ví dụ: đầu tiên ngày trong tuần).
  2. Hãy xem phương diện này là time:day trong XML lát cắt của bạn.

Công thức địa lý

Đang dùng country hoặc state các khái niệm chuẩn

Mục tiêu

Hãy dùng các khái niệm country hoặc state chuẩn, nhập tất cả các giá trị vĩ độ/kinh độ, v.v. để các giá trị này không cần phải được xác định trong tập dữ liệu.

Các bước

  1. Đảm bảo rằng tất cả quốc gia và/hoặc tiểu bang của Hoa Kỳ trong các tệp CSV dữ liệu của lát cắt là những mã nhận dạng hợp lệ từ quốc gia chính tắc và tiểu bang bảng định nghĩa.
  2. Thêm geo:country và/hoặc geo_us:state làm trong các phần tương ứng.
  3. Hãy đảm bảo tên cột của các cột này khớp với tên các khái niệm trước đây (không bao gồm tên tập dữ liệu được nhập, ví dụ: country) hoặc nếu không bao gồm mapDimension trong định nghĩa lát cắt của bạn. Ví dụ: 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

Chỉ sử dụng một số quốc gia chính tắc hoặc các tiểu bang

Mục tiêu

Sử dụng một tập hợp con của khái niệm địa lý chuẩn để chỉ tập hợp con này (chứ không phải toàn bộ danh sách, ví dụ: tất cả quốc gia trên thế giới) xuất hiện trước công chúng Giao diện người dùng của Trình khám phá dữ liệu.

Các bước

  1. Định nghĩa khái niệm cục bộ mở rộng khái niệm tập mẹ. Ví dụ: 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. Trong tệp CSV định nghĩa về khái niệm có liên quan, chỉ bao gồm mã của khái niệm tập mẹ mà bạn muốn sử dụng. Ví dụ: 
    my_country_subset
FR  
MX
US

Ghi chú

  • Mỗi thực thể của khái niệm tập hợp con phải là một thực thể hợp lệ của thuộc tính khái niệm tập mẹ; bạn không thể "mở rộng" khái niệm mới với thực thể.

Xác định khái niệm địa lý của riêng bạn

Mục tiêu

Tạo các khái niệm địa lý của riêng bạn mà người dùng có thể khám phá và lập bản đồ, giống như trang chính tắc do Google xác định.

Các bước

  1. Tạo khái niệm mở rộng geo:location.
  2. Trong bảng định nghĩa khái niệm có liên quan, hãy thêm các cột name, latitude và longitude.
  3. Điền các thuộc tính sau cho mỗi thực thể của khái niệm; thời gian các giá trị vĩ độ và kinh độ là số thực có quy ước N và E là số dương, W và S là số âm.

Ghi chú

  • Bạn không cần phải bao gồm name một cách rõ ràng, Các tài sản latitude và longitude trong định nghĩa khái niệm vì các khái niệm này sẽ tự động được đưa vào khi mở rộng geo:location.
  • Xem định nghĩa của state trong tập dữ liệu hướng dẫn để biết ví dụ:

Công thức về chỉ số và đơn vị

Sử dụng tỷ lệ phần trăm

Mục tiêu

Định nghĩa khái niệm (chỉ số) là tỷ lệ phần trăm của một chỉ số khác.

Các bước

  1. Mở rộng khái niệm của bạn quantity:ratio.
  2. Đặt thuộc tính is_percentage thành true. 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. Đặt thuộc tính percentage_of dựa trên nội dung (không bắt buộc) chỉ có một tỷ lệ phần trăm. Ví dụ: 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

Đang sử dụng currency đơn vị

Mục tiêu

Định nghĩa khái niệm (chỉ số) có đơn vị tiền tệ (ví dụ: đô la Mỹ).

Các bước

  1. Làm cho chỉ số của bạn mở rộng quantity:quantity hoặc một trong trẻ em, ví dụ: quantity:amount
  2. Thêm thuộc tính unit tham chiếu đến unit:currency rồi đặt giá trị của biến này thành một mã nhận dạng trong định nghĩa về đơn vị tiền tệ liên kết . Ví dụ: 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

Tạo đơn vị tuỳ chỉnh

Mục tiêu

Tạo đơn vị tuỳ chỉnh cho một hoặc nhiều chỉ số.

Các bước

  1. Tạo khái niệm mở rộng unit:unit.
  2. Thêm các cột unit_text và symbol vào bảng định nghĩa liên kết. Nếu muốn điều chỉnh vị trí biểu tượng, bạn cũng có thể thêm symbol_position .
  3. Điền vào các giá trị cho các thuộc tính sau cho mỗi thực thể của đơn vị. Tệp CSV mẫu cho "khu vực" đơn vị: 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. Để sử dụng đơn vị mới tạo trong khái niệm (chỉ số), hãy đảm bảo phần sau mở rộng quantity:quantity hoặc một trong các phần tử con. Sau đó: thêm thuộc tính tham chiếu đến khái niệm đơn vị của bạn. Ví dụ: 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

Ghi chú

  • Nếu khái niệm về đơn vị chỉ có một thực thể duy nhất, bạn có thể bỏ qua mã nhận dạng từ bảng định nghĩa cũng như các thẻ value trong các chỉ số sử dụng chúng.
  • Xem định nghĩa về đơn vị tiền tệ chính tắc để biết một ví dụ đầy đủ.