> 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/output-the-data/datacoordination-table/pincoordinationtable-function.md).

# ピン打ち帳票連携テーブル

{% hint style="warning" %}
本機能はオンプレミス版でのみ利用可能です。
{% endhint %}

## 機能**概要**

ピン打ち帳票を連携テーブルへ出力します。

帳票内の明細部（ピン打ち表）以外のクラスターは１帳票１レコードで出力（連携テーブル）、 明細部（ピン打ち表）はピンの粒度で出力（連携明細テーブル）します。

連携明細テーブル（ビュー）はシートコピーに対応しており、コピーされた明細行（ピン打ち表の行）も反映されます。

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FZS61cfwZdt28zCLSzprg%2Fimage.png?alt=media&amp;token=94c766b8-b530-4d7d-a9da-614bed973031" alt=""><figcaption></figcaption></figure></div>

## **連携テーブルと連携明細テーブル**

ピン打ち、ピンNo.配置は連携テーブル、連携明細テーブルへは出力されません。

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2Fr0WBZUasDQHfNbza30BJ%2Fimage.png?alt=media&amp;token=d0a5ee77-5fef-46c6-9d91-ff35b5f4cfc9" alt=""><figcaption></figcaption></figure></div>

## **連携ビュー（連携明細ビュー）**

外部システムから連携テーブルを参照する場合は、基本的に「連携ビュー」を使用して参照します。\
連携ビューを参照することで、定義修正によるリビジョンアップに対応します。

連携ビューは過去に公開された旧リビジョン定義から作成された帳票を含めて参照可能です。 \
定義編集により項目の増減があった場合も、旧リビジョンを含めたすべての項目を参照します。&#x20;

連携ビューの項目は定義のリビジョンアップにより増えることはあっても、減ることはありません。

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

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2Fl5xxWvC2eaRK33Uj27Rg%2Fimage.png?alt=media&amp;token=631e4437-baab-4335-b854-a02418ad98b1" alt=""><figcaption></figcaption></figure></div>

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

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

## **連携テーブル（ビュー）レイアウト**

連携テーブル： report\_ {定義ID}\
連携ビュー： view\_report \_{元定義ID}

* データー粒度：帳票ID&#x20;
* 主キー：帳票ID

【共通項目　と　クラスター項目のイメージ】

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FAwhggN8SLpfKTTkv8pVU%2Fimage.png?alt=media&amp;token=59f683ad-734f-4d4a-8bb1-a8eb606cb39f" alt=""><figcaption></figcaption></figure></div>

### **連携テーブル（ビュー）クラスター項目**

項目名は 「cluster\_{S}\_{C}\_{T}」 （{S}=シートNO、{C}＝クラスターINDEX、｛T}=データー型）

データー型{T}は、クラスター種別によりそれぞれ以下のように設定されます。

* 数値型＝N（NUMERIC）
* 日付型＝D（TIMESTAMP）
* 文字列＝”T”（TEXT）

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FNDFUujZpzV7QrAHZ6FYo%2Fimage.png?alt=media&amp;token=b4d80047-0dcb-41a0-946f-c9aa17fc184d" alt=""><figcaption></figcaption></figure></div>

【例】

cluster\_1\_0\_T　＝　物件名\
cluster\_1\_1\_T　＝　検査名\
cluster\_1\_2\_D　＝　検査日\
cluster\_1\_3\_T　＝　検査箇所\
cluster\_1\_4\_T　＝　検査者\
cluster\_1\_5\_T　＝　立会者

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

計算式は数値型として扱います。\
文字列の場合は連携テーブルへ出力されません
{% endhint %}

### **連携テーブルレイアウト　共通項目**

