CloudHill Paas使用文档

CloudHill Paas使用文档

一. 概述

1.1 paas简介

  1.1.1 云山Paas平台旨在将通用业务代码提炼到Paas平台上，供各种业务线调用。
  解决了业务线可以随Paas平台的升级，保持Paas接口调用规则不变的情况下，
  动态且隐式升级服务能力。
  另外Paas平台基于.net core 3.1平台搭建，可以集中化管理并扩建其负载能力。

1.2 业务名词介绍

 1.2.1 壳体:Paas平台能力全面对外开放，但是对于云山常用业务线
 CMS，微信，测评、订单等需要后台前端页面或Api来说，需要有个壳体项目去调用Paas平台的功能。
 前端不需要直接调用Paas上的功能，
 也不需要后端每次都编写调用Paas的功能。
 所以如果新建项目的话，直接获取壳体项目，为提后台和前端提供能力。

 1.2.1 SDK:为了方便.net程序员进行Paas调用,提供了基于framework和core两种SDK调用途径。

1.3 ClientId和ClientSecret

 1.3.1 各个项目需要向管理员联系，管理员应提供Paas的ClientId和ClientSecret，
并配置对应业务线的Scope权限。
通过账密换取accesstoken后，即可调用对应Paas平台功能。

1.4 Paas文档及SDK

 1.4.1 Paas调用文档
 1.4.2 Neget包地址:请联系管理员
 1.4.3 PaasSDK(NetCore)Nuget包:CloudHill.PaaS.Identity4.NetCore
 1.4.4 PaasSDK(Framework)Nuget包:CloudHill.PaaS.Identity4.Framework

Paas调用文档

二.项目搭建（重点）

2.1 参考文章

 2.1.1 参考文章

基础项目创建文档

三.Sys相关

注:Sys目前得功能未集成在Paas中,暂时需要使用本地业务得Sys业务表

3.1 壳体安装

 3.1.1 Sys页面Nuget:CloudHill.SysWeb.NetCore
 3.1.2 Sys壳体Nuget:CloudHill.Sys.NetCore

静态页面壳体安装文档

3.2 基础配置

 3.2.1 appsettings.json配置:在appsettings.json加入Sys得对应数据库配置

"SysEntities": "Server=数据库IP;Database=数据库名称;User id=数据库IP;password=数据库密码",

 3.2.2 app.config配置:在app.config加入IOC配置

<GlobalInit>
            <Assemblys>
                    <Assembly name="Sys" value="CloudHill.Sys.NetCore" />
   			</Assemblys>
</GlobalInit>
<Unity>
            <Assemblys>
   				<Assembly name="Sys" value="CloudHill.Sys.NetCore" />
   			</Assemblys>
</Unity>

3.3 前端获取的能力

 3.3.1 备忘录中获取值列表的能力

备忘录中获取值列表的能力

四.Cms相关

4.1 壳体安装

 4.1.1 Cms页面Nuget:CloudHill.CmsWeb.NetCore
 4.1.2 Cms壳体Nuget:CloudHill.Cms.Paas.NetCore
 4.1.3 Startup.cs:在该文件夹加入如下代码,以便使用文本编辑器

静态页面壳体安装文档

//文本编辑器初始化
//注意要保留壳体项目中的config.json,该文件为为本编辑器配置文件
services.AddUEditorService();

4.2 基础配置

 4.2.1 app.config配置:在app.config加入IOC配置

<GlobalInit>
            <Assemblys>
                    <Assembly name="Cms" value="CloudHill.Cms.NetCore" />
   			</Assemblys>
</GlobalInit>
<Unity>
            <Assemblys>
   				<Assembly name="Cms" value="CloudHill.Cms.NetCore" />
   			</Assemblys>
</Unity>

4.3 前端获取的能力

 4.3.1 备忘录中上传文件的能力和广告获取能力

备忘录中上传文件的能力和广告获取能力

4.4 Cms配站语法

 4.4.1 新的配站语法相关示例

新的配站语法相关示例

五.Evaluation相关

5.1 壳体安装

 5.1.1 Evaluation页面Nuget:CloudHill.EvaluationWeb.Paas.NetCore
 5.1.2 Evaluation壳体Nuget:CloudHill.Evaluation.Paas.NetCore

静态页面壳体安装文档

5.2 基础配置

 5.2.1 app.config配置:在app.config加入IOC配置

<GlobalInit>
            <Assemblys>
                    <Assembly name="Evaluation" value="CloudHill.Evaluation.NetCore" />
   			</Assemblys>
</GlobalInit>
<Unity>
            <Assemblys>
   				<Assembly name="Evaluation" value="CloudHill.Evaluation.NetCore" />
   			</Assemblys>
</Unity>

5.3 前端获取的能力

 5.3.1 未提供直接调用能力。
       后续应直接获取试卷等应在壳体中补充,目前仍需要后端接入下SDK的功能

六.Weixin相关

6.1 壳体安装

 6.1.1 Weixin页面Nuget:CloudHill.WeiXinWeb.NetCore
 6.1.2 Weixin壳体Nuget:CloudHill.WeiXin.Paas.NetCore

静态页面壳体安装文档

6.2 基础配置

 6.2.1 app.config配置:在app.config加入IOC配置

<GlobalInit>
            <Assemblys>
                    <Assembly name="Weixin" value="CloudHill.Weixin.NetCore" />
   			</Assemblys>
</GlobalInit>
<Unity>
            <Assemblys>
   				<Assembly name="Weixin" value="CloudHill.Weixin.NetCore" />
   			</Assemblys>
</Unity>

6.3 前端获取的能力

 6.3.1 未提供直接调用能力。

七.Good相关

7.1 壳体安装

 7.1.1 Good页面Nuget:CloudHill.GoodWeb.NetCore
 7.1.2 Good壳体Nuget:CloudHill.Good.Paas.NetCore

静态页面壳体安装文档

7.2 基础配置

 7.2.1 app.config配置:在app.config加入IOC配置

<GlobalInit>
            <Assemblys>
                    <Assembly name="Good" value="CloudHill.Good.NetCore" />
   			</Assemblys>
</GlobalInit>
<Unity>
            <Assemblys>
   				<Assembly name="Good" value="CloudHill.Good.NetCore" />
   			</Assemblys>
</Unity>

7.3 前端获取的能力

 7.3.1 未提供直接调用能力。

注:其他非壳体类型的PAAS功能，可直接调用SDK进行使用