بررسی اجمالی و هدف
خارج از کادر, خزه’ محتوا قسمت وب سایت پرس و جو (CQWP) نمایش نتایج: از شماره خود را در قالب لیست, similar to search results. It is also possible to display the results in a grid format (i.e. فرمت جدول HTML). Grid formats are better in some circumstances. I describe how to achieve that effect in this article.
سناریوی کسب و کار
I have worked with a client on an enterprise-wide MOSS rollout. We have designed their taxonomy such that projects are first class citizens in the hierarchy and have their own top level site. Project managers maintain a singleton list of project summary information, مانند عنوان, بودجه, تاریخ اتمام انتظار می رود, remaining budget and other summary type fields. By "singleton" I mean a custom SharePoint list guaranteed to contain only one item. Simplistically, مثل این به نظر می رسد:
رویکرد فنی بسیار مشابه به عنوان شرح داده شده اینجا (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!447.entry). The CQWP uses an XSL transform to emit HTML for the browser to render.
I always envision the result before diving into the XSL because XSL is a nightmare. Here’s my desired result:
HTML مثل این ایجاد می کند که نتیجه:
|
|
<اچ تی ام ال>
<بدن>
<مرکز>
<جدول مرز= 1>
<!-- برچسب ها ->
<TR bgcolor= آبی>
<فلش><فونت رنگ= سفید><ب>نام پروژه</ب></فونت></فلش>
<فلش ردیف کردن= راست><فونت رنگ= سفید><ب>کامل عضویت</ب></فونت></فلش>
<فلش ردیف کردن= راست><فونت رنگ= سفید><ب>بودجه</ب></فونت></فلش>
<فلش ردیف کردن= راست><فونت رنگ= سفید><ب>هزینه های واقعی</ب></فونت></فلش>
<فلش><فونت رنگ= سفید><ب>وضعیت کل</ب></فونت></فلش>
</TR>
<TR>
<فلش>اتاق کامپیوتر را دوباره سیم.</فلش>
<فلش ردیف کردن= راست>02/01/08</فلش>
<فلش ردیف کردن= راست>22,500.00</فلش>
<فلش ردیف کردن= راست>19,000.00</فلش>
<فلش>در حال پیشرفت</فلش>
</TR>
<TR>
<فلش>سرورهای ارائه برای ارتقا SQL</فلش>
<فلش ردیف کردن= راست>04/01/08</فلش>
<فلش ردیف کردن= راست>7,500.00</فلش>
<فلش ردیف کردن= راست>0.00</فلش>
<فلش>برنامه ریزی</فلش>
</TR>
</جدول>
</مرکز>
</بدن>
</اچ تی ام ال>
|
رویکرد
این مراحل را برای ایجاد شبکه:
- شناسایی اجزای شبکه (سطر / ستون).
- تعریف و ایجاد ستون های سایت لازم.
- ایجاد سایت های زیر را برای پروژه ها و لیست های تک قلو.
- اضافه کردن CQWP به یک صفحه وب و پیکربندی آن به جستجو برای لیست شما.
- اصلاح XML CQWP را برای جمع آوری ستون های اضافی.
- اصلاح XSL برای تولید یک جدول.
I’m going to concentrate on number six. Numbers one through four are straight-forward and something that any CQWP user has already done. Number five has been well-documented by others including this exhaustive screen-shot laden article from MSDN اینجا (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) و وبلاگ هدر سلیمان را اینجا (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
آجیل و پیچ و مهره
شروع و اجرای مراحل یک تا پنج به عنوان در مستندات MSDN و مقاله هدر سلیمان را.
در این مرحله, شما CQWP خود را به این صفحه اضافه شده است و شما باید خود را <CommonViewFields> در صورت لزوم پیکربندی.
پس از مراحل معمول, من این نتایج متوسط:
1. ایجاد یک نوع محتوا, a templatized custom list for that content type and two sites. Here is the content type:
در اینجا این است که ساختار سایت:
2. در اضافه کردن CQWP را پس از ایجاد زیرسایت پروژه های من و لیست خلاصه پروژه تک قلو:
3. اضافه کردن اطلاعات اضافی من می خواهم از طریق <CommonViewFields>:
<ویژگی نام="CommonViewFields" نوع="رشته">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</ویژگی>
توجه داشته باشید که من تا به حال به نگه داشتن تمام زمینه های مالکیت در یک خط و یا آن را نمی خواهد کار کند (CQWP به من بگویید که با پرس و جو بازگشت موردی).
4. در این مرحله, we’re ready to move beyond the MSDN article and flip on over to Heather Solomon’s article. Follow her steps starting near step #5 برای ایجاد یک سفارشی / unghosted version of ItemStyle.xsl. I follow Heather’s advice, تا از طریق گام 11 و این نتایج متوسط:
4.1: نام قالب XSL من به شرح زیر است:
<XSL:template name="Grid" match="Row[@Style=’Grid’]" mode="itemstyle">
من نیز کمی تغییر دهید به او پیشنهاد <XSL:و هر …> با اضافه کردن یک <برزیلی /> برچسب برای ارائه یک لیست پاک کننده:
<XSL:و هر را انتخاب کنید="@ *">
P:<XSL:ارزش را انتخاب کنید="نام()" /><برزیلی/>
</XSL:و هر>
4.2: من بخشی از وب را تغییر دهید, go to appearance and select my "Grid" سبک:
درخواست تغییر دهید و در اینجا نتیجه است:
ما می توانیم از بالا دید که مزارع ما می خواهیم (نام پروژه, هزینه, وضعیت, غیره) are available for us to use when we emit the HTML. Not only that, but we see the names by which we must reference those columns in the XSL. مثلا, we reference Project Status as "Project_x005F_x0020_Name".
در این مرحله, ما از وبلاگ هدر و از شانه ها از این غول های ترک, من من کمی خود را اضافه کنید.
ContentQueryMain.xsl
توجه: در هنگام ایجاد تغییرات به هر دو ContentQueryMain.xsl و همچنین ItemStyle.xsl, شما نیاز به چک کردن این فایل ها به پشت در قبل از اثر تغییرات خود شما.
به منظور استفاده از شبکه سازی, MOSS uses two different XSL files to produce the results we see from a CQWP. To generate the previous bit of output, we modified ItemStyle.xsl. MOSS actually uses another XSL file, ContentQueryMain.xsl to in conjunction with ItemStyle.xsl to generate its HTML. As its name implies, ContentQueryMain.xsl is the "main" XSL that controls the overall flow of translation. It iterates through all the found items and passes them one by one to templates in ItemStyle.xsl. We’ll modify ItemStyle.xsl to generate the open <جدول> برچسب قبل از انتشار اولین ردیف از داده ها و بسته شدن <جدول> tag after emitting the last row. To accomplish this, ContentQueryMain.xsl is modified to pass two parameters to our "grid" الگو در ItemStyle.xsl در, "last row" and "current row". ItemStyle.xsl uses these to conditionally emit the necessary tags.
با استفاده از روش هدر سلیمان, we locate ContentQueryMain.xsl. It is located in the same place as ItemStyle.xsl. This screen shot should help:
ما نیاز به ایجاد تغییرات زیر:
- اصلاح الگوی XSL, "CallItemTemplate" that actually invokes our Grid template in ItemStyle.xsl. We will pass two parameters to the Grid template so that it will have the data it needs to conditionally generate opening and closing <جدول> برچسب ها.
- Modify another bit of ContentQueryMain.xsl that calls the "CallItemTemplate" to pass it a "LastRow" پارامتر به طوری که LastRow ممکن است در به گرید قالب ما منتقل.
Locate the template named "OuterTemplate.CallItemTemplate" مشخص شده توسط رشته:
<XSL:قالب نام="OuterTemplate.CallItemTemplate">
به جای کل قالب به شرح زیر است:
|
|
<XSL:قالب نام="OuterTemplate.CallItemTemplate">
<XSL:پارامتر نام="CurPosition" />
<!--
Add the "LastRow" پارامتر.
We only use it when the item style pass in is "Grid".
-->
<XSL:پارامتر نام="LastRow" />
<XSL:را انتخاب کنید>
<XSL:وقتی که آزمون="@ سبک = 'NewsRollUpItem'">
<XSL:اعمال قالب را انتخاب کنید="." طرز="itemstyle">
<XSL:با پارامترها نام="EditMode" را انتخاب کنید="$cbq_iseditmode" />
</XSL:اعمال قالب>
</XSL:وقتی که>
<XSL:وقتی که آزمون="@ سبک = 'NewsBigItem'">
<XSL:اعمال قالب را انتخاب کنید="." طرز="itemstyle">
<XSL:با پارامترها نام="CurPos" را انتخاب کنید="$CurPosition" />
</XSL:اعمال قالب>
</XSL:وقتی که>
<XSL:وقتی که آزمون="@ سبک = 'NewsCategoryItem'">
<XSL:اعمال قالب را انتخاب کنید="." طرز="itemstyle">
<XSL:با پارامترها نام="CurPos" را انتخاب کنید="$CurPosition" />
</XSL:اعمال قالب>
</XSL:وقتی که>
<!--
رمز عبور موقعیت فعلی و lastrow را به شبکه قالب itemstyle.xsl.
ItemStyle.xsl استفاده خواهد کرد که منتشر می کنند باز و بسته شدن <جدول> برچسب ها.
-->
<XSL:وقتی که آزمون="@ سبک = 'شبکه'">
<XSL:اعمال قالب را انتخاب کنید="." طرز="itemstyle">
<XSL:با پارامترها نام="CurPos" را انتخاب کنید="$CurPosition" />
<XSL:با پارامترها نام="آخر" را انتخاب کنید="$LastRow" />
</XSL:اعمال قالب>
</XSL:وقتی که>
<XSL:وگرنه>
<XSL:اعمال قالب را انتخاب کنید="." طرز="itemstyle">
</XSL:اعمال قالب>
</XSL:وگرنه>
</XSL:را انتخاب کنید>
</XSL:قالب>
|
این سایت در مقابل نظرات و پیشنهادات هدف از این تغییرات را توصیف می.
البته, the "OuterTemplate.CallItemTemplate" is itself called from another template. Locate that template by searching for this text string:
<XSL:قالب نام="OuterTemplate.Body">
از طریق دستورالعمل در OuterTemplate.Body در بروید و وارد پارامتر LastRow را به شرح زیر است (به عنوان یک نظر در کج (ایتالیک) نشان داده شده است):
<XSL:تماس قالب نام="OuterTemplate.CallItemTemplate">
<XSL:با پارامترها نام="CurPosition" را انتخاب کنید="$CurPosition" />
<!-- قرار دادن پارامتر LastRow. -->
<XSL:با پارامترها نام="LastRow" را انتخاب کنید="$LastRow"/>
</XSL:تماس قالب>
بعد از همه این, ما در نهایت همه چیز به درستی راه اندازی به طوری که ItemStyle.xsl ما می منتشر می کنند <جدول> برچسب در جای مناسب.
ItemStyle.Xsl
توجه: دوباره, بررسی در ItemStyle.xsl پس از ساخت هر گونه تغییرات به طوری که می بینید اثر این تغییرات.
ما دو وظایف در اینجا:
- Replace the entire Grid template. You can copy/paste from below.
- Add some mumbo jumbo outside the template definition that enables "formatcurrency" template to work. (شما می توانید بگویید که من یک دسته شکننده در XSL).
اولین, در نزدیکی بالای ItemStyle.xsl به, اضافه کردن این خط:
<!-- برخی از سخنان نامفهوم را قادر می سازد که ما را به نمایش U.S. پول. -->
<XSL:فرمت اعشاری نام="کارکنان" رقم="D" />
<XSL:قالب نام="قصور" مسابقه="*" طرز="itemstyle">
توجه داشته باشید که من آن را به طور مستقیم قبل از ارسال <XSL:template name="Default" …> تعریف.
بعد, go back to our Grid template. Replace the entire Grid template with the code below. It is thoroughly commented, اما دریغ نکنید به من ایمیل و یا نظر در وبلاگ من اگر سوالی دارید.
|
|
<XSL:قالب نام="توری" مسابقه="ردیف[@ سبک = 'شبکه']" طرز="itemstyle">
<!--
ContentMain.xsl عبور CurPos و آخرین.
ما با استفاده از این مشروط منتشر می کنند باز و بسته شدن <جدول> برچسب ها.
-->
<XSL:پارامتر نام="CurPos" />
<XSL:پارامتر نام="آخر" />
<!-- متغیر های زیر را از ItemStyle.xsl استاندارد نیافته -->
<XSL:متغیر نام="SafeImageUrl">
<XSL:تماس قالب نام="OuterTemplate.GetSafeStaticUrl">
<XSL:با پارامترها نام="UrlColumnName" را انتخاب کنید="'آدرس تصویر'"/>
</XSL:تماس قالب>
</XSL:متغیر>
<XSL:متغیر نام="SafeLinkUrl">
<XSL:تماس قالب نام="OuterTemplate.GetSafeLink">
<XSL:با پارامترها نام="UrlColumnName" را انتخاب کنید="LinkUrl '"/>
</XSL:تماس قالب>
</XSL:متغیر>
<XSL:متغیر نام="DisplayTitle">
<XSL:تماس قالب نام="OuterTemplate.GetTitle">
<XSL:با پارامترها نام="عنوان" را انتخاب کنید="@ عنوان"/>
<XSL:با پارامترها نام="UrlColumnName" را انتخاب کنید="LinkUrl '"/>
</XSL:تماس قالب>
</XSL:متغیر>
<XSL:متغیر نام="LinkTarget">
<XSL:اگر آزمون="@ OpenInNewWindow = 'واقعی'" >_blank</XSL:اگر>
</XSL:متغیر>
<!--
در اینجا یک متغیر تعریف کنیم, "tableStart". این شامل HTML غیر فعال است
. توجه داشته باشید که اگر CurPos = 1, آن شامل HTML در یک تگ CDATA.
وگرنه, آن را خالی خواهد بود.
ارزش tableStart emited هر زمان ItemStyle از طریق نام
.
-->
<XSL:متغیر نام="tableStart">
<XSL:اگر آزمون="$CurPos = 1">
<![CDATA[
<مرز جدول = 1>
<tr bgcolor="blue">
<فلش><font color="white"><ب>نام پروژه</ب></فونت></فلش>
<td align="right"><font color="white"><ب>کامل عضویت</ب></فونت></فلش>
<td align="right"><font color="white"><ب>بودجه</ب></فونت></فلش>
<td align="right"><font color="white"><ب>هزینه های واقعی</ب></فونت></فلش>
<فلش><font color="white"><ب>وضعیت کل</ب></فونت></فلش>
</TR>
]]>
</XSL:اگر>
</XSL:متغیر>
<!--
متغیر دیگر, tableEnd به سادگی تعریف جدول از تگ بسته شدن.
همانطور که با tableStart, آن همیشه emited شده. به همین دلیل است که ارزش آن است
.
-->
<XSL:متغیر نام="tableEnd">
<XSL:اگر آزمون="$CurPos = $ آخرین">
<![CDATA[ </جدول> ]]>
</XSL:اگر>
</XSL:متغیر>
<!--
همیشه محتویات tableStart را منتشر می کنند. اگر این اولین بار نیست
, سپس ما می دانیم که ارزش خود را
.
غیر فعال کردن خروجی فرار به دلیل هنگامی که tableStart آن را خالی نیست, آن
. اگر
, it will generate
stuff like "<جدول&پیداکنید;" instead of "<جدول>".
-->
<XSL:ارزش را انتخاب کنید="$tableStart" غیر فعال کردن خروجی فرار="بله"/>
<TR>
<!--
P:Project_x005F_x0020_Name
:Project_x005F_x0020_End_x005F_x0020_Date
:Project_x005F_x0020_Budget
:Project_x005F_x0020_Expenses
:Project_x005F_x0020_Status
-->
<فلش>
<XSL:ارزش را انتخاب کنید="@ Project_x005F_x0020_Name،"/>
</فلش>
<فلش ردیف کردن="راست">
<XSL:ارزش را انتخاب کنید="@ Project_x005F_x0020_End_x005F_x0020_Date،"/>
</فلش>
<فلش ردیف کردن="راست">
<XSL:تماس قالب نام="formatcurrency">
<XSL:با پارامترها نام="ارزش"
را انتخاب کنید="@ Project_x005F_x0020_Budget،"></XSL:با پارامترها>
</XSL:تماس قالب>
</فلش>
<فلش ردیف کردن="راست">
<XSL:تماس قالب نام="formatcurrency">
<XSL:با پارامترها نام="ارزش" را انتخاب کنید="@ Project_x005F_x0020_Expenses ها">
</XSL:با پارامترها>
</XSL:تماس قالب>
</فلش>
<فلش>
<XSL:ارزش را انتخاب کنید="@ Project_x005F_x0020_Status،"/>
</فلش>
<!--
همه از موارد زیر است نظر به توضیح این چیزها.
اما, آوردن آن به عقب و چیزهای آن را به یک <فلش> برای دیدن آن
.
-->
<!--
<div id="linkitem" class="item">
<XSL:if test="string-length($SafeImageUrl) != 0">
<div class="image-area-left">
<a href="{$SafeLinkUrl}" target="{$LinkTarget}">
<img class="image-fixed-width" src="{$SafeImageUrl}"
alt="{@ ImageUrlAltText،}"/>
</a>
</DIV>
</XSL:اگر>
<div class="link-item">
<XSL:تماس قالب
name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<a href="{$SafeLinkUrl}"
target="{$LinkTarget}" title="{@ LinkToolTip،}">
<XSL:value-of select="$DisplayTitle"/>
</a>
<div class="description">
<XSL:value-of select="@Description" />
</DIV>
</DIV>
</DIV>
-->
</TR>
<!--
منتشر می کنند برچسب جدول بسته شدن. اگر ما در ردیف آخر,
این خالی خواهد بود.
-->
<XSL:ارزش را انتخاب کنید="$tableEnd" غیر فعال کردن خروجی فرار="بله"/>
</XSL:قالب>
<XSL:قالب نام="formatcurrency">
<XSL:پارامتر نام="ارزش" را انتخاب کنید="0" />
<XSL:ارزش را انتخاب کنید='فرمت شماره($ارزش, "$DDD,DDD,DDD.DD", "staff")' />
</XSL:قالب>
|
