7章ページの作成 - 24. ページインポート機能

11. インポートに伴うエラーに対処する

インポート過程でのエラーの有無は「ダッシュボード」画面で確認することができます。

ページのインポートを行うと、状況によってエラーが発生する場合があります。一度にたくさんのファイルをインポートするとエラーも大量に発生することがあるため、インポートの結果発生したエラーについては、ダッシュボード画面に記録が残るようになっています。インポート途中でエラーが発生していたページは、ダッシュボードに一覧表示されます。エラーの詳細は、そこからページ編集画面に入ることで確認することができます。

wrp ファイルのインポートで発生するエラーの例

まず Te をエキスポート時にそのページが使っていたテンプレートとします。wrp ファイルは Te に従って生成されています。

次に Ti をインポート時に使われるテンプレートとします。wrp ファイルをインポートした結果作成されるページは Ti の定義に従って作成されます。

普通は Te と Ti が同じなのでここで紹介するようなエラーが発生することはないのですが、他のサイトで作成した wrp ファイルをインポートする場合や、昔作成した wrp ファイルをインポートする場合など Te と Ti の間に違いが生じてしまっている場合があります。そのような場合に以下のようなエラーが発生することになります。

Ti に定義されている要素 a が Te には定義されていない

Ti に定義されている要素 a が Te には定義されていなかったので wrp ファイル中には a に対応する値が含まれていなかった。インポート処理ではひとまず a の値は Ti に定義されている a の初期値で初期化された状態になっているがエラーとしてレポートされる。

Te に定義されていた要素 a が Ti に定義されていない

Te に定義されていた要素 a が Ti に定義されていない。wrp ファイル中にエキスポートされている要素 a 値の行き場がないため、インポート処理の過程で値が捨てられてしまっている。

Te では繰り返しありとなっていた要素 a が Ti では繰り返しなしになっている

Te では繰り返しありとなっていた要素 a が Ti では繰り返しなしになっている。wrp ファイル中には要素 a の値が a[0] a[1] ... と複数記録されているが Ti の a は繰り返しなしなので a[0] 以外の a[1] 以降の値の行き場がなくインポートの過程で捨てられてしまっている。

Ti には Te と同じ要素 a が定義されているがその型が違っている

例えば Te では「イメージ」型だった要素 a に対して Ti では「複数行テキスト」として定義されている。ほとんどの場合、自動的な型変換はできないため wrp ファイル中の値を受け入れることができず値が捨てられてしまっている。ごく例外的に、例えば「複数行テキスト」と「1行テキスト」などかろうじて型変換できる場合には wrp 中の値を使う場合はある。いずれにしてもエラーはレポートされる。

インポート操作を行ったユーザがデザイナ権限を持っていないため属性を復元できなかった

ページの属性の「変更を禁止」の設定はデザイナ権限が必要ですが、インポートを行ったユーザがデザイナ権限を持っていない場合、この属性を復元できません。エラーが記録されます。また「変更を禁止」の各設定値はすべて OFF に設定されます。

エラーの例と対処の手順

ここでは、ページをエキスポートした時と、それをインポートした時で、テンプレートの要素の型が変わってしまっていた場合のエラーを例に、エラーメセージの表示とダッシュボード上での表示について見てみましょう。

まず、以下のようなテンプレートが定義されているとします。テンプレートの名称は「店舗情報」です。下のスナップショットはこのテンプレートの要素定義画面です。

① phone という名前の要素が定義されています。
② この要素のタイプは「1行テキスト」となっています。

このテンプレートでページを1ページ作ってみましょう。

① テンプレート「店舗情報」で1ページ作成しました。
② ページのタイトルは「中央区」としてあります。
③ 要素には適当な値を入れてあります。
④ ページを一旦保存した後で「エキスポート」ボタンをクリックしてページを wrp ファイルとしてエキスポートします。

① エキスポートするファイル名は「中央区_Rev_1.wrp」とします。
② 「ダウンロード」ボタンをクリックしてファイル「中央区_Rev_1.wrp」をダウンロードします。

ここで、エラーを発生させるためにテンプレート「店舗情報」の定義を少し変更します。

① 要素 phone のタイプを「1行テキスト」から「複数行のテキスト」に変更してしまいます。

この状態で、先ほどダウンロードした「中央区_Rev_1.wrp」をインポートしてみましょう。

インポートでエラーが発生しています。エラーの原因は wrp ファイル中の phone という要素の型が「1行テキスト」だったのに対して、テンプレート「店舗情報」の phone の要素の型が「複数行テキスト」になっていて、要素の型が一致していないことです。メッセージのとおり、エラーの詳細はページ編集画面で確認することができます。また、ダッシュボードにもインポートエラーのあるページとしてリストアップされています。

まず、ダッシュボード側の表示を見てみましょう。

① メニューで「ダッシュボード」をクリックしてダッシュボード画面を表示します。
② 表示されるダッシュボード画面には「インポートエラーのあるページ」として「中央区」がリストされています。この表示はページ「中央区」でエラーを除去するまで維持されます。
③ インポートにより作成されたページは「編集中」状態で作成されるのでこの欄にもリストされています。

では、ページ編集画面に入ってみましょう。

④ 操作欄にある編集ボタンをクリックするとページ「中央区」のページ編集画面に入ることができます。ページ編集画面の表示は下のスナップショットのようになっているでしょう。

① インポート時に発生したエラーのメッセージが表示されています。なお、インポート時に 03-xxxx-xxxx という値はなんとか受け取ることができました。これは型の違いが小さかったためです。多くの場合、型が違う場合には値は受け取れずに破棄されてしまいます。
② エラー表示右上のクローズボタンをクリックすることでエラーを消すことができます。クローズボタンはエラーを消す効果しかありません。エラーを消すとダッシュボード上の「インポートエラーのあるページ」へ掲載が終わります。

発生したエラーに対して個別に要素の値を再入力などして対応することができるかもしれません。または、インポート自体をやり直す場合には、インポートによって作成されたページを削除するか、または、リビジョンを削除してからインポートし直してください。