预算报表创建接口说明

（仅支持客户端方式预算报表，暂不支持H5端预算报表)

一、接口说明：

预算报表自动创建提供了三个接口，

GetBudgetReport：自动创建预算报表，单元格默认值0，创建成功后，返回新创建或已存在的预算报表ID，及表页的单元格数据格式，用于填充报表数值；

FillBudgetReport：按照报表表页的单元格格式，填充新创建报表的单元格值；

ImportBudgetReport：引入Excel文件填充报表数值。

导入命名空间：

Kingdee.K3.FIN.BM.App.Core.CommonService

Kingdee.K3.FIN.BM.ServiceHelper.BMCommonServiceHelper

Kingdee.K3.FIN.BM.Common.BusinessEntity.BudgetReportEntity

Kingdee.K3.FIN.BM.Common.BusinessEntity.DimsionTypeEntity

Kingdee.K3.FIN.BM.Common.BusinessEntity.DimFilldWay

Kingdee.K3.FIN.BM.Common.BusinessEntity.ImportExcelType

Kingdee.K3.FIN.ReportEntity.PivotGrid.PivotGridCellValue

/// 预算报表自动创建

bool  GetBudgetReport(Context  ctx,  //上下文环境

BudgetReportEntity  budgetReportEntity,  //报表头信息

Dictionary<string, Dictionary<int, DimsionTypeEntity>>  dimValueDic,  

                              //表页控制维度填充值key:表页名称value:[key]报告维度类别ID

Dictionary<string, DimFilldWay>  sheetFillWayDic, 

                              //表页控制维度组合填充方式key:表页名称

List<string>  lstSheetNames,  //表页名称

out Dictionary<string, List<FIN.ReportEntity.PivotGrid.PivotGridCellValue>>  sheetValueDic,

                             //返回创建成功报表的表页单元格数据key:表页名称

out List<string>  lstErrors,   //错误提示

bool isReCreateReport =  false,  //是否重新填充已存在报表

bool isReFillDimension =  false);  //是否重新填充控制维度

/// 预算报表自动填充单元格值       

bool  FillBudgetReport(Context  ctx,  //上下文环境

BudgetReportEntity  budgetReportEntity,   //报表头信息

List<string>  lstSheetNames,   //表页名称

Dictionary<string, List<FIN.ReportEntity.PivotGrid.PivotGridCellValue>>  sheetValueDic,

                              //表页填充单元格数据key:表页名称

out List<string>  lstErrors);  //错误提示

/// 预算报表Excel填充       

bool  ImportBudgetReport(Context  ctx,  //上下文环境

BudgetReportEntity  budgetReportEntity,   //报表头信息

System.IO.FileStream  fstream,   //引入Excel文件

ImportExcelType excelType,  //引入Excel文件类型

Dictionary<string, DimFilldWay>  selectFillWayDic,  

                              //表页引入控制维度组合填充方式key:表页名称

out List<string>  lstErrors);  //错误提示

二、测试试例：

发布或二开调用”报表创建接口界面”，

首先选择预算模板、预算组织、预算方案、年度、期间等报表头信息，可以创建空维度值的预算报表；预算维度单据体选择维度值，可以填充报表预算维度。

其次，预算报表创建成功后，接口返回报表ID、表页单元格数据格式，可以按照返回的表页单元格数据格式进行数据赋值、或引入Excel数据，填充报表数值；

三、实体定义：

    /// 报表实体

    public class BudgetReportEntity

    {

        [必录]

        public string ID ; /// 报表ID

        public string SampleID ; /// 预算模板ID

        public long EntryOrgId ; /// 预算组织ID

        public int SchemeID ; /// 预算方案ID

        public int Year ; /// 年度

        public int Period ; /// 期间

        public int CurrencyID ; /// 币别

        public int BwbCurrencyId ; /// 综合本位币币别

        public string ReportType ;/// 报表类型

        public int DimensionType_Id ; /// 主维度类别ID

        public int DimensionId; /// 维度值ID(基础资料)

        public string  AssistantId ; /// 维度值ID(辅助资料)

        [默认值]

        public string CycleID ;/// 周期

        public int AmountunitID ; /// 金额单位

        …………

    }

    ///维度填充值对象

    public class DimsionTypeEntity

    {

        public List<DimsionValueEntity> DimsionValueEntityList { get; set; }

                    /// 维度填充值集合

        …………

    }

    ///维度填充值对象

    public class DimsionValueEntity

    {

        [关键标识]

        public string DimsionId ; /// 维度ID

        [保留]

        public string DimsionName ; /// 维度名称

        public string DimsionNumber ; /// 维度编码

    }

    /// 预算报表维度填充方式

    public enum DimFilldWay

    {

        CrossFillWay = 0, /// 笛卡尔积方式

        GroupFillWay = 1, /// 组合排列

    }

    /// 透视表单元格数据

    public class PivotGridCellValue

    {

        [关键标识]

        public string Key; /// 单元格标示：期间类型_期间_数据类型_维度[唯一标识]

        public CycleType PeriodType ; /// 期间周期类型，如：