<table><thead><tr><th width="175">項目ID</th><th width="132">型</th><th width="188">項目名</th><th>備考</th></tr></thead><tbody><tr><td>rep_top_id</td><td>integer</td><td>帳票ＩＤ</td><td>[共通項目]</td></tr><tr><td>rep_top_name</td><td>text,</td><td>帳票名称</td><td>[共通項目]</td></tr><tr><td>public_status</td><td>numeric(1,0),</td><td>公開ステータス</td><td>[共通項目] <br>0:非公開、1:テスト、2:公開</td></tr><tr><td>edit_refer_status</td><td>numeric(1,0),</td><td>編集ステータス</td><td>[共通項目]<br> 0:入力前、1:編集中、2:承認待ち、3:差し戻し、4:入力完了</td></tr><tr><td>rep_top_org</td><td>integer,</td><td>元帳票ＩＤ</td><td>[共通項目]</td></tr><tr><td>rev_no</td><td>integer,</td><td>リビジョンNO</td><td>[共通項目]</td></tr><tr><td>def_top_id</td><td>integer,</td><td>定義ＩＤ</td><td>[共通項目]</td></tr><tr><td>report_type</td><td>numeric(1,0),</td><td>帳票種別</td><td>[共通項目] <br>1:シート、2:セット</td></tr><tr><td>rep_sheet_count</td><td>integer,</td><td>シート帳票ページ数</td><td>[共通項目]</td></tr><tr><td>display_sheet_number</td><td>text,</td><td>シート表示順</td><td>[共通項目]</td></tr><tr><td>server_version</td><td>text,</td><td>サーバーバージョン</td><td>[共通項目]</td></tr><tr><td>top_remarks1</td><td>text,</td><td>備考情報１</td><td>[共通項目]</td></tr><tr><td>top_remarks2</td><td>text,</td><td>備考情報２</td><td>[共通項目]</td></tr><tr><td>top_remarks3</td><td>text,</td><td>備考情報３</td><td>[共通項目]</td></tr><tr><td>top_remarks4</td><td>text,</td><td>備考情報４</td><td>[共通項目]</td></tr><tr><td>top_remarks5</td><td>text,</td><td>備考情報５</td><td>[共通項目]</td></tr><tr><td>top_remarks6</td><td>text,</td><td>備考情報６</td><td>[共通項目]</td></tr><tr><td>top_remarks7</td><td>text,</td><td>備考情報７</td><td>[共通項目]</td></tr><tr><td>top_remarks8</td><td>text,</td><td>備考情報８</td><td>[共通項目]</td></tr><tr><td>top_remarks9</td><td>text,</td><td>備考情報９</td><td>[共通項目]</td></tr><tr><td>top_remarks10</td><td>text,</td><td>備考情報１０</td><td>[共通項目]</td></tr><tr><td>deleted</td><td>numeric(1,0),</td><td>削除フラグ</td><td>0:未削除、1:削除済み<br>※連携テーブルにのみ存在する項目です。連携ビューには存在しません。</td></tr><tr><td>sys_regist_term</td><td>text,</td><td>登録端末</td><td>[共通項目]</td></tr><tr><td>sys_regist_user</td><td>text,</td><td>登録者</td><td>[共通項目]</td></tr><tr><td>sys_regist_time</td><td>timestamp</td><td>登録日時</td><td>[共通項目]</td></tr><tr><td>sys_update_term</td><td>text,</td><td>更新端末</td><td>[共通項目]</td></tr><tr><td>sys_update_user</td><td>text,</td><td>更新者</td><td>[共通項目]</td></tr><tr><td>sys_update_time</td><td>timestamp</td><td>更新日時</td><td>[共通項目]</td></tr><tr><td>[クラスター１]</td><td>…</td><td></td><td></td></tr><tr><td>…</td><td>…</td><td></td><td></td></tr></tbody></table>

{% hint style="success" %}
【共通項目について】

* 全ての連携テーブル（ビュー）は共通項目として帳票基本情報が格納されます。
* 共通項目は全ての連携テーブル（ビュー）名称とデータ型が同じです。
  {% endhint %}

## **連携明細テーブル（ビュー）レイアウト**

連携明細テーブル：report\_ {定義ID}\_1\
連携明細ビュー：view\_report \_{元定義ID}\_1

