アプリ結合

¶アプリ結合

二つの入力レコードを共通する結合キーの値をもとに結合します。

¶特徴

• 2つのデータの結合
  顧客マスタと購買履歴のように、2つのデータフローを共通のキー（顧客IDなど）で紐づけて、1つのデータにまとめられます。
• 目的に応じた結合方法
  「内部結合」や「左外部結合」など、分析の目的に応じたデータの残し方を選択できます。
  • 内部結合: 両方のデータフローにキーが一致するデータのみを抽出します。
  • 左外部結合: 左側のデータフローのデータをすべて残し、キーが一致する右側のデータを結合します。
  • 右外部結合: 右側のデータフローのデータをすべて残し、キーが一致する左側のデータを結合します。
  • 完全外部結合: 両方のデータフローのすべてのデータを含み、キーが一致するデータを結合します。
• 柔軟なキー設定
  結合の軸となるキー項目を複数指定できます。これにより、より複雑な条件でのデータ結合が可能です。

¶機能

¶設定項目詳細

¶使い方

¶設定手順

データフロー編集画面で、結合したい2つの入力元ノードを「アプリ結合」ノードに接続し、以下の手順で設定を行います。

1. 入力データフローの選択:
   「元となる入力」と「結合する入力」をそれぞれ選択します。

   
   「元となる入力」と「結合する入力」には、同じデータフローは選択できません。

   

2. 結合方法の選択:
   右側の設定パネルで、4つの結合方法から1つを選択します。

   

3. 結合キーの設定:
   「新規項目の追加」セクションで「元のフィールド」と「結合するフィールド」を選択し [ + ] ボタンで結合キーとして登録します。

   
   フィールドの組み合わせは複数登録することも可能です。

   新規項目の追加

   

   設定済みリスト

   

4. ノード名の設定と保存（任意）: 必要に応じて、ノードのタイトルや説明を編集し、設定を保存します。

¶動作イメージ

以下に、2つのデータフロー（顧客マスタ、購買履歴）を 顧客マスタ.顧客ID = 購買履歴.顧客ID を結合条件として結合する例を示します。

入力データ1（顧客マスタ）

入力データ2（購買履歴）

¶内部結合

両方のデータフローに「顧客ID」が存在するレコードのみが結合されて出力されます。

¶左外部結合

結合の元（左側）である「顧客マスタ」の全レコードが保持されます。

¶右外部結合

結合する（右側）である「購買履歴」の全レコードが保持されます。

¶完全外部結合

両方のデータフローのすべてのレコードが保持されます。

¶注意事項

• 結合キーに指定できないフィールド:
  構造化されたデータや特殊なデータ形式を持つ以下のフィールドタイプは、結合キーとして指定できません。

  • ファイル
  • 関連レコード一覧
  • テーブル

