Overview եւ օբյեկտիվ
Դուրս վանդակում, MOSS’ Content Հարցման Web Part (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 նման առաջացնում այդ արդյունքը:
|
<html>
<մարմին>
<կենտրոն>
<սեղան սահման= 1>
<!-- Պիտակներ ->
<TR bgcolor= Կապույտ>
<TD><տառ գույն= Սպիտակ><բ>Ծրագրի անվանումը</բ></տառ></TD>
<TD շարել= Իրավունք><տառ գույն= Սպիտակ><բ>Լրացրեք ամսաթիվ</բ></տառ></TD>
<TD շարել= Իրավունք><տառ գույն= Սպիտակ><բ>Բյուջե</բ></տառ></TD>
<TD շարել= Իրավունք><տառ գույն= Սպիտակ><բ>Փաստացի Ծախսերի</բ></տառ></TD>
<TD><տառ գույն= Սպիտակ><բ>Ընդհանուր Status</բ></տառ></TD>
</TR>
<TR>
<TD>Re-մետաղալար համակարգչային սենյակ.</TD>
<TD շարել= Իրավունք>02/01/08</TD>
<TD շարել= Իրավունք>22,500.00</TD>
<TD շարել= Իրավունք>19,000.00</TD>
<TD>Ընթացքում</TD>
</TR>
<TR>
<TD>Տրամադրում սերվերներ եւ SQL նորոգման</TD>
<TD շարել= Իրավունք>04/01/08</TD>
<TD շարել= Իրավունք>7,500.00</TD>
<TD շարել= Իրավունք>0.00</TD>
<TD>Նախատեսվում</TD>
</TR>
</սեղան>
</կենտրոն>
</մարմին>
</html>
|
Մոտեցում
Հետեւեք այս քայլերին, ստեղծել ցանց:
- Որոշել են բաղադրիչները ցանցին (տող / սյուներ).
- Սահմանել եւ ստեղծել անհրաժեշտ Տեղում սյունյակները.
- Ստեղծել ենթածրագրեր կայքերը համար նախագծերի եւ SINGLETON ցուցակները.
- Ավելացնել CQWP դեպի ինտերնետային էջի եւ կարգավորել այն որոնել ձեր ցուցակներում.
- Փոփոխությունները CQWP ի մասին XML Նամակ հավաքել մինչեւ լրացուցիչ սյունյակները.
- Փոփոխությունները 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) եւ Heather Սողոմոն բլոգում այստեղ (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
Ընկույզներ եւ Հեղյուսներ
Սկիզբ եւ իրականացնել քայլեր, մեկ է հինգ ըստ MSDN փաստաթղթերի եւ Heather Սողոմոնի հոդվածը.
Այս պահին, դու ավելացրել ձեր CQWP նշված էջը եւ դուք պետք է ձեր <CommonViewFields> կազմաձեւված անհրաժեշտ.
Հետեւելով սովորական քայլերը, Ես այդ միջանկյալ արդյունքները:
1. Ստեղծել բովանդակության տեսակը, a templatized custom list for that content type and two sites. Here is the content type:
Ահա կայքը կառուցվածքը:
2. Ավելացնել CQWP հետո ստեղծելու իմ ծրագրերի subsites եւ SINGLETON ծրագրերի ամփոփ ցուցակները:
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:համար յուրաքանչյուր …> ավելացնելով ա <BR /> պիտակների ապահովել մաքուր ցուցակման:
<xsl:համար յուրաքանչյուր ընտրել="@ *">
P:<xsl:արժեք է ընտրել="անուն()" /><BR/>
</xsl:համար յուրաքանչյուր>
4.2: Ես փոփոխությունները վեբ մասը, go to appearance and select my "Grid" ոճ:
Դիմել փոփոխությունը, եւ այստեղ է արդյունք:
Մենք կարող ենք տեսնել, որ վերը նշված, որ մենք ուզում ենք fields (Ծրագրի անվանումը, ծախսեր, կարգավիճակ, եւ այլն:) 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".
Այս պահին, Մենք հեռանում Heather բլոգում եւ ուսերին այդ հսկաների ուսերին, Ես իմ սեփական փոքր.
ContentQueryMain.xsl
Նկատի ունեցեք,: Երբ փոփոխություններ կատարելու եւ ContentQueryMain.xsl նաեւ ItemStyle.xsl, դուք պետք է ստուգել այդ ֆայլերը ետ փակցնելու տեսնում ազդեցությունը ձեր փոփոխությունների.
For ցանցը կայացման նպատակով, 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 <սեղան> Պիտակ առաջ emitting առաջին շարքում տվյալների եւ փակման <սեղան> 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.
Օգտագործելով Heather Սողոմոնի տեխնիկա, 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 <սեղան> Tags.
- 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:Param անուն="CurPosition" />
<!--
Add the "LastRow" պարամետր.
We only use it when the item style pass in is "Grid".
-->
<xsl:Param անուն="LastRow" />
<xsl:ընտրել>
<xsl:երբ փորձարկում="@ Style = 'NewsRollUpItem.">
<xsl:դիմում - կաղապարներ ընտրել="." ռեժիմ="itemstyle">
<xsl:հետ-Param անուն="EditMode" ընտրել="$cbq_iseditmode" />
</xsl:դիմում - կաղապարներ>
</xsl:երբ>
<xsl:երբ փորձարկում="@ Style = 'NewsBigItem.">
<xsl:դիմում - կաղապարներ ընտրել="." ռեժիմ="itemstyle">
<xsl:հետ-Param անուն="CurPos" ընտրել="$CurPosition" />
</xsl:դիմում - կաղապարներ>
</xsl:երբ>
<xsl:երբ փորձարկում="@ Style = 'NewsCategoryItem.">
<xsl:դիմում - կաղապարներ ընտրել="." ռեժիմ="itemstyle">
<xsl:հետ-Param անուն="CurPos" ընտրել="$CurPosition" />
</xsl:դիմում - կաղապարներ>
</xsl:երբ>
<!--
Pass ներկայիս դիրքորոշումը եւ lastrow են Ցանց itemstyle.xsl Կաղապար.
ItemStyle.xsl կօգտագործեն որ արտադրել բաց եւ փակման <սեղան> Tags.
-->
<xsl:երբ փորձարկում="@ Style = 'Ցանց'">
<xsl:դիմում - կաղապարներ ընտրել="." ռեժիմ="itemstyle">
<xsl:հետ-Param անուն="CurPos" ընտրել="$CurPosition" />
<xsl:հետ-Param անուն="Անցյալ" ընտրել="$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:Call-ձեւանմուշ անուն="OuterTemplate.CallItemTemplate">
<xsl:հետ-Param անուն="CurPosition" ընտրել="$CurPosition" />
<!-- Տեղադրեք LastRow պարամետր. -->
<xsl:հետ-Param անուն="LastRow" ընտրել="$LastRow"/>
</xsl:Call-ձեւանմուշ>
Ի վերջո, այս, Մենք վերջապես պետք է ամեն ինչ ստեղծվել է, ճիշտ այնպես, որ մեր ItemStyle.xsl կարող է արտադրել <սեղան> tags է ճիշտ տեղում.
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, ավելացրեք այս տողը:
<!-- Ոմանք mumbo Jumbo որը հնարավորություն է տալիս մեզ դրսեւորել U.S. արժույթը. -->
<xsl:Decimal-format անուն="անձնակազմ" նիշ="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:Կաղապար անուն="Ցանց" համընկնում="Շարք[@ Style = 'Ցանց']" ռեժիմ="itemstyle">
<!--
ContentMain.xsl անցնում CurPos եւ Վերջինը.
Մենք օգտագործում ենք դրանք պայմանականորեն արտադրել է բաց եւ փակման <սեղան> Tags.
-->
<xsl:Param անուն="CurPos" />
<xsl:Param անուն="Անցյալ" />
<!-- Հետեւյալ փոփոխականներ են հարմարեցված են ստանդարտ ItemStyle.xsl -->
<xsl:փոփոխական մեծություն անուն="SafeImageUrl">
<xsl:Call-ձեւանմուշ անուն="OuterTemplate.GetSafeStaticUrl">
<xsl:հետ-Param անուն="UrlColumnName" ընտրել="'ImageUrl'"/>
</xsl:Call-ձեւանմուշ>
</xsl:փոփոխական մեծություն>
<xsl:փոփոխական մեծություն անուն="SafeLinkUrl">
<xsl:Call-ձեւանմուշ անուն="OuterTemplate.GetSafeLink">
<xsl:հետ-Param անուն="UrlColumnName" ընտրել="'LinkUrl'"/>
</xsl:Call-ձեւանմուշ>
</xsl:փոփոխական մեծություն>
<xsl:փոփոխական մեծություն անուն="DisplayTitle">
<xsl:Call-ձեւանմուշ անուն="OuterTemplate.GetTitle">
<xsl:հետ-Param անուն="Վերնագիր" ընտրել="@ Վերնագիրը"/>
<xsl:հետ-Param անուն="UrlColumnName" ընտրել="'LinkUrl'"/>
</xsl:Call-ձեւանմուշ>
</xsl:փոփոխական մեծություն>
<xsl:փոփոխական մեծություն անուն="LinkTarget">
<xsl:եթե փորձարկում="@ OpenInNewWindow = 'True." >_blank</xsl:եթե>
</xsl:փոփոխական մեծություն>
<!--
Այստեղ մենք սահմանել է փոփոխական, "tableStart". Սա պարունակում է HTML
. Նշենք, որ եթե CurPos = 1, այն ներառում է HTML մի CDATA tag.
Այլապես, դա կլինի դատարկ.
Արժեքը tableStart է emited ամեն անգամ ItemStyle կոչվում միջոցով
.
-->
<xsl:փոփոխական մեծություն անուն="tableStart">
<xsl:եթե փորձարկում="$CurPos = 1">
<![CDATA[
<Աղյուսակ սահմանը = 1>
<tr bgcolor="blue">
<TD><font color="white"><բ>Ծրագրի անվանումը</բ></տառ></TD>
<td align="right"><font color="white"><բ>Լրացրեք ամսաթիվ</բ></տառ></TD>
<td align="right"><font color="white"><բ>Բյուջե</բ></տառ></TD>
<td align="right"><font color="white"><բ>Փաստացի Ծախսերի</բ></տառ></TD>
<TD><font color="white"><բ>Ընդհանուր Status</բ></տառ></TD>
</TR>
]]>
</xsl:եթե>
</xsl:փոփոխական մեծություն>
<!--
Another փոփոխական, 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
-->
<TD>
<xsl:արժեք է ընտրել="@ Project_x005F_x0020_Name"/>
</TD>
<TD շարել="իրավունք">
<xsl:արժեք է ընտրել="@ Project_x005F_x0020_End_x005F_x0020_Date"/>
</TD>
<TD շարել="իրավունք">
<xsl:Call-ձեւանմուշ անուն="formatcurrency">
<xsl:հետ-Param անուն="արժեք" ընտրել="@ Project_x005F_x0020_Budget"></xsl:հետ-Param>
</xsl:Call-ձեւանմուշ>
</TD>
<TD շարել="իրավունք">
<xsl:Call-ձեւանմուշ անուն="formatcurrency">
<xsl:հետ-Param անուն="արժեք" ընտրել="@ Project_x005F_x0020_Expenses"> </xsl:հետ-Param>
</xsl:Call-ձեւանմուշ>
</TD>
<TD>
<xsl:արժեք է ընտրել="@ Project_x005F_x0020_Status"/>
</TD>
<!--
Բոլոր Հետեւյալ մեկնաբանել է հստակեցնել բաներ.
Սակայն, բերել այն ետ եւ այլեւայլով այն <TD> տեսնել իր
.
-->
<!--
<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}"/>
</ա>
</div>
</xsl:եթե>
<div class="link-item">
<xsl:Call-ձեւանմուշ name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@ LinkToolTip}">
<xsl:value-of select="$DisplayTitle"/>
</ա>
<div class="description">
<xsl:value-of select="@Description" />
</div>
</div>
</div>
-->
</TR>
<!--
Արտադրել փակման սեղան հատկորոշիչը. Եթե մենք չենք վերջին շարքում,
դա կլինի դատարկ.
-->
<xsl:արժեք է ընտրել="$tableEnd" անջատել, արտադրանքի, փախչող="այո"/>
</xsl:Կաղապար>
<xsl:Կաղապար անուն="formatcurrency">
<xsl:Param անուն="արժեք" ընտրել="0" />
<xsl:արժեք է ընտրել='ֆորմատ, թիվ($արժեք, "$DDD,DDD,DDD.DD", "staff")' />
</xsl:Կաղապար>
|