> 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/data-registration-in-kintone.md).

# kintone「入力結果の登録」

i-Reporter → kintone連携

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

***

## 機能概要

kintone「入力結果の登録」では、i-Reporterからkintoneへデータ連携を行います。

{% hint style="success" %}
本機能は、双方向連携(メニュー 自動帳票作成→入力帳票の登録)と動作が異なります。 

kintoneアプリのレコード更新ではなく、kintoneアプリに新規レコードを登録します。
{% endhint %}

| 連携方向                 | 機能説明                                         | 実行タイミング              |
| -------------------- | -------------------------------------------- | -------------------- |
| i-Reporter→kintone連携 | i-Reporterで入力した帳票データをkintoneの新規レコードとして登録します。 | i-ReporterのWebhook通知 |

***

## 設定の流れ

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

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

***

## 連携項目対応表

下記ページより、「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との連携パターンの選択

【手順】

1. 「入力結果の登録」メニューをクリックし、「追加」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FCUA055b2cSciOGsclhO5%2Fimage.png?alt=media&amp;token=d46fa15b-294d-43cf-a0d0-a44ba6cb3787" 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%2FktWfgIVVsIKPGucbdlPK%2Fimage.png?alt=media&amp;token=e17fa801-8513-4362-bb0c-1b90c60cac97" alt="" width="563"><figcaption></figcaption></figure></div>

#### 連携元の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%2Fh7oSUYI3dJFyqZ708T95%2Fimage.png?alt=media&amp;token=324189f4-b03e-4805-8c3d-7bfc8b9cf48e" alt="" width="563"><figcaption></figcaption></figure></div>

#### 連携先のkintoneアプリの選択

【手順】

1.「データソース選択」をクリックし、表示された一覧の中から連携対象のkintoneにチェックを入れ、「OK」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FoROfuHx6N3UPQrKKb1iX%2Fimage.png?alt=media&amp;token=f0673d2a-6830-496b-8976-26696a27867a" alt="" width="563"><figcaption></figcaption></figure></div>

2. 「アプリ未選択」をクリックし、連携対象のkintoneアプリにチェックを入れ、「選択」ボタンを押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FOmJ24wi39IJpYBRmzjqO%2Fimage.png?alt=media&amp;token=ab1a4594-ca4a-4726-a340-069776c4a8a3" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FB5kFyFKQsdzMa1MZ88Nk%2Fimage.png?alt=media&amp;token=44c34ecf-90fa-4ffd-b28c-ea872829116d" alt="" width="375"><figcaption></figcaption></figure></div>

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

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

#### i-Reporter帳票とkintoneアプリをマッピング

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

【手順】

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

{% hint style="success" %}

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

<figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FqJGXtuzs0qRmX5vKG0oN%2Fimage.png?alt=media&amp;token=b5ad9b77-0949-4d26-a02a-1750469b070c" alt=""><figcaption></figcaption></figure>

#### 連携先のkintone情報グリッドの項目説明

<table><thead><tr><th width="170.64532470703125">項目</th><th>説明</th></tr></thead><tbody><tr><td>最小REV</td><td><p>マッピングした帳票定義（リビジョン）と異なるリビジョンの帳票定義を入力結果の登録処理の対象するか指定できます。 </p><p>未設定の場合は、マッピングで選択している帳票定義（リビジョン）から作成された入力帳票のみ連携対象とします。 </p><p>最小REVを設定した場合は、指定したリビジョン以上の帳票定義から作成された入力帳票を連携対象とします。</p><p> ※通常は、帳票定義を修正しリビジョンが上がった場合はマッピングで最新リビジョン取得をしますが、最新リビジョン取得をし忘れた場合に入力帳票が連携対象外となることを防ぎます。</p><p> 最新リビジョン取得は、帳票定義のプレビュー表示時にボタンが表示されます。</p></td></tr><tr><td>マッピング</td><td>マッピングされたi-Reporter帳票定義のクラスターを表示します。</td></tr><tr><td>フィールド</td><td>連携先のkintoneのフィールドを表示します。</td></tr><tr><td>固定値</td><td>i-Reporter帳票定義情報の備考で選択可能な固定値をマッピングした場合に使用します。設定する固定値を入力します。</td></tr><tr><td>必須フィールド</td><td>i-Reporter帳票定義情報の表をマッピングした場合に使用します。 必須と指定したフィールドを有効な連携対象のレコードとして判定します。</td></tr><tr><td>フィールドタイプ</td><td><p>明示的に連携先のフィールドのタイプを指定します。 指定したタイプにフォーマット変換します。</p><p> ※現在、日付タイプが指定可能です。 値が日付として認識できる場合にYYYYMMDD形式に変換して設定します。（変換できない場合は0を設定します。）</p></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 %}

