一、简介
ExperienceBuilder(简称:EXB)是以无代码或低代码方式创建web应用程序的平台,通过自定义灵活的布局、内容、微件与2D、3D数据交互,可适配不同屏幕尺寸。
其具有以下特点:
-
可创建单页面或多页面应用,可以固定屏幕或滚动屏幕显示
-
在同一个应用中与2D、3D数据交互
-
通过拖拽微件向应用添加可互相关联的工具
-
可为应用设置主题样式
-
可将应用部署到任意设备
-
可创建自定义应用模板
-
在同一位置创建、部署、管理应用
在 ArcGIS Enterprise 10.8.1/GeoScene Enterprise 2.1中开始引入Experience Builder,分为两个版本:
1.Enterprise内置版,可通过portal的应用程序启动面板打开
2.开发版,可独立安装部署,目前仅有ArcGIS
对应API版本
10.8.1及以上内置企业版可直接访问EXB,也可安装开发版搭配使用;10.6-10.8只能安装独立开发版EXB。其相应JSAPI版本如下:
https://developers.arcgis.com/experience-builder/guide/release-versions/
注意:
一般开发版相较于内置版更新频率更高,如果只是想使用最新开发版的微件功能,请完成第二部分的1-7,如果想扩展开发自定义微件功能,请完成第二部分的1-8。
从Enterprise 11.0开始,支持将自定义微件添加到Enterprise使用,低版本只能在开发版中使用。
同一机器可以同时安装多个版本的EXB。
二、在线安装
1.安装Node.js 12及以上,具体需求版本参考对应API版本
2.下载开发版EXB,解压到自定义路径
3.Server模块安装与服务启动
Server目录位置打开cmd
运行npm ci,自动安装必要模块
运行npm start,启动Server服务,
注意:
若使用自定义端口,运行npm start -- --port 81 --https_port 443
若使用子目录启动server,如https://localhost:3001/subfolder,运行npm start -- --path /subfolder
4.注册到系统服务
Server路径打开cmd,运行npm run install-windows-service,将服务注册到系统服务,默认名称为exb-server,之后可以在系统服务管理启用/停止。
5.Portal新建应用程序项目
下一步补全项目信息,保存即可
6.注册应用程序
打开刚创建的应用程序项目,点击设置
划到最下方找到应用程序注册,点击更新
输入重定向URL,https地址为安装ExperienceBuilder的机器IP加3001端口号,或者https://localhost:3001,点击添加——更新
复制应用程序ID,备用
7.登录EXB应用程序
访问EXB地址:https://IP:3001,需信任证书
输入注册的Enterprise地址及上一步复制的应用程序ID,即可登录
注意:
EXB默认使用Node.js的自签名证书,也可以替换为自己的证书,步骤是替换server/cert目录下的server.key和server.cert文件。或者使用自定义位置下的证书,运行npm start -- --cert_folder <folder path>
(扩展开发额外需要的安装)
8.Client模块安装与服务启动
需安装服务以启动webpack来帮助分发自定义组件,
Client目录位置打开cmd
运行npm ci,自动安装必要模块
运行npm start,启动Client服务,
注意:
在client/your-extensions目录下新建文件或文件夹后,需重启Client服务
三、离线安装
1.本地部署JS API,版本参考对应API
托管JSAPI的服务器最好设置CORS,比如,Windows系统在HTTPS Response Header添加`Access-Control-Allow-Origin`
2.安装Node.js 12及以上,具体需求版本参考对应API版本
3.下载开发版EXB,解压到自定义路径
4.下载npm-cache.zip,解压到自定义路径
5.拷贝npm-cache
用户目录打开cmd
运行npm config get cache,获取缓存位置
拷贝4.中的目录到获取的目录
6.Server、Client模块安装
分别在Server、Client目录打开cmd,分别运行npm install --offline,安装所需模块
7.更新JS API地址
打开Client/dist目录
更新以下四个文件中的arcgisJsApiUrl变量为1.中本地部署的地址
8.启动服务
分别打开Server、Client目录,运行npm start
9.Portal新建应用程序项目
下一步补全项目信息,保存即可
10.注册应用程序
打开刚创建的应用程序项目,点击设置
划到最下方找到应用程序注册,点击更新
输入重定向URL,https地址为安装ExperienceBuilder的机器IP加3001端口号,或者https://localhost:3001,点击添加——更新
复制应用程序ID,备用
11.登录EXB应用程序
访问EXB地址:https://IP:3001,需信任证书
输入注册的Enterprise地址及上一步复制的应用程序ID,即可登录
注意:
EXB默认使用Node.js的自签名证书,也可以替换为自己的证书,步骤是替换server/cert目录下的server.key和server.cert文件。或者使用自定义位置下的证书,运行npm start -- --cert_folder <folder path>
四、应用构建
Enterprise版在portal门户打开ExperienceBuilder应用程序,开发版访问https://域名:3001
1.新建Experience
选择模板
2.添加微件
示例添加了地图微件,拖拽即可
3.添加数据
只支持web地图、场景服务及web要素图层,其余web图层需先保存为地图或场景
4.配置微件
选中微件,右侧面板显示可配置项,包括内容、样式、操作。
比如,选中地图控件,在右侧面板选择地图,为地图空间绑定数据源
5.预览效果
右上方点击保存——预览
五、官方问题汇总
参考链接
ArcGIS Experience Builder install | ArcGIS Experience Builder | ArcGIS Developers
欢迎大家沟通交流,点点关注 懒GISer