転送先 - kintone

概要

サイボウズのkintoneへデータを転送する設定のDocsです。

制約

補足事項

設定項目

STEP1 基本設定

項目名	必須	内容
kintone接続情報	Yes	あらかじめ登録してあるkintoneの接続情報から、今回の転送設定に必要な権限を持つものを選択します。
アプリID	Yes	データの転送先となる、kintoneのアプリIDを入力します。 アプリIDは、アプリ画面のURLから確認できます。 APIで取得する場合はkintone API公式ドキュメント - アプリの ID を取得するを参照ください。
ゲストスペースID	No	ゲストスペースを利用している場合は、ゲストスペースIDを入力してください。
転送モード	Yes	転送モードを指定します。 insert：転送先にレコードを転送します。 update：アップデートキーが一致するレコードを更新します。 upsert：アップデートキーが一致するレコードがあれば更新し、そうでなければ新しくレコードを転送します。
アップデートキー	Yes	転送モードにてupdateまたはupsertを選択した場合に入力します。 ユニークな値を持つフィールドのカラム名を入力してください。 レコードIDも指定できます。その場合は$idと入力してください。 なお、アップデートキーは、STEP2カラム定義の任意のカラム名と一致している必要があります。

STEP1 詳細設定

詳細設定をクリックすると、設定項目が表示されます。

STEP2 出力オプション

カラムに関して詳細な設定ができます。

データ型の指定が必要なケース

転送設定STEP2のカラム定義で指定されたカラムは、明示的にデータ型を指定しない場合、以下のルールにしたがってkintoneのフィールド形式に変換されます。

kintoneで上記以外のフィールド形式を利用している場合は、STEP2の出力オプションにて対象カラムを追加し、データ型を明示する必要があります。
選択可能なフィールド形式は以下のとおりです。

• SINGLE_LINE_TEXT
• MULTI_LINE_TEXT
• RICH_TEXT
• NUMBER
• CHECK_BOX
• RADIO_BUTTON
• MULTI_SELECT
• DROP_DOWN
• USER_SELECT
• ORGANIZATION_SELECT
• GROUP_SELECT
• DATE
• TIME
• DATETIME
• LINK
• SUBTABLE

データ型にUSER_SELECT・ORGANIZATION_SELECT・GROUP_SELECTを選択したい場合

以下のフィールド形式を選択する場合は、転送データの値を以下の通りにする必要があります。

• USER_SELECTの場合：ユーザーのログイン名
• ORGANIZATION_SELECTの場合：組織コード
• GROUP_SELECTの場合：グループコード

カンマで区切ることで、値を複数含めることもできます。（例：user1,user2）

アプリ内のテーブル（旧：サブテーブル）を更新したい場合

アプリ内のテーブル（本記載以降、サブテーブルと表記）にレコードを転送できます。
なお、以下ではフィールドを階層構造別に区別して説明します。

• アプリ直下のフィールド
• サブテーブル内のフィールド

一度の転送で、アプリ直下のフィールドへの転送、およびサブテーブル内のフィールドの更新を一括で行うことができます。

2次元テーブルを利用したサブテーブルの更新

用意する転送データ

サブテーブル内のフィールドのレコードが最小粒度となる形で、アプリ直下のフィールドの値が平坦化されて結合されたテーブルを用意します。
具体例を用いて説明します。

• アプリ直下：案件ID・会社名というフィールドが存在する
• サブテーブル：活動履歴というサブテーブルに、活動日・活動内容というフィールドが存在する

このようなケースにおいて、以下のような4列のテーブルを用意します。
なお、転送データには、サブテーブルそのものに関する要素（上記例での活動履歴）を含める必要はありません。

転送設定STEP1詳細設定のテーブル転送キー

ユニークな値で構成されたアプリ直下のフィールドに該当するカラム名を入力します。
ここで指定されたカラムの値に基づいて、サブテーブルのレコードがグルーピングされます。
なお、本箇所で入力した値は、次手順で設定するカラム定義の任意のカラム名と一致している必要があります。

転送設定STEP2のカラム定義

カラム名をそれぞれ以下の通り入力します。

• アプリ直下のフィールド：該当フィールドのフィールドコード
• サブテーブル内のフィールド：「サブテーブルのフィールドコード.サブテーブル内のフィールドのフィールドコード」
  • .を含めて入力する必要があります。

転送設定STEP2出力オプションのカラム設定

カラム設定を追加することで、フィールドごとにデータ型を明示的に指定できます。
カラム名には、転送設定STEP2のカラム定義で指定したカラム名を入力ください。
なお、サブテーブル内のフィールドの場合、.を含めて入力する必要があります。

また、サブテーブルに対し、何らかのフィールドの値を基準に昇順ソートしてデータを転送できます。
ソートして転送したい場合は、以下の通りカラム設定を追加してください。

• カラム名：転送設定STEP2のカラム定義で指定したサブテーブル内のフィールドより、カラム名の「サブテーブルのフィールドコード」の部分（.の前部分）を入力ください。
• フィールドコード：該当サブテーブルのフィールドコードを入力ください。
• データ型：SUBTABLEを選択してください。
• テーブルの行をソートするカラム：任意のサブテーブル内のフィールドのフィールドコードを入力ください。
  • 本箇所では「サブテーブルのフィールドコード.」（.の前部分）の部分を入力する必要はありません。

上記設定に基づいて転送ジョブを実行すると、以下の通りにデータが転送されます。

案件IDが1の中身を確認すると、サブテーブルも更新されていることがわかります。