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