Zipアップロード機能マニュアル（JSP版）

Transcription

1 HeartCore Zip アップロード 機 能 マニュアル(JSP 版 ) October 2013 Ver

2 改 訂 履 歴 改 訂 日 改 訂 内 容 Ver 年 07 月 マニュアル 改 訂 Ver 年 10 月 行 間 の 修 正 対 象 ライセンス 項 目 の 追 加 Ver 年 10 月 フォーマット 改 訂 - 2 -

3 目 次 1 本 文 書 の 目 的 と 対 象 ライセンス 目 的 対 象 ライセンス 機 能 概 要 Zipアップロード 機 能 とは? Zipアップロード 機 能 の 利 用 目 的 Zipアップロード 機 能 を 利 用 可 能 なユーザ 権 限 Zipアップロードの 流 れ Zipアップロード 機 能 の 制 限 事 項 Zip アップロード 機 能 導 入 手 順 Zipアップロードモジュールの 実 装 手 順 Zipアップロードモジュールの 実 装 手 順 Zip アップロード 機 能 利 用 手 順 Zipアップロード 画 面 の 説 明 Zip 圧 縮 ファイルの 作 成 Zipアップロードを 行 う 付 録 1 HeartCoreの 公 開 方 式 設 定 について

4 1 本 文 書 の 目 的 と 対 象 ライセンス 1.1. 目 的 本 文 書 は 弊 社 がお 客 様 に 納 品 する CMS パッケージ 製 品 HeartCore における Zip アップ ロード 機 能 の 実 装 手 順 及 び 操 作 手 順 を 説 明 する 文 書 です お 客 様 が 実 際 に Zip アップロード 機 能 を 利 用 するにあたり 本 文 書 を 参 照 することで 該 当 機 能 の 一 通 りの 操 作 を 行 うことができることを 目 的 としております 1.2. 対 象 ライセンス 当 該 機 能 を 提 供 しているライセンスは 以 下 の 通 りです 尚 価 格 は 価 格 表 を 参 照 願 います Professional Enterprise Standard Suite Standard Suite Zip アップロード 機 能 : 標 準 装 備 :オプション 装 備 -: 設 定 なし 2 機 能 概 要 2.1 Zip アップロード 機 能 とは? HeartCore で 利 用 する WEB コンテンツを HTML ファイルから HeartCore コンテンツとし て 登 録 するための 機 能 です HTML で 作 成 した 複 数 の WEB コンテンツを Zip 形 式 で 圧 縮 し その 圧 縮 したファイルを Zip アップロード 機 能 でアップロードすることで 圧 縮 ファイル 内 の WEB コンテンツがまとめて HeartCore の WEB コンテンツとして 登 録 されます また 圧 縮 ファイル 単 位 で HeartCore コンテンツ(イメージ ファイル)グループ コンテ ンツ(イメージ ファイル)タイプの 設 定 や コンテンツの 公 開 日 時 公 開 終 了 日 時 の 設 定 が 可 能 です 2.2 Zip アップロード 機 能 の 利 用 目 的 複 数 の HTML ファイルをまとめて HeartCore の WEB コンテンツとして 登 録 することがで きるため 既 存 WEB コンテンツの 移 行 作 業 等 の 必 要 工 数 を 削 減 することができます 2.3 Zip アップロード 機 能 を 利 用 可 能 なユーザ 権 限 Zip アップロード 機 能 を 利 用 することができるユーザは HeartCore の Super Admin(シス テム 管 理 者 ) 権 限 を 持 ったユーザとなります - 4 -

