Thuộc tính và phép chiếu mở rộng

Để xác định các đặc điểm tuỳ chỉnh cho một danh bạ dùng chung, hãy sử dụng các thuộc tính và phép chiếu mở rộng.

Thuộc tính mở rộng

Bạn có thể đặt thông tin bổ sung liên quan đến danh bạ dùng chung làm thuộc tính mở rộng, với các cặp tên-giá trị tuỳ ý, cho một mục danh bạ dùng chung. Bạn có trách nhiệm duy trì tính duy nhất của khoá. Giá trị của một thuộc tính mở rộng có thể được lưu trữ dưới dạng giá trị (chuỗi tuỳ ý) hoặc blob XML (văn bản thuần tuý). Mỗi danh bạ dùng chung có thể có tối đa 10 thuộc tính mở rộng được liên kết. Mỗi thuộc tính mở rộng phải có kích thước vừa phải; đừng sử dụng ảnh hoặc nhạc chuông.

Ví dụ

Ví dụ sau đây cho thấy một thuộc tính mở rộng có khoá và giá trị:

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

Ví dụ sau đây cho thấy một thuộc tính mở rộng có khoá và blob XML:

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

Giá trị phép chiếu

Để giới hạn khả năng hiển thị của thuộc tính mở rộng, hãy sử dụng phép chiếu. Bạn chỉ được phép đặt các thuộc tính mở rộng (gd:extendedElement phần tử) trong full hoặc property-KEY phép chiếu.

Bảng sau đây mô tả các giá trị phép chiếu được hỗ trợ:

Tên phép chiếu Mô tả
thin Không có phần tử gd:extendedProperty nào được trả về hoặc cập nhật.
property-KEY KEY cho biết khoá của một thuộc tính mở rộng (phần tử gd:extendedProperty) được trả về (đối với các yêu cầu GET) hoặc cần được cập nhật (đối với yêu cầu PUT hoặc POST). Nếu thuộc tính mở rộng không được sử dụng trong các thao tác cập nhật, thì thuộc tính đó sẽ bị xoá.
full Tất cả các phần tử gd:extendedProperty đều được trả về và tất cả các phần tử phải được đưa vào trong quá trình cập nhật.