Developers

カーボン型について

概要

カーボン型は、活動の紐づき先アプリの情報を、「登録時点の状態」で履歴として保存するためのデータ形式です。 「カーボンコピー（写し）」のように、活動時点の情報を固定的に保持します。

Info

紐づき先のアプリで内容が後から更新されても、カーボン型には影響しません。登録時の情報が、そのまま履歴として残ります。

紐づき先アプリとプロパティ構造

カーボン型では、各紐づき先のアプリに対応する情報を、下記のようなプロパティ名で保持します。

項目名プロパティ名
活動対象顧客activities.activity.target_customer
活動対象案件activities.activity.target_businessplan
活動対象取引商品activities.activity.target_deal
報告者activities.activity.target_employee
当日面談者activities.activity.interviewer@activities.interviewer.target_businesscard

特徴

  • 画面からの入力と同様に、紐づき先アプリの内容を履歴情報として保存します。
  • 活動が最新の場合は、各種アプリにも活動登録内容が反映されます。
  • カーボン型に配置できる項目は、項目設定の定義に準拠します。
  • 活動登録時に未指定だった項目は、登録直後に取得可能な最新データで補完されます。

項目名の命名ルール

カーボン型では、対象となる紐づき項目の名前の先頭に各カーボンに応じたプロパティ名を付与する必要があります。
例えば、活動対象顧客に配置される顧客アプリの項目は一律activities.activity.target_customer@が接頭辞となります。

例：

  "activities.activity.target_customer": {
    "activities.activity.target_customer@customers.customer.id": 47593743414019,
    "activities.activity.target_customer@customers.customer.customer_name": "ソフトブレーン株式会社",
    "activities.activity.target_customer@customers.customer.customer_type": "法人",
    "activities.activity.target_customer@customers.customer.relational_parent_customer": null,
    "activities.activity.target_customer@customers.customer.charge_employee@customers.charge_employee.main_charge": 14852199191504,
    "activities.activity.target_customer@customers.customer.charge_employee@customers.charge_employee.target_employee@employees.employee.id": [
      14852199191504,
      14852199191505
    ],
    "activities.activity.target_customer@customers.customer.charge_department@customers.charge_department.main_charge": 14852199191498,
    "activities.activity.target_customer@customers.customer.charge_department@customers.charge_department.target_department@employees.department.id": [
      14852199191498,
      14852199191501
    ],
    "activities.activity.target_customer@customers.customer.charge_group@customers.charge_group.main_charge": 14852199191496,
    "activities.activity.target_customer@customers.customer.charge_group@customers.charge_group.target_group@employees.group.id": [
      14852199191496,
      14852199191497
    ]
  }