#### テーブルのマッピング

i-Reporterの表形式データをkintoneのテーブルへ連携する設定を行います。

{% hint style="success" %}

* マッピング可能なkintoneのテーブル数は最大3つです。
* 連携先のkintoneテーブルを増やす（または減らす）場合は、「テーブルマッピング」タブ右横の「＋」または「－」を押します。
  {% endhint %}

【手順】

1. kintoneに連携するi-Reporter帳票定義の「表」を選択します。
2. 「テーブルマッピング」タブを選択します。
3. 「テーブル未選択」を押し、連携先のkintoneテーブルを選択し、1とマッピングします。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FIemOnUwWxgOxMDeQt6aa%2Fimage.png?alt=media&amp;token=573230d7-2b13-498c-b134-2092078c0686" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**i-Reporter表形式データの連携方法**

* i-Reporter表形式データをkintoneのテーブルに登録する場合、初期設定では「複数レコード連携API (k/v1/records.json) 」での連携が適用されます。
* 連携先の kintoneでWebhookを利用したい場合は、「単一レコード連携API (k/v1/record.json) 」の使用が必要です。\
  初期設定から「単一レコード連携API (k/v1/record.json) 」での連携に切り替える場合は、kintoneのご契約プランを確認の上、下記の手順をご参照ください。
  {% endhint %}

【手順】

1. 「Webhook URL」タブを選択します。
2. 「表マッピング時における単一レコード連携API (k/v1/record.json) の使用」のチェックボックスを選択します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FY20Q7sesTipox0Bwxyt7%2Fimage.png?alt=media&amp;token=f4ffe8cb-fc79-4b81-9d7a-15ce6b5cd04b" alt="" width="563"><figcaption></figcaption></figure></div>

3. 確認画面の「注意」を確認の上、「確認して選択」を押します。

<div align="left"><figure><img src="https://3546243214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa6x5FdBzsQ0pMtLL2hEs%2Fuploads%2FEAPYgnxj5ekH9nj9LDif%2Fimage.png?alt=media&amp;token=e13a5d72-5e95-4852-82b7-f6a0e21ee40f" alt="" width="563"><figcaption></figcaption></figure></div>

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

入力帳票の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%2FUK16JsQKGnhQG4c53a8w%2Fimage.png?alt=media&amp;token=9b708049-7145-469f-ba1d-80558cdc7a67" 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%2F3ejPEilDqyEw3QNwcrxC%2Fimage.png?alt=media&amp;token=07b0b017-0063-43f9-aa30-258609732747" 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%2FvJCgce4D3Ltguti9Aaxs%2Fimage.png?alt=media&amp;token=77867e0d-0db8-4379-9690-aeed9da4569e" alt="" width="563"><figcaption></figcaption></figure></div>

#### トークン登録

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

【手順】

1. kintoneアプリで生成した「APIトークン」をコピーします。
2. i-Repo Linkの「トークン」タブを選択し、1. でコピーした「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%2FP3evHpog4jBDe32HEh8w%2Fimage.png?alt=media&amp;token=d5386da1-68c0-4d9d-b359-a11d8ebc994d" alt="" width="563"><figcaption></figcaption></figure></div>

#### Webhook URLの設定

**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通知設定は、後述の「2. 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%2Fou2NTVsl1AXkqgCTxwvW%2Fimage.png?alt=media&amp;token=787188fb-eef5-45d7-b01d-9213a2fead7e" alt="" width="563"><figcaption></figcaption></figure></div>

### 2. 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 %}