6.x升级到6.6的升级说明(.NetCore)

1. 在此项目的“依赖项-包-管理NuGet程序包”中搜索到“Zhuozhengsoft.PageOffice"程序后安装6.6.1.3及以上版本。

2. 拷贝PageOffice客户端安装程序将posetup_6.6.1.3.exe和com.zhuozhengsoft.pageoffice_6.6.1.3_amd64.deb等程序包到项目的bin目录下（项目的生成目录，比如：bin\Debug\net6.0）。

注意

Pageoffice客户端版本号必须与上一步在nuget中安装的PageOffice服务器端程序版本号保持一致

3. 新增对PowServer相关配置。

   • 如果是.Net6及以上版本，在 Program.cs 中新增如下配置：

     ...
     // PageOffice V6.6及以上版本新增以下配置，V6.5及之前版本无需此代码 
     builder.Services.AddPageOfficePowServer();
     ...
         
     //特别注意：这三句配置代码必须放app.UseRouting()前面   
     app.UsePageOfficePowServer();// PageOffice V6.6及以上版本新增配置
     app.UseMiddleware<PageOfficeNetCore.POServer.ServerHandlerMiddleware>(); 
     app.UseMiddleware<PageOfficeNetCore.POServer.AdminSealHandlerMiddleware>();
     
     app.UseRouting();
     ...
     

   • 如果是.Net5版本，在 Startup.cs 中新增如下配置：

     1. 在ConfigureServices方法中配置PowServer服务

     public void ConfigureServices(IServiceCollection services)
     {
          ...
         //PageOffice V6.6及以上版本新增以下配置，V6.5及之前版本无需此代码 
         services.AddPageOfficePowServer();
     }
     

     2. 在Configure方法中配置PowServer服务

     public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
     {
         ....
     
         //特别注意：这三句配置代码必须放app.UseRouting()前面
         app.UsePageOfficePowServer();// PageOffice V6.6及以上版本新增配置
         app.UseMiddleware<PageOfficeNetCore.POServer.ServerHandlerMiddleware>();
         app.UseMiddleware<PageOfficeNetCore.POServer.AdminSealHandlerMiddleware>();
     
         app.UseRouting();
         ....
     }
     

4.新增对powserver添加跨域配置。在当前项目的appsettings.json中添加：

  // PowServer跨域安全配置：
  // 1. 生产环境不推荐使用"*"，建议明确指定允许的域名/IP
  // 2. 格式：多个地址用逗号分隔，如"域名1,域名2,IP"。注意：本地开发环境地址(localhost,127.0.0.1)也必须在此配置
  // 3. 示例：
  //    - 前后端分离："前端域名地址,前端IP地址,后端地址"
  //      示例："ui.example.com,192.168.1.100,localhost"
  //    - 单体多入口："域名,IP"
  //      示例："www.oa.com,192.168.1.200"
  "powserver-allowedOrigins": "*",

5.为 powserver 请求配置完全开放访问权限。请参照 poserver.zz 已有的开放配置，将 powserver 加入免认证路径列表。比如在当前项目的Program.cs文件中添加：

app.MapGet("poserver.zz", () => "poserver.zz").AllowAnonymous();
// 新增为powserver路径配置免认证访问
app.MapGet("powserver", () => "powserver").AllowAnonymous();

部署阶段：

nginx部署时，新增支持WebSocket的配置。详细步骤可参考：Nginx普通部署(v6.6+)

集群部署阶段：

集群（负载均衡）部署时，比如nginx集群部署时，新增支持WebSocket的配置。详细步骤可参考：Nginx集群部署(v6.6+)