SharePoint Technical Notes: SharePoint Designer

カスタムテーマ利用時の注意

またMSDNフォーラムの投稿からの内容で、備忘録を兼ねて問題点と解決策をこちらにも投稿しておきます。

サイトに適用するテーマはカスタムで作成できます。カスタムのテーマの作成方法については次の URL が参考になります。

How to: Customize Themes (英語)
SharePoint Developer (おりば～ずさんのブログ)

が、カスタム作成したテーマを一度適用したあと、再びそのテーマを修正してもすぐには反映されません。これはIIS 上のワーカプロセスがテーマをキャッシュしていることが原因であるようです。

解決方法

サイトの設定から、いったん、カスタム作成のテーマとは別のテーマを適用する
ワーカプロセスをリサイクルする
サイトの設定から、カスタム作成のテーマに戻す

ワーカプロセスのリサイクル

リサイクルは GUI と CUI の両方で操作できます。

GUI
IIS の管理ツールから、利用しているアプリケーションプールを右クリックし「リサイクル」をクリックする。

CUI
cscript.exe c:\windows\system32\iisapp.vbs /a "アプリケーションプール名" /r

コンテンツクエリ Web パーツ (8.タスクの一覧を取得する)

すっかり長くなってしまった一連の投稿も、今回でいよいよ最終回です。

最後に、これまでの内容の応用としてコンテンツクエリ Web パーツを使い、サイトコレクション内のすべてのサイトから自分が担当になっいるタスクの一覧を取得するようにしてみたいと思います(これも、以前、ご質問をいただいたことがあるものです。)

[最終目標の画面]

※作業量割には、そこそこ素敵な感じの仕上がりになったように思います。

実現した機能

タスクの進捗ごとにグループ化する
タスクのタイトルの他に、優先順位と期日を表示するようにする
優先順位で並び替える
優先順位が高いものだけにアイコンを表示する
新しいアイテムは New! のアイコンを表示する
期日が過ぎている場合は、その旨を表示する

作業概要

コンテンツクエリ Web パーツを配置し、サイトコレクション全体から自分が担当になっているタスクを取得するための基本設定を行う
コンテンツクエリ Web パーツをエクスポートし、表示したい列を取得できるよう編集して、再びインポートする
ItemStyle.xsl を編集し、見た目を整える
コンテンツクエリ Web パーツに新しいスタイルを適用する

コンテンツクエリWebパーツの基本設定

グループ作業ポータルのトップページに、コンテンツクエリ Web パーツを配置します。
[コンテンツクエリ Web パーツ] の [編集] - [共有 Web パーツの変更] をクリックします。
[クエリ] セクションで [ソース] を "このサイトコレクションのすべてのサイトからアイテムを表示する"とします(今回はサイトコレクション全体を対象としてみます)。
[リストの種類]から[このリストの種類のアイテムを表示する] を"タスク" に変更します。また[コンテンツタイプ] で "リストコンテンツタイプ" を指定し、[このコンテンツタイプのアイテムを表示する] で "タスク" を指定します。
[追加フィルタ] セクションで [次の条件でアイテムを表示する] にて "担当者" が "次の値に等しい" "[Me]" となるように指定します。これで自分のタスクのみをフィルタできるようになります。なお、画面に表示されているようにこの設定ではキャッシュが利用できないため、パフォーマンスが下がる可能性がありますので、実運用で利用される場合は実際にどの程度のパフォーマンスになるかを測定してみてから利用されるとよいと思います。さらに今回は終了したタスクは非表示にするようにしたいため、"かつ" を選択し、"タスクの状態" が "次の値に等しくない" "完了" となるように指定します。
[プレゼンテーション] セクションでは、[アイテムのグループ化キー]として" タスクの状態" を指定します。[アイテムの並び替えキー]に[優先度]を指定します。
すべてのタスクを表示するために [表示するアイテム数を制限する] チェックボックスをオフにします。
[グループスタイル]を"帯状"、[アイテムのスタイル]を"箇条書きタイトル" に設定します。
[外観]セクションの[タイトル]に"自分の仕事一覧" と入力します。
[適用] をクリックします。

表示したい列の取得

コンテンツクエリ Web パーツの右上に表示される▼をクリックし、[エクスポート]をクリックします。
任意の名前でローカルに保存します。今回は "mytask.webpart" という名前で保存します。
エクスポートしたファイルをメモ帳などで編集します。次のタグを見つけます。

