ডিসেম্বর | 2007 | পল Galvin এর 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.

The overall approach is as follows:

Create a list or document library that contains the data you want to graph.
Place the associated document library / custom list onto a page and convert it to a data view web part (DVWP).
Modify the DVWP’s XSL to generate HTML that shows as a graph.

ব্যবসা দৃশ্যকল্প / সেটআপ:

I have created a custom list with the standard Title column and one additional column, "Status". This models (very simplistically) 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. (দেখুন এখানে for an important note about intellisense that will help you a lot).

I create an empty project add four new files (replacing the words "Original" and "New" as appropriate):

Original.xslt
New.xslt
Original Params.xml
New Params.xml

আমার কেস, এটা ভালো দেখায়:

Modify the web part and copy the params and XSL to the "Original" ভিসুয়াল স্টুডিও সংস্করণ.

এখানে উদ্দেশ্য XSL গ্রাফ হিসাবে উপস্থাপনা করে HTML এর মধ্যে DVWP ক্যোয়ারী থেকে আমরা ফিরে পেতে ফলাফল রুপান্তর হতে হয়.

এই শেষ, 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>
<শরীর>
<কেন্দ্র>
<টেবিল প্রস্থ = 80%>
<tr><td><কেন্দ্র>Horizontal Bar Graph</td></tr>
<tr>
<td align="center">
<table border="1" প্রস্থ = 80%>
<tr>
<Td প্রস্থ = 10%>খুলুন</td>
<td><টেবিল = cellpadding"0" = cellspacing"0" সীমানা = 0 প্রস্থ = 50%><TR bgcolor = লাল><td> </td></tr></টেবিল></td>
</tr>
<tr>
<Td প্রস্থ = 10%>বন্ধ</td>
<td><টেবিল = cellpadding"0" = cellspacing"0" সীমানা = 0 প্রস্থ = 25%><TR bgcolor = লাল><td> </td></tr></টেবিল></td>
</tr>
<tr>
<Td প্রস্থ = 10%>স্থগিত</td>
<td><টেবিল = cellpadding"0" = cellspacing"0" সীমানা = 0 প্রস্থ = 25%><TR bgcolor = লাল><td> </td></tr></টেবিল></td>
</tr>
</টেবিল>
</td>
</tr>
</টেবিল>
</শরীর>
</HTML>

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

নিন-দূরে এখানে এই হল: শেষ পর্যন্ত, আমরা করছেন সব সারি এবং কলাম সঙ্গে এইচটিএমএল তৈরি হয়.

টেমপ্লেট 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:

আমি প্রথম DVWP তৈরি করার সময় SharePoint ডিজাইনার সম্পর্কে দিয়েছেন ডিফল্ট XSL শুরু.
আমি SPD এর থেকে এই নিচে কাটা করতে পারবেন 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".
The drill down works by creating an <একটি href> এমন: http://server/List?FilterField1=fieldname&FilterValue1=actualFilterValue. This technique may be of value in other contexts. প্রথমে, I thought I would need to conform to a more complex format: 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.

Here it is:

<xsl:স্টাইলশীট সংস্করণ="1.0" exclude-result-prefixes="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:কস্পমান="HTTP://schemas.microsoft.com/ASPNET/20" xmlns:ddwrt="HTTP://schemas.microsoft.com/WebParts/v2/DataView/runtime" 
 xmlns:দী="urn:schemas-microsoft-com:অফিস" xmlns:গণ="uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882" 
 xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:টকা="urn:schemas-microsoft-com:rowset" xmlns:z-র="#RowsetSchema" 
 xmlns:ddwrt2="urn:frontpage:অভ্যন্তরীণ">
  <xsl:উত্পাদন পদ্ধতি="HTML" ইন্ডেন্ট="কোন" />
  <xsl:দশমিক ফরম্যাট Nan="" />
  <xsl:PARAM নাম="ListUrlDir"></xsl:PARAM> <!-- আমি একটি ড্রিল ডাউন সমর্থন এই প্রয়োজন.  -->

  <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" />

        <!--
          We define our HTML table here.  I'm borrowing from some standard
          SharePoint styles here to make it consistent.  I think it will honor
          changes to the global css file as well as theme overrides.
        -->
        <টেবিল প্রস্থ="100%" cellspacing="0" cellpadding="2"
