GetRolesForUser Web メソッドの使用
4 min
現在のユーザーが使用できるロールのリストを返します。 現在のユーザーの従業員レコードに関連付けられているロールの配列を格納するフィールドを含む応答オブジェクトを返します。
リクエスト構文
FRSHEATIntegrationGetRolesResponse GetRolesForUser(文字列セッションキー、文字列テナントID) NameDisplayPair[] GetRolesForUser(文字列セッションキー、文字列テナントID、文字列ユーザ名)パラメータ
- sessionKey: Connect Web メソッドからのセッション キー。
- tenantId: セッション キーが認証されるテナント。
戻り値
FRSHEATIntegrationGetRolesResponse クラスは次のように定義されます。
パブリック クラス FRSHEATIntegrationGetRolesResponse
{
パブリック文字列ステータス { 取得; 設定; }
パブリック リスト<NameDisplayPair> roleList { get; set; }
パブリック文字列例外理由 { 取得; 設定; }
}FRSHEATIntegrationGetRolesResponse クラスには次のフィールドがあります。
- ステータス: Web メソッドが現在のユーザーのロールのリストを正常に取得したかどうかを示すステータスが含まれます。 セッション キー ( Connect Web メソッドから返される) が有効な場合、このフィールドは成功の値を返します。
- roleList: NameDisplayPair オブジェクトの配列が含まれます。 各 NameDisplayPair エントリは、現在のユーザーが属するロールに対応します。 配列内の各 NameDisplayPair レコードについて、 name プロパティはロールの名前を返しますが、 表示名 プロパティはロールの表示名を返します。
- exceptionReason: この Web メソッドの実行時にアプリケーションが例外をスローした場合の例外情報が含まれます。
例
FRSHEATIntegrationGetRolesResponse getRolesResponse = frSvc.GetRolesForUser(authSessionKey, tenantId);
名前表示ペア[] ロールペアリスト = null;
if (getRolesResponse.status == "Success")
{
rolePairList = getRolesResponse.roleList;
Console.WriteLine("現在のユーザーは次のロールに属しています:");
foreach (NameDisplayPair rolePair in rolePairList)
{
Console.WriteLine("\\tRole: {0} => DisplayName: \\"{1}\\"", rolePair.Name, rolePair.DisplayName);
}
}