Översikt:
(UPPDATERING 12/04/07: Lagt till en annan intressant resurs i slutet som länkar till en annan blogg som behandlar detta via en mycket intressant webbdel)
Denna bloggpost beskriver hur du skapar ett diagram i SharePoint. Detta fungerar i både WSS och MOSS miljöer som det bara beror på datavywebbdelen.
Den övergripande strategin är följande:
- Skapa en lista eller ett dokumentbibliotek som innehåller de data du vill rita grafer.
- Placera tillhörande dokumentbiblioteket / anpassad lista på en sida och konvertera den till en datavywebbdel (DVWP).
- Ändra den DVWP XSL för att generera HTML som visas som ett diagram.
Affärsscenario / Setup:
Jag har skapat en anpassad lista med kolumnen standard och en ytterligare kolumn, "Status". Denna modeller (mycket förenklat) "tillstånd för utgift" scenario där titeln representerar projektet och Status ett värde från listan över:
- Föreslås
- I processen
- Avstannat
Målet är att producera ett interaktivt horisontella stapeldiagram som visar dessa statuskoder.
Jag har fylls listan och det ser ut så här:
Skapa datavywebbdelen:
Skapa en DVWP genom att lägga till den anpassade listan till en sida (sida i mitt fall) och följ instruktionerna Här (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!395.entry).
Förutom att helt enkelt skapa en DVWP, Vi måste också ange egenskapen personsökning att visa alla tillgängliga rader. För mig, Detta ser ut så här:
Vid denna punkt, Jag stänger alltid SPD och webbläsaren. Jag sedan öppna åter sidan med webbläsaren. Detta undviker misstag mucking upp del Webblayout på sidan.
Ändra XSLT:
Nu är det dags att ändra XSLT.
Jag använda alltid visual studio för detta. (Se Här för en viktig anmärkning om intellisense som kommer hjälpa dig mycket).
Jag skapar ett tomt projekt lägga till fyra nya filer (ersätta orden "Original" och "ny" i förekommande fall):
- Original.XSLT
- New.XSLT
- Ursprungliga Params.xml
- Nya Params.xml
I mitt fall, Det ser ut så här:
Ändra webbdelen och kopiera params och XSL till det "ursprungliga" version i Visual Studio.
Målet är att orsaka XSL: att omvandla de resultat vi får tillbaka från DVWP frågan till HTML som visas som ett diagram.
I detta syfte, Det bidrar till att först överväga hur HTML-koden ska se ut innan vi blir förvirrade av vansinne som är känd som "XSL". (Att vara tydlig, Följande är bara ett exempel; inte skriva eller klistra in visual studio. Jag ger ett fullt slag som utgångspunkt för att senare på uppskrivning). Följande exempel diagram återges enligt HTML omedelbart efter:
Motsvarande HTML:
<HTML> <organ> <Center> <tabell bredd = 80%> <TR><TD><Center>Horisontella stapeldiagram</TD></TR> <TR> <TD align = "center"> <Table border = "1" bredd = 80%> <TR> <TD bredd = 10%>Öppna</TD> <TD><tabell cellpadding ="0" CellSpacing ="0" border = 0 bredd = 50%><TR bgcolor = röd><TD> </TD></TR></tabell></TD> </TR> <TR> <TD bredd = 10%>Stängt</TD> <TD><tabell cellpadding ="0" CellSpacing ="0" border = 0 bredd = 25%><TR bgcolor = röd><TD> </TD></TR></tabell></TD> </TR> <TR> <TD bredd = 10%>Avstannat</TD> <TD><tabell cellpadding ="0" CellSpacing ="0" border = 0 bredd = 25%><TR bgcolor = röd><TD> </TD></TR></tabell></TD> </TR> </tabell> </TD> </TR> </tabell> </organ> </HTML> |
Jag använde en död enkel metod att skapa min barer genom att ange bakgrundsfärgen på en rad i "röd".
Den take-away här är detta: I slutet, allt vi gör är att skapa HTML med rader och kolumner.
Mallen XSLT:
Jag har kopierat den XSLT som genererar ett horisontellt stapeldiagram. Det är ganska väl kommenterade så jag inte kommer lägga mycket här utom dessa anteckningar:
- Jag började med standard-XSL som SharePoint Designer gav mig när jag först skapade DVWP.
- Jag kunde skära ner detta från SPD: s 657 linjer för att 166 linjerna.
- Jag röra inte runt med parametrar XML-filen (som är separat från XSL och du vet vad jag menar när du går till ändra DVWP sig; Det finns två filer kan du ändra). Men, för att förenkla det, Jag tog bort nästan alla av dem från XSL. Detta innebär att om du vill göra använda av dessa parametrar, du behöver bara lägga till deras varierande definitioner tillbaka till XSL. Det blir lätt eftersom du har de ursprungliga XSL varierande definitionerna i din visual studio-projekt.
- Du borde kunna kopiera och klistra in detta direkt i din visual studio-projekt. Sedan, ta bort mina samtal och sätt dina egna samtal till "ShowBar".
- Nedrullningen verk genom att skapa en <en href> Gillar det här: http://server/List?FilterField1=fieldname&FilterValue1=actualFilterValue. Denna teknik kan vara av värde i andra sammanhang. Först, Jag trodde jag skulle behöva följa en mer komplex format: http://server/List/AllItems.aspx?View={guid}&FilterField1=blah&FilterValue1=blah, men i min omgivning som inte är nödvändig. Listans URL skickas till oss med SharePoint så detta är ganska lätt att generalisera.
Här är det:
<XSL:Stylesheet version="1.0" Uteslut-resultat-prefix="rs z o s ddwrt dt msxsl" |
Resultaten:
XSL från ovan genererar denna graf:
Detaljgranska ned till underliggande data genom att klicka på statuskoden:
Avslutande tankar:
Detta kan generaliseras?
Jag älskar detta grafritande koncept, men jag hatar att jag måste gå in och göra så mycket hand-kodning. Jag har gett en liten tanke till huruvida det kan generaliseras och jag är optimistisk, men jag är också lite rädd att det kan finnas en tegelvägg någonstans längs den väg som inte erbjuder någon verk-runt omkring. Om någon har några bra idéer på detta, notera i kommentarerna eller maila mig.
Vertikala diagram:
Detta är ett horisontellt stapeldiagram. Det är säkert möjligt att skapa en lodrät graf. Vi behöver bara ändra HTML. Jag skulle börja på samma sätt: Skapa en HTML-återgivning av en vertikal stapeldiagram och sedan räkna ut hur man få det via XSL. Om någon är intresserad av att, Jag skulle kunna övertalas att prova och träna på kinks. Om någon redan har gjort det, låt mig veta så länkar jag gärna till din blogg 🙂
Jag tror att utmaningen med en vertikal graf är att etiketterna för grafen är svårare att hantera, men absolut inte omöjligt.
Fältet Namn Gotcha:
Det finns åtminstone två saker att se upp för med ditt namn.
Första, ett namn med en utrymme har avbrottstecken i XSL. Detta kommer troligen vara en fråga här:
<XSL:variabel Namn="totalProposed"
Välj="greve(/dsQueryResponse/rader/rad[normalisera-space(@Status) = "Föreslås"])" />
Om din "Status" kolumn heter faktiskt "statuskod" då måste du referera till den som "Status_x0020_Code":
<XSL:variabel Namn="totalProposed"
Välj="greve(/dsQueryResponse/rader/rad[normalisera-space(@Status_x0020_Code) = "Föreslås"])" />Andra, och jag är lite otydlig på detta, men du måste också vara på alerten för fältet namn ändras. Om du ger ditt område "statuskod" och senare på, döp om den till "AFE Status", det interna namnet"" ändrar inte. Det interna namnet kommer "statuskod" och måste refereras som "Status_x0020_Code". "Andra resurser" Länkar hjälpa diagnostisera och korrigera denna typ av problem.
Om färgen:
Jag plockade "röd" eftersom det är tilltalande för mig just nu. Det skulle inte vara en stor sak att visa olika färger för att ge mer än bara en visuell beskrivning av ett antal, men att också ge en användbar KPI. Till exempel, om andelen "avstannat" AFES är > 10% då Visa det röda, annars visas det i svart. Användning <XSL:Välj> att uppnå detta.
Andra resurser:
- Fastställa interna namn (och annan bra info) för data i en lista: http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!134.entry
- Visa alla data som tillhandahålls av SharePoint (rå XML): http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!190.entry
- Få XPATH-uttrycket för en specifik kolumn: http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!155.entry
- En annan metod med OWA(?). Jag har inte grävt i det, men ser lovande ut, särskilt för cirkeldiagram: http://www.waka.dk/Blog/PermaLink,guid,e2532e71-d774-4ac9-8f25-883964b830f4.aspx
Glad omvandla!
<slutet />
Denna sida slutfört nästan uppgiften jag letade.
Jag har en grupp som vill använda listan SharePoint undersökning för att skapa en veckans omröstning. Fångsten? De vill inte se koden… Eller ändra systemet varje gång de skickar mätningen (planerade för en veckovis uppdatering).
Jag kunde ansluta detta till listan undersökning och skapa diagrammet på kolumnen första svar. Men vad jag kan inte förutsäga är de värden och etiketter som de måste gå framåt. För att göra saken kan värre de ha mer eller mindre svar finns varje vecka.
Jag kommer att söka någon annanstans bara i fall, men har någon hittat ett sätt att skapa rader och etiketter baserade på antalet tillgängliga alternativ och dynamiskt ställa dessa snarare än hårt kodning förväntade värden?
Tack Paul. Mycket hjälpsam. Tack för ditt arbete, Jag kunde lägga till en kolumn diagram bar till en befintlig DVWP (t.ex. för aktiviteter) mycket enkelt med bara några rader kod.
I SharePoint Designer, Jag har infogat en datavy med titeln och % komplett kolumner från en uppgiftslista. Jag placerar du markören i en av cellerna och högerklicka på. Jag väljer du infoga en kolumn till höger. I kodvyn, Jag hittade den <TD> och ersatt den <XSL:text-element inuti cellen med din kod:
<tabell cellpadding ="0" CellSpacing ="0" Border ="0"
bredd = "{runda(@PercentComplete * 100)+1}%">
<TR stil = "background-color:röd">
<XSL:text inaktivera-utdata-fly = "ja"><![CDATA[ ]]></XSL:texten>
</TR>
</tabell>
Obs jag förändrat den rad färgkoden från bgcolor = "röd" till style = "background-color:röd"
Också, kunde välja en av kolumnerna i min lista (@PercentComplete) i stället för "$BarPercent"
Greg
En annan metod (med endast SharePoint UI):
http://pathtosharepoint.wordpress.com/2008/09/02/a-progress-bar-for-your-tasks-list/
http://pathtosharepoint.wordpress.com/2008/10/21/progress-bar-color-coding/
xmlns:__designer =http://schemas.microsoft.com/WebParts/v2/DataView/designer xmlns:ASP ="http://schemas.microsoft.com/ASPNET/20">
Välj = "räkna(/dsQueryResponse/rader/rad[normalisera-space(@Status)= "PIA"])" />
http://www.microsoft.com/sharepoint/downloads/components/detail.asp?a1=701Ian Morrish postat detta i maj 2006. Jag försökte i MOSS 2007 och det fungerar bra. Lagt till GAC, fick execadmsvcjobs och iisreset…
Stor post, Tack!
Stor post, Tack!
Hej Paul!
Bra jobbat! Jag hade också något sådant i mitt sinne att visa SharePoint-listor på ett grafiskt sätt 😉
Jag har ett "Använda instrumentpaneler i SharePoint’ fråga. Vi är ett militärt sjukhus som använder MOSS-standarden för vårt intranät och skulle vilja bygga en instrumentpanel för vår kommandogrupp för att se "realtid"’ om möjligt. En av de viktigaste punkterna som visar realtid nuvarande arbetsbelastningen inom anläggningen och bokstavligen titta på det ändra upp och ner (kan behöva klicka på “uppdatera”/F5).
Tack på förhand,
Du kan göra något nyttigt med jQuery för att åstadkomma denna effekt. Maila mig på Galvin.Paul@gmail.com och jag ska vara glad att försöka ge en hand.