服务流程 调用星空企业版的单据 BOTP 下推操作

以费用报销单为例

一、请求参数说明： 

1.formid：业务对象表单Id，字符串类型（必录）

2.data：JSON格式数据（详情参考JSON格式数据）（必录）     

 2.1.Ids：单据内码集合，字符串类型，格式："Id1,Id2,..."（使用内码时必录）     

 2.2.Numbers：单据编码集合，数组类型，格式：[No1,No2,...]（使用编码时必录）    

 2.3.EntryIds：分录内码集合，逗号分隔（分录下推时必录） 注（按分录下推时，单据内码和编码不需要填,否则按整单下推）   

  2.4.RuleId：转换规则内码，字符串类型（未启用默认转换规则时，则必录）     

 2.5.TargetBillTypeId：目标单据类型内码，字符串类型（非必录）    

 2.6.TargetOrgId：目标组织内码，整型（非必录）     

 2.7.TargetFormId：目标单据FormId，字符串类型，（启用默认转换规则时，则必录）   

  2.8.IsEnableDefaultRule：是否启用默认转换规则，布尔类型，默认false（非必录）   

  2.9.IsDraftWhenSaveFail：保存失败时是否暂存，布尔类型，默认false（非必录）  注（暂存的单据是没有编码的）       2.10.CustomParams：自定义参数，字典类型，格式："{key1:value1,key2:value2,...}"（非必录）  注（传到转换插件的操作选项中，平台不会解析里面的值） 

 二、返回结果： {"Result":{"ResponseStatus":{"ErrorCode":"","IsSuccess":"false","Errors":[{"FieldName":"","Message":"","DIndex":0}],"SuccessEntitys":[{"Id":"","Number":"","DIndex":0}],"SuccessMessages":[{"FieldName":"","Message":"","DIndex":0}],"MsgCode":""},"ConvertResponseStatus":{"ErrorCode":"","IsSuccess":"false","Errors":[{"FieldName":"","Message":"","DIndex":0}],"SuccessEntitys":[{"Id":"","Number":"","DIndex":0}],"SuccessMessages":[{"FieldName":"","Message":"","DIndex":0}],"MsgCode":""}}} 

备注： ConvertResponseStatus 返回的是单据转换的结果，ResponseStatus 返回的是单据转换后下游单据保存的结果 

 三、代码示例： // 引用SDK组件Kingdee.BOS.WebApi.Client.dll；SDK下载地址：https://openapi.open.kingdee.com/ApiSdkCentervar client = new K3CloudApi(); // 初始化登录认证，appID、appSec可在"第三方系统登录授权"中获取 client.InitClient("abcd", "appID", "appSec", "userName", 2052, "100", "url"); 

client.Push("ER_ExpReimbursement","{"Ids":"","Numbers":[],"EntryIds":"","RuleId":"","TargetBillTypeId":"","TargetOrgId":0,"TargetFormId":"","IsEnableDefaultRule":"false","IsDraftWhenSaveFail":"false","CustomParams":{}}");

上述是星空企业版WebApi对费用报销单 ER_ExpReimbursement 下推的api介绍

那么在集成云的服务流程里如何调用这个下推API呢

首先服务流程的流程属性先引入进来星空企业版的数据源 别名设置为 H763

那么在服务流程的脚本里 就可以这样调用下推操作

var action="Push";//下推动作
var data={  //该参数请参考星空webapi的介绍
		"Ids":"",
		"Numbers":[

		],
		"EntryIds":"",
		"RuleId":"",
		"TargetBillTypeId":"",
		"TargetOrgId":0 ,
		"TargetFormId":"",
		"IsEnableDefaultRule":"false",
		"IsDraftWhenSaveFail":"false",
		"CustomParams":
			{

			}
	};
var params={"#data":
[
  "ER_ExpReimbursement",//费用报销单的formid
   String.FormatJson(data)
]};
var  res= $service(H763,action, params).result;// H763 是服务流程的流程属性引入的星空数据源别名