> 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/business-system/kintone/automatic-documentcreation-and-data-registration.md).

# kintone「自動帳票作成→入力帳票の登録」

kintone → i-Reporter → kintone連携

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

***

## 機能概要

kintone「自動帳票作成→入力帳票の登録」では、kintoneとi-Reporterの双方向連携を行います。

| 連携方向                 | 機能説明                                              | 実行タイミング                                        |
| -------------------- | ------------------------------------------------- | ---------------------------------------------- |
| kintone→i-Reporter連携 | kintoneのデータを元にしてi-Reporterの帳票を自動作成します。            | kntoneアプリのレコード編集画面のボタンクリック(i-Repo Link連携プラグイン) |
| i-Reporter→kintone連携 | i-Reporterで入力した帳票データをkintoneの元レコードの指定フィールドに登録します。 | i-ReporterのWebhook通知                           |

***

## 設定の流れ

{% stepper %}
{% step %}
kintoneプラグインのインストール
{% endstep %}

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

{% step %}
i-Repo Managerの連携設定
{% endstep %}

{% step %}
i-Repo Link連携kintoneプラグインの設定
{% endstep %}
{% endstepper %}

***

## 連携項目対応表

下記ページより、「1. kintone -> i-Reporter連携」、「2. i-Reporter -> kintone連携」をご参照ください。

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

***

## 設定手順

### 1. kintoneプラグインのインストール

「業務システム連携 kintone ＞ 共通設定 ＞ kintoneプラグインのインストール」をご参照ください。

{% content-ref url="/pages/nGX7Ksm2aLtxIt8S6Zdw" %}
[kintoneプラグインのインストール](/i-repo-link-manual/business-system/kintone/general-settings/installing-plug-in.md)
{% endcontent-ref %}

{% hint style="success" %}
i-Repo Linkのバージョンが1.0.251204以降の場合、ゲストスペースでもkintoneプラグインをご利用いただけます。
{% endhint %}

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

#### kintoneとの連携パターンの選択 <a href="#mappinguno" id="mappinguno"></a>

【手順】

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

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FcObEFvltPfy8zQicHoXu%2Fimage.png?alt=media&amp;token=271fd74b-4d25-4c77-afd9-7e386a93908d" 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%2Fmp6uJ4izt0IWgUEIYSnY%2Fimage.png?alt=media&amp;token=15f3e863-11d4-47ba-9676-8bd9b5af4ea8" alt="" width="563"><figcaption></figcaption></figure></div>

#### 双方向連携するkintoneアプリの選択

【手順】

1. 「データソース」と「アプリ」から、連携先のkintoneとアプリを選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FHGuC1bBV2T5yFn5XlO6B%2Fimage.png?alt=media&amp;token=718df04e-0d08-4638-97c9-77a86cf9c67f" alt="" width="295"><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%2FYQnq9R91pdIqIDEGuAk5%2Fimage.png?alt=media&amp;token=d680ca53-fbcb-4878-be14-038c5a166668" alt="" width="563"><figcaption></figcaption></figure></div>

#### kintoneアプリとi-Reporter帳票定義のクラスターをマッピング

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

【手順】

1. 「データマッピング」タブを選択します。
2. 連携するkintoneアプリの「フィールド」を選択し、i-Reporter帳票定義の紐づけ先となるクラスター行（チェックボックス含む）を選択します。

{% hint style="success" %}

