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 thông tin liên hệ chung, hãy sử dụng thuộc tính mở rộng và phép chiếu.

Thuộc tính mở rộng

Bạn có thể đặt thông tin liên quan đến liên hệ dùng chung bổ sung thành tên mở rộng với các cặp tên-giá trị tuỳ ý cho mục nhập địa chỉ liên hệ dùng chung. Bây giờ trách nhiệm của bạn trong việc duy trì tính duy nhất của khoá. Giá trị của 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 (chuỗi đơn thuần) văn bản). Mỗi người liên hệ dùng chung có thể được liên kết với tối đa 10 thuộc tính mở rộng. Mỗi thuộc tính mở rộng phải có kích thước nhỏ hợp lý; khô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ó một khoá và một 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ị dự đoán

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

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 (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 PUT hoặc POST). Nếu phần mở rộng không được sử dụng trong quá trình cập nhật, thuộc tính này đã bị xoá.
full Tất cả phần tử gd:extendedProperty đều được trả về và tất cả các phần tử đều phải được đưa vào trong quá trình cập nhật.