ステップ 4: サンプルコードを説明する

Java サンプルコード

C# サンプルコード

ここでは、サンプル C# クライアントアプリケーションについて説明します。このサンプルアプリケーションでは、ログインするために必要なステップを示し、いくつかの API コールを呼び出し、引き続いて処理する方法を説明します。

このサンプルアプリケーションでは、次の主要なタスクを実行します。

1. Salesforce のユーザー名とパスワードの入力をユーザーに促します。
2. login() をコールして、シングルログインサーバーにログインします。ログインが成功すると、次を実行します。
   • 返された sessionId を、後続の API コールのセッション認証に必要なセッションヘッダーに設定します。
   • Lightning プラットフォームエンドポイントを、後続の API コールの対象となる返された serverUrl にリセットします。

     API にアクセスするすべてのクライアントアプリケーションは、後続の API コールを実行する前に、このステップでタスクを完了する必要があります。

   • ユーザー情報を取得し、セッション情報と共にコンソールに書き込みます。
3. describeGlobal() をコールし、組織のデータで使用できるすべてのオブジェクトの一覧を取得します。describeGlobal メソッドは、ログインユーザーが使用できるオブジェクトを指定します。API コールから返されるデータは頻繁に変更されることはないため、この API コールは、セッションごとに何度も呼び出すべきではありません。DescribeGlobalResult はコンソールにエコーとして返されます。
4. describeSObjects() をコールして、指定されたオブジェクトのメタデータ (項目リストとオブジェクトプロパティ) を取得します。describeSObject メソッドは、ユーザーが使用できる各オブジェクトに取得できるメタデータ情報の種類について説明しています。サンプルクライアントアプリケーションはユーザーが指定するオブジェクトに describeSObjects() コールを実行し、返されたメタデータ情報をコンソールにエコーとして返します。オブジェクトメタデータ情報には、権限、データ型、選択リスト項目の長さと使用できる値、referenceTo 項目のデータ型が記載されています。
5. 単純なクエリ文字列 ("SELECT FirstName, LastName FROM Contact") を渡し、query() を呼び出し、返される QueryResult を反復処理します。
6. logout() をコールして、ユーザーをログアウトします。

次のサンプルコードでは try/catch ブロックを使用して、API コールで返される可能性のある例外を処理します。

次のコードによって、サンプル C# クライアントアプリケーションが開始されます。

次の C# の例は、.NET 2.0 SforceService サービスの代わりに .NET 3.0 SoapClient サービスを使用している点を除き、前の C# の例と同じです。