المواقع الموسعة والتوقعات

لتحديد خصائص مخصّصة لجهة اتصال مشتركة، استخدِم الخصائص الممتدة والتوقعات.

الخصائص الممتدة

يمكنك ضبط معلومات إضافية ذات صلة بجهة اتصال مشتركة كخاصية ممتدة، مع أزواج عشوائية من الاسم والقيمة، لإدخال جهة اتصال مشتركة. تقع على عاتقك مسؤولية الحفاظ على تفرد المفتاح. يمكن تخزين قيمة خاصية ممتدة كقيمة (سلسلة عشوائية) أو ككائن ثنائي كبير بتنسيق XML (نص عادي). يمكن أن تتضمّن كل جهة اتصال مشتركة 10 خصائص ممتدة كحد أقصى. يجب أن تكون كل خاصية ممتدة صغيرة بشكل معقول، ولا تستخدِم صورة أو نغمة رنين.

مثال

يعرض المثال التالي خاصية ممتدة تتضمّن مفتاحًا وقيمة:

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

يعرض المثال التالي خاصية ممتدة تتضمّن مفتاحًا وكائنًا ثنائيًا كبيرًا بتنسيق XML:

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

قيم التوقعات

للحدّ من مدى ظهور الخصائص الممتدة، استخدِم التوقعات. لا يُسمح بضبط الخصائص الممتدة (gd:extendedElement عناصر) إلا ضمن توقّع full أو property-KEY.

يوضّح الجدول التالي قيم التوقعات المتوافقة:

اسم التوقّع الوصف
thin لا يتم عرض أو تعديل أي عناصر gd:extendedProperty.
property-KEY يشير KEY إلى مفتاح خاصية ممتدة (عنصر gd:extendedProperty) يتم عرضها (لطلبات GET) أو يجب تعديلها (لطلب PUT أو POST). إذا لم يتم استخدام الخاصية الممتدة أثناء عمليات التعديل، يتم حذفها.
full يتم عرض جميع عناصر gd:extendedProperty ويجب تضمين جميع العناصر أثناء التعديل.