> 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/create-a-form/setup-a-form/creatingform-excelfile.md).

# 帳票定義Excelファイルをi-Repo Designerに取り込む

## **概要**

Excelで作成した帳票レイアウトにクラスター情報を設定してi-Repo Designerに取り込むことで、クラスターを配置済みの帳票定義が作成されます。 \
Excel上でのクラスター情報の設定には、専用のExcelアドイン（i-Repo EXCEL COM Add-in）を使用します。

Excelを取り込んだ帳票定義から作成された入力帳票は、クラスターの入力値をセルに反映したExcelファイルとして出力できます。

### **Excelファイルの各要素と帳票定義の関連**

Excelファイルの各要素と i-Reporter の帳票定義の各要素との関連は下記のとおりです。

<table><thead><tr><th width="192">Excel要素</th><th width="180">i-Reporter帳票定義</th><th>説明</th></tr></thead><tbody><tr><td>ブック（ファイル）</td><td>帳票</td><td>ファイル名が帳票名称に設定されます。<br>i-Repo Designerで変更も可能です。</td></tr><tr><td>ワークシート</td><td>シート</td><td>ワークシート名が帳票シート名称に設定されます。<br>i-Repo Designerで変更も可能です。</td></tr><tr><td>セル</td><td>クラスター</td><td>セルに取り込み用のコメントを設定します。</td></tr></tbody></table>

### **Excelファイル名と帳票定義名称**

**帳票定義Excelファイルのファイル名=帳票定義名称**

Excelファイルのブック1つが、1つi-Reporter帳票定義になります。 \
Excelファイル取込時、そのExcelファイル名が帳票定義名称として設定されます。\
i-Repo Designer上で帳票定義名称を手動で変更することも可能です。

### **Excelファイルのシート名と帳票定義のシート定義名称**

**帳票定義Excelファイルのシート名=帳票定義のシート（シート定義）名称**

Excelブックのワークシート1枚が、帳票定義の1シート（シート定義）に対応します。 \
複数ページの帳票定義を作成する場合は、シートを複数に分けたExcelファイルを作成します。 \
ワークシートの左から順に、シート定義1,2,3…が作成されます。 \
Excelブックのワークシート名が、そのまま帳票定義のシート定義名称になります。&#x20;

{% hint style="warning" %}
帳票定義として登録できるシートの上限は50シートです。
{% endhint %}

### **Excelファイルのセルと帳票定義のクラスター**

**帳票定義Excelファイルのセル=帳票定義のクラスター**

Excelブックのワークシート内にあるセルが、帳票定義のクラスターに対応します。 \
帳票のレイアウトに応じて結合セルを作成してください。 \
クラスターにしたいセルは、Excel上で、i-Repo EXCEL COM Add-inを使用してクラスター設定を行います。

### **Excelファイルのセルの書式設定反映**&#x20;

Excelで設定したセル書式の一部は、i-Repo Designer取込み時にクラスター設定へ反映されます。 \
反映される書式設定は、下記の３つです。

* 文字サイズ
* 太さ
* 配置指定

{% hint style="warning" %}

* BoldとItalicが両方設定されている場合はBoldが優先設定されます。
* 書式設定は１つのセル内で統一されている必要があります。\
  （１つのセル内で異なる文字サイズ等が指定されている場合には対応していません。）
  {% endhint %}

### **計算式とExcel関数**

計算式は、Excelファイル上で、「計算式クラスター」または「時刻計算クラスター」と設定したセルに記述します。i-Repo Designerへ帳票定義Excelファイルを取り込むと、i-Reporter用の計算式/関数に変換されます。

i-Reporter上で、Sはシートを、Cはクラスターを意味します。\
【例】\
　S1C19：シート1、index19のクラスター

<figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FbQ2MJ7W3rkDPgv1WHNk4%2Fimage.png?alt=media&amp;token=9e83c54b-5a12-4fa1-a692-f57bbe2a8ba5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
記述する計算式/関数は、i-Reporterで対応しているものである必要があります。\
i-Reporterで使用できる計算式/関数について、詳細は「[EXCEL関数機能](https://manuals.i-reporter.jp/create-a-form/prepare-the-formexcelfile/excelfunctions)」をご参照ください。
{% endhint %}

{% hint style="warning" %}

* 時刻計算クラスターの計算式は、時刻クラスター同士の引き算である必要があります。
  {% endhint %}

#### **Excel関数のi-Repo Designerへの取り込み**

Excel関数はExcelファイル上で記述し、i-Repo Designerへ取り込んだ場合のみ有効になります。 \
i-Repo Designer上でExcel関数の編集はできません。\
計算式を修正する場合は、一度i-Repo DesignerからExcelファイルを出力してExcelファイル上で編集を行い、再度i-Repo Designerに取り込みます。

<div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FRCkbm0l27QEGuRFwIKvL%2Fimage.png?alt=media&amp;token=8d001f17-2654-440d-b0b4-f6de9704611c" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
帳票定義ファイルの出力とi-Repo Designerへの再取り込みについて、詳細は「[帳票定義ファイルの出力/i-Repo Designerへの再取り込み](https://manuals.i-reporter.jp/create-a-form/setup-a-form/modifyingexcelform_output_reuptake)」をご参照ください。
{% endhint %}

{% hint style="success" %}
i-Repo Designer上で、計算式クラスターの「入力パラメータ設定」画面 ＞ 「計算式」にExcel関数を含む計算式を直接入力した場合、エラーとなります。

四則演算のみであれば直接入力が可能ですが、一度入力した計算式の再編集はできませんので、計算式の記述はExcelファイル上で行うことを推奨します。
{% endhint %}

## **i-Repo DesignerへのExcelファイル取り込み**

【手順】

1. i-Repo Designerを起動、ログインします。\
   「帳票定義を作成する」をクリックして、「帳票定義情報設定」画面を表示します。\
   「Excelファイルから作成する」をクリックし、i-Repo Designerに取り込むExcelファイルを選択します。\
   「開く」ボタンクリックするか、ファイル名をダブルクリックすると、取り込みを開始します。

   <figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FOmDRW2G9zNRnxPRXpLzJ%2Fimage.png?alt=media&amp;token=a71409be-81ad-4c1d-847a-a16c58b6e2ff" alt=""><figcaption></figcaption></figure>

2. クラスターindexを採番し直すかどうかの確認メッセージが表示されますので、「はい」または「いいえ」をクリックします。

   <div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FlAEyBBOUri9kcI70mYqo%2Fimage.png?alt=media&amp;token=ffa0f9ba-4b16-4530-a7a8-9f7b00da2772" alt="" width="455"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>クラスターindexの採番し直しメッセージについて、詳細は「<a href="#excelfairuminomessji">Excelファイル取り込み時の確認メッセージ</a>」をご参照ください。</p></div>

3. Excelファイルの解析処理とi-Repo Designerへの展開処理が実行されます。 \
   この処理にはしばらく時間がかかります。

   <div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FJcPvyKTu88RRA9ddk8P0%2Fimage.png?alt=media&amp;token=64bb6b51-e2d0-4510-8e34-6a3026b64add" alt="" width="375"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>取り込み処理が完了するまで、Excelを起動しないでください。<br>正しく処理が実行されない場合があります。</p></div>

4. 処理が完了すると、i-Repo Designer上に帳票定義が展開されます。

### **Excelファイル取り込み時の確認メッセージ**&#x20;

Excelファイルをi-Repo Designerへ取り込む際、「クラスターindexを採番し直しますか？」 の確認メッセージが表示されます。 \
「はい」を選択すると、帳票定義上の全てのクラスターindex番号を左上から右下へ向かって自動採番します。\
「いいえ」を選択した場合、既に割り振られているクラスターindex番号は変更されません。クラスターindexが採番されていないクラスターのみ、クラスターindex番号を自動採番します。

<div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2Fvkxghvi0QJROksPltfzR%2Fimage.png?alt=media&amp;token=41c1be0d-6079-4821-b88d-158d507b7147" alt="" width="455"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**【注意】**\
帳票定義の更新時にクラスターindexを採番し直した場合は、下記の問題にご注意ください。

* **既にその帳票が外部システムと連携して運用されている場合**\
  クラスターのindexが変わることにより、システム連携に不整合が発生します。
* **i-Repo Manager「データー出力機能」のCSVを利用している場合**\
  出力対象の各帳票のクラスター情報はindex順に一行一帳票で複数行で出力されます。\
  クラスターのindex が変わることにより、各帳票の出力項目の順番が変わりますので、CSVの利用に注意が必要です。
  {% endhint %}

#### **EXCEL取込み時のクラスターindex振り直し確認画面表示**&#x20;

「帳票定義情報設定」タブ ＞「EXCEL取込み時のクラスターindex振り直し確認画面表示」にて、「クラスターindexを採番し直しますか？」 の確認メッセージ画面の表示/非表示を設定できます。

<div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2FZdKUNGsjOORQYPe77ril%2Fimage.png?alt=media&amp;token=b41e0e40-7ffd-4f84-be7a-b19bca2f2869" alt=""><figcaption></figcaption></figure></div>

**する：**&#x30AF;ラスターindex振直し確認画面を表示する&#x20;

**しない：**&#x30AF;ラスターindex振直し確認画面を表示しない 　

{% hint style="warning" %}
確認画面を表示しない場合、クラスターindexは振り直しされません。
{% endhint %}

### **EXCELのCOM参照を使用してEXCELファイルを取込む**

<figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2F36VcbTybxWi9RhFUVzdG%2Fimage.png?alt=media&amp;token=870ae40e-c63a-4f60-b8fe-a713ae689333" alt=""><figcaption></figcaption></figure>

ExcelのCOM参照を使用してExcelファイルを取り込むかどうかの設定です。\
「EXCELのCOM参照を使用してEXCELファイルを取込む」のチェックをオフにした状態で「EXCELファイルから作成する」 を実行した場合は、COM参照を使用せずにExcelファイルを取り込みます。

COM参照を使用することで、正常に取り込めなかった背景文字列やオブジェクトが取り込めるようになる可能性があります。 \
本チェックをオフにした状態で正常にExcelファイル取込みができない場合は、本チェックをオンにした状態でExcelファイル取り込みをお試しください。

また、本チェックのオン/オフにより、下記の過去のDesignerバージョンと同じEXCELファイル取り込み仕様になります。

* チェックをオフにした状態：\
  バージョン 6.2.19070以前と同じ仕様でEXCELファイル取り込み
* チェックをオンにした状態：\
  バージョン 6.2.19080以降と同じ仕様でEXCELファイル取り込み

{% hint style="success" %}
本チェックのオン/オフによって、機能や不具合状況が当時のバージョンにダウングレードすることはありません。\
また、あくまでも取込み方式の違いのみであり、取り込まれた帳票定義の設定などにも影響はありません。
{% endhint %}

## **Excelファイル取り込み後の設定**

Excelファイルの取り込みが完了すると、Excelファイルの各シートのレイアウトイメージ、及びクラスター設定が反映された帳票定義がi-Repo Designer上に帳票定義が展開されます。

レイアウトイメージ（Excel上で設定したセル背景色や罫線、シート内に配置した画像など）は1枚のPDFに変換され、シートの背景画像として使用されます。

Excelファイル上でクラスター設定を行ったセルはクラスターに変換され、薄黄色で表示されます。\
クラスターをダブルクリックすると、該当クラスターの「入力パラメータ設定」画面が表示されます。クラスターごとの各種設定は、この「入力パラメータ設定」画面で行います。\
i-Repo Designerへの初回取り込み時はデフォルト値が設定されますので、必要に応じて設定を修正してください。\
クラスター名称、クラスター種別を変更することも可能です。&#x20;

数値選択、トグル選択、トグル集計、単一選択、複数選択などの選択系のクラスターには、それらの選択肢の設定が必要です。

<div align="left"><figure><img src="https://3237210363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd8X0mqwp3tAAJZM8UeyH%2Fuploads%2F08AyH9dWf9u4pDZfEICQ%2Fimage.png?alt=media&amp;token=059aba3c-a7c8-4a8f-97c0-5d311d89813c" alt="" width="520"><figcaption><p>【例】キーボードテキストクラスターの「入力パラメータ設定」画面</p></figcaption></figure></div>

### **Excelファイル取り込み後にi-Repo Designer上で制限される機能**

Excelファイル取り込みで作成された帳票定義は、元のExcelファイルとの整合性を保つため、i-Repo Designer上で下記編集を行うことができません。&#x20;

* シートの挿入と削除はできません
* 帳票定義の背景画像を変更することはできません
* i-Repo Designer上で削除したクラスターは、Excelファイル出力時に反映されません
* i-Repo Designer上で追加したクラスターは、出力したExcelファイル上に表示されません。\
  ただし、データとしては保持しており、該当のExcelファイルを再度i-Repo Designerへ取り込むとi-Repo Designer上で表示されます。\
  （計算式、時刻計算、ピン打ち、ピンNo.配置、ピンNo.クラスターは対象外です）

これらの編集が必要な場合は、「EXCEL定義出力」でExcelファイルを出力し、Excelファイル上で修正を行ってください。\
修正後は、i-Repo Designerで該当の帳票定義を開いた状態で「EXCELファイルから作成する」ボタンでExcelファイルを取り込むことで、帳票定義を更新（リビジョンアップ）することができます。

{% hint style="info" %}
リビジョンアップについて、詳細は「[履歴管理（帳票定義のリビジョンアップ）](https://manuals.i-reporter.jp/create-a-form/setup-a-form/revisionhistory-management.md) 」をご参照ください。
{% endhint %}
