عناصر البيانات

أين يعيش هذا

في المنتج تُسمّى الواجهة عناصر البيانات، تحت قسم البيانات. وفي واجهة البرمجة لا يزال الكيان يُسمّى عنصر بيانات — كل نقطة نهاية أدناه تقول /datasets — والكلمتان تعنيان الشيء نفسه.

كيف تتحرك البيانات عبر Haiyz

عنصر مستضاف واحد، وكل الخدمات. يوضح الرسم ما يقرؤه وما يشاركه؛ ولا شيء ينسخه.

النموذج

العنصر اسم إضافة إلى قائمة مرتّبة من الإصدارات. كل إصدار ملف واحد حتى 50 م.ب، يُخزَّن كما رُفع.

• الرفع إلى عنصر موجود يضيف إصدارًا؛ وتبقى الإصدارات السابقة قابلة للتنزيل ويمكن لخريطة أو غرفة تثبيت أي منها. ولقطة الطبقة القابلة للتحرير إصدار أيضًا، معلَّم بذلك.
• لا يتغيّر الإصدار بعد رفعه أبدًا. صحّح الملف برفع الملف المصحّح إصدارًا تاليًا — أو، على طبقة قابلة للتحرير، بتحرير معالمها؛ ويبقى الرفع حينها تاريخًا.
• يُقبل أي ملف. الصيغ المكانية تحصل على تحقق ومعاينة؛ وما عداها يُخزَّن ويُفحص ويُقدَّم كما هو.
• يحمل كل إصدار حجمه ومجموع التحقق الخاص به، وهو ما يستخدمه سطح المكتب ونقطة نهاية فحص الإصدارات لمعرفة ما إذا كانت النسخة محدّثة. أما الطبقة القابلة للتحرير المسحوبة فتكون محدّثة بإصدار مزامنتها.
• يمكن تحويل طبقة حيّز الجاهزة إلى قابلة للتحرير. تصبح صفوفها حينها بيانات العنصر الحالية، ويُرفض رفع إصدار ملف جديد ما دام التحرير مفعّلًا، ويحمل العنصر رقاقة قابل للتحرير.

التحقق إثراء، لا بوّابة

عندما يكون الإصدار بصيغة مكانية معروفة، يقرؤه المحرّك ويسجّل ما وجده — نظام الإحداثيات، ونوع الهندسة، وعدد المعالم، والإطار المحيط، والتحذيرات. يُرفق السجل بالإصدار ويُعرض في الصفحة:

"validation": {
  "valid": true,
  "crs": "EPSG:4326",
  "geometryType": "Point",
  "featureCount": 1,
  "bbox": [46.6753, 24.7136, 46.6753, 24.7136],
  "layers": [],
  "warnings": []
}

الفحص يحكم التسليم، لا الرفع

يُفحص كل إصدار بحثًا عن البرمجيات الخبيثة بعد الرفع. للفحص أربع حالات، وتحدّد الحالة من يستطيع تنزيل الملف — لا ما إذا كان قد قُبل:

• لا يمنع الفاحص أي رفع أبدًا. يوجد الإصدار لحظة اكتمال الرفع.
• يستطيع المالك رؤية الإصدار وتنزيله وفحصه لا يزال معلّقًا.
• أما الآخرون — المشاهدون وروابط المشاركة وغرف البيانات وسطح المكتب — فلا يتلقون إلا الإصدارات النظيفة.
• في نشر بلا فاحص تُعلَّم الإصدارات بأنها غير مدعومة؛ ويتبع التسليم حينها إعدادات ظهور المالك وحدها.

من يرى ماذا

للعنصر ظهور واحد. الخاص لك وحدك؛ وغير المدرج يُفتح بالرابط لأي مسجّل دخول؛ والعام مدرج في الفهرس؛ والمؤسسي ظاهر لأعضاء مؤسستك بحسب أدوارهم:

