nVisual二次开发——关于视图内对象的获取

nVisual作为一个图形化管理软件，首要的是将视图内对象渲染出来，对象渲染的数据来源于diagram接口，本章小编带大家了解这个接口。

• 接口描述：传入视图节点id，获取视图属性、视图背景、视图内对象数据

• URL地址：http://ip:port /wapi/v1/diagram/{diagramId}

• 访问方法:：Get

英文参数名	中文参数名	类型	必填	默认值	描述
diagramId	视图Id	Long	是		顶层视图id是24000000000001，之后打开哪个节点视图，视图id即为节点本身id
top_left_x	视图左上角x坐标	Double	否		所在视图为地图时，需要传参视图范围，左上角和右下角来限定加载视图范围，根据限定的视图范围，加载范围内对象。地图坐标系是墨卡托投影坐标
top_left_y	视图左上角y坐标	Double	否
bottom_right_x	视图右下角x坐标	Double	否
bottom_right_y	视图右下角y坐标	Double	否
map_zoom	当前视图所在地图层级	Double			所在视图是地图时，需要知道当前所在视图层级

样例传参：

常规视图：

localhost:8081/wapi/v1/diagram/24000000000001

地图：

localhost:8081/wapi/v1/diagram/24000000173161?top_left_x=12004144.930958997&top_left_y=5606184.75128747&bottom_right_x=13607488.03626885&bottom_right_y=4196074.4534825375&map_zoom=8&map_maxZoom=19

接口会根据传参返回当前视图要加载的数据的一切，包含：当前视图层级、视图权限、视图背景图片、视图宽高、视图比例、视图类型、内部节点对象、内部连线对象等…

返回成功样例