* データー粒度：ピン番号&#x20;
* ピン番号　フィールド物理名：rep\_row\_no&#x20;
* 主キー：帳票ID＋rep\_row\_no

【共通項目　と　クラスター項目のイメージ】

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FtlqHAcA6r626SUW7OY0A%2Fimage.png?alt=media&amp;token=f689c3c1-0489-4b87-91d3-aa38cf1172e5" alt=""><figcaption></figcaption></figure></div>

### **連携明細テーブルレイアウト　共通項目**

<table><thead><tr><th width="175">項目ID</th><th width="132">型</th><th width="188">項目名</th><th>備考</th></tr></thead><tbody><tr><td>rep_top_id</td><td>integer</td><td>帳票ＩＤ</td><td>主キー<br>[共通項目]</td></tr><tr><td>rep_row_no</td><td>integer</td><td>ピンNo.</td><td>主キー<br>[共通項目]</td></tr><tr><td>pin_point</td><td>text</td><td>ピン座標</td><td>[共通項目]</td></tr><tr><td>pin_x</td><td>numeric(14,5)</td><td>ピクセル座標X</td><td>[共通項目]<br>ピン打ちクラスター枠左を０と捉えたX座標</td></tr><tr><td>pin_y</td><td>numeric(14,5)</td><td>ピクセル座標Y</td><td>[共通項目]<br>ピン打ちクラスター枠左を０と捉えたY座標</td></tr><tr><td>rep_top_name</td><td>text,</td><td>帳票名称</td><td>[共通項目]</td></tr><tr><td>public_status</td><td>numeric(1,0),</td><td>公開ステータス</td><td>[共通項目] <br>0:非公開、1:テスト、2:公開</td></tr><tr><td>edit_refer_status</td><td>numeric(1,0),</td><td>編集ステータス</td><td>[共通項目]<br> 0:入力前、1:編集中、2:承認待ち、3:差し戻し、4:入力完了</td></tr><tr><td>rep_top_org</td><td>integer,</td><td>元帳票ＩＤ</td><td>[共通項目]</td></tr><tr><td>rev_no</td><td>integer,</td><td>リビジョンNO</td><td>[共通項目]</td></tr><tr><td>def_top_id</td><td>integer,</td><td>定義ＩＤ</td><td>[共通項目]</td></tr><tr><td>report_type</td><td>numeric(1,0),</td><td>帳票種別</td><td>[共通項目] <br>1:シート、2:セット</td></tr><tr><td>rep_sheet_count</td><td>integer,</td><td>シート帳票ページ数</td><td>[共通項目]</td></tr><tr><td>display_sheet_number</td><td>text,</td><td>シート表示順</td><td>[共通項目]</td></tr><tr><td>server_version</td><td>text,</td><td>サーバーバージョン</td><td>[共通項目]</td></tr><tr><td>top_remarks1</td><td>text,</td><td>備考情報１</td><td>[共通項目]</td></tr><tr><td>top_remarks2</td><td>text,</td><td>備考情報２</td><td>[共通項目]</td></tr><tr><td>top_remarks3</td><td>text,</td><td>備考情報３</td><td>[共通項目]</td></tr><tr><td>top_remarks4</td><td>text,</td><td>備考情報４</td><td>[共通項目]</td></tr><tr><td>top_remarks5</td><td>text,</td><td>備考情報５</td><td>[共通項目]</td></tr><tr><td>top_remarks6</td><td>text,</td><td>備考情報６</td><td>[共通項目]</td></tr><tr><td>top_remarks7</td><td>text,</td><td>備考情報７</td><td>[共通項目]</td></tr><tr><td>top_remarks8</td><td>text,</td><td>備考情報８</td><td>[共通項目]</td></tr><tr><td>top_remarks9</td><td>text,</td><td>備考情報９</td><td>[共通項目]</td></tr><tr><td>top_remarks10</td><td>text,</td><td>備考情報１０</td><td>[共通項目]</td></tr><tr><td>deleted</td><td>numeric(1,0),</td><td>削除フラグ</td><td>[共通項目]<br>0:未削除、1:削除済み<br>※連携テーブルにのみ存在する項目です。連携ビューには存在しません。</td></tr><tr><td>sys_regist_term</td><td>text,</td><td>登録端末</td><td>[共通項目]</td></tr><tr><td>sys_regist_user</td><td>text,</td><td>登録者</td><td>[共通項目]</td></tr><tr><td>sys_regist_time</td><td>timestamp</td><td>登録日時</td><td>[共通項目]</td></tr><tr><td>sys_update_term</td><td>text,</td><td>更新端末</td><td>[共通項目]</td></tr><tr><td>sys_update_user</td><td>text,</td><td>更新者</td><td>[共通項目]</td></tr><tr><td>sys_update_time</td><td>timestamp</td><td>更新日時</td><td>[共通項目]</td></tr><tr><td>[クラスター１]</td><td>…</td><td></td><td></td></tr><tr><td>…</td><td>…</td><td></td><td></td></tr></tbody></table>

