リストとはCMSデータとして定義したデータのことです。
リスト管理ページでは、このリストの管理できます。
CMSデータはテナントのシステム要件に応じて自由に設計できるデータです。
定義済のリストの一覧がメニューに表示されます。
下記の画像はサンプルECサイトのリスト一覧になります。テナントによりリスト一覧は異なります。
リスト一覧より管理するCMSデータを選択するとCMSデータ一覧が表示されます。
新規作成ボタン押下すると新規にデータを登録できます。
リサイクルボタン押下すると過去に削除したデータを復元する画面が表示されます。 誤ってデータを削除してしまった場合などに利用します。設定によりますが、復元できる削除データは直近200件のデータのみとなります。
一括アップロードボタンを押下するとデータを一括アップロードする画面が表示されます。詳細は一括アップロードをご参照ください。
一括ダウンロードボタンを押下すると、データをCSV形式でダウンロードできます。 こちらでダウンロードしたCSVは一括アップロードするCSVと同様の形式になります。 ダウンロードデータをフィルターする場合は、一覧で条件を指定してフィルターしてから一括ダウンロードを行ってください。
一覧で選択したデータが一覧の下部に表示されます。
編集ボタンを押下すると表示しているデータを編集できます。
削除ボタンを押下すると表示しているデータを削除します。
新規作成ボタンを押下するとデータを新規登録できます。
連鎖削除ボタンを押下すると表示しているデータを削除する際に、このデータと関連した他のCMSデータを一緒に削除します。
拡張機能:コピーリンクを押下すると表示しているデータを元に、データを新規登録できます。
CMSデータをCSVをアップロードして一括登録します。
ここでは登録するデータを、CSV形式のファイルでアップロードします。
Blob(Binary Large Object)を含むデータを一括登録する場合は、一括アップロード(Zip圧縮)をご参照ください。
以下は一括アップロードボタンを押下したときに表示されるアップロード画面です。
※以下はバナーのリストデータを開いた時で、他のリストデータの場合は ColumnName
, ViewName
の項目が異なります。
アップロードするCSVファイルにはいくつかルールがあります。
ヘッダー列は必ず3行必要
1行目にCMSデータのフィールドの表示名、2行目に型、3行目に列名を記述します。
template downloadリンクよりダウンロードできるCSVテンプレートファイルには上記3行が含まれています。
フィールドの型
CMSデータのフィールドの型は、template downloadリンクよりダウンロードできるCSVテンプレートファイルの2行目に記載されています。
入力必須のフィールドの場合、(*)
が型の後に表示されます。Int32(*)
は、入力必須の整数の型を表します。
型 | 説明 | 設定値の例 |
---|---|---|
Boolean | 真偽値 | True 、False |
Int32 | 整数 | 100 、-100 |
Int64 | 長整数 | 10000 、-10000 |
String | 文字列 | いろはにほへと |
DateTime | 日時 | 2016/09/20 14:08:02 、2020/01/01 |
Byte[] | Blob(バイナリファイル) | Zip圧縮で一括アップロードをする場合に、Zip圧縮前のディレクトリのBlobファイルのパスを指定する。images\hero.png |
CSVの列は可変。但し主キーの列は必須
CSVファイルに用意する列は必ずしも全てのフィールドを用意する必要はありません。
必ず必要な列は、データを一意に識別する主キーとなるフィールドです。データを新規登録する場合は、入力必須のフィールドの列も必要です。
未登録→新規登録。登録済→更新
アップロードするCSVデータが、Commerbleに未登録の場合は新規登録されます。Commerbleに登録済の場合は更新されます。
登録するファイルをZip圧縮してアップロードします。
例:バナー画像を2つ(top-banner.png
, side-banner.png
)アップロードする場合
2020banner.csv
に変更します。CSVファイル名は任意ですが説明の都合上 2020banner.csv
としています。2020banner
を作成します。ディレクトリ名はCSVファイル名と同じにする必要があります。top-banner.png
, side-banner.png
を配置します。Byte[]
型の列に画像ファイルパスを指定します。2020banner
をZip圧縮します。Zip圧縮したファイルはCSVファイル名と同じ 2020banner.zip
としてください。2020banner.zip
を、一括アップロード画面から アップロードします。画像ファイルパスに誤りがあるなど、圧縮ファイルのディレクトリ構成に問題がある場合はアップロード中にエラーとなり登録できません。
うまくいかない場合は以下のことを確認してみてください。
2020banner.zip の構成
2020banner.csv
クライアントマシンがWindowsの場合のアップロード方法を説明します。
今回作成したZipファイルは、こちらよりダウンロードできます。
この例で一括アップロードするCMSデータは静的ファイルを管理するデータで、以下のスキーマとします。
表示名 | カラム名 | 型 | 説明 |
---|---|---|---|
ファイルタイプ | FileType | String(*) | ファイルの種類を保持 |
ファイルパス | FilePath | String(*) | ECサイトで公開するURLのパスを保持 |
コンテンツタイプ | ContentType | String | ECサイトで出力する際のmime-typeを保持 |
ファイル | FileBinary | Byte[] | Blob(バイナリデータ)を保持 |
今回は画像ファイルを2つ、CSSファイルを2つアップロードする例を説明します。
クライアントマシンがmacOSの場合のアップロード方法を説明します。
今回作成したZipファイルは、こちらよりダウンロードできます。
この例で一括アップロードするCMSデータは静的ファイルを管理するデータで、以下のスキーマとします。
表示名 | カラム名 | 型 | 説明 |
---|---|---|---|
ファイルタイプ | FileType | String(*) | ファイルの種類を保持 |
ファイルパス | FilePath | String(*) | ECサイトで公開するURLのパスを保持 |
コンテンツタイプ | ContentType | String | ECサイトで出力する際のmime-typeを保持 |
ファイル | FileBinary | Byte[] | Blob(バイナリデータ)を保持 |
今回は画像ファイルを2つ、CSSファイルを1つアップロードする例を説明します。