IBM FileNet P8, النسخة 5.1.+            

التوصل لعناصر من خلال عناوين URLs

تمنح خاصية امكانية تحديد عنوان URL للمستخدمين التوصل المباشر الى العناصر بدون الحاجة الى التجول خلال واجهة تعامل مستخدم الوحدة التابعة الى IBM® FileNet P8. بعد بدء الاتصال الى الوحدة التابعة الى FileNet P8، مثل Workplace XT، يقوم المستخدم بادخال عنوان URL للعنصر في خط عنوان برنامج الاستعراض. (يستطيع موجه النظام تكوين علامات توقف أو تفضيلات لاسترجاع حافظة أو عنصر قابل للنسخ.)

مع توافر امكانية تحديد عنوان URL، يمكنك:
  • استرجاع الوثائق والحافظات وعمليات البحث التي تم تخزينها وقوالب البحث وتعريفات مسار العمل وقوالب النشر.
  • تحميل أنواع العناصر التالية وحفظها في حاسب محلي: وثيقة، عملية بحث تم تخزينها، قالب بحث، قالب نشر، تعريف مسار عمل.
  • أدخل عنوان URL بناءا على المسار أو بناءا على الكود كما هو موضح بأسفل.
يقوم عنوان URL الذي يعتمد على المسار باستخدام مسار الحاوية لتحديد مكان عنصر في ملف تخزين عناصر. على سبيل المثال، لاسترجاع الوثيقة بالاسم Current Works، التي توجد في حافظة Projects في ملف تخزين العناصر بالاسم Transportation، سيقوم المستخدم بادخال عنوان URL مماثل للمثال التالي:

http://P8_client_server_name/application_name:port/getContent/Transportation/Projects/Current+Works

لاسترجاع العناصر باستخدام عناوين URL التي تعتمد على المسار، يجب أن تحدد تفضيلات موقع استخدام عناوين URL على أساس المسار.

يقوم عنوان URL الذي يعتمد على الكود باستخدام GUIDs لتحديد مكان عنصر في ملف تخزين العناصر. يتم تحديد مكان الوثيقة بواسطة GUID لملف تخزين العناصر الذي توجد به الوثيقة، بالاضافة الى GUID الخاص بالوثيقة. على سبيل المثال، لاسترجاع وثيقة، يقوم المستخدم بادخال عنوان URL مماثل للمثال التالي:

http://P8_client_server_name/application_name:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}

يكون العنوان الذي يعتمد على كود تعريف أسرع من العنوان الذي يعتمد على المسار؛ لكن، يقوم عنوان URL الذي يعتمد على المسار فقط بحل المراجع النسبية التي توجد في الوثيقة. على سبيل المثال، اذا قمت بطلب الملف "example.html" مع عنوان URL يعتمد على المسار، سيتم استرجاع الملف وسيقوم برنامج الاستعراض بحل أي عناوين URL اضافية في example.html (مثل شارات <script>، <img>، <link>). يتم حل أي وصلات (<a href=...>) بواسطة برنامج الاستعراض عند قيام المستخدم بالضغط على الوصلات.

يعرض الجدول التالي الاستجابات المفترضة لأنواع العناصر المختلفة التي يمكنك تحديدها في عنوان URL.
نوع العنصر الاستجابة
حافظة يتم ارجاع صفحة تعرض اسم الحافظة.
وثيقة اذا كانت الوثيقة تحتوي على محتويات، يتم ارجاع المحتويات. اذا كانت الوثيقة لها مرجع خارجي، ستقوم الوحدة التابعة الى FileNet P8 باعادة توجيه الوحدة التابعة وفقا لما يتطلبه الأمر. اذا كانت الوثيقة لا تحتوي على محتويات، ستقوم الوحدة التابعة الى FileNet P8 بتسجيل خطأ.
تعريف مسار العمل يتم فتح برنامج Process Designer المصغر.
عملية بحث تم تخزينها يتم ارجاع صفحة تعرض اسم عملية البحث التي تم تخزينها.
قالب البحث يتم ارجاع صفحة تعرض قالب البحث.
قالب النشر يتم ارجاع محتويات قالب النشر كملف XML.

قواعد نسق عنوان URL على أساس المسار

يتطلب عنوان URL على أساس المسار كود ملف تخزين عناصر واسم مسار الحاوية. يعد المعامل mode=download اختياريا. على سبيل المثال:

http://server/web_application/getContent/objectStoreID/pathName?mode=download