{% hint style="success" %}
【共通項目について】

* 全ての連携テーブル（ビュー）は共通項目として帳票基本情報が格納されます。
* 共通項目は全ての連携テーブル（ビュー）名称とデータ型が同じです。
  {% endhint %}

### **連携明細テーブル（ビュー）クラスター項目**

項目名は 「cluster\_{S}\_{C}\_{T}」 （{S}=シートNO、{C}＝クラスターINDEX、｛T}=データー型）

{S} {C}はPinNo=1の各クラスターのシート番号、クラスターindex

データー型{T}は、クラスター種別によりそれぞれ以下のように設定されます。

* 数値型＝N（NUMERIC）
* 日付型＝D（TIMESTAMP）
* 文字列＝”T”（TEXT）

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FjmSx2myi8Gp2lYawR45e%2Fimage.png?alt=media&amp;token=5aa923e3-b2a5-4185-8f98-90e37aeb2eee" alt=""><figcaption></figcaption></figure></div>

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

計算式は数値型として扱います。\
文字列の場合は連携テーブルへ出力されません。
{% endhint %}

## **設定手順**

ピン帳票を連携テーブル出力するには以下手順の設定が必要です

{% stepper %}
{% step %}
**帳票定義設定**

Designerでピン定義を開き、連携テーブル出力設定を行います。
{% endstep %}

{% step %}
**サーバー側の設定**

サーバー上で設定を行います。（※i-Repo Manager上での設定ではありません）
{% endstep %}
{% endstepper %}

以上の設定を行うことでピン帳票が連携テーブル出力するようになります。

### **帳票定義設定**

ピン帳票の連携テーブル、連携明細テーブル出力を行うためには、i-Repo Designerの 「帳票定義情報設定」タブ ＞ 「■連携用テーブルの作成」 で設定を行います。

**【「■連携用テーブルの作成」項目説明】**

* **作成しない**\
  連携テーブル、連携明細テーブルを作りません（デフォルト）
* **作成する（全項目）** \
  帳票内の全項目が連携テーブル、連携明細テーブルへ出力します
* **作成する（対象項目を指定）**\
  クラスター毎に連携テーブル、連携明細テーブルに出力するかどうかを指定して出力します

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FIO4cLx93xKMWKwtjw0Jo%2Fimage.png?alt=media&amp;token=94a28a8e-8852-41b6-8775-58258dc5a61f" alt=""><figcaption></figcaption></figure></div>

**「作成する（対象項目を指定）」を選択した場合**

「作成する（対象項目を指定）」を選択した場合は、各クラスターにて連携設定を行います。\
以下のどちらでも設定できます。

* クラスター上で右クリック ＞ 「連携テーブルの出力」 ＞ 「連携テーブルに出力する」
* クラスター上でダブルクリックして「入力パラメータ設定」画面を開き、「連携用テーブル：連携用テーブルに出力」にチェック

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FT06B3EEj3We2B3kRSPeI%2Fimage.png?alt=media&amp;token=7096913b-534e-40c3-9390-714614dbd0a3" alt=""><figcaption></figcaption></figure></div>

