SOAP API の一般的な例外

IBM® Campaign SOAP API が、次の一般的な例外をスローすることがあります。すべてのローカライズされた例外のメッセージは、 IBM Campaign で使用可能な場合、 要求されたロケールに置かれます。通常の Java™ ロケール・フォールバック・ポリシーが適用されます。

RemoteException

このアイテムは、SOAP インターフェースにのみ適用されます。

API に対するすべての SOAP 呼び出しは、SOAP エンベロープ処理レイヤー (Axis) での問題や何かの理由による Web サービス WSDL で定義された制約の違反など、システム・レベルのエラーが検出された場合に、RemoteException をスローすることがあります。

DataException など、チェック済みおよび未チェックの普通の API 例外は、RemoteException としてではなくエラー状態として返されます。

詳しくは、SOAP インターフェースのセクションを参照してください。

AuthenticationException

ユーザーを指定の Campaign パーティションに対して認証できませんでした。IBM Marketing Platform で定義されているユーザーの役割を確認してください。

許可例外

ユーザーは、要求された操作の実行を許可されていません。この例外はどの API メソッドでもスローできるので、宣言されません (検査されません)。IBM Marketing Platform でユーザーの役割に割り当てられている権限を確認してください。

データ例外

Campaign で、基礎となるデータベース・レイヤーに重大な例外が生じました (チェックされていません)。

詳しくは、IBM Campaign フローチャートおよびリスナー・ログを確認してください。

ロック例外

別のユーザーによって編集されているコンポーネント (フローチャートなど) をクライアントが更新しようとするときにスローされる、一時的な例外。通常は、待機してから操作を再試行することにより、この例外からリカバリーできます。再試行のロジックに関してはクライアントが担当します。

InvalidComponentException

無効または不明なコンポーネント (キャンペーン、フローチャート、ターゲット・セル) を参照しようとしました。例外の getComponentReference() メソッドは、問題のコンポーネントの参照を返します。

InvalidAttributeException

誤ったデータ型を使用したり、許可されていない値の配列を使用したりするなど、クライアントが無効な属性を提供または参照したときにスローされる例外。例外の getAttributeName() メソッドは問題の属性の名前を返し、getAttributeValue() は値を返し、getComponentReference() はコンポーネント (またはバルク・インデックス) を示します。

AttributeExistsException

クライアントがコンポーネントに複製する属性のメタデータを定義しようとするとスローされます。例外の getAttributeName() メソッドは、複製する属性の名前を返します。getComponentReference() はコンポーネント (またはバルク・インデックス) を示します。

AttributeNotFoundException

クライアントが不明な属性 (キャンペーン、フローチャート、ターゲット・セル、その他) を参照しようとすると常にスローされます。例外の getAttributeName() メソッドは、一致しない属性の名前を返します。getComponentReference() はコンポーネント (またはバルク・インデックス) を示します。

CompositeException

CompositeException は、複数のエラーを呼び出し元に報告して戻すために、いくつかの API によって使用されます。これには通常、複数の原因がバインドされます。 すべての原因は、発生した順序によるリストとして取得されます。例外の getCauseList() メソッドはこのリストを返します。 そのリストをさらに検査して、各エラーの詳細を知ることができます。

注: 通常、API は作業を正常に完了するか、複合の例外をスローする前に作業をロールバックします。例えば、SOAP API メソッド: ターゲット・セルで説明されているバルク・ターゲット・セル・スプレッドシート API を参照してください。