---
title: طلب العناصر
description: "هنا ندخل في التفاصيل حول جلب عناصر الطلبات وإنشائها وتحديثها وحذفها. يمكن الوصول إلى عناصر الطلبات من نقطة النهاية /phaser-order-rows. #### جلب عناصر الطلبات تقوم بجلب عناصر الطلب عن طريق إرسال طلب GET- طلب إلى نقطة نهاية /phaser-order-rows: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **الشكل…"
url: "https://skyplanner.ai/ar/docs/%d8%b7%d9%84%d8%a8-%d8%a7%d9%84%d8%b9%d9%86%d8%a7%d8%b5%d8%b1/"
updated: "2025-10-08"
category: عمليات الدمج
tags:
  - التكامل
  - واجهة برمجة التطبيقات
---

# طلب العناصر

هنا ندخل في التفاصيل حول جلب عناصر الطلبات وإنشائها وتحديثها وحذفها.

يمكن الوصول إلى عناصر الطلبات من نقطة النهاية /phaser-order-rows.

#### جلب عناصر الطلبات

تقوم بجلب عناصر الطلب عن طريق إرسال طلب GET- طلب إلى نقطة نهاية /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**الشكل 1.** جلب عناصر الطلبات

يمكنك البحث عن عناصر الطلب من خلال مجموعة متنوعة من المعلمات المختلفة:

- **phaser_order_id**
  - معرف **طلب**Skyplanner الداخلي، يمكن العثور عليه من نقطة نهاية /phaser-orders-endpoint
- **خارجي_معرف**
  - المعرف الخارجي لعنصر الطلب
  - على سبيل المثال المعرف الفريد من نظامك الخارجي (ERP، إلخ)
- **معرف_تخطيط_الإنتاج_منتج_بمنتج_معرّف**
  - معرّف منتج Skyplanner الداخلي
  - يمكن العثور عليها من نقطة نهاية /المنتجات/ المنتجات
- **المعرف_الأصلي**
  - إذا كان أحد عناصر الطلب يحتوي على عناصر فرعية (مثل المنتجات الفرعية) فإن العناصر الفرعية تحتوي على معرّف عنصر الطلب الأصل في حقل parent_id
- **فهرس_الصفوف**
  - الرقم الفهرسي لعنصر الطلب

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**الشكل 2.** ترتيب مؤشرات صفوف العناصر

- **رقم العمل**
  - قيمة رقم العمل لعنصر الطلب
- **الحالة**
  - حالة عنصر الطلب
  - القيم المسموح بها: **جديدة** أو **بدأت** أو **مكتملة**
- **المنصب**
  - قيمة موضع عنصر الطلب

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
الشكل 3. قيم موضع عنصر الطلب

- **تاريخ_التسليم**
  - تاريخ تسليم عنصر الطلب
  - الصيغة **2025-06-05T22:00:00+00:00**
- **حالة_تاريخ_التسليم**
  - الشرط الاختياري للبحث عن تاريخ التسليم
  - الخيارات: >، =، =، <=، !=، !=
  - في حالة عدم وجود قيمة معطاة، سيتم استخدام الشرط **>= الشرط**
- **هو_المتوقع**
  - إرجاع عناصر الطلبات التي هي احتمالات فقط
- **تضمين_أرشيف**
  - تضمين عناصر الطلبات المؤرشفة (المحذوفة بشكل ناعم) في عملية الجلب
  - يُشار إليها بقيمة **is_archive**
- **معدلة**
  - عناصر طلب الإرجاع التي تم تعديلها بعد تاريخ معين
  - الصيغة **2025-06-05T22:00:00+00:00**
- **حالة معدلة**
  - الشرط الاختياري للبحث عن القيمة المعدلة
  - الخيارات: >، =، =، <=، !=، !=
  - في حالة عدم وجود قيمة معطاة، سيتم استخدام الشرط **>= الشرط**

يمكنك أيضًا مزج معلمات البحث ومطابقتها مثل هذا:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**الشكل 4.**إحضار عناصر الطلب حسب **phaser_order_id**و **row_index**

لجلب عنصر طلب معين بمعرف Skyplanner الداخلي الخاص به يمكنك القيام بطلب مثل هذا:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**الشكل 5.** جلب عنصر طلب بمعرف Skyplanner 4

#### إنشاء عناصر الطلبات

لاحظ أنه يجب عليك إنشاء **طلب** قبل إنشاء عنصر الطلب!

لإنشاء عنصر طلب، أرسل طلب POST إلى نقطة نهاية /phaser-order-rows إلى نقطة نهاية /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**الشكل** **6.** إنشاء عنصر طلب

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**الشكل 7.** عنصر الطلب الذي تم إنشاؤه

فيما يلي نظرة عامة حول الحقول التي يمكنك استخدامها عند إنشاء عنصر طلب:

- **phaser_order_id**
  - معرف Skyplanner الداخلي **للطلب** الذي تم إرفاق عنصر الطلب به
  - **الحقل المطلوب**
