Descricións e Obxectivo
Fóra da caixa, Moss’ Content Query web Part (CQWP) exhibe os seus resultados nun formato de lista, similar to search results. It is also possible to display the results in a grid format (i.e. HTML formato de táboa). Grid formats are better in some circumstances. I describe how to achieve that effect in this article.
Escenario empresarial
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, como título, orzamento, data de conclusión prevista, remaining budget and other summary type fields. By "singleton" I mean a custom SharePoint list guaranteed to contain only one item. Simplistically, parece que esta:
O enfoque técnico é do mesmo xeito como se describe aquí (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 como este que xera resultado:
|
|
<html>
<corpo>
<centro>
<mesa fronteira= 1>
<!-- Etiquetas ->
<tr bgcolor= Blue>
<td><fonte cor= Branco><b>Nome do Proxecto</b></fonte></td>
<td aliñar= Right><fonte cor= Branco><b>Data completar</b></fonte></td>
<td aliñar= Right><fonte cor= Branco><b>Orzamento</b></fonte></td>
<td aliñar= Right><fonte cor= Branco><b>Gasto real</b></fonte></td>
<td><fonte cor= Branco><b>Estado xeral</b></fonte></td>
</tr>
<tr>
<td>Sala de informática Re-wire.</td>
<td aliñar= Right>02/01/08</td>
<td aliñar= Right>22,500.00</td>
<td aliñar= Right>19,000.00</td>
<td>En marcha</td>
</tr>
<tr>
<td>Provisionar servidores SQL para actualización</td>
<td aliñar= Right>04/01/08</td>
<td aliñar= Right>7,500.00</td>
<td aliñar= Right>0.00</td>
<td>Planeado</td>
</tr>
</mesa>
</centro>
</corpo>
</html>
|
Aproximación
Siga estes pasos para crear a reixa:
- Identificar os compoñentes da reixa (liñas / columnas).
- Definir e crear columnas de sitio necesarias.
- Crear sitios sub para os proxectos e listas únicas.
- Engadir o CQWP a unha páxina web e configuralo para buscar as súas listas.
- Modificar XML do CQWP para recoller as columnas adicionais.
- Editar o XSL para xerar unha táboa.
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 aquí (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) e blog de Heather Solomon aquí (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
Porcas e parafusos
Comezar e aplicar medidas de un a cinco anos segundo a documentación do MSDN e artigo de Heather Solomon.
Neste punto, engadiu o CQWP á páxina e ten a súa <CommonViewFields> configurar que corresponda.
Seguindo os pasos habituais, Eu recibín estes resultados intermedios:
1. Crear un tipo de contido, a templatized custom list for that content type and two sites. Here is the content type:
Aquí está a estrutura do sitio:
2. Engadir o CQWP despois de crear os meus subsites proxecto e únicas proxecto listas sumarias:
3. Fai toda a información adicional que quero vía <CommonViewFields>:
<propiedade nome="CommonViewFields" tipo="corda">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</propiedade>
Nótese que eu tiña que manter todos os campos de propiedade nunha liña ou que non ía funcionar (CQWP iría me dicir que a consulta non devolveu elementos).
4. Neste punto, 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 para crear un personalizado / unghosted version of ItemStyle.xsl. I follow Heather’s advice, ata a etapa 11 e obter eses resultados intermedios:
4.1: O nome do meu template XSL como segue:
<XSL:template name="Grid" match="Row[@Style=’Grid’]" mode="itemstyle">
I tamén modificar lixeiramente a súa suxerido <XSL:a-cada …> pola adición dun <br /> etiqueta para fornecer unha listaxe máis limpo:
<XSL:a-cada seleccionar="@ *">
P:<XSL:valor de seleccionar="nome()" /><br/>
</XSL:a-cada>
4.2: Eu modificar a parte web, go to appearance and select my "Grid" estilo:
Aplicar o cambio e aquí está o resultado:
Podemos ver enriba que os campos que queremos (Nome do proxecto, gasto, Estado, etc) 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. Por exemplo, we reference Project Status as "Project_x005F_x0020_Name".
Neste punto, partimos do blog de Heather e dos ombros destes xigantes, Eu podo engadir o meu propio pouco.
ContentQueryMain.xsl
NOTA: Ao facer cambios en ambos ContentQueryMain.xsl así como ItemStyle.xsl, ten que comprobar os arquivos de volta antes de ver o efecto das súas alteracións.
Para fins de reixa de decisións, 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 <mesa> cita antes emitindo a primeira liña de datos e do peche <mesa> tag after emitting the last row. To accomplish this, ContentQueryMain.xsl is modified to pass two parameters to our "grid" modelo no ItemStyle.xsl, "last row" and "current row". ItemStyle.xsl uses these to conditionally emit the necessary tags.
Empregando a técnica de Heather Solomon, we locate ContentQueryMain.xsl. It is located in the same place as ItemStyle.xsl. This screen shot should help:
Temos que facer os seguintes cambios:
- Modificar un modelo 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 <mesa> Tag.
- Modify another bit of ContentQueryMain.xsl that calls the "CallItemTemplate" to pass it a "LastRow" parámetro para que LastRow pode ser repassada ao noso modelo de Reixa.
Locate the template named "OuterTemplate.CallItemTemplate" identificado pola cadea:
<XSL:modelo nome="OuterTemplate.CallItemTemplate">
Substituír todo o modelo como segue:
|
|
<XSL:modelo nome="OuterTemplate.CallItemTemplate">
<XSL:paran nome="CurPosition" />
<!--
Add the "LastRow" parámetro.
We only use it when the item style pass in is "Grid".
-->
<XSL:paran nome="LastRow" />
<XSL:escoller>
<XSL:cando proba="@ Style = 'NewsRollUpItem'">
<XSL:apply-templates seleccionar="." xeito="ItemStyle">
<XSL:con-paran nome="Modo Edición" seleccionar="$cbq_iseditmode" />
</XSL:apply-templates>
</XSL:cando>
<XSL:cando proba="@ Style = 'NewsBigItem'">
<XSL:apply-templates seleccionar="." xeito="ItemStyle">
<XSL:con-paran nome="CurPos" seleccionar="$CurPosition" />
</XSL:apply-templates>
</XSL:cando>
<XSL:cando proba="@ Style = 'NewsCategoryItem'">
<XSL:apply-templates seleccionar="." xeito="ItemStyle">
<XSL:con-paran nome="CurPos" seleccionar="$CurPosition" />
</XSL:apply-templates>
</XSL:cando>
<!--
Pase posición actual e LastRow ao modelo ItemStyle.xsl Reixa.
ItemStyle.xsl vai usar isto para obter a apertura e peche <mesa> Tag.
-->
<XSL:cando proba="@ Style = 'Grid'">
<XSL:apply-templates seleccionar="." xeito="ItemStyle">
<XSL:con-paran nome="CurPos" seleccionar="$CurPosition" />
<XSL:con-paran nome="Último" seleccionar="$LastRow" />
</XSL:apply-templates>
</XSL:cando>
<XSL:se non>
<XSL:apply-templates seleccionar="." xeito="ItemStyle">
</XSL:apply-templates>
</XSL:se non>
</XSL:escoller>
</XSL:modelo>
|
As observacións describen o efecto do cambio.
Por suposto, the "OuterTemplate.CallItemTemplate" is itself called from another template. Locate that template by searching for this text string:
<XSL:modelo nome="OuterTemplate.Body">
Desprácese entre as instruccións OuterTemplate.Body e introducir o parámetro LastRow como segue (aparece como un comentario en cursiva):
<XSL:call-template nome="OuterTemplate.CallItemTemplate">
<XSL:con-paran nome="CurPosition" seleccionar="$CurPosition" />
<!-- Insire o parámetro LastRow. -->
<XSL:con-paran nome="LastRow" seleccionar="$LastRow"/>
</XSL:call-template>
Despois de todo isto, Finalmente temos cousas configurado correctamente para que o noso ItemStyle.xsl pode emitir <mesa> etiquetas no lugar seguro.
ItemStyle.xsl
NOTA: De novo, facturación ItemStyle.xsl despois de facer todos os cambios para que vexa o efecto desas mudanzas.
Temos dúas tarefas aquí:
- 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. (Pode dicir que eu teño unha alza tenue en XSL).
Primeiro, na parte superior ItemStyle.xsl, engadir esta liña:
<!-- Algúns patranhas que nos permite visualizar U.S. moeda. -->
<XSL:decimal-formato nome="persoal" díxito="D" />
<XSL:modelo nome="Omisión" corresponden="*" xeito="ItemStyle">
Teña en conta que eu engade-o directamente antes da <XSL:template name="Default" …> definición.
Seguinte, go back to our Grid template. Replace the entire Grid template with the code below. It is thoroughly commented, pero non dubide en me enviar correo-e ou deixar un comentario no meu blog, se ten dúbidas.
|
|
<XSL:modelo nome="Reixa" corresponden="Liña[@ Style = 'Grid']" xeito="ItemStyle">
<!--
ContentMain.xsl pasa CurPos e última.
Nós usalos para emitir condicional a ceo aberto e peche <mesa> Tag.
-->
<XSL:paran nome="CurPos" />
<XSL:paran nome="Último" />
<!-- As seguintes variables son non modificados a partir do patrón de ItemStyle.xsl -->
<XSL:variable nome="SafeImageUrl">
<XSL:call-template nome="OuterTemplate.GetSafeStaticUrl">
<XSL:con-paran nome="UrlColumnName" seleccionar="'ImageUrl'"/>
</XSL:call-template>
</XSL:variable>
<XSL:variable nome="SafeLinkUrl">
<XSL:call-template nome="OuterTemplate.GetSafeLink">
<XSL:con-paran nome="UrlColumnName" seleccionar="'LinkUrl'"/>
</XSL:call-template>
</XSL:variable>
<XSL:variable nome="DisplayTitle">
<XSL:call-template nome="OuterTemplate.GetTitle">
<XSL:con-paran nome="Título" seleccionar="@ Título"/>
<XSL:con-paran nome="UrlColumnName" seleccionar="'LinkUrl'"/>
</XSL:call-template>
</XSL:variable>
<XSL:variable nome="LinkTarget">
<XSL:se proba="@ OpenInNewWindow = 'True'" >_blank</XSL:se>
</XSL:variable>
<!--
Aquí imos definir unha variable, "tableStart". Este contén o código HTML
. Nótese que se CurPos = 1, inclúe o HTML nunha etiqueta CDATA.
En caso contrario, estará baleiro.
O valor de tableStart é emited cada vez ItemStyle chámase través
.
-->
<XSL:variable nome="tableStart">
<XSL:se proba="$CurPos = 1">
<![CDATA[
<borde da táboa = 1>
<tr bgcolor="blue">
<td><font color="white"><b>Nome do Proxecto</b></fonte></td>
<td align="right"><font color="white"><b>Data completar</b></fonte></td>
<td align="right"><font color="white"><b>Orzamento</b></fonte></td>
<td align="right"><font color="white"><b>Gasto real</b></fonte></td>
<td><font color="white"><b>Estado xeral</b></fonte></td>
</tr>
]]>
</XSL:se>
</XSL:variable>
<!--
Outra variable, tableEnd define simplemente tag mesa de clausura.
Igual que tableStart, sempre emited. É por iso que o seu valor é
.
-->
<XSL:variable nome="tableEnd">
<XSL:se proba="$CurPos = $ Última">
<![CDATA[ </mesa> ]]>
</XSL:se>
</XSL:variable>
<!--
Sempre liberan o contido da tableStart. Se este non é o primeiro
, entón sabemos o seu valor
.
Desactivar saída fuxir porque cando tableStart non en branco, el
. Se
, it will generate
stuff like "<mesa>" instead of "<mesa>".
-->
<XSL:valor de seleccionar="$tableStart" disable-output-escapar="si"/>
<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:valor de seleccionar="@ Project_x005F_x0020_Name"/>
</td>
<td aliñar="dereito">
<XSL:valor de seleccionar="@ Project_x005F_x0020_End_x005F_x0020_Date"/>
</td>
<td aliñar="dereito">
<XSL:call-template nome="FormatCurrency">
<XSL:con-paran nome="valor"
seleccionar="@ Project_x005F_x0020_Budget"></XSL:con-paran>
</XSL:call-template>
</td>
<td aliñar="dereito">
<XSL:call-template nome="FormatCurrency">
<XSL:con-paran nome="valor" seleccionar="@ Project_x005F_x0020_Expenses">
</XSL:con-paran>
</XSL:call-template>
</td>
<td>
<XSL:valor de seleccionar="@ Project_x005F_x0020_Status"/>
</td>
<!--
Todo o que sigue é comentado para aclarar as cousas.
Con todo, trae-lo de volta e enche-lo nun <td> para ver a súa
.
-->
<!--
<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}"/>
</un>
</p>
</XSL:se>
<div class="link-item">
<XSL:call-template
name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<a href="{$SafeLinkUrl}"
target="{$LinkTarget}" title="{@ LinkToolTip}">
<XSL:value-of select="$DisplayTitle"/>
</un>
<div class="description">
<XSL:value-of select="@Description" />
</p>
</p>
</p>
-->
</tr>
<!--
Emitir tag mesa de clausura. Se non estamos na última liña,
este quedará en branco.
-->
<XSL:valor de seleccionar="$tableEnd" disable-output-escapar="si"/>
</XSL:modelo>
<XSL:modelo nome="FormatCurrency">
<XSL:paran nome="valor" seleccionar="0" />
<XSL:valor de seleccionar='formato de número($valor, "$DDD,DDD,DDD.DD", "staff")' />
</XSL:modelo>
|
