катэгорыя Архівы: SharePoint развіцця

Сцеражыцеся Крытычныя змены ў ItemStyle.xsl

Я працаваў з ItemStyle.xsl каб наладзіць знешні выгляд вэб-кантэнту Частка запытаў і мае рацыю наконт абеду, 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, заўважыў гэта паведамленне з'яўляецца ў кучу месцаў:

Не ўдаецца адлюстраваць гэтую вэб-частка. Для ліквідацыі праблемы, адкрыць гэтую вэб-старонку ў Windows SharePoint Services-сумяшчальны HTML рэдактар, напрыклад Microsoft Office SharePoint Designer. Калі праблема не ўхіленая, звярніцеся да адміністратара вэб-сервера.

Я абвінавачваў кліента (ня ведаючы яшчэ, што гэта была мая віна ў гэтым пункце) but eventually noticed that visual studio intellisense was warning me that I had malformed XSL. I corrected it and everything started working.

Цыроўкі асцярожныя пры працы з ItemStyle.xsl (і любы з глабальнага файлаў XSL) — разбіваючы іх закранае многія артэфакты ў сямействе.

<канец />

Адлюстраванне вынікаў запытаў Змесціва вэб-частку ў сетцы / Стол

Агляд і мэты

З скрынкі, MOSS’ Запыт змесціва вэб-часткі (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>

<!-- Этыкетка ->
 <тр BGCOLOR= Сіні>
 <TD><шрыфт колер= Белы><B>Назва праекта</B></шрыфт></TD>
 <TD выраўнаваць= Правы><шрыфт колер= Белы><B>Поўная дата</B></шрыфт></TD>
 <TD выраўнаваць= Правы><шрыфт колер= Белы><B>Бюджэт</B></шрыфт></TD>
 <TD выраўнаваць= Правы><шрыфт колер= Белы><B>Фактычны расход</B></шрыфт></TD>
 <TD><шрыфт колер= Белы><B>Агульны стан</B></шрыфт></TD>
 </тр>

<тр>
 <TD>Re-правадной кампутарная зала.</TD>
 <TD выраўнаваць= Правы>02/01/08</TD>
 <TD выраўнаваць= Правы>22,500.00</TD>
 <TD выраўнаваць= Правы>19,000.00</TD>
 <TD>In Progress</TD>
 </тр>

<тр>
 <TD>Прадастаўленне сервераў для абнаўлення SQL</TD>
 <TD выраўнаваць= Правы>04/01/08</TD>
 <TD выраўнаваць= Правы>7,500.00</TD>
 <TD выраўнаваць= Правы>0.00</TD>
 <TD>Запланаваны</TD>
 </тр>

</стол>
 </цэнтр>
 </цела>
</HTML>

Падыход

Выканайце наступныя крокі для стварэння сеткі:

  1. Апісанне кампанентаў сеткі (радкоў / слупкоў).
  2. Вызначыць і стварыць неабходныя слупкі сайта.
  3. Стварэнне сайтаў для суб праектаў і Сінглтан спісы.
  4. Дадаць CQWP на вэб-старонку і наладзіць яго для пошуку вашых спісаў.
  5. Змяніць XML CQWP да сабраць дадатковыя слупкі.
  6. Змяніць 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) і блог Хізэр Саламона тут (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).

Азы

Пачаць і ажыццяўляць крокі з першага па пяты ў адпаведнасці з MSDN дакументацыя і артыкулы Хізэр Саламона.

У гэты момант, вы дадалі CQWP на старонку, і ў вас ёсць <CommonViewFields> сканфігураваны як неабходныя.

Пасля звычайных крокаў, Я атрымліваю гэтыя прамежкавыя вынікі:

1. Стварыць тып кантэнту, a templatized custom list for that content type and two sites. Here is the content type:

малюнак

Вось структура сайта:

малюнак

2. Дадаць CQWP пасля стварэння майго праекта даччыных сайтаў і спісаў Сінглтан рэзюмэ праекта:

малюнак

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:коштам ад выбіраць="імя()" /><бр/>
    </XSL:для кожнага,>

4.2: Я змяніць вэб-частка, go to appearance and select my "Grid" стыль:

малюнак

Ужыць змены і вось вынік:

малюнак

Як відаць са сказанага вышэй, мы хочам палёў (Назва праекта, расход, статус, і г.д.) 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".

