> For the complete documentation index, see [llms.txt](https://cimtops.gitbook.io/i-repo-link-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cimtops.gitbook.io/i-repo-link-manual/datasource/database/automatic-documentcreation.md).

# データベース「自動帳票作成」

データベース → i-Reporter連携

{% hint style="success" %}
この機能はi-Repo Linkオンプレミス版のみでご利用いただけます。
{% endhint %}

* 本ページで使用している画像は、PostgreSQL連携のイメージです。
* 他のデータベース連携も同じ画面構成のため、読み替えてご参照ください。

***

## 機能概要

各データベース「自動帳票作成」では、データベースからi-Reporterへのデータ連携を行います。

<table><thead><tr><th>連携方向</th><th width="214.33333333333331">機能説明</th><th>実行タイミング</th></tr></thead><tbody><tr><td>データベース→i-Reporter連携</td><td>データベースのデータを元にしてi-Reporterの帳票を自動作成します。</td><td>i-Repo Linkのマッピング設定にて生成されたAPI(Webhook)を外部システムから呼び出します。</td></tr></tbody></table>

***

## 設定の流れ

{% stepper %}
{% step %}
マッピングおよび連携設定
{% endstep %}

{% step %}
表へのマッピング（必要な場合のみ）
{% endstep %}
{% endstepper %}

{% hint style="info" %}
「自動帳票作成」を実行するためには、本ページの内容を設定後、Webhook URLの実行が必要です。

i-Repo Linkには、Webhook URLを実行する機能はございませんので、以下のページを参考に実行してください。

i-Reporter お悩み検索 ＞ [\[i-Repo Link\]データソース連携を利用して「自動帳票作成」を実行したい](https://help.i-reporter.jp/knowledge/i-repo-link%E3%83%87-%E3%82%BF%E3%82%BD-%E3%82%B9%E9%80%A3%E6%90%BA%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6-%E8%87%AA%E5%8B%95%E5%B8%B3%E7%A5%A8%E4%BD%9C%E6%88%90-%E3%82%92%E5%AE%9F%E8%A1%8C%E3%81%97%E3%81%9F%E3%81%84)
{% endhint %}

***

## 連携項目対応表

連携対象のデーターベースのページをご参照ください。

{% content-ref url="/pages/qCrAvnZUQb8tplmWYIaI" %}
[PostgreSQLとi-Reporterの連携項目対応表](/i-repo-link-manual/datasource/database/general-settings/postgresql-data-types-table.md)
{% endcontent-ref %}

{% content-ref url="/pages/tPwIFYkA43Yv8yCN5xKy" %}
[Oracleとi-Reporterの連携項目対応表](/i-repo-link-manual/datasource/database/general-settings/oracle-data-types-table.md)
{% endcontent-ref %}

{% content-ref url="/pages/S5Abl4W6XE5xIaXg0M70" %}
[SQL Serverとi-Reporterの連携項目対応表](/i-repo-link-manual/datasource/database/general-settings/sql-server-data-types-table.md)
{% endcontent-ref %}

{% content-ref url="/pages/sbJKiqeTUdGDLgm97FCV" %}
[MySQLとi-Reporterの連携項目対応表](/i-repo-link-manual/datasource/database/general-settings/mysql-data-types-table.md)
{% endcontent-ref %}

***

## 設定手順

### 1. マッピングおよび連携設定

#### データベースとの連携パターンの選択

【手順】

1. 「自動帳票作成」メニューをクリックし、「追加」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FicfkPLKdtPzAX8wNalXN%2Fimage.png?alt=media&amp;token=fafa00b7-608a-45ae-afa8-8c93a638bf45" alt="" width="563"><figcaption></figcaption></figure></div>

#### マッピングコード・名称の設定

【手順】

1. 「マッピングコード」と「マッピング名称」を設定します。

{% hint style="success" %}
マッピングコードは、i-Repo Link環境内の全てのマッピング設定を一意に識別するキーです。
{% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FO4CfPxrcqOsJhWfo5YAN%2Fimage.png?alt=media&amp;token=7eb1d75a-fb0c-4201-9183-97dd08419519" alt="" width="563"><figcaption></figcaption></figure></div>

#### 連携元のデータベースのデータソースとテーブル／ビューの選択

【手順】

1. 連携元としてデータベースの「データソース」と「テーブル／ビュー」を選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FXG0HjvKBcve9y0YW5Dm5%2Fimage.png?alt=media&amp;token=e082da7c-bfdd-49e5-97fb-452234898319" alt="" width="563"><figcaption></figcaption></figure></div>

データソースの追加・設定は、以下のページをご参照ください。

{% content-ref url="/pages/5zfQ1QLNvASFAnPSNt7s" %}
[データソース管理](/i-repo-link-manual/preparation/data-source-settings.md)
{% endcontent-ref %}

#### 連携先のi-Reporter帳票定義の選択

【手順】\
1.「帳票定義選択」を押し、連携する帳票定義を選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2Frhpn6BUwuA4j5wCdc5Gq%2Fimage.png?alt=media&amp;token=605e4018-35e2-4abb-b05a-d0cc5cd63f61" alt="" width="563"><figcaption></figcaption></figure></div>

#### データベースのフィールドとi-Reporter帳票定義のクラスターをマッピング

* 画面左側にデータベース情報、画面右側にマッピング情報とi-Reporterの帳票定義情報が表示されます。
* 帳票定義情報の下部にはプレビューが表示されます。（「帳票定義名称」左横ボタンで表示／非表示が選択可能です。）

【手順】

1. 連携するFu-jin/Raijin(SQL Server)データベースの「フィールド」を選択し、i-Reporter帳票定義の紐づけ先となるクラスター行（チェックボックス含む）を選択します。

{% hint style="success" %}

* Fu-jin/Raijin(SQL Server)データベースのフィールドが薄いグレーのものは、連携対象外のフィールドです。
* マッピングできない場合は、エラーメッセージが表示されます。
* 「データマッピング2」以降は、抽出条件に適合するデータが0件の場合も自動表作成が実行されます。\
  ただし、「データマッピング1」では抽出条件に適合するデータが1件以上存在する場合にのみ、自動帳票作成されます。
  {% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2F0kj1MrTL5dtFHk6Tq7ok%2Fimage.png?alt=media&amp;token=2939f69c-f07a-4cda-8381-e7cb61b71d16" alt="" width="563"><figcaption></figcaption></figure></div>

マッピングできるフィールドとクラスターの組み合わせは、以下より連携対象のデーターベースのページをご参照ください。

{% content-ref url="/pages/Ey12CrFiMubvySjr580b" %}
[共通設定](/i-repo-link-manual/datasource/database/general-settings.md)
{% endcontent-ref %}

#### データ検索条件の設定

* データベースのデータを抽出するための検索条件を設定します。\
  検索されたデータを元に帳票が自動作成されます。

【手順】

1. 「データ検索条件」タブを選択します。
2. 「追加」ボタンを押します。
3. 「条件フィールド」と「APIパラメーター」を設定します。
4. 検索条件を追加する場合は、「追加」ボタンを押します。

{% hint style="success" %}

* 抽出レコードが１件となるように検索条件を設定してください。複数レコードが検索されると自動帳票作成はエラーとなります。
* 検索条件は、固定値とAPIパラメーター（クエリパラメーター）を指定することができます。 APIパラメーターは10個まで指定が可能です。 パラメータ名は、param1～10で指定してください。（固定値の場合は、APIパラメーターとして指定する必要はありません。）
  {% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2Fa2ohZo12ds9m0086IutW%2Fimage.png?alt=media&amp;token=834a798f-18ab-452a-972a-137b19f134a2" alt="" width="563"><figcaption></figcaption></figure></div>

#### Webhook URLの設定

**i-Reporter設定用Webhook URL**

* 「i-Reporter設定用Webhook URL」は、外部システムが自動帳票作成を実行する際に呼び出すAPIが生成されます。
* APIパラメーター（クエリーパラメーター）を使用する場合は、このWebhook URLの末尾に指定してください。\
  APIパラメータは、末尾に ? を追加して、その後に param1=\[値] の形式で & を使って指定したパラメーター数分だけ連結してください。 \
  例）APIパラメーター1に値ABCとAPIパラメーター２に値123を指定する場合\
  \[http or https]://\[ドメイン]/i-RepoLink/api/mappings/\[マッピングコード]/autoGenerat&#x65;**?param1=ABC\&param2=123**

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FcKE3QNWZXzqNjrre8GEW%2Fimage.png?alt=media&amp;token=6fa595ec-65c4-4794-8041-d2c1d3f932ce" alt="" width="563"><figcaption></figcaption></figure></div>

### **2. 表へのマッピング**

データベースのマスターデータなど、表の所定領域から自動でデータ取得し、i-Reporterで自動帳票作成を実行します。

#### Excelアドインにおける表設定の確認

【手順】

1. i-Repo Linkに表として認識させるため、i-Repo EXCEL COM Add-inの「表設定」で目的の表を作成します。\
   具体的な手順は以下のページをご参照ください。

{% hint style="info" %}
[i-Repo EXCEL COM Add-in での表設定](https://manuals.i-reporter.jp/output-the-data/datacoordination-table/configuring-tables-in-addin)
{% endhint %}

{% hint style="success" %}
複数のシートにわたって同一の表として出力することも可能ですが、その場合はすべての表設定において下記が完全に同一であることを確認してください。

* 列名称
* 列キー
* 列型
* クラスター種別
  {% endhint %}

**「i-Repo EXCEL COM Add-in」での表設定の画面例**

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FjZWjIRkAt2VVtgAgptT2%2Fimage.png?alt=media&amp;token=d6e5d360-7910-46a4-91c6-73ad99ecfe27" alt="" width="563"><figcaption></figcaption></figure></div>

#### マッピングする表の選択

{% hint style="warning" %}

* 表へのマッピングは「データマッピング2」以降で実施できます。 （「データマッピング1」は通常のマッピングのみ可能です。）
* データマッピングごとに、それぞれ違うテーブルを選択してマッピングすることが可能です。
  {% endhint %}

【手順】

1. 「データマッピング2」（またはそれ以降）のタブを選択し、その下部にある青字の「未選択」を選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2F93L6pOh71MH9mY6xkRHN%2Fimage.png?alt=media&amp;token=5d3f711e-325a-4411-9302-d77249fe6c9f" alt="" width="563"><figcaption></figcaption></figure></div>

2. 「クラスター/表形式の選択」画面で「表形式」を選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FplzLGxd0XsD6XLowZxh4%2Fimage.png?alt=media&amp;token=1d851a43-5d7b-4bd8-a713-e968bb209dc0" alt="" width="563"><figcaption></figcaption></figure></div>

#### マッピングの設定

【手順】

1. マッピングする表を選択し、「選択」ボタンを押します。

{% hint style="success" %}
表を複数選択することも可能です。「データ格納する表順」の数字順に上から表データの流し込みが実施されます。
{% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2F4JJKIa8LcjoP2UTfbq3Z%2Fimage.png?alt=media&amp;token=3eb1d008-48e9-46e9-8125-41fc741ba143" alt="" width="563"><figcaption></figcaption></figure></div>

2. i-Reporterに連携する各データベースの「フィールド」を選択し、連携先となる「表」の項目を選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2F1T8esGFqV1IqtfyDSFAo%2Fimage.png?alt=media&amp;token=cae9f82c-aab6-4d55-960d-abb3ebc0a126" alt="" width="563"><figcaption></figcaption></figure></div>

#### 【例外】 表に対して、通常のマッピングを行う方法

{% hint style="danger" %}
表がある場合でも、表へのマッピングではなく、通常のマッピングをすることも可能です。
{% endhint %}

【手順】

1. 「データマッピング1」タブを選択し、青字の「クラスター」を選択します。
2. 「クラスターの設定」で「表形式のクラスターを一覧に表示」にチェックを入れ、「選択」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2Fd4W95iL8eGEfcgs36BoK%2Fimage.png?alt=media&amp;token=aeb7396f-70ca-40ce-8a83-d8e12cdd8149" alt="" width="563"><figcaption></figcaption></figure></div>