শৈলী="border-right: 1 solid #C0C0C0; border-bottom: 1 solid #C0C0C0; border-left-style: solid; border-left-width: 1; border-top-style: solid; border-top-width: 1;">

           <tr>
            <td সারিবদ্ধ="কেন্দ্র">
              <টেবিল সীমানা="1" প্রস্থ="100%">

                <!--
                  For each status that we want to graph, we call the "ShowBar" টেমপ্লেট.
                  We pass it:
                  1. A label for the row.  This is transformed into a hyperlink.
                  2. The percent (variable from above).
                  3. The actual field name of the code from the underlying list.  This
                     does not need to match the display label.
                  4. Field value matched for #3.
                  5. Total items of this status code (not the grand total of all
                     status codes).

                  It emits a <tr></tr> and the horizontal bar graph line.

                  We call this template for each status code we want to view.
                -->
                <xsl:কল-ফর্মা নাম="ShowBar">
                  <xsl:সঙ্গে PARAM নাম="BarDisplayLabel" নির্বাচন করা="'Proposed'"/>
                  <xsl:সঙ্গে PARAM নাম="BarPercent" নির্বাচন করা="$percentProposed"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldName" নির্বাচন করা="'Status'"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldValue" নির্বাচন করা="'Proposed'"/>
                  <xsl:সঙ্গে PARAM নাম="TotalItems" নির্বাচন করা="$totalProposed"></xsl:সঙ্গে PARAM>
                </xsl:কল-ফর্মা>

                <xsl:কল-ফর্মা নাম="ShowBar">
                  <xsl:সঙ্গে PARAM নাম="BarDisplayLabel" নির্বাচন করা="'Stalled'"/>
                  <xsl:সঙ্গে PARAM নাম="BarPercent" নির্বাচন করা="$percentStalled"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldName" নির্বাচন করা="'Status'"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldValue" নির্বাচন করা="'Stalled'"/>
                  <xsl:সঙ্গে PARAM নাম="TotalItems" নির্বাচন করা="$totalStalled"></xsl:সঙ্গে PARAM>
                </xsl:কল-ফর্মা>

                <xsl:কল-ফর্মা নাম="ShowBar">
                  <xsl:সঙ্গে PARAM নাম="BarDisplayLabel" নির্বাচন করা="'In Process'"/>
                  <xsl:সঙ্গে PARAM নাম="BarPercent" নির্বাচন করা="$percentInProcess"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldName" নির্বাচন করা="'Status'"/>
                  <xsl:সঙ্গে PARAM নাম="QueryFilterFieldValue" নির্বাচন করা="'In Process'"/>
                  <xsl:সঙ্গে PARAM নাম="TotalItems" নির্বাচন করা="$totalInProcess"></xsl:সঙ্গে PARAM>
                </xsl:কল-ফর্মা>

              </টেবিল>
            </td>
          </tr>
        </টেবিল>
      </xsl:অন্যথায়>
    </xsl:নির্বাচন করা>
  </xsl:টেমপ্লেট>

  <!--
    This template does the work of displaying individual lines in the bar graph.

    You'll probably do most of your tweaking here.
  -->
  <xsl:টেমপ্লেট নাম="ShowBar">
    <xsl:PARAM নাম="BarDisplayLabel" /> <!-- label to show -->
    <xsl:PARAM নাম="BarPercent"/> <!-- Percent of total. -->
    <xsl:PARAM নাম="QueryFilterFieldName"/> <!-- Used to jump to the query & filter -->
    <xsl:PARAM নাম="QueryFilterFieldValue"/> <!-- Used to jump to the query & filter -->
    <xsl:PARAM নাম="TotalItems" /> <!-- total count of this barlabel -->

    <tr>

      <!-- The bar label itself. -->
      <td বর্গ="ms-formbody" প্রস্থ="30%">

        <!--
          This next set of statements builds a query string that allows
          us to drill down to a filtered view of the underlying data.
          We make use of a few things here:
          1. We can pass FilterField1 and FilterValue1 to a list to filter on a column.
          2. SharePoint is passing a key parameter to us, ListUrlDir that points to
             the underlying list against which this DVWP is "running".

          Isn't XSL fun?
        -->
        <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ">
        <![CDATA[<একটি href ="]]></xsl:পাঠ>
        <xsl:মান-এর নির্বাচন করা="$ListUrlDir"/>
        <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ"><![CDATA[?FilterField1=]]></xsl:পাঠ>
        <xsl:মান-এর নির্বাচন করা="$QueryFilterFieldName"/>
        <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ"><![CDATA[&FilterValue1=]]></xsl:পাঠ>
        <xsl:মান-এর নির্বাচন করা="$QueryFilterFieldValue"/>
        <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ"><![CDATA[">]]></xsl:পাঠ>
        <xsl:মান-এর নির্বাচন করা="$BarDisplayLabel"/>
        <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ"><![CDATA[</একটি>]]></xsl:পাঠ>

        <!-- The next bit shows some numbers in the format: "(total / % of total)" -->
        (<xsl:মান-এর নির্বাচন করা="$TotalItems"/> /

        <!-- This creates a nice percent label for us.  ধন্যবাদ, Microsoft! -->
        <xsl:কল-ফর্মা নাম="percentformat">
          <xsl:সঙ্গে PARAM নাম="percent" নির্বাচন করা="$BarPercent"/>
        </xsl:কল-ফর্মা>)

      </td>

      <!-- পরিশেষে, emit a <td> tag for the bar itself.-->
      <td>
        <টেবিল cellpadding="0" cellspacing="0" সীমানা="0"