5 2.4 Zip アップロードの 流 れ Zip アップロード 機 能 を 利 用 するための 大 まかな 手 順 は 以 下 の 通 りです (1) HTML 形 式 WEB コンテンツ(イメージ ファイル 含 む)をZip 形 式 で 圧 縮 する (2) HeartCore のZip アップロード 画 面 より 適 用 するコンテンツ(イメージ ファイル)グ ループ コンテンツ(イメージ ファイル)タイプを 選 択 する (3) 圧 縮 ファイルを 選 択 し Zip アップロードを 行 う 2.5 Zip アップロード 機 能 の 制 限 事 項 (1) HeartCore ZIP アップロード 機 能 は ZIP ファイルにある HTML ファイルの 内 容 をその まま HeartCore へ 取 り 込 む (2) 元 HTML ファイルに 対 して 変 更 処 理 (URL 書 換 え JavaScript/HTML 分 離 文 字 コード 変 更 など)を 行 わない (3) HeartCore ZIP アップロードは 一 つの ZIP ファイルを 一 つのコンテンツグループに 対 し てのみ 処 理 する (4) コンテンツグループを 分 けて HTML ファイルを ZIP する 必 要 がある ( 一 つの ZIP ファ イルを 複 数 のコンテンツグループへアップロードすることはできない) (5) ZIP アップロード 時 コンテンツグループの 指 定 が 必 須 であるコンテンツグループを 指 定 せずにアップロードすることができない (6) ZIP ファイルにある HTML ファイルのエンコーディングが 統 一 する 必 要 がある エンコー ディングが 混 在 することはできません (7) ZIP ファイルの 中 にあるファイル 名 は 英 数 字 及 び _ -. のみとする 全 角 ファイ ル 名 スペースなどが 入 っているファイル 名 が 処 理 できない (8) アップロードする ZIP ファイルのファイル 名 は 英 数 字 及 び _ -. のみとする 全 角 ファイル 名 スペースなどが 入 っているファイル 名 が 処 理 できない - 5 -

6 (9) ZIP アップロード 時 には HeartCore の 設 定 にてコンテンツグループ イメージグループ ファイルグループを 有 効 にする 必 要 がある (10) ZIP アップロード 時 には アップロードするユーザが コンテンツグループ イメージグ ループ ファイルグループに 対 してアクセス 可 能 な 権 限 を 設 定 する 必 要 がある (11) Zip ファイルにイメージ 及 び その 他 ファイル(PDF など)が 混 在 していて アップロー ド 時 に 格 納 するイメージ(ファイル)グループ イメージ(ファイル)タイプを 選 択 しな かった 場 合 デフォルトの -なし- のグループ 及 び タイプに 設 定 される (12) ZIP ファイルにパスワードをかけることができない (13) アップロードする ZIP ファイルサイズの 上 限 は 設 定 ファイルで 設 定 可 能 です ただし WEB ベースアップロード 処 理 なので ネットワークなどの 環 境 に 依 存 するが ファイルサ イズが 大 きい 場 合 クライアントブラウザはタイムアウトが 発 生 する 場 合 もある (14) HTML ファイルをアップロードする 場 合 は その HTML のメタ 情 報 も 取 り 込 む メタ 情 報 が 空 の 場 合 は 空 で 登 録 される - 6 -

7 3 Zip アップロード 機 能 導 入 手 順 表 記 説 明 本 文 書 の 手 順 説 明 に 下 記 の 表 記 を 使 います $TOMCAT_HOME : TOMCAT のインストールパス 3.1 Zip アップロードモジュールの 実 装 手 順 (1) WEB サーバのサービスを 停 止 します (2) Tomcat のサービスを 停 止 します (3) Tomcat のJSP キャッシュを 削 除 します (4) Tomcat の$TOMCAT_HOME/webapps/ROOT フォルダをバックアップします (5) Tomcat の$TOMCAT_HOME/webapps/ROOT ディレクトリ 内 に ZipUpload モジュー ルを 展 開 します ( 上 書 き. 確 認 が 出 た 場 合 は 上 書 きを 許 可 してください ) (6) Zip アップロード 機 能 設 定 ファイル(zipupload.properties)を 開 き 動 作 環 境 に 合 わせて 設 定 します (7) モジュールを 適 用 するHeartCore の webadmin/module/config.jsp ファイルに ZipUpload モジュールのメニューを 追 加 します 追 記 する 内 容 :JSP 版 の 記 述 例 <%@ include file="zipupload/config.jsp" %> (8) Zipアップロードモジュールでコンテンツを 公 開 処 理 する 場 合 は 環 境 の ROOT ディレク トリ 直 下 に 配 置 されている config.static.jsp ファイルに 下 記 の 記 述 内 容 を 追 加 します 追 記 する 内 容 myconfig.settemp("use_zipupload_publish","yes"); (9) Tomcat のサービスを 開 始 します (10) WEB サーバのサービスを 開 始 します - 7 -

