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

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

السمات الموسَّعة

يمكنك ضبط معلومات إضافية ذات صلة بجهة الاتصال المشتركة كملف شخصي ممتد، مع أزواج اسم وقيمة عشوائية، لإدخال جهة اتصال مشترَكة. ويقع على عاتقك الحفاظ على تفرد المفتاح. يمكن تخزين قيمة سمة ممتدة كقيمة (سلسلة عشوائية) أو كتلة 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 ويجب تضمين جميع العناصر أثناء إجراء التحديث.