Salesforce API名生成ツールの使い方
- テキスト入力欄に、日本語でカスタム項目名やオブジェクト名を入力します（例：「取引先担当者」「注文明細」）。
- 初回利用時はAIモデルが自動的にダウンロードされます（約30MB、次回以降はキャッシュから読み込まれます）。
- 「API名を生成」ボタンをクリックすると、AIが日本語を英語に翻訳し、Salesforceの命名規則に沿ったAPI名を自動生成します。
- 生成されたAPI名（snake_case / camelCase / __c / __mdt）をコピーして、Salesforceの設定画面に貼り付けてご利用ください。
すべての処理はブラウザ内で完結し、入力した日本語テキストがサーバーに送信されることはありません。機密性の高い項目名も安心してご利用いただけます。
SalesforceのAPI名とは
Salesforce では、カスタムフィールドやカスタムオブジェクトを作成する際に「表示ラベル」と「API名」の2つを設定します。 表示ラベルはユーザーが画面上で目にする名前（日本語も可能）で、API名はシステム内部で使用される一意の英語識別子です。
API名は、Apex コードでの参照（Account.Custom_Field__c）、SOQL クエリ（SELECT Custom_Field__c FROM Account）、メタデータ API によるデプロイ、
データローダーによるデータ操作など、Salesforce のプログラム的な操作すべてで使われます。
そのため、わかりやすく一貫性のある命名が非常に重要です。
__c と __mdt のサフィックス
Salesforce では、カスタム項目の種類に応じて異なるサフィックスが自動的に付与されます。
__c（Custom）— カスタムフィールドやカスタムオブジェクトに付与されます。例：Order_Detail__c（カスタムオブジェクト）、Total_Amount__c（カスタムフィールド）。__mdt（Custom Metadata Type）— カスタムメタデータ型に付与されます。アプリケーションの設定値やマッピング定義など、デプロイ可能な設定データの保存に使います。例：Tax_Rate_Setting__mdt。__r（Relationship）— カスタムリレーション名に使用されます（本ツールでは生成対象外）。
API名の命名規則
Salesforce のAPI名には厳格なルールがあります。
- 使用可能文字：英字（A-Z, a-z）、数字（0-9）、アンダースコア（_）のみ。日本語・スペース・ハイフンなどは使用不可。
- 先頭文字：必ず英字で始める（数字やアンダースコアで始められない）。
- 連続アンダースコア不可：
Order__Detailのようにアンダースコアが2つ以上連続する名前は設定できません（__cサフィックスは例外）。 - 末尾アンダースコア不可：サフィックスの前にアンダースコアで終わることはできません。
- 文字数制限：サフィックスを除いて最大40文字。
日本語ラベルからAPI名を決める際のベストプラクティス
日本語の表示ラベルから英語のAPI名を決める際は、以下のポイントに注意すると、チーム全体で一貫性のあるメタデータを構築できます。
- 意味が伝わる英訳を選ぶ — 「取引先」→
Account、「注文明細」→Order_Detailのように、英語圏の開発者にも理解できる名前にする。 - 省略しすぎない —
Ord_Dtl__cよりOrder_Detail__cの方が可読性が高い。 - snake_case で統一する — Salesforce の標準項目は
PascalCase（例：AccountNumber）ですが、カスタム項目はSnake_Case（例：Order_Detail__c）で作成するのが一般的です。 - プレフィックスを活用する — パッケージやアプリ固有の項目には
APP_Field_Name__cのようなプレフィックスを付けると、標準項目との衝突を避けられます。
AI翻訳の仕組み
このツールは Helsinki-NLP/opus-mt-ja-en モデル（量子化ONNX形式）を Transformers.js で動かしています。 Transformers.js はブラウザの WebAssembly / WebGPU 上で機械学習モデルを実行するライブラリで、すべての推論処理がクライアントサイドで完結します。 翻訳結果が外部サーバーに送信されることは一切ありません。
初回利用時にモデルファイル（約30MB）がダウンロードされ、ブラウザの Cache Storage にキャッシュされます。 2回目以降はキャッシュから即座に読み込まれるため、起動が高速です。
よくある質問（FAQ）
SalesforceのAPI名とは何ですか？
API名はSalesforceの内部で使用される一意の識別子です。カスタムフィールドやカスタムオブジェクトを作成すると自動的に付与され、Apex、SOQL、メタデータAPIなどからアクセスする際に使用します。表示ラベル（日本語）とは別に、英語ベースのAPI名が必要です。
__cと__mdtの違いは何ですか？
__c はカスタムフィールドやカスタムオブジェクトのサフィックスです。__mdt はカスタムメタデータ型のサフィックスで、アプリケーションの設定やマッピング情報など、デプロイ可能な設定データの保存に使われます。
API名の命名規則は何ですか？
使用できる文字は英数字とアンダースコアのみです。先頭は英字で始める必要があり、連続するアンダースコアは使用できません。サフィックスを除いて最大40文字の制限があります。
日本語ラベルからAPI名を決める方法は？
日本語のラベルを英語に翻訳し、単語をアンダースコアで区切る snake_case 形式にするのが一般的です。このツールではAIが自動的に日英翻訳とAPI名生成を行うため、手動で英訳する手間を省けます。
このツールはオフラインで動作しますか？
初回はAIモデルのダウンロード（約30MB）にインターネット接続が必要ですが、モデルがブラウザにキャッシュされた後はオフラインでも使用可能です。翻訳処理はすべてブラウザ内で完結します。