Privire de ansamblu şi obiectivul
Afară de la cutie, MOSS’ Conţinut parte de interogare Web (CQWP) afişează rezultatele sale într-un format listă, similar cu rezultatele căutării. De asemenea, este posibil să afişaţi rezultatele în format grilă (adică. Format de tabel HTML). Grila formate sunt mai bine în anumite circumstanţe. Descrie modul de a realiza acest efect în acest articol.
Scenariu de afaceri
Am lucrat cu un client pe un rollout de muşchi de nivel de întreprindere. Ne-am proiectat taxonomie lor, astfel încât proiectele sunt cetăţeni de clasa întâi în ierarhia şi au propriile lor site-ul de nivel superior. Managerilor de proiect să menţină o listă de singleton de proiect informaţii rezumative, ca titlu, buget, data preconizată de finalizare, restul bugetul şi alte domenii de tip de rezumare. De "singleton" Adica o personalizate lista SharePoint garantat să conțină doar un singur articol. Simplist, se pare ca asta:
Abordare tehnică este la fel de mult după cum este descris aici (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!447.entry). CQWP foloseşte o transformare XSL să emită HTML pentru browser-ul sa redea.
Am envision întotdeauna rezultatul înainte de scufundare în XSL pentru XSL este un coşmar. Aici este meu rezultatul dorit:
HTML ca aceasta generează acest rezultat:
|
<HTML>
<corpul>
<Centrul>
<tabel frontieră= 1>
<!-- Etichete-->
<TR bgcolor= albastru>
<TD><font culoare= alb><b>Numele proiectului</b></font></TD>
<TD Aliniaţi= dreapta><font culoare= alb><b>Data completă</b></font></TD>
<TD Aliniaţi= dreapta><font culoare= alb><b>Buget</b></font></TD>
<TD Aliniaţi= dreapta><font culoare= alb><b>Cheltuieli actuale</b></font></TD>
<TD><font culoare= alb><b>Starea generală</b></font></TD>
</TR>
<TR>
<TD>Re-sârmă sala de calculatoare.</TD>
<TD Aliniaţi= dreapta>02/01/08</TD>
<TD Aliniaţi= dreapta>22,500.00</TD>
<TD Aliniaţi= dreapta>19,000.00</TD>
<TD>În curs de desfăşurare</TD>
</TR>
<TR>
<TD>Furnizarea de servere pentru SQL Upgrade</TD>
<TD Aliniaţi= dreapta>04/01/08</TD>
<TD Aliniaţi= dreapta>7,500.00</TD>
<TD Aliniaţi= dreapta>0.00</TD>
<TD>Planificate</TD>
</TR>
</tabel>
</Centrul>
</corpul>
</HTML>
|
Abordare
Urmaţi aceşti paşi pentru a crea grila:
- Identifica componentele de reţea (rânduri/coloane).
- Defini şi de a crea coloane de site-ul necesar.
- Creaţi site-uri sub pentru proiecte şi liste de singleton.
- Adauga CQWP la o pagină web şi configuraţi-l pentru a căuta listele tale.
- Modifica CQWP XML să adune coloane suplimentare.
- Modifica XSL pentru a genera un tabel.
Am de gând să se concentreze asupra numărului şase. Numere unul prin patru sunt drept-înainte, şi ceva care orice utilizator CQWP deja a făcut. Numărul cinci a fost bine documentate de alţii, inclusiv acest articol exhaustivă de ecran-shot încărcat la MSDN aici (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) şi Heather Solomon blog aici (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
Nuci şi bolţuri
Începe şi implementa paşi unul prin cinci după documentaţia MSDN şi Heather Solomon articolul.
La acest punct, aţi adăugat ta CQWP la pagina şi aveţi dumneavoastră <CommonViewFields> configurate după cum este necesar.
Urmând paşii de obicei, I a lua aceste rezultate intermediare:
1. Crea un tip de conținut, un șablon particularizat lista pentru acel tip de conținut și două site-uri. Aici este tipul de conținut:
Aici este structura site-ului:
2. Adauga CQWP după crearea meu proiect subsite-uri și singleton liste rezumatul proiectului:
3. Adauga toate informaţiile suplimentare vreau prin <CommonViewFields>:
<proprietate nume="CommonViewFields" tip="şir">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</proprietate>
Reţineţi că am avut de a păstra toate câmpurile de proprietate pe o linie sau o nu ar funcţiona (CQWP mi-ar spune că interogarea returnat niciun element).
4. La acest punct, Suntem gata pentru a trece dincolo de articolul MSDN şi flip pe peste articolul lui Heather Solomon. Urmaţi paşii ei incepand de lângă pas #5 pentru a crea o personalizate / unghosted versiune de ItemStyle.xsl. Am urmat sfatul lui Heather, până prin pas 11 şi a obţine aceste rezultate intermediare:
4.1: Nume şablon mea XSL, după cum urmează:
<XSL:Nume şablon = "grilă" meci = "Row[@Style = "Grila"]" modul = "itemstyle">
De asemenea, uşor modifica ei sugerat <XSL:pentru fiecare …> prin adăugarea de o <br /> Tag-ul pentru a oferi o listă mai curat:
<XSL:pentru fiecare Selectaţi="@*">
P:<XSL:valoarea de Selectaţi="nume()" /><br/>
</XSL:pentru fiecare>
4.2: Modifică partea web, Du-te la aspect şi selectaţi meu "grilă" stil:
Aplicaţi schimbare şi aici este rezultatul:
Putem vedea din cele de mai sus că domeniile vrem (Numele proiectului, cheltuieli, statutul, etc) sunt disponibile pentru noi de a folosi atunci când am emite HTML. Nu numai că, dar vom vedea numele prin care noi trebuie să referinţă aceste coloane în XSL. De exemplu, am de referinţă proiectul statutului ca "Project_x005F_x0020_Name".
La acest punct, plecam de la Heather pe blog si de la umeri de giganţi aceste, Adăuga propria mea pic.
ContentQueryMain.xsl
NOTĂ: Când a face modificări la atât ContentQueryMain.xsl, cât şi ItemStyle.xsl, trebuie să verificaţi aceste fişiere înapoi în înainte de a vedea efectul de modificări.
Scopuri grila de luare a, MOSS utilizează două fişiere diferite XSL pentru a produce rezultate vom vedea de la o CQWP. Pentru a genera anterioare de biţi de ieşire, am modificat ItemStyle.xsl. MUŞCHI de fapt foloseste un alt fișier XSL, ContentQueryMain.xsl sa în colaborare cu ItemStyle.xsl pentru a genera sale HTML. După cum sugerează şi numele, ContentQueryMain.xsl este principala"" XSL care controleaza fluxul de ansamblu de traducere. Acesta reiterează prin toate elementele găsit şi trece-le unul câte unul la template-uri în ItemStyle.xsl. Ne vom modifica ItemStyle.xsl pentru a genera deschis <tabel> Tag-ul înainte de a emite primul rând de date şi închidere <tabel> Tag-ul după emit ultimul rând. Pentru a realiza acest lucru, ContentQueryMain.xsl este modificat pentru a trece doi parametri noastre "grilă" şablon în ItemStyle.xsl, "ultimul rând" şi "rândul curent". ItemStyle.xsl foloseşte să emită condiţional Tag-uri necesare.
Folosind tehnica de Heather Solomon, ne găsiţi ContentQueryMain.xsl. Acesta este situat în acelaşi loc ca ItemStyle.xsl. Acest ecran shot ar trebui să ajute:
Trebuie să efectuaţi următoarele modificări:
- Modificarea unui șablon xsl, "CallItemTemplate" fapt care invocă noastre şablon de grilă în ItemStyle.xsl. Vom trece doi parametri în şablonul grila astfel încât acesta va avea datele are nevoie pentru a genera condiţional deschidere şi închidere <tabel> Tag-uri.
- Modifica un pic de ContentQueryMain.xsl care necesită "CallItemTemplate" pentru a trece un LastRow"" parametru aşa că LastRow poate fi trecut pe la noastre şablon de grilă.
Găsiţi şablonul denumit "OuterTemplate.CallItemTemplate" identificate de şir:
<XSL:şablon nume="OuterTemplate.CallItemTemplate">
Înlocui șablonul întreg după cum urmează:
|
<XSL:şablon nume="OuterTemplate.CallItemTemplate">
<XSL:Param nume="CurPosition" />
<!--
Adauga "LastRow" parametru.
Noi folosim doar atunci când elementul stil trece în "Grilă".
-->
<XSL:Param nume="LastRow" />
<XSL:alege>
<XSL:când test="@Style = 'NewsRollUpItem'">
<XSL:aplica-template-uri Selectaţi="." modul de="itemstyle">
<XSL:cu-param nume="EditMode" Selectaţi="$cbq_iseditmode" />
</XSL:aplica-template-uri>
</XSL:când>
<XSL:când test="@Style = 'NewsBigItem'">
<XSL:aplica-template-uri Selectaţi="." modul de="itemstyle">
<XSL:cu-param nume="CurPos" Selectaţi="$CurPosition" />
</XSL:aplica-template-uri>
</XSL:când>
<XSL:când test="@Style = 'NewsCategoryItem'">
<XSL:aplica-template-uri Selectaţi="." modul de="itemstyle">
<XSL:cu-param nume="CurPos" Selectaţi="$CurPosition" />
</XSL:aplica-template-uri>
</XSL:când>
<!--
Trece poziţia curentă şi lastrow la grila itemstyle.xsl şablon.
ItemStyle.xsl care va folosi pentru a emite open şi închidere <tabel> Tag-uri.
-->
<XSL:când test="@Style = "Grila"">
<XSL:aplica-template-uri Selectaţi="." modul de="itemstyle">
<XSL:cu-param nume="CurPos" Selectaţi="$CurPosition" />
<XSL:cu-param nume="Ultima" Selectaţi="$LastRow" />
</XSL:aplica-template-uri>
</XSL:când>
<XSL:în caz contrar>
<XSL:aplica-template-uri Selectaţi="." modul de="itemstyle">
</XSL:aplica-template-uri>
</XSL:în caz contrar>
</XSL:alege>
</XSL:şablon>
|
Comentarii descrie scopul modificările.
desigur, "OuterTemplate.CallItemTemplate" în sine este numit de la un alt şablon. Găsiţi că şablon de cercetare pentru acest șir text:
<XSL:şablon nume="OuterTemplate.Body">
Parcurgeţi instrucţiunile din OuterTemplate.Body şi inseraţi parametrul LastRow după cum urmează (indicat ca un comentariu în caractere italice):
<XSL:apel-şablon nume="OuterTemplate.CallItemTemplate">
<XSL:cu-param nume="CurPosition" Selectaţi="$CurPosition" />
<!-- Inseraţi parametrul LastRow. -->
<XSL:cu-param nume="LastRow" Selectaţi="$LastRow"/>
</XSL:apel-şablon>
După toate acestea, în cele din urmă am lucruri stabilite în mod corespunzător astfel încât ItemStyle.xsl nostru poate emite <tabel> Tag-uri la locul potrivit.
ItemStyle.Xsl
NOTĂ: Din nou, verifica în ItemStyle.xsl după a face orice modificări, astfel încât veţi vedea efectul modificărilor.
Avem două sarcini aici:
- Înlocuiţi întreaga grilă şablon. Să puteţi copy/paste de mai jos.
- Adauga unele jumbo mumbo în afara definiţia şablonului care permite "formatcurrency" şablon de a lucra. (Vă pot spune că am un mâner fragilă pe XSL).
Prima, lângă partea de sus a ItemStyle.xsl, adăugaţi această linie:
<!-- Unele mumbo jumbo care ne permite să afişaţi SUA. moneda. -->
<XSL:zecimal-format nume="Personalul" cifre="D" />
<XSL:şablon nume="În mod implicit" meci="*" modul de="itemstyle">
Reţineţi că am adăugat-o direct înainte <XSL:Nume şablon = "implicit" …> definiţie.
Următoarea, Du-te înapoi la noastre şablon de grilă. Înlocuiţi întreaga grilă şablon cu codul de mai jos. Acesta este foarte bine comentat, dar nu ezitaţi să mi e-mail sau lăsaţi comentarii pe blog-ul meu, dacă aveţi întrebări.
|
<XSL:şablon nume="Grilă" meci="Rând[@Style = "Grila"]" modul de="itemstyle">
<!--
ContentMain.xsl trece CurPos şi ultimul.
Vom folosi aceste să emită condiţional open şi închidere <tabel> Tag-uri.
-->
<XSL:Param nume="CurPos" />
<XSL:Param nume="Ultima" />
<!-- Următoarele variabile sunt nemodificat la ItemStyle.xsl standard -->
<XSL:variabila nume="SafeImageUrl">
<XSL:apel-şablon nume="OuterTemplate.GetSafeStaticUrl">
<XSL:cu-param nume="UrlColumnName" Selectaţi="'ImageUrl'"/>
</XSL:apel-şablon>
</XSL:variabila>
<XSL:variabila nume="SafeLinkUrl">
<XSL:apel-şablon nume="OuterTemplate.GetSafeLink">
<XSL:cu-param nume="UrlColumnName" Selectaţi="'LinkUrl'"/>
</XSL:apel-şablon>
</XSL:variabila>
<XSL:variabila nume="DisplayTitle">
<XSL:apel-şablon nume="OuterTemplate.GetTitle">
<XSL:cu-param nume="Titlul" Selectaţi="@Title"/>
<XSL:cu-param nume="UrlColumnName" Selectaţi="'LinkUrl'"/>
</XSL:apel-şablon>
</XSL:variabila>
<XSL:variabila nume="LinkTarget">
<XSL:Dacă test="@OpenInNewWindow = "True"" >_blank</XSL:Dacă>
</XSL:variabila>
<!--
Aici vom defini o variabila, "tableStart". Aceasta conţine HTML pe care le folosim pentru a defini deschiderea de masă, precum şi etichete de coloană. Reţineţi că, dacă CurPos = 1, Acesta include HTML într-o etichetă CDATA.
În caz contrar, Acesta va fi gol.
Valoarea tableStart este emisă de fiecare dată când ItemStyle este numit prin intermediul ContentQueryMain.xsl.
-->
<XSL:variabila nume="tableStart">
<XSL:Dacă test="$CurPos = 1">
<![CDATA[
<masă de frontieră = 1>
<TR bgcolor = "albastru">
<TD><culoare font = "alb"><b>Numele proiectului</b></font></TD>
<TD alinia = "dreapta"><culoare font = "alb"><b>Data completă</b></font></TD>
<TD alinia = "dreapta"><culoare font = "alb"><b>Buget</b></font></TD>
<TD alinia = "dreapta"><culoare font = "alb"><b>Cheltuieli actuale</b></font></TD>
<TD><culoare font = "alb"><b>Starea generală</b></font></TD>
</TR>
]]>
</XSL:Dacă>
</XSL:variabila>
<!--
O altă variabilă, tableEnd defineşte pur şi simplu închiderea tag-ul de masă.
Ca cu tableStart, este întotdeauna emisă. De aceea, valoarea sa este asociată condiţional pe baza dacă am fost trecut ultimul rând de ContentQueryMain.xsl.
-->
<XSL:variabila nume="tableEnd">
<XSL:Dacă test="$CurPos = $Last">
<![CDATA[ </tabel> ]]>
</XSL:Dacă>
</XSL:variabila>
<!--
Întotdeauna emite conţinutul tableStart. Dacă acest lucru nu este primul rând trecut la noi de ContentQueryMain.xsl, apoi am ştiu valoarea sa va fi necompletat.
Dezactiva de ieşire evadarea deoarece când tableStart ea nu gol, Acesta include HTML reale, care ne-o dorim a fi prestate de către browser. Dacă nu spunem XSL parser-ul pentru a dezactiva de ieşire evadarea, Acesta va genera chestii de genul"<tabel>" în loc de"<tabel>".
-->
<XSL:valoarea de Selectaţi="$tableStart" Dezactivează-ieşire-evadarea="da"/>
<TR>
<!--
P:Project_x005F_x0020_Name P:Project_x005F_x0020_End_x005F_x0020_Date P:Project_x005F_x0020_Budget P:Project_x005F_x0020_Expenses P:Project_x005F_x0020_Status
-->
<TD>
<XSL:valoarea de Selectaţi="@Project_x005F_x0020_Name"/>
</TD>
<TD Aliniaţi="dreptul de">
<XSL:valoarea de Selectaţi="@Project_x005F_x0020_End_x005F_x0020_Date"/>
</TD>
<TD Aliniaţi="dreptul de">
<XSL:apel-şablon nume="formatcurrency">
<XSL:cu-param nume="valoarea" Selectaţi="@Project_x005F_x0020_Budget"></XSL:cu-param>
</XSL:apel-şablon>
</TD>
<TD Aliniaţi="dreptul de">
<XSL:apel-şablon nume="formatcurrency">
<XSL:cu-param nume="valoarea" Selectaţi="@Project_x005F_x0020_Expenses"> </XSL:cu-param>
</XSL:apel-şablon>
</TD>
<TD>
<XSL:valoarea de Selectaţi="@Project_x005F_x0020_Status"/>
</TD>
<!--
Următoarele este comentat afară pentru a clarifica lucrurile.
Cu toate acestea, aduceţi-l înapoi şi chestii-l într-un <TD> pentru a vedea efectul acesteia.
-->
<!--
<div id = "linkitem" clasa = "element">
<XSL:Dacă testul = "şir de caractere de lungime($SafeImageUrl) != 0">
<div clasa = "imagine-zona-stânga">
<o href = "{$SafeLinkUrl}" target = "{$LinkTarget}">
<img clasa = "imagine-lăţime fixă" src = "{$SafeImageUrl}" alt = "{@ImageUrlAltText}"/>
</o>
</div>
</XSL:Dacă>
<div clasa = "link-ul-element">
<XSL:apel-şablon name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<o href = "{$SafeLinkUrl}" target = "{$LinkTarget}" title = "{@LinkToolTip}">
<XSL:valoare-a selecta = "$DispXSLTitle" />
</o>
<div clasa = "Descriere">
<XSL:valoare de select="@Description" />
</div>
</div>
</div>
-->
</TR>
<!--
Emite închidere tag-ul de masă. Dacă nu suntem pe ultimul rând,
Acest lucru va fi necompletat.
-->
<XSL:valoarea de Selectaţi="$tableEnd" Dezactivează-ieşire-evadarea="da"/>
</XSL:şablon>
<XSL:şablon nume="formatcurrency">
<XSL:Param nume="valoarea" Selectaţi="0" />
<XSL:valoarea de Selectaţi='format de număr($valoarea, "$DDD,DDD,DDD.DD", "personal")' />
</XSL:şablon>
|