Cartlanna Catagóire: SharePoint Forbartha

Beware Athruithe Breaking go ItemStyle.xsl

Bhí mé ag obair le ItemStyle.xsl a shaincheapadh ar an cuma ar Ábhar Gréasáin Iarratas Cuid agus an ceart faoi am lóin, I made a breaking change to the xsl. I didn’t realize it, but this had far reaching effects throughout the site collection. I went off to lunch and upon my return, noticed this message appearing in a bunch of places:

Unable to display this Web Part. To troubleshoot the problem, open this Web page in a Windows SharePoint Services-compatible HTML editor such as Microsoft Office SharePoint Designer. If the problem persists, contact your Web server administrator.

I blamed the client (not realizing as yet that it was my fault at this point) but eventually noticed that visual studio intellisense was warning me that I had malformed XSL. I corrected it and everything started working.

Be darned careful when working with ItemStyle.xsl (and any of the global XSL files) — breaking them affects many artifacts in the site collection.

<deireadh />

Taispeáin Ábhar Torthaí Iarratas Cuid Gréasáin i Eangach / Tábla

Forbhreathnú agus Cuspóir

As an bosca, CAONAIGH’ Cuid Web Content Iarratas (CQWP) Taispeánann na torthaí i bhformáid liosta, similar to search results. It is also possible to display the results in a grid format (i.e. Bhformáid tábla HTML). Grid formats are better in some circumstances. I describe how to achieve that effect in this article.

Cás Gnó

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, cosúil le teideal, buiséad, dáta críochnaithe ag súil, remaining budget and other summary type fields. By "singleton" I mean a custom SharePoint list guaranteed to contain only one item. Simplistically, tá sé cosúil leis an:

íomhá

