> 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/tpics/menu/jidoutyouhyou.md).

# 自動帳票作成

## 機能概要

* **自動帳票作成**は、TPiCS(SQL Server)からi-Reporterへの連携を行います。

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

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

以下の手順に従ってマッピング設定を行ってください。

### 1. TPiCS(SQL Server)との連携パターンの選択

* **自動帳票作成**メニューをクリックして新規のマッピングを追加します。

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

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

* **マッピングコード**と**マッピング名称**を設定します。
* マッピングコードは、**i-Repo Link環境内の全てのマッピング設定を一意に識別するキー**になります。

<figure><img src="/files/5yhyCedQayv3DT70tiyA" alt=""><figcaption></figcaption></figure>

### 3. 連携元のTPiCS(SQL Server)のデータソースとテーブル／ビューの選択

* 連携元としてTPiCS(SQL Server)の**データソース**と**テーブルまたはビュー**を選択します。

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

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

{% content-ref url="/pages/Mr8iIh9WBLvgsGDHpX6I" %}
[データソース管理](/i-repo-link-manual/system/2/1.md)
{% endcontent-ref %}

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

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

### 5. TPiCS(SQL Server)データベースのフィールドとi-Reporter帳票定義のクラスターをマッピング

* 画面[^1]左側にTPiCS(SQL Server)データベース情報、画面右側にi-Reporterの帳票定義情報が表示されます。
* TPiCS(SQL Server)データベースのフィールドが薄いグレーのものは、連携対象外のフィールドです。
* マッピングできない場合は、エラーメッセージが表示されます。

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

* マッピングできるフィールドとクラスターの組み合わせは、以下のページを参照してください。

{% content-ref url="/pages/aYh8RTflCgbs2hyuLMrl" %}
[TPiCSとi-Reporterの連携項目対応表](/i-repo-link-manual/tpics/common/tpics_ireporter.md)
{% endcontent-ref %}

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

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

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

### 7. キー項目の設定

* 連携したTPiCSのデータを一意に識別するためのキー項目を設定します。
* キー項目は、帳票のシステムキーに設定されます。
* キー項目は、データ更新時などに利用します。※今後実装される機能で使用

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

### 8. 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/\[マッピングコード]/registerRepor&#x74;**?param1=ABC\&param2=123**

{% hint style="success" %}
TPiCSから自動帳票作成を行うための設定は以下のリンクをご確認ください。\
[
](<https://www.tpics.co.jp/home/連携システム/i-repoter/#cc-m-header-7959630811&#xD;&#xA;>)[TPiCSの設定
](<https://www.tpics.co.jp/home/連携システム/i-repoter/#cc-m-header-7959630811&#xD;&#xA;>)
{% endhint %}

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

## **表へのマッピングの手順**

データベースにおけるマスターデータなど、表の"決まった場所"に自動で入って自動帳票作成ができます。

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

i-Repo Linkに表として認識させるために、[Excelのアドイン「表設定」で目的の表を作成](https://manuals.i-reporter.jp/output-the-data/datacoordination-table/configuring-tables-in-addin)します。

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

* 列名称
* 列キー
* 列型
* クラスター種別

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

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

{% hint style="warning" %}
表へのマッピングは「データマッピング2」以降で実施できます（データマッピング1は通常のマッピングのみ可能）
{% endhint %}

{% hint style="info" %}
**データマッピングごとに、それぞれ違うテーブルを選択してマッピングすることが可能です**
{% endhint %}

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

<figure><img src="/files/1W1rIn0V7pF3Ma2YAVlW" alt=""><figcaption></figcaption></figure>

「クラスター/表形式の選択」という画面が立ち上がり、「表形式」を選択ください。

<figure><img src="/files/3gzK2B23FLVkLVNGrJWi" alt=""><figcaption></figcaption></figure>

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

マッピングしたい表を選択ください。

なお、複数選択することも可能で、「データ格納する表順」の数字順に上から表データの流し込みが実施されます。

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

データソースにおけるどのテーブル/フィールドを、表のどの列に流し込むのかを考えて、対応する行にマッピングしてください。

<figure><img src="/files/5c24pepHWRv3n6Z3FgSM" alt=""><figcaption></figcaption></figure>

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

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

表を使わない場合は、データマッピング1で青字の「クラスター」を選択して、「表形式のクラスターを一覧に表示」を押すと、通常のクラスターとして表示されるようになり、表ではない通常のマッピングが可能です。

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

[^1]: