アクセス方法
- BRANTECTにログインします。
- 画面左上のハンバーガーメニューから「ドメイン管理」→「ドメイン一覧」を選択します。
- ドメイン一覧画面（/dn/domains/）上部の「インポート」をクリックします。
テンプレートのダウンロード（推奨）
インポートに必要な列を含むExcelテンプレートをダウンロードできます。
- ドメイン一覧画面（/dn/domains/）を開きます。
- 画面上部の「Excel取込用テンプレート」をクリックします。
- テンプレートファイルがダウンロードされます。
- 日本語環境: `Domain_Import_Template (Ja).xlsx`
- 英語環境: `Domain_Import_Template (En).xlsx`
- テンプレートの2枚目シートにデータを入力します。
インポートの手順
- ドメイン一覧画面（/dn/domains/）を開きます。
- 「インポート」ボタンをクリックします。インポートダイアログが開きます。
- ファイルをセットします（いずれかの方法で）。
- ダイアログ内をクリックしてファイル選択ダイアログから選択する
- ファイルをドロップエリアにドラッグ＆ドロップする
- 「インポート」ボタンをクリックして実行します。
成功の場合:「ドメインのインポートに成功しました」ダイアログが表示されます。OKをクリックすると画面がリロードされ、一覧に反映されます。
エラーの場合:エラーダイアログが表示されます（行番号・列名・エラー理由付き）。ファイルを修正して再度インポートしてください。
ファイル仕様
対応フォーマット
| 形式 | 拡張子 | 備考 |
|---|---|---|
| Excel | .xlsx | Excelスプレッドシート（xlsx形式のみ） |
Excelファイルの注意事項
- シートが1枚の場合: 1枚目のシートからデータを読み込みます。
- シートが2枚の場合: 2枚目のシートからデータを読み込みます（テンプレートをダウンロードすると1枚目に解説シートが追加されるため）。
- ヘッダー直後の行にDOMAIN_NAMEが「example.co.jp」の行がある場合は、サンプル行として自動的にスキップされます。
SYSTEM_REF の動作
| 値 | 動作 |
|---|---|
| C | 新規登録: ドメインをシステムに新規追加します。 |
| 整数（例: 12345） | 既存更新: 指定したSYSTEM_REFのドメインデータを上書き更新します。 |
列定義（全35列）
インポートファイルの1行目はヘッダー行です。以下35列を順番どおりに記述してください。
| # | カラム名（英語） | 日本語 | 必須 | 最大文字数 | 備考 |
|---|---|---|---|---|---|
| 1 | Client | クライアント | ○ | — | 形式: (00000000000) 括弧付き11桁数字 |
| 2 | Sys Ref | Sys Ref | ○ | — | 新規: C / 既存更新: 整数（例: 12345） |
| 3 | Our Ref | Our Ref | — | 15 | 任意の文字列 |
| 4 | Domain Name | ドメインネーム | ○ | 253 | 有効なFQDN形式（例: example.co.jp） |
| 5 | Country/Area | 国・地域 | — | — | |
| 6 | Host Name | ホストネーム | — | 100 | |
| 7 | TLD | トップレベル | — | 63 | トップレベルドメイン |
| 8 | SLD | セカンドレベル | — | 63 | セカンドレベルドメイン |
| 9 | Registrant | 権利者名 | — | 255 | |
| 10 | Internal Category | 権利者区分 | — | — | マスターデータの値のみ有効 |
| 11 | Registrant Type | 名義区分 | — | — | マスターデータの値のみ有効 |
| 12 | Registrant Country/Area | 権利者所在国 | — | 50 | マスターデータの国コード/名称のみ |
| 13 | Registrant Address | 権利者住所 | — | 255 | |
| 14 | Registration Date | 登録日 | — | — | 形式: YYYY/MM/DD または YYYYMMDD Excelの表示形式を文字列もしくはyyyy/mm/ddに変更 |
| 15 | Expiration Date | 更新期限日 | — | — | 形式: YYYY/MM/DD または YYYYMMDD Excelの表示形式を文字列もしくはyyyy/mm/ddに変更 |
| 16 | Similarity detective date | ウォッチ発見日 | — | — | 形式: YYYY/MM/DD または YYYYMMDD Excelの表示形式を文字列もしくはyyyy/mm/ddに変更 |
| 17 | Registrar | レジストラ | — | 255 | |
| 18 | Renewal managing company | 更新管理会社 | — | 255 | |
| 19 | Registration Status | 権利状態 | — | — | マスターデータの値のみ有効 |
| 20 | Progress | 進行状態 | — | — | マスターデータの値のみ有効 |
| 21 | URL | WebサイトURL | 条件付き必須 | 256 | MONITORING=1 の場合は必須 |
| 22 | Forwarding URL | 転送先アドレス | — | 256 | |
| 23 | Web Site Status | Webサイトステータス | — | — | マスターデータの値のみ有効 |
| 24 | Monitoring | モニタリング状況 | — | — | 1: 有効 / 0 or 空: 無効 |
| 25 | Back order | バックオーダー | — | — | |
| 26 | IDN | 多言語区分 | — | — | マスターデータの値のみ有効 |
| 27 | IDN code | 多言語code | — | 100 | |
| 28 | Name Server 1 | ネームサーバー1 | — | 50 | 形式: ns1.example.com (192.0.2.1) |
| 29 | Name server 2 | ネームサーバー2 | — | 50 | 同上 |
| 30 | Name server 3 | ネームサーバー3 | — | 50 | 同上 |
| 31 | Name server 4 | ネームサーバー4 | — | 50 | 同上 |
| 32 | Name server 5 | ネームサーバー5 | — | 50 | 同上 |
| 33 | Name server 6 | ネームサーバー6 | — | 50 | 同上 |
| 34 | Others | 備考 | — | — | 自由記述 |
| 35 | Name Server API Key | ネームサーバーAPIキー | — | — | 形式: (APIキーID) ラベル名 |
※ 35列の後ろにカスタムフィールド列（クライアントが独自設定）が続く場合があります。
入力ルール
ファイル全体のチェック
| チェック項目 | ルール |
|---|---|
| ファイル形式 | .xlsx のみ受け付けます。（CSVは準備中です） |
| 最大行数 | ヘッダーを除くデータ行が5,000行以下であること。 |
| ヘッダー列数 | 標準35列（＋カスタムフィールド数）が揃っていること。 |
| ヘッダー内容 | 列名と順番が仕様と一致していること。 |
行ごとのチェック
| 列（英語） | 列（日本語） | チェック内容 |
|---|---|---|
| Client | クライアント | (XXXXXXXXXXX) 形式（括弧付き11桁数字）であること。 |
| Sys Ref | Sys Ref | C または整数であること。 |
| Our Ref | Our Ref | 15文字以内。 |
| Domain Name | ドメインネーム | 有効なFQDN形式、1〜253文字。新規登録時に既存ドメインと重複不可。同一ファイル内で重複不可。 |
| Host Name | ホストネーム | 100文字以内。 |
| TLD / SLD | トップレベル / セカンドレベル | 各63文字以内。 |
| Registrant / Registrar / Renewal managing company / Registrant Address | 権利者名 / レジストラ / 更新管理会社 / 権利者住所 | 各255文字以内。 |
| Registrant Country/Area | 権利者所在国 | マスターデータに存在する国コード/名称のみ。50文字以内。 |
| Internal Category / Registrant Type / Registration Status / Progress / Web Site Status / IDN | 権利者区分 / 名義区分 / 権利状態 / 進行状態 / Webサイトステータス / 多言語区分 | マスターデータに存在する値のみ。 |
| Registration Date | 日付列（登録日等） | YYYY/MM/DD または YYYYMMDD 形式。 Excelの表示形式を文字列もしくはyyyy/mm/dd。 |
| URL / Forwarding URL | WebサイトURL / 転送先アドレス | 各256文字以内。 |
| URL | WebサイトURL | MONITORING=1 の場合は必須。 |
| IDN code | 多言語code | 100文字以内。 |
| Name Server 1 / Name server 2〜6 | ネームサーバー1〜6 | 各50文字以内。 |
| カスタムフィールド（リスト型） | カスタムフィールド（リスト型） | クライアントに設定された選択肢の値のみ有効。 |
エラーと対処法
ファイルレベルのエラー
| エラーコード | 意味 | 対処法 |
|---|---|---|
| ERROR_INVALID_TYPE | 非対応のファイル形式 | .xlsx ファイルを使用してください。 |
| ERROR_INVALID_SIGNED_URL | 内部処理エラー（署名付きURL無効） | 再試行してください。 |
| ERROR_GET_FILE | ファイル取得失敗 | 再試行してください。 |
| ERROR_INVALID_HEADER_LENGTH | ヘッダーの列数が不足 | テンプレートを確認し、全列を揃えてください。 |
| ERROR_INVALID_HEADER_CONTENT | ヘッダーの列名または順番が不一致 | テンプレートを使用し、列名を修正してください。 |
| ERROR_IMPORT_TOO_MANY_ROWS | データが5,000行を超えている | ファイルを分割してインポートしてください。 |
| ERROR_PARSE_EXCEL_FILE | Excelの解析失敗 | .xlsx 形式で保存されているか確認してください。 |
| ERROR_INVALID_CLIENT_CD | 他クライアントのドメインをインポートしようとした | CLIENTコードを自社のものに修正してください。 |
| ERROR_INVALID_CUSTOM_FIELD_HEADER | カスタムフィールド列名がクライアント設定に存在しない | カスタムフィールドの列名を確認してください。 |
行レベルのエラー（バリデーションエラー）
エラーは「行番号・列名・エラー種別」の形式で表示されます。複数行にエラーがある場合は全バリデーションエラーをまとめて返します。エラーがある行はインポートされません。
| エラー種別 | 意味 |
|---|---|
| invalid | 値の形式が無効 |
| required | 必須項目が未入力（例: Monitoring=1でURLが空） |
| exists | 新規登録（Sys Ref=C）しようとしたドメインが既に登録済み |
| duplicate | インポートファイル内に同じドメイン名（Sys Ref=C）が重複している |
| exceeds_15 | Our Ref が15文字超 |
| exceeds_63 | TLD または SLD が63文字超 |
| exceeds_100 | Host Name または IDN code が100文字超 |
| exceeds_255 | Registrant等が255文字超 |
| exceeds_256 | URL または Forwarding URL が256文字超 |