8 3.2 Zip アップロードモジュールの 実 装 手 順 下 記 のZipUpload 設 定 ファイルで ZipUpload の 機 能 設 定 を 行 います Zip アップロード 機 能 設 定 ファイル $TOMCAT_HOME/WEB-INF/classes/ zipupload.properties 設 定 ファイル 項 目 説 明 (1) UPLOAD_TEMP_PATH アップロードファイルの 一 時 保 存 ディレクトリをROOTからの 相 対 パスで 指 定 します ( 例 えば $TOMCAT_HOME/webapps/ROOT/tmp/ に 指 定 します 事 前 に$TOMCAT_HOME/webapps/ROOT/tmp/フォルダを 作 成 する 必 要 があります) (2) HTML_TYPE HTML ファイルの 拡 張 子 を 指 定 します (ここに 登 録 した 拡 張 子 のファイ ルは コンテンツとしてアップロードされます) 通 常 デフォルトのままで 変 更 する 必 要 があり ません (3) IMAGE_TYPE イメージファイルの 拡 張 子 を 指 定 します (ここに 登 録 した 拡 張 子 のファ イルは イメージとしてアップロードされます) A) 通 常 デフォルトのままで 変 更 する 必 要 がありません また IMAGE_TYPEに 設 定 されて いない 拡 張 子 のイメージファイルは ファイルコンテンツとしてアップロードされます (4) CSS_TYPE 保 留 パラメータ このパラメータを 変 更 しないでください (5) SIZETHRESHOLD 保 留 パラメータ このパラメータを 変 更 しないでください (6) FILESIZEMAX アップロードファイルの 最 大 ファイルサイズ(バイト 数 )を 指 定 します このパラメータを SIZEMAX パラメータと 同 じ 値 に 設 定 してください (7) SIZEMAX アップロードファイルの 最 大 ファイルサイズ(バイト 数 )を 指 定 します この パラメータをFILESIZEMAX パラメータと 同 じ 値 に 設 定 してください (8) LOGGING_FLAG Zip アップロード 機 能 の 実 行 ログをTomcat のログファイルに 書 き 込 む かどうかを 設 定 します (1= 書 き 込 む 0= 書 き 込 まない) (9) TITLE_SUMMARY_SAME_FLAG ZIP アップロード 時 HTMLの<TITLE>タグの 内 容 を コンテンツタイトルに 設 定 する 以 外 に コンテンツのサマリにも 設 定 する (10) HTML_PARSER_FLAG 内 部 用 保 留 パラメータです 変 更 しないでください - 8 -

9 設 定 例 UPLOAD_TEMP_PATH=tmp HTML_TYPE=html,htm,shtml IMAGE_TYPE=jpg,jpeg,swf,bmp,gif,png CSS_TYPE=css SIZETHRESHOLD=4096 FILESIZEMAX= SIZEMAX= LOGGING_FLAG=1 TITLE_SUMMARY_SAME_FLAG = 1 HTML_PARSER_FLAG = 1 4 Zip アップロード 機 能 利 用 手 順 4.1 Zip アップロード 画 面 の 説 明 (1) (2) (1) (2) (3) (4) (5)(3) (4) (5) (6) (7) (6) (8) (9) (7) (10) (8) (11) (9) (12) (13) (1) コンテンツグループ Zip アップロードするコンテンツに 設 定 するコンテンツグループを 選 択 します (2) コンテンツタイプ Zip アップロードするコンテンツに 設 定 するコンテンツタイプを 選 択 します (3) イメージグループ Zip アップロードするイメージに 設 定 するイメージグループを 選 択 します (4) イメージタイプ Zip アップロードするイメージに 設 定 するイメージタイプを 選 択 します - 9 -

