Overblik og mål
Ud af boksen, MOSS’ Webdelen til indholdsforespørgsel (CQWP) viser sine resultater i en listeformat, ligner søgeresultater. Det er også muligt at få vist resultaterne i et gitter format (dvs. HTML-tabelformat). Gitter formater er bedre i nogle tilfælde. Jeg beskriver hvordan man opnår effekten i denne artikel.
Forretningsscenario
Jeg har arbejdet med en klienten på en enterprise-wide MOSS udrulningen. Vi har designet deres taksonomi, således at projekter er første klasses borgere i hierarkiet og har deres eget websted på øverste niveau. Projektledere opretholde en singleton liste over projekt oversigtsoplysninger, som titlen, budget, forventet afslutningsdato, resterende budget og andre opsummeringstype felter. Ved "singleton" Jeg mener en brugerdefineret SharePoint-liste garanteret indeholder kun ét element. Simplistisk, Det ser sådan ud:
Den tekniske tilgang er meget det samme som beskrevet Her (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!447.entry). CQWP bruger en XSL-transformering til at udlede HTML for browseren at gengive.
Jeg forestille altid resultatet før dykke ned i XSL, fordi XSL er et mareridt. Her er min ønskede resultat:
HTML som dette genererer som følge:
|
<HTML>
<kroppen>
<Center>
<tabel grænsen= 1>
<!-- Etiketter-->
<Tr BgColor= blå>
<TD><skrifttype farve= hvid><b>Projektnavn</b></skrifttype></TD>
<TD Juster= højre><skrifttype farve= hvid><b>Komplet dato</b></skrifttype></TD>
<TD Juster= højre><skrifttype farve= hvid><b>Budget</b></skrifttype></TD>
<TD Juster= højre><skrifttype farve= hvid><b>Faktiske udgift</b></skrifttype></TD>
<TD><skrifttype farve= hvid><b>Overordnede Status</b></skrifttype></TD>
</Tr>
<Tr>
<TD>Re-wire edb-rum.</TD>
<TD Juster= højre>02/01/08</TD>
<TD Juster= højre>22,500.00</TD>
<TD Juster= højre>19,000.00</TD>
<TD>I gang</TD>
</Tr>
<Tr>
<TD>Bestemmelse servere for SQL Upgrade</TD>
<TD Juster= højre>04/01/08</TD>
<TD Juster= højre>7,500.00</TD>
<TD Juster= højre>0.00</TD>
<TD>Planlagt</TD>
</Tr>
</tabel>
</Center>
</kroppen>
</HTML>
|
Tilgang
Følg disse trin for at oprette gitteret:
- Identificere komponenter i gitteret (rækker/kolonner).
- Definere og oprette nødvendige webstedskolonner.
- Oprette sub websteder for projekter og singleton lister.
- Tilføje en CQWP til en webside og konfigurere den til at søge efter dine lister.
- Ændre den CQWP XML til at samle op på de yderligere kolonner.
- Redigere XSL-koden for at generere en tabel.
Jeg vil koncentrere mig om nummer seks. Tal en gennem fire er ligetil og noget, som enhver CQWP bruger allerede har gjort. Nummer fem er blevet veldokumenteret af andre, herunder denne udtømmende skærmbillede belæsset artikel fra MSDN Her (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) og Heather Solomon's blog Her (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
Møtrikker og bolte
Indlede og gennemføre trin et til fem ifølge dokumentationen til MSDN og Heather Solomons artikel.
På dette punkt, du har tilføjet din CQWP til siden og du har din <CommonViewFields> konfigureret efter behov.
Efter de sædvanlige fremgangsmåde, Jeg får disse mellemliggende resultater:
1. Opret en indholdstype, en templatized brugerdefineret liste for denne indholdstype og to websteder. Her er den type indhold:
Her er lokationsstrukturen:
2. Tilføj CQWP efter at skabe mit projekt underordnede websteder og singleton projekt sammenfattende lister:
3. Tilføj alle de yderligere oplysninger, vil jeg via den <CommonViewFields>:
<Egenskaben Navn="CommonViewFields" type="streng">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</Egenskaben>
Bemærk, at jeg var nødt til at holde alle egenskabsfelter på én linje, eller det ville ikke arbejde (CQWP ville fortælle mig, at forespørgslen returnerede ingen emner).
4. På dette punkt, Vi er klar til at bevæge sig ud over i MSDN-artiklen og flip på over til Heather Solomons artikel. Følg hende trin starter i nærheden af trin #5 oprette en tilpasset / unghosted version af ItemStyle.xsl. Jeg følger Heathers rådgivning, op gennem skridt 11 og få disse mellemliggende resultater:
4.1: Nævne min XSL-skabelon som følger:
<XSL:skabelonnavn = "gitter" matche = "træk[@Style = 'Grid']" mode = "itemstyle">
Jeg ændre også lidt hende foreslog <XSL:for hver …> ved at tilføje en <BR /> Tag til at give et renere notering:
<XSL:for hver Vælg="@*">
P:<XSL:værdi af Vælg="Navn()" /><br/>
</XSL:for hver>
4.2: Jeg redigere webdelen, gå til udseende og vælge mine "gitter" stil:
Anvende ændringen og her er resultatet:
Vi kan se fra ovenstående, at felterne, vi vil (Projektnavn, udgift, status, osv) er tilgængelige for os at bruge, når vi udsender HTML. Ikke kun det, men vi se de navne, som vi skal henvise til disse kolonner i XSL. For eksempel, Vi henviser til projektets Status som "Project_x005F_x0020_Name".
På dette punkt, Vi afgår fra Heather's blog og fra skuldrene af disse giganter, Jeg tilføje min egen lille smule.
ContentQueryMain.xsl
NOTE: Når du foretager ændringer til både ContentQueryMain.xsl og ItemStyle.xsl, Du skal tjekke disse filer tilbage i, før du kan se effekten af dine ændringer.
Henblik på nettet-gøre, MOSS bruger to forskellige XSL-filer til at producere de resultater, vi ser fra en CQWP. Til at generere den tidligere bit output, Vi ændrede ItemStyle.xsl. MOSS bruger faktisk en anden XSL-fil, ContentQueryMain.xsl til i forbindelse med ItemStyle.xsl til at generere sin HTML. Som navnet antyder, ContentQueryMain.xsl er "vigtigste" XSL, der styrer den samlede strøm af Oversættelse. Det gentager listen over alle de fundne genstande og passerer dem én efter én til skabeloner i ItemStyle.xsl. Vi vil ændre ItemStyle.xsl for at generere åbne <tabel> Tag før udsender den første række af data og lukning <tabel> Tag efter udsender den sidste række. At opnå dette, ContentQueryMain.xsl er ændret for at passere to parametre til vores "gitter" skabelon i ItemStyle.xsl, "sidste række" og "aktuel række". ItemStyle.xsl bruger disse betinget udleder de nødvendige tags.
Ved hjælp af Heather Solomon teknik, vi finde ContentQueryMain.xsl. Det er beliggende i samme sted som ItemStyle.xsl. Dette skærmbillede bør hjælpe:
Vi har brug for at foretage følgende ændringer:
- Ændre en XSL-skabelon, "CallItemTemplate" der faktisk påberåber sig vores gitter skabelon i ItemStyle.xsl. Vi vil passere to parametre til skabelonen gitter, således at det får de data, det skal generere betinget åbning og lukning <tabel> Tags.
- Ændre en anden lidt af ContentQueryMain.xsl, der kalder "CallItemTemplate" at give den en "LastRow" parameter, således at LastRow kan blive videregivet til vores gitter skabelon.
Find den skabelon opkaldt "OuterTemplate.CallItemTemplate" identificeret af strengen:
<XSL:skabelon Navn="OuterTemplate.CallItemTemplate">
Erstatte hele skabelonen som følger:
|
<XSL:skabelon Navn="OuterTemplate.CallItemTemplate">
<XSL:Param Navn="CurPosition" />
<!--
Tilføj "LastRow" parameter.
Vi kun bruger det når varen stil pass i er "Grid".
-->
<XSL:Param Navn="LastRow" />
<XSL:Vælg>
<XSL:Hvornår test="@Style = 'NewsRollUpItem'">
<XSL:anvende skabeloner Vælg="." mode="itemstyle">
<XSL:med param Navn="EditMode" Vælg="$cbq_iseditmode" />
</XSL:anvende skabeloner>
</XSL:Hvornår>
<XSL:Hvornår test="@Style = 'NewsBigItem'">
<XSL:anvende skabeloner Vælg="." mode="itemstyle">
<XSL:med param Navn="CurPos" Vælg="$CurPosition" />
</XSL:anvende skabeloner>
</XSL:Hvornår>
<XSL:Hvornår test="@Style = 'NewsCategoryItem'">
<XSL:anvende skabeloner Vælg="." mode="itemstyle">
<XSL:med param Navn="CurPos" Vælg="$CurPosition" />
</XSL:anvende skabeloner>
</XSL:Hvornår>
<!--
Pass aktuelle position og lastrow gitter itemstyle.xsl skabelon.
ItemStyle.xsl vil bruge det til at udlede åbne og lukke <tabel> Tags.
-->
<XSL:Hvornår test="@Style = 'Grid'">
<XSL:anvende skabeloner Vælg="." mode="itemstyle">
<XSL:med param Navn="CurPos" Vælg="$CurPosition" />
<XSL:med param Navn="Seneste" Vælg="$LastRow" />
</XSL:anvende skabeloner>
</XSL:Hvornår>
<XSL:ellers>
<XSL:anvende skabeloner Vælg="." mode="itemstyle">
</XSL:anvende skabeloner>
</XSL:ellers>
</XSL:Vælg>
</XSL:skabelon>
|
Kommentarer beskriver formålet med ændringerne.
Selvfølgelig, "OuterTemplate.CallItemTemplate" hedder sig selv fra en anden skabelon. Find skabelonen ved at søge efter denne tekststreng:
<XSL:skabelon Navn="OuterTemplate.Body">
Gennemse vejledningen i OuterTemplate.Body og indsætte parameteren LastRow som følger (vist som en kommentar i kursiv):
<XSL:Call-skabelon Navn="OuterTemplate.CallItemTemplate">
<XSL:med param Navn="CurPosition" Vælg="$CurPosition" />
<!-- Indsætte parameteren LastRow. -->
<XSL:med param Navn="LastRow" Vælg="$LastRow"/>
</XSL:Call-skabelon>
Efter alt dette, Endelig har vi ting sat rigtigt op, således at vores ItemStyle.xsl kan udsende <tabel> Tags på det rigtige sted.
ItemStyle.Xsl
NOTE: Igen, Tjek i ItemStyle.xsl efter at gøre eventuelle ændringer, så du kan se effekten af ændringerne.
Vi har to opgaver her:
- Erstatte skabelonen hele gitteret. Du kan kopiere/indsætte nedefra.
- Tilføje nogle mumbo jumbo udenfor skabelondefinitionen, der giver mulighed for "formatcurrency" skabelon til arbejde. (Du kan fortælle, at jeg har en svag håndtag på XSL).
Første, nær toppen af ItemStyle.xsl, Tilføj denne linje:
<!-- Nogle mumbo jumbo, der gør det muligt for os at vise os. valuta. -->
<XSL:decimal-format Navn="personale" ciffer="D" />
<XSL:skabelon Navn="Standard" match="*" mode="itemstyle">
Bemærk at jeg tilføjede det direkte før den <XSL:skabelonnavn = "standard" …> definition.
Næste, gå tilbage til vores gitter skabelon. Erstatte skabelonen hele gitteret med koden nedenfor. Det er grundigt kommenterede, men tøv ikke med at email mig eller efterlade kommentarer på min blog, hvis du har spørgsmål.
|
<XSL:skabelon Navn="Gitter" match="Række[@Style = 'Grid']" mode="itemstyle">
<!--
ContentMain.xsl passerer CurPos og sidste.
Vi bruger disse til betinget udsender åbne og lukke <tabel> Tags.
-->
<XSL:Param Navn="CurPos" />
<XSL:Param Navn="Seneste" />
<!-- Følgende variabler er uændret fra den standard ItemStyle.xsl -->
<XSL:variabel Navn="SafeImageUrl">
<XSL:Call-skabelon Navn="OuterTemplate.GetSafeStaticUrl">
<XSL:med param Navn="UrlColumnName" Vælg="'ImageUrl'"/>
</XSL:Call-skabelon>
</XSL:variabel>
<XSL:variabel Navn="SafeLinkUrl">
<XSL:Call-skabelon Navn="OuterTemplate.GetSafeLink">
<XSL:med param Navn="UrlColumnName" Vælg="'LinkUrl'"/>
</XSL:Call-skabelon>
</XSL:variabel>
<XSL:variabel Navn="DisplayTitle">
<XSL:Call-skabelon Navn="OuterTemplate.GetTitle">
<XSL:med param Navn="Titel" Vælg="@Title"/>
<XSL:med param Navn="UrlColumnName" Vælg="'LinkUrl'"/>
</XSL:Call-skabelon>
</XSL:variabel>
<XSL:variabel Navn="LinkTarget">
<XSL:Hvis test="@OpenInNewWindow = "True"" >_blank</XSL:Hvis>
</XSL:variabel>
<!--
Her definere vi en variabel, "tableStart". Dette indeholder HTML-koden, som vi bruger til at definere åbningen af tabellen samt kolonneetiketterne. Bemærk, at hvis CurPos = 1, Det indeholder HTML-koden i et CDATA-tag.
Ellers, det vil være tom.
Værdien af tableStart er emited hver gang ItemStyle kaldes via ContentQueryMain.xsl.
-->
<XSL:variabel Navn="tableStart">
<XSL:Hvis test="$CurPos = 1">
<![CDATA[
<tabel border = 1>
<TR bgcolor = "blå">
<TD><font color = "hvid"><b>Projektnavn</b></skrifttype></TD>
<TD align = "right"><font color = "hvid"><b>Komplet dato</b></skrifttype></TD>
<TD align = "right"><font color = "hvid"><b>Budget</b></skrifttype></TD>
<TD align = "right"><font color = "hvid"><b>Faktiske udgift</b></skrifttype></TD>
<TD><font color = "hvid"><b>Overordnede Status</b></skrifttype></TD>
</Tr>
]]>
</XSL:Hvis>
</XSL:variabel>
<!--
En anden variabel, tableEnd simpelthen definerer afsluttende tabel tag.
Som med tableStart, Det er altid emited. Dette er grunden til, at dens værdi er tildelt betinget baseret på om vi har været forbi den sidste række ContentQueryMain.xsl.
-->
<XSL:variabel Navn="tableEnd">
<XSL:Hvis test="$CurPos = $Last">
<![CDATA[ </tabel> ]]>
</XSL:Hvis>
</XSL:variabel>
<!--
Altid udsende indholdet af tableStart. Hvis dette ikke er den første række videre til os af ContentQueryMain.xsl, så vi ved dens værdi bliver tom.
Deaktiverer output flygter fordi når tableStart det ikke tom, Det omfatter faktiske HTML, som vi ønsker skal gengives af browseren. Hvis vi ikke fortæller output XSL-parseren til at deaktivere flygter, det vil generere ting som"<tabel>" i stedet for"<tabel>".
-->
<XSL:værdi af Vælg="$tableStart" Deaktiver-output-undslippe="Ja"/>
<Tr>
<!--
P:Project_x005F_x0020_Name Pedersen:Project_x005F_x0020_End_x005F_x0020_Date Pedersen:Project_x005F_x0020_Budget Pedersen:Project_x005F_x0020_Expenses Pedersen:Project_x005F_x0020_Status
-->
<TD>
<XSL:værdi af Vælg="@Project_x005F_x0020_Name"/>
</TD>
<TD Juster="højre">
<XSL:værdi af Vælg="@Project_x005F_x0020_End_x005F_x0020_Date"/>
</TD>
<TD Juster="højre">
<XSL:Call-skabelon Navn="FormatCurrency">
<XSL:med param Navn="værdi" Vælg="@Project_x005F_x0020_Budget"></XSL:med param>
</XSL:Call-skabelon>
</TD>
<TD Juster="højre">
<XSL:Call-skabelon Navn="FormatCurrency">
<XSL:med param Navn="værdi" Vælg="@Project_x005F_x0020_Expenses"> </XSL:med param>
</XSL:Call-skabelon>
</TD>
<TD>
<XSL:værdi af Vælg="@Project_x005F_x0020_Status"/>
</TD>
<!--
Alle de følgende er kommenteret ud for at afklare tingene.
Dog, Bring det tilbage og kram det ind i en <TD> at se dets effekt.
-->
<!--
<div id = "linkitem" Class = "element">
<XSL:Hvis test = "strenglængde($SafeImageUrl) != 0">
<div class = "billede-området-venstre">
<en href = "{$SafeLinkUrl}" Target = "{$LinkTarget}">
<IMG class = "billede-fast-bredde" src = "{$SafeImageUrl}" alt = "{@ImageUrlAltText}"/>
</en>
</div>
</XSL:Hvis>
<div class = "link-vare">
<XSL:Call-skabelon Name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<en href = "{$SafeLinkUrl}" Target = "{$LinkTarget}" title = "{@LinkToolTip}">
<XSL:værdien af Vælg = "$DisplayTitle" />
</en>
<div class = "beskrivelse">
<XSL:værdien af select="@Description" />
</div>
</div>
</div>
-->
</Tr>
<!--
Udsender afsluttende tabel tag. Hvis vi ikke er på den sidste række,
Dette vil være tom.
-->
<XSL:værdi af Vælg="$tableEnd" Deaktiver-output-undslippe="Ja"/>
</XSL:skabelon>
<XSL:skabelon Navn="FormatCurrency">
<XSL:Param Navn="værdi" Vælg="0" />
<XSL:værdi af Vælg='format-nummer($værdi, "$DDD,DDD,DDD. DD", "personale")' />
</XSL:skabelon>
|