• 結合キーのフィールドタイプ互換性:
  結合条件に指定するキー項目は、左右でフィールドタイプに互換性がある必要があります。
  本プロセッサーでは、kintoneの各フィールドタイプを以下の7つの「カテゴリー」に分類して互換性を判定します。同じカテゴリーに属するフィールド同士、または片方が「文字列（汎用）」である場合にのみ結合キーとして設定できます。

  • カテゴリー分類と kintone フィールド型の対応:

    • 文字列（汎用）: 文字列（1行）（SINGLE_LINE_TEXT）、文字列（複数行）（MULTI_LINE_TEXT）、リッチエディター（RICH_TEXT）、ラジオボタン（RADIO_BUTTON）、ドロップダウン（DROP_DOWN）、複数選択（MULTI_SELECT）^※1、チェックボックス（CHECK_BOX）^※1、リンク（LINK）、および結合キーに指定可能な他のカテゴリーに分類されないフィールド型
    • 数値/ID: 数値（NUMBER）、レコード番号（RECORD_NUMBER）^※2
    • 日付^※3: 日付（DATE）
    • 日時^※3: 日時（DATETIME）、作成日時（CREATED_TIME）、更新日時（UPDATED_TIME）
    • 時刻^※3: 時刻（TIME）
    • 期間: （表示書式を時間量（時分・日時分）に設定した計算（CALC）フィールドのみが該当します）
    • アカウント（ユーザー・組織・グループ）^※4: ユーザー選択（USER_SELECT）、組織選択（ORGANIZATION_SELECT）、グループ選択（GROUP_SELECT）、作業者（STATUS_ASSIGNEE）、作成者（CREATOR）、更新者（MODIFIER）

  • 計算フィールドの扱い:
    計算フィールド（CALC）は、kintoneの「表示書式（format）」設定に応じて、対応するカテゴリーに分類されます。

    • NUMBER, NUMBER_DIGIT（数値・数値桁区切り） $\rightarrow$ 数値/ID
    • DATE（日付） $\rightarrow$ 日付
    • DATETIME（日時） $\rightarrow$ 日時
    • TIME（時刻） $\rightarrow$ 時刻
    • HOUR_MINUTE（時間（時分））, DAY_HOUR_MINUTE（時間（日時分）） $\rightarrow$ 期間
    • 未設定、または上記以外 $\rightarrow$ 文字列（汎用）

  • 組み合わせ可否の早見表:

    カテゴリー	文字列(汎用)	数値/ID	日付	日時	時刻	期間	アカウント
    文字列(汎用)	〇	〇	〇	〇	〇	〇	〇
    数値/ID	〇	〇	✕	✕	✕	✕	✕
    日付	〇	✕	〇	✕	✕	✕	✕
    日時	〇	✕	✕	〇	✕	✕	✕
    時刻	〇	✕	✕	✕	〇	✕	✕
    期間	〇	✕	✕	✕	✕	〇	✕
    アカウント	〇	✕	✕	✕	✕	✕	〇

• 実データのフォーマット不一致:
  UI上で結合キーの組み合わせが許可されていても、内部で処理される実際のデータ形式が一致しない場合、結合されません。 以下の組み合わせで結合を行う場合は特にご注意ください。

  1. 複数選択・チェックボックスと文字列（汎用）フィールドの結合:

     • 複数選択やチェックボックスの値は、内部で選択肢が五十音やアルファベットなどの辞書順（昇順）にソートされ、改行（\n）で連結された文字列に変換されます。
     • 結合相手の文字列フィールドの値が、この改行連結された文字列と完全に一致していないと結合されません。

  2. レコード番号と数値フィールドの結合 (数値/ID 同士):

     • レコード番号に「アプリコード」（例: APP-）を設定している場合、実データは "APP-1" のようになります。
     • 一方、数値フィールドの実データは "1" となるため、値が一致せず結合されません。アプリコードを使用している場合は、もう一方を文字列フィールドにしてアプリコードを付与した値にするなどの工夫が必要です。

  3. 日付・日時・時刻と文字列（汎用）フィールドの結合:

     • 各日付系フィールドは、以下の標準的な文字列フォーマットに変換されます。
       • 日付: YYYY-MM-DD （例: "2026-08-12"）
       • 日時: YYYY-MM-DDTHH:mm:ssZ （UTC表記。日本時間16:45は "2026-08-12T07:45:00Z" となります）
       • 時刻: HH:mm （例: "16:45"）
     • 文字列フィールド側を結合キーにする場合、このフォーマット（特に日時のUTC表記）と完全に一致させる必要があります。

  4. アカウント（ユーザー・組織・グループ）フィールドと文字列（汎用）フィールドの結合:

     • アカウント（ユーザー・組織・グループ）に分類されるフィールド（作成者、更新者、ユーザー選択、組織選択、グループ選択、作業者）の値は、内部で "表示名 (コード)" という形式の文字列に変換されます（例: "管理者 (admin)"）。
     • 複数選択可能なフィールド（ユーザー選択など）で複数が選択されている場合は、五十音やアルファベットなどの辞書順（昇順）にソートされ、カンマと半角スペースで連結されます（例: "ユーザーA (userA), ユーザーB (userB)"）。
     • したがって、結合相手の文字列フィールドに単なるログインコード（"admin"）や表示名（"管理者"）が入っているだけでは結合されません。

• データ量:
  大量のレコードを持つデータフロー同士を結合する場合、処理に時間がかかることがあります。事前に「レコード抽出」プロセッサーなどで不要なデータを絞り込んでおくことを推奨します。