岗位 #

功能介绍 #

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

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

  • 功能清单
    • 获取岗位下拉框(公司+部门+岗位)树形
        /// <summary>
        /// 获取岗位下拉框(公司+部门+岗位)
        /// </summary>
        /// <param name="cancellationToken">cancellationToken</param>
        /// <returns>Success</returns>
        [HttpGet("api/permission/position/Selector")]
        ITask<RESTfulResult<PositionListTreeOutput>> PositionSelectorAsync(CancellationToken cancellationToken = default);

返回值

  public class PositionListTreeOutput
    {
        public List<PositionSelectorOutput> list { get; set; }
    }
    /// <summary>
    /// 岗位下拉框输出
    /// </summary>
    [SuppressSniffer]
    public class PositionSelectorOutput : TreeModel
    {
        /// <summary>
        /// 岗位名称
        /// </summary>
        public string fullName { get; set; }

        /// <summary>
        /// 图标
        /// </summary>
        public string icon { get; set; }

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

        /// <summary>
        /// 岗位类型
        /// </summary>
        public string type { get; set; }

        /// <summary>
        /// 排序
        /// </summary>
        public long? sortCode { get; set; }
    }
  • 全部岗位下拉框(下拉框)
/// <summary>
        /// 全部岗位
        /// </summary>
        /// <param name="cancellationToken">cancellationToken</param>
        /// <returns>Success</returns>
        [HttpGet("api/permission/position/All")]
        ITask<RESTfulResult<PositionListTreeOutput>> GetAllPositionsAsync(CancellationToken cancellationToken = default);

返回值

同上

  • 获取岗位信息
// <summary>
        /// 根据Id获取角色信息
        /// </summary>
        /// <param name="id">主键</param>
        /// <param name="cancellationToken">cancellationToken</param>
        /// <returns>Success</returns>
        [HttpGet("api/permission/position/{id}")]
        ITask<RESTfulResult<PositionInfoOutput>> GetPositionAsync([Required] string id, CancellationToken cancellationToken = default);

返回值

 /// <summary>
    /// 岗位信息输出
    /// </summary>
    [SuppressSniffer]
    public class PositionInfoOutput
    {
        /// <summary>
        /// 主键
        /// </summary>
        public string id { get; set; }

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

        /// <summary>
        /// 岗位名称
        /// </summary>
        public string fullName { get; set; }

        /// <summary>
        /// 岗位编号
        /// </summary>
        public string enCode { get; set; }

        /// <summary>
        /// 岗位类型
        /// </summary>
        public string type { get; set; }

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

        /// <summary>
        /// 描述
        /// </summary>
        public string description { get; set; }

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

使用说明 #

  1. 引用nuget包Mal3s.Server.SDK
  2. 配置文件appsettings.json中NacosConfig节点的Listeners添加配置
{
        "Optional": false,
        "DataId": "netcore-webapi.json",
        "Group": "DEFAULT_GROUP"
},
  1. 微服务配置
  services.AddServerApiService(_configuration);
  1. 注入服务
private readonly IHttpSystemApi _httpSystemApi;
 public HomeController(IHttpSystemApi api)
{
  _httpSystemApi = api;
}
  1. 调用基础服务方法
 var result = await _sysApi.GetPositionAsync("276306219235280133");
 var result = await _sysApi.GetAllPositionsAsync();
 var result = await _sysApi.PositionSelectorAsync();
上次更新: 3/8/2023, 4:23:32 PM