SOAP API 開発者ガイド
jPartner WSDL の使用
API では、次の 2 つの WSDL を使用できます。
- Enterprise Web サービス WSDL — 単独の Salesforce 組織のクライアントアプリケーションを構築する Enterprise 開発者によって使用されます。Enterprise WSDL は非常に強い型付けであるため、コールは int や string など特定のデータ型のオブジェクトや項目を含みます。Enterprise WSDL ドキュメントを使用する顧客は、組織でカスタムオブジェクトまたはカスタム項目を変更したとき、あるいは異なるバージョンの API を使用するときに、Enterprise WSDL ドキュメントをダウンロードし、改めて使用する必要があります。組織の現在の WSDL にアクセスするには、Salesforce 組織にログインし、[設定] から、[クイック検索] ボックスに「API」と入力します。次に、API ページで [Enterprise WSDL の生成] を選択します。
- Partner Web サービス WSDL — メタデータ駆動で本来動的なクライアントアプリケーションに使用されます。特に、複数の組織が利用するクライアントアプリケーションを構築する Salesforce パートナーにとって役立ちます (もちろん、他のケースでも役立ちます)。特定のデータ型ではなく、項目名と値の名前-値のペアを使用する Salesforce データモデルはあまり強く型付けされていないため、いかなる組織内のデータにアクセスするためにも使用できます。この WSDL は、オブジェクトに対して処理を行う前にオブジェクトの情報を取得するクエリコールを発行できるクライアントアプリケーションの開発に最も適しています。Partner WSDL ドキュメントは、API のバージョンごとに 1 回のみダウンロードして使用する必要があります。組織の現在の WSDL にアクセスするには、Salesforce 組織にログインし、[設定] から、[クイック検索] ボックスに「API」と入力します。次に、API ページで [パートナー WSDL の生成] を選択します。
通常、Enterprise WSDL がより使用しやすいですが、Partner WSDL は柔軟性があり、さまざまな組織に動的に適応可能です。Partner WSDL を使用すると、複数のユーザおよび複数の組織に使用できる単一のアプリケーションを更新できます。
高精度バージョン
正規の WSDL よりも高い精度が必要な場合、取引先チームまで、「高精度 API」機能についてお問い合わせください。この機能が有効になっている場合、ダウンロードした WSDL (Enterprise と Partner の両方) でより精度の高いデータ型が使用されます。たとえば、丸めエラーが発生しやすい複雑な数値数式を組織で使用する場合には、この機能が役立ちます。
WSDL の正規バージョンを使用していて、高精度バージョンに変更する場合、次の手順を実行します。
- 新しい WSDL をダウンロードします。
- スタブコードを再生成します(「Java 開発者環境の設定」を参照)。
- コードの数値を保存するために使用される変数の型が新しい型に対応できることを確認します。