创建角色 - 应用 API

创建角色
信息包含：角色名称、描述、权限信息

请求参数

Body 参数application/json

name

string

角色名称

必需

description

string

角色描述

必需

permissionWay

string

必需

分发所有应用项, 80：可查看、编辑、删除所有记录; 60：可查看所有记录，但只能编辑、删除自己拥有的记录; 30：可查看加入的，只能编辑、删除自己拥有的记录; 20：对所有记录只有查看权限; 0：分发有权限应用项

hideAppForMembers

string

必需

是否对成员隐藏应用,true：隐藏，false：不隐藏

generalAdd

object

添加权限

可选

enable

boolean

必需

gneralShare

object

分享权限

可选

enable

boolean

必需

generalImport

object

导入权限

可选

enable

boolean

必需

generalExport

object

导出权限

可选

enable

boolean

必需

generalDiscussion

object

讨论权限

可选

enable

boolean

必需

generalSystemPrinting

object

系统打印

可选

enable

boolean

必需

generalAttachmentDownload

object

附件下载

可选

enable

boolean

必需

generalLogging

object

日志

可选

enable

boolean

必需

worksheetAddRecord

object

工作表添加记录

可选

enable

boolean

工作表添加记录

必需

worksheetShareView

object

工作表分享

可选

enable

boolean

工作表分享

必需

worksheetImport

object

工作表导入

可选

enable

boolean

工作表导入

必需

worksheetExport

object

工作表导出

可选

enable

boolean

工作表导出

必需

worksheetDiscuss

object

工作表讨论

可选

enable

boolean

工作表讨论

必需

worksheetLogging

object

工作表日志

可选

enable

boolean

工作表日志

必需

worksheetBatchOperation

object

工作表批量操作

可选

enable

boolean

工作表批量操作

必需

recordShare

object

记录分享

可选

enable

boolean

记录分享

必需

recordDiscussion

object

记录讨论

可选

enable

boolean

记录讨论

必需

recordSystemPrinting

object

系统打印

可选

enable

boolean

系统打印

必需

recordAttachmentDownload

object

附件下载

可选

enable

boolean

附件下载

必需

recordLogging

object

日志

可选

enable

boolean

日志

必需

payment

object

支付

可选

enable

boolean

支付

必需

extendAttrs

array[string]

扩展属性

可选

optionalControls

array[string]

可选控件

可选

sheets

array [object {7}]

可选

sheetId

string

工作表Id

必需

canAdd

string

是否可添加

必需

readLevelId

string

必需

查看权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

editLevelId

string

必需

编辑权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

removeLevel

string

必需

删除权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

removeLevelId

array [object {6}]

必需

删除权限级别 0：未授权 20：仅我拥有的 30：我的及下属的 100：全部的

navigateHide

string

是否导航隐藏

必需

pages

array [object {6}]

自定义页面Id集

必需

pageId

string

可选

name

string

可选

checked

boolean

可选

navigateHide

boolean

可选

sortIndex

integer

可选

iconUrl

string

可选

示例

