يقوم الملف content_redir.properties بتوصيف اعادة التوجيه لصفحات Workplace XT Java Server Pages (JSP) أو
servlets، أو التطبيقات المهيأة أو للمورد، عند قيام المستخدم بمحاولة فتح ملف من Workplace XT. تعتمد اعادة التوجيه على نوع MIME للمحتويات. يعرض هذا الموضوع كيفية تهيئة اعادة التوجيه.
يوضح القسم التالي كيفية قيام التطبيق باستخدام content_redir.properties.
لتهيئة اعادة التوجيه، أنظر القسم تعديل ملف خصائص اعادة التوجيه.
نبذة عن اعادة توجيه المحتويات
يتكون
content_redir.properties من أزواج للمفتاح/القيمة، حيث يكون المفتاح نوع MIME، وتقوم القيمة بتحديد المكون الذي سيتم استخدامه لفتح ملف لنوع MIME المصاحب.
الكشف التالي لبرنامج مشاهدة الصور ويستخدم هنا كمثال.
يمكن تطبيق المثال للتطبيقات الأخرى. في اختبار الكشف، يجب ملاحظة النقاط التالية:
- المجموعة الأولى لأزواج المفتاح/القيمة تناظر أنواع 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 servlet، بأسفل.
- بالنسبة لأنواع عناصر الوثائق، يتم تعريف تصرف اعادة التوجيه بواسطة محددات معينة، التي يجب مراعاتها اذا قمت بتعديل 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 التي تريد تعريف اعادة التوجيه لها.