前のトピック: getContact次のトピック: グループ管理メソッド


findContacts

findContactsメソッドでは以下のパラメータを使用します。

パラメータ

タイプ

説明

SID

整数

ログインにより取得したセッションを指定します。

userName

String

このユーザ名を持つ連絡先だけが返されます。 パーセント(%)記号を使用してワイルドカード検索ができます。

たとえば、Smi で始まるユーザ名を持つすべての連絡先を検索する場合は、Smi% と指定します。

lastName

String

この姓を持つ連絡先だけが返されます。 パーセント(%)記号を使用してワイルドカード検索ができます。

firstName

String

この名を持つ連絡先だけが返されます。 パーセント(%)記号を使用してワイルドカード検索ができます。

email

String

この電子メール アドレスを持つ連絡先だけが返されます。 パーセント(%)記号を使用してワイルドカード検索ができます。

accessType

String

このアクセス タイプを持つ連絡先だけが返されます。 カンマ区切りで複数の役割を指定できます。 以下の値を指定します。

  • 10002 - 管理
  • 10004 - 顧客
  • 10005 - 従業員
  • 10009 - IT スタッフ
  • 10013 - ナレッジ管理
  • 10014 - プロセス管理
  • 10010 - サービス デスク管理
  • 10008 - サービス デスク スタッフ
  • 10020 - ベンダー スタッフ

inactiveFlag

整数

非アクティブまたはアクティブな連絡先だけが返されます。 以下の値を指定します。

  • 0(アクティブ)
  • -999(すべて)
  • その他(非アクティブ)

説明

連絡先のリストを取得します。

戻り値

<UDSObjectList>ノード。ノード内に、以下の<Attributes>子ノードを使用して連絡先を説明する0個以上の<UDSObject>ノードを含みます。

XML エレメントの値

タイプ

説明

id

UUID

連絡先の一意の ID を示します。

userid

String

連絡先のユーザ名を示します。

last_name

String

連絡先の姓を示します。

first_name

String

連絡先の名を示します。

access_type

整数

連絡先の役割 ID を示します。

delete_flag

整数

連絡先がアクティブか非アクティブかを示します。

  • 0 - アクティブ
  • 1 - 非アクティブ

loginWithArtifact

loginWithArtifact メソッドでは以下のパラメータを使用します。

パラメータ

タイプ

説明

userid

String

ユーザ ID を指定します。

artifact

String

CA EEM から取得したアーチファクトを識別します。

説明

提供される CA EEM アーチファクトによってユーザ認証を実行し、バックエンド サーバでセッションを開始します。 アーチファクトは、認証用に 1 回のみ使用できます。 返されたセッション ID(SID)は、後続の Web サービス メソッド呼び出しに使用できます。 アーチファクトは、CA EEM から直接取得できます。また、getArtifact メソッドによっても取得できます。

注: この操作を行うには、Service Desk と CA EEM とが統合されている必要があります。

この SID は logout() によって解放されます。 タイムアウトまで使用されない場合、SIDの有効期限が切れる可能性があります。

戻り値

以下の値が返されます。

パラメータ

タイプ

説明

SID

String

ほかの Web サービス コールすべてで使用する一意のセッション ID(SID)を示します。 平文となっています。