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  | 
文:李杨帆