У гэты момант, мы сыйдзем з блога Хізэр і з плячэй гэтых гігантаў, Я дадаць уласныя трохі.

ContentQueryMain.xsl

УВАГА: Пры унясенні змяненняў у абодвух ContentQueryMain.xsl а таксама ItemStyle.xsl, Вы павінны праверыць гэтыя файлы назад у перш чым вы бачыце ўплыў змены.

Для сеткавых рашэнняў мэтаў, 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 <стол> Тэг да спрацоўвання першага радка дадзеных і закрыццё <стол> 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.

Выкарыстоўваючы тэхніку Хізэр Саламона, 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 <стол> тэгі.
  • 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:параметраў імя="CurPosition" />

    <!--
      Add the "LastRow" параметр.
      We only use it when the item style pass in is "Grid".
    -->
    <XSL:параметраў імя="LASTROW" />

    <XSL:выбіраць>
      <XSL:калі тэст="@ Стыль = 'NewsRollUpItem'">
        <XSL:Apply-шаблоны выбіраць="." рэжым="ItemStyle">
          <XSL:з параметрам- імя="EditMode" выбіраць="$cbq_iseditmode" />
        </XSL:Apply-шаблоны>
      </XSL:калі>
      <XSL:калі тэст="@ Стыль = 'NewsBigItem'">
        <XSL:Apply-шаблоны выбіраць="." рэжым="ItemStyle">
          <XSL:з параметрам- імя="CurPos" выбіраць="$CurPosition" />
        </XSL:Apply-шаблоны>
      </XSL:калі>
      <XSL:калі тэст="@ Стыль = 'NewsCategoryItem'">
        <XSL:Apply-шаблоны выбіраць="." рэжым="ItemStyle">
          <XSL:з параметрам- імя="CurPos" выбіраць="$CurPosition" />
        </XSL:Apply-шаблоны>
      </XSL:калі>

      <!--
              Перадаць бягучае становішча і LASTROW ў шаблон ItemStyle.xsl Сетка.
              ItemStyle.xsl будзе выкарыстоўваць гэта, каб выпраменьваць адкрытыя і закрыццё <стол> тэгі.
      -->
      <XSL:калі тэст="Стыль @ = "Сетка"">
        <XSL:Apply-шаблоны выбіраць="." рэжым="ItemStyle">
          <XSL:з параметрам- імя="CurPos" выбіраць="$CurPosition" />
          <XSL:з параметрам- імя="Апошні" выбіраць="$LASTROW" />
        </XSL:Apply-шаблоны>
      </XSL:калі>

      <XSL:у адваротным выпадку>
        <XSL:Apply-шаблоны выбіраць="." рэжым="ItemStyle">
        </XSL:Apply-шаблоны>
      </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:выклік-шаблону імя="OuterTemplate.CallItemTemplate">
  <XSL:з параметрам- імя="CurPosition" выбіраць="$CurPosition" />
  <!-- Устаўце параметр LASTROW. -->
  <XSL:з параметрам- імя="LASTROW" выбіраць="$LASTROW"/>
</XSL:выклік-шаблону>