{

    "code": 200,

    "breadcrumbs": [

        "顶层",

        "测试学习",

        "zyb",

        "节点",

        "学校",

        "node"

    ],

    "node_diagram": {

        "id": 24000000160302,

        "typeId": 26000000000000,

        "parentId": 24000000151465,

        "name": "node",

        "background": "",

        "route": "24000000000001/24000000019900/24000000151441/24000000151463/24000000151465/24000000160302",

        "diagramWidth": 1000,

        "diagramHeight": 750,

        "diagramMarginSize": null,

        "hidden": null,

        "slotId": null,

        "masterId": null,

        "insertUserId": 94000000000300,

        "templateId": null,

        "adaNodeId": null,

        "connectorCode": null,

        "rackOverrideType": null,

        "showContainerChildren": true,

        "doubleClickBehavior": "default",

        "mapCoordinateLeft": null,

        "mapCoordinateTop": null,

        "mapCoordinateRight": null,

        "mapCoordinateBottom": null,

        "mapUnitsType": null,

        "dinamicMapSupport": null,

        "autoLayoutState": null,

        "mapSource": null,

        "displayGrid": null,

        "snapToGrid": null,

        "gridSpacingY": null,

        "gridSpacingX": null,

        "pageColor": "#FFFFFF",

        "overrideTemplateGrid": null,

        "readOnlyForNonAdmins": null,

        "collectorId": null,

        "diagramScale": 10,

        "mapZoom": 3,

        "blocked": false

    },

    "node_type_diagram": {

        "id": 26000000000000,

        "name": "node",

        "image": "xejh0pfy.svg",

        "image2": "",

        "background": "",

        "defaultWidth": 117.12777191129884,

        "defaultHeight": 117.12777191129884,

        "typeGroup": 1,

        "hierarchyBrowserLabel": 28000000003736,

        "width": 50,

        "height": 50,

        "templateId": null,

        "vendorId": 880,

        "description": "节点",

        "keepAspectRatio": true,

        "showContainerChildren": false,

        "doubleClickBehavior": "test",

        "categoryId": null,

        "snmpOid": "",

        "independentMounting": false,

        "inStock": -1,

        "nodeClassGroupId": 110012,

        "nodeClassId": null,

        "creator": null,

        "createDate": null,

        "deep": 0,

        "enabled": true,

        "system": true,

        "favourite": true

    },

    "vis_links": [

        {

            "linkId": 25000000114815,

            "typeId": 27000000000060,

            "name": " \n",

            "fromNode": 24000000160303,

            "toNode": 24000000160304,

            "fromRoute": "24000000000001/24000000019900/24000000151441/24000000151463/24000000151465/24000000160302/24000000160303",

            "toRoute": "24000000000001/24000000019900/24000000151441/24000000151463/24000000151465/24000000160302/24000000160304",

            "visLinkId": 211307,

            "diagramId": 24000000160302,

            "routepath": null,

            "fromAnchorPointX": 0.5,

            "fromAnchorPointY": 0.5,

            "toAnchorPointX": 0.5,

            "toAnchorPointY": 0.5,

            "canDelete": true,

            "canMove": true,

            "displayed": true,

            "color": "#cb5b06",

            "thickness": 1,

            "htLinkType": "{\"linkType\":null,\"startArrowHead\":null,\"endArrowHead\":null,\"autoArrangement\":false}",

            "displayedVisLinkFields2": [],

            "table": []

        }

    ],

    "vis_nodes": [

        {

            "id": 2550947,

            "nodeId": 24000000160303,

            "diagramId": 24000000160302,

            "x": 217.5785183006974,

            "y": 241.13354846368617,

            "width": 116.70357514917723,

            "height": 160.25068415238206,

            "imageOverride": null,

            "keepAspectRatio": false,

            "angle": 0,

            "canMove": true,

            "canResize": true,

            "canRotate": true,

            "canDelete": true,

            "zOrder": 0,

            "displayed": true,

            "typeId": 26000000000000,

            "name": "node",

            "parentId": 24000000160302,

            "slotId": null,

            "masterId": null,

            "route": "24000000000001/24000000019900/24000000151441/24000000151463/24000000151465/24000000160302/24000000160303",

            "mapZoom": 3,

            "nodeTypeName": "node",

            "nodeTypeImage": "xejh0pfy.svg",

            "nodeTypeTypeGroup": 1,

            "nodeTypeHeight": 50,

            "nodeTypeWidth": 50,

            "mountedNodesData": null,

            "displayedVisNodeFields": null,

            "shapes": null,

            "diagramSublink": null,

            "diagramSublinks": null,

            "unitsHeight": null,

            "hasEmbeddedFile": false,

            "clusterSize": null,

            "table": [],

            "blocked": false,

            "master": true,

            "cluster": null

        },

           ],

    "ports": [],

    "containerChildren": [],

    "slots": [],

    "diagram_properties": {

        "racks_count": 0,

        "nodes_count": 2,

        "devices_count": 0,

        "links_count": 1

    },

    "diagram_node_properties": [

        {

            "propertyId": 28000000003736,

            "nodeTypeId": 26000000000000,

            "name": "名称",

            "defaultValue": "%template%0",

            "position": 0,

            "mandatory": true,

            "displayed": false,

            "fontSize": 12,

            "fontColor": "#000000",

            "notEditable": false,

            "offsetX": 0,

            "offsetY": 0,

            "angle": 0,

            "anchorPointX": 1,

            "anchorPointY": 1,

            "bold": false,

            "italic": false,

            "underline": false,

            "fontFamily": "Arial",

            "fillColor": "",

            "align": 0,

            "lockList": false,

            "justification": 0,

            "snmpOid": "",

            "propertyValueId": 5820681,

            "nodeId": 24000000160302,

            "value": "node",

            "hasPropertyValue": true,

            "nodeOverrides": [],

            "visNodeFields": {

                "visNodeId": 2550946,

                "propertyValueId": 5820681,

                "offsetY": 0,

                "offsetX": 0,

                "fontSize": 4.1208791208791204,

                "canMove": true,

                "color": "#000000",

                "state": false,

                "angle": 0,

                "bold": false,

                "italic": false,

                "underline": false,

                "fontFamily": "Arial",

                "backgroundColor": "#FFFFFF",

                "align": false,

                "anchor": false,

                "uprightAlignment": null,

                "justification": false,

                "mapZoom": 3,

                "new": true

            },

            "system": false,

            "inProperties": true,

            "typeField": false,

            "uniqueForThisType": false,

            "uniqueForAllTypes": false

        },

      

    ],

    "free_texts": [],

    "diagram_permissions": "Admin"

}

