派胜OA - Windows 部署 ExpressOA 3.x（系统环境和软件配置）

ExpressOA 3.x 使用全球最佳编程语言 C# 构建（.NET 跨平台、高性能、开源免费）。
ExpressOA 包含自托管 Kestrel Web 服务器，Kestrel 可以单独使用，也可以与反向代理服务器一起使用。
ExpressOA 应用程序 runroot 文件夹中包含应用程序目录结构。

在 Windows Server 2022, 2019, 2016 上的托管方式：

l使用 IIS 托管 ExpressOA

在 Windows 11, Windows 10 上的托管方式：

l使用 Windows 服务托管 ExpressOA

ExpressOA® Lite 版本不需要下列步骤：

1.2 安装字体
1.3 安装依赖程序

（1）部署 ExpressOA 程序文件

1.1 下载 ExpressOA 3.x 程序包

www.paioffice.com/expressoa/downloads
解开 ExpressOA 程序包，移动 approot 到目标部署路径，例如 C:\ExpressOA。

1.2 安装字体

打开文件夹 fonts，全选所有字体文件，单击鼠标右键【为所有用户安装】。

重要提示

在 Windows Server 2022, 2019, 2016 上，全选所有字体文件，单击鼠标右键【为所有用户安装】。

在 Windows 11, Windows 10 上，全选所有字体文件，右键 >> 显示更多选项，找到【为所有用户安装】。

1.3 安装依赖程序

安装 Visual C++ 2010 Redistributable 依赖程序。
打开 ExpressOA 程序包 windows-prerequisites 文件夹，安装 vcredist_x86.exe。

1.4 设置 ExpressOA 目录结构的文件系统权限

Windows 用户组 Users 文件系统权限列表如下。

ExpressOA® Core ExpressOA® Lite

目录/文件

文件系统权限

chmod 权限

用途

/fonts

读取

444

字体文件

/license

完全控制

666

存储许可证文件

/runroot

读取和执行

555

应用程序目录结构

/storageRoot

完全控制

666

存储路径

/temp

完全控制

666

临时文件夹

certarchive.json

读取

444

数字存档（数字证书配置）

cloudstorage.json

读取

444

云存储配置

database.json

读取

444

配置数据库连接

（2）安装数据库 Microsoft SQL Server 或 PostgreSQL

ExpressOA 3.x 支持三种数据库。

lSQL Server 2022, 2019, 2017
lSQL Server Express 2022, 2019, 2017（免费商用）
lPostgreSQL 17, 16, 15, 14, 13, 12（免费商用）

2.1 安装 Microsoft SQL Server 或 PostgreSQL数据库

SQL Server 2022 下载
https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads
SQL Server 2022 Express 下载
https://www.microsoft.com/zh-cn/download/details.aspx?id=104781
SQL Server 管理工具下载
https://docs.microsoft.com/zh-cn/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver15

PostgreSQL 下载
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

2.2 使用 SQL Server 数据库

ExpressOA 程序包 database-sql-statements 文件夹下，包含创建数据库结构的 SQL 语句。

使用 SQL Server 管理器，新建数据库 ExpressOA（数据库名称可以自定义）。
使用 SQL Server 管理器，选择数据库 >> 属性 >> 选项，确认数据库排序规则为 Chinese_PRC_CI_AS（简体中文）。

使用 SQL Server 查询分析器，创建 ExpressOA 数据库结构（依次执行 SQL 语句 microsoft-sqlserver....sql）。
1、系统核心数据结构。

microsoft-sqlserver_core.sql

2、基本的演示工作流程（流程设计和表单模板）。

microsoft-sqlserver_demo.sql

3、可选。更多的演示工作流程（流程设计和表单模板）。

microsoft-sqlserver_workflow_sample.sql

2.3 如果使用 PostgreSQL 数据库。

ExpressOA 程序包 database-sql-statements 文件夹下，包含创建数据库结构的 SQL 语句。

使用 PostgreSQL - pgAdmin，创建 ExpressOA 数据库结构（依次执行 SQL 语句 postgresql....sql）。
1、系统核心数据结构。

postgresql_core.sql

2、基本的演示工作流程（流程设计和表单模板）。

postgresql_demo.sql

3、可选。更多的演示工作流程（流程设计和表单模板）。

postgresql_workflow_sample.sql

（3）配置 SQL Server 或 PostgreSQL 数据库连接

使用记事本打开 database.json 配置数据库连接信息。
使用 SQL Server 数据库：DatabaseType 为【空字符串】或【SQLServer】。
使用 PostgreSQL 数据库：DatabaseType 为【PostgreSQL】。

重要：在 json 配置文件中，使用两个 \\ 代表一个 \。

DatabaseType 为空，使用 SQLServer 数据库

{
  "DatabaseType": "",
  "ConnectionStrings": {
    "SQLServer": "database=ExpressOA;Data Source=localhost;User ID=sa;password=YourPassword;Connect Timeout=60",
    "PostgreSQL": "Database=ExpressOA;Host=localhost;Username=postgres;Password=YourPassword"
  }
}

使用 PostgreSQL 数据库

{
  "DatabaseType": "PostgreSQL",
  "ConnectionStrings": {
    "SQLServer": "database=ExpressOA;Data Source=localhost;User ID=sa;password=YourPassword;Connect Timeout=60",
    "PostgreSQL": "Database=ExpressOA;Host=localhost;Username=postgres;Password=YourPassword"
  }
}

SQL Server 知识点

在一台计算机上可以安装运行多个 SQL Server 实例。
实例又分为【默认实例】和【命名实例】，一台计算机上最多只有一个【默认实例】，【默认实例】没有特定的名称。
如果要访问 SQL Server【默认实例】，使用计算机名 | localhost | IP地址。
如果要访问 SQL Server【命名实例】，使用计算机名 | localhost | IP地址\\实例名称。

举例（1）SQL Server 作为缺省实例安装在本机，Data Source 如下：
localhost
举例（2）SQL Server Expres 安装在本机，实例名称为 "SQLEXPRESS"，Data Source 如下：
localhost\\SQLEXPRESS
举例（3）SQL Server 服务器 IP 地址为"10.1.2.3"，实例名称为 "MSSQL"，Data Source 如下：
10.1.2.3\\MSSQL

托管篇：

（1）Windows Server 使用 IIS 托管 ExpressOA 3.x

适用于 Windows Server 2022, 2019, 2016

（2）Windows 11, 10 使用 Windows 服务托管 ExpressOA 3.x

适用于 Windows 11, Windows 10