> 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/modifyingexcelform_output_reuptake.md). # 帳票定義ファイルの出力/i-Repo Designerへの再取り込み ## **帳票定義ファイルの出力について** i-Repo Designerで作成した帳票定義は、クラスターのパラメーターや定義情報が含まれた状態で出力することができます。\ i-Repo Designerから出力することができる形式は下記2種類です。 * **Excelファイル形式**\ 帳票定義の改訂を行う際に使用します。\ 出力したExcel帳票定義ファイル上でレイアウト変更などを行い、再度i-Repo Designerに取り込むことで、帳票定義を更新します。
* **xmlファイル形式**\ 別環境への帳票定義移行など、環境を跨ぐ帳票定義の受け渡しに使用します。

【注意】

帳票定義xmlファイルの編集は行わないでください。

帳票定義xmlファイルを直接編集した場合、動作保証の範囲外となります。
帳票定義の編集は、i-Repo Designer上もしくは帳票定義Excelファイル上で行ってください。

### **EXCEL定義出力** i-Repo Designer上部メニューの「EXCEL定義出力」より、帳票定義Excelファイルを出力することができます。\ 任意の名前を付けてPCに保存してください。

帳票定義の内容によっては、出力に少し時間がかかる場合があります。\ 出力完了後はメッセージが表示されます。

{% hint style="warning" %} Excelファイル取り込みで作成されていない帳票定義（PDFや画像から作成した帳票定義）は「EXCEL定義出力」メニューが表示されず、EXCELファイルとして出力できません。 {% endhint %} ### **出力に関する注意点** i-Repo Designerへの帳票定義Excelファイル取り込み時と同様に、出力の際も、該当PCにOffice製品がインストールされている必要があります。 {% hint style="info" %} インストールが必要なOffice製品のバージョンは、「[動作環境](https://manuals.i-reporter.jp/system-requirements) ＞ i-Repo Designer」をご参照ください。 {% endhint %} {% hint style="warning" %} EXCELファイルの互換性の問題によって、帳票定義EXCELファイルが出力できない場合があります。例えば、Excel 2010 で作成された帳票定義を Excel 2007がインストールされたPCで出力する場合、ファイル内にExcel 2007 と互換性のないオブジェクトが含まれているとエラーとなります。 {% endhint %} ### **出力したファイルに追加されるシート（**ExcelOutputSetting**）** 出力したExcelファイルには「ExcelOutputSetting」シートが新規追加されます。 \ シートには帳票定義の設定情報がxml形式で記述されています。\ （クラスター情報は各セルのコメントに書き込まれます。）帳票定義情報の保持のため、下記にご注意ください。 * 「ExcelOutputSetting」シートを削除しないでください。 * 「ExcelOutputSetting」シートのシート名称の変更をしないでください。 * 他シートに「ExcelOutputSetting」シートと同じシート名を付けないでください。 * 「ExcelOutputSetting」シートの内容を直接編集しないでください。クラスター情報のみをi-Repo Designerへ取り込みたい場合は、「ExcelOutputSetting」シートを削除してからi-Repo Designerへ取り込みます。

## **帳票定義 xmlファイルの出力** i-Repo Designer上部メニューの「帳票定義をローカル保存」より、帳票定義Excelファイルを出力することができます。帳票定義xmlファイルは主に、別環境への帳票定義移行など、環境を跨ぐ帳票定義の受け渡しに使用します。

{% hint style="warning" %} **【注意】** 帳票定義xmlファイルの編集は行わないでください。帳票定義xmlファイルを直接編集した場合、動作保証の範囲外となります。\ 帳票定義の編集は、i-Repo Designer上もしくは帳票定義Excelファイル上で行ってください。 {% endhint %} ## **帳票定義 Excel ファイルの再取り込み** ### **新規に帳票定義を作成するには** 新規に帳票定義を作成する場合は、i-Repo Designer上で帳票定義を何も開いていない状態で、「帳票定義を作成する」＞「EXCELファイルから作成する」より新規作成します。 ### **既存の帳票定義を更新するには** 既存の帳票定義を更新（リビジョンアップ）する場合は、該当の帳票定義をi-Repo Designerで開いて編集画面を表示しておきます。その状態で、「帳票定義情報設定」タブで「EXCELファイルから作成する」をクリックします。ダイアログが表示されるので「はい」を選択し、取り込みを行うExcelファイルを選択します。

