CRMを触っていると必ず出会うのが「API名」です。画面に表示される項目のラベルとは別に、システムが内部でその項目を識別するための名前で、関数の実装や外部連携、データ移行のときに欠かせません。

SalesforceからZoho CRMへの移行案件をいくつか経験する中で、この2つのCRMではAPI名の考え方がかなり違うと感じました。今回は具体的なAPI名そのものには踏み込まず、それぞれの仕様の思想を整理してみます。

SalesforceのAPI名の考え方

Salesforceでは、項目を作るとラベルをもとにAPI名が自動生成されます。日本語のラベルであっても、内部的には英数字ベースの名前が割り当てられ、独自に追加した項目には決まった接尾辞が付く仕組みになっています。標準で用意されている項目と、ユーザーが後から追加した項目とで、命名のルールがはっきり分かれているのが大きな特徴です。

つまり、API名を見れば「これは標準項目なのか、後から追加された項目なのか」がある程度判別できます。この一貫性は、開発や連携の場面では扱いやすいポイントです。名前だけを見て項目の素性を推測できるので、コードを書く側からすると見通しが立てやすいのです。

もう一つ重要なのが、一度決まったAPI名は基本的に変わらないという点です。ラベルを後から日本語に変えても、内部のAPI名はそのまま維持されます。表示上の名前と内部の名前が独立して管理されているので、運用の途中でラベルを調整しても、既存の連携が壊れにくいという安心感があります。

ZohoのAPI名の考え方

一方でZoho CRMのAPI名は、もう少し柔軟で、そのぶん不揃いになりやすい印象です。項目を作ったときのラベルをもとに名前が決まりますが、生成のされ方が一律ではなく、項目によって命名の傾向がまちまちになることがあります。

特に、モジュールを作り込んでいく過程で項目を追加したり作り直したりを繰り返すと、似たような役割の項目でも命名のパターンがそろわないことがあります。整った名前が付く項目もあれば、機械的に振られた番号のような名前になる項目もあり、あとから一覧で眺めると統一感に欠ける、ということが起こりがちです。

これはZohoが劣っているという話ではなく、項目を柔軟に足し引きしながら育てていける設計思想の裏返しでもあります。手軽にカスタマイズできる反面、命名の一貫性は運用する側が意識して保つ必要がある、ということです。

標準項目とカスタム項目の扱いの違い

両者の思想の違いがよく表れるのが、標準項目とカスタム項目の区別です。

Salesforceは、この2つを命名のルールではっきり分けています。名前を見ればどちらか判別できるので、処理を機械的に分岐させることもしやすい設計です。大規模な連携で、項目の種類ごとに扱いを変えたいときに、この明快さは効いてきます。

Zohoは、標準として最初から用意されている項目と、ユーザーが追加した項目とで、命名の傾向は異なるものの、Salesforceほど厳密に線引きされているわけではありません。管理画面ではカスタム項目かどうかのフラグで区別できますが、API名そのものだけを見て素性を判断するのは、Salesforceに比べると難しい場面があります。

項目の型と名前の関係

もう一点、実務で気づいたのが、項目の型とAPI名の関係です。

どちらのCRMでも、テキストや数値、日付、選択リスト、ルックアップ、数式など、さまざまな型の項目を作れます。ただ、名前を見ただけでその項目がどの型なのかは、両者とも基本的には分かりません。名前と型は別の情報として管理されているためです。

これは当たり前のようでいて、移行や連携の設計では見落としやすいところです。名前が似ていても、一方はテキスト、もう一方は数式、ということが普通に起こります。API名の一覧だけを頼りにすると、型の違いを見誤ることがあるので、名前とあわせて型の情報も必ず突き合わせる習慣が大切だと感じています。

どちらが良い悪いではない

ここまで両者の違いを並べてきましたが、これはどちらが優れているという話ではありません。

Salesforceの一貫した命名は、大規模で堅牢な連携を組むうえで強みになります。ルールが明確なぶん、多くの開発者が関わる現場でも認識のずれが起きにくいでしょう。

Zohoの柔軟な命名は、現場でスピーディーにモジュールを組み立て、試行錯誤しながら業務に合わせていく使い方にフィットします。中小規模で、自分たちの手でCRMを育てていくスタイルには、この身軽さがむしろ合っていると感じます。

大切なのは、それぞれの思想の違いを理解したうえで付き合うことです。特に、この2つをまたぐデータ移行では、この命名の考え方の違いが思わぬところで効いてきます。その具体的な注意点については、次の記事で改めてまとめます。