インポート時に使用する記事データファイルの条件を次に示します。

• ファイルフォーマットどおりの記述であること。
• ユティリティコマンドを実行するユーザに，ファイルに対する読み取り権限があること。
• BOMは付けないこと。
• ファイル内の記事に対して記事を追加する場合は，上位記事よりあとに記述すること。

• cbbimpnoticeコマンド（記事のインポート）で指定するファイル
  拡張子を持つ任意のファイル名を指定できます。拡張子の種類は任意です。拡張子は，ファイル末尾からファイル先頭に向かって最初に現れたピリオドまでとなります。ピリオドが一つもないファイルは，拡張子がないものとします。
  
• cbbexpnoticeコマンド（記事のエクスポート）で出力するファイル
  ファイル名は次の形式となります。
  

  「cbbexpnotice」＋「_」＋年月日時分秒＋「.csv」

  年月日時分秒には，コマンドの実行日時が次の形式で出力されます。
  

  「年（4桁）」＋「月（2桁）」＋「日（2桁）」＋「時（2桁<24h表示>）」＋「分（2桁）」＋「秒（2桁）」

  なお，次の場合には，二つ目以降のファイル名に「2」以降の通番が与えられます。
  
  • プロパティファイルhptl_clb_cbb_command.propertiesのhptl_clb_cbb_notice_max_numキーによって出力する記事データファイルを分割する場合
    「.csv」の前に「[n]」（nは「2」以上の整数）の通番が与えられます。
    
  • 同じ日時に同時にcbbexpnoticeコマンド（記事のエクスポート）が実行された場合
    「.csv」の前に「(n)」（nは「2」以上の整数）の通番が与えられます。
    

ファイルのフォーマットは次のとおりです。

• 1行目は項目名のヘッダとする。
• 1記事につき1行とし，改行またはファイルの終端を行の終端とする。
• 各項目は半角コンマ「,」で区切る。
• 各項目は半角ダブルクォーテーション「"」で囲む。
• 行の先頭が「#」の場合はコメント行として扱う。
• 半角ダブルクォーテーション「"」は，「""」（半角ダブルクォーテーション二つ）で表記する。
• cbbexpnoticeコマンド（記事のエクスポート）実行時に-eオプションを指定した場合，1行は4,527バイトまで指定できる。それ以外の場合は，3,727バイトまで指定できる。

記事データファイルの項目を次の表に示します。なお，エクスポート時に値がない項目には，「""」が出力されます。

表F-1　記事データファイルの項目

項番	項目	説明	項目値と値の意味	インポート時
				指定可否	省略時仮定値
