本文介绍了一种在金蝶软件中实现自动登录后自动打开特定单据的功能。对于7.x版本,介绍了不需要写入isoKey的启动插件方式,并提供了在主控插件中直接取数据的代码示例。同时,说明了如何通过URL传递参数,但建议通过WebApi存储大量数据以避免URL长度限制。对于6.x版本,提供了特定代码示例用于写入和获取客制化参数。此外,还指导了如何使用BOSIDE扩展主控台,并展示了注册二开插件以实现在登录后自动打开采购订单的实例,包括动态表单和表单列表的显示。最后,展示了测试效果。
自动登录后,实现自动打开某个单据的功能(实在很多二开同学在问,利用周末的时间给大家制作一个Demo如下)
(7.x方法的解决方案!【推荐】)
1、启动插件不需要写入isoKey(写入isoKey是6.x的过时方法,7.x不需要这样处理);
2、在主控插件已经支持直接取到数据(系统出厂主控无需下面代码);如果是二开主控,在AfterBindData事件中加入以下代码即可;
using Kingdee.BOS.Core;
this.View.OpenSpecFormsByStartArgs();
3、在具体打开的单据中, 通过下面代码即可取到所有参数;
using Kingdee.BOS.Authentication;
var args = this.View.OpenParameter.GetCustomParameter(FormConst.StartAppArgs) as StartAppHomePageArgs;
特别注意:由于仅仅通过URL进行传递参数,StartAppHomePageArgs中的自定义参数CustomArgs不能传递太多数据,建议预先通过WebApi存储数据到服务器,然后仅传递该数据的唯一索引即可,在具体单据业务插件中通过该唯一索引提取数据即可。
(下面代码适合6.x, 7.x也可用)
1,在启动自动登陆插件文章的第六部分的代码里面的[i]DoLoginCore(context, ret, pluginLoginInfo);[/i]方法调用完成后,编写如下代码,写入客制化参数:
(下面代码仅适合6.x,对于7.x不需要写这段代码)
[code]
//隔离参数键值
if (!string.IsNullOrWhiteSpace(ret.SessionId))
{
var isoKey = ret.SessionId + "_AutoLoginArgs";
//登陆成功后,加入自定义参数
HttpContext.Current.Application.Set(isoKey, "PUR_PurchaseOrder|100001");
}[/code]
实现URL自动登录的文章参考:
文章2: https://vip.kingdee.com/article/37406
文章1: https://vip.kingdee.com/article/25013
2,用BOSIDE打开【主控台经典版】BOS_MainConsoleSutra,做扩展后保存,如下图片操作:
3,在扩展后的【主控台经典版】BOS_MainConsoleSutra注册下面新建的二开插件:
using Kingdee.BOS.Core.Bill;
using Kingdee.BOS.Core.DynamicForm;
using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.List;
using Kingdee.BOS.Core.Metadata;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web;
namespace Kingdee.BOS.Test.PlugIn.Basic
{
public class Ext_HomePagePlugin : AbstractDynamicFormPlugIn
{
public override void AfterBindData(EventArgs e)
{
base.AfterBindData(e);
//隔离参数键值
var isoKey = this.Context.SessionId + "_AutoLoginArgs";
//获取客制化参数
var cargs = HttpContext.Current.Application.Get(isoKey) as string;
//清理Session
HttpContext.Current.Application.Remove(isoKey);
if (!string.IsNullOrWhiteSpace(cargs) && cargs.IndexOf('|') > 0)
{
var tmp = cargs.Split('|');
string pageId = Guid.NewGuid().ToString();
// 显示单据, 使用 BillShowParameter
var showParam = new BillShowParameter()
{
FormId = tmp[0],
PageId = pageId,
Status = OperationStatus.EDIT
};
showParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showParam.OpenStyle.TagetKey = "FMAINTAB";
// 传入需要单据内码
showParam.PKey = tmp[1];
this.View.ShowForm(showParam);
// 显示单据列表, 使用 ListShowParameter
var showListParam = new ListShowParameter()
{
FormId = tmp[0],
PageId = Guid.NewGuid().ToString()
};
showListParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showListParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showListParam.OpenStyle.TagetKey = "FMAINTAB";
this.View.ShowForm(showListParam);
}
// 显示动态表单, 使用 DynamicFormShowParameter
var showDyParam = new DynamicFormShowParameter()
{
FormId = "PUR_USERORDERPARAM",
PageId = Guid.NewGuid().ToString()
};
showDyParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showDyParam.OpenStyle.ShowType = ShowType.MainNewTabPage;
showDyParam.OpenStyle.TagetKey = "FMAINTAB";
this.View.ShowForm(showDyParam);
}
}
}
4,测试自动登陆后完美自动打开采购订单,如下图,自动登录后没有做任何操作的状态如下图:
普通表单
表单列表界面
动态表单界面