* kintoneアプリのフィールドが薄いグレーのものは、連携対象外のフィールドです。
* マッピングできない場合は、エラーメッセージが表示されます。
  {% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FcjyNExwwzOnkuHF1eVZD%2Fimage.png?alt=media&amp;token=8d72e2d5-8fa3-4ffa-be3d-bb5073270d88" alt="" width="563"><figcaption></figcaption></figure></div>

3. 必要に応じ、画面中央の矢印を選択しデータ連携の方向を切り替えます。

<table><thead><tr><th width="137.53265380859375">矢印アイコン</th><th>データ連携の流れ</th></tr></thead><tbody><tr><td><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FkXO5R38lqI8XJLtNrrnx%2Fimage.png?alt=media&amp;token=430151d4-14d4-4ef3-a955-d23369baf7db" alt="" data-size="original"></td><td>kintoneの登録データで自動帳票作成し、i-Reporterに登録した入力値でkintoneを更新</td></tr><tr><td><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2Fkl2eVPupbGLHpwWGQsFF%2Fimage.png?alt=media&amp;token=e9b9d247-7211-454e-8b26-e12c5d4d1983" alt="" data-size="original"></td><td>kintoneの登録データで自動帳票作成</td></tr><tr><td><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FBNtwxFwxSHFApWn4iPMR%2Fimage.png?alt=media&amp;token=6a5d2df5-7719-4c3e-b12c-8ca1afa597c7" alt="" data-size="original"></td><td>i-Reporterに登録した入力値でkintoneを更新</td></tr></tbody></table>

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

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

#### ファイルのマッピング

入力帳票のPDF、Excelファイルをkintoneへ連携する設定をします。

【手順】

1. 「ファイルマッピング」タブを選択します。
2. kintoneアプリの「添付ファイル」フィールドを選択します。
3. i-Reporterから連携するファイル形式を、「PDF」または「EXCEL」から選択します。

{% hint style="success" %}

* ファイルの連携は、i-Reporter→kintoneのマッピング設定のみ可能です。
* 必要な場合のみ設定してください。
  {% endhint %}

{% hint style="warning" %}
添付するファイル名にスラッシュが含まれる場合、連携時にエラーが発生します。ファイル名の設定状況をご確認ください。
{% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FLiJmpG4Lb3v0Y7DHm2tr%2Fimage.png?alt=media&amp;token=2b48c142-e112-4eee-ac69-875f12c544ef" alt="" width="563"><figcaption></figcaption></figure></div>

#### キー項目の選択

kintone→i-Reporterにて連携したkintoneアプリの「レコードID」をi-Reporterの「帳票備考」に格納します。格納したkintoneの「レコードID」は、i-Reporter→kintoneの連携にて使用します。

【手順】

1. 「キー項目」タブを選択します。
2. kintoneのレコードIDを格納する、i-Reporterの「帳票備考」欄を設定します。

{% hint style="success" %}
キー項目の設定は、kintoneとi-Reporterの双方向連携に必須の設定です。
{% endhint %}

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2Fc5pPYuWUkGlJ3C91TCek%2Fimage.png?alt=media&amp;token=71c46c94-14c1-4918-8307-b958756079aa" alt="" width="563"><figcaption></figcaption></figure></div>

#### kintoneのAPIトークン生成

【手順】

1. i-Reporterと連携するkintoneのアプリを開きます。
2. 歯車のアイコン「アプリの設定」から、「設定」を選択します。
3. 「APIトークン」を選択し、「生成する」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FA9wCIFbnKXiaqOAXf3Vr%2Fimage.png?alt=media&amp;token=c2601c0d-1027-4891-a18f-7e5041d5bb9f" alt="" width="563"><figcaption></figcaption></figure></div>

4. 生成したAPIトークンの表示後に、「アクセス権」の設定で全ての項目にチェックを付けます。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FuLfzPYWgk985QWSRYFi8%2Fimage.png?alt=media&amp;token=648a20a2-0f5f-4135-8a47-61e0e97eff83" alt="" width="563"><figcaption></figcaption></figure></div>

#### トークン登録

連携先の**kintoneアプリのAPIトークン**を設定します。

【手順】

1. kintoneアプリで生成した「APIトークン」をコピーします。
2. i-Repo Linkの「トークン」タブを選択し、1. でコピーした「APIトークン」を「kintoneアプリAPIトークン」に貼り付けます。
3. 画面左上の「保存」ボタンを押し、設定済みのマッピングとして一覧に表示されれば完了です。

{% hint style="warning" %}
kintoneのAPIトークンのアクセス権が不足している場合、kintoneへの接続に失敗します。\
レコード閲覧、レコード追加、レコード編集の権限を付与するようにしてください。
{% endhint %}

{% hint style="success" %}

* kintoneのルックアップフィールドをマッピングしている場合は、ルックアップフィールドが参照しているkintoneアプリのAPIトークンもカンマ区切りで追加します。
* 複数参照している場合は、全ての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%2Fr7JoTh01fYZFNLuodFJZ%2Fimage.png?alt=media&amp;token=9c00b4b5-c083-4f8d-bd67-dffc5ea59a3c" alt="" width="563"><figcaption></figcaption></figure></div>

#### Webhook URLの設定

**kintone設定用Webhook URL**

* 「kintone設定用Webhook URL」は、「i-Repo Link連携kintoneプラグイン」に設定します。
* kintoneからi-Repo LinkへのWebhook通知に使用するURLが表示されます。\
  i-Repo Linkを経由してi-Reporterの自動帳票作成などを実現します。
* i-Repo Link連携kintoneプラグインの設定は、後述の「4. i-Repo Link連携kintoneプラグインの設定」をご参照ください。

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

* 「i-Reporter設定用Webhook URL」は、「i-ReporterのWebhook通知」に設定します。
* i-Reporterからi-Repo LinkへのWebhook通知に使用するURLが表示されます。\
  i-Repo Linkを経由してkintoneのレコード更新や追加などを実現します。
* i-ReporterのWebhook通知設定には、編集保存通知、完了通知、変更通知などが使用可能です。\
  対象の帳票定義に使用するWebhook通知を設定してください。
* i-ReporterのWebhook通知設定は、後述の「3. i-Repo Managerの連携設定」をご参照ください。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FIa5j6WiQ5tPAaFsvDbzN%2Fimage.png?alt=media&amp;token=3375fdd2-af17-4684-9301-a46792eb075a" alt="" width="563"><figcaption></figcaption></figure></div>

### 3. i-Repo Managerの連携設定

「業務システム連携 kintone ＞ 共通設定 ＞ i-Repo Managerの連携設定」をご参照ください。

{% content-ref url="/pages/xCv2ANgzGkPzIpfcoFcq" %}
[i-Repo Managerの連携設定](/i-repo-link-manual/business-system/kintone/general-settings/data-linkage-settings.md)
{% endcontent-ref %}

### 4. i-Repo Link連携kintoneプラグインの設定

「業務システム連携 kintone ＞共通設定 ＞ i-Repo Link連携kintoneプラグインの設定」をご参照ください。

{% content-ref url="/pages/DFGFYJXuqxyUBOEeb6UV" %}
[i-Repo Link連携kintoneプラグインの設定](/i-repo-link-manual/business-system/kintone/general-settings/plug-in-settings.md)
{% endcontent-ref %}