用户 #

功能介绍 #

Mall3s获取主要通过nuget包封装（Mal3s.Server.SDK），可以获取公共用户、岗位、角色、部门、公司、站内信等各个基础服务。

备注：本地调试请启动Mall3s.Server项目，否则本地无法启动。

功能清单
- 根据roleEnCode获取用户信息

        /// <summary>
        /// 根据roleEnCode获取用户信息
        /// </summary>
        /// <param name="cancellationToken">cancellationToken</param>
        /// <returns>Success</returns>
        [HttpGet("api/permission/users/UserListByRoleEnCode")]
        ITask<RESTfulResult<List<UserInfoOutput>>> GetUserListByRoleAsync(string roleEnCode, CancellationToken cancellationToken = default);

返回值

 /// <summary>
    /// 用户信息输出
    /// </summary>
    public class UserInfoOutput
    {
        /// <summary>
        /// 主键
        /// </summary>
        public string id { get; set; }

        /// <summary>
        /// 账户
        /// </summary>
        public string account { get; set; }

        /// <summary>
        /// 用户姓名
        /// </summary>
        public string realName { get; set; }

        /// <summary>
        /// 机构ID
        /// </summary>
        public string organizeId { get; set; }

        /// <summary>
        /// 我的主管
        /// </summary>
        public string managerId { get; set; }

        /// <summary>
        /// 岗位主键
        /// </summary>
        public string positionId { get; set; }

        /// <summary>
        /// 角色主键
        /// </summary>
        public string roleId { get; set; }

        /// <summary>
        /// 备注
        /// </summary>
        public string description { get; set; }

        /// <summary>
        /// 性别
        /// </summary>
        public string gender { get; set; }

        /// <summary>
        /// 民族
        /// </summary>
        public string nation { get; set; }

        /// <summary>
        /// 籍贯
        /// </summary>
        public string nativePlace { get; set; }

        /// <summary>
        /// 证件类型
        /// </summary>
        public string certificatesType { get; set; }

        /// <summary>
        /// 证件号码
        /// </summary>
        public string certificatesNumber { get; set; }

        /// <summary>
        /// 文化程度
        /// </summary>
        public string education { get; set; }


        /// <summary>
        /// 电话
        /// </summary>
        public string telePhone { get; set; }

        /// <summary>
        /// 固定电话
        /// </summary>
        public string landline { get; set; }

        /// <summary>
        /// 手机
        /// </summary>
        public string mobilePhone { get; set; }

        /// <summary>
        /// 邮箱
        /// </summary>
        public string email { get; set; }

        /// <summary>
        /// 紧急联系人
        /// </summary>
        public string urgentContacts { get; set; }

        /// <summary>
        /// 紧急电话
        /// </summary>
        public string urgentTelePhone { get; set; }

        /// <summary>
        /// 通讯地址
        /// </summary>
        public string postalAddress { get; set; }

        /// <summary>
        /// 头像
        /// </summary>
        public string headIcon { get; set; }

        /// <summary>
        /// 有效标志
        /// </summary>
        public int? enabledMark { get; set; }

        /// <summary>
        /// 排序
        /// </summary>
        public long? sortCode { get; set; }
    }

根据用户id获取用户信息

        /// <summary>
        /// 根据用户id获取用户信息(,分割 )
        /// </summary>
        /// <param name="cancellationToken">cancellationToken</param>
        /// <returns>Success</returns>
        [HttpPost("api/permission/users/UserListById")]
        ITask<RESTfulResult<List<UserInfoOutput>>> GetUserListAsync([JsonContent] string userIds, CancellationToken cancellationToken = default);

返回值

 /// <summary>
    /// 用户信息输出
    /// </summary>
    public class UserInfoOutput
    {
        /// <summary>
        /// 主键
        /// </summary>
        public string id { get; set; }

        /// <summary>
        /// 账户
        /// </summary>
        public string account { get; set; }

        /// <summary>
        /// 用户姓名
        /// </summary>
        public string realName { get; set; }

        /// <summary>
        /// 机构ID
        /// </summary>
        public string organizeId { get; set; }

        /// <summary>
        /// 我的主管
        /// </summary>
        public string managerId { get; set; }

        /// <summary>
        /// 岗位主键
        /// </summary>
        public string positionId { get; set; }

        /// <summary>
        /// 角色主键
        /// </summary>
        public string roleId { get; set; }

        /// <summary>
        /// 备注
        /// </summary>
        public string description { get; set; }

        /// <summary>
        /// 性别
        /// </summary>
        public string gender { get; set; }

        /// <summary>
        /// 民族
        /// </summary>
        public string nation { get; set; }

        /// <summary>
        /// 籍贯
        /// </summary>
        public string nativePlace { get; set; }

        /// <summary>
        /// 证件类型
        /// </summary>
        public string certificatesType { get; set; }

        /// <summary>
        /// 证件号码
        /// </summary>
        public string certificatesNumber { get; set; }

        /// <summary>
        /// 文化程度
        /// </summary>
        public string education { get; set; }


        /// <summary>
        /// 电话
        /// </summary>
        public string telePhone { get; set; }

        /// <summary>
        /// 固定电话
        /// </summary>
        public string landline { get; set; }

        /// <summary>
        /// 手机
        /// </summary>
        public string mobilePhone { get; set; }

        /// <summary>
        /// 邮箱
        /// </summary>
        public string email { get; set; }

        /// <summary>
        /// 紧急联系人
        /// </summary>
        public string urgentContacts { get; set; }

        /// <summary>
        /// 紧急电话
        /// </summary>
        public string urgentTelePhone { get; set; }

        /// <summary>
        /// 通讯地址
        /// </summary>
        public string postalAddress { get; set; }

        /// <summary>
        /// 头像
        /// </summary>
        public string headIcon { get; set; }

        /// <summary>
        /// 有效标志
        /// </summary>
        public int? enabledMark { get; set; }

        /// <summary>
        /// 排序
        /// </summary>
        public long? sortCode { get; set; }
    }

使用说明 #

引用nuget包Mal3s.Server.SDK
配置文件appsettings.json中NacosConfig节点的Listeners添加配置

{
        "Optional": false,
        "DataId": "netcore-webapi.json",
        "Group": "DEFAULT_GROUP"
},

微服务配置

  services.AddServerApiService(_configuration);

注入服务

private readonly IHttpSystemApi _httpSystemApi;
 public HomeController(IHttpSystemApi api)
{
  _httpSystemApi = api;
}

调用基础服务方法

  var userInfos = await _httpSystemApi.GetUserListByRoleAsync("xxx");
  
  return userInfos;

岗位

功能介绍

使用说明