> For the complete documentation index, see [llms.txt](https://manuals.i-reporter.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.i-reporter.jp/input-features/custom-master/settings-in-manager/registration.md).

# カスタムマスターの登録

## **カスタムマスターの登録**

カスタムマスターの登録・更新はすべてCSVで行います。\
i-Repo ManagerでCSVファイルをアップロードして登録・更新します。

{% hint style="info" %}
弊社が公開している「カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）」を利用して、EXCEL上で「カスタムマスター取り込みCSVレイアウト」に準拠したCSVファイルを作成できます。\
このブックはCSVの読み込みと書き出しが可能です。

詳細は、「[カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）](/input-features/custom-master/custommasterinputsheet.md)」 ページをご参照ください。
{% endhint %}

ブックを開く時に 「セキュリティー警告」が表示される場合は「コンテンツの有効化」 を選択してください。

{% hint style="success" %}
「コンテンツの有効化」の詳細は、Microsoft社のサポートページでご確認ください。\
（「ドキュメントを信頼してマクロを有効にする」等で検索するとヒットします。）
{% endhint %}

「カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）」は、「入力シート」をコピーして使うことはできません。

<figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/QNPJ2IXjkCb8R65kTiQc/image.png" alt=""><figcaption></figcaption></figure>

## **EXCELファイルでのCSV作成**

【手順】

1. 「カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）」をダウンロードします。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>ダウンロードの際は、「<a href="/input-features/custom-master/custommasterinputsheet.md">カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）</a>」 ページをご参照ください。</p></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/iAZF15MPH9NIO2FaRaSX/image.png" alt=""><figcaption></figcaption></figure></div>

2. Excelを起動し、入力シートの背景が白のセルに必要な情報を記入します。\
   各入力項目タイトルのセル内コメント欄には、入力についての説明があります。<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/ogm20CsioEQw3XoGvJN1/image.png" alt=""><figcaption></figcaption></figure></div>

3. マスターの基本情報の各セルに以下の要領にて値を入力します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/hFDDfRxpHGCmP0WhbzhL/image.png" alt=""><figcaption></figcaption></figure></div>

   マスターの基本情報の設定<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/SFAOTTzMlnaWdloAGT1x/image.png" alt=""><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/0WX72ziHXrrBdQJzaEzr/image.png" alt=""><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/8AdmYSDZaT203yvCRvFp/image.png" alt=""><figcaption></figcaption></figure></div>

4. カスタムマスターテーブルを構成するキー情報とそのフィールドの情報を設定します。<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/vVBstqYXSLm3liCi1OQM/image.png" alt=""><figcaption></figcaption></figure></div>

5. カスタムマスターテーブルを構成する実際のレコード情報を設定します。<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/khoshQhuPsN9lrCSIbFr/image.png" alt=""><figcaption></figcaption></figure></div>

   \
   レコード情報の設定

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/a2Zp1mn1MyZKiAXHNy1x/image.png" alt=""><figcaption></figcaption></figure></div>

   レコード情報の設定：画像情報の設定<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/BEcHS5tjThCVJn2qaApQ/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

## **EXCELファイルからCSV出力**

セルに値を入力後、下記の操作を行います。

<div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/U4ABZyvlZUooIVgvM3gM/image.png" alt=""><figcaption></figcaption></figure></div>

## **CSVのアップロード**

作成したCSVをi-Repo Managerからアップロードします。

【手順】

1. i-Repo Managerの上部メニュー「カスタムマスター」 ＞ 「カスタムマスターメンテナンス」ボタンをクリックします。

   <figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FydRezGHqqDh6aysHWS7a%2Fimage.png?alt=media&amp;token=8000487d-d4cd-4496-a367-dd2da25edc94" alt=""><figcaption></figcaption></figure>

2. 「カスタムマスターメンテナンス」画面で、各項目を設定します。

   <figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2F8at4a6cNTzJbSNPRQjVf%2Fimage.png?alt=media&amp;token=159f2ed1-1ca7-483a-b1de-6b6cff872dfd" alt=""><figcaption></figcaption></figure>

   \
   **ファイル形式**\
   「画像フィールド」に画像をセットしない（カスタムマスターに画像を含まない）場合は「CSV」を、「画像フィールド」に画像をセットする場合は「CSV\_ZIP」を指定します。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>「画像フィールド」に画像をセットする場合は、ファイル形式に「CSV_ZIP」を指定します。<br>詳細は、「<a href="#nocsvwoappusuru">画像付のCSVを作成、アップする方法</a>」 をご参照ください。</p></div>

   \
   **Encoding**\
   アップロードするCSVファイルのエンコードを指定します。\
   日本語版の「カスタムマスター定義用Excelブック（CustomMasterInputSheet.xlsb）」を使用して作成したCSVの場合、Encodingは「Shift\_jis」になっています。\
   \
   **ラベルの位置設定**\
   CSVで設定する「ラベル」が「Label\_A/LabelA-1」のように階層になっている場合、作成されたカスタムマスターには、「Label\_A」、「LabelA-1」の２つのラベルが付きます。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FX10I1dINmJy9fCnTJraW%2Fimage.png?alt=media&amp;token=f9a7afe6-01a0-4573-b326-30ecd8eb72f3" alt="" width="563"><figcaption></figcaption></figure></div>

   「ラベルの位置設定」にチェックを入れることで、一番下階層のラベルのみを付けることができます。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FYHKttmq1ll2K6yOg3HHq%2Fimage.png?alt=media&amp;token=39c4bb0e-bde0-4f01-9b21-770ad8ca88d4" alt="" width="563"><figcaption></figcaption></figure></div>

   \
   **エラーレコードをスキップして続行**\
   CSVファイルアップロード時、エラーとなるレコードが存在した場合に、カスタムマスター登録処理を続行するか中断するかを選択します。

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>「エラーレコードをスキップして続行」は、ConMas Manager 8.2.26020 で追加された機能です。</p></div>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>詳細は「<a href="#errekdowosukippushite">エラーレコードをスキップして続行</a>」をご参照ください。</p></div>

   \
   **ファイルの選択**\
   アップロードするCSVファイルを選択します。<br>

3. 「登録」ボタンをクリックし、CSVファイルをアップロードします。

4. アップロードが完了すると、画面に処理結果が表示されます。\
   \
   **i-Repo Manager(ConMas Manager)  8.2.26020 以降**\
   「インポート結果」欄に処理結果が表示されます。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FQSAfLskILFdycV24WUVe%2Fimage.png?alt=media&amp;token=af40c242-1056-41ff-ac3b-8896cc6d7243" alt="" width="304"><figcaption></figcaption></figure></div>

   \
   エラーが発生した場合はメッセージをご確認の上、CSVファイルを修正して再度取り込んでください。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FOaFiLDXbqt6xHnbgxAqz%2Fimage.png?alt=media&amp;token=75f6620f-8dc1-43e0-8ba5-bbd454f3fd62" alt="" width="294"><figcaption><p>エラーメッセージの一例</p></figcaption></figure></div>

   \
   \
   **ConMas Manager 8.2.26010 まで**\
   処理結果が表示されます。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FGrEKIaSgtb0sOjVjaoDv%2Fimage.png?alt=media&amp;token=ca068a2e-0cb8-443e-9bf9-1c394daa2f73" alt="" width="292"><figcaption></figcaption></figure></div>

   \
   エラーが発生した場合はメッセージをご確認の上、CSVファイルを修正して再度取り込んでください。

   <div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FKqFjlLnFOnQ4EolMoXzw%2Fimage.png?alt=media&amp;token=c5c59f58-c8d0-450b-94d1-88d1df41ca9d" alt="" width="325"><figcaption><p>エラーメッセージの一例</p></figcaption></figure></div>

### **アップロード処理のキャンセル**

{% hint style="warning" %}
「アップロード処理のキャンセル」は、ConMas Manager 8.2.26020 で追加された機能です。
{% endhint %}

CSVファイルアップロード中は「キャンセル」ボタンが表示され、アップロード処理をキャンセルできます。

<div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2F8sGzbUujWJWNwpNSnkHE%2Fimage.png?alt=media&amp;token=2efcb622-37bb-48d3-bf40-013c56529fa8" alt="" width="563"><figcaption></figcaption></figure></div>

アップロード処理をキャンセルした場合、既に処理が完了したレコードはそのまま登録され、それ以降のレコードのアップロード処理が中断されます。\
「インポート結果」欄には、処理を中断した旨と、登録されたレコード件数が表示されます。

<div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2Fv2r5l8FgILF7kuXm0ZRE%2Fimage.png?alt=media&amp;token=76b06d2d-404f-4043-92b2-125b9a8b35c1" alt="" width="479"><figcaption></figcaption></figure></div>

### **エラーレコードをスキップして続行**

{% hint style="warning" %}
「エラーレコードをスキップして続行」は、ConMas Manager 8.2.26020 で追加された機能です。
{% endhint %}

アップロードしたCSVファイルにエラーとなるレコードが存在した場合に、カスタムマスター登録処理を続行するか中断するかを選択します。

<div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2F2VtaVQ4VBl1xiU2WFjiJ%2Fimage.png?alt=media&amp;token=782b00f2-0f40-4449-9393-63334420f1ed" alt="" width="306"><figcaption></figcaption></figure></div>

#### **チェックなし**

アップロードしたCSVファイル内にエラーとなるレコードが1行でも存在した場合、カスタムマスター登録処理を中断します。データは何もインポートされません。\
「インポート結果」には、最初にエラーになったレコード行情報のみが表示されます。エラーになったレコードを一覧で確認することはできません。\
※i-Repo Manager 8.2.26010 までのバージョンと同様の動作です。

<div align="left"><figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FOHOhLaYZNKQGYWTHayEA%2Fimage.png?alt=media&amp;token=1c2b1d19-a1f6-43f5-af45-6ea628c1ecc6" alt="" width="294"><figcaption></figcaption></figure></div>

#### **チェックあり**

アップロードしたCSVファイル内にエラーとなるレコードが存在した場合、そのレコードをスキップして処理を続行します。\
処理結果は「インポート結果」欄に表示されます。

**「インポート結果」欄**

<figure><img src="https://4289497189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCXpgG9PGmZ8z3hGmqRae%2Fuploads%2FHcHMtTqYms4TT1AHt9Jb%2Fimage.png?alt=media&amp;token=e2bd3914-484e-4394-953b-15aae20a39cd" alt=""><figcaption></figcaption></figure>

**正常レコード**\
正常に取込みが行えたレコードの件数を表示します。

**エラーレコード**\
エラーが発生し取込みが行えなかった（スキップされた）レコードの件数を表示します。

**「CSVダウンロード」ボタン**\
エラーレコードの一覧をCSVでダウンロードできます。

**エラーレコード一覧**\
エラーレコードの一覧が表示されます。\
ただし、「エラーレコード一覧」に表示されるレコードは100件までです。\
エラーレコードが100件を超える場合は、「CSVダウンロード」ボタンよりCSVをダウンロードして確認します。

{% hint style="warning" %}
【注意】

「エラーレコードをスキップして続行」にチェックを付けた場合、下記点にご注意ください。

* ファイル読み込みエラーや例外的なエラーが発生した場合はスキップされず、カスタムマスター登録処理が中断されます。
* 一括で登録できるレコード数、ファイルサイズには以下の制限があります。\
  制限を超える場合は、ファイルを分割してアップロードしてください。
  * レコード数は：10万件まで
  * ファイルサイズ：100MB まで
    {% endhint %}

#### **「エラーレコードをスキップして続行」のデフォルト設定**

「エラーレコードをスキップして続行」項目のデフォルト チェック有無は、共通マスターで変更ができます。\
i-Repo Managerの 「システム管理」 ＞ 「共通マスター管理」にて、下記の「共通項目値」を変更します。

* 共通キー　　　”CUSTOM\_MASTER”
* 共通項目名称　”UI\_DEFAULT\_INVALID\_RECORD\_SKIP\_MODE”
* 共通項目値　　”0”：チェックなし、”1”：チェックあり

{% hint style="success" %}
デフォルト状態での チェック有無を設定していても、「カスタムマスターメンテナンス」画面で手動でチェックの付け外しが可能です。\
その場合は、本設定に関わらず、画面上でのチェック有無に従って動作します。
{% endhint %}

{% hint style="warning" %}
【注意】

i-Reporterのご使用開始時期（ご使用開始時のi-Repo Manager(ConMas Manager) バージョン）によって、本項目のデフォルト設定が異なります。

* ConMas Manager 8.2.26010までにi-Reporterを使用開始された場合、本設定項目のデフォルト値は「0」です。
* i-Repo Manager(ConMas Manager) 8.2.26020以降にi-Reporterを使用開始された場合、本設定項目のデフォルト値は「1」です。
  {% endhint %}

## **画像付のCSVを作成、アップロードする方法**

【手順】

1. CSVの画像フィールドにセットしたい画像ファイル名を拡張子つきで入力します。<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/vTEjyxnNh37UsZWmeWas/image.png" alt=""><figcaption></figcaption></figure></div>
2. 「カスタムマスター取り込みCSV」と対象の画像ファイルを同一フォルダ内に配置します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/FWU1IZrQTs87l9DA69fX/image.png" alt="" width="375"><figcaption></figcaption></figure></div>
3. 「カスタムマスター取り込みCSV」と画像ファイルを複数選択し、Zip圧縮を行います。<br>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>「カスタムマスター取り込みCSV」と「画像データ」をすべて選択状態にし、 右クリック ＞「送る」や「ZIP ファイルに圧縮する」などでZIP化してください。<br>※圧縮時に表示されるメニューは、お使いのPCや圧縮ソフトにより異なります。</p><p>「カスタムマスター取り込みCSV」と「画像データ」を任意のフォルダに格納してから、 そのフォルダごとZIP化している場合、i-Repo Managerで取り込む際に画像データのある階層が読み取れず、エラーとなる可能性があります。</p></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/s8Fya8b4TWycXaiMs7ef/image.png" alt=""><figcaption></figcaption></figure></div>
4. Zipファイルをi-Repo Managerからアップロードします。\
   ファイル形式は「CSV\_ZIP」を選択します。<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/CXpgG9PGmZ8z3hGmqRae/blobs/FWVsix38tPbEVo1kTah7/image.png" alt="" width="533"><figcaption></figcaption></figure></div>
