SAP شرح استخدام IDOC في لغة ABAP: دليل خطوة بخطوة
فريق التحرير
⚡ ملخص ذكي
SAP IDoc (المستند الوسيط) هو حاوية بيانات موحدة تنقل معلومات الأعمال بين SAP وغيرSAP تشرح هذه الدورة التدريبية تعريف الأنظمة وبنيتها وأنواعها وجداولها وملفات تعريف الشركاء والمنافذ وعمليات الإرسال والاستقبال الشاملة.
ما هو مستند الهوية (IDoc)؟
IDoc هو مجرد حاوية البيانات تُستخدم لتبادل المعلومات بين أي عمليتين يمكنها فهم تركيب البيانات ودلالاتها.
بمعنى آخر، فإن IDoc يشبه ملف بيانات بتنسيق محدد يتم تبادله بين نظامين يعرفان كيفية تفسير تلك البيانات.
يرمز IDoc إلى "وثيقة وسيطة".
عندما تقوم بتنفيذ الصادرة في عملية ALE أو EDI، يتم إنشاء IDoc. SAP يتم تخزين مستندات IDoc في قاعدة البيانات، ولكل مستند IDoc رقم تعريف. رقم مميز داخل العميل.
الميزات الرئيسية
- مستندات IDoc هي مستقلة عن أنظمة الإرسال والاستقبال (SAPإلىSAP وكذلك غير ذلكSAP).
- تعتمد مستندات IDoc على EDI المعايير، ANSI ASC X12، وEDIFACT. في حالة وجود أي تعارض في حجم البيانات، يعتمد IDoc الحجم الأكبر.
- مستندات IDoc هي مستقلة عن اتجاه تبادل البيانات، على سبيل المثال، يدعم ORDERS01 في وحدة الشراء كلاً من الوارد والصادر.
- يمكن عرض مستندات IDocs في نص محرر لأن البيانات مخزنة بتنسيق الأحرف بدلاً من التنسيق الثنائي.
بنية مستند IDoc
يتكون هيكل IDoc من ثلاثة أجزاء:
- الجزء الإداري (سجل التحكم) — يحتوي على نوع IDoc، ونوع الرسالة، والحالة الحالية، والمرسل، والمستلم، وبيانات وصفية مماثلة. ويُشار إلى هذا باسم سجل التحكم.
- بيانات التطبيق (سجل البيانات) — يحتوي على بيانات العمل. وتسمى هذه البيانات سجلات البيانات أو شرائح.
- معلومات الحالة (سجل الحالة) — يقدم معلومات حول المراحل المختلفة التي مر بها مستند الهوية (IDoc).
يمكنك عرض مستند IDoc باستخدام المعاملة WE02 or WE05.
كما هو موضح في لقطة الشاشة أعلاه، يتكون سجل IDoc من ثلاثة أجزاء: التحكم، والبيانات، والحالة. سيتم شرح كل جزء بالتفصيل أدناه.
سجل التحكم
- يتم تخزين جميع بيانات سجل التحكم في EDIDC الجدول. مفتاح هذا الجدول هو رقم IDoc.
- يحتوي على معلومات مثل رقم IDoc، والاتجاه (وارد/صادر)، والمرسل، ومعلومات المستلم، والقناة المستخدمة، والمنفذ المستخدم.
- يشير الاتجاه "1" إلى الخارج، ويشير الاتجاه "2" إلى الداخل.
سجل بيانات
- يحتوي سجل البيانات على بيانات التطبيق مثل معلومات رأس الموظف، والتفاصيل الأسبوعية، وتفاصيل العميل، وما إلى ذلك.
- يتم تخزين جميع بيانات سجل البيانات في جداول. EDID2 إلى EDID4و إيدي دي دي هو هيكل يمكنك من خلاله رؤية مكوناته.
- يحتوي على بيانات مثل رقم IDoc، واسم ورقم الجزء في IDoc، والتسلسل الهرمي، والبيانات نفسها.
- يتم تخزين الحمولة الفعلية كسلسلة نصية في حقل يسمى سداتا، وهو حقل يتكون من 1000 حرف.
سجل الحالة
- يتم إرفاق سجل الحالة بـ IDoc في كل مرحلة أو عند مواجهة خطأ.
- يتم تخزين جميع بيانات سجل الحالة في نظام معلومات إدارة الطوارئ الجدول.
- الحالات من 1 إلى 42 مخصصة للرحلات المغادرة بينما الحالات من 50 إلى 75 مخصصة للرحلات القادمة.
أنواع IDoc
يحدد نوع IDoc (الأساسي) بنية وتنسيق مستند العمل المراد تبادله. IDoc هو مثال على نوع IDocتمامًا مثل مفهوم المتغيرات وأنواع المتغيرات في لغات البرمجةيمكن تعريف أنواع IDoc باستخدام المعاملة WE30.
ما هي الشريحة؟
يحدد المقطع شكل وبنية أ سجل بيانات في IDoc. الأجزاء هي مكونات قابلة لإعادة الاستخدام.
لكل جزء، SAP يقوم بإنشاء المكونات التالية.
- نوع المقطع (إصدار مستقل)
- تعريف المقطع (يعتمد على الإصدار)
- توثيق القطاع
تمثل الأحرف الثلاثة الأخيرة إصدار المقطع. قد تتغير التعريفات بتغير الإصدار، لكن نوع المقطع يبقى كما هو. المعاملة: WE31.
ما هو نوع IDoc الممتد؟
يوجد نوعان من IDoc:
- خفيف
- تمديد
SAP يوفر العديد من أنواع IDoc الأساسية المُعرّفة مسبقًا والتي لا يمكن تعديلهإذا كنت بحاجة إلى إضافة المزيد من البيانات إلى نوع أساسي محدود، يمكنك استخدام نوع إضافي. في معظم الأحيان ستحتاج إلى لست أحتاج إلى تمديدات.
توثيق
يتم توثيق كل مستند IDoc بشكل كامل في المعاملة WE60.
نوع الرسالة
تمثل الرسالة نوعًا محددًا من المستندات التي transmitعلى سبيل المثال، يتم التعامل بين شريكين، مثل الطلبات، وردود الطلبات، والفواتير.
يمكن ربط نوع IDoc واحد بالعديد من أنواع الرسائل. وبالمقابل، يمكن ربط نوع رسالة واحد بأنواع IDoc مختلفة. المعاملة: WE81.
عرض IDoc
يمكن استخدام نوع IDoc لأكثر من نوع رسالة واحد، مما ينتج عنه وجود حقول في IDocs أكثر من المطلوب لنوع رسالة معين.
تعمل ميزة IDoc Views على تحسين أداء إنشاء مستندات IDoc من خلال ضمان ملء الأجزاء ذات الصلة فقط بالبيانات. وتُعد ميزة IDoc Views مهمة فقط لمعالجة البيانات الصادرة.
الملفات الشخصية للشريك
الشريك هو شريك تجاري تقوم معه بإجراء الأعمال وتبادل الوثائق.
في ملف تعريف الشريك الذي يتم تبادل مستندات IDoc معه، يمكنك تحديد المعلمات اللازمة لتبادل البيانات. المعاملة المستخدمة هي WE20.
ميناء
يحدد الميناء الخصائص التقنية للاتصال بينك SAP النظام والنظام الآخر الذي ترغب في نقل البيانات معه (النظام الفرعي). يحدد المنفذ الوسيلة التي يتم من خلالها تبادل البيانات بين النظامين.
توجد أنواع مختلفة من المنافذ. النوعان الأكثر استخداماً هما منافذ TRFC يستخدم في ALE و منافذ الملفات يستخدم بواسطة نظام تبادل البيانات الإلكترونية (EDI).
بالنسبة لمنافذ TRFC، يجب عليك تحديد اسم الوجهة المنطقية التي تم إنشاؤها باستخدام SM59عند استخدام منفذ ملف، يمكنك تحديد الدليل الذي يجب وضع ملف IDoc فيه. ثم يقوم النظام الآخر أو البرنامج الوسيط باستلام الملف من هناك. ويمكن استخدام وحدة وظائف لإنشاء اسم ملف IDoc. تجريبيمكنك استخدام "ملف صادر" لتحديد اسم ملف ثابت. علامة التبويب "الزناد الصادريمكن استخدام هذا الخيار لتوفير معلومات إذا كنت ترغب في تشغيل بعض العمليات على النظام الفرعي عند إنشاء مستند IDoc في هذا الموقع. حدد اسم ملف الأمر والدليل الذي يجب تشغيله فيه.
معاملة IDoc الشائعة Codes
| تقديم Code | الهدف |
|---|---|
| WE02 / WE05 | عرض ومراقبة مستندات IDoc |
| WE30 | إنشاء أو تغيير نوع IDoc |
| WE31 | إنشاء أو تغيير شريحة |
| WE20 | تحديث ملف تعريف الشريك |
| WE21 | صيانة الموانئ |
| WE42 | تحديد عملية الإدخال Code |
| WE57 | قم بتخصيص وحدة وظائف واردة لنوع الرسالة |
| WE60 | وثائق IDoc |
| WE81 / WE82 | إنشاء نوع رسالة / ربطه بنوع IDoc |
| BD51 | تحديد خصائص وحدة الوظائف |
| SM59 | الحفاظ على وجهات RFC |
عملية IDoc: مثال من واقع الحياة
لنأخذ مثالاً على إرسال أمر شراء إلى مورد من خلال IDoc.
- عند إنشاء أمر شراء (PO)، يحتاج النظام إلى إرسال IDoc إلى المورد.
- يتم إرسال أمر الشراء بصيغة IDoc إلى المورد (الشريك). يجب أن يكون هذا الشريك مُفعّلاً لتقنية تبادل البيانات الإلكترونية (EDI) في النظام. SAP يدرك أنه يستطيع إرسال المستند إلى هذا المورد إلكترونياً.
- يصبح أمر الشراء المرسل كوثيقة IDoc صادرة من قبل العميل وثيقة IDoc واردة للمورد. SAP يمكن للنظام الموجود على جانب البائع معالجة هذا لإنشاء مستند طلب (أمر بيع) على نظامهم.
- تُعد عروض الأسعار وطلبات عروض الأسعار وأوامر الشراء وأوامر البيع والفواتير وإشعارات التسليم من أكثر المستندات التي يتم تبادلها بشكل شائع من خلال IDoc.
عملية نقل البيانات خارج الخاص بك SAP النظام يسمى عملية الصادرةأثناء انتقال البيانات إلى SAP النظام يسمى عملية واردةبصفتك مطورًا أو مستشارًا تقوم بإعداد هذه العمليات لمنظمتك، فإن خطوات تكوين كل منها موضحة بالتفصيل أدناه.
العملية الصادرة
الخطوات المتبعة:
- إنشاء مقاطع (WE31).
- إنشاء نوع IDoc (WE30).
- إنشاء نوع رسالة (WE81).
- قم بربط نوع الرسالة بنوع IDoc (WE82).
- إنشاء منفذ (WE21).
- إذا كنت تستخدم طريقة التحكم في الرسائل لتشغيل IDocs، فأنشئ وحدة الوظائف التي تُنشئ IDoc واربطها بعملية صادرة. Code.
- وإلا، فقم بإنشاء وحدة وظائف أو برنامج مستقل يقوم بإنشاء IDoc مباشرة.
- قم بإنشاء ملف تعريف الشريك (WE20) بالمعلومات الضرورية في المعلمات الصادرة للشريك الذي تتبادل معه IDoc، وقم بتشغيل IDoc.
العملية الواردة
الخطوات المتبعة:
- إنشاء نوع IDoc الأساسي (المعاملة WE30).
- إنشاء نوع الرسالة (المعاملة WE81).
- قم بربط نوع الرسالة بنوع IDoc الأساسي (المعاملة WE82).
- أنشئ وحدة الوظائف لمعالجة IDoc.
- حدد خصائص وحدة الوظائف (BD51).
- قم بتخصيص وحدة الوظائف الواردة لنوع الرسالة (WE57).
- تحديد العملية Code (المعاملة WE42).
- إنشاء ملف تعريف الشريك (المعاملة WE20).
