元对象嵌入看板 - .Net 平台应用与技巧

# 一、概述
如大家所知，平台的云看板设计器可以快速实现看板的设计，再通过看板项的相关配置，就可以实现看板的发布。有时候我们需要在元对象的MainView里面添加一些图表，下面就为大家介绍一种看板图表的嵌入方法。

# 二、应用实例
1. 安灯异常操作记录
在MainView中嵌入图表，展示每个状态耗时时长占比及操作时序。
![](/media//202305/2023-05-25_153727.png)
2. 维修操作记录
在MainView中嵌入图表，展示每个状态耗时时长占比及操作时序。
![](/media//202305/2023-05-25_153935.png)

# 三、实现步骤
**1. 设计看板并配置看板项、看板对象**
![](/media//202305/2023-05-25_154714.png)

**2. 在元对象中引用OrBitUserDialog.dll，并配置需要嵌入的看板对象，添加看板用户，否则无权限加载看板**
[dll引用及看板配置]
![](/media//202305/2023-05-25_154324.png)

**3. 元对象脚本编写**
[参数定义]
PS：若元对象未配置看板项，则isWebView为false，将不会加载看板。
![](/media//202305/2023-05-25_160120.png)
````csharp
	bool isWebView = false;
	bool isAdd = true;
	bool isNavigate = true;
	string webUid = Guid.NewGuid().ToString();
	string sourceUrl = @"http://121.37.203.18/CloudKB_Dev/#/login?	platform=2&user=%OrBitUser%&token=%UserTicket%";
	string kanbanId = ""; // 看板Id
	string time = "0"; // 刷新秒数
	string refresh = ""; //页面刷新时间
	string navigateUrl = @"http://121.37.203.18/CloudKB_Dev/?id={0}#/web?id={1}&time=	{2}&refresh={3}&type=1&user=%OrBitUser%&customParam=";
````
[公用方法]
````csharp
		#region GetMainViewKanbanId() 获取看板Id
		/// <summary>
		/// 获取看板Id
		/// </summary>
		/// <returns></returns>
		private bool GetMainViewKanbanId()
        {
			string sql = @"	SELECT	SMD.MainViewKanbanId,KB.RefreshTime,KB.PageRefreshTime
							FROM	dbo.SysMetadata SMD
							INNER JOIN dbo.KanBan KB ON KB.KanBanId = SMD.MainViewKanbanId
							WHERE SMD.MetadataName = '{0}'";
			sql = string.Format(sql,Scripter.MetaObjectName);
			
			DataSet ds = Scripter.GetSqlDataSet(sql);
			Scripter.Debug.PrintG(sql);
			if(ds != null & ds.Tables.Count > 0 & ds.Tables[0].Rows.Count > 0)
			{
				kanbanId = ds.Tables[0].Rows[0][0].ToString();
				Scripter.Debug.PrintR(kanbanId);
				time = ds.Tables[0].Rows[0][1].ToString();
				refresh = ds.Tables[0].Rows[0][2].ToString();
				
				return true;
			}
			
            return false;
        }
		#endregion
		
		#region WebView看板操作
		/// <summary>
		/// 设置Source，看板免登录
		/// </summary>
		private void WebViewSource()
		{
			if(isAdd)
			{
				sourceUrl = Scripter.GetOrBitUrl(sourceUrl);
				bool flag = Scripter.OBUD_WebBrowserAdd(0,webUid,sourceUrl,DockStyle.Fill,800,320);
				isAdd = !flag;
				Scripter.Debug.PrintG("sourceUrl "+sourceUrl);
				
				Scripter.TreeViewRefresh();
			}
		}
		
		/// <summary>
		/// 导航Url，刷新看板
		/// </summary>
		/// <param name="ParentPKId"></param>
		private void WebViewNavigate(string ParentPKId)
		{
			if( isNavigate & !string.IsNullOrEmpty(ParentPKId) )
			{
				string url = Scripter.GetOrBitUrl( string.Format(navigateUrl,ParentPKId,kanbanId,99999999,refresh)+ParentPKId );
				Scripter.Debug.PrintG("navigateUrl "+url);
				bool flag = Scripter.OBUD_WebBrowserNavigate(webUid,null,url);
				isNavigate = !flag;
				// 失败，则刷新触发重新加载一次
				if(isNavigate) Scripter.OBUD_WebBrowserNavigate(webUid,null,url);
					
				Scripter.Debug.PrintG("flag "+flag.ToString());
			}
		}
		#endregion
````
[看板免登录]
![](/media//202305/2023-05-25_155455.png)

[加载看板内容]
![](/media//202305/2023-05-25_155607.png)

[看板对象释放]
![](/media//202305/2023-05-25_155858.png)

# 四、升级说明（目前只支持R16）
1、更新Broswer目录下的exe文件
[【附件】BrowserR16_5_20.rar](/media/attachment/2023/05/BrowserR16_5_20.rar)
2、更新Plugin目录下的OrBitScript.dll和OrBitUserDialog.dll。其中OrBitScript.dll新增url转换的方法GetOrBitUrl，OrBitUserDialog.dll新增WebView2控件的添加和Source设置和url导航。
[【附件】R16dll_KB.rar](/media/attachment/2023/05/R16dll_KB.rar)