IBM FileNet P8, النسخة 5.2            

خصائص اعادة توجيه المحتويات

يقوم الملف content_redir.properties بتوصيف اعادة التوجيه لصفحات ‏‎Workplace XT Java Server Pages ‎(JSP)‎‏ أو servlets، أو التطبيقات المهيأة أو للمورد، عند قيام المستخدم بمحاولة فتح ملف من Workplace XT. تعتمد اعادة التوجيه على نوع MIME للمحتويات. يعرض هذا الموضوع كيفية تهيئة اعادة التوجيه. يوضح القسم التالي كيفية قيام التطبيق باستخدام content_redir.properties. لتهيئة اعادة التوجيه، أنظر قسم تعديل ملف خصائص اعادة التوجيه.

نبذة عن اعادة توجيه المحتويات

يتكون content_redir.properties من أزواج للمفتاح/القيمة، حيث يكون المفتاح نوع MIME، وتقوم القيمة بتحديد المكون الذي سيتم استخدامه لفتح ملف لنوع MIME المصاحب. الكشف التالي خاص ببرنامج Image Viewer ويتم استخدامه هنا كمثال. يمكن تطبيق المثال للتطبيقات الأخرى. في اختبار الكشف، يجب ملاحظة النقاط التالية:
  • المجموعة الأولى لأزواج المفتاح/القيمة تناظر أنواع MIME لبرنامج مشاهدة الصور. للاستفادة من خاصية التعليقات التوضيحية في برنامج مشاهدة الصور، يمكنك تحرير هذا الملف لتحديد أنواع الصور التي يتم فتحها في برنامج مشاهدة الصور. يعرض الكشف أنواع MIME التي يتم فتحها بواسطة برنامج مشاهدة الصور، ذات القيمة /WcmJavaViewer.jsp?{QUERY_STRING}. أنظر التعامل مع برنامج مشاهدة الصور للحصول على مزيد من المعلومات عن برنامج مشاهدة الصور.
  • تعتمد المفاتيح التي توجد في content_redir.properties على الخاصية mimeType التي تم تعريفها في فئات Content Engine معينة. أنظر نبذة عن أنواع MIME للتعرف على المزيد من المعلومات.
  • يمكن أن تتضمن القيمة على أوامر مركبة، مثل {QUERY_STRING}. توجد كل الأوامر المركبة المتاحة في content_redir.properties.
  • اذا لم يتم تعريف نوع MIME في content_redir.properties، سيتم استدعاء getContent servlet، وستكون الاستجابة وفقا لنوع العنصر المحدد. أنظر طريقة التصرف المفترضة من getContent، بأسفل.
  • بالنسبة لأنواع عناصر الوثائق، يتم تعريف تصرف اعادة التوجيه بواسطة محددات معينة، التي يجب مراعاتها اذا قمت بتعديل content_redir.properties. أنظر التعليمات الخاصة بالمحددات الأخرى، بأسفل.
# قم بالتعقيب على السطور ذات أنواع  MIME حتى لا يتم فتحها بواسطة برنامج مشاهدة الصور
image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/bmp=/WcmJavaViewer.jsp?{QUERY_STRING}
image/tiff=/WcmJavaViewer.jsp?{QUERY_STRING}
image/gif=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-visio=/redirect/customAppRedirect.jsp?vsId={VERSION_SERIES_ID}&objectStoreName={OBJECT_STORE_NAME}&id={OBJECT_ID}&objectType=document

application/vnd.filenet.im-image=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-form=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-other=/WcmJavaViewer.jsp?{QUERY_STRING}

folder=/WcmObjectBookmark.jsp
customobject=/integrationWebBasedCommand?_commandId=3010
showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010
application/x-filenet-search=/WcmObjectBookmark.jsp
application/x-filenet-searchtemplate=/WcmObjectBookmark.jsp
application/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jsp
application/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp
...

التصرف المفترض بالنسبة الى getContent servlet

اذا لم يتم تحديد نوع MIME في content_redir.properties، سيقوم التطبيق باستدعاء getContent servlet. يتم تحديد تصرف servlet بواسطة نوع العنصر المحدد، كما هو موضح بأسفل.
حافظة
يتم اعادة توجيه الوحدة التابعة لصفحة تعرض الحافظة.
وثيقة
اذا كانت الوثيقة تحتوي على محتويات، يتم ارجاع المحتويات الى برنامج الاستعراض.
اذا كانت الوثيقة لها مرجع خارجي، سيقوم servlet باعادة توجيه الوحدة التابعة بطريقة مناسبة.
اذا كانت الوثيقة لا تحتوي على محتويات، سيتم تسجيل خطأ.
وثيقة تعريف مسار العمل
يتم اعادة توجيه الوحدة التابعة الى Workflow Designer.
عملية بحث تم تخزينها
يتم اعادة توجيه الوحدة التابعة لصفحة تعرض عملية البحث التي تم تخزينها.
قالب البحث
يتم اعادة توجيه الوحدة التابعة لصفحة تعرض قالب البحث.
قالب النشر
يتم ارجاع محتويات قالب النشر كملف XML.

التفاعل مع المحددات الأخرى

بالاضافة لمحددات الملف content_redir.properties، تؤثر خاصية تم اخفائها في عناصر نوع الوثيقة (التي تتضمن صور) على تصرف اعادة التوجيه. هذه الخاصية التي تم اخفائها تسمى "IgnoreRedirect" ولا يتم تحديدها افتراضيا. يمكن أن يتم تحديدها برمجيا أو من خلال مدير المشروع فقط.