حيث:
  • server هو اسم وحدة خدمة Application Engine أو Workplace XT التي يوجد بها تطبيق الوحدة التابعة الى FileNet P8.
  • web_application هو اسم تطبيق الوحدة التابعة الى FileNet P8؛ على سبيل المثال، Workplace XT.
  • objectStoreID هو كود ملف تخزين العناصر، الذي يمكن أن يكون GUID أو الاسم الخاص بملف تخزين العناصر. يكون اسم ملف تخزين العناصر متفردا في نطاق منفرد، لكن ليس بالضرورة في الدليل الفعال. عند استخدام الاسم للاشارة الى ملف تخزين العناصر، سيتم ارجاع أول ملف تخزين عناصر مطابق في الدليل الفعال. اذا كان هناك ملفات تخزين عناصر بنفس الاسم في الدليل الفعال، عندئذ يجب تصنيف اسم ملف تخزين العناصر باسم النطاق باستخدام الحرف "@"؛ على سبيل المثال، objectStoreName@domainName.
  • pathName هو اسم مسار الحاوية.
  • يسمح المعامل mode=download (الاختياري) بحفظ المحتويات محليا.
    ملاحظة: عناوين URL على أساس المسار للوثيقة وعملية البحث التي تم تخزينها وقالب البحث ولعناصر قالب النشر تشير دائما الى أحدث نسخة.

مثال لعناوين URL على أساس المسار

باستخدام عنوان URL هذا، يتم عرض صفحة Workplace XT مع قالب البحث المحدد. يتم تعريف ملف تخزين العناصر بواسطة الاسم (Forms):

http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download

باستخدام عنوان URL هذا، يكون ملف تخزين العناصر والنماذج مصنفين باسم النطاق الخاص بهم، Midwest:

http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download

قواعد نسق عنوان URL على أساس كود التعريف

يكون لعنوان URL على أساس كود التعريف ثلاث معاملات لمجموعة حروف استعلام مطلوبة لعنصر الحافظة: objectStoreName، objectType، id. على سبيل المثال:

http://server/web application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}

بالنسبة الى الوثيقة وعملية البحث التي تم تخزينها وقالب البحث وقالب النشر وعناصر تعريف مسار العمل، يكون لعنوان URL المعاملات التالية: objectStoreName، objectType، id، fsld. يعد المعامل mode=download اختياريا. فيما مثال لذلك:

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download

أو

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}

أو

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download

حيث:
  • server هو اسم وحدة خدمة Application Engine أو Workplace XT التي يتم تشغيل تطبيق الوحدة التابعة الى FileNet P8 بها.
  • web_application هو اسم تطبيق الوحدة التابعة الى FileNet P8.
  • objectStoreName=objectStoreGUID هو GUID لملف تخزين العناصر حيث يوجد العنصر. قم بتضمين الأقواس المموجة.
  • objectType=type هو نوع العنصر الذي سيتم استرجاعه. أدخل قيمة objectType المناسبة:
    بالنسبة الى: objectType=
    وثيقة وثيقة
    حافظة حافظة
    عملية بحث تم تخزينها storedsearch
    قالب البحث searchtemplate
    تعريف مسار العمل وثيقة
    قالب النشر publishtemplate
  • id=objectGUID هو GUID الذي يقوم بتعريف العنصر في ملف تخزين العناصر. يعد هذا معامل مطلوب لعنصر الحافظة. بالنسبة للوثيقة وعملية التخزين التي تم تخزينها وقالب البحث وتعريف مسار العمل وعناصر قالب النشر، يكون كود التعريف اختياريا ويتم استخدامه لاسترجاع نسخة محددة. قم بتضمين الأقواس المموجة.
  • vsId=versionSeriesGUID هو GUID لاسترجاع أحدث نسخة في تسلسل النسخ للعناصر التالية: وثيقة، عملية بحث تم تخزينها، قالب بحث، تعريف مسار عمل، قالب نشر.
    ملاحظة: عند وجود كلا من ID و vsld في عنوان URL، يقوم تطبيق الوحدة التابعة الى FileNet P8 باستخدام ID لاسترجاع النسخة المحددة. اذا لم يمكن ايجاد النسخة المحددة، سيقوم تطبيق الوحدة التابعة الى FileNet P8 بتسجيل خطأ ويمنح المستخدم الاختيار لاسترجاع أحدث نسخة كما هو محدد بواسطة المعامل vsld.
  • يعد المعامل mode=download اختياريا، ويسمح لك بحفظ المحتويات محليا.
    ملاحظة: يمكنك توصيف تطبيق الوحدة التابعة الى FileNet P8 لاستخدام عناوين URL على أساس المسار لطلبات الوثيقة. لذلك، اذا قمت بادخال عنوان URL على أساس كود التعريف، سيقوم تطبيق الوحدة التابعة FileNet P8 بتحويل عنوان URL على أساس كود التعريف الى عنوان URL على أساس المسار ان أمكن، وذلك للحفاظ على تكامل أي مراجع نسبية لعنوان URL تم ادراجها في محتويات الوثيقة.


تعليق توضيحي

آخر تحديث: يوليو 2011


© .IBM حقوق النشر لشركة 2011.
يتم تشغيل مركز المعلومات هذا من خلال تقنيات Eclipse. ‏‎(http://www.eclipse.org)‎‏