عرض مشاركة واحدة
قديم 19-Nov-2011, 08:17 PM   #9
humam
مشرف منتدى المطورين
افتراضي

Microsoft.Dynamics.GP.eConnect.dll

هنا سوف نشرح الطرق والكائنات المتوفرة في هذه المكتبة الدياميكية والتي يمكن استدعاء مكوناتها عن طريق تضمين فضاء الاسماء Microsoft.Dynamics.GP.eConnect وتحتوي هذه المكتبة على ثلاث فئات اساسية هي :
eConnectMethod: وهذه الفئة تعطيك امكانية ارسال واستلام وثائق XML.
EnumTypes: وهذه الفئة تحتوي على ثوابت من النوع Enum والتي تحتاج الى امرارها الى الطرق التي سوف تستخدمها من الفئة الاولى.

eConnectException: وهذه الفئة تجعلك قادر الى متابعة الاستثناءات التي قد تحصل اثناء العمل مع مكونات eConnect.

ملاحظة: للمزيد من المعلومات حول Enum و Exception يمكن مراجعة مكتبة MSDN.

الفئة eConnectMethod :

وتحتوي هذه الفئة على طريقتين هما :
1. eConnect_EntryPoint method
2. eConnect_Requester method
ولكي تكون قادر على استدعاء هذه الطرق عليك ان تعرف اولا كائن من النوع eConnectMethod وكما يلي:
VB.NET:

Dim eConnectObject As New eConnectMethods

C#:

eConnectType eConnect = new eConnectType();

في C#نلاحظ انك تحتاج اولا الى ذكر نوع الكائن او المتغير ثم تتبعه بأسم المتغير وبعد ذلك تتم عملية انشاء نسخة جديدة من الكائن بواسطة العبارة new.

الطريقة eConnect_EntryPoint method

وهي تسمح لك بعملية ارسال وثائق XML من التطبيق الذي تصممه الى برنامج الجريت بلينز وتمتلك هذه الدالة خمس بارمترات هي:
ConnectionString: وهي عبارة عن سلسلة نصية تحتوي على اسم المزود واسم قاعدة البيانات واعدادات الامان:

sConnectionString = @aa"data source=GP10;initial catalog=TWO;integrated security=SSPI";
هذا المثال بلغة C# والمعامل @aa ضروري في بداية العبارة لكي يتم ترجمتها مثل ما هي بدون الحاجة الى استخدام معاملات الهروب.
ConnectionString = "DataSource=GP10; Integrated Security=SSPI;
"Persist Security Info=False; Initial Catalog=TWO"
هذا المثال بلغة VB.NET

ConnectionType: وهنا سوف نحدد نوع الاتصال ويوجد هناك خياران هما:

EnumTypes.ConnectionStringType.SqlClient
EnumTypes.ConnectionStringType.OleDb

الخيار الاول يعني ان الاتصال يتم مع مصدربيانات SQL Server اما OleDb يستخدم للاتصال مع الانواع الاخرى من قواعد البيانات ونلاحظ ان قيمة هذا البارمتر هي من النوع EnumTypes والمضمنة في الفئة EnumTypes .

sXML:وسوف يمثل هذا البرامتر XML document لذا عليك ان تنشىء كائن من هذا النوع لكي تمرره الى هذه الطريقة.

ValidationType: وهنا سوف تحدد نوع التحقق وهناك قيميتين هما None او XSD في حالة None هذا يعني انك لاتريد ان تجري عملية تحقق على وثيقة XML التي ترسلها الى الجريت بلينز اما الخيار الثاني XSD فهو يعني انك تريد التحقق من تركيب وثيقة XML باستخدام eConnect Schema قبل ارسالها الى الجريت بلينز وقد ذكرنا سابقا عن ملفات Schema ما الغرض منها واين يمكنك ايجادها.

eConnectSchema:ان هذا البرامتر سوف يكون اختياري في حالة كونك استخدمت القيمة None في البرامتر السابق اما اذا استخدمت القيمة XSD فعليك هنا توضيح مسار ملف XSD الذي سوف تستخدمه في عملية المقارنه والتحقق.
__________________
GP Techno-Functional Consultant
humam غير متواجد حالياً   رد مع اقتباس