1	掲示板ID	記事を登録または更新する掲示板のID	1〜2,147,483,647の整数 （cbbexpnoticeコマンド（記事のエクスポート）で出力した掲示板一覧ファイルに存在し，掲示板状態が公開中の掲示板IDを記述する）	●	なし
2	掲示板名	記事を登録または更新する掲示板の名称	なし	−	なし
3	記事ID	記事の登録番号	1〜2,147,483,647の整数 （cbbexpnoticeコマンド（記事のエクスポート）で出力した記事一覧ファイルに存在する記事IDを記述する。記事の更新の場合だけ，記事IDを記述する）	○	なし
4	登録記事ID	記事データファイル内で記事を一意に識別するための値	1〜2,147,483,647の整数 （本文ファイル，添付ファイルとの関連づけをするため，重複不可） なお，エクスポート時の登録記事IDは，複数のファイルをまたいでも通番で採番される。	●	なし
5	主題	記事の主題	255バイト以内の文字列	●	なし
6	ユーザID	記事掲示者のユーザID	255バイト以内の半角文字列	●	なし
7	ユーザ名	記事掲示者のユーザ名	なし	−	なし
8	ユーザ名(英名)	記事掲示者のユーザ名(英名)	なし	−	なし
9	属性ID	記事の属性を示すID	0〜99,999の整数 （cbbexpnoticeコマンド（記事のエクスポート）で出力した属性一覧ファイルに存在する属性IDを記述する）	●	なし
10	属性名	記事の属性を示す名称	なし	−	なし
11	重要度ID	記事の重要度を示すID	0〜99,999の整数 （cbbexpnoticeコマンド（記事のエクスポート）で出力した重要度一覧ファイルに存在する重要度IDを記述する）	○	重要度「普通」を示すID
12	重要度名	記事の重要度を示す名称	なし	−	なし
13	階層レベル	記事の階層を示す値 0：最上位記事 1〜10：記事の階層	なし	−	なし
14	上位記事	上位記事の記事IDまたは登録記事ID 0：該当なし その他：記事IDまたは登録記事ID	最上位記事の場合 0 記事IDの場合 1〜2,147,483,647の整数 登録記事IDの場合 1〜2,147,483,647の整数 なお，上位記事に指定する値は次のとおりです。 掲示板への登録の場合は，0を記述する。 既存の記事への追記の場合は，cbbexpnoticeコマンド（記事のエクスポート）で出力した記事一覧ファイルに存在する記事IDを記述する。 記事データファイル内の記事への追記の場合は，「"N"＋記事データファイルに存在する登録記事ID」を記述する。 エクスポート時，出力した記事データファイルに上位記事が存在する場合は，上位記事の記事IDではなく，「N」＋上位記事の「登録記事ID」である。	△2	なし
15	下位開始記事ID	下位記事中の最初の記事ID 0：該当なし その他：記事ID	なし	−	なし
16	下位終了記事ID	下位記事中の最後の記事ID 0：該当なし その他：記事ID	なし	−	なし
17	前記事ID	前記事の記事ID 0：該当なし その他：記事ID	なし	−	なし
18	後記事ID	後記事の記事ID 0：該当なし その他：記事ID	なし	−	なし
19	最上位記事ID	最上位（掲示板の直下に作成した記事）の記事ID(レコードが最上位記事の場合は自身の記事IDを設定している)	なし	−	なし
20	記事管理者のユーザID	記事管理者のユーザID	255バイト以内の半角文字	○	項番6「ユーザID」の値
21	記事管理者のユーザ名	記事管理者のユーザ名	なし	−	なし
22	記事管理者のユーザ名(英名)	記事管理者のユーザ名(英名)	なし	−	なし
23	添付ファイル有無	記事に添付されている添付ファイルの有無 0：添付ファイルなし 1：添付ファイルあり	0または1	○	0
24	掲示期限	記事の掲示期限	yyyy/MM/dd形式の日付 ※ （システムパラメタmax_roomeffectiveの設定値まで）	△1	掲示日にシステムパラメタdef_roomeffectiveの設定値（日数）を加えた日付
25	掲示日	記事の掲示指定日付	yyyy/MM/dd形式の日付 ※	△1	記事を登録または更新した日付（コマンド実行開始日付）
26	記事参照URL	［記事参照］画面を表示するURL	なし	−	なし

（凡例）

●：指定が必須の項目

○：指定が任意の項目

−：指定不要。指定した場合は無視される

△1：最上位記事の場合は「○」，最上位記事以外の場合は「−」として扱う

△2：記事の登録の場合は「●」，記事の更新の場合は「−」として扱う

注※

設定できる日付の範囲は1970/1/1〜9999/12/31。

「MM」「dd」に指定する値は次のとおり。01〜09は1〜9と指定できる。

・MM（月）：01〜12

・dd（日）：01〜31

掲示日は，掲示期限以前の日付を記述すること。

値に指定する日付のタイムゾーンは，コマンドを実行するOSのデフォルトロケールのタイムゾーンとすること。

エクスポートした記事データファイルの1行目にはヘッダを出力します。ヘッダは行の先頭に「#」を付加し，コメント行として出力されます。ヘッダに出力する項目を次の表に示します。

表F-2　記事データファイルのヘッダに出力する項目

項番	プロパティ	ヘッダに出力する項目
1	掲示板ID	"掲示板ID"
2	掲示板名	"掲示板名"
3	記事ID	"記事ID"
4	登録記事ID	"登録記事ID"
5	主題	"件名"
6	ユーザID	"ユーザID"
7	ユーザ名	"ユーザ名"
8	ユーザ名(英名)	"ユーザ名(英語)"
9	属性ID	"属性ID"
10	属性名	"属性名"
11	重要度ID	"重要度ID"
12	重要度名	"重要度名"
13	階層レベル	"階層レベル"
14	上位記事	"上位記事"
15	下位開始記事ID	"下位開始記事ID"
16	下位終了記事ID	"下位終了記事ID"
17	前記事ID	"前記事ID"
18	後記事ID	"後記事ID"
19	最上位記事ID	"最上位記事ID"
20	記事管理者のユーザID	"記事管理者のユーザID"
21	記事管理者のユーザ名	"記事管理者のユーザ名"
22	記事管理者のユーザ名(英名)	"記事管理者のユーザ名(英語)"
23	添付ファイル有無	"添付ファイル有無"
24	掲示期限	"掲示期限"
25	掲示日	"掲示日"
26	記事参照URL	"記事参照URL"※

注※　-eオプションを指定した場合だけ出力されます。