Tổng quan và mục tiêu
Ra khỏi hộp, RÊU’ Nội dung truy vấn Web Part (CQWP) Hiển thị kết quả của nó trong một định dạng danh sách, tương tự như kết quả tìm kiếm. Nó cũng có thể hiển thị các kết quả trong một định dạng lưới (tức là. Định dạng bảng HTML). Định dạng lưới tốt hơn trong một số trường hợp. Tôi mô tả làm thế nào để đạt được có hiệu lực trong bài viết này.
Kinh doanh kịch bản
Tôi đã làm việc với một khách hàng ngày một buổi giới thiệu MOSS toàn doanh nghiệp. Chúng tôi đã thiết kế phân loại của họ như vậy mà dự án là các công dân hạng nhất trong hệ thống và có trang web riêng của họ cấp cao nhất. Quản lý dự án duy trì một danh sách singleton của thông tin tóm tắt dự án, chẳng hạn như tiêu đề, ngân sách, Ngày hoàn thành dự kiến, còn lại ngân sách và các lĩnh vực khác của loại tóm tắt. Bởi "singleton" Tôi có nghĩa là một danh sách SharePoint tùy chỉnh bảo đảm để chứa chỉ có một mục. Simplistically, nó trông như thế này:
Các phương pháp kỹ thuật là giống như được mô tả Ở đây (http://paulgalvin.spaces.live.com/blog/cns!1CC1EDB3DAA9B8AA!447.entry). CQWP sử dụng một biến đổi XSL để phát ra HTML cho trình duyệt để hiển thị.
Tôi luôn luôn hình dung kết quả trước khi lặn vào XSL vì XSL là một cơn ác mộng. Đây là kết quả mong muốn của tôi:
HTML như thế này tạo ra kết quả đó:
|
|
<HTML>
<cơ thể>
<Trung tâm>
<Bàn biên giới= 1>
<!-- Nhãn-->
<tr BGColor= màu xanh>
<TD><phông chữ màu sắc= trắng><b>Tên dự án</b></phông chữ></TD>
<TD sắp xếp= right><phông chữ màu sắc= trắng><b>Ngày tháng đầy đủ</b></phông chữ></TD>
<TD sắp xếp= right><phông chữ màu sắc= trắng><b>Ngân sách</b></phông chữ></TD>
<TD sắp xếp= right><phông chữ màu sắc= trắng><b>Chi phí thực tế</b></phông chữ></TD>
<TD><phông chữ màu sắc= trắng><b>Tổng thể trạng thái</b></phông chữ></TD>
</tr>
<tr>
<TD>Phòng máy tính Re-wire.</TD>
<TD sắp xếp= right>02/01/08</TD>
<TD sắp xếp= right>22,500.00</TD>
<TD sắp xếp= right>19,000.00</TD>
<TD>Trong tiến trình</TD>
</tr>
<tr>
<TD>Cung cấp máy chủ cho SQL nâng cấp</TD>
<TD sắp xếp= right>04/01/08</TD>
<TD sắp xếp= right>7,500.00</TD>
<TD sắp xếp= right>0.00</TD>
<TD>Kế hoạch</TD>
</tr>
</Bàn>
</Trung tâm>
</cơ thể>
</HTML>
|
Phương pháp tiếp cận
Thực hiện theo các bước sau để tạo ra mạng lưới:
- Xác định các thành phần của lưới điện (hàng/cột).
- Xác định và tạo ra các trang web cần thiết cột.
- Tạo ra các trang web phụ cho các dự án và danh sách singleton.
- Thêm CQWP vào một trang web và cấu hình nó để tìm kiếm các danh sách của bạn.
- Sửa đổi của CQWP XML để thu thập các cột bổ sung.
- Sửa đổi XSL để tạo ra một bảng.
Tôi sẽ tập trung vào thứ sáu. Con số một thông qua bốn là thẳng về phía trước và một cái gì đó bất kỳ người sử dụng CQWP đã thực hiện. Thứ năm đã được các tài liệu bởi người khác trong đó này bài viết laden ảnh chụp màn hình đầy đủ từ MSDN Ở đây (http://msdn2.microsoft.com/en-us/library/bb897399.aspx) và Heather Solomon blog Ở đây (http://www.heathersolomon.com/blog/articles/CustomItemStyle.aspx).
Nuts và bu lông
Bắt đầu và thực hiện bước 1 đến 5 theo các tài liệu MSDN và bài viết của Heather Solomon.
Tại thời điểm này, bạn đã thêm CQWP của bạn vào trang web và bạn có của bạn <CommonViewFields> cấu hình cần thiết.
Theo các bước thông thường, Tôi nhận được các kết quả trung gian:
1. Tạo ra một loại nội dung, một danh sách tùy chỉnh templatized cho rằng loại nội dung và hai trang web. Dưới đây là các loại nội dung:
Dưới đây là cấu trúc trang web:
2. Thêm CQWP sau khi tạo dự án SubSite và singleton của tôi danh sách tóm tắt dự án:
3. Thêm tất cả các thông tin bổ sung mà tôi muốn thông qua các <CommonViewFields>:
<bất động sản Tên="CommonViewFields" loại="chuỗi">Project_x0020_Name;Project_x0020_Expenses;Project_x0020_Status;Project_x0020_Start_x0020_Date;Project_x0020_End_x0020_Date;Project_x0020_Budget</bất động sản>
Lưu ý rằng tôi đã có để giữ cho tất cả các lĩnh vực bất động sản trên một dòng, hoặc nó sẽ không làm việc (CQWP sẽ cho tôi biết các truy vấn trở lại không có khoản mục).
4. Tại thời điểm này, chúng tôi đã sẵn sàng để di chuyển vượt ra ngoài các bài viết MSDN và flip trên bài viết của Heather Solomon. Làm theo các bước của mình bắt đầu gần bước #5 để tạo ra một tùy chỉnh / Phiên bản unghosted của ItemStyle.xsl. Tôi làm theo lời khuyên của Heather, lên qua bước 11 và nhận được các kết quả trung gian:
4.1: Tên của tôi mẫu XSL như sau:
<XSL:tiêu bản tên = "lưới điện" phù hợp với = "hàng[@Style = 'Lưới']" chế độ = "itemstyle">
Tôi cũng hơi sửa đổi của mình đề nghị <XSL:cho mỗi …> bằng cách thêm một <BR /> các từ khóa để cung cấp một danh sách sạch hơn:
<XSL:cho mỗi chọn="@*">
P:<XSL:giá trị của chọn="Tên()" /><BR/>
</XSL:cho mỗi>
4.2: Sửa đổi phần web, đi đến sự xuất hiện và lựa chọn của tôi "lưới điện" phong cách:
Áp dụng thay đổi và đây là kết quả:
Chúng tôi có thể nhìn thấy từ trên các lĩnh vực chúng tôi muốn (Tên dự án, chi phí, tình trạng, vv) có sẵn cho chúng tôi sử dụng khi chúng tôi phát ra HTML. Không chỉ vậy, nhưng chúng tôi thấy tên mà chúng tôi phải tham khảo những cột trong XSL. Ví dụ:, chúng tôi tham khảo tình trạng dự án như "Project_x005F_x0020_Name".
Tại thời điểm này, chúng tôi khởi hành từ blog của Heather và từ vai những người khổng lồ, Tôi thêm riêng của tôi ít.
ContentQueryMain.xsl
LƯU Ý: Khi thực hiện thay đổi cho cả hai ContentQueryMain.xsl cũng như ItemStyle.xsl, bạn cần phải kiểm tra các tập tin đó trở lại trước khi bạn nhìn thấy hiệu quả của các thay đổi.
Cho các mục đích thực hiện lưới điện, MOSS sử dụng hai tập tin XSL khác nhau để tạo ra kết quả chúng ta thấy từ một CQWP. Để tạo ra các bit trước của đầu ra, chúng tôi sửa đổi ItemStyle.xsl. MOSS thực sự sử dụng một XSL tập tin, ContentQueryMain.xsl để kết hợp với ItemStyle.xsl để tạo ra HTML của nó. Như tên gọi của nó, ContentQueryMain.xsl là "chính" XSL điều khiển lưu lượng tổng thể của bản dịch. Nó iterates thông qua tất cả các mục tìm thấy và vượt qua họ từng người một để mẫu trong ItemStyle.xsl. Chúng tôi sẽ sửa đổi ItemStyle.xsl để tạo ra mở <Bàn> thẻ trước khi phát ra các dòng đầu tiên của dữ liệu và đóng cửa <Bàn> các từ khóa sau đợt phát ra hàng cuối cùng. Để thực hiện việc này, ContentQueryMain.xsl được sửa đổi để vượt qua hai tham số cho chúng tôi "lưới điện" mẫu trong ItemStyle.xsl, "hàng cuối cùng" và "hàng hiện tại". ItemStyle.xsl sử dụng này để có điều kiện phát ra các thẻ cần thiết.
Sử dụng kỹ thuật của Heather Solomon, chúng tôi xác định vị trí ContentQueryMain.xsl. Sân bay này nằm trong cùng một vị trí như ItemStyle.xsl. Ảnh chụp màn hình này sẽ giúp:
Chúng tôi cần phải thực hiện những thay đổi sau:
- Sửa đổi một mẫu xsl, "CallItemTemplate" mà thực sự invokes mẫu lưới điện của chúng tôi tại ItemStyle.xsl. Chúng tôi sẽ gửi hai tham số cho các mẫu lưới điện như vậy mà nó sẽ có dữ liệu cần thiết để tạo ra có điều kiện mở và đóng cửa <Bàn> Download.
- Sửa đổi một chút ContentQueryMain.xsl rằng các cuộc gọi "CallItemTemplate" để vượt qua nó "LastRow" tham số để LastRow rằng có thể được thông qua ngày cho chúng tôi mẫu lưới điện.
Xác định vị trí các mẫu đặt tên là "OuterTemplate.CallItemTemplate" xác định bằng chuỗi:
<XSL:tiêu bản Tên="OuterTemplate.CallItemTemplate">
Thay thế mẫu toàn bộ như sau:
|
|
<XSL:tiêu bản Tên="OuterTemplate.CallItemTemplate">
<XSL:param Tên="CurPosition" />
<!--
Thêm "LastRow" tham số.
Chúng tôi chỉ sử dụng nó khi vượt qua phong cách mục trong "Mạng lưới".
-->
<XSL:param Tên="LastRow" />
<XSL:chọn>
<XSL:Khi kiểm tra="@Style = 'NewsRollUpItem'">
<XSL:áp dụng mẫu chọn="." chế độ="itemstyle">
<XSL:với param Tên="EditMode" chọn="$cbq_iseditmode" />
</XSL:áp dụng mẫu>
</XSL:Khi>
<XSL:Khi kiểm tra="@Style = 'NewsBigItem'">
<XSL:áp dụng mẫu chọn="." chế độ="itemstyle">
<XSL:với param Tên="CurPos" chọn="$CurPosition" />
</XSL:áp dụng mẫu>
</XSL:Khi>
<XSL:Khi kiểm tra="@Style = 'NewsCategoryItem'">
<XSL:áp dụng mẫu chọn="." chế độ="itemstyle">
<XSL:với param Tên="CurPos" chọn="$CurPosition" />
</XSL:áp dụng mẫu>
</XSL:Khi>
<!--
Vượt qua vị trí hiện tại và lastrow với các mạng lưới itemstyle.xsl mẫu.
ItemStyle.xsl sẽ sử dụng để phát ra mở và đóng cửa <Bàn> Download.
-->
<XSL:Khi kiểm tra="@Style = 'Lưới'">
<XSL:áp dụng mẫu chọn="." chế độ="itemstyle">
<XSL:với param Tên="CurPos" chọn="$CurPosition" />
<XSL:với param Tên="Cuối cùng" chọn="$LastRow" />
</XSL:áp dụng mẫu>
</XSL:Khi>
<XSL:Nếu không>
<XSL:áp dụng mẫu chọn="." chế độ="itemstyle">
</XSL:áp dụng mẫu>
</XSL:Nếu không>
</XSL:chọn>
</XSL:tiêu bản>
|
Các ý kiến mô tả mục đích của những thay đổi.
Tất nhiên, "OuterTemplate.CallItemTemplate" chính nó được gọi là từ một mẫu. Xác định vị trí mẫu đó bằng cách tìm kiếm chuỗi văn bản này:
<XSL:tiêu bản Tên="OuterTemplate.Body">
Di chuyển qua các hướng dẫn trong OuterTemplate.Body và chèn các tham số LastRow như sau (Hiển thị như là một bình luận trong nghiêng):
<XSL:cuộc gọi, mẫu Tên="OuterTemplate.CallItemTemplate">
<XSL:với param Tên="CurPosition" chọn="$CurPosition" />
<!-- Chèn các tham số LastRow. -->
<XSL:với param Tên="LastRow" chọn="$LastRow"/>
</XSL:cuộc gọi, mẫu>
Sau khi tất cả điều này, chúng tôi cuối cùng có những thứ được thiết lập đúng cách để ItemStyle.xsl chúng tôi có thể phát ra <Bàn> khoá đúng nơi.
ItemStyle.Xsl
LƯU Ý: Một lần nữa, kiểm tra trong ItemStyle.xsl sau khi thực hiện bất kỳ thay đổi để cho bạn thấy tác động của những thay đổi.
Chúng tôi có hai nhiệm vụ ở đây:
- Thay thế toàn bộ lưới điện mẫu. Bạn có thể sao chép/dán từ dưới đây.
- Thêm một số mumbo jumbo bên ngoài định nghĩa mẫu cho phép "formatcurrency" mẫu để làm việc. (Bạn có thể nói rằng tôi có một xử lý mỏng manh trên XSL).
Đầu tiên, gần đầu ItemStyle.xsl, Thêm dòng này:
<!-- Một số mumbo jumbo cho phép chúng tôi để hiển thị Hoa Kỳ. thu. -->
<XSL:định dạng số thập phân Tên="nhân viên phục vụ" chữ số="D" />
<XSL:tiêu bản Tên="Mặc định" phù hợp với="*" chế độ="itemstyle">
Lưu ý rằng tôi đã thêm nó trực tiếp trước các <XSL:tiêu bản tên = "mặc định" …> định nghĩa.
Tiếp theo, trở lại của chúng tôi mẫu lưới điện. Thay thế mẫu lưới toàn bộ với mã dưới đây. Nó là hoàn toàn nhận xét, nhưng đừng ngần ngại gửi email cho tôi hoặc để lại ý kiến trên blog của tôi nếu bạn có thắc mắc.
|
|
<XSL:tiêu bản Tên="Mạng lưới" phù hợp với="Hàng[@Style = 'Lưới']" chế độ="itemstyle">
<!--
ContentMain.xsl qua CurPos và cuối cùng.
Chúng tôi sử dụng các điều kiện phát ra mở và đóng cửa <Bàn> Download.
-->
<XSL:param Tên="CurPos" />
<XSL:param Tên="Cuối cùng" />
<!-- Các yếu tố sau đây được chưa sửa đổi từ ItemStyle.xsl tiêu chuẩn -->
<XSL:biến Tên="SafeImageUrl">
<XSL:cuộc gọi, mẫu Tên="OuterTemplate.GetSafeStaticUrl">
<XSL:với param Tên="UrlColumnName" chọn="'ImageUrl'"/>
</XSL:cuộc gọi, mẫu>
</XSL:biến>
<XSL:biến Tên="SafeLinkUrl">
<XSL:cuộc gọi, mẫu Tên="OuterTemplate.GetSafeLink">
<XSL:với param Tên="UrlColumnName" chọn="'LinkUrl'"/>
</XSL:cuộc gọi, mẫu>
</XSL:biến>
<XSL:biến Tên="DisplayTitle">
<XSL:cuộc gọi, mẫu Tên="OuterTemplate.GetTitle">
<XSL:với param Tên="Tiêu đề" chọn="@Title"/>
<XSL:với param Tên="UrlColumnName" chọn="'LinkUrl'"/>
</XSL:cuộc gọi, mẫu>
</XSL:biến>
<XSL:biến Tên="LinkTarget">
<XSL:Nếu kiểm tra="@OpenInNewWindow = 'True'" >_blank</XSL:Nếu>
</XSL:biến>
<!--
Ở đây chúng ta định nghĩa một biến, "tableStart". Điều này chứa mã HTML mà chúng tôi sử dụng để xác định việc mở bảng cũng như các nhãn cột. Lưu ý rằng nếu CurPos = 1, nó bao gồm HTML trong một thẻ CDATA.
Nếu không, nó sẽ được sản phẩm nào.
Giá trị của tableStart là emited mỗi khi ItemStyle được gọi là thông qua ContentQueryMain.xsl.
-->
<XSL:biến Tên="tableStart">
<XSL:Nếu kiểm tra="$CurPos = 1">
<![CDATA[
<biên giới bảng = 1>
<tr bgcolor = "màu xanh">
<TD><màu sắc font = "trắng"><b>Tên dự án</b></phông chữ></TD>
<TD align = "quyền"><màu sắc font = "trắng"><b>Ngày tháng đầy đủ</b></phông chữ></TD>
<TD align = "quyền"><màu sắc font = "trắng"><b>Ngân sách</b></phông chữ></TD>
<TD align = "quyền"><màu sắc font = "trắng"><b>Chi phí thực tế</b></phông chữ></TD>
<TD><màu sắc font = "trắng"><b>Tổng thể trạng thái</b></phông chữ></TD>
</tr>
]]>
</XSL:Nếu>
</XSL:biến>
<!--
Một biến, tableEnd đơn giản chỉ cần xác định đóng bàn từ khóa.
Như với tableStart, nó luôn luôn là emited. Đây là lý do tại sao giá trị của nó được phân công có điều kiện dựa trên cho dù chúng tôi đã được thông qua dòng cuối bởi ContentQueryMain.xsl.
-->
<XSL:biến Tên="tableEnd">
<XSL:Nếu kiểm tra="$CurPos = $Last">
<![CDATA[ </Bàn> ]]>
</XSL:Nếu>
</XSL:biến>
<!--
Luôn luôn phát ra các nội dung của tableStart. Nếu đây không phải là dòng đầu tiên được thông qua cho chúng tôi bởi ContentQueryMain.xsl, sau đó chúng tôi biết giá trị của nó sẽ được để trống.
Vô hiệu hóa đầu ra thoát bởi vì khi tableStart nó không trống, nó bao gồm HTML thực tế mà chúng tôi muốn được thực hiện bởi trình duyệt. Nếu chúng tôi không nói cho XSL phân tích cú pháp để vô hiệu hóa đầu ra thoát, nó sẽ tạo ra các công cụ như"<Bàn>" thay vì của"<Bàn>".
-->
<XSL:giá trị của chọn="$tableStart" vô hiệu hoá-đầu ra-thoát="Có"/>
<tr>
<!--
P:Project_x005F_x0020_Name P:Project_x005F_x0020_End_x005F_x0020_Date P:Project_x005F_x0020_Budget P:Project_x005F_x0020_Expenses P:Project_x005F_x0020_Status
-->
<TD>
<XSL:giá trị của chọn="@Project_x005F_x0020_Name"/>
</TD>
<TD sắp xếp="quyền">
<XSL:giá trị của chọn="@Project_x005F_x0020_End_x005F_x0020_Date"/>
</TD>
<TD sắp xếp="quyền">
<XSL:cuộc gọi, mẫu Tên="formatcurrency">
<XSL:với param Tên="giá trị"
chọn="@Project_x005F_x0020_Budget"></XSL:với param>
</XSL:cuộc gọi, mẫu>
</TD>
<TD sắp xếp="quyền">
<XSL:cuộc gọi, mẫu Tên="formatcurrency">
<XSL:với param Tên="giá trị" chọn="@Project_x005F_x0020_Expenses">
</XSL:với param>
</XSL:cuộc gọi, mẫu>
</TD>
<TD>
<XSL:giá trị của chọn="@Project_x005F_x0020_Status"/>
</TD>
<!--
Tất cả những điều sau đây nhận xét ra để làm rõ sự vật.
Tuy nhiên, mang nó trở lại và công cụ nó thành một <TD> để xem hiệu quả của nó.
-->
<!--
<DIV id = "linkitem" lớp = "mã">
<XSL:Nếu thử nghiệm = "chuỗi dài($SafeImageUrl) != 0">
<div class = "thời gian còn lại khu vực hình ảnh">
<một href = "{$SafeLinkUrl}" mục tiêu = "{$LinkTarget}">
<img lớp = "hình ảnh cố định-chiều rộng" src = "{$SafeImageUrl}"
Alt = "{@ImageUrlAltText}"/>
</một>
</div>
</XSL:Nếu>
<div class = "liên kết-mục">
<XSL:cuộc gọi, mẫu
name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<một href = "{$SafeLinkUrl}"
mục tiêu = "{$LinkTarget}" tiêu đề = "{@LinkToolTip}">
<XSL:giá trị của chọn = "$DisplayTitle" />
</một>
<div class = "mô tả">
<XSL:giá trị của select="@Description" />
</div>
</div>
</div>
-->
</tr>
<!--
Phát ra đóng bàn từ khóa. Nếu chúng tôi không phải là trên dòng cuối cùng,
Điều này sẽ được để trống.
-->
<XSL:giá trị của chọn="$tableEnd" vô hiệu hoá-đầu ra-thoát="Có"/>
</XSL:tiêu bản>
<XSL:tiêu bản Tên="formatcurrency">
<XSL:param Tên="giá trị" chọn="0" />
<XSL:giá trị của chọn='định dạng số($giá trị, "$DDD,DDD,DDD.DD", "nhân viên")' />
</XSL:tiêu bản>
|
