[humam]

Using eConnect to update existing Document

يوجد العديد من XML Document تسمح لك بالقيام بعملية تحديث بيانات GP Documents الموجودة مسبقا ولكي يكون eConnect قادرعلى تحديث هذه Documents فأن eConnect XML Document يجب ان تحتوي على نوع خاص من eConnect XML Node تحتوي على Update Functionality .

ملاحظة:سوف استخدم مصطلح XML Document للدلالة على eConnect XML Document و Transaction Type للدلالة على eConnect Transaction Type واخيرا XML Node للدلالة على eConnect XML Node .

ان هذه XML Node الخاصة والتي تمتلك Update Functionality سوف تشير الى Business Object والذي كما ذكرنا في السابق انه مجموعة من الاجراءات المخزنه ووضيفة هذا Business Object هو التأكد هل ان البيانات الموجودة في XML Node تخص GP Document موجودة مسبقا في قاعدة البيانات ام لا فأذا وجد Business Object هذه البيانات موجودة مسبقا سوف يقوم بتحديث تلك Documents اما اذا لم تكن موجودة سوف يضيف Document جديدة .

بالنسبة الى الطرق التي يستخدمها Business Object لتحديث GP Document هناك طريقتين يمكن استخدامها:

Document Exchange: في هذه الحالة فان Business Object سوف يقوم بعملية تحديث لجميع حقول البيانات سواء تم امرار هذه الحقول او لم يتم امرار قيم هذه الحقول وفي حالة ترك قيم بعض الحقول فارغة فسوف يتم استخدام eConnect default value لاعداد هذه الحقول اي ببساطة عند استخدام هذه الطريقة سوف تحتاج الى امرار قيم جميع الحقول حتى لو لم تتغير قيمها السابقة.

Field Level Update: في هذه الطريقة يمكن السماح بادراج فقط الحقول التي سوف تتغير قيمها ضمن XML Node اما الحقول التي لم يتم ادراجها ضمن XML Node سوف تحتفظ بقيمها السابقة.

Automating document number assignment
ان XML Document التي تعمل على تكوين GP Documents جديدة سوف تحتاج ان تمرر المعرف الخاص بهذه Document ضمن XML Node ولكن بعض XML Document توفر امكانية ايجاد Document Number عن طريق استرجاع المعرف السابق لأخر Document ثم زيادته بمقدار واحد وتعيينه الى Document الجديدة وللقيام بذلك فان XML Document يجب ان تحتوي على Schema توفر Auto numbering اي ان هذه الخاصية ليست متاحة لكل انوع XML Document وبعد التأكد من وجود هذه الخاصية يجب ان تمرر العنصر الذي يمثل Document Number مع تركه فارغا وبتالي سوف يقوم eConnect بالبحث عن الرقم واسناده الى الوثيقة.
في المثال التالي يوضح XML Document تستخدم Transaction Type من نوع GL وهنا سوف نلاحظ كيفية ترك حقل JRNENTRY فارغ للحصول على الرقم بصورة ذاتية :

<taGLTransactionHeaderInsert>
<BACHNUMB>TEST14</BACHNUMB>
<JRNENTRY></JRNENTRY>
<REFRENCE>General Transaction</REFRENCE>
<TRXDATE>2007-01-21</TRXDATE>
<RVRSNGDT>1900-01-01</RVRSNGDT>
<TRXTYPE>0</TRXTYPE>
<SQNCLINE>16384</SQNCLINE>
</taGLTransactionHeaderInsert>

ملاحظة:
ان SOP Document لاتتطلب منك امرار عنصر يمثل معرف الوثيقة بل سوف تقوم بشكل ذاتي بتحديث معرف GP Document سواء مررت العنصر الذي يمثل معرف الوثيقة وتركته فارغا او لم تذكر هذا المعرف ضمن XML Node . ولكن في حالة كونك مررت العنصر الذي يمثل المعرف مع قيمة سوف يؤدي ذلك الى استخدام هذه القيمة لتحديث حقل المعرف في قاعدة البيانات.