カスタマイズ ガイド
Windows / UNIX 版

サイボウズ Office シリーズ ver.1.1 より、画面をカスタマイズできるようになりました。
以下のようなカスタマイズを行なって頂けます。

• イメージファイルの置き換え
• メッセージやイメージの追加・変更・削除
  リンクの追加・変更・削除
• Include ファイル（ヘッダなど）の変更
  Include ファイルの作成
• ページの追加

これらのカスタマイズを行なう前に、次の「カスタマイズ時のお願い」をよくお読み下さい。また、カスタマイズを行なう際は、このカスタマイズガイドを一通り理解した上で行なって下さいますようよろしくお願い致します。

• カスタマイズに係わる全ての危険はお客様のみが負うことをここに確認し、予めご了承下さい。
• カスタマイズは、必ず元ファイルをバックアップしてから行なってください。
• カスタマイズ作業は、HTML オーサリングツール（Microsoft FrontPage97 や クラリスホームページなど）を使わずに、テキストエディタ（メモ帳など）を使って下さい。（オーサリングツールを使うと、書き換えてはいけない部分まで変更される恐れがあります。）

サイボウズ Office のアプリケーションで使われているイメージファイルは、ホームディレクトリ配下の CybozuImages ディレクトリに保管されています。これらのファイルを置き換えるだけで、イメージファイルの変更が可能です。

例えば、CybozuImages の中の logo_schedule.gif（サイボウズ スケジュールのタイトルイメージ）を置き換えると、サイボウズ スケジュールの画面は以下のようにタイトルが変わります。

変更したいイメージのファイル名を調べるときは、Windows で Netscape Communicator を利用している場合、変更したいイメージを右クリックして「画像を名前をつけて保存...」を選ぶと、ファイル名がわかります。

イメージファイルを置き換えるときは、必ず元のイメージファイルをバックアップしてから行なって下さい。

メッセージやイメージの追加・変更・削除
リンク先の追加・変更・削除

サイボウズ Office シリーズ ver.1.1 以降では、テンプレート HTML ファイルに基づいて画面表示を行ないます。従って、これらのテンプレートファイルを変更することで、簡単に画面レイアウトなどの変更を行なうことができます。

テンプレートファイルは、以下のようなディレクトリ構造で保管されています。（C:\InetPub\scripts\cybozu にインストールした場合）

例えば、schedule ディレクトリにあるテンプレートファイル「Month.html」（月間スケジュールを表示するための HTML ファイル）を以下のように変更すると、

月間スケジュールの表示画面は、

変更結果が反映された画面

のように変更されます。

テンプレート HTML ファイルの中では、通常の HTML タグはすべて利用できますので、メッセージやイメージの追加・変更・削除、リンク先の追加・変更・削除など、画面レイアウトのカスタマイズを簡単に行なって頂けます。

カスタマイズしたい画面に対応するテンプレートファイルがどれであるかを探し出すには、ブラウザーを使うと簡単です。普段、サイボウズ Office を利用するのと同様にアクセスし、カスタマイズしたい画面を表示させます。このとき、ブラウザーの Location 表示欄を見て下さい。

http://(hostname)/scripts/cybozu/schedule.exe?Day+6+19980117

となっていれば、この画面に対応するテンプレートファイルは schedule ディレクトリ内の「Day.html」だとわかります。このファイルを編集すれば、現在表示されている画面をカスタマイズできます。（フレーム表示時は Location は正常に表示されませんのでご注意下さい。）

テンプレートファイルを編集するときは、必ず元のファイルをバックアップしてから行なって下さい。そして、編集するときは、HTML オーサリングツール（Microsoft FrontPage や クラリスホームページなど）を使わずに、テキストエディタ（メモ帳など）を使って下さい。オーサリングツールを使うと、書き換えてはいけない部分まで変更される恐れがあります。

また、カスタマイズする際は、元のテンプレートファイルに存在するコメントアウトタグ（『<!-- Admin -->』など）の部分などを削除しないようにして下さい。正常に動作しなくなる可能性があります。

Include ファイル（ヘッダなど）の変更
Include ファイルの作成

サイボウズ Office シリーズのテンプレート HTML ファイルでは、SSI (Server Side Include) のように、HTML ファイル内に別の HTML ファイルを取り込むことができます。この機能を利用すると、ヘッダやフッタなどの作成が容易に行なえます。

例えば、schedule ディレクトリ内の Month.html （月間スケジュールを表示するための HTML ファイル）を開いてみると、ヘッダファイル（schedule ディレクトリ内の Header.html）が取り込まれていることがわかります。

ここで、schedule ディレクトリ内の Header.html（ヘッダファイル）を少し変更してみましょう。

　

<table width="100%"><tr> <td><a href="http://cybozu.co.jp/"> <img border="0" src="/CybozuImages/logo_schedule.gif" alt="スケジュール"></a> <a href="office.exe?">[トップページへ]</a></td> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ この部分を追加する <td align="right"><font size="+1">[_Part_]</font></td> </tr></table><p>

Header.html を変更する

すると、Month.html に基づいて表示される月ビューだけでなく、このヘッダファイルを取り込んでいるすべての画面に変更が反映されます。（左上のタイトルイメージの右側に『[トップページへ]』というリンクが作成されています。）

変更結果が反映された画面（個人の日ビューにも反映される）

このように Include されいてるファイルを変更することで、ヘッダなどが変更できます。

また、Header.html 以外のファイルを作成し、Include することもできます。例えば、schedule ディレクトリ内の Test.html というファイルを Include するために、以下のように記述すると、

<!--#include file="schedule/Test.html"-->

記述された部分に、Test.html が取り込まれます。

Include ファイル作成上の注意点としては、include 文を記述するときに、実行する exe（UNIX の場合は cgi）ファイルからのパスを記述することです。ここでは、実行ファイル schedule.exe が、C:\InetPub\scripts\cybozu にあるため、schedule/Test.html と記述して、取り込むファイルが schedule ディレクトリ配下の Test.html ファイルであることをを指定しています。

この include 機能は、不測の障害を防ぐために、二重の取り込み（include される HTML ファイルの中に include 文を書いてファイルを取り込むこと）ができないようにしています。ご了承下さい。

ページの追加

サイボウズ Office のカスタマイズ機能をさらに活用すると、全く新しい別の画面を作成することも可能です。例えば、schedule ディレクトリ内に Test.html という HTML ファイルを作成し、以下のようにアクセスします。

http://(hostname)/scripts/cybozu/schedule.exe?Test

すると、Test.html は schedule.exe を通じてクライアントに返されます。

ページの追加は、かなり高度なカスタマイズ方法ですので、よく機能をご理解頂いた上で行なって下さいますようよろしくお願い致します。

再インストール、バージョンアップ時の注意

再インストールやバージョンアップを行なったとき、基本的にテンプレートファイルは上書きされます。せっかくカスタマイズした HTML ファイルが上書きされないように、前もってバックアップを取るようにして下さい。

ただし、Windows 版の場合は、インストール時にインストーラが自動的にバックアップを取ります。例えば、C:\InetPub\scripts\cybozu\schedule（サイボウズ スケジュールのデータディレクトリ） にある HTML ファイルをカスタマイズしていたとき、それらのファイルは C:\InetPub\scripts\cybozu\schedule\backup にコピーされ、現在使っている HTML ファイルは新しいバージョンのものに置き換えられます。以下は、再インストール後のバックアップファイルの場所を表わしたものです。