Пасля ўсяго гэтага, мы, нарэшце, рэчы створаны належным чынам, каб нашы ItemStyle.xsl можа выпраменьваць <стол> тэгаў у патрэбным месцы.

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, дадайце гэты радок:

  <!-- Некаторыя фетыш, які дазваляе нам прадстаўляць U.S. валюта. -->
  <XSL:дзесятковы фармат імя="персанал" лічба="Рэ" />

  <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:шаблон імя="Сетка" супадаць="Радок[Стыль @ = "Сетка"]" рэжым="ItemStyle">

    <!--
      ContentMain.xsl праходзіць CurPos і апошні.
      Мы выкарыстоўваем гэтыя умоўна вылучаюць адкрытыя і закрыццё <стол> тэгі.
    -->
    <XSL:параметраў імя="CurPos" />
    <XSL:параметраў імя="Апошні" />

    <!-- Наступныя зменныя не змяняюцца ад стандартнага ItemStyle.xsl -->
    <XSL:пераменная імя="SafeImageUrl">
      <XSL:выклік-шаблону імя="OuterTemplate.GetSafeStaticUrl">
        <XSL:з параметрам- імя="UrlColumnName" выбіраць="'ImageUrl'"/>
      </XSL:выклік-шаблону>
    </XSL:пераменная>
    <XSL:пераменная імя="SafeLinkUrl">
      <XSL:выклік-шаблону імя="OuterTemplate.GetSafeLink">
        <XSL:з параметрам- імя="UrlColumnName" выбіраць="'LinkUrl'"/>
      </XSL:выклік-шаблону>
    </XSL:пераменная>
    <XSL:пераменная імя="DisplayTitle">
      <XSL:выклік-шаблону імя="OuterTemplate.GetTitle">
        <XSL:з параметрам- імя="Назва" выбіраць="@ Title"/>
        <XSL:з параметрам- імя="UrlColumnName" выбіраць="'LinkUrl'"/>
      </XSL:выклік-шаблону>
    </XSL:пераменная>
    <XSL:пераменная імя="LinkTarget">
      <XSL:калі тэст="@ OpenInNewWindow = 'True'" >_blank</XSL:калі>
    </XSL:пераменная>

    <!--
      Тут мы вызначаем зменную, "tableStart".  Гэты дакумент утрымлівае HTML
      .  Заўважым, што калі CurPos = 1, ён уключае ў сябе HTML ў тэгу CDATA.
      У адваротным выпадку, гэта будзе пустой.

      Значэнне tableStart з'яўляецца emited кожны раз ItemStyle выклікаецца праз
      .
    -->
    <XSL:пераменная імя="tableStart">
      <XSL:калі тэст="$CurPos = 1">
        <![CDATA[
        <мяжы табліцы = 1>
          <tr bgcolor="blue">
            <TD><font color="white"><B>Назва праекта</B></шрыфт></TD>
            <td align="right"><font color="white"><B>Поўная дата</B></шрыфт></TD>
            <td align="right"><font color="white"><B>Бюджэт</B></шрыфт></TD>
            <td align="right"><font color="white"><B>Фактычны расход</B></шрыфт></TD>
            <TD><font color="white"><B>Агульны стан</B></шрыфт></TD>
          </тр>
        ]]>
      </XSL:калі>
    </XSL:пераменная>

    <!--
      Іншая пераменная, tableEnd проста вызначае зачыняе тэг табліцы.

      Як і tableStart, гэта заўсёды emited.  Менавіта таму яго значэнне
      .
    -->
    <XSL:пераменная імя="tableEnd">
      <XSL:калі тэст="$CurPos = $ Апошняя">
        <![CDATA[ </стол> ]]>
      </XSL:калі>
    </XSL:пераменная>

    <!--
      Заўсёды выпраменьваць ўтрыманне tableStart.  Калі гэта не першы
      , то мы ведаем, яго значэнне
      .

      Забараніць маскіраванне tableStart таму што, калі ён не пусты, гэта
      .  Калі
      , it will generate
      stuff like "&л;стол&GT;" instead of "<стол>".
    -->
    <XSL:коштам ад выбіраць="$tableStart" адключыць-выхад-ўцёкі="ды"/>


    <тр>
      <!--
      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:выклік-шаблону імя="FormatCurrency">
          <XSL:з параметрам- імя="значэнне" 
выбіраць="@ Project_x005F_x0020_Budget"></XSL:з параметрам-> </XSL:выклік-шаблону> </TD> <TD выраўнаваць="права"> <XSL:выклік-шаблону імя="FormatCurrency"> <XSL:з параметрам- імя="значэнне" выбіраць="@ Project_x005F_x0020_Expenses">
</XSL:з параметрам-> </XSL:выклік-шаблону> </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}"/> </a> </спраў> </XSL:калі> <div class="link-item"> <XSL:выклік-шаблону
name="OuterTemplate.CallPresenceStatusIconTemplate"/> <a href="{$SafeLinkUrl}"
target="{$LinkTarget}" title="{@ LinkToolTip}"> <XSL:value-of select="$DisplayTitle"/> </a> <div class="description"> <XSL:value-of select="@Description" /> </спраў> </спраў> </спраў>
--> </тр> <!-- Выпраменьваюць зачыняе тэг табліцы. Калі мы не на апошнім шэрагу, гэта будзе пустой. --> <XSL:коштам ад выбіраць="$tableEnd" адключыць-выхад-ўцёкі="ды"/> </XSL:шаблон> <XSL:шаблон імя="FormatCurrency"> <XSL:параметраў імя="значэнне" выбіраць="0" /> <XSL:коштам ад выбіраць="Format-лік($значэнне, "$DDD,DDD,DDD.DD", "staff")" /> </XSL:шаблон>