داخل المؤسسة يحدّد الدور ما يستطيع العضو فعله بعناصر المؤسسة:

قيم الظهور وأسماء الأدوار هي تعدادات واجهة البرمجة نفسها؛ وهي مطبوعة هنا تمامًا كما تتوقعها الواجهة.

روابط المشاركة

يسلّم رابط المشاركة إصدارًا واحدًا لأشخاص بلا حساب. يحمل نطاقًا، ومدة انتهاء (7 أيام افتراضيًا، و90 يومًا كحد أقصى)، وسقف استخدام اختياريًا، وما إذا كان تسجيل الدخول مطلوبًا.

scope

ما يفتحه الرابط: إصدار واحد بعينه، أو أحدث إصدار نظيف للعنصر وقت الزيارة.

expiresInDays

مدة الصلاحية بالأيام. الافتراضي 7؛ والحد الأقصى 90. الرابط المنتهي يجيب بـ410.

maxUses

اختياري. بعد هذا العدد من التنزيلات يتوقف الرابط عن العمل ويجيب بـ429.

requireLogin

اختياري. عند تفعيله يجب أن يكون الزائر مسجّل الدخول — ويعمل الرابط حينها كعنصر غير مدرج.

• يُعرض رمز الرابط مرة واحدة عند إنشائه. ولا يُخزَّن بعدها بصيغة قابلة للقراءة.
• يُحلّ فتح الرابط إلى عنوان تنزيل صالح لمدة 120 ثانية ومقيّد بذلك الملف؛ يمكن مشاركة الرابط نفسه، ولا ينبغي مشاركة العنوان المحلول.
• لا يقدّم الرابط أبدًا إصدارًا فحصه معلّق أو فاشل.
• إلغاء الرابط نافذ فورًا؛ ولا يمسّ العنصر ولا إصداراته.

غرف البيانات

تجمع غرفة البيانات حتى 50 إصدارًا مثبّتًا لمجموعة من الأشخاص — تسليم، أو مجموعة مراجعة، أو حزمة منافسة — مع أدوار وسجل نشاط.

• تحتوي الغرفة على إصدارات لا عناصر: ما يراه المستلم لا يتغيّر عند رفع إصدار جديد ما لم تثبّته.
• يُسجَّل كل فتح وتنزيل وتغيير في سجل الغرفة، ويراه مديروها.
• ثلاثة أدوار: المشاهدون يفتحون وينزّلون، والمتعاونون يضيفون الإصدارات ويثبّتونها، والمديرون يغيّرون العضوية والإعدادات.
• يمكن إضافة مجموعة إلى غرفة كعضو واحد؛ ويرث أفرادها دور الغرفة معًا.

المجموعات

المجموعة قائمة أعضاء مسمّاة. هي طريقة لمنح الوصول لعدة أشخاص دفعة واحدة؛ وليست مقعدًا ولا تملك شيئًا خاصًا بها.

• للمجموعة مالك وأعضاء؛ والمالك ليس عضوًا تلقائيًا.
• ينضم الأعضاء بالدعوة، من صفحة المجموعة أو بالبريد الإلكتروني.
• عند إضافة مجموعة إلى غرفة بيانات أو لوحة معلومات أو خريطة، يحصل كل عضو على دور ذلك العنصر عبر المجموعة.
• تُسجَّل تغييرات عضوية المجموعة، وإزالة عضو تزيل كل وصول حصل عليه عبر المجموعة.

المصادر الحية

يمكن أن يشير العنصر إلى خدمة خارجية — طبقة Esri REST أو بوابة — بدلًا من أن يحتوي ملفًا. تقرأ المنصّة حينها الصفوف من المصدر عند فتح العنصر.

