岗位 #
功能介绍 #
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; }
}
使用说明 #
- 引用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 result = await _sysApi.GetPositionAsync("276306219235280133");
var result = await _sysApi.GetAllPositionsAsync();
var result = await _sysApi.PositionSelectorAsync();