Стандартны WSS / MOSS экранаў ўводу дадзеных не падтрымліваюць каскадныя выпадаючых (ці іншай ўнутры ад зносін)

АБНАЎЛЕННЕ (04/2008): Гэты вялікі запіс у блогу паказвае добрую JavaScript падыходу да вырашэння гэтай праблемы: http://webborg.blogspot.com/2008/04/add-functions-and-events-to-sharepoint.html

UPDATE II: (04/2008): Гэтая запіс у блогу выглядае шматспадзеўна, а: http://www.cleverworkarounds.com/2008/03/13/free-mosswss-2007-web-part-hide-controls-via-javascript/

Некалькі разоў на тыдзень, калі не штодня, forum users describe a requirement that would normally be met via cascading drop-downs. Напрыклад, У мяне ёсць два выпадаючых кіравання:

  • Спіс U.S. дзяржаў
  • Спіс U.S. гарадоў.

Як адказныя пастаўшчыкоў UI, мы хочам, каб працаваць, як гэта:

  • Павел выбірае U.S. state from the drop-down.
  • This causes the cities drop-down to filter only those cities that belong to the selected state.
  • Павел выбірае горад з гэтага адфільтраваным спіс.

There is no out-of-the-box support for this feature. На самай справе, 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.

Рэальная мэта гэтага артыкула, каб апісаць магчымыя рашэнні і гэтыя варыянты, як я іх ведаю:

  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. У гэтым выпадку, Вы звычайна спрабуюць выкарыстоўваць вылічаецца слупок, але некалькі разоў, 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, быць у курсе пытанняў, якія разглядаюцца на гэтая артыкул (http://paulgalvin.spaces.live.com/blog/cns!CC1EDB3DAA9B8AA!405.entry).
  3. Апрацоўшчыкі падзей: Як і працоўны працэс, 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 (і ўся аб'ектная мадэль) і можа зрабіць усе неабходныя разлікі.
  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 функцыі ўводу дадзеных (ў выглядзе асобнага вэб-старонцы або ў якасці вэб-часткі) і выкарыстоўваць яго замест.

Калі хто ведае іншыя і / або лепшыя варыянты, калі ласка, напішыце каментар, і я буду абнаўляць цела гэтага паста.

<канец />

Technorati Тэгі:

Стварыць гістаграмы ў SharePoint

Агляд:

(АБНАЎЛЕННЕ 12/04/07: Дададзены яшчэ адзін цікавы рэсурс у канцы па спасылцы на іншы блог, які вырашае гэтую праблему з дапамогай вельмі цікавы вэб-часткі)

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.

Агульны падыход заключаецца ў наступным:

  1. Стварэнне спісу або бібліятэкі дакументаў, якая змяшчае дадзеныя, якія вы хочаце графіка.
  2. Навядзіце адпаведнай бібліятэцы дакументаў / карыстацкі спіс на старонцы і пераўтварыць яго ў вэб-частцы прадстаўлення даных (DVWP).
  3. Змяніць XSL DVWP для генерацыі HTML, які паказвае ў выглядзе графіка.

Бізнес-сцэнар / Усталёўка:

Я стварыў карыстацкі спіс са стандартным загалоўкам слупка і адзін дадатковы слупок, "Status". This models (Вельмі спрошчана) an "Authorization For Expense" сцэнар, пры якім назва ўяўляе праект і статус значэння з спісу:

  • Прапанаваны
  • У працэсе
  • Запаволенне

Мэтай якой з'яўляецца стварэнне інтэрактыўнага гарызантальнай гістаграмы, якая паказвае Гэтыя коды стану.

Я населеныя спісе і гэта выглядае так:

малюнак

Стварэнне дадзеных вэб-частка:

Стварыць DVWP шляхам дадання карыстацкіх спісаў на старонку (сайта ў маім выпадку) і вынікайце інструкцыям тут (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!395.entry).

У дадатак да проста стварэнне DVWP, we also need to set the paging property to show all available rows. Для мяне, гэта выглядае прыкладна так:

малюнак

У гэты момант, 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.

Змяніць XSLT:

Прыйшоў час змяніць XSLT.

I always use visual studio for this. (Паглядзець тут Хочацца зрабіць важная заўвага аб IntelliSense, якія дапамогуць вам многае).

Я ствараю пусты праект дадаць чатыры новых файлаў (replacing the words "Original" and "New" па меры неабходнасці):

  • Original.xslt
  • New.xslt
  • Арыгінальныя Params.xml
  • Новы Params.xml

У маім выпадку, гэта выглядае так:

малюнак

Modify the web part and copy the params and XSL to the "Original" У версіі Visual Studio.

Мэта тут складаецца, каб выклікаць XSL для пераўтварэння вынікаў мы вернемся з DVWP запыту ў HTML, які адлюстроўваецца як граф.

З гэтай мэтай, it helps to first consider what the HTML should look like before we get confused by the insanity that is known as "XSL". (Каб было ясна, Наступныя проста прыклад; 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:

прыклад столбчатые

Адпаведны HTML:

<HTML>
<цела>
<цэнтр>
<Шырыня стала = 80%>
<тр><TD><цэнтр>Гарызантальная гістаграма</TD></тр>
<тр>
<td align="center">
<table border="1" шырыня = 80%>
<тр>
<TD шырыня = 10%>Адкрыць</TD>
<TD><Табліца CellPadding ="0" CELLSPACING ="0" мяжа = 0 шырыня = 50%><BGCOLOR TR = чырвоны><TD>&NBSP;</TD></тр></стол></TD>
</тр>
<тр>
<TD шырыня = 10%>Закрыта</TD>
<TD><Табліца CellPadding ="0" CELLSPACING ="0" мяжа = 0 шырыня = 25%><BGCOLOR TR = чырвоны><TD>&NBSP;</TD></тр></стол></TD>
</тр>
<тр>
<TD шырыня = 10%>Запаволенне</TD>
<TD><Табліца CellPadding ="0" CELLSPACING ="0" мяжа = 0 шырыня = 25%><BGCOLOR TR = чырвоны><TD>&NBSP;</TD></тр></стол></TD>
</тр>
</стол>
</TD>
</тр>
</стол>
</цела>
</HTML>

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

Вынас вось гэтая: У рэшце рэшт, усё, што мы робім, гэта стварэнне HTML са радкамі і слупкамі.

Шаблон 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:

  • Я пачаў з XSL па змаўчанні, што SharePoint Designer даў мне, калі я ўпершыню стварыў DVWP.
  • Я быў у стане рассячы гэты ўніз ад СДПГ 657 ліній 166 lines.
  • Я не важдацца з XML-файла параметраў (якая з'яўляецца асобнай ад XSL, і вы будзеце ведаць, што я маю на ўвазе, калі вы ідзяце, каб змяніць сябе DVWP; Ёсць два файла можна змяніць). Аднак, для таго, каб спрасціць, 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. Затым, remove my calls and insert your own calls to "ShowBar".
  • Дэталізацыі працуе шляхам стварэння <HREF> вось так: http://server/List?FilterField1=fieldname&FilterValue1=actualFilterValue. This technique may be of value in other contexts. At first, Я думаў, што трэба, каб адпавядаць больш складаны фармат: 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.

Вось яна:

<XSL:стыляў версія="1.0" выключаюць-вынік-прэфіксы="RS Z O S DDWRT DT msxsl" 
XMLNS:msxsl="урна:схемы-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:аспід="HTTP://schemas.microsoft.com/ASPNET/20" XMLNS:DDWRT="HTTP://schemas.microsoft.com/WebParts/v2/DataView/runtime"
XMLNS:пра="урна:схемы-Microsoft-COM:офіс" XMLNS:з="UUID:BDC6E3F0-6DA3-11D1-A2A3-00AA00C14882"
XMLNS:DT="UUID:C2F41010-65B3-11D1-A29F-00AA00C14882" XMLNS:RS="урна:схемы-Microsoft-COM:Набор радкоў" XMLNS:Z="#RowsetSchema"
XMLNS:ddwrt2="урна:Галоўная:ўнутраны"
> <XSL:выхадны метад="HTML" водступ="няма" /> <XSL:дзесятковы фармат NaN="" /> <XSL:параметраў імя="ListUrlDir"></XSL:параметраў> <!-- Мне гэта трэба для падтрымкі дэталізацыі. --> <XSL:шаблон супадаць="/" XMLNS:SharePoint="Microsoft.SharePoint.WebControls"
XMLNS:__designer=http://schemas.microsoft.com/WebParts/v2/DataView/designer XMLNS:аспід="HTTP://schemas.microsoft.com/ASPNET/20"
> <XSL:пераменная імя="dvt_StyleName">Стол</XSL:пераменная> <XSL:пераменная імя="Радкі" выбіраць="/dsQueryResponse / Радкі / радкоў" /> <XSL:пераменная імя="dvt_RowCount" выбіраць="лічыць($Радкі)" /> <XSL:пераменная імя="IsEmpty" выбіраць="$dvt_RowCount = 0" /> <XSL:пераменная імя="dvt_IsEmpty" выбіраць="$dvt_RowCount = 0" /> <XSL:выбіраць> <XSL:калі тэст="$dvt_IsEmpty"> Там няма дадзеных для пабудовы графікаў!<бр/> </XSL:калі> <XSL:у адваротным выпадку> <!-- Цікавае пачынаецца тут. Нам неабходна вызначыць пару зменных для кожнага радка ў графе: агульная колькасць           . --> <XSL:пераменная імя="totalProposed" выбіраць="лічыць(/dsQueryResponse / Радкі / радкоў[нармалізаваць прастору(@ Статус) = 'Прапанаваная'])" /> <XSL:пераменная імя="percentProposed" выбіраць="$totalProposed DIV $ dvt_RowCount" /> <XSL:пераменная імя="totalInProcess" выбіраць="лічыць(/dsQueryResponse / Радкі / радкоў[нармалізаваць прастору(@ Статус) = 'У працэсе'])" /> <XSL:пераменная імя="percentInProcess" выбіраць="$totalInProcess DIV $ dvt_RowCount" /> <XSL:пераменная імя="totalStalled" выбіраць="лічыць(/dsQueryResponse / Радкі / радкоў[нармалізаваць прастору(@ Статус) = 'Запаволенне'])" /> <XSL:пераменная імя="percentStalled" выбіраць="$totalStalled DIV $ dvt_RowCount" /> <!-- Мы вызначаем HTML стол тут. Я запазычанні з некаторых стандартных           . Я думаю, што будзе выконваць           . --> <стол шырыня="100%" CELLSPACING="0" CellPadding="2" стыль="мяжы правы: 1 цвёрдых # C0C0C0; ніжняй мяжы: 1 цвёрдых # C0C0C0; мяжы левага стылі: цвёрды; мяжы левага шырыні: 1; мяжы верхняга стылю: цвёрды; мяжы верхняга шырыня: 1;"> <тр> <TD выраўнаваць="цэнтр"> <стол мяжа="1" шырыня="100%"> <!-- Для кожнага статусу, які мы хочам графіка, we call the "ShowBar" шаблон. Мы перадаем гэта: 1. Пазнаку для радкі. Гэта ператвараецца ў гіперспасылку. 2. Адсоткаў (Невялікі зверху). 3. Фактычнае імя поля кода з базавага спісу. Гэта                      . 4. Значэнне поля супастаўныя па #3. 5. Усяго сцёк гэтага кода стану (ня агульны вынік усіх                      ). Ён выпраменьвае <тр></тр> і гарызантальнай лініі гістаграмы. Мы называем гэта шаблон для кожнага кода стану мы хочам, каб паглядзець. --> <XSL:выклік-шаблону імя="Showbar"> <XSL:з параметрам- імя="BarDisplayLabel" выбіраць=""Прапанаваны""/> <XSL:з параметрам- імя="BarPercent" выбіраць="$percentProposed"/> <XSL:з параметрам- імя="QueryFilterFieldName" выбіраць=""Статус""/> <XSL:з параметрам- імя="QueryFilterFieldValue" выбіраць=""Прапанаваны""/> <XSL:з параметрам- імя="TotalItems" выбіраць="$totalProposed"></XSL:з параметрам-> </XSL:выклік-шаблону> <XSL:выклік-шаблону імя="Showbar"> <XSL:з параметрам- імя="BarDisplayLabel" выбіраць=""Запаволенне""/> <XSL:з параметрам- імя="BarPercent" выбіраць="$percentStalled"/> <XSL:з параметрам- імя="QueryFilterFieldName" выбіраць=""Статус""/> <XSL:з параметрам- імя="QueryFilterFieldValue" выбіраць=""Запаволенне""/> <XSL:з параметрам- імя="TotalItems" выбіраць="$totalStalled"></XSL:з параметрам-> </XSL:выклік-шаблону> <XSL:выклік-шаблону імя="Showbar"> <XSL:з параметрам- імя="BarDisplayLabel" выбіраць="«У працэсе»"/> <XSL:з параметрам- імя="BarPercent" выбіраць="$percentInProcess"/> <XSL:з параметрам- імя="QueryFilterFieldName" выбіраць=""Статус""/> <XSL:з параметрам- імя="QueryFilterFieldValue" выбіраць="«У працэсе»"/> <XSL:з параметрам- імя="TotalItems" выбіраць="$totalInProcess"></XSL:з параметрам-> </XSL:выклік-шаблону> </стол> </TD> </тр> </стол> </XSL:у адваротным выпадку> </XSL:выбіраць> </XSL:шаблон> <!-- Гэты шаблон робіць працу адлюстравання асобных ліній у гістаграме. Вы, верагодна, рабіць большую частку вашай налады тут. --> <XSL:шаблон імя="Showbar"> <XSL:параметраў імя="BarDisplayLabel" /> <!-- этыкетцы, каб паказаць --> <XSL:параметраў імя="BarPercent"/> <!-- Працэнт ад агульнай. --> <XSL:параметраў імя="QueryFilterFieldName"/> <!-- Выкарыстоўваецца для пераходу да запыту & фільтрацыю --> <XSL:параметраў імя="QueryFilterFieldValue"/> <!-- Выкарыстоўваецца для пераходу да запыту & фільтрацыю --> <XSL:параметраў імя="TotalItems" /> <!-- Агульная колькасць гэтага barlabel --> <тр> <!-- У бары сам лэйбл. --> <TD клас="MS-formbody" шырыня="30%"> <!-- Гэта наступны набор аператараў будуе радок запыту, якая дазваляе           . Мы выкарыстоўваем некалькі рэчаў тут: 1. Мы можам перадаць FilterField1 і FilterValue1 ў спіс для фільтрацыі на калонцы. 2. SharePoint праходзіць ключавым параметрам для нас, ListUrlDir that points to the underlying list against which this DVWP is "running". Хіба гэта не весела XSL? --> <XSL:тэкст адключыць-выхад-ўцёкі="ды"> <![CDATA[<HREF ="]]></XSL:тэкст> <XSL:коштам ад выбіраць="$ListUrlDir"/> <XSL:тэкст адключыць-выхад-ўцёкі="ды"><![CDATA[?FilterField1 =]]></XSL:тэкст> <XSL:коштам ад выбіраць="$QueryFilterFieldName"/> <XSL:тэкст адключыць-выхад-ўцёкі="ды"><![CDATA[&FilterValue1 =]]></XSL:тэкст> <XSL:коштам ад выбіраць="$QueryFilterFieldValue"/> <XSL:тэкст адключыць-выхад-ўцёкі="ды"><![CDATA[">]]></XSL:тэкст> <XSL:коштам ад выбіраць="$BarDisplayLabel"/> <XSL:тэкст адключыць-выхад-ўцёкі="ды"><![CDATA[</a>]]></XSL:тэкст> <!-- Наступны біт паказвае некаторыя нумары ў фармаце: "(агульны / % ад агульнай колькасці)" --> (<XSL:коштам ад выбіраць="$TotalItems"/> / <!-- Гэта стварае прыгожую этыкетку працэнтаў для нас. Дзякуй, Microsoft! --> <XSL:выклік-шаблону імя="PercentFormat"> <XSL:з параметрам- імя="працэнт" выбіраць="$BarPercent"/> </XSL:выклік-шаблону>) </TD> <!-- У рэшце рэшт, выпускаць <TD> тэг для самога бара.--> <TD> <стол CellPadding="0" CELLSPACING="0" мяжа="0" шырыня="{вакол($BarPercent * 100)+1}%"> <тр BGCOLOR="чырвоны"> <XSL:тэкст адключыць-выхад-ўцёкі="ды"><![CDATA[&NBSP;]]></XSL:тэкст> </тр> </стол> </TD> </тр> </XSL:шаблон> <!-- Гэта ўзята непасрэдна з некаторых XSL я знайшоў у шаблоне MS. --> <XSL:шаблон імя="PercentFormat"> <XSL:параметраў імя="працэнт"/> <XSL:выбіраць> <XSL:калі тэст="Format-лік($працэнт, '#, # # 0%;-#,##0%")= 'NaN'">0%</XSL:калі> <XSL:у адваротным выпадку> <XSL:коштам ад выбіраць="Format-лік($працэнт, '#, # # 0%;-#,##0%")" /> </XSL:у адваротным выпадку> </XSL:выбіраць> </XSL:шаблон> </XSL:стыляў>

Вынікі:

XSL зверху генеруе гэты графік:

малюнак

Перайдзіце да базавых дадзеных, націснуўшы на код стану:

малюнак

Заключэнне Думак:

Ці можа гэта быць абагульнены?

Я люблю гэтую канцэпцыю графічнага, 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, калі ласка, запішыце ў каментарах або напішыце мне.

Вертыкальныя Графікі:

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, калі ласка, дайце мне ведаць, і я з задавальненнем спасылку на свой блог 🙂

Я думаю, што праблема з вертыкальнай граф тым, што цэтлікі для графа цяжэй кіраваць, але, вядома, не выключана,.

Імя поля Гоча:

Ёсць, па меншай меры, дзве рэчы, якія трэба паглядзець з вашымі імёнамі палёў.

Першы, a field name with a space has to be escaped in the XSL. This will probably be an issue here:

        <XSL:пераменная імя="totalProposed" 
выбіраць="лічыць(/dsQueryResponse / Радкі / радкоў[нармалізаваць прастору(@ Статус) = 'Прапанаваная'])" />

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

   <XSL:пераменная імя="totalProposed" 
выбіраць="лічыць(/dsQueryResponse / Радкі / радкоў[нармалізаваць прастору(@ Status_x0020_Code) = 'Прапанаваная'])" />

Другі, і я трохі невыразнай на гэтым, but you also need to be on the alert for field name changes. If you name your field "Status Code" а потым на, 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" спасылкі могуць дапамагчы дыягнаставаць і выправіць гэтую праблему.

Пра тое, што колер:

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. Напрыклад, if the percentage of "stalled" AFE з'яўляецца > 10% затым паказаць яго чырвоным, otherwise show it in black. Выкарыстоўваць <XSL:выбіраць> для дасягнення гэтай мэты.

Іншыя рэсурсы:

Шчаслівыя пераўтварэнні!

<канец />

Падпісацца на мой блог!

Прадстаўленне даных праз спіс OM Карыстальніцкія (або, Яшчэ адзін OM дадзеных Displayor [як YACC, але розныя])

Сёння, 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."

Слупка ў пытанне можа быць створаны, выдаліць і стварыць наноў у іншым асяроддзі, so I knew it wasn’t a reserved name. Аднак, Я проста не мог знайсці калонку ў любым месцы праз стандартны інтэрфейс карыстальніка SharePoint ў любым месцы ў сямействе.

Я адправіў да Форумы MSDN тут і нястрымнай Andrew Woodward паказаў мне ў напрамку зыходных дадзеных аб'ектнай мадэлі.

Я пайшоў, каб CodePlex знайсці некаторыя інструменты, якія дапамаглі б мне зазірнуць у зыходныя дадзеныя OM і дапамагчы мне знайсці праблему.

Я паспрабаваў некалькі інструментаў, і яны былі вельмі крута і цікава, але ў рэшце рэшт, the UI wasn’t good enough for my purpose. I’m not criticizing them by any means, але відавочна, што інструмент-мейкера не было маёй праблемай на ўвазе, калі яны стварылі сваю UI :). Most people seem to be investing a fair amount of time and effort in creating workstation / кліенцкіх прыкладанняў, якія забяспечваюць дрэва праглядаў, right-click context menus and so forth. These are nice and all, але гэта вялікая праца для стварэння топ-оф-лініі карыстацкі досвед, які таксама вельмі гнуткая.

Я сапраўды меў патрэбу ў адказ на гэтае пытанне. Мне прыйшло ў галаву, што калі б я мог атрымаць усе слупкі сайта ў сямействе сайтаў у карыстацкі спіс, Я мог выбіраць, сартаваць і ствараць паданні, якія дапамаглі б мне знайсці гэтага нібыта існуючага слупка (што ён і зрабіў, Дарэчы). I went ahead and did that and an hour or two later, былі ўсе мае калонкі сайт загружаецца ў карыстацкі спіс з групоўкай, sorting and so forth. I found my answer five minutes later.

Калі і калі я паспяхова захапіць уладу над светам, I think I will decree that all SharePoint tools providers must seriously consider surfacing their object model data in a custom list. That way, У мяне ёсць сіла шукаць любое, як я хачу (абмежаваны, вядома, стандартнымі функцыямі SharePoint).