• يُقرأ العنصر الحي عبر المنصّة، لا من المتصفح مباشرة، فتبقى بيانات اعتماد المصدر على الخادم.
• يمكن أخذ نسخة صلبة في أي وقت: تصبح الصفوف الحالية إصدارًا مخزّنًا كأي رفع. (وهذا غير نوع إصدار اللقطة الذي يخص الطبقات القابلة للتحرير.)
• تعرض الخرائط المبنية على عنصر حي صفوفه وقت نشر الخريطة؛ والتحديث يسحب المصدر مجددًا.

النسخ الصلبة

تجمّد النسخة الصلبة مصدرًا حيًا أو نتيجة أداة أو إصدار عنصر آخر في إصدار مخزّن خاص بك. وهي الطريقة للاحتفاظ بلقطة مؤرّخة من بيانات لا تتحكم بها.

التحرير في المكان

يمكن لمدير العنصر تحويل طبقة حيّز الجاهزة إلى قابلة للتحرير. منذئذٍ تكون صفوفها النسخة الحية: يغيّر المحررون المعالم في المتصفح، ودون اتصال في جيو حيّز مع المزامنة، ومن حيّز فيلد عبر هدف الحملة. يجتاز كل تغيير فحصين في الخادم — صلاحية الشخص للعملية، وقفل المعلم مع قواعد الطبقة — ويُسجَّل. تحفظ اللقطات الصفوف الحية إصداراتٍ من نوع لقطة ويمكن استعادتها.

• ما دامت أي طبقة من العنصر قابلة للتحرير، يجيب POST /datasets/:id/versions بـ 409 EDITING_BLOCKS_UPLOAD؛ خذ لقطة أو أوقف التحرير أولًا.
• يسري حدّان من الخطة: editableLayers (الطبقات المفعّل فيها التحرير لكل مالك) وeditsPerMonth (التعديلات المطبَّقة في الشهر الميلادي). وكلاهما يجيب بـ 409 PLAN_LIMIT_REACHED.
• النموذج الكامل في أدلة البيانات: الطبقات القابلة للتحرير، ومن يجوز له التحرير، والقواعد، والتحرير في المتصفح وفي جيو حيّز، وجسر فيلد، والسجل واللقطات، وكل سبب رفض. ونقاط النهاية في مرجع الواجهة البرمجية تحت /datasets/:id/editing.

اقرأ أدلة التحرير

الحفظ من تشغيل أداة

يمكن حفظ نتيجة أي أداة تنتج ملفًا كعنصر بيانات، أو كإصدار جديد لعنصر، من لوحة نتيجة التشغيل — دون تنزيلها وإعادة رفعها.

الحصص

تُحسب عمليات الرفع كتشغيلات على سجل الأدوات، تحت مفتاح الأداة dataset-upload، وبالنوافذ نفسها كأي أداة محسوبة.

التخزين سقف تراكمي لكل مالك عبر كل إصدارات كل العناصر:

• حذف عنصر يحرّر بايتات كل إصداراته دفعة واحدة.
• يضيف الإصدار الجديد حجمه إلى المجموع؛ وتبقى الإصدارات الأقدم محسوبة حتى يُحذف العنصر.
• الطبقات القابلة للتحرير والتعديلات الشهرية حدّان آخران من الخطة، منفصلان عن التخزين وعن تشغيل الأدوات؛ راجع الخطط والحدود.

رموز الأخطاء

الرموز التي تجيب بها واجهة البيانات، مرتبطة بحالة HTTP الخاصة بها. تعكس المعاني الرسالة ثنائية اللغة التي تعيدها الواجهة.

البيانات المفتوحة، وإلى أين بعد ذلك

يمكن ترقية العنصر العام إلى فهرس البيانات المفتوحة، حيث يُدرج للجميع مع رخصته وإصداراته. الترقية خاضعة للمراجعة؛ ولا يمكن حذف العنصر المرقّى ما دام مدرجًا.

لغرف البيانات والمجموعات أدلة خاصة تحت قسمي البيانات والمشاركة؛ وسجل الأدوات ونوافذه في صفحة الحصص.