10 (5) ファイルグループ Zip アップロードするファイルに 設 定 するファイルグループを 選 択 します (6) ファイルタイプ Zip アップロードするファイルに 設 定 するファイルタイプを 選 択 します (7) コンテンツの 公 開 設 定 フィールド Zip アップロードするコンテンツに 公 開 を 設 定 します (8) コンテンツの 開 始 時 間 設 定 フィールド Zip アップロードするコンテンツに 公 開 開 始 時 間 を 設 定 します ( 公 開 開 始 時 間 を 有 効 にするには コンテンツを 公 開 処 理 する 必 要 があります ) (9) コンテンツの 終 了 時 間 設 定 フィールド Zip アップロードするコンテンツに 公 開 終 了 時 間 を 設 定 します ( 公 開 終 了 時 間 を 有 効 にするには コンテンツを 公 開 処 理 する 必 要 があります ) (10) コンテンツ 選 択 フィールド Zip アップロードする 圧 縮 ファイルを 選 択 します (11) 同 じServer-Filename のコンテンツがサーバにある 場 合 上 書 きする (チェック) アップロードする 圧 縮 ファイルと 同 じディレクトリ 構 成 で アプリケーションサーバ 上 に 同 じフ ァイル 名 のコンテンツがあった 場 合 このチェックをつけることで 上 書 きすることができます チェックをつけない 場 合 アップロード 処 理 を 行 いません (12) 文 字 コードの 選 択 アップロードするHTML コンテンツの 文 字 エンコードを 指 定 します この 項 目 で 設 定 した 文 字 エ ンコード 以 外 で エンコーディングされたHTML コンテンツは 正 常 にZip アップロードされま せん (13) OK ボタン 設 定 した 内 容 で Zip アップロードを 実 行 します 4.2 Zip 圧 縮 ファイルの 作 成 Zipアップロード 機 能 で 複 数 のHTML コンテンツをHeartCoretコンテンツとして 登 録 するには Zip 形 式 の 圧 縮 ファイルを 作 成 する 必 要 があります なお ZIPファイルに 格 納 されているフォルダ 構 成 は そのままアプリケーションサーバに 展 開 さ れます そのため アプリケーションサーバに 展 開 するHTMLコンテンツに 対 して ディレクトリ 構 成 を 定 義 したい 場 合 は ZIPファイルに 定 義 するディレクトリ 構 成 で 格 納 する 必 要 があります

11 4.3 Zip アップロードを 行 う (1) HeartCore 管 理 コンテンツへシステム 管 理 者 権 限 ユーザでログインします (2) 管 理 メニューより 設 定 メニューをクリックします (3) 設 定 メニューツリーより Zip Upload メニューをクリックします (4) Zip アップロードする HTML コンテンツに コンテンツ(イメージ ファイル)グループ コンテンツ(イメージ ファイル)タイプを 設 定 します

12 (5) Zip アップロードする HTML コンテンツに 公 開 チェックボックスを 選 択 した 状 態 で 公 開 開 始 時 間 公 開 終 了 時 間 を 設 定 します (6) 参 照 ボタンを 押 し Zip アップロードする 圧 縮 ファイルを 選 択 します (7) 同 一 ファイル 名 であるファイルが 存 在 した 場 合 上 書 きを 行 うには 同 じServer-filename のコ ンテンツがサーバにある 場 合 上 書 きする にチェックをつけます