عند فتح عناصر نوع الوثيقة، يقوم التطبيق بالبحث عن خاصية IgnoreRedirect والقيام بالتصرفات التالية:
  • اذا تم تحديد IgnoreRedirect بالقيمة True، يتم ارسال الوثيقة الى برنامج الاستعراض.
  • اذا تم تحديد IgnoreRedirect بالقيمة False، يتم ارسال الوثيقة الى المكون المحدد في content_redir.properties.
  • اذا لم يتم تحديد IgnoreRedirect بالقيمة (NULL)، يتم ارسال الوثيقة الى المكون المحدد في content_redir.properties.

بالنسبة للوثائق المخزنة في مكتبة خارجية، مثل Image Services، توجد تفضيلات موقع خدمة خارجية بالاسم "Include Redirect". افتراضيا، يتم تحديد هذه التفضيلات بالقيمة "نعم". اذا تم تحديد القيمة "نعم"، يتم ارفاق عنوان URL مع محددات الخاصية IgnoreRedirect في الصورة. أنظر تفضيلات الخدمات الخارجية للحصول على مزيد من المعلومات عن هذه التفضيلات.

عند فتح الصور المخزنة في Image Services، يقوم التطبيق بالتصرفات التالية:
  • اذا كان "Include Redirect" = Yes، وخاصية الوثيقة IgnoreRedirect = true، سيقوم التطبيق بارسال الصورة الى برنامج الاستعراض.
  • اذا كان "Include Redirect" = Yes، وخاصية الوثيقة IgnoreRedirect = false، سيقوم التطبيق بارسال الصورة الى الوجهة المستهدفة المحددة في content_redir.properties.
  • اذا كان "Include Redirect" = No، لن يتم تضمين محددات الخاصية IgnoreRedirect في عنوان URL، وسيقوم التطبيق بارسال الصورة الى الوجهة المستهدفة المحددة في content_redir.properties.

تعديل ملف خصائص اعادة التوجيه

يمكنك تهيئة اعادة التوجيه من خلال تعديل content_redir.properties. على سبيل المثال، يمكنك اضافة اعادة توجيه لتطبيقات المورد، أو التعقيب على اعادة التوجيه الحالية والسماح الى getContent servlet بالتعامل مع العناصر ذات نوع MIME الذي تم التعقيب عليه.

ملاحظة: قبل تعديل content_redir.properties، قم بالتحقق من خاصية IgnoreRedirect ومن تفضيلات موقع "Include Redirect" لأنواع MIME التي تريد تعريف اعادة التوجيه لها.

لتعديل ملف خصائص اعادة التوجيه

  1. قم بفتح content_redir.properties باستخدام برنامج تحرير النص. افتراضيا، سيتم تركيب الملف في المكان التالي:
    Workplace XT: <install_location>/FileNet/Config/WebClient
  2. تعديل الخصائص وفقا لما يتطلبه الأمر.
    • لازالة مناظرة نوع MIME موجودة حاليا، قم بالتعقيب على زوج المفتاح/القيمة المناسب ذو رمز # بالبداية؛ على سبيل المثال، #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • لاضافة مناظرة نوع MIME، أدخل زوج مفتاح/قيمة مع تحديد مفتاح يناظر قيمة خاصية mimeType التي تم تعريفها في فئة Content Engine. يجب أن تحدد القيمة مسار لصفحة JSP أو servlet في التطبيق، بالنسبة لدليل التطبيق.

      باستخدام الأوامر المركبة، يمكنك امرار مجموعة حروف استعلام URL للعنصر المحدد الى المكون المحدد في زوج المفتاح/القيمة. على سبيل المثال، يمكنك تضمين الأمر المركب {QUERY_STRING} لامرار مجموعة حروف الاستعلام بالكامل. أو يمكنك امرار معاملات منفردة من مجموعة حروف الاستعلام مع {OBJECT_TYPE}، {OBJECT_ID}، والأوامر المركبة الأخرى. أنظر الملف content_redir.properties للحصول على كشف كامل بالأوامر المركبة.

    • لمناظرة نوع MIME لتطبيق مهيأ أو تطبيق المورد، يجب أن تحدد مكون في التطبيق يقوم باعادة التوجيه الى التطبيق الخارجي. على سبيل المثال، في زوج المفتاح/القيمة لمساحة العمل التالي، ستقوم مساحة العمل باعادة التوجيه الى Workplace/redirect/customAppRedirect.jsp اذا قام المستخدم بتحديد ملف مع نوع MIME بالقيمة "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      لاعادة التوجيه الى تطبيق خارجي، يمكن أن يكون الكود البرمجي لاعادة توجيه JSP مماثل للسطر التالي.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      لكن، يكون الكود البرمجي لاعادة التوجيه لتطبيق خارجي أكثر شمولا، مع اتاحة نفس برامج API الأساسية الى Workplace XT، لارجاع عنوان URL والمعاملات والرموز المميزة للسرية وأي قيم أخرى مطلوبة بواسطة التطبيق الخارجي.

  3. حفظ content_redir.properties.
  4. أعد بدء وحدة خدمة الانترنت حتى تصبح المحددات الجديدة الخاصة بك فعالة.


تعليق توضيحي

آخر تحديث: مارس 2013
aeadm_config_file_content_redir.htm

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