Excelファイルの取り込みが開始され、編集画面が再取り込みした帳票定義の内容に変わります。 \ サーバーへの保存、公開を行うと既存の帳票定義がリビジョンアップされます。 {% hint style="info" %} リビジョンアップについて、詳細は「[履歴管理（帳票定義のリビジョンアップ）](https://manuals.i-reporter.jp/create-a-form/setup-a-form/revisionhistory-management)」をご参照ください。 {% endhint %} ## **編集した帳票定義 Excel ファイルを再取り込みする際の注意点** i-Repo Designerから出力した帳票定義Excelファイルに対してシートの挿入/入替/削除を行った場合、i-Repo Designerで設定済みの定義情報の整合性を保つために、再取込み時に下記の処理を行います。 ### **シート名称を変更した場合** * 名称が変更されたシートは新規に挿入されたシートとして扱われます。\ クラスターのパラメーター設定はセルに残りますが、ネットワーク設定やカーボンコピー設定などは破棄されます。 * 別のシートから名称を変更したシートのクラスターを含む計算式、ネットワーク設定、カーボンコピー設定がある場合、下記の「シートまたはクラスターを削除した場合」の処理も行われます。 * すべての設定を残したい場合は、i-Repo Designerでシート名称を変更してから出力してください。 {% hint style="warning" %} 帳票定義Excelファイル上でシート名を変更すると、下記設定 “以外” は破棄されます。 * 各クラスタ―の「入力パラメータ設定」画面で設定する内容(※) * クラスター備考 * 表形式設定 ※「入力パラメータ設定」画面で設定する内容のうち以下は例外となり、破棄されます。 * アクションクラスター：アクション種別「Gateway連携」のPOST設定 * アクションクラスター：アクション種別「一括クリア」のクリア対象とするクラスターの指定 * Scanditクラスターの読取データ表設定 * マスター選択クラスターのマスターキー {% endhint %} ### **シートまたはクラスターを削除した場合** * 削除されたシートまたはクラスターに、計算式、ネットワーク設定、カーボンコピー設定が含まれている場合、参照先がなくなります。 * ネットワーク、カーボンコピーの参照先が削除された場合、その情報を破棄します。 * 計算式、自動帳票名称作成設定の参照先が削除された場合、不正な参照先を「#REF」に変換します。 \ 【例】\ 計算式 = S1C10+S2C10 の時、シートNo.2のシートを削除して参照先が不正となった場合、i-Repo Designerへの再取込み時には、計算式 = S1C10+#REF という表示に変換されます。 {% hint style="warning" %} 計算式に「#REF」が含まれる場合、サーバーへのテスト公開または公開保存の際にエラーとなります。 {% endhint %} ### **既存シートが見つからない場合の確認画面** {% hint style="warning" %} 「既存シートが見つからない場合の確認画面」を表示する機能は、i-Repo Designer 8.2.26060 で追加されました。 {% endhint %} i-Repo DesignerからEXCEL定義出力を行ったタイミングで帳票定義Excelファイル上に存在していたシートが、i-Repo Designerへの再取込み時に見つからない場合、確認画面が表示されます。

#### **既存シートが見つからない場合とは** 出力した帳票定義Excelファイルに対して下記操作を行った場合に、「既存シートが見つからない」と判定されます。 * **帳票定義Excelファイル上でシート名を変更した**

i-Reporterでは、全角と半角も区別して別の文字として扱います。

【例】
シート名称全角「Ｆ００１」を半角「F001」に変更してi-Repo Designerへ再取り込みした場合、同一シートとはみなさずに、全角「Ｆ００１」は削除されたシート、半角「F001」は新規追加されたシートとして扱います。

* **帳票定義Excelファイル上でシートを削除した** #### **確認が実行される条件** 「既存シートが見つからない場合の確認画面」を表示するためのチェックは、「ExcelOutputSetting」シート（i-Repo Designerから出力したファイルに追加されるシート）が存在する帳票定義Excelファイルをi-Repo Designer へ取り込んだ際に実行されます。 ## **再取り込み時のクラスタ**ー**index再採番について** クラスターindexは、クラスターを識別するためにシート単位でクラスターに割り振られる値のことです。\ i-Repo Designerに帳票定義を取り込む際は、クラスターindexを再採番するかどうかの確認画面が表示されます。

* 採番し直した場合、計算式、ネットワーク設定、カーボンコピー設定などで利用されているクラスターindexの値を整合性を保つように変更します。 * 採番し直さない場合、既存のクラスターのindexはそのままに、クラスターindexが割り当てられていないクラスターにのみ新たな番号を割り当てます。 {% hint style="warning" %} 帳票定義の更新時にクラスターindexを採番し直した場合は、下記の問題にご注意ください。 * **既にその帳票が外部システムと連携して運用されている場合** クラスターのindexが変わることにより、システム連携に不整合が発生します。 * **i-Repo Manager「データー出力機能」のCSVを利用している場合** 出力対象の各帳票のクラスター情報はindex順に一行一帳票で複数行で出力されます。クラスターのindex が変わることにより、各帳票の出力項目の順番が変わりますので、CSVの利用に注意が必要です。 {% endhint %} {% hint style="success" %} クラスターindexの採番は、各シートの左上から右下へ向かって実行されます。\ これを、上から下や、左から右など、順番を変更して自動採番する機能はありません。 {% endhint %} ### **クラスタ**ー **index に関する注意事項** クラスターとして設定されたセルをコピーするとコメントもコピーされるため、クラスター index が重複します。【例】\ クラスター index 2 のセルを index 3 のセルにコピーした場合、クラスター index 「2」が重複します。

クラスター index はシート内で重複できません。重複を防ぐには以下の方法があります。 * i-Repo Designerへの取り込み時に再採番する。 * クラスターindex再採番確認画面で「はい」をクリックする（再採番する）場合\ 帳票定義内の全てのクラスターを対象に、クラスターindexの再採番が実行されます。 * クラスターindex再採番確認画面で「いいえ」をクリックする（再採番しない）場合\ i-Repo Designerへの取り込み前に、コピーしたセルのクラスター index を、アドインで空欄にしておきます。\ クラスタ―index再採番確認画面で「いいえ」をクリックした場合、クラスターindex欄が空欄のセルのみ、他のクラスターとindexが重複しないよう採番されます。 * コピーしたセルのクラスター index をアドインで重複しないように手動で設定しなおす。 * セルをコピーせずに（またはコメントを削除して）新たなクラスターとして設定し、i-Repo Designerで入力パラメータを設定しなおす。 {% hint style="warning" %} 再採番等で既存のクラスターindex を変更すると、外部システム連携でのindex の不一致や、CSV出力時の順序が入れ替わるためCSV取り込みなどで、予期しない動作をする可能性があります。 {% endhint %} ### **再取り込み時のクラスタ**ー **index の採番例** 【例】 i-Repo Designerでネットワーク設定を行った帳票定義Excelファイルに、クラスター index を空欄にしたクラスターを2つ追加したものを再取り込みした場合の例です。元の帳票定義では、クラスター index 2 からクラスター index 3 へネットワーク設定がされています。\ 帳票定義Excelファイル上で、クラスタ― index 2 とクラスター index 3 よりも上にクラスターを2つ挿入します。

この帳票定義Excelファイルをi-Repo Designerに取り込む際、「採番し直しを実行した場合」と「採番し直しを実行しない場合」、それぞれ次のようなクラスタ―indexになります。 #### **採番し直しを実行した場合** すべてのクラスター index を採番し直します。\ 元の index 2-3 のネットワークは、新しく採番された index 4-5 のネットワークとなります。

#### **採番し直しを実行しない場合** 新しいクラスターに、既存の index 番号の続きから採番を行います。index 2-3 のネットワークは変更がないのでそのままとなります。

### **クラスタ**ー **index が重複している場合** 再取込み時にクラスターindexの重複が発生していた場合、採番し直したとしても、ネットワーク情報などが正常に反映されない場合があります。 **【例】クラスターindexの採番し直し** 帳票定義Excelファイル上で、クラスター index 2 とクラスター index 3 よりも上にクラスタ―を2つ挿入し、そのうちの1つに、i-Repo EXCEL COM Add-inを使用してクラスター index 3 を設定します。\ これにより、既存クラスターとクラスタ― index の重複が発生します。

この帳票定義Excelファイルをi-Repo Designerに再取り込みし、クラスターindex番号の採番し直しを実行した場合、各クラスターの index は下記のようになります。

* **A**\ indexの指定がないので、自動採番でindex=2が自動設定されます。 * **B**\ 変更の必要がなかったため、帳票定義Excelファイル上で指定されたindex=3を保持します。 * **C**\ 上に2つクラスタ―が追加されたため、index=2からindex=4に変更されます。 * **D**\ 上に2つクラスタ―が追加されたため、index=3からindex=5に変更されます。 **【例】クラスターindexの採番し直し後のネットワーク設定** 帳票定義で、クラスター index 2 からクラスター index 3 へネットワーク設定がされています。\ 帳票定義Excelファイル上で、クラスター index 2 とクラスター index 3 よりも上にクラスタ―を2つ挿入し、そのうちの1つに、i-Repo EXCEL COM Add-inを使用してクラスター index 3 を設定します。\ これにより、既存クラスターとクラスタ― index の重複が発生します。

ネットワークなどの設定は、採番をし直す前のクラスターindexを元に新しいindexに書き換えられます。\ クラスターindexが重複している場合は、内部処理で先に見つかったクラスターを対象にしてネットワーク設定の情報が書き換えられます。上記の例では、期待される設定「クラスターindex 4 から 5」ではなく、「クラスターindex 4 から 3」のネットワークが作成されます。

## **EXCEL定義出力時の計算式出力** EXCELファイルから帳票定義を作成する際に、計算式クラスターのセルにEXCEL関数を使用していた場合、EXCEL定義出力したファイルの元のセルに計算式を出力します。

## **i-Repo Designer上で作成したクラスターについて** ### **i-Repo Designer上で作成したクラスターの再取り込み** Excel取込み後にi-Repo Designer上で「クラスターモード：配置」を使用して作成したクラスターは、セル位置情報を持たないため、EXCEL定義出力で出力したExcelファイル上のセルには表示されません。\ 該当のクラスターの情報は、「ExcelOutputSetting」シートに保持されており、再度i-Repo Designerへ取り込むことでクラスターとして表示されます。 {% hint style="warning" %} 下記クラスターは、EXCELファイル上での設定が前提となるクラスター種別であるため、上記仕様の対象外です。 * 計算式クラスター * 時刻計算クラスター * ピン打ちクラスター * ピンNo.配置クラスター * ピンNo.クラスターこれらのクラスター種別をi-Repo Designer上で作成した場合、その帳票定義をExcel出力すると、作成したクラスター情報は保持されず破棄されます。 {% endhint %} {% hint style="warning" %} i-Repo Designer上で作成したクラスターをEXCEL定義出力時に保持する機能は、i-Repo Designer(ConMas Designer) 6.3.19110 以降でご利用いただけます。\ これより過去のバージョンでは、i-Repo Designer上で作成したクラスター情報は保持されず破棄されますのでご注意ください。 {% endhint %} ### **i-Repo Designer上で作成したクラスターの制限** i-Repo Designer上で作成したクラスターに関しては、下記の制限があります。\ 不都合が生じる場合は、クラスターの作成をAdd-inツールを用いてEXCELファイル上で実施してください。 * **EXCEL上でシート名称を変更すると、i-Repo Designer上で作成したクラスター情報は消失します。**\ 新規シート扱いになるためです。同様にネットワーク設定などの各種設定も消失します。\ シート名称を変更したい場合は、i-Repo Designer上で「シート情報設定」からシート定義名称を変更してください。
* **EXCEL上でシートをコピーしても、i-Repo Designer上で作成したクラスター情報はコピーされません。**\ 「ExcelOutputSetting」シート内に情報を保持しているためシートのコピーでは情報がコピーされません。
* **i-Repo Designer上で作成したクラスターは、EXCEL上で表示されないため編集/削除ができません。**　i-Repo Designer上での編集・削除をお願いします。
* **i-Repo Designer上で作成したクラスターは、EXCEL上で表示されないため計算式クラスターの対象にできません。**\ 計算式の対象にしたいクラスターは、i-Repo EXCEL COM Add-inを使用してEXCEL上でクラスター種別設定を行う必要があります。
* **EXCEL上でセルの行列を追加/削除しても、i-Repo Designer上で作成したクラスターの位置は追従しません。**\ EXCEL定義出力した時点のクラスターの座標位置を保持しているため、EXCELファイル上で行・列の挿入や削除を行っても、再取込み後のクラスターの位置はそれに応じて追従しません。 \ 再取込み後にクラスター位置を調整してください。

* **背景画像の縦横比が変化した場合、i-Repo Designer上で作成したクラスターの位置とサイズも変化します。**\ 各クラスターの配置位置は背景画像に対する比率で保持しています。\ このため、背景画像となる印刷範囲設定の縦横比が変化すると、クラスターの配置と縦横比もこれに応じて変化します。再取込み後にクラスター位置とサイズを調整してください。\ また、極端な印刷範囲の縦横幅の増減はお控えください。
* **環境が異なる端末間でEXCELファイル取込みを実施した場合、環境の差異によって背景画像に差異が発生する可能性があります。**\ **その場合、背景画像に対してクラスターがずれたように見える可能性があります。**\ 帳票のレイアウトに変わりがない場合でも、環境が異なる端末間でEXCELファイル取込みを実施した場合、EXCELのバージョンやプリンタードライバー等の環境の差異により、背景画像の余白やサイズに差異が発生する可能性があります。\ しかし、i-Repo Designer上で作成したクラスター情報はそのままのため、相対的に背景画像に対してクラスターがずれたように見える可能性があります。\ これはクラスターがずれた訳ではなく背景画像側がずれるために発生します。\ \ クラスター位置とサイズを厳密に管理したい場合は、i-Repo Designer上でのクラスター作成ではなく、i-Repo EXCEL COM Add-inを使用してEXCEL上でクラスター種別設定を行ってください。