**連携明細テーブル出力設定**

「作成する（対象項目を指定）」の明細部については、一番上のクラスターのみ出力設定することで、全行に出力設定が反映されます。

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FqOx7j3S3nvNnklPlx6mn%2Fimage.png?alt=media&amp;token=60d6649e-cf2b-4827-86b6-01a32205af58" alt=""><figcaption></figcaption></figure></div>

### **サーバー側の設定**

サーバー上にある、以下の設定ファイル（ConMasReportTable.exe.config）を修正し、サーバー上にて以下のプログラム（ Cimtops.ConMasReportTable.exe ）を実行します。

**プログラム**\
`[ドライブ]:\ConMas\SettingFiles\xml\interface\report\reportTable\app\Cimtops.ConMasReportTable.exe`

**設定ファイル**\
`[ドライブ]:\ConMas\SettingFiles\xml\interface\report\reportTable\app\Cimtops.ConMasReportTable.exe.config`

**ログ出力先**\
`[ドライブ]:\ConMas\SettingFiles\xml\interface\report\reportTable\log\log`

【Cimtops.ConMasReportTable.exe.configの設定】

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2F3gY9JhxuyVslOI4qPbzC%2Fimage.png?alt=media&amp;token=7e118d23-6584-4aa2-88ee-a7c88508d702" alt=""><figcaption></figcaption></figure></div>

**手動実行**

`[ドライブ]:\ConMas\SettingFiles\xml\interface\report\reportTable\app\Cimtops.ConMasReportTable.exe`\
をダブルクリックすることで連携テーブル（ビュー）連携明細テーブル（ビュー）が生成 または レコード追加を行います。

帳票を追加、変更したタイミングでは連携テーブルには反映されず、上記EXEが実行されることで変更分を反映します

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FNYf2LkD1t3nhS6ZqEZWY%2Fimage.png?alt=media&amp;token=d16b0152-51c7-4784-9f87-38c60ec67297" alt=""><figcaption></figcaption></figure></div>

**自動実行設定**

WindowsタスクスケジューラーにCimtops.ConMasReportTable.exeの定期実行を登録することで、定期的にピン明細ビューを自動生成することが可能です。

{% hint style="warning" %}
スケジュール登録前にサーバー側の設定を完了してください
{% endhint %}

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FCdf8KbcjrmR5fl5DhHcS%2Fimage.png?alt=media&amp;token=0416d914-4f86-42c4-a5c6-c15920508a00" alt="" width="552"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FU5uA6VM2yucJeCNvanlV%2Fimage.png?alt=media&amp;token=7583aa45-2878-462c-9d0f-ae82fbf9b232" alt="" width="435"><figcaption></figcaption></figure></div>

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

* より短い間隔で定期実行するとリアルタイムに近い間隔で変換が実行されます。
* プログラムは多重起動せず、起動際にpoolフォルダに存在した連携ファイルを全て処理します。
  {% endhint %}

{% hint style="info" %}
Windowsタスクスケジューラーの基本的な設定方法は以下をご参照ください。\
(Microsoft Learn ※外部サイト)

* [タスク スケジューラを起動する](tps://technet.microsoft.com/ja-jp/library/cc721931.aspx)
* [タスク スケジューラの操作方法](https://technet.microsoft.com/ja-jp/library/cc766428.aspx)
  {% endhint %}

## **【補足】フォルダー構成**

<div align="left"><figure><img src="https://4267383434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJOsI6lvNedHZoaBw5Ppf%2Fuploads%2FpvduSQMKrgME34G3l2mV%2Fimage.png?alt=media&amp;token=4a82fe0c-1fe1-486a-9737-9257b47c5b7e" alt=""><figcaption></figcaption></figure></div>

### **failureについて**

サーバーメンテナンス中でPostgreSQL停止させていた場合など、失敗するとfailureフォルダーに連携ファイルが格納されます。

失敗原因が判明し解決次第、再度poolフォルダーに連携ファイルを配置し直すことで再度実行されます。
