خواص و پیش بینی های گسترده

برای تعریف ویژگی‌های سفارشی برای یک مخاطب مشترک، از ویژگی‌ها و پیش‌بینی‌های توسعه‌یافته استفاده کنید.

ویژگی‌های توسعه‌یافته

شما می‌توانید اطلاعات اضافی مربوط به مخاطب مشترک را به عنوان یک ویژگی توسعه‌یافته، با جفت‌های نام-مقدار دلخواه، برای یک ورودی مخاطب مشترک تنظیم کنید. مسئولیت حفظ منحصر به فرد بودن کلید بر عهده شماست. مقدار یک ویژگی توسعه‌یافته می‌تواند به عنوان یک مقدار (رشته دلخواه) یا یک XML blob (متن ساده) ذخیره شود. هر مخاطب مشترک می‌تواند حداکثر 10 ویژگی توسعه‌یافته مرتبط داشته باشد. هر ویژگی توسعه‌یافته باید به طور معقولی کوچک باشد؛ از عکس یا زنگ تلفن استفاده نکنید.

مثال

مثال زیر یک ویژگی توسعه‌یافته با یک کلید و یک مقدار را نشان می‌دهد:

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

مثال زیر یک ویژگی توسعه‌یافته به همراه کلید و یک XML blob را نشان می‌دهد:

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

مقادیر پیش‌بینی

برای محدود کردن قابلیت مشاهده‌ی ویژگی‌های توسعه‌یافته، از projections استفاده کنید. تنظیم ویژگی‌های توسعه‌یافته (عناصر gd:extendedElement ) فقط در یک projection full یا property- KEY مجاز است.

جدول زیر مقادیر پیش‌بینی پشتیبانی‌شده را شرح می‌دهد:

نام پروژکتور توضیحات
thin هیچ عنصر gd:extendedProperty برگردانده یا به‌روزرسانی نمی‌شود.
property- KEY KEY نشان دهنده کلید یک ویژگی توسعه یافته (عنصر gd:extendedProperty ) است که برگردانده می‌شود (برای درخواست‌های GET ) یا باید به‌روزرسانی شود (برای درخواست‌های PUT یا POST ). اگر ویژگی توسعه یافته در حین عملیات به‌روزرسانی استفاده نشود، ویژگی حذف می‌شود.
full تمام عناصر gd:extendedProperty برگردانده می‌شوند و تمام عناصر باید در طول به‌روزرسانی گنجانده شوند.