SOAP サービス: WSDL ドキュメントからのクラスの定義

外部サービスの呼び出し

WSDL ドキュメントを使用して Apex クラスを生成した後、外部サービスを呼び出すには、Apex コードにスタブのインスタンスを作成して、そこでメソッドをコールします。たとえば、Apex から StrikeIron IP アドレス検索サービスを呼び出すために、次のようなコードを作成できます。

1  // Create the stub
2  strikeironIplookup.DNSSoap dns = new strikeironIplookup.DNSSoap();
3
4  // Set up the license header
5  dns.LicenseInfo = new strikeiron.LicenseInfo();
6  dns.LicenseInfo.RegisteredUser = new strikeiron.RegisteredUser();
7  dns.LicenseInfo.RegisteredUser.UserID = 'you@company.com';
8  dns.LicenseInfo.RegisteredUser.Password = 'your-password';
9
10  // Make the Web service call
11  strikeironIplookup.DNSInfo info = dns.DNSLookup('www.myname.com');

HTTP ヘッダーのサポート

Web サービスコールアウトでの HTTP ヘッダーの送信

1docSample.DocSamplePort stub = new docSample.DocSamplePort();
2stub.inputHttpHeaders_x = new Map<String, String>();
3
4//Setting a basic authentication header
5
6stub.inputHttpHeaders_x.put('Authorization', 'Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==');
7
8//Setting a cookie header
9stub.inputHttpHeaders_x.put('Cookie', 'name=value');
10
11//Setting a custom HTTP header
12stub.inputHttpHeaders_x.put('myHeader', 'myValue');
13
14String input = 'This is the input string';
15String output = stub.EchoString(input);

inputHttpHeaders_x の値を指定すると、標準ヘッダーセットがその値で上書きされます。

Web サービスコールアウト応答からの HTTP 応答ヘッダーへのアクセス

1docSample.DocSamplePort stub = new docSample.DocSamplePort();
2stub.outputHttpHeaders_x = new Map<String, String>();
3String input = 'This is the input string';
4String output = stub.EchoString(input);
5
6//Getting cookie header
7String cookie = stub.outputHttpHeaders_x.get('Set-Cookie');
8
9//Getting custom header
10String myHeader = stub.outputHttpHeaders_x.get('My-Header');

outputHttpHeaders_x のデフォルト値は null です。応答のヘッダーの内容にアクセスするには、outputHttpHeaders_x を設定する必要があります。

サポートされる WSDL の機能

Apex では、ドキュメントリテラルでラップした WSDL スタイルと次のプリミティブデータ型と組み込みデータ型のみをサポートしています。

Apex では、次のスキーマ構造をサポートしています。

• xsd:all、API バージョン 15.0 以降を使用して保存した Apex コードにおいて
• xsd:annotation、API バージョン 15.0 以降を使用して保存した Apex コードにおいて
• xsd:attribute、API バージョン 15.0 以降を使用して保存した Apex コードにおいて
• xsd:choice、API バージョン 15.0 以降を使用して保存した Apex コードにおいて
• xsd:element。API バージョン 15.0 以降を使用して保存した Apex コードにおいて、ref 属性が次の制限付きでサポートされます。
  • 他の名前空間の ref はコールできません。
  • グローバル要素では ref を使用できません。
  • また、要素に ref が含まれる場合も、name または type を含めることができません。
• xsd:sequence

次のデータ型は、コールインとして使用されている場合、つまり外部 Web サービスが Apex Web サービスメソッドをコールする場合にのみサポートされています。これらのデータ型は、コールアウトとして使用されている場合、つまり Apex Web サービスメソッドが外部 Web サービスをコールする場合はサポートされていません。

• blob
• decimal
• enum

Apex は次のようなその他の WSDL コンストラクタ、データ型、サービスをサポートしていません。

• RPC/符号化サービス
• 複数の portTypes、複数のサービス、または複数のバインドを含む WSDL サービス
• 外部スキーマをインポートする WSDL ファイル。たとえば、外部スキーマをインポートしている次の WSDL フラグメントは、サポートされていません。
  1<wsdl:types>
  2    <xsd:schema
  3     elementFormDefault="qualified"
  4     targetNamespace="http://s3.amazonaws.com/doc/2006-03-01/">
  5      <xsd:include schemaLocation="AmazonS3.xsd"/>
  6    </xsd:schema>
  7  </wsdl:types>

  ただし、同じスキーマ内のインポートはサポートされています。次の例では、外部 WSDL は変換する WSDL に貼り付けられます。

  1<wsdl:types>
  2    <xsd:schema
  3      xmlns:tns="http://s3.amazonaws.com/doc/2006-03-01/"
  4      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  5      elementFormDefault="qualified"
  6      targetNamespace="http://s3.amazonaws.com/doc/2006-03-01/">
  7
  8      <xsd:element name="CreateBucket">
  9        <xsd:complexType>
  10          <xsd:sequence>
  11     [...]
  12    </xsd:schema>
  13  </wsdl:types>

• 前の表に記載されていないスキーマの型
• Salesforce WSDL を含めた、サイズ制限を超えた WSDL
• ドキュメントリテラルでラップしたスタイルを使用しない WSDL。次の WSDL スニペットはドキュメントリテラルでラップしたスタイルを使用しないため、インポートしたときに「Unable to find complexType (complexType が見つかりません)」というエラーが発生します。
  1<wsdl:types>
  2    <xsd:schema targetNamespace="http://test.org/AccountPollInterface/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  3      <xsd:element name="SFDCPollAccountsResponse" type="tns:SFDCPollResponse"/>
  4      <xsd:simpleType name="SFDCPollResponse">
  5          <xsd:restriction base="xsd:string" />
  6      </xsd:simpleType>
  7    </xsd:schema>
  8  </wsdl:types>

  次のスニペットは、要素の順序を含む complexType として simpleType 要素をラップするよう変更したものです。この場合はドキュメントリテラルのスタイルに従っているため、サポートされています。
  1<wsdl:types>
  2    <xsd:schema targetNamespace="http://test.org/AccountPollInterface/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  3      <xsd:element name="SFDCPollAccountsResponse" type="tns:SFDCPollResponse" />
  4      <xsd:complexType name="SFDCPollResponse">
  5        <xsd:sequence>
  6          <xsd:element name="SFDCOutput" type="xsd:string" />
  7        </xsd:sequence>
  8      </xsd:complexType>
  9    </xsd:schema>
  10  </wsdl:types>