প্রস্থ="{round($BarPercent*100)+1}%">
          <tr bgcolor="red">
            <xsl:পাঠ নিষ্ক্রিয়-আউটপুট-escaping="হ্যাঁ"><![CDATA[&nbsp;]]></xsl:পাঠ>
          </tr>
        </টেবিল>
      </td>
    </tr>

  </xsl:টেমপ্লেট>

  <!-- This is taken directly from some XSL I found in an MS template. -->
  <xsl:টেমপ্লেট নাম="percentformat">
    <xsl:PARAM নাম="percent"/>
    <xsl:নির্বাচন করা>
      <xsl:যখন পরীক্ষা="বিন্যাস-সংখ্যা($percent, '#,##0%;-#,##0%')= 'NaN'">0%</xsl:যখন>
      <xsl:অন্যথায়>
        <xsl:মান-এর নির্বাচন করা="বিন্যাস-সংখ্যা($percent, '#,##0%;-#,##0%')" />
      </xsl:অন্যথায়>
    </xsl:নির্বাচন করা>
  </xsl:টেমপ্লেট>

</xsl:স্টাইলশীট>

The Results:

The XSL from above generates this graph:

Drill down to the underlying data by clicking on the status code:

Concluding Thoughts:

Can This Be Generalized?

I love this graphing concept, 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, please make a note in the comments or আমাকে ইমেইল.

Vertical Graphs:

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, please let me know and I’ll gladly link to your blog 🙂

I think that challenge with a vertical graph is that the labels for the graph are more difficult to manage, but certainly not impossible.

Field Name Gotcha’s:

There are at least two things to look out for with your field names.

প্রথম, 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) = 'প্রস্তাবিত'])" />
দ্বিতীয়, and I’m a little fuzzy on this, but you also need to be on the alert for field name changes. If you name your field "Status Code" and then later on, 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" links may help diagnose and correct this kind of problem.

About that Color:

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’s is > 10% then show it red, otherwise show it in black. ব্যবহার <xsl:নির্বাচন করা> to accomplish this.

Other Resources:

Determine the internal name (and other good info) for the data in a list: http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!134.entry
Show all the data provided by SharePoint (কাঁচা এক্সএমএল): http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!190.entry
একটি নির্দিষ্ট কলামের xpath প্রকাশ করুন: http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!155.entry
OWA ব্যবহার করে আরেকটি পন্থা(?). I have not dug into it, কিন্তু প্রতিশ্রুতি দেখায়, বিশেষ করে পাই চার্ট জন্য: http://www.waka.dk/Blog/PermaLink,guid,e2532e71-d774-4ac9-8f25-883964b830f4.aspx

রূপান্তর শুভ!

<শেষ />

আমার ব্লগ এর জন্য সাবস্ক্রাইব করুন!

Technorati বিভাগ: SharePoint, DVWP, ডেটা দেখান ওয়েব পার্ট, XSL, XSLT, WSS, শৈবাল

পল Galvin এর SharePoint মহাশূন্য

মাসিক আর্কাইভ: ডিসেম্বর 2007

SharePoint মধ্যে বার গ্রাফ নির্মাণ