Is é an cur chuige teicniúil mórán mar an gcéanna a bhfuil cur síos anseo (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:

íomhá

Gineann HTML mar seo an toradh sin a:

<html>
 <comhlacht>
 <lár>
 <tábla teorann= 1>

<!-- Lipéid ->
 <tr bgcolor= Gorm>
 <td><Is iad dath= Bán><b>Ainm an Tionscadail</b></Is iad></td>
 <td ailíniúCeart><Is iad dath= Bán><b>Comhlánaigh Dáta</b></Is iad></td>
 <td ailíniúCeart><Is iad dath= Bán><b>Buiséad</b></Is iad></td>
 <td ailíniúCeart><Is iad dath= Bán><b>Costas Iarbhír</b></Is iad></td>
 <td><Is iad dath= Bán><b>Stádas Foriomlán</b></Is iad></td>
 </tr>

<tr>
 <td>Seomra ríomhaireachta Re-sreang.</td>
 <td ailíniúCeart>02/01/08</td>
 <td ailíniúCeart>22,500.00</td>
 <td ailíniúCeart>19,000.00</td>
 <td>I Dul Chun Cinn</td>
 </tr>

<tr>
 <td>Freastalaithe Soláthar le haghaidh Uasghrádú SQL</td>
 <td ailíniúCeart>04/01/08</td>
 <td ailíniúCeart>7,500.00</td>
 <td ailíniúCeart>0.00</td>
 <td>Pleanáilte</td>
 </tr>

</tábla>
 </lár>
 </comhlacht>
</html>

Cur Chuige

Lean na céimeanna seo a chruthú ar an eangach:

  1. Sainaithin na comhpháirteanna an eangach (rónna / colúin).
  2. Shainiú agus a chruthú colúin suíomh is gá.
  3. Cruthaigh suímh fho do na tionscadail agus liostaí singleton.
  4. An CQWP a chur le leathanach gréasáin agus é a chumrú chun cuardach a dhéanamh do do liostaí.
  5. Athraigh an CQWP ar XML a bhailiú suas na colúin bhreise a.
  6. Athraigh an XSL a ghiniúint tábla.

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 anseo (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) agus blog Heather Sholamón ar anseo (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).

Cnónna Agus Bolts

Tosaigh agus a chur i céimeanna amháin trí chúig de réir an doiciméadú MSDN agus airteagal Heather Sholamón ar.

Ag an bpointe seo, Chuir tú do CQWP go dtí an leathanach agus tá tú do <CommonViewFields> cumraithe mar is gá.

Tar éis na céimeanna is gnách, Faighim na torthaí idirmheánacha:

1. Cruthaigh cineál ábhar, a templatized custom list for that content type and two sites. Here is the content type:

íomhá

Seo é an struchtúr an tsuímh:

íomhá

2. Cuir an CQWP tar éis a chruthú mo subsites tionscadail agus liostaí achoimre singleton tionscadal:

íomhá

3. Cuir an t-eolas breise a ba mhaith liom tríd an <CommonViewFields>:

        <maoin ainm="CommonViewFields" cineál="teaghrán">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</maoin>

Tabhair faoi deara go raibh mé a choinneáil ar na réimsí go léir mhaoin ar líne amháin nó nach mbeadh sé ag obair (Ba mhaith CQWP insint dom go ais an cheist Níl aon rud).

4. Ag an bpointe seo, 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 a chruthú saincheaptha / unghosted version of ItemStyle.xsl. I follow Heather’s advice, suas trí chéim 11 agus a fháil ar na torthaí idirmheánacha:

4.1: Ainmnigh mo XSL teimpléad seo a leanas mar:

<XSL:ainm teimpléad = "Greille" mheaitseáil = "Rae[@Style=’Grid’]" mode = "itemstyle">

Liom freisin a mhodhnú beagán Mhol sí <XSL:do-gach …> ag cur le <br /> chlib a chur ar fáil ar liosta níos glaine:

    <XSL:do-gach roghnú="@ *">
      P:<XSL:luach-ar roghnú="ainm()" /><br/>
    </XSL:do-gach>

4.2: Mé a mhodhnú an chuid gréasáin, téigh go dtí cuma agus mo "Greille roghnú" stíl:

íomhá

Cuir an t-athrú agus anseo tá an toradh:

íomhá

Is féidir linn a fheiceáil ó na réimsí thuas gur mian linn a (Ainm an Tionscadail, chostas, stádas, 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. Mar shampla, Stádas againn Tionscadal tagartha mar "Project_x005F_x0020_Name".

Ag an bpointe seo, imeacht againn ó bhlag Heather agus ó na shoulders na giants, Liom a chur mo beagán féin.

ContentQueryMain.xsl

NÓTA: Nuair athruithe a dhéanamh ar an dá ContentQueryMain.xsl chomh maith le ItemStyle.xsl, gá duit a sheiceáil na comhaid ar ais i roimh a fheiceann tú ar an éifeacht do chuid athruithe.

Do-eangach a dhéanamh chun críocha, 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, Is é an príomh-ContentQueryMain.xsl "" 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 <tábla> tag roimh astú an ró chéad na sonraí agus an spriocdháta <tábla> tag after emitting the last row. To accomplish this, ContentQueryMain.xsl atá modhnaithe go dtí dhá paraiméadair pas a fháil ar ár "greille" teimpléad i ItemStyle.xsl, "As a chéile is déanaí" and "current row". ItemStyle.xsl uses these to conditionally emit the necessary tags.

Ag baint úsáide as teicníc Heather Sholamón ar, we locate ContentQueryMain.xsl. It is located in the same place as ItemStyle.xsl. This screen shot should help:

íomhá

Ní mór dúinn a dhéanamh ar na hathruithe seo a leanas:

  • Athraigh an teimpléad 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 <tábla> clibeanna.
  • Athraigh eile beagán de ContentQueryMain.xsl go bhfuil gá, CallItemTemplate "" chun pas a fháil sé LastRow "" paraiméadar ionas gur féidir LastRow a chur ar aghaidh chuig ár teimpléad Eangach.

Aimsigh an teimpléad atá ainmnithe "OuterTemplate.CallItemTemplate" aitheanta ag an teaghrán:

  <XSL:teimpléad ainm="OuterTemplate.CallItemTemplate">

In ionad an teimpléad iomlán mar seo a leanas:

  <XSL:teimpléad ainm="OuterTemplate.CallItemTemplate">
    <XSL:stop a chur ainm="CurPosition" />

    <!--
      Cuir an LastRow "" paraiméadar.
      Bainimid úsáid ach amháin nuair a bhíonn sé an pas stíl mír i "Eangach".
    -->
    <XSL:stop a chur ainm="LastRow" />

    <XSL:roghnú>
      <XSL:nuair a tástáil="@ Stíl = 'NewsRollUpItem'">
        <XSL:iarratas a dhéanamh-teimpléid roghnú="." Modh="itemstyle">
          <XSL:le-param ainm="EditMode" roghnú="$cbq_iseditmode" />
        </XSL:iarratas a dhéanamh-teimpléid>
      </XSL:nuair a>
      <XSL:nuair a tástáil="@ Stíl = 'NewsBigItem'">
        <XSL:iarratas a dhéanamh-teimpléid roghnú="." Modh="itemstyle">
          <XSL:le-param ainm="CurPos" roghnú="$CurPosition" />
        </XSL:iarratas a dhéanamh-teimpléid>
      </XSL:nuair a>
      <XSL:nuair a tástáil="@ Stíl = 'NewsCategoryItem'">
        <XSL:iarratas a dhéanamh-teimpléid roghnú="." Modh="itemstyle">
          <XSL:le-param ainm="CurPos" roghnú="$CurPosition" />
        </XSL:iarratas a dhéanamh-teimpléid>
      </XSL:nuair a>

      <!--
              Staid reatha agus lastrow ar aghaidh chuig an teimpléad itemstyle.xsl Eangach.
              Beidh ItemStyle.xsl sin a úsáid chun scaoileann an oscailte agus dúnta <tábla> clibeanna.
      -->
      <XSL:nuair a tástáil="@ Stíl = 'Eangach'">
        <XSL:iarratas a dhéanamh-teimpléid roghnú="." Modh="itemstyle">
          <XSL:le-param ainm="CurPos" roghnú="$CurPosition" />
          <XSL:le-param ainm="Last" roghnú="$LastRow" />
        </XSL:iarratas a dhéanamh-teimpléid>
      </XSL:nuair a>

      <XSL:ar shlí eile>
        <XSL:iarratas a dhéanamh-teimpléid roghnú="." Modh="itemstyle">
        </XSL:iarratas a dhéanamh-teimpléid>
      </XSL:ar shlí eile>
    </XSL:roghnú>
  </XSL:teimpléad>

Cur síos ar na tuairimí chun críche na n-athruithe.

Ar ndóigh,, an OuterTemplate.CallItemTemplate "" is itself called from another template. Locate that template by searching for this text string:

<XSL:teimpléad ainm="OuterTemplate.Body">

Scrollaigh trí na treoracha i OuterTemplate.Body agus cuir isteach an paraiméadar LastRow mar seo a leanas (a thaispeántar mar a comment i gcló iodálach):

<XSL:glao-teimpléad ainm="OuterTemplate.CallItemTemplate">
  <XSL:le-param ainm="CurPosition" roghnú="$CurPosition" />
  <!-- Cuir isteach an paraiméadar LastRow. -->
  <XSL:le-param ainm="LastRow" roghnú="$LastRow"/>
</XSL:glao-teimpléad>

Tar éis seo ar fad, againn ar deireadh tá rudaí a chur ar bun i gceart ionas gur féidir ár ItemStyle.xsl scaoileann <tábla> clibeanna ag an áit cheart.

ItemStyle.Xsl

NÓTA: Arís, sheiceáil i ItemStyle.xsl tar éis aon athruithe mar sin a fheiceann tú ar an éifeacht na n-athruithe.

Tá dhá thasc anseo:

  • Replace the entire Grid template. You can copy/paste from below.
  • Cuir roinnt jumbo mumbo lasmuigh den sainmhíniú teimpléad a chuireann ar chumas "formatcurrency" template to work. (Is féidir leat insint go bhfuil mé a láimhseáil tenuous ar XSL).

An Chéad, in aice leis an barr de ItemStyle.xsl, chur leis an líne seo:

  <!-- Roinnt jumbo mumbo sin ar ár gcumas a chur ar taispeáint U.S. airgeadra. -->
  <XSL:deachúil-format ainm="foirne" dhigit="D" />

  <XSL:teimpléad ainm="Réamhshocrú" mheaitseáil="*" Modh="itemstyle">

Tabhair faoi deara gur chuir mé é díreach roimh an <XSL:ainm teimpléad = "Default" …> sainmhíniú.

Ar Aghaidh, go back to our Grid template. Replace the entire Grid template with the code below. It is thoroughly commented, Ní ach ná bíodh aon leisce ort ríomhphost chugam nó tuairimí ar mo bhlag fhágáil má tá ceisteanna agat.

  <XSL:teimpléad ainm="Greille" mheaitseáil="Rae[@ Stíl = 'Eangach']" Modh="itemstyle">

    <!--
      ContentMain.xsl Gabhann CurPos agus Deiridh.
      Bainimid úsáid as na a scaoileann coinníollach an oscailte agus dúnta <tábla> clibeanna.
    -->
    <XSL:stop a chur ainm="CurPos" />
    <XSL:stop a chur ainm="Last" />

    <!-- Na hathróga seo a leanas gan athrú ó ItemStyle.xsl caighdeánach -->
    <XSL:athróg ainm="SafeImageUrl">
      <XSL:glao-teimpléad ainm="OuterTemplate.GetSafeStaticUrl">
        <XSL:le-param ainm="UrlColumnName" roghnú="'ImageUrl'"/>
      </XSL:glao-teimpléad>
    </XSL:athróg>
    <XSL:athróg ainm="SafeLinkUrl">
      <XSL:glao-teimpléad ainm="OuterTemplate.GetSafeLink">
        <XSL:le-param ainm="UrlColumnName" roghnú="'LinkUrl'"/>
      </XSL:glao-teimpléad>
    </XSL:athróg>
    <XSL:athróg ainm="DisplayTitle">
      <XSL:glao-teimpléad ainm="OuterTemplate.GetTitle">
        <XSL:le-param ainm="Teideal" roghnú="@ Teideal"/>
        <XSL:le-param ainm="UrlColumnName" roghnú="'LinkUrl'"/>
      </XSL:glao-teimpléad>
    </XSL:athróg>
    <XSL:athróg ainm="LinkTarget">
      <XSL:más rud é tástáil="@ OpenInNewWindow = 'Fíor'" >_blank</XSL:más rud é>
    </XSL:athróg>

    <!--
      Seo linn a shainiú athróg, "TableStart".  Tá sé seo an HTML
      .  Tabhair faoi deara gur CurPos = 1, Cuimsíonn sé an HTML i tag CDATA.
      Seachas sin, beidh sé folamh.

      Is é an luach tableStart emited go ndéantar gach ItemStyle am a dtugtar trí
      .
    -->
    <XSL:athróg ainm="tableStart">
      <XSL:más rud é tástáil="$CurPos = 1">
        <![CDATA[
        <teorann tábla = 1>
          <tr bgcolor = "gorm">
            <td><cló dath = "bán"><b>Ainm an Tionscadail</b></Is iad></td>
            <td ailíniú = "ceart"><cló dath = "bán"><b>Comhlánaigh Dáta</b></Is iad></td>
            <td ailíniú = "ceart"><cló dath = "bán"><b>Buiséad</b></Is iad></td>
            <td ailíniú = "ceart"><cló dath = "bán"><b>Costas Iarbhír</b></Is iad></td>
            <td><cló dath = "bán"><b>Stádas Foriomlán</b></Is iad></td>
          </tr>
        ]]>
      </XSL:más rud é>
    </XSL:athróg>

    <!--
      Eile athróg, tableEnd Sainmhíníonn ach an chlib tábla deiridh.

      Mar is amhlaidh le tableStart, tá sé i gcónaí emited.  Sin é an fáth go bhfuil a luach.
    -->
    <XSL:athróg ainm="tableEnd">
      <XSL:más rud é tástáil="$CurPos toil; $ Last">
        <![CDATA[ </tábla> ]]>
      </XSL:más rud é>
    </XSL:athróg>

    <!--
      I gcónaí scaoileann an t-ábhar tableStart.  Más rud é nach é seo an chéad
      , ansin a fhios againn a luach
      .

      Díchumasaigh aschur éalú toisc nach nuair tableStart sé folamh, sé
      .  Má, beidh sé a ghiniúint&lt;tábla&gt;" in ionad "<tábla>".
    -->
    <XSL:luach-ar roghnú="$tableStart" dhíchumasú-aschur-éalú="yes"/>


    <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:luach-ar roghnú="@ Project_x005F_x0020_Name"/>
      </td>

      <td ailíniú="ceart">
        <XSL:luach-ar roghnú="@ Project_x005F_x0020_End_x005F_x0020_Date"/>
      </td>

      <td ailíniú="ceart">
        <XSL:glao-teimpléad ainm="formatCurrency">
          <XSL:le-param ainm="luach" 
roghnú="@ Project_x005F_x0020_Budget"></XSL:le-param> </XSL:glao-teimpléad> </td> <td ailíniú="ceart"> <XSL:glao-teimpléad ainm="formatCurrency"> <XSL:le-param ainm="luach" roghnú="@ Project_x005F_x0020_Expenses">
</XSL:le-param> </XSL:glao-teimpléad> </td> <td> <XSL:luach-ar roghnú="@ Project_x005F_x0020_Status"/> </td> <!-- Gach seo a leanas a bhfuil trácht amach chun rudaí a shoiléiriú. Mar sin féin, thabhairt ar ais agus é a stuif isteach <td> a fheiceáil ar a         . --> <!-- <div id = "linkitem" aicme = "mír"> <XSL:má tástála = "teaghrán fad-($SafeImageUrl) != 0 "> <aicme div = "íomhá i limistéar an-chlé"> <a href = "{$SafeLinkUrl}" sprioc = "{$LinkTarget}"> <img aicme = "íomhá-seasta-leithead" src = "{$SafeImageUrl}"
Poiblı = "{@ ImageUrlAltText}"/> </a> </div> </XSL:más rud é> <aicme div = "nasc-item"> <XSL:glao-teimpléad
name="OuterTemplate.CallPresenceStatusIconTemplate"/> <a href = "{$SafeLinkUrl}"
sprioc = "{$LinkTarget}" title = "Ar{@ LinkToolTip}"> <XSL:luach-ar roghnaigh = "$ DisplayTitle" /> </a> <aicme div = "tuairisc"> <XSL:luach-ar roghnaigh = "@ Cur Síos" /> </div> </div> </div>
--> </tr> <!-- Scaoileann an chlib tábla deiridh. Más rud é nach bhfuil muid ar an tsraith dheireanach, beidh sé seo a bheith folamh. --> <XSL:luach-ar roghnú="$tableEnd" dhíchumasú-aschur-éalú="yes"/> </XSL:teimpléad> <XSL:teimpléad ainm="formatCurrency"> <XSL:stop a chur ainm="luach" roghnú="0" /> <XSL:luach-ar roghnú='bhformáid-uimhir($luach, "$ DDD,DDD,DDD.DD ", "Foireann")' /> </XSL:teimpléad>

Ná Standard SSU / CAONAIGH Scrúduithe Iontráil Sonraí Tacaíocht Cascáideacha Drop-downs (nó eile laistigh den ó cumarsáide)

Suas chun dáta (04/2008): Léiríonn an iontráil seo bhlag iontach cur chuige dea-javascript bunaithe ar an bhfadhb seo: http://webborg.blogspot.com/2008/04/add-functions-and-events-to-sharepoint.html

Suas chun dáta II: (04/2008): Breathnaíonn an iontráil seo blog bhfuil tuar dóchais inti chomh maith: http://www.cleverworkarounds.com/2008/03/13/free-mosswss-2007-web-part-hide-controls-via-javascript/

Roinnt uaireanta sa tseachtain, más rud é nach laethúil, forum users describe a requirement that would normally be met via cascading drop-downs. Mar shampla, Tá mé dhá rialuithe titim síos-:

  • Liosta de U.S. stáit
  • Liosta de U.S. cities.

As responsible UI providers, we want it to operate like this:

  • Paul selects a U.S. state from the drop-down.
  • This causes the cities drop-down to filter only those cities that belong to the selected state.
  • Paul selects a city from this filtered list.

There is no out-of-the-box support for this feature. Go deimhin, there is no OOB support for any kind of direct intra-form communication. This includes programmatically hiding/enabling/disabling fields in response to field changes elsewhere on the form.

The real objective of this article to to describe possible solutions and these are the options as I know them:

  1. Develop a custom column type. As a custom-column-developer, you have full control over the "world" of that custom column. You can implement a cascading drop-down that way.
  2. Consider using workflow. In some cases, you want to automatically assign a value to field based on another field’s value. Sa chás seo, you would normally try to use a calculated column, but some times, it just won’t get the job done. SharePoint Designer workflow is a relatively administer-friendly alternative to dropping down into code and visual studio. If you go this route, be aware of the issue addressed by airteagal seo (http://paulgalvin.spaces.live.com/blog/cns!CC1EDB3DAA9B8AA!405.entry).
  3. Event handlers: Like workflow, this is an after-the-fact solution. Your event handler is a .NET assembly (C #, VB.NET) to which SharePoint passes control. The object you develop has access to the data of the list (and the whole object model) and can do any needed calculation.
  4. Use SharePoint Designer to create custom entry forms. I don’t have direct experience with this approach, but I hear they are doing good things with NewForm.aspx these days 🙂
  5. Roll your own ASP.NET data entry function (as a stand-alone web page or as a web part) and use that instead.

If anyone knows other and/or better options, please post a comment and I’ll update the body of this post.

<deireadh />

Clibeanna Technorati:

Cruthaigh Graif Bharra i SharePoint

Forbhreathnú:

(Suas chun dáta 12/04/07: Curtha acmhainn suimiúil eile ag an deireadh nascadh le blag eile a thugann aghaidh ar seo trí cuid gréasáin an-suimiúil)

This blog entry describes how to create a bar graph in SharePoint. This works in both WSS and MOSS environments as it only depends upon the data view web part.

Is é an cur chuige foriomlán mar seo a leanas:

  1. Cruthaigh liosta nó leabharlann doiciméad ina bhfuil na sonraí is mian leat a graf.
  2. Cuir an leabharlann doiciméad gaolmhar / liosta saincheaptha isteach ar leathanach agus é a thiontú go sonraí a gcuid gréasáin dearcadh (DVWP).
  3. Athraigh XSL an DVWP HTML a léiríonn mar ghraf a ghiniúint.

Cás Gnó / Socrú:

Chruthaigh mé liosta saincheaptha leis an gcolún Teideal caighdeánach agus aon cholún breise, "Status". This models (an-simplistically) an "Authorization For Expense" cás nuair a dhéanann ionadaíocht ar an teideal an tionscadail agus an Stádas luach as an liosta de:

  • Molta
  • I Próiseas
  • Stop tagtha

Is é an cuspóir a thabhairt ar aird graf barra cothrománach idirghníomhach a léiríonn na cóid seo stádas.

Tá mé daonra an liosta agus tá sé cosúil le seo:

íomhá

Cruthaigh Sonraí View Web Cuid:

Cruthaigh an DVWP tríd an liosta saincheaptha le leathanach (leathanach an láthair i mo chás) agus lean na treoracha anseo (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!395.entry).

Chomh maith le go simplí a chruthú ar an DVWP, we also need to set the paging property to show all available rows. Maidir liom féin, seo Breathnaíonn an rud éigin mar seo:

íomhá

Ag an bpointe seo, I always close SPD and the browser. I then re-open the page using the browser. This avoids accidentally mucking up the web part layout on the page.

Athraigh an XSLT:

Tá sé am anois a mhodhnú an XSLT.

I always use visual studio for this. (Féach anseo do nóta tábhachtach faoi IntelliSense a chabhróidh leat go leor).

Chruthú mé mo tionscadal folamh chur ceithre comhad nua (replacing the words "Original" and "New" mar is cuí):

  • Original.xslt
  • New.xslt
  • Params.xml Bunaidh
  • Params.xml Nua

I mo chás, tá sé cosúil leis an:

íomhá

Modify the web part and copy the params and XSL to the "Original" leagan i Stiúideo Amharc.

Is é an cuspóir anseo a chur faoi deara an XSL a athrú ar na torthaí a fhaigheann muid ar ais ó na cheist DVWP i HTML go Rindreáil mar ghraf.

Chun na críche sin, it helps to first consider what the HTML should look like before we get confused by the insanity that is known as "XSL". (Chun a bheith soiléir, Is é an méid seo a leanas ach sampla; don’t type it or copy/paste into visual studio. I provide a full blow starting point for that later in the write-up). The following sample graph is rendered as per the HTML immediately following:

Samplach Bar Graf

HTML comhfhreagrach:

<html>
<comhlacht>
<lár>
<leithead tábla = 80%>
<tr><td><lár>Graf Bar Cothrománach</td></tr>
<tr>
<td align="center">
<table border="1" width = 80%>
<tr>
<td width = 10%>Oscail</td>
<td><tábla cellpadding ="0" cellspacing ="0" teorann = 0 leithead = 50%><tr bgcolor = dearg><td>&nbsp;</td></tr></tábla></td>
</tr>
<tr>
<td width = 10%>Dúnta</td>
<td><tábla cellpadding ="0" cellspacing ="0" teorann = 0 leithead = 25%><tr bgcolor = dearg><td>&nbsp;</td></tr></tábla></td>
</tr>
<tr>
<td width = 10%>Stop tagtha</td>
<td><tábla cellpadding ="0" cellspacing ="0" teorann = 0 leithead = 25%><tr bgcolor = dearg><td>&nbsp;</td></tr></tábla></td>
</tr>
</tábla>
</td>
</tr>
</tábla>
</comhlacht>
</html>

I used a dead simple approach to creating my bars by setting the background color of a row to "red".

An glan-amach anseo seo: Sa deireadh, gach táimid ag déanamh go bhfuil a chruthú HTML le sraitheanna agus colúin.

Teimpléad XSLT:

I’ve copied the XSLT that generates a horizontal bar graph. It’s fairly well commented so I won’t add much here except for these notes:

  • Thosaigh mé leis an mainneachtain XSL gur thug SharePoint Dearthóir dom nuair a chruthaigh mé ar dtús leis an DVWP.
  • Bhí mé in ann a ghearradh síos seo ón SPD ar 657 línte a 166 lines.
  • Ní raibh mé praiseach ar fud leis an gcomhad XML paraiméadair (atá ar leith ó na XSL agus beidh a fhios agat cad is ciall agam nuair a théann tú a mhodhnú ar an DVWP féin; tá dhá comhad féidir leat a mhodhnú). Mar sin féin, d'fhonn a shimpliú é, I did remove nearly all of them from the XSL. This means that if you want to make use of those parameters, you just need to add their variable definitions back to the XSL. That will be easy since you will have the original XSL variable definitions in your visual studio project.
  • You ought to be able to copy and paste this directly into your visual studio project. Ansin,, remove my calls and insert your own calls to "ShowBar".
  • An druil Oibríonn síos ag a chruthú <a href> mar seo: http://server/List?FilterField1=fieldname&FilterValue1=actualFilterValue. This technique may be of value in other contexts. Ar dtús, Shíl mé go mbeadh de dhíth orm chun cloí le formáid níos casta: http://server/List/AllItems.aspx?View={guid}&FilterField1=blah&FilterValue1=blah, but in my environment that is not necessary. The List’s URL is passed to us by SharePoint so this is quite easy to generalize.

Anseo tá sé:

<XSL:Stílbhileog leagan="1.0" eisiamh-thoradh-réimíreanna="rs z o s ddwrt dt msxsl" 
xmlns:msxsl="urn:schemas-microsoft-com:XSLT" xmlns:XSL="http://www.w3.org/1999/XSL/Transform"
xmlns:SharePoint="Microsoft.SharePoint.WebControls" xmlns:__designer="http://schemas.microsoft.com/WebParts/v2/DataView/designer"
xmlns:asp="http://schemas.microsoft.com/ASPNET/20" xmlns:ddwrt="http://schemas.microsoft.com/WebParts/v2/DataView/runtime"
xmlns:o="urn:schemas-microsoft-com:oifig" xmlns:s="UUID:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882"
xmlns:dt="UUID:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:rs="urn:schemas-microsoft-com:rowset" xmlns:z="#RowsetSchema"
xmlns:ddwrt2="urn:frontpage:inmheánacha"
> <XSL:aschur modh="html" fleasc="aon" /> <XSL:deachúil-format NaN="" /> <XSL:stop a chur ainm="ListUrlDir"></XSL:stop a chur> <!-- Gá dom seo chun tacú le druil síos-. --> <XSL:teimpléad mheaitseáil="/" xmlns:SharePoint="Microsoft.SharePoint.WebControls"
xmlns:__designer=http://schemas.microsoft.com/WebParts/v2/DataView/designer xmlns:asp="http://schemas.microsoft.com/ASPNET/20"
> <XSL:athróg ainm="dvt_StyleName">Tábla</XSL:athróg> <XSL:athróg ainm="Rónna" roghnú="/dsQueryResponse / Rónna / Rae" /> <XSL:athróg ainm="dvt_RowCount" roghnú="comhaireamh($Rónna)" /> <XSL:athróg ainm="IsEmpty" roghnú="$dvt_RowCount = 0" /> <XSL:athróg ainm="dvt_IsEmpty" roghnú="$dvt_RowCount = 0" /> <XSL:roghnú> <XSL:nuair a tástáil="$dvt_IsEmpty"> Níl aon sonraí ar ghraf!<br/> </XSL:nuair a> <XSL:ar shlí eile> <!-- Tosaíonn an stuif suimiúil anseo. Ní mór dúinn a shainiú le péire de na hathróga maidir le gach as a chéile sa ghraf: líon iomlán           . --> <XSL:athróg ainm="totalProposed" roghnú="comhaireamh(/dsQueryResponse / Rónna / Rae[normalú-spás(@ Stádas) = 'Na'])" /> <XSL:athróg ainm="percentProposed" roghnú="$totalProposed div $ dvt_RowCount" /> <XSL:athróg ainm="totalInProcess" roghnú="comhaireamh(/dsQueryResponse / Rónna / Rae[normalú-spás(@ Stádas) = 'I Próiseas'])" /> <XSL:athróg ainm="percentInProcess" roghnú="$totalInProcess div $ dvt_RowCount" /> <XSL:athróg ainm="totalStalled" roghnú="comhaireamh(/dsQueryResponse / Rónna / Rae[normalú-spás(@ Stádas) = 'Ag fanacht'])" /> <XSL:athróg ainm="percentStalled" roghnú="$div totalStalled $ dvt_RowCount" /> <!-- Táimid shainiú ár tábla HTML anseo. Tá mé ar iasacht ó roinnt caighdeán           . Sílim go mbeidh sé onóir           . --> <tábla leithead="100%" cellspacing="0" cellpadding="2" stíl="teorann-dheis: 1 # soladach C0C0C0; teorann-bun: 1 # soladach C0C0C0; teorann-chlé-stíl: soladach; teorann-chlé-leithead: 1; teorann-top-stíl: soladach; teorann-top-leithead: 1;"> <tr> <td ailíniú="lár"> <tábla teorann="1" leithead="100%"> <!-- I gcás gach stádas gur mhaith linn a graf, we call the "ShowBar" teimpléad. Pas muid é: 1. A lipéad le haghaidh an tsraith nua. Seo é a chlaochlú i hyperlink. 2. An gcéad (athraitheach ó thuas). 3. An t-ainm réimse iarbhír an cód as an liosta bunúsacha. Seo                      . 4. Luach réimse mheaitseáil le haghaidh #3. 5. Míreanna Iomlán an cód stádais (nach bhfuil an iomlán mhór de gach                      ). Astaíonn sé <tr></tr> agus an líne chothrománach graf barra. Glaoch orainn an teimpléad le haghaidh gach cód stádais a ba mhaith linn a fheiceáil. --> <XSL:glao-teimpléad ainm="ShowBar"> <XSL:le-param ainm="BarDisplayLabel" roghnú="'Na'"/> <XSL:le-param ainm="BarPercent" roghnú="$percentProposed"/> <XSL:le-param ainm="QueryFilterFieldName" roghnú="'Stádas'"/> <XSL:le-param ainm="QueryFilterFieldValue" roghnú="'Na'"/> <XSL:le-param ainm="TotalItems" roghnú="$totalProposed"></XSL:le-param> </XSL:glao-teimpléad> <XSL:glao-teimpléad ainm="ShowBar"> <XSL:le-param ainm="BarDisplayLabel" roghnú="'Ag fanacht'"/> <XSL:le-param ainm="BarPercent" roghnú="$percentStalled"/> <XSL:le-param ainm="QueryFilterFieldName" roghnú="'Stádas'"/> <XSL:le-param ainm="QueryFilterFieldValue" roghnú="'Ag fanacht'"/> <XSL:le-param ainm="TotalItems" roghnú="$totalStalled"></XSL:le-param> </XSL:glao-teimpléad> <XSL:glao-teimpléad ainm="ShowBar"> <XSL:le-param ainm="BarDisplayLabel" roghnú="'I Próiseas'"/> <XSL:le-param ainm="BarPercent" roghnú="$percentInProcess"/> <XSL:le-param ainm="QueryFilterFieldName" roghnú="'Stádas'"/> <XSL:le-param ainm="QueryFilterFieldValue" roghnú="'I Próiseas'"/> <XSL:le-param ainm="TotalItems" roghnú="$totalInProcess"></XSL:le-param> </XSL:glao-teimpléad> </tábla> </td> </tr> </tábla> </XSL:ar shlí eile> </XSL:roghnú> </XSL:teimpléad> <!-- Dhéanann an teimpléad seo ar obair na línte aonair sa ghraf barra a thaispeánann. Feicfidh tú a dhéanamh is dócha an chuid is mó de do tweaking anseo. --> <XSL:teimpléad ainm="ShowBar"> <XSL:stop a chur ainm="BarDisplayLabel" /> <!-- lipéad a thaispeáint --> <XSL:stop a chur ainm="BarPercent"/> <!-- Céatadán den iomlán. --> <XSL:stop a chur ainm="QueryFilterFieldName"/> <!-- A úsáidtear chun léim chuig an cheist & scagaire --> <XSL:stop a chur ainm="QueryFilterFieldValue"/> <!-- A úsáidtear chun léim chuig an cheist & scagaire --> <XSL:stop a chur ainm="TotalItems" /> <!-- líon iomlán an barlabel --> <tr> <!-- An barra lipéad féin. --> <td ranga="ms-formbody" leithead="30%"> <!-- Ceadaíonn an chéad sraith eile de ráitis go gcuireann an teaghrán cheist           . Déanaimid úsáid a bhaint as cúpla rudaí anseo: 1. Is féidir linn a pas a fháil FilterField1 agus FilterValue1 a scagadh ar colún le liosta. 2. Is SharePoint paraiméadar eochair ag dul a chur chugainn, ListUrlDir that points to the underlying list against which this DVWP is "running". Ní XSL spraoi? --> <XSL:téacs dhíchumasú-aschur-éalú="yes"> <![CDATA[<a href ="]]></XSL:téacs> <XSL:luach-ar roghnú="$ListUrlDir"/> <XSL:téacs dhíchumasú-aschur-éalú="yes"><![CDATA[?FilterField1 =]]></XSL:téacs> <XSL:luach-ar roghnú="$QueryFilterFieldName"/> <XSL:téacs dhíchumasú-aschur-éalú="yes"><![CDATA[&FilterValue1 =]]></XSL:téacs> <XSL:luach-ar roghnú="$QueryFilterFieldValue"/> <XSL:téacs dhíchumasú-aschur-éalú="yes"><![CDATA[">]]></XSL:téacs> <XSL:luach-ar roghnú="$BarDisplayLabel"/> <XSL:téacs dhíchumasú-aschur-éalú="yes"><![CDATA[</a>]]></XSL:téacs> <!-- Léiríonn an beagán eile roinnt uimhreacha san fhormáid: "(iomlán / % den iomlán)" --> (<XSL:luach-ar roghnú="$TotalItems"/> / <!-- Cruthaíonn sé seo lipéad faoin gcéad deas dúinn. Go raibh maith agat, Microsoft! --> <XSL:glao-teimpléad ainm="percentformat"> <XSL:le-param ainm="faoin gcéad" roghnú="$BarPercent"/> </XSL:glao-teimpléad>) </td> <!-- Mar fhocal scoir, scaoileann <td> tag do na barra féin.--> <td> <tábla cellpadding="0" cellspacing="0" teorann="0" leithead="{bhabhta($BarPercent * 100)+1}%"> <tr bgcolor="dearg"> <XSL:téacs dhíchumasú-aschur-éalú="yes"><![CDATA[&nbsp;]]></XSL:téacs> </tr> </tábla> </td> </tr> </XSL:teimpléad> <!-- Tá sé seo thógtar iad go díreach ó roinnt XSL a bhí ann i teimpléad MS. --> <XSL:teimpléad ainm="percentformat"> <XSL:stop a chur ainm="faoin gcéad"/> <XSL:roghnú> <XSL:nuair a tástáil="bhformáid-uimhir($faoin gcéad, '#, # # 0%;-#,##0%')= 'NaN'">0%</XSL:nuair a> <XSL:ar shlí eile> <XSL:luach-ar roghnú="bhformáid-uimhir($faoin gcéad, '#, # # 0%;-#,##0%')" /> </XSL:ar shlí eile> </XSL:roghnú> </XSL:teimpléad> </XSL:Stílbhileog>

Na Torthaí:

An XSL ó thuas Gineann an graf seo:

íomhá

Druileáil síos go dtí na sonraí bunúsacha trí chliceáil ar an cód stádais:

íomhá

Smaointe Clabhsúr:

Is féidir é seo a bheith ginearálta?

Is breá liom an coincheap Graphing, but I hate the fact that I have to go in and do so much hand-coding. I’ve given a little thought to whether it can be generalized and I’m optimistic, but I’m also a little fearful that there may be a brick wall somewhere along the path that won’t offer any work-around. If anyone has some good ideas on this, le do thoil déan nóta sa tuairimí nó ríomhphost chugam.

Graif Ingearach:

This is a horizontal bar graph. It’s certainly possible to create a vertical graph. We just need to change the HTML. I would start the same way: Create an HTML representation of a vertical bar graph and then figure out how to get that via XSL. If anyone is interested in that, I could be persuaded to try it out and work out the kinks. If someone has already done that, cuir in iúl dom agus beidh mé gladly nasc chuig do bhlag 🙂

Sílim go bhfuil dúshlán le graf ingearach go bhfuil na lipéid don ghraf níos deacra a bhainistiú, ach is cinnte nach bhfuil sé dodhéanta.

Réimse Ainm Gotcha ar:

Tá ar a laghad dhá rud chun breathnú amach le do ainmneacha réimse.

An Chéad, a field name with a space has to be escaped in the XSL. This will probably be an issue here:

        <XSL:athróg ainm="totalProposed" 
roghnú="comhaireamh(/dsQueryResponse / Rónna / Rae[normalú-spás(@ Stádas) = 'Na'])" />

If your "Status" column is actually named "Status Code" then you need to reference it as "Status_x0020_Code":

   <XSL:athróg ainm="totalProposed" 
roghnú="comhaireamh(/dsQueryResponse / Rónna / Rae[normalú-spás(@ Status_x0020_Code) = 'Na'])" />

Dara, agus mé fuzzy beag ar an, but you also need to be on the alert for field name changes. If you name your field "Status Code" agus ansin ina dhiaidh sin ar, rename it to "AFE Status", the "internal name" does not change. The internal name will still be "Status Code" and must be referenced as "Status_x0020_Code". The "other resources" Is féidir naisc seo cabhrú dhiagnóiseadh agus a cheartú chineál seo fhadhb.

Faoi sin Dath:

I picked "red" because it’s pleasing to me at the moment. It would not be a big deal to show different colors so as to provide more than just a visual description of a number, but to also provide a useful KPI. Mar shampla, if the percentage of "stalled" AFE é > 10% ansin a thaispeáint sé dearg, otherwise show it in black. Úsáid <XSL:roghnú> chun accomplish seo.

Acmhainní Eile:

Shona athrú!

<deireadh />

Liostáil le mo bhlag!

Sonraí OM Reatha Trí Liosta Chustaim (nó, Ach eile Sonraí OM Displayor [cosúil le YACC, ach éagsúla])

Sa lá atá inniu, I spent a handful of hours tracking down the root cause behind the message "The column name that you entered is already in use or reserved. Choose another name."

D'fhéadfadh an colún i gceist a chruthú, scriosadh agus ath-cruthaíodh i dtimpeallacht eile, so I knew it wasn’t a reserved name. Mar sin féin, Mé nach bhféadfaí a fháil ach an colún in áit ar bith tríd an comhéadan úsáideora caighdeánach SharePoint ag aon suíomh sa bhailiúchán láithreán.

Phost mé go Fóraim MSDN anseo agus an indomitable Andrew Woodward Léirigh mé i dtreo na sonraí bunúsacha tsamhail réad.

Chuaigh mé go dtí CodePlex a fháil ar roinnt uirlisí a bheadh ​​cabhrú liom piaraí i na sonraí OM bunúsacha agus cabhrú liom a aimsiú ar an deacracht.

Rinne mé roinnt uirlisí agus bhí siad an-fionnuar agus suimiúil ach sa deireadh, the UI wasn’t good enough for my purpose. I’m not criticizing them by any means, ach go soiléir nach raibh an uirlis-lucht bhfuil mo fhadhb i gcuimhne nuair a chruthaigh siad a n-UI :). Most people seem to be investing a fair amount of time and effort in creating workstation / iarratais cliant a chur ar fáil tuairimí crann, right-click context menus and so forth. These are nice and all, ach tá sé a lán oibre a chruthú taithí úsáideora barr-ar-an-líne go bhfuil freisin an-solúbtha.

Is gá mé i ndáiríre freagra ar an bhfadhb seo. Tharla sé domsa go má raibh mé in ann a fháil ar gach ceann de na colúin láithreán sa bhailiúchán láithreán i liosta saincheaptha, Raibh mé in ann a scagadh, shórtáil agus a chruthú tuairimí a bheadh ​​cabhrú liom teacht ar an colún supposedly atá ann cheana féin (rud a rinne sé, BTW). I went ahead and did that and an hour or two later, Bhí gach mo colúin láithreán luchtaithe isteach i liosta saincheaptha le grúpáil, sorting and so forth. I found my answer five minutes later.

Má bhíonn agus nuair mé a ghlacadh go rathúil ar fud an domhain, I think I will decree that all SharePoint tools providers must seriously consider surfacing their object model data in a custom list. That way, Tá mé an chumhacht chun cuardach a dhéanamh ar bhealach ar bith is mian liom (srianta, ar ndóigh, le caighdeán gnéithe SharePoint).