# データー連携テーブル機能の概要

## **機能概要**

帳票データーを専用のテーブルに自動出力します。\
表形式の帳票は、表ごとにテーブルが作成され、BIツールのデーターソースとしても視認性の高い情報の参照が可能となります。\
出力されたテーブルはビューを介してConMasManager、外部連携APIで参照、CSV出力できます。

<div align="left"><figure><img src="/files/o5aY1yEUfYKdJd81sQrJ" alt=""><figcaption></figcaption></figure></div>

## **連携テーブルの種類**

連携テーブルは以下の２つの種類があります。

* **単票形式**\
  １帳票1レコードで登録される形式です。 <br>
* **表形式**\
  表設定に従って、表形式で登録される形式です。表ごとに複数のテーブルが生成されます。

{% hint style="warning" %}
表形式を利用する場合は、予めEXCEL COM Add-inで表設定をしておく必要があります。
{% endhint %}

{% hint style="info" %}
表設定については、 「アプリケーションの基本操作 ＞ ConMas Excel COM Add-in の基本操作 ＞ [ConMas EXCEL COM Add in Ver7.0 日本語 AI バージョン](https://manuals.i-reporter.jp/basicoperation/addin-basicoperation/conmas-exceladdin-7.0)」をご参照ください。
{% endhint %}

<div align="left"><figure><img src="/files/2IvIk66UupMNrxbb2gpM" alt=""><figcaption></figcaption></figure></div>

### **単票形式**

単票形式データ出力用の連携テーブルに、1帳票の連携対象クラスター値が1レコード上に出力されます。

* **データ出力単位：帳票ID**

{% hint style="info" %}
単票形式について、詳細は 「[単票形式](/output-the-data/datacoordination-table/single-column-format.md)」 をご参照ください。
{% endhint %}

<div align="left"><figure><img src="/files/S7YtvVdiBwlpSq2lcUex" alt=""><figcaption></figcaption></figure></div>

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

連携テーブルではヘッダはデータベーステーブルカラムの値となり、図のように日本語では表示されません。\
詳細は、「単票形式　連携テーブル、連携ビューの名称」の項をご参照ください。
{% endhint %}

### **表形式**

帳票の表ごとに、表形式データ出力用の連携テーブルに出力します。

* **データ出力単位：帳票ID、表番号、行番号**
* **ヘッダー：表設定時の列**

{% hint style="info" %}
表形式について、詳細は 「[表形式](/output-the-data/datacoordination-table/tabular.md)」 をご参照ください。
{% endhint %}

<div align="left"><figure><img src="/files/i4ZUsPtA9FL5j0F6PDEH" alt=""><figcaption></figcaption></figure></div>

**表形式でないクラスター値**

ConMas Designerで行う、連携テーブル出力設定に従って出力されます。\
出力対象の場合は、出力対象の全表に表形式でないクラスター値が出力されます。\
出力対象でない場合は出力されません。

**クラスター値が未入力の行**

帳票上で連携テーブル出力対象の表内に未入力の行が存在する場合も、連携テーブルに対象レコードが生成されます。

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

連携テーブルでは、ヘッダはデータベーステーブルカラムの値となり、図のように日本語では表示されません。\
詳細は、「表形式　連携テーブル、連携ビューの名称」項をご参照ください。
{% endhint %}

## **連携テーブルへの出力タイミング**

入力帳票を新規保存、変更保存、完了保存したタイミングで、連携テーブルに出力します。

<div align="left"><figure><img src="/files/Kk3TkzCuDS94fKqd8TSf" alt=""><figcaption></figcaption></figure></div>

## **連携テーブルの作成**

帳票定義ごとに連携テーブル機能の使用有無を設定することで、連携テーブルを自動生成します。

**帳票定義情報設定画面での設定**

【手順】

1. ConMas Designerで連携テーブルを使用する帳票定義を読み込みます。
2. 「帳票定義情報設定」タブをクリックし、設定画面を表示します。
3. 「■連携用テーブルの作成（BI等との連携用）」を“作成する（全項目）”または”作成する（対象項目を選択）”に設定します。

<figure><img src="/files/delYc3JEI6JpxC0xSpYd" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

* 帳票定義上の全てのクラスターを連携テーブルに出力したい場合は、\
  \&#xNAN;**“作成する（全項目）”** を選択します。
* 帳票定義上の一部のクラスターを連携テーブルに出力したい場合は、\
  \&#xNAN;**“作成する（対象項目を選択）**” を選択します。 \[推奨]
  {% endhint %}

### **作成する（全項目を出力）**

帳票定義内の全クラスターを連携テーブルに出力する場合に選択します。

<div align="left"><figure><img src="/files/K66nnp1UvSy2IhQjVFkJ" alt="" width="563"><figcaption></figcaption></figure></div>

* **単票形式** \
  定義内の全クラスターを連携テーブル出力します。\
  ※表設定に含まれるクラスターも全て出力します。&#x20;
* **表形式**\
  定義内の全クラスター、全表を連携テーブルに出力します。\
  ※EXCEL COM Add-inで表設定を行っている場合のみ、単票形式のテーブルとは別に表設定ごとに表形式のテーブルを作成します。&#x20;

{% hint style="danger" %}
【注意事項】

1帳票定義あたりの連携対象クラスター数の制限は**1572**です。

ただし、連携できるデーター量には制限があるため、1クラスターのデーター量が多い場合にはクラスター数の制限に満たなくてもタブレット上から帳票を保存できなくなります。

帳票内にクラスターが多い場合は、**“作成する（対象項目を指定）”**　を選択することを推奨します。
{% endhint %}

### **作成する（対象項目を指定）**

<div align="left"><figure><img src="/files/Nyp6Ssj7kDlb1J2InLWu" alt="" width="563"><figcaption></figcaption></figure></div>

* **単票形式** \
  クラスター設定「連携テーブルに出力」にチェックを入れたクラスターのみを出力します。&#x20;
* **表形式**\
  クラスター設定「連携テーブルに出力」にチェックを入れたクラスターと、 EXCEL COM Add-in表設定の「連携テーブルに出力する」にチェックした表のみを出力します。\
  ※EXCEL COM Add-inで表設定を行っている場合のみ、表設定ごとに表形式のテーブルを作成します。

**クラスタ―設定（ConMas Designerでの設定）**

<div align="left"><figure><img src="/files/Y4IeBs6cLh0pCRA3qjJU" alt=""><figcaption></figcaption></figure></div>

**表設定（Excelファイル上のEXCEL COM Add-inでの設定）**

<div align="left"><figure><img src="/files/tKLzgdN90YR9eE6dqK3b" alt=""><figcaption></figcaption></figure></div>

### **帳票定義公開時のエラーについて**

1定義ごとの連携設定可能なクラスター数は、最大**1572**項目です。

最大数を超える連携設定を行った場合、ConMas Designerでの定義公開(またはテスト公開)時に次のようなエラーが表示されます。\
エラーが表示された場合は、連携クラスター数を減らしてください。\
※ご利用のバージョンによって、エラーメッセージの文言に差異があります。

**公開(テスト公開)対象の定義内の連携クラスター数が1572を超えている場合**\
&#x20;**\[12101]**

<table><thead><tr><th width="360">エラーメッセージ</th><th>アプリバージョン条件</th></tr></thead><tbody><tr><td><p>連携テーブルの出力対象クラスター数が制限値を超えています。</p><p>[12101]</p></td><td><p>ConMas Manager：V8.1.24020 以上　かつ</p><p>ConMas Designer：V8.1.24020 以上</p></td></tr><tr><td>保存に失敗しました。<br>エラーコード[12101]</td><td><p>ConMas Manager：V8.1.24020 以上　かつ</p><p>ConMas Designer：V8.1.23100 より前</p></td></tr></tbody></table>

**公開(テスト公開)対象の定義で、過去リビジョンを含めた連携対象クラスター数が1572を超えている場合** \
**\[12102]**

| エラーメッセージ                                            | アプリバージョン条件                                                                  |
| --------------------------------------------------- | --------------------------------------------------------------------------- |
| <p>連携テーブルの出力対象クラスター数が制限値を超えています。</p><p>\[12102]</p> | <p>ConMas Manager：V8.1.24020 以上　かつ</p><p>ConMas Designer：V8.1.24020 以上</p>  |
| <p>保存に失敗しました。<br>エラーコード\[12102]</p>                 | <p>ConMas Manager：V8.1.24020 以上　かつ</p><p>ConMas Designer：V8.1.23100 より前</p> |

## **連携ビュー**

外部システムから連携テーブルを参照する場合は、基本的に「連携ビュー」を使用して参照します。

* 連携ビューを参照することで、定義修正によるリビジョンアップに対応します。&#x20;
* 連携ビューは過去に公開された旧リビジョン定義から作成された帳票を含めて参照可能です。&#x20;
* 定義編集により項目の増減があった場合も、旧リビジョンを含めたすべての項目を参照します。&#x20;
* 連携ビューの項目は定義のリビジョンアップにより増えることはあっても、減ることはありません。&#x20;
* ConMasManager、外部連携APIから参照できるのは連携ビューとなります。

【連携テーブル と 連携ビュー の関係】

<div align="left"><figure><img src="/files/ZlO8x7ha2HArs1FQ2bG6" alt=""><figcaption></figcaption></figure></div>

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

* 連携ビューは「公開」保存時のみ生成（再生成）されます。
* 「テスト」で新規保存された場合、連携テーブルは生成されますが、連携ビューは存在しません。
* 公開された定義を「テスト」保存した場合、テスト保存された定義から作成された帳票データは連携ビューに含まれません。
* 「テスト」保存された定義を「テスト」保存で更新した場合は、連携テーブルが再生成されます。（登録済みのテスト帳票データは失われます）
* 「非公開」保存した定義は連携テーブルも生成されません。
  {% endhint %}

## **シートコピーした場合の動作**

単票形式：コピーされたシートの情報は出力されません。

表形式　 ：コピーされたシートの情報は行追加で出力されます。

【表形式】\
・行番号はコピー元の最大値以降を採番\
・行名称はコピー元と同じ

<div align="left"><figure><img src="/files/bDF5RiKK7ZdIbznprv4l" alt=""><figcaption></figcaption></figure></div>

## **MotionBoardとの連携イメージ**

ウィングアーク社製ダッシュボードソリューション「MotionBoard」との連携が可能です。\
MotionBoardは、i-Reporter標準データーベースである「postgreSQL」に対応しているため、MotionBoardからi-Reporterの「連携ビュー」を直接参照することができます。\
&#x20;i-Reporterで入力した帳票データをMotionBoardの豊富な分析機能・チャート表現機能を活用し、 効果的な表現でデータの共有、ダッシュボード表示などが可能です。

<div align="left"><figure><img src="/files/5w0y1FYPi8rwJWw15k9z" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
【補足】

ウィングアーク社製BI・データー活用ソリューション「Dr.Sum」との連携も可能です。\
その他、postgreSQLへの接続可能なシステムとも同様のイメージで連携可能です。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuals.i-reporter.jp/output-the-data/datacoordination-table/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.