13 (8) 既 にコンテンツが 登 録 されている 場 合 既 存 の 設 定 情 報 を 初 期 化 して 登 録 する 場 合 は 既 存 情 報 を 初 期 化 する ラジオボタンを 選 択 します 既 存 の 設 定 情 報 を 維 持 したまま 登 録 する 場 合 は 既 存 情 報 を 維 持 する ラジオボタンを 選 択 しま す (9) OK ボタンを 押 すことで Zip アップロード 処 理 が 行 われます (10) Zip アップロード 処 理 が 終 了 すると 各 ファイルの 完 了 ステータスが 表 示 されます アッ プロードに 失 敗 したファイルや 記 述 形 式 に 注 意 点 があった 場 合 においても エラー 内 容 を 表 示 します

14 (11) ウェブサイトコンテンツメニューを 開 き Zip アップロードしたコンテンツグループから コンテンツを 確 認 します このように Zip アップロードしたHTML コンテンツを HeartCore のコンテンツとして 登 録 する ことができます 5 付 録 1 HeartCore の 公 開 方 式 設 定 について ZIP 圧 縮 ファイルにあるHTML ファイルが HeartCore の 公 開 設 定 によって 下 記 のように 違 う 方 法 でアップロードされます

15 (1) 公 開 方 式 が ページを 公 開 するのに 動 的 Web アドレスを 使 用 します と 設 定 されている 場 合 HTML ファイルはHeartCore DB に 登 録 されます (2) ( 静 的 ファイルが 生 成 されない) 公 開 方 式 が ページを 公 開 するのに 静 的 Web アドレスを 有 効 にします (3) *.html ファイルと*.css ファイルを 動 的 に 出 力 します と 設 定 されている 場 合 HTML ファイルはHeartCore DBに 登 録 され HTML ファイルのパスと 同 じパスの 動 的 ファイルも 生 成 される (4) 例 えば /abc/xyz.html がロードされた 場 合 $TOMCAT_HOME/wbapps/ROOT/abc/xyz.html/index.jspファイルが 生 成 されます (5) 公 開 方 式 が ページを 公 開 するのに 静 的 Web アドレスを 有 効 にします (6) *.html ファイルと*.css ファイルをWEB サーバーに 対 し 静 的 なファイルとして 配 信 し ます と 設 定 されている 場 合 HTML ファイルはHeartCore DB に 登 録 され HTML ファイ ルパスと 同 じパスの 静 的 ファイルも 生 成 されます (7) 例 えば /abc/xyz.html がロードされた 場 合 $TOMCAT_HOME/webapps/ROOT/abc/xyz.htmlファイルが 生 成 されます

16 ZIP 圧 縮 ファイルにあるHTML ファイルにメタ 情 報 が 記 述 されている 場 合 は コンテンツの メタ 情 報 へ 登 録 されます Zipアップロードを 行 なったHTMLソースメタ 情 報 の 例 <meta name="author" content=" 作 成 者 " /> <meta name="description" content="メタディスクリプション" /> <meta name="keywords" content="keywords1,keywords2,keywords3 キーワード" /> <meta name="robots" content="all" /> (1) HTML ファイルに 記 述 されている author メタ 情 報 は 作 成 者 として 登 録 されます (2) HTML ファイルに 記 述 されている description メタ 情 報 は メタディスクリプションとして 登 録 されます (3) HTML ファイルに 記 述 されている keywords メタ 情 報 は キーワードとして 登 録 されます (4) HTML ファイルに 記 述 されている author description keywords 以 外 のメタ 情 報 は 追 加 のメタ 情 報 として 追 加 登 録 されます

17 (1) ZIP 圧 縮 ファイルにあるHTML ファイルのHEAD 情 報 は コンテンツの HTML HEADコード へ 登 録 されます (2) ZIP 圧 縮 ファイルにあるHTML ファイルのBODYタグ 属 性 情 報 は コンテンツの HTML BODY 属 性 へ 登 録 されます 以 上