この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

SOAP API 開発者ガイド

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

ステップ 3: 開発プラットフォームに WSDL ファイルをインポートする

WSDL ファイルを作成または取得したら、開発環境内のクライアント Web サービスアプリケーション構築に必要なオブジェクトを生成できるよう、WSDL ファイルを開発プラットフォームにインポートする必要があります。このセクションでは、WSC と Microsoft Visual Studio のサンプルについて説明します。その他の開発環境の指示については、プラットフォームの製品マニュアルを参照してください。

WSDL ファイルをインポートするプロセスは、Enterprise WSDL ファイルおよび Partner WSDL ファイルで同じです。

メモ

Java 環境での使用方法 (WSC)

Java 環境は、サーバ側オブジェクトのプロキシとして機能する Java オブジェクトを使用して、API にアクセスします。API を使用する前に、まず組織の WSDL ファイルからこれらのオブジェクトを生成する必要があります。

SOAP クライアントには、このプロセスで使用する独自のツールがあります。WSC では、wsdlc ユーティリティを使用します。

wsdlc を実行する前に、システムに WSC JAR ファイルがインストール済みであり、クラスパスで参照されている必要があります。

メモ

wsdlc の基本構文は、次のとおりです。

このコマンドでは、指定された WSDL ファイルに基づいて jar 出力ファイルを生成します。jar 出力ファイルの作成後、Java プログラムで wsc jar ファイル (wsc-22.jar など) と共に参照し、クライアントアプリケーションを作成します。

Microsoft Visual Studio での使用方法

Visual Studio 言語は、サーバ側オブジェクトのプロキシとして機能するオブジェクトを使用して API にアクセスします。API を使用する前に、まず組織の WSDL ファイルからこれらのオブジェクトを生成する必要があります。

サーバ側オブジェクトのプロキシクラスを取得したら、非文字列項目に値を設定しているかどうかを指定する必要があります。詳細は、「.NET、非文字列項目、および Enterprise WSDL」を参照してください。

Visual Studio には、WSDL ファイルをインポートして XML Web サービスクライアントを生成する 2 つの方法があります。IDE ベースの方法と、コマンドラインを使用する方法です。このステップごとの説明では、IDE を使用して WSDL ファイルをインポートする方法を説明します。

始める前に、まず新しいアプリケーションを作成するか、Visual Studio で既存のアプリケーションを開きます。また、「ステップ 2: Web サービス WSDL を生成または取得する」で説明されているように WSDL ファイルを生成する必要があります。

メモ

XML Web サービスクライアントは、XML Web サービスを参照して使用するコンポーネントまたはアプリケーションです。必ずしもクライアントベースのアプリケーションである必要はありません。実際、多くの場合、ご使用の XML Web サービスクライアントは、Web フォームなどのその他の Web アプリケーションであったり、その他の XML Web サービスであったりします。マネージコードで XML Web サービスにアクセスする場合、プロキシクラスと .NET Framework がすべてのインフラストラクチャコードを処理します。

マネージコードから XML Web サービスにアクセスするには、次の手順を行います。

  1. プロジェクト名 Walkthrough を編集します (後述のサンプルの using ディレクティブを your_project_name.web_reference_name に変更します)。Web 参照を、アクセスする XML Web サービスのプロジェクトに追加します。Web 参照は、XML Web サービスの公開されたメソッドのプロキシとして機能するメソッドでプロキシクラスを作成します。
  2. Web 参照の名前空��を追加します。
  3. プロキシクラスのインスタンスを作成し、その他のクラスのメソッドと同様にそのクラスのメソッドにアクセスします。

Visual Studio のバージョンと推奨される開発者環境に応じて、.NET 2.0 スタイルの Web 参照か、.NET 3.0 スタイルのサービス参照のいずれかを追加できます。.NET 3.0 スタイルの参照では、SforceService ではなく SoapClient のようなサービスを使用します。

Web 参照を追加するには、次の手順を行います。

これらのステップは使用している Visual Studio のバージョンによって異なる可能性があります。詳細は、Visual Studio マニュアルの「Adding and Removing Web References (Web 参照の追加と削除)」を参照してください。

メモ

  1. Visual Studio 2010 以前を使用している場合は、[プロジェクト] メニューで [Web 参照を追加] を選択します。Visual Studio の以降のバージョンでは、[プロジェクト] メニューで [サービス参照を追加]、[詳細]、[Web 参照を追加] の順に選択します。
  2. [Web 参照を追加] ダイアログボックスの URL ボックスに、次のように、アクセスする XML Web サービスについてのサービス説明を取得する URL を入力します。

    c:\WSDLFiles\enterprise.wsdl

  3. [Go] をクリックして、XML Web サービスの情報を取得します。
  4. Web 参照名のボックスで、Web 参照に使用する名前である、sforce への Web 参照の名前を変更します。
  5. [参照を追加] をクリックして、対象 XML Web サービスの Web 参照を追加します。
  6. Visual Studio は、サービスの説明を取得し、プロキシクラスを生成して、アプリケーションと XML Web サービス間を接続します。

Visual Basic .Net 1.1 と Enterprise WSDL を使用する場合、生成された Web サービスを変更して、Visual Studio のクライアント生成ユーティリティのバグを解決する必要があります。API は、名前が Visual Basic キーワードと競合する 2 つのオブジェクト (Case と Event) を公開します。これらのオブジェクトを表すクラスが作成されると、Visual Studio はクラス名を大かっこで囲みます ([Case] と [Event])。これは、キーワードを再利用するメソッドです。

メモ

SObject クラスの定義では、Visual Studio は、SObject 定義の一部である System.Xml.Serialization.XmlIncludeAttribute のクラス参照にケースと行動をラップしません。Visual Studio のこの問題を回避するには、次のようにケースや行動で XmlIncludeAttribute 設定を編集する必要があります。C# には適用されず、Enterprise WSDL を使用する場合にのみ適用されます。