<property name="CommonViewFields" type="string" />
"期日" と "優先度" 列情報を取得できるように次の通り編集します。

<property name="CommonViewFields" type="string">DueDate,DateTime;Priority,Choice</property>
上書き保存します。
再び IE に戻り、編集した Web パーツ情報をインポートするために、[Webパーツの追加]をクリックします。
Webパーツの追加画面右下に表示される "Webパーツギャラリーとオプションの詳細設定" リンクをクリックします。
画面右上の "Web パーツの追加" の下に表示される"参照" 部分の▼をくりっし、[インポート] をクリックします。
"mytask.webpart" ファイルを指定し、アップロードします。
アップロードしたWebパーツをWebパーツ領域に追加します。

ItemStyle.xsl を編集する

SharePoint Designer 2007 を起動し、コンテンツクエリ Web パーツを配置しているサイトを開きます。
[フォルダ一覧]内から[Style Library(スタイルライブラリ)] - [XSL Style Sheets] の順に展開し、ItemStyle.xsl を右クリックしチェックアウトします。
ItemStyle.xsl をダブルクリックします。
XSLT 内で ddwrt 関数を使用できるよう宣言を次のように追加します。なお、これまでの一連の設定を行っている場合はこの操作は不要です。

<xsl:stylesheet
version="1.0"
exclude-result-prefixes="x xsl cmswrt cbq ddwrt"
... (中略)
xmlns:ddwrt="http://schemas.microsoft.com/WebParts/v2/
DataView/runtime">
<xsl:template name="Bullets" match="Row[@Style='Bullets']" mode="itemstyle">
から対応する</xsl:template>までをコピーし、</xsl:stylesheet> の直前に貼り付けます。
スタイルシートを次のように変更します(赤色部分が追加修正を行った部分です)。

<xsl:template name="すべてのタスク" match="Row[@Style='すべてのタスク']" mode="itemstyle">
      <xsl:variable name="SafeLinkUrl">
         <xsl:call-template name="OuterTemplate.GetSafeLink">
            <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
         </xsl:call-template>
      </xsl:variable>
      <xsl:variable name="DisplayTitle">
         <xsl:call-template name="OuterTemplate.GetTitle">
            <xsl:with-param name="Title" select="@Title"/>
            <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
         </xsl:call-template>
      </xsl:variable>
      <xsl:variable name="LinkTarget">
         <xsl:if test="@OpenInNewWindow = 'True'" >_blank</xsl:if>
      </xsl:variable>
      <div id="linkitem" class="item link-item bullet">
         <xsl:call-template name="OuterTemplate.CallPresenceStatusIconTemplate"/>
<span style="color:black;">
<xsl:value-of select="@Priority"/></span>
:
         <a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">
            <xsl:value-of select="$DisplayTitle"/>
         </a>
<img src="/_layouts/images/blank.gif" width="5" style="visibility:hidden" alt=""/><xsl:if test="@Priority='(1) 高'">
<img src="/_layouts/images/ewr207s.gif" alt="優先度:高" border="0" height="11px"/>
</xsl:if>
<xsl:if test="ddwrt:IfNew(@Modified)">
<img src="/_layouts/1041/images/New.gif" alt="新しいアイテム"/></xsl:if>
<img src="/_layouts/images/blank.gif" width="13" style="visibility:hidden" alt=""/>
<span style="color:black">
[期日:<xsl:value-of select="ddwrt:FormatDate(string(@DueDate),number('1041'),7)"/>]
      </span>
<xsl:if test="translate(substring-before(@DueDate,' '),'-','')<translate(substring-before(ddwrt:TodayIso(),'T'),'-','')">
<span style="color:red;"><img src="/_layouts/images/blank.gif" width="5" style="visibility:hidden" alt=""/>
※期日を過ぎています!</span>
</xsl:if>
</div>
</xsl:template>
上書き保存し、メジャーバージョンとして発行します(SharePoint Desigenr 2007 を終了しても構いませんが、記述ミスなどがある場合にすぐに修正できるよういったんは最小化しておいた方が良いでしょう)。

コンテンツクエリ Web パーツに新しいスタイルを適用する

