FetchServiceReqValidationListData Web メソッドの使用
5 min
指定された サービス申請パラメータの許容検証リスト データを返します。
リクエスト構文
パブリック FRSHEATFetchSRValListDataResponse FetchServiceReqValidationListData(文字列 sessionKey、文字列 tenantId、文字列 offeringName、文字列 paramName、FRSHEATDepValItem depvalItem = null、文字列 subStrMatch = "")パラメータ
- sessionKey: Connect Web メソッドからのセッション キー。
- tenantId: セッション キーが認証されるテナント。
- offeringName: 申請項目の名前。
- paramName: 申請項目内のパラメータの名前。
- depValItem: 依存検証項目を表す FRSHEATDepValItem オブジェクト。
- subStrMatch: 返された検証リスト項目と一致する部分文字列。
戻り値
FRSHEATFetchSRValListDataResponse オブジェクトは次のように定義されます。
パブリッククラス FRSHEATFetchSRValListDataResponse
{
パブリック文字列ステータス { 取得; 設定; }
パブリック文字列例外理由 { 取得; 設定; }
public List<FRSHEATValListValue> validationValuesList { get; set; }
}FRSHEATFetchSRValListDataResponse クラスには次のフィールドがあります。
- ステータス: 接続の状態に関するステータスを提供します。 以下の表には、使用可能なステータス値の詳細な説明が記載されています。
- exceptionReason: この Web メソッドの実行時にアプリケーションが例外をスローした場合の例外情報が含まれます。
- validationValuesList: FRSHEATValListValue オブジェクトのリストが含まれており、各オブジェクトは指定された検索条件に一致するレコードを表します。
FRSHEATValListValue クラスは次のように定義されます。
パブリッククラス FRSHEATValListValue
{
public string strRecId;
public string strStoredValue;
パブリック文字列 strDisplayValue;
}FRSHEATValListValue クラスには次のフィールドがあります。
- strRecId: 検証リストに対応する RecID。
- strStoredValue: 検証リスト レコードの保存された値。 たとえば、検証リスト レコードが「Ashley Simon」従業員レコードに対応する場合は「ASimon」になります。
- strDisplayValue: 検証リスト レコードの表示値。 たとえば、検証リスト レコードが「Ashley Simon」従業員レコードに対応する場合は、「Ashley Simon」になります。
次の表に、使用可能なステータス値とその解釈方法を示します。
状態 | 説明 |
|---|---|
成功 | 指定された数値 ID を持つ サービス申請を正常に取得しました。 これは、 reqData フィールドで使用できます。 |
見つかりません | テナントには、指定された数値 ID を持つ サービス申請が含まれていません。 数値 ID が正しく入力されていることを確認してください。 |
エラー | この Web メソッドの実行中にエラーが発生しました。 対応する exceptionReason フィールドを調べて、Web メソッドが失敗した理由を特定します。 |
例
// リクエスト元に一致する検証リストレコードを取得します。
// 「ドメインパスワードリセット」申請項目
// リクエスターは「RequesterDeparment」パラメータによって制約されるため、
// これはWebメソッドへの入力パラメータとして指定する必要があります
string offeringName = "ドメインパスワードのリセット";
文字列 paramName = "リクエスター";
FRSHEATDepValItem depValItem = newFRSHEATDepValItem()
{
strParName = "RequesterDepartment",
strParValue = "IT"
};
FRSHEATFetchSRValListDataResponse 検証値応答 = frSvc.FetchServiceReqValidationListData(authSessionKey、tenantId、offeringName、paramName、depValItem、subStrQuery);
FRSHEATValListValue[] valListValues;
if (validationValuesResponse.status == "成功")
{
valListValues = validationValuesResponse.validationValuesList;
Console.WriteLine("一致する検証リスト レコードは次のとおりです:\n");
foreach (FRSHEATValListValue valListItem in valListValues)
{
Console.WriteLine("保存された値: \\"{0}\\"\\t\\t表示値: \\"{1}\\"", valListItem.strStoredValue, valListItem.strDisplayValue);
}
}