{
    "appKey":"422e5a5d0e570105",
"sign":"MzkzMDY3Mzk1NjM0YjkyNjE1YzI2N2ZhNDEzZGE3ZTQwMzQ3ZWJkNzI1ZDc2NjcxYTdkY2ViMzVhZGJlNTI0Yg==",
    "appId": "bd75405e-4c8e-4dba-8b43-9820c0b53ec2",
    "projectId": "28447959-cf7f-4ae9-9074-8977ce48e2a0",
    "hideAppForMembers": false,
    "roleType": 0,
    "permissionWay": 0,
    "sheets": [
        {
            "sheetId": "67cff5821131169abf7ef611",
            "sheetName": "组织管理",
            "canAdd": true,
            "readLevel": 100,
            "editLevel": 100,
            "removeLevel": 100,
            "views": [
                {
                    "viewId": "67cff5821131169abf7ef615",
                    "viewName": "全部",
                    "canRead": true,
                    "canEdit": true,
                    "canRemove": true,
                    "type": 0
                }
            ],
            "fields": [
                {
                    "fieldId": "ownerid",
                    "type": 26,
                    "fieldName": "拥有者",
                    "notRead": false,
                    "notEdit": false,
                    "notAdd": false,
                    "isDecrypt": false,
                    "isReadField": false,
                    "hideWhenAdded": true,
                    "isHide": false
                }
            ],
             "worksheetAddRecord": {
                "enable": true 
            },
            "worksheetShareView": {
                "enable": true
            },
            "worksheetImport": {
                "enable": true
            },
            "worksheetExport": {
                "enable": true
            },
            "worksheetDiscuss": {
                "enable": true
            },
            "worksheetLogging": {
                "enable": true
            },
            "worksheetBatchOperation": {
                "enable": true
            },
            "recordShare": {
                "enable": true
            },
            "recordDiscussion": {
                "enable": true
            },
            "recordSystemPrinting": {
                "enable": true
            },
            "recordAttachmentDownload": {
                "enable": true
            },
            "recordLogging": {
                "enable": true
            },
            "payment": {
                "enable": true
            }
        }
        
    ],
    "extendAttrs": [],
    "optionalControls": [],
    "pages": [
        {
            "pageId": "67617eef1657b7ae33be5ae2",
            "name": "0",
            "checked": true,
            "navigateHide": false,
            "sortIndex": 8,
            "iconUrl": "https://fp1.mingdaoyun.cn/customIcon/dashboard.svg"
        }
    ],
    "roleCategory": 0,
    "generalAdd": {
        "enable": true
    },
    "gneralShare": {
        "enable": true
    },
    "generalImport": {
        "enable": true
    },
    "generalExport": {
        "enable": true
    },
    "generalDiscussion": {
        "enable": true
    },
    "generalSystemPrinting": {
        "enable": true
    },
    "generalAttachmentDownload": {
        "enable": true
    },
    "generalLogging": {
        "enable": true
    },
    "description": "",
    "name": "新角色40"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.mingdao.com/v1/open/app/createRole' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey":"422e5a5d0e570105",
"sign":"MzkzMDY3Mzk1NjM0YjkyNjE1YzI2N2ZhNDEzZGE3ZTQwMzQ3ZWJkNzI1ZDc2NjcxYTdkY2ViMzVhZGJlNTI0Yg==",
    "appId": "bd75405e-4c8e-4dba-8b43-9820c0b53ec2",
    "projectId": "28447959-cf7f-4ae9-9074-8977ce48e2a0",
    "hideAppForMembers": false,
    "roleType": 0,
    "permissionWay": 0,
    "sheets": [
        {
            "sheetId": "67cff5821131169abf7ef611",
            "sheetName": "组织管理",
            "canAdd": true,
            "readLevel": 100,
            "editLevel": 100,
            "removeLevel": 100,
            "views": [
                {
                    "viewId": "67cff5821131169abf7ef615",
                    "viewName": "全部",
                    "canRead": true,
                    "canEdit": true,
                    "canRemove": true,
                    "type": 0
                }
            ],
            "fields": [
                {
                    "fieldId": "ownerid",
                    "type": 26,
                    "fieldName": "拥有者",
                    "notRead": false,
                    "notEdit": false,
                    "notAdd": false,
                    "isDecrypt": false,
                    "isReadField": false,
                    "hideWhenAdded": true,
                    "isHide": false
                }
            ],
             "worksheetAddRecord": {
                "enable": true 
            },
            "worksheetShareView": {
                "enable": true
            },
            "worksheetImport": {
                "enable": true
            },
            "worksheetExport": {
                "enable": true
            },
            "worksheetDiscuss": {
                "enable": true
            },
            "worksheetLogging": {
                "enable": true
            },
            "worksheetBatchOperation": {
                "enable": true
            },
            "recordShare": {
                "enable": true
            },
            "recordDiscussion": {
                "enable": true
            },
            "recordSystemPrinting": {
                "enable": true
            },
            "recordAttachmentDownload": {
                "enable": true
            },
            "recordLogging": {
                "enable": true
            },
            "payment": {
                "enable": true
            }
        }
        
    ],
    "extendAttrs": [],
    "optionalControls": [],
    "pages": [
        {
            "pageId": "67617eef1657b7ae33be5ae2",
            "name": "0",
            "checked": true,
            "navigateHide": false,
            "sortIndex": 8,
            "iconUrl": "https://fp1.mingdaoyun.cn/customIcon/dashboard.svg"
        }
    ],
    "roleCategory": 0,
    "generalAdd": {
        "enable": true
    },
    "gneralShare": {
        "enable": true
    },
    "generalImport": {
        "enable": true
    },
    "generalExport": {
        "enable": true
    },
    "generalDiscussion": {
        "enable": true
    },
    "generalSystemPrinting": {
        "enable": true
    },
    "generalAttachmentDownload": {
        "enable": true
    },
    "generalLogging": {
        "enable": true
    },
    "description": "",
    "name": "新角色40"
}'

返回响应

🟢200成功

application/json

Body

data

object

必需

roleId

string

角色 id

必需

name

string

角色名称

必需

roleType

integer

角色类型

必需

desc

string

描述

必需

users

array[string]

用户信息

必需

departments

array[string]

部门

必需

departmentTrees

array[string]

部门树

必需

projectOrganizes

array[string]

组织角色

必需

jobs

array[string]

职位

必需

success

boolean

必需

error_code

integer

必需

示例

{
    "data": {
        "roleId": "6825715d-92cc-4e15-83ce-8e39d1a667bc",
        "name": "新角色40",
        "roleType": 0,
        "desc": "",
        "users": [],
        "departments": [],
        "departmentTrees": [],
        "projectOrganizes": [],
        "jobs": []
    },
    "success": true,
    "error_code": 1
}

🟠401没有权限

🟠404记录不存在