IE に戻ります。コンテンツクエリWeb パーツの[編集] メニューから[共有Webパーツの変更] をクリックします。
コンテンツのクエリツールパーツ内の"プレゼンテーション" セクションを開き、アイテムのスタイルを "すべてのタスク" に変更し適用します。
表示に問題がなければ発行します。エラーが表示される場合は、ItemStyle.xsl の構文を見直してください。

以上で完了です!

と、なんとなく実務で利用できそうな感じ完成しました。トップページを見ると常に自分の仕事が追いかけてくるようになります(^^ゞ。

思いのほか長い連続投稿になってしまいましたが、参考になりましたでしょうか。

他にもいろいろとカスタマイズしたいというニーズがあるかと思いますが、調査中のものもたくさんありますので、また追々ご紹介していきたいと思います。

コンテンツクエリ Web パーツ　(7.任意の列で並び替える)

今日の設定を終えてようやく「すべてのお知らせ」を取得するコンテンツクエリ Web パーツが完成です! では早速、最後の工程に入りましょう。

コンテンツクエリ Web パーツは既定では並び替えに利用できる列が限られています。そこで、任意の列で並び替える方法をご紹介します。

今回は、「更新日時」列を使用します。既定では「更新日時(_Hidden)」が表示されます。hidden とはなっているものの表示されているので利用できそうなものですが、実際には並び替えには利用できないようです。そこで、前回取得した「更新日時」列の情報を使って更新日時で並び替えられるように調整します。

コンテンツクエリ Web パーツで任意の列で並び替えを行えるようにするには、Webパーツのデータを一旦エクスポートし、内容を編集する必要があります。

操作概要

コンテンツクエリ Web パーツのエクスポートする
エクスポートしたデータを編集する
2. をインポートする
コンテンツクエリ Web パーツの並べ替えキーを変更する

コンテンツクエリ Web パーツのエクスポート

コンテンツクエリ Web パーツの右上に表示される▼をクリックし、[エクスポート] をクリックします。
任意の名前でファイルをローカルに保存します。今回も前回と同様に"mycqwp.webpart" という名前で上書き保存しておきます。

Web パーツ情報の編集

次にエクスポートしたXMLファイルをメモ帳などで開き、編集します。次のタグを見つけます。

<property name="AdditionalGroupAndSortFields" type="string" null="true" />
編集日時(Modified) 列が「並び替え」ドロップダウンメニューに表示されるよう次のように変更します。

<property name="AdditionalGroupAndSortFields" type="string">Modified</property>

上書き保存をします。

Web パーツ情報をインポートする

編集した mycqwp.webpart をインポートします。

IE を使用してコンテンツクエリWebパーツを追加したサイトを表示します。
[サイトの操作]メニューから[ページの編集]をクリックします。
"Web パーツの追加" をクリックします。
Web パーツの追加画面右下に表示される "Web パーツギャラリーとオプションの詳細設定" リンクをクリックします。
画面右上の"Web パーツの追加" の下に表示される "参照"部分の▼をクリックし、[インポート]をクリックします。
先ほど編集した "mycqwp.webpart" ファイルを指定し、アップロードします。
アップロードした Web パーツをWeb パーツ領域に追加(インポート)します。

コンテンツクエリ Web パーツの並べ替えキーを変更する

コンテンツクエリ Web パーツに適用されている並び替え設定を変更します。

追加した Web パーツの[編集]メニューから[共有Webパーツの変更]をクリックします。
コンテンツのクエリツールパーツ内の"プレゼンテーション" セクションを開き、"アイテムの並び替えキー" のドロップダウンメニューから "Modified" を選択します。
[OK]ボタンをクリックします。
[発行]します。

以上で、更新日時で並び替えが行われるようになったはずです。

うまく表示されれば完成です、パチパチパチ～♪

次回は最終回として、今回ご紹介してきた一連の内容を応用して「複数サイトから自分のタスクを表示する」ようにしてみたいと思います。

参考: PointBridge Blogs(英語)

コンテンツクエリ Web パーツ　(6.リンク機能を修正する)

コンテンツクエリ Web パーツを使用してサブサイトのアイテムを取得する場合、ルートのサイトコレクションが作成されていないとリンク機能が正しく動作しません。このことは以前の記事でもご紹介しました。

【参考: コンテンツクエリ Web パーツのエラー】

しかし、ルートのサイトコレクションを作成しなくてもリンク機能を有効にすることも可能です。ひとつの解決策として、その方法をご紹介しておきます。

解決策

そもそも問題となる固定のリンクの情報は、ContentQueryMain.xsl に記載されています。ここにはリンク先のアイテムにリダイレクトしてくれるはずの"CopyUtil.aspx" のURL が "/_layouts/CopyUtil.aspx" とハードコードされています。これをサイトのURLに合わせて編集してやれば、この場合の問題は解決します。

なお SharePoint Designer 2007 を使用するのがミソです。SharePoint Designer 2007 使用してこのファイルを編集することで、サイトごとに独自の編集が可能となります。

修正方法

SharePoint Designer 2007 を起動し、コンテンツクエリ Web パーツを追加したサイトを開きます。
[フォルダ一覧] - [Style Library (スタイルライブラリ)] - [XSL Style Sheets] を展開し、ContentQueryMain.xsl を右クリックしチェックアウトします。
ContentQueryMain.xsl をダブルクリックします。
次のタグを見つけます。
<xsl:value-of select="concat('/_layouts/CopyUtil.aspx?
Use=id&Action=dispform&ItemId=',@ID,'
&ListId=',@ListId,'&WebId=',@WebId,'
&SiteId=',$SiteId)"/>
"/_layouts/CopyUtil.aspx" の部分をサイトのURLに応じて編集します。たとえば、私の環境では次のように編集しました。
<xsl:value-of select="concat('/sites/top/_layouts/CopyUtil.aspx?
Use=id&Action=dispform&ItemId=',@ID,'
&ListId=',@ListId,'&WebId=',@WebId,'
&SiteId=',$SiteId)"/>
上書き保存し、マイナーバージョンとしてチェックインしておきます。

コンテンツクエリ Web パーツ　(5.表示部分を整える)

前回のままでは本文がすべて表示されてしまうため、本文から30文字分のみを表示し全文を読みたいユーザーには "詳細" リンクから参照できるよう調整します。また New! のアイコンも表示するようにします。

[今回の目標画面]

作業内容

タイトルの隣に New! アイコンを表示する
本文の表示を制限し、詳細情報へのリンクを追加する

タイトルの隣に New! アイコンを表示する

SharePoint Designer 2007 でコンテンツクエリ Web パーツを追加したサイトを開きます。
[フォルダ一覧] - [Style Library (スタイルライブラリ)] - [XSL Style Sheets] を展開し、ItemStyle.xsl を右クリックしチェックアウトします。
ItemStyle.xsl をダブルクリックします。
" すべてのお知らせ用スタイル" テンプレート内から、次の部分を見つけます。

<a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">
<xsl:value-of select="$DisplayTitle"/>
</a>
今回はタイトル部分のリンクを削除しておくため、"<a href="{$SafeLinkUrl}" target="{$LinkTarget}" title="{@LinkToolTip}">" および "</a>" を削除し、<xsl:value-of select="$DisplayTitle"/> の部分のみが残るようにします。
<xsl:value-of select="$DisplayTitle"/> の直後に以下のタグを追加します。

<xsl:value-of select="$DisplayTitle"/>
<xsl:if test="ddwrt:IfNew(@Modified)">
<img src="/_layouts/1041/images/New.gif" alt="新しいアイテム"/><img src="/_layouts/images/blank.gif" width="13" style="visibility:hidden" alt=""/>
</xsl:if>

続いて、次の作業を行います。

本文の表示を制限し、詳細情報へのリンクを追加する

"すべてのお知らせ用スタイル" テンプレート内で次のタグを見つけます。

<xsl:value-of select="$bodyContent"/>
次のように変更します。この例ではリンクをクリックすると別ウィンドウで表示するようにしています。

<div class="description">
<xsl:value-of select="substring($bodyContent,1,30)"/>
...(
<a href="{$SafeLinkUrl}" mce="{$SafeLinkUrl}" target="_blank"
title="{@LinkToolTip}">詳細</a>)
</div>
上書き保存をします。また今回で ItemStyel.xsl の編集は終わりますのでメジャーバージョンを発行するようにチェックインをしておきます。

最後に、結果を IE で確認します。まだこのままでは、詳細リンクをクリックしてもルートのサイトコレクションがない場合はエラーとなってしまいます。次回は、ルートのサイトコレクションを作成せずにアイテムのリンク先を表示できるよう修正します。

参考: Microsoft Enterprise Content Management Team Blog (英語)

カテゴリ「SharePoint Designer」の32件の投稿