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

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

Mỗi công thức đều bắt đầu bằng một mục tiêu, sau đó là một danh sách các bước cụ thể. Nhiều trang cũng bao gồm các đ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ó ý kiến phản hồi về một công thức hoặc muốn đề xuất cho người khác, vui lòng đăng thông báo trong Diễn đàn DSPL.

Công thức nấu ăn cơ bản

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

Mục tiêu

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

Các bước thực hiện

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

Ghi chú

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

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

Mục tiêu

Tạo hệ phân cấp các khái niệm (phương diện). Những nội dung này sẽ hiển thị 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, cho phép người dùng hiểu các nhóm và di chuyển giữa các nhóm này.

Các bước thực hiện

1. Xác định khái niệm "mẹ" (ví dụ: region).
2. Xác định khái niệm "con" (ví dụ: subregion).
3. Thêm một thuộc tính trong thành phần con tham chiếu đến thành phần 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ã mẹ.
4. Trong bảng định nghĩa cho thành phần con, hãy thêm một cột tham chiếu đến thành phần mẹ.
5. Đối với mỗi bản sao con, hãy điền vào một bản sao hợp lệ của khái niệm mẹ.

Ghi chú

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

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ẽ xuất hiện dưới dạng tuỳ chọn trong bộ chọn màu Public Data Explorer.

Các bước thực hiện

1. Xác định khái niệm "danh mục" (ví dụ: income_level).
2. Xác định khái niệm "con" (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à thêm một phần tử name:

   <property concept="..."/>
     <info>
       <name><value>"..."</value></name>
     </info>
   </property>
   

   tập hợp các dấu chấm đầu tiên được thay thế bằng mã khái niệm danh mục và tập hợp thứ hai được thay thế bằng tên hiển thị mong muốn cho thuộc tính 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 bản sao con, hãy điền vào một bản sao hợp lệ của khái niệm danh mục.

Ghi chú

• Một khái niệm có thể có nhiều thuộc tính đóng vai trò là danh mục; trong trường hợp này, người dùng sẽ thấy tất cả thuộc tính đó dưới dạng tùy chọn trong bộ chọn màu.
• Một trong các danh mục này cũng có thể là đối tượng mẹ cho mục đích sắp xếp các thực thể theo thứ bậc trong giao diện người dùng. Hãy xem công thức trước đây để 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 thực thể của một khái niệm. Thứ tự này được dùng khi liệt kê các thực thể trong bảng điều hướng bên trái của các trang hình ảnh công khai của Trình khám phá dữ liệu công khai.

Các bước thực hiện

1. Đặt khái niệm của bạn trong entity:entity hoặc một trong các phần tử con (ví dụ: geo:location).
2. Thêm thuộc tính entity_order vào siêu dữ liệu khái niệm.
3. Đặt giá trị của quá trình trước đó thành một trong ALPHA hoặc TABLE; chế độ trước đó sẽ khiến các thực thể được liệt kê theo thứ tự tên hiển thị, trong khi chế độ sau sẽ giữ nguyên các thực thể theo thứ tự xuất hiện trong bảng định nghĩa khái niệm.

Ghi chú

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

Công thức thời gian

Dữ liệu hằng quý

Mục tiêu

Hình ảnh hoá dữ liệu được chỉ định theo khoảng thời gian hằng quý.

Các bước thực hiện

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

Dữ liệu hằng tuần

Mục tiêu

Hình ảnh hoá dữ liệu được chỉ định trong khoảng thời gian hằng tuần.

Các bước thực hiện

1. Chuyển đổi tất cả các tuần trong dữ liệu Slice của bạn thành các ngày (ví dụ: ngày đầu tiên của tuần).
2. Coi 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ý

Sử dụng các khái niệm chính tắc country hoặc state

Mục tiêu

Sử dụng các khái niệm chính tắc country hoặc state, nhập tất cả các giá trị vĩ độ/kinh độ, v.v. để không cần xác định trong phạm vi tập dữ liệu.

Các bước thực hiện

1. Hãy đảm bảo rằng tất cả thông tin tham chiếu đến quốc gia và/hoặc tiểu bang của Hoa Kỳ trong tệp CSV chứa dữ liệu cắt là các mã hợp lệ trong bảng định nghĩa quốc gia và trạng thái chính tắc.
2. Thêm geo:country và/hoặc geo_us:state làm phương diện trong các phần tương ứng.
3. Đảm bảo rằng tên cột của các tên này khớp với tên của các khái niệm trước (không bao gồm tên tập dữ liệu đã nhập, ví dụ: country) hoặc nếu không thì bao gồm câu lệnh 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 hoặc tiểu bang chính tắc

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ả các quốc gia trên thế giới) xuất hiện trong Giao diện người dùng dữ liệu công khai.

Các bước thực hiện

1. Xác định một khái niệm cục bộ mở rộng khái niệm siêu tập hợp. Ví dụ:

   <concept id="my_country_subset" extends="geo:country">
   ...
   </concept>
   

2. Trong tệp CSV có định nghĩa về khái niệm liên quan, chỉ đưa vào mã nhận dạng 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 con đều phải là một thực thể hợp lệ của khái niệm tập mẹ; bạn không thể "mở rộng" khái niệm đó bằng các thực thể mới.

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, có thể khám phá và lập bản đồ, giống như khái niệm chính tắc do Google xác định.

Các bước thực hiện

1. Tạo một khái niệm mở rộng geo:location.
2. Trong bảng định nghĩa củ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; giá trị vĩ độ và kinh độ là số thực có quy ước là N và E dương, còn W và S là số âm.

Ghi chú

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

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

Sử dụng 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 khái niệm khác.

Các bước thực hiện

1. Mở rộng quantity:ratio khái niệm của bạn.
2. Đặt thuộc tính is_percentage thành true.

   <attribute id="is_percentage">
     <value>true</value>
   </attribute>
   

3. Nếu muốn, hãy đặt thuộc tính percentage_of dựa trên khái niệm tỷ lệ phần trăm này. Ví dụ:

   <attribute id="percentage_of">
     <value>labor force</value>
   </attribute>
   

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

Mục tiêu

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

Các bước thực hiện

1. Đặt chỉ số của bạn mở rộng quantity:quantity hoặc một trong các chỉ số con, ví dụ: quantity:amount.
2. Thêm một thuộc tính unit tham chiếu đến unit:currency và đặt giá trị của thuộc tính này thành một mã nhận dạng từ bảng định nghĩa về đơn vị tiền tệ được liên kết. Ví dụ:

   <concept id="...">
     <attribute concept="unit:currency">
       <value>EUR</value>
     </attribute>
   </concept>
   

Tạo đơn vị tùy chỉnh

Mục tiêu

Tạo một đơn vị tùy chỉnh cho một hoặc nhiều chỉ số của bạn.

Các bước thực hiện

1. Tạo một 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 được 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 cột symbol_position.
3. Điền các giá trị cho các thuộc tính sau cho từng bản sao của đơn vị. Ví dụ về tệp CSV cho các đơn vị "khu vực":

   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 đơn vị quảng cáo sau mở rộng quantity:quantity hoặc một trong các đơn vị con. Sau đó, hãy thêm một 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 đơn vị của bạn chỉ có một bản sao, bạn có thể bỏ qua cột mã nhận dạng khỏi bảng định nghĩa cũng như các thẻ value trong các chỉ số sử dụng bản sao đó.
• Hãy xem định nghĩa về khái niệm đơn vị tiền tệ chính tắc để biết ví dụ hoàn chỉnh.