- **معرف_صف_طلب_إنتاج_تخطيط_الإنتاج**
  - بعد تصدير الأمر إلى وحدة جدولة الإنتاج في Skyplanner، يتم إنشاء كيان منفصل يسمى **صف أمر تخطيط الإنتاج** ويتم تعيين معرفه في هذا الحقل
  - **لا يوصى باستخدامه**(اتركه فارغًا أو لا ترسل هذا الحقل على الإطلاق في حقل الطلب)
- **معرف_تخطيط_الإنتاج_منتج_بمنتج_معرّف**
  - معرّف منتج Skyplanner للمنتج الذي ينتجه عنصر الطلب
  - مطلوب إذا كنت ترغب في إحضار خطوات عملية افتراضية من المنتج
- **خارجي_معرف**
  - المعرف الفريد لعنصر الطلب
  - استخدم هذا لربط عنصر طلب Skyplanner بعنصر الطلب الخاص بك من نظام خارجي (تخطيط موارد المؤسسات وما إلى ذلك)
  - **يجب أن تكون فريدة من نوعها**
- **المعرف_الأصلي**
  - إذا كان عنصر الطلب عنصرًا فرعيًا لعنصر طلب آخر، فقم بإعطاء قيمة المعرف الأصلي هنا
- **فهرس_الصفوف**
  - أين يقع هذا العنصر في قائمة عناصر الطلب بالترتيب في الترتيب
- **رقم العمل**
  - تُستخدم فقط كقيمة رقم عمل إعلامي لعنصر الطلب
  - غير مرئي في واجهة مستخدم Skyplanner
- **الحالة**
  - حالة عنصر الطلب
  - القيم المسموح بها: **جديد، بدأ، جاهز، على مراحل**
- **هو_أرشيف**
  - هل تم أرشفة عنصر الطلب (حذف ناعم)
- **المنصب**
  - قيمة معرّف عنصر الطلب (انظر الشكل 3.)
- **المبلغ**
  - إجمالي الكمية المصنعة من المنتج
- **المبلغ_المطلوب**
  - الكمية المطلوبة من المنتج
- **السعر**
  - سعر الوحدة من المنتج
- **استخدام_مواد_مخصصة**
  - إذا كنت لا ترغب في استخدام إعداد المواد الافتراضي من بيانات المنتج، قم بتعيين هذه القيمة إلى صواب
  - افتراضي: **خطأ**
- **استخدام_مواد_مخصصة_محسوبة_مخصص_محسوبة**
  - يتم احتساب كميات المواد المخصصة بناءً على كمية المنتجات المصنعة
  - إذا تم ضبطها على خطأ، تكون كميات المواد ثابتة
  - افتراضي: **خطأ**
- **الحصول_على_خطوات_افتراضية**
  - إنشاء خطوات عملية لطلب عنصر بناءً على خطوات العملية الافتراضية للمنتج
  - افتراضي: **خطأ**
- **استخدام_معدلات_الوظائف_المحسوبة_في_الوظائف**
  - حساب مدد خطوات العملية بناءً على بيانات السجل الزمني السابقة
  - في حالة عدم توفر بيانات كافية للحساب، يتم استخدام المدد الافتراضية
  - افتراضي: **خطأ**
- **العناصر_الفرعية**
  - إنشاء عناصر فرعية للمنتج أيضًا إذا كانت متوفرة
  - افتراضي: **خطأ**
- **تاريخ_التسليم**
  - الصيغة: 2022-01-01 10:30:11
- **تاريخ_بدء_الأهلية**
  - الصيغة: 2022-01-01 10:30:11
- **معرّف_الرسم**
  - مُعرِّف الرسم/المطبوعة الزرقاء/التعليمات
- **الوصف**
  - وصف عنصر الطلب
- **وصف_إضافي**
  - وصف إضافي لبند الطلب
- **هو_المتوقع**
  - هل عنصر الطلب احتمال
  - افتراضي: **خطأ**

#### تحديث عناصر الطلبات

لتحديث بيانات عنصر الطلب، يمكنك إرسال طلب PUT إلى نقطة نهاية /phaser-order-rows:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**الشكل 8.**تحديث عنصر الطلب

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**الشكل 9.**عنصر الطلب المحدّث

#### حذف عناصر الطلبات

يتم حذف عناصر الأمر بطريقة "الحذف الناعم". في الواقع، يؤدي حذف عنصر أمر إلى تغيير قيمة **is_archive** الخاصة به إلى صواب. هذا يعني أنه يمكنك استعادة عناصر الطلب المحذوفة عن طريق تحديث قيمة is_archive إلى خطأ.

عند حذف عنصر أمر، سيقوم النظام أيضًا بحذف خطوات العملية المرتبطة به.

يمكنك حذف عناصر الطلب عن طريق إرسال طلب حذف-حذف إلى نقطة نهاية /phaser-أمر-صفوف-طلب:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**الشكل 10.**حذف عناصر الطلبات

يمكنك حذف عناصر الطلب عن طريق إعطاء معرّفات Skyplanner الداخلية في المصفوفة **"ids"** أو المعرّفات_الخارجية في المصفوفة **"external_ids"**.