英文参数名	中文参数名	类型	描述
code	状态码	Int	200成功，其他失败
breadcrumbs	导航	Map
node_diagram	视图属性	Map
Id	id	Long
typeid	类型id	Long
parentid	父节点id	Long
name	字段名	String
background	背景	String
route	路径	String
diagramWidth	图形宽度	Double
diagramHeight	图形长度	Double
diagramMarginSize	图形页面空白大小	Double
hidden	隐藏	Boolean
slotId	槽id	Long
masterId	主体id	Long
insertUserId	用户id	Long
templateId	模板id	Long
adaNodeId	自动数据采集模型id	Long
rackOverrideType	架覆盖类型	String
showContainerChildren	展示机柜的子级	Boolean
doubleClickBehavior	双击的反应	String
mapCoordinateLeft	地图左坐标	Double
mapCoordinateTop	地图顶部坐标	Double
mapCoordinateRight	地图右坐标	Double
mapCoordinateBottom	地图底部坐标	Double
mapUnitsType	地图单位种类
dinamicMapSupport	动态地图支持
autoLayoutState	自动布局状态
mapSource	地图源	Int
displayGrid	展示网格
snapToGrid	对齐网格
gridSpacingY	网格行距y坐标
gridSpacingX	网格行距z坐标
pageColor	页面颜色	String
overrideTemplateGrid	覆盖模板网格
readOnlyForNonAdmins	非管理员只读
collectorId	收藏id
diagramScale	图形缩放	Double
mapZoom	地图层级	Double
blocked	封闭的	Boolean
image	图像	String
Image2	图像2	String
background	背景	String
defaultWidth	默认宽度	Double
defaultHeight	默认高度	Double
typeGroup	组类型	Int
hierarchyBrowserLabel	层次结构浏览器标签	Long
width	宽度	Double
height	高度	Double
templateId	模板id	Long
vendorId	供应商id	Long
description	描述	String
keepAspectRatio	是否保持长宽比	Boolean
categoryId	种类id	Long
snmpOid
independentMounting	独立安装	Boolean
inStock	在库的	Int
nodeClassGroupId	节点类组id	Long
nodeClassId	节点类id	Long
creator	创造者
createDate	创造日期
deep	深度	Double
enabled	启用	Boolean
system	系统	Boolean
favourite	最喜欢的	Boolean
vis_links	显示连接	List
linkId	连接id	Long
fromNode	从哪个节点起	Long
toNode	到哪个节点	Long
fromRoute	从什么路径走	String
toRoute	到什么路径	String
visLinkId	显示连接id	Long
diagramId	图形Id	Long
routepath	路线路径?	String
fromAnchorPointX	起点锚点x长度	Double
fromAnchorPointY	起点锚点y长度	Double
toAnchorPointX	终点锚点x长度	Double
toAnchorPointY	终点锚点y长度	Double
canDelete	是否可删除	Boolean
canMove	是否可移动	Boolean
displayed	是否显示	Boolean
Color	颜色	String
htLinkType	Ht连接种类	String
displayedVisLinkFields2	显示显示连接域2	List
Table	表格	List
vis_nodes	显示节点	Map
nodeId	节点Id	Long
x	x坐标	Double
y	y坐标	Double
width	宽度	Double
height	高度	Double
imageOverride	图像覆盖	String
keepAspectRatio	是否保持长宽比	Boolean
angle	角度	Double
canResize	是否可调大小	Boolean
canRotate	是否可旋转	Boolean
zOrder	图层等级	String
nodeTypeName	节点种类名称	String
nodeTypeImage	节点种类图像	String
nodeTypeTypeGroup	节点种类种类组	Int
nodeTypeHeight	节点种类高	Double
nodeTypeWidth	节点种类宽	Double
mountedNodesData	设备上架u位数据
displayedVisNodeFields	显示显示节点域
shapes	形状
diagramSublink	图形子连接
diagramSublinks	图形子连接
unitsHeight	部件高度
hasEmbeddedFile	有嵌入式文件	Boolean
clusterSize	集群规模
cluster	是否是聚合点
ports	端口	List
containerChildren	机柜子集	List
slots	插槽	List
diagram_properties	图形属性	Map
racks_count	机架数	Int
nodes_count	节点数	Int
devices_count	设备数	Int
links_count	连接数	Int
diagram_node_properties	节点图形属性	Map
propertyId	属性id	Long
nodeTypeId	节点种类id	Long
defaultValue	默认值	String
position	位置	Int
fontSize	字体大小	Double
fontColor	字体颜色	String
notEditable	不可编辑的	Boolean
offsetX	X轴偏移	Double
offsetY	Y轴偏移	Double
anchorPointX	X轴锚点	Double
anchorPointY	Y轴锚点	Double
bold	粗体的？	Boolean
italic	斜体的？	Boolean
underline	下划线	Boolean
fontFamily	字体	String
fillColor	填充色	String
align	对齐	Int
lockList	列表锁	Boolean
justification	调整	Boolean
propertyValueId	属性值id	Long
hasPropertyValue	有属性值	Boolean
nodeOverrides	节点覆盖	List
visNodeFields	显示节点的域	Map
visNodeId	显示节点id	Long
state	状态	Boolean
backgroundColor	背景颜色	String
anchor	锚	Boolean
uprightAlignment	垂直对齐
new	是否是新的	Boolean
inProperties	属性	Boolean
typeField	类型字段	Boolean
free_texts	自由文本	List
diagram_permissions	视图权限	String

文：李杨帆

---