O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 O2OA(v9.5)开发平台更新说明(二):数据视图与内容管理双优化
  • 6.2 安装部署-私有化部署服务器架构推荐
  • 6.3 安装部署-在Linux系统中部署O2OA 平台
  • 6.4 安装部署-在Windows系统中部署O2OA 平台
  • 6.5 安装部署-通过Docker Hub快速部署docker镜像
  • 6.6 安装部署-在宝塔/PHPStudy中部署O2OA 平台
  • 6.7 安装部署-O2OA 平台之HTTP端口规划
  • 6.8 安装部署-平台服务器版本升级操作说明
  • 6.9 安装部署-O2OA 平台集群部署配置及操作说明
  • 6.10 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.11 服务器配置与管理-​O2OA主要配置文件说明
  • 6.12 服务器配置与管理-服务器端口冲突和端口修改
  • 6.13 服务器配置与管理-如何修改服务器内存占用率?
  • 6.14 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.15 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.16 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.17 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.18 服务器配置与管理-O2OA 平台平台数据库配置信息样例
  • 6.19 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.20 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.21 服务器配置与管理-文件存储服务器配置
  • 6.22 服务器配置与管理-工作日节假日配置
  • 6.23 服务器配置与管理-消息提醒配置说明
  • 6.24 服务器配置与管理-自定义消息提醒
  • 6.25 服务器配置与管理-定制消息通知的内容
  • 6.26 服务器配置与管理-消息通知过滤
  • 6.27 服务器配置与管理-为待办创建配置邮件通知
  • 6.28 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.29 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.30 服务器配置与管理-数据导出导入与系统数据备份
  • 6.31 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.32 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.33 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.34 O2OA 平台如何基于nginx上下文分发的方式快速集群部署
  • 6.35 系统安全-访问日志相关配置
  • 6.36 系统架构-平台集群化部署之基于Nginx端口分发机制实现集群部署
  • 6.37 系统安全-审计日志相关配置
  • 6.38 系统安全-平台日志文件说明
  • 6.39 系统架构-基于nginx快速集群部署-上下文分发
  • 6.40 系统安全-O2OA日志输出设置log4j2.xml
  • 6.41 系统安全-用户密码初始化规则的设定(默认密码是什么)
  • 6.42 系统安全-启用HTTPS(百度云版)
  • 6.43 系统安全-启用HTTPS(腾讯云版)
  • 6.44 系统安全-自签名SSL证书验证HTTPS功能
  • 6.45 系统安全-登录密码RSA加密
  • 6.46 系统安全-用户登录IP限制
  • 6.47 O2OA 平台前端安全配置建议(一)
  • 6.48 系统安全-在用户登录过程中启用图形验证码
  • 6.49 系统协作集成-金山文档
  • 6.50 系统安全-平台部署之使用非root用户运行服务
  • 6.51 O2OA(v9.5)开发平台更新说明(一):流程平台
  • 6.52 系统协作集成-集成永中Office
  • 6.53 系统安全-O2Server启用国密加密设置
  • 6.54 系统协作集成-集成金格在线Office
  • 6.55 系统安全-日志应用使用说明
  • 6.56 O2OA(v9.5)开发平台更新说明(三):聚焦安全与系统维护的全面升级
  • 6.57 系统安全-用户重置密码操作(重置后密码是什么)
  • 6.58 系统安全-超级管理员(xadmin)密码修改
  • 6.59 O2OA(v9.5)开发平台更新说明(四):手机端焕新登场、功能再升级、体验再飞跃!
  • 6.60 系统安全-使用Web端运行服务器管理命令
  • 6.61 O2OA(v9.5)开发平台更新说明(五):应用功能优化与问题修复
  • 6.62 系统安全-o2server无法正常显示验证码解决办法
  • 第16章 开发知识及常见问题
  • 16.1 O2OA如何实现文件跨服务器的备份
  • 16.2 O2OA 平台服务器故障排查
  • 16.3 开发知识-让后端代理/接口脚本编写也能像前端一样用上debugger
  • 16.4 常见问题-SQLServer中创建新数据库使用哪个中文编码?
  • 16.5 O2OA 平台流程引擎中如何修改,定制流程的流转记录
  • 16.6 mysql数据库备份
  • 16.7 domain不正确的时候如何强制设置成正确的
  • 16.8 配置文件中使用密文存储密码
  • 16.9 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.10 常见问题-查看表结构
  • 16.11 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.12 linux环境libreoffice安装及使用
  • 16.13 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.14 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.15 藕粉社区问答系列1
  • 16.16 藕粉社区问答系列2
  • 16.17 藕粉社区问答系列3
  • 16.18 快速入门-平台相关资料汇总
  • 16.19 快速入门-服务器总体介绍汇总
  • 16.20 快速入门-流程表单载入基础数据
  • 16.21 快速入门-常用表单脚本样例汇总
  • 16.22 快速入门-自定义表数据分页样例
  • 16.23 云服务器-阿里云ECS服务器的端口启用
  • 16.24 开发知识-React篇:在O2OA 平台框架中使用React
  • 16.25 开发知识-React篇:在O2OA门户页面中使用React
  • 16.26 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.27 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.28 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.29 平台中使用Druid数据库连接及监控
  • 16.30 开发知识-在PAAS平台上部署O2OA 平台
  • 16.31 开发知识-如何使用Tomcat架设webdav服务器
  • 16.32 开发知识-单个端口模式的Nginx和系统配置
  • 16.33 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.34 开发知识-O2OA 平台启用Eruda进行移动端调试
  • 16.35 开发知识-神通数据库安装
  • 16.36 开发知识-人大金仓数据安装
  • 16.37 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.38 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.39 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.40 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.41 开发知识-数据优化知识点
  • 16.42 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.43 消息队列-配置activeMQ、kafka消息队列
  • 16.44 常见问题-数据导出或者导入时发生OOM异常
  • 16.45 常见问题-如何让用户首次登录必须改掉初始密码
  • 16.46 常见问题-如何在模块部署中控制模块的访问权限
  • 16.47 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.48 常见问题-如何使用服务管理调用WebService
  • 16.49 常见问题-如何使用脚本调用外部服务
  • 16.50 常见问题-如何使用脚本控制流程自动流转
  • 16.51 常见问题-如何通过脚本调用系统内服务
  • 16.52 常见问题-接口代码疑惑解答汇总
  • 16.53 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.54 常见问题-集群配置后启动报错:NullPointerException
  • 16.55 常见问题-服务器错误:can not decrypt token
  • 16.56 常见问题-IOS移动办公无法收到验证码
  • 16.57 常见问题-服务器和日志时间相差12小时的问题
  • 16.58 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.59 藕粉社区问答系列4
  • 16.60 开发知识-React篇:在React应用中集成O2OA

  • 开发知识-Vue篇:使用Vue-CLI开发O2应用

    时间:2022-08-03   
    内容导读

    本篇介绍在平台框架内使用脚手架工具 Vue-CLI 开发应用并部署到平台服务目录的做法:先安装工具并创建项目,接着在页面入口引入平台脚本、抽取全局对象,并把框架实例挂载放入脚本载入完成后的回调。随后修改根组件,嵌入指定数据应用下的视图,添加创建文档与打开主页的按钮,再自行编写组件包装平台视图对象。最后说明编译前需把资源路径设为相对路径、产物部署到服务目录,另有本地运行与自动化上传等做法。

    提示:

    本文介绍的方法已过时,建议查看文档:o2oa 开发平台前端源码级二次开发

    介绍 O2OA 前端二次开发中创建 O2OA component 的方式,分别基于 React 和 Vue 模式。


    Vue-CLI 是 Vue 官方提供的 CLI 工具,用于为应用快速搭建繁杂的脚手架。本章介绍如何在 Node,js 环境下使用 Vue-CLI 工具进行 Vue 和 O2 集成应用开发,并在 O2平台的 webServer 下运行。

    版本要求

    本文适用于以下版本:

    环境安装

    Vue CLI 需要 Node.js 8.9 或更高版本 (推荐 8.11.0+)。在正确安装好 Node.js 和 npm 或 yarn 后,可以使用下列任一命令全局安装 Vue-CLI:

    npm install -g @vue/cli # OR yarn global add @vue/cli

    安装完成后,你就可以在命令行中访问 vue 命令。运行 vue 命令,若展示出所有可用命令的帮助信息,即可验证它是否安装成功。

    还可以用该命令检查其版本是否正确:

    vue --version

    在 O2平台框架中使用 Vue

    如果希望将应用部署在 O2服务器的 webServer 下,则可参考下面的例子。

    创建一个应用

    运行以下命令创建一个名为 vue-app 的新项目:

    vue create vue-app

    根据提示选取所需特性,本例使用默认选项。安装完成后,Vue 会自动创建好整个目录结构:

    目录.png

    本例中嵌入 O2平台数据中心中的一个视图,用于展现内容管理信息;并创建两个按钮,分别用于创建信息文档和打开主页。

    添加 O2脚本引入:在 public/index.html 的 head 中添加 O2脚本引入:

    HTML复制代码

    1
    <script src="../o2_core/bundle.js"></script>

    indexhtml.png

    为便于后续引入,在 src 下创建 o2.js 文件,添加以下代码:

    let o2 = window.o2; let layout = window.layout; export {o2, layout};

      修改 src/main.js 文件如下:

    import Vue from 'vue' import App from './App.vue' //引入o2的layout对象 import {layout} from "./o2"; Vue.config.productionTip = false; //当o2载入完成后创建Vue根组件 layout.addReady(function(){   new Vue({     render: h => h(App),   }).$mount('#app') });

    修改 App 组件

      修改 src/App.vue 文件如下:

    <template>   <div id="app">     <div class="title">信息中心</div>     <o2-view app="内容管理数据" name="所有信息"/>     <button @click="createDocument">创建新信息</button>     <button @click="openHomepage">打开主页</button>   </div> </template> <script> //引用o2-view组件 import o2View from './components/o2-view.vue' //引入o2的全局对象o2 import {o2} from "./o2"; export default {   name: 'App',   components: {     o2View   },   methods: {     "createDocument": function(){       //通过o2.env对象新建内容管理文档       //o2.env对象即是在O2门户页面的脚本中的this指向,可以使用其方法。       //createDocument方法创建内容管理文档,可传入栏目和分类参数,请参考API文档       o2.env.page.createDocument();     },     "openHomepage": function(){       //通过o2.env对象打开主页应用       o2.env.page.openApplication("Homepage");     }   } } </script> <style>   #app {     width: 80%;     margin: 30px auto;   }   .title {     padding: 10px;     background: #0f81cc;     font-size: 18px;     color: #ffffff;   }   button {     padding: 10px 20px;     text-align: center;     background: #0f81cc;     margin-top: 10px;     color: #ffffff;     font-size: 18px;     float: left;     margin-right: 20px;     cursor: pointer;     border: 0;   } </style>

    App.vue 是一个 Vue 组件,文件分为三部分:<template>部分定义组件模板,<style>部分定义组件样式,<script>部分实现组件逻辑。

    模板中使用了<o2-view>标签,将由 o2-view 组件负责渲染,并向 o2-view 传入两个参数:app="内容管理数据"和name="所有信息",我们将在 o2-view 组件中使用这两个参数,用于展现"内容管理数据"这个数据应用下的"所有信息"视图。您需要现在 O2平台里创建好对应的视图,如果需要展现其他数据应用的其他视图,需要修改这两个值。

    创建了两个 button,通过 @click 分别绑定 createDocument 和 openHomepage 两个方法,用于新建内容管理文档和打开主页应用

    在 components 部分引用了 o2View 组件,下一步创建该组件。

    创建 o2-view 组件

    删除 src/components/目录下的原有 .vue 文件,然后新建 o2-view.vue 文件,输入以下代码:

    <template>   <div class="view"></div> </template> <script> //引入o2对象 import {o2} from "../o2"; export default {   name: 'o2-view',   props: {     app: String, //传入的参数,本例中获取到“内容管理数据”     name: String  //传入的参数,本例中获取到“所有信息”   },   //在vue组件挂载后执行   mounted: function(){     //引入o2平台的Viewer对象     o2.xDesktop.requireApp("query.Query", "Viewer", function(){       //新建一个Viewer对象,用于展现指定的视图       //将Viewer展现挂载到this.$el上,就是template中的:<div class="view"></div>对象       new o2.xApplication.query.Query.Viewer(this.$el, {         "application": this.app,         "viewName": this.name,       });     }.bind(this));   } } </script> <style scoped> div {   height: 600px; } </style>

      在 o2-view 组件中,我们主要做的事是,在 vue 组件挂载后,将 o2的视图组件,再挂载到 o2-view 组件的根 Dom 对象。

    同时,需要在 O2服务器上创建好对应的数据应用和视图,本例中即“内容管理数据”应用下的“所有信息”视图。

    编译并运行

    完成上述开发工作后,即可编译并运行我们的应用。

    由于我们要将 Vue 应用部署在 O2的 web 服务器目录下,而非根路径下,因此需要简单配置编译路径。在 vue 应用目录下创建 vue.config.js 文件,输入以下代码:

    module.exports = {     publicPath: "." };

    将编译后的路径引用设置为相对路径。

    在当前项目路径下,使用以下任意一条命令编译项目:

    npm build # OR yarn build

      出现类似下面的信息,表示编译成功:

    编译成功.png

    编译后,将在项目路径下,生成 dist 目录,

    vue-app.png

    接着将dist目录部署到O2服务器的webServer下,并重命名为“vue-app”。然后通过浏览器访问:http://your-server/vue-app。

    如果未登录服务器,会出现登录页面,登录后即可查看应用运行的效果。

    信息列表.png

    如果您将您的应用部署到服务器的其他目录,如 custom/vue-app 下,那么您需要在 src/o2.js 文件中增加一行代码:o2.base = "../";

    //src/o2.js let o2 = window.o2; let layout = window.layout; o2.base = "../"; export {o2, layout};

    至此,我们已经可以在 O2平台的框架内使用 Vue 开发应用了。

    开发模式优化

    虽然可以使用 React 开发 O2应用,但上述模式在每次修改代码后,都需要运行 build 命令并手工上传到服务器,在开发较复杂的应用时效率较低。下面介绍两种应对方式。

    本地运行 O2服务器

    可以在本地运行服务器,并直接在服务器的 webServer 目录下创建项目。然后必须修改 Vue 配置,使其编译到正确的路径,即修改项目目录下的 vue.config.js 文件:

    module.exports = {     publicPath: ".",     outputDir: "../vue-app" };

      然后每次运行编译后,Vue会将编译后的应用生成在webServer/vue-app/目录下,我们直接通过http://locahost/vue-app就可以查看运行结果。

    通过部署工具自动化部署到远程服务器

    当然,为了节省我们部署远程服务器的时间,可以使用 javascript 打包工具,自动完成这个过程,这里我们使用 gulp,通过 ftp 或 sftp 来进行自动化部署到远程服务器。

    这种方式无需在本地运行 O2服务器,但需要准备一台远程服务器,并可通过 ftp 或 sftp 连接到服务器的 webServer。

    按上述方式创建好应用后,安装 gulp 环境:

    npm i -g gulp-cli

      安装 gulp 以及 gulp 相关插件:

    npm i gulp gulp-ftp gulp-sftp-up4 gulp-run -save-dev

      在项目根目录新建 gulpfile.js 文件:

    var gulp = require('gulp'),     ftp = require('gulp-ftp'),     sftp = require('gulp-sftp-up4'),     run = require('gulp-run'); //根据您的实际服务器修改 var options = {     'build': 'dist',     'host': 'o2server服务器',     'user': 'sftp user',     'pass': 'sftp password',     "port": 22,     "remotePath": "/data/o2server/servers/webServer/vue-app" }; //sftp任务 function upload_sftp(){     var build = "dist/**/*";     return gulp.src(build)         .pipe(sftp({             host: options.host,             user: options.user || 'anonymous',             pass: options.pass || null,             port: options.port || 22,             remotePath: (options.remotePath || '/')         })); } //ftp任务 function upload_ftp(){     var build = "dist/**/*";     return gulp.src(build)         .pipe(ftp({             host: options.host,             user: options.user || 'anonymous',             pass: options.pass || null,             port: options.port || 21,             remotePath: (options.remotePath || '/')         })); } //运行vue build function build_vue() {     return run('npm build').exec(); } 输出gulp任务,如果使用ftp,更换第二个任务为upload_ftp exports.build = gulp.series(build_vue, upload_sftp);

    当开发或修改代码完成后,执行以下命令:

    gulp build

    即可自动编译 Vue 应用并上传到 O2服务器。通过浏览器访问:http://your-server/vue-app 即可查看结果。

    这只是一个简单的示例,用于提供一种思路,也可以使用其他熟悉的工具实现相同或类似的功能。对于熟悉前端构建工具的用户,实现更便捷的功能也不困难,例如监控文件改动、实时部署并刷新浏览器等。

    总结

    本章介绍了在 O2平台的框架内使用 Vue 开发应用,并将应用运行在 O2服务器的 webServer 中。该方式集成了 O2平台的全部功能,无需处理登录等繁琐事项,也可方便地调用 O2的后端服务,并提供了优化开发模式的思路。

    O2OA 翱途 企业应用开发平台

    兰德网络O2OA平台软件

    开源、自主可控的协同办公底座

    研发与运营

    纵横翱途(杭州)科技有限公司

    企业级协同应用 · 工作流引擎 · AI 智能体

    www.o2oa.net | 400-888-0545