~kyy/LB_MesClient.git

tjx

2025-10-24 cd6496f2fadb885056c35a67fb3caf1a1a765ab1

补充文档

已修改2个文件

已添加1个文件

	DevApp/Gs.DevApp/DevFrm/QC/Frm_MesQaItemsDetect01.Designer.cs	8 ●●●●● 补丁 \| 查看 \| 原始文档 \| blame \| 历史
	DevApp/Gs.DevApp/DevFrm/Rk/Frm_MesInvItemArn.cs	37 ●●●●● 补丁 \| 查看 \| 原始文档 \| blame \| 历史
	DevApp/Gs.DevApp_Onboarding.md	48 ●●●●● 补丁 \| 查看 \| 原始文档 \| blame \| 历史

 DevApp/Gs.DevApp/DevFrm/QC/Frm_MesQaItemsDetect01.Designer.cs

@@ -777,7 +777,7 @@
            this.gridColumn17.Width = 94;
            // 
            // gridColumn23
            //
            // 
            this.gridColumn23.Caption = "éè´åå·";
            this.gridColumn23.FieldName = "cgdNo";
            this.gridColumn23.MinWidth = 25;
@@ -785,9 +785,9 @@
            this.gridColumn23.Visible = true;
            this.gridColumn23.VisibleIndex = 22;
            this.gridColumn23.Width = 94;
            //
            // 
            // gridColumn_cgdCreate
            //
            // 
            this.gridColumn_cgdCreate.Caption = "éè´è®¢ååå»ºäºº";
            this.gridColumn_cgdCreate.FieldName = "cgdCreate";
            this.gridColumn_cgdCreate.MinWidth = 25;
@@ -795,7 +795,7 @@
            this.gridColumn_cgdCreate.Visible = true;
            this.gridColumn_cgdCreate.VisibleIndex = 23;
            this.gridColumn_cgdCreate.Width = 100;
            //
            // 
            // gridColumn30
            // 
            this.gridColumn30.Caption = "ç±»å";

 DevApp/Gs.DevApp/DevFrm/Rk/Frm_MesInvItemArn.cs

@@ -43,6 +43,8 @@
           }, tips);
            // æ·»å gridView1çRowStyleäºä»¶ï¼å½éè´§æ è¯th=1æ¶æ´è¡æ çº¢
            gridView1.RowStyle += GridView1_RowStyle;
            // æ·»å gvMx1çRowStyleäºä»¶ï¼å½å¤çæè§clyjä¸º"éè´§"æ¶æ´è¡æ çº¢
            gvMx1.RowStyle += GvMx1_RowStyle;
            Gs.DevApp.ToolBox.UtilityHelper.SetTabParameter(gridView1, xtraTabControl1, pageBar1, (value) =>
            {
                getModel(value);
@@ -141,6 +143,8 @@
                        gvMx1.BestFitColumns();
                        Gs.DevApp.ToolBox.UtilityHelper.SetGridLayout(gvMx1);
                        ConfigureOaColumns();
                        // å·æ°è§å¾æ ·å¼ï¼ä½¿RowStyleäºä»¶çæ
                        gvMx1.RefreshData();
                    }
                    catch (Exception ex)
                    {
@@ -176,6 +180,37 @@
                    {
                        e.Appearance.BackColor = System.Drawing.Color.Red;
                        e.Appearance.ForeColor = System.Drawing.Color.White;
                    }
                }
            }
        }

        /// <summary>
        /// gvMx1çRowStyleäºä»¶ï¼å½å¤çæè§clyjä¸º"éè´§"æ¶æ´è¡æ çº¢
        /// </summary>
        private void GvMx1_RowStyle(object sender, RowStyleEventArgs e)
        {
            if (e.RowHandle >= 0)
            {
                var view = sender as GridView;
                if (view != null)
                {
                    try
                    {
                        var clyjValue = view.GetRowCellValue(e.RowHandle, "clyj");
                        if (clyjValue != null && !string.IsNullOrEmpty(clyjValue.ToString()))
                        {
                            string clyj = clyjValue.ToString().Trim();
                            if (clyj == "éè´§")
                            {
                                e.Appearance.BackColor = System.Drawing.Color.Red;
                                e.Appearance.ForeColor = System.Drawing.Color.White;
                            }
                        }
                    }
                    catch
                    {
                        // å¦æåä¸åå¨ï¼å¿½ç¥éè¯¯
                    }
                }
            }
@@ -583,6 +618,8 @@
                        gvMx1.BestFitColumns();
                        Gs.DevApp.ToolBox.UtilityHelper.SetGridLayout(gvMx1);
                        ConfigureOaColumns();
                        // å·æ°è§å¾æ ·å¼ï¼ä½¿RowStyleäºä»¶çæ
                        gvMx1.RefreshData();
                    }
                    else
                    {

 DevApp/Gs.DevApp_Onboarding.md

¶Ô±ÈÐÂÎÄ¼þ
@@ -0,0 +1,48 @@
# Gs.DevApp å¿«éä¸ææå

## ç®å½éè§
- `DevFrm/`ï¼åä¸å¡æ¨¡åç WinForms çªä½ï¼ä¾å¦ `BasicData/Frm_MesWorkshopLine.cs`ã`QC/Frm_FqcDetect01.cs`ãæææ¥è¯¢ä¸ CRUD å¥å£é½å¨è¿äºçªä½éã
- `ToolBox/UtilityHelper.cs`ï¼éç¨æ¹æ³åºï¼åå« HTTP è°ç¨ãè¡¨æ ¼ç¿»é¡µãæ§ä»¶å¯ç¨æ§å¶çã
- `ToolBox/MsgHelper.cs`ï¼ç»ä¸çæ¶æ¯æç¤ºå°è£ã
- `Entity/`ï¼æ¥å£äº¤äºæ¨¡åï¼ä¾å¦ `PageQueryModel`ã`ReturnModel<T>`ï¼ç¨äºåé¡µ/è¿åå¼è§£æã
- `UserControl/UcToolBarMenu.cs`ï¼å·¥å·æ¡æ§ä»¶ï¼å®ä¹äº `btnAddClick`ã`btnSaveClick` çåºå®äºä»¶ã

## æ¥è¯¢åºå®å¥å£ï¼getPageList
1. è§¦åé¾è·¯ï¼`pageBar1.PagerEvent`ã`toolBarMenu1.btnLoadClick`ã`toolBarMenu1.btnQueryClick` æç»é½ä¼è°ç¨ `getPageList(int curPage)`ï¼åè§ `DevFrm\BasicData\Frm_Customer.cs:36`ï¼ã
2. æ¹æ³å¿åä¸ä»¶äºï¼
   - æé  `PageQueryModel` å¹¶åºååï¼`new PageQueryModel(curPage, pageBar1.RowsCount, sortName, "asc", "", UtilityHelper.GetSearchWhere(_filterList))`ã
   - è°ç¨æ¥å£ï¼`UtilityHelper.HttpPost("", _webServiceName + "GetListPage", json)`ã
   - è§£æå¹¶ç»å®ï¼`UtilityHelper.ReturnToTablePage(strReturn)` â ç»å®å° `gcMain1`ï¼åæ¥ `pageBar1.TotalPages/RecordCount`ã
3. å¦æè¦æ¹æ¥è¯¢æ¡ä»¶ï¼æ¥ `_filterList` çæå»ºæµç¨ï¼`UtilityHelper.GetDilter` + `ShowFilter` èªå®ä¹çéï¼ã

## æç»å è½½ï¼getModel
- åæ¢å°æç»é¡µææ§è¡ç¼è¾æ¶ï¼`UtilityHelper.SetTabParameter` ä¼æèµ· `getModel(string guid)`ã
- è¯¥æ¹æ³è°ç¨ `_webServiceName + "GetModel"`ï¼éè¿ `UtilityHelper.SetValueByObj(layoutMx1.Controls, data, isEdit)` ç»æ§ä»¶åå¡«ï¼å½ `toolBarMenu1.currentAction == "edit"` æ¶åè®¸ç¼è¾ã
- è¥çå°âæç»ä¸å·æ°âï¼åç¡®è®¤ `lbGuid` æ¯å¦èµå¼ã`toolBarMenu1.currentAction` æ¯å¦è¢«éç½®ã

## æ°å¢/ç¼è¾/ä¿å
- å¥å£ç»ä¸ç»å®å¨çªä½æé å½æ°ä¸ï¼
  - `btnAddClick`ï¼`UtilityHelper.CleanValueByControl(layoutMx1.Controls, true)` æ¸ç©ºæ§ä»¶ï¼`JumpTab(xtraTabControl1, 4)` åå°ç¼è¾é¡µã
  - `btnEdtClick`ï¼`UtilityHelper.GetCurrentRow(...)` è¯»åå½åè¡ï¼`ChangeEnableByControl(..., true)` å¼å¯ç¼è¾ã
  - `btnSaveClick`ï¼ç»è£å¿åå¯¹è±¡ï¼éå¸¸å« `Guid = UtilityHelper.ToGuid(lbGuid.Text)`ï¼ï¼ç¶å `UtilityHelper.HttpPost("", _webServiceName + "EditModel", json)`ãæååæ¸é¤ `currentAction`ã`ChangeEnableByControl(..., false)` å¹¶æç¤ºã
- å¸¸è§æ ¡éªä¸æé®ç¶æååå¨ `ToolBarMenu1_btnSaveClick` åï¼ç´æ¥å¨å¯¹åºçªä½éè°æ´ã

## å é¤ä¸å·æ°
- å é¤åºå®å¨ `toolBarMenu1.btnDelClick`ï¼å¦ `DevFrm\BasicData\Frm_MesWorkshopLine.cs:200`ï¼ï¼
  - éè¿ `UtilityHelper.GetCurrentRow` æ¿ Guid â `MsgHelper.AskQuestion` äºæ¬¡ç¡®è®¤ â è°ç¨ `_webServiceName + "DeleteModel"`ã
  - æååéå¸¸ `getPageList(pageBar1.CurrentPage)` éæ°æååè¡¨ã
- å·æ°æé® `btnLoadClick` é»è®¤å¤æå½åé¡µç¾ï¼å¨æç»é¡µæ§è¡ `getModel(lbGuid.Text)`ï¼å¦ååå° `getPageList`ã

## å¸¸ç¨å·¥å·æ¹æ³éæ¥
- `UtilityHelper.HttpPost`ï¼ç»ä¸çæ¥å£è¯·æ±ï¼èªå¨å `App.config` ä¸ç `WebApiUrl`ï¼è°è¯æ¶å¯åæå° `_webServiceName` ç¡®è®¤ URLã
- `UtilityHelper.ReturnToTablePage` / `ReturnToDynamic`ï¼ææ¥å£ JSON è½¬ä¸º `ReturnModel<T>`ï¼å½åè¡¨æ¸²æå¼å¸¸æ¶é¦éæ£æ¥ `rtnCode` ä¸ `rtnMsg`ã
- `UtilityHelper.GetSearchWhere`ï¼æ `FilterEntity` æ¼æ SQL çæ®µï¼ä½äº `ToolBox/UtilityHelper.cs` 1679 è¡éè¿ã
- `UtilityHelper.JumpTab` / `SetGridViewParameter` / `SetTabParameter`ï¼è´è´£åè¡¨ä¸æç»é¡µçèå¨ï¼è¥ç¿»é¡µæåå»è¡ä¸ºå¤±æï¼åçè¿äºè®¾ç½®æ¯å¦è¢«è°ç¨ã
- `UtilityHelper.ChangeEnableByControl`ã`SetValueByObj`ã`CleanValueByControl`ï¼è¡¨åæ§ä»¶æ¹éèµå¼/ç¦ç¨çé¦é APIã
- `ToolBox.MsgHelper`ï¼æå¸¦ç»ä¸æ ·å¼çæç¤ºçªï¼é¿åç´æ¥ä½¿ç¨ `MessageBox.Show`ã

## è°è¯å°è´´å£«
- ä¸ç¥éæåè½å¨åªä¸ªçªä½ï¼ä½¿ç¨ `rg "MesXxxManager"` æ `rg "btnSaveClick"` å¿«éå®ä½ã
- æææ¥è¯¢é½å½åä¸º `getPageList`ï¼å°å gï¼ï¼æä»¥ `rg "getPageList"` è½ä¸æ¬¡çæ¸ææçªä½çåé¡µå®ç°ã
- `_webServiceName` åæ®µæååç«¯æ§å¶å¨åç¼ï¼å¦ `"MesWorkshopLineManager/"`ï¼ï¼å®ä½æ¥å£æ¶åªéç»å `GetListPage`ã`GetModel`ã`EditModel`ã`DeleteModel`ã
- å·¥å·æ¡æææé®äºä»¶çåå§å®ä¹å¨ `UserControl/UcToolBarMenu.cs`ï¼å¦æéè¦æ°å¢æé®æææ¥ç¦ç¨é»è¾ï¼å¯ä»¥ä»è¿éä¸æã

			@@ -777,7 +777,7 @@
			this.gridColumn17.Width = 94;
			//
			// gridColumn23
			//
			//
			this.gridColumn23.Caption = "éè´åå·";
			this.gridColumn23.FieldName = "cgdNo";
			this.gridColumn23.MinWidth = 25;
			@@ -785,9 +785,9 @@
			this.gridColumn23.Visible = true;
			this.gridColumn23.VisibleIndex = 22;
			this.gridColumn23.Width = 94;
			//
			//
			// gridColumn_cgdCreate
			//
			//
			this.gridColumn_cgdCreate.Caption = "éè´è®¢ååå»ºäºº";
			this.gridColumn_cgdCreate.FieldName = "cgdCreate";
			this.gridColumn_cgdCreate.MinWidth = 25;
			@@ -795,7 +795,7 @@
			this.gridColumn_cgdCreate.Visible = true;
			this.gridColumn_cgdCreate.VisibleIndex = 23;
			this.gridColumn_cgdCreate.Width = 100;
			//
			//
			// gridColumn30
			//
			this.gridColumn30.Caption = "ç±»å";

			@@ -43,6 +43,8 @@
			}, tips);
			// æ·»å gridView1çRowStyleäºä»¶ï¼å½éè´§æ è¯th=1æ¶æ´è¡æ çº¢
			gridView1.RowStyle += GridView1_RowStyle;
			// æ·»å gvMx1çRowStyleäºä»¶ï¼å½å¤çæè§clyjä¸º"éè´§"æ¶æ´è¡æ çº¢
			gvMx1.RowStyle += GvMx1_RowStyle;
			Gs.DevApp.ToolBox.UtilityHelper.SetTabParameter(gridView1, xtraTabControl1, pageBar1, (value) =>
			{
			getModel(value);
			@@ -141,6 +143,8 @@
			gvMx1.BestFitColumns();
			Gs.DevApp.ToolBox.UtilityHelper.SetGridLayout(gvMx1);
			ConfigureOaColumns();
			// å·æ°è§å¾æ ·å¼ï¼ä½¿RowStyleäºä»¶çæ
			gvMx1.RefreshData();
			}
			catch (Exception ex)
			{
			@@ -176,6 +180,37 @@
			{
			e.Appearance.BackColor = System.Drawing.Color.Red;
			e.Appearance.ForeColor = System.Drawing.Color.White;
			}
			}
			}
			}

			/// <summary>
			/// gvMx1çRowStyleäºä»¶ï¼å½å¤çæè§clyjä¸º"éè´§"æ¶æ´è¡æ çº¢
			/// </summary>
			private void GvMx1_RowStyle(object sender, RowStyleEventArgs e)
			{
			if (e.RowHandle >= 0)
			{
			var view = sender as GridView;
			if (view != null)
			{
			try
			{
			var clyjValue = view.GetRowCellValue(e.RowHandle, "clyj");
			if (clyjValue != null && !string.IsNullOrEmpty(clyjValue.ToString()))
			{
			string clyj = clyjValue.ToString().Trim();
			if (clyj == "éè´§")
			{
			e.Appearance.BackColor = System.Drawing.Color.Red;
			e.Appearance.ForeColor = System.Drawing.Color.White;
			}
			}
			}
			catch
			{
			// å¦æåä¸åå¨ï¼å¿½ç¥éè¯¯
			}
			}
			}
			@@ -583,6 +618,8 @@
			gvMx1.BestFitColumns();
			Gs.DevApp.ToolBox.UtilityHelper.SetGridLayout(gvMx1);
			ConfigureOaColumns();
			// å·æ°è§å¾æ ·å¼ï¼ä½¿RowStyleäºä»¶çæ
			gvMx1.RefreshData();
			}
			else
			{

¶Ô±ÈÐÂÎÄ¼þ
			@@ -0,0 +1,48 @@
			# Gs.DevApp å¿«éä¸ææå

			## ç®å½éè§
			- `DevFrm/`ï¼åä¸å¡æ¨¡åç WinForms çªä½ï¼ä¾å¦ `BasicData/Frm_MesWorkshopLine.cs`ã`QC/Frm_FqcDetect01.cs`ãæææ¥è¯¢ä¸ CRUD å¥å£é½å¨è¿äºçªä½éã
			- `ToolBox/UtilityHelper.cs`ï¼éç¨æ¹æ³åºï¼åå« HTTP è°ç¨ãè¡¨æ ¼ç¿»é¡µãæ§ä»¶å¯ç¨æ§å¶çã
			- `ToolBox/MsgHelper.cs`ï¼ç»ä¸çæ¶æ¯æç¤ºå°è£ã
			- `Entity/`ï¼æ¥å£äº¤äºæ¨¡åï¼ä¾å¦ `PageQueryModel`ã`ReturnModel<T>`ï¼ç¨äºåé¡µ/è¿åå¼è§£æã
			- `UserControl/UcToolBarMenu.cs`ï¼å·¥å·æ¡æ§ä»¶ï¼å®ä¹äº `btnAddClick`ã`btnSaveClick` çåºå®äºä»¶ã

			## æ¥è¯¢åºå®å¥å£ï¼getPageList
			1. è§¦åé¾è·¯ï¼`pageBar1.PagerEvent`ã`toolBarMenu1.btnLoadClick`ã`toolBarMenu1.btnQueryClick` æç»é½ä¼è°ç¨ `getPageList(int curPage)`ï¼åè§ `DevFrm\BasicData\Frm_Customer.cs:36`ï¼ã
			2. æ¹æ³å¿åä¸ä»¶äºï¼
			- æé `PageQueryModel` å¹¶åºååï¼`new PageQueryModel(curPage, pageBar1.RowsCount, sortName, "asc", "", UtilityHelper.GetSearchWhere(_filterList))`ã
			- è°ç¨æ¥å£ï¼`UtilityHelper.HttpPost("", _webServiceName + "GetListPage", json)`ã
			- è§£æå¹¶ç»å®ï¼`UtilityHelper.ReturnToTablePage(strReturn)` â ç»å®å° `gcMain1`ï¼åæ¥ `pageBar1.TotalPages/RecordCount`ã
			3. å¦æè¦æ¹æ¥è¯¢æ¡ä»¶ï¼æ¥ `_filterList` çæå»ºæµç¨ï¼`UtilityHelper.GetDilter` + `ShowFilter` èªå®ä¹çéï¼ã

			## æç»å è½½ï¼getModel
			- åæ¢å°æç»é¡µææ§è¡ç¼è¾æ¶ï¼`UtilityHelper.SetTabParameter` ä¼æèµ· `getModel(string guid)`ã
			- è¯¥æ¹æ³è°ç¨ `_webServiceName + "GetModel"`ï¼éè¿ `UtilityHelper.SetValueByObj(layoutMx1.Controls, data, isEdit)` ç»æ§ä»¶åå¡«ï¼å½ `toolBarMenu1.currentAction == "edit"` æ¶åè®¸ç¼è¾ã
			- è¥çå°âæç»ä¸å·æ°âï¼åç¡®è®¤ `lbGuid` æ¯å¦èµå¼ã`toolBarMenu1.currentAction` æ¯å¦è¢«éç½®ã

			## æ°å¢/ç¼è¾/ä¿å
			- å¥å£ç»ä¸ç»å®å¨çªä½æé å½æ°ä¸ï¼
			- `btnAddClick`ï¼`UtilityHelper.CleanValueByControl(layoutMx1.Controls, true)` æ¸ç©ºæ§ä»¶ï¼`JumpTab(xtraTabControl1, 4)` åå°ç¼è¾é¡µã
			- `btnEdtClick`ï¼`UtilityHelper.GetCurrentRow(...)` è¯»åå½åè¡ï¼`ChangeEnableByControl(..., true)` å¼å¯ç¼è¾ã
			- `btnSaveClick`ï¼ç»è£å¿åå¯¹è±¡ï¼éå¸¸å« `Guid = UtilityHelper.ToGuid(lbGuid.Text)`ï¼ï¼ç¶å `UtilityHelper.HttpPost("", _webServiceName + "EditModel", json)`ãæååæ¸é¤ `currentAction`ã`ChangeEnableByControl(..., false)` å¹¶æç¤ºã
			- å¸¸è§æ ¡éªä¸æé®ç¶æååå¨ `ToolBarMenu1_btnSaveClick` åï¼ç´æ¥å¨å¯¹åºçªä½éè°æ´ã

			## å é¤ä¸å·æ°
			- å é¤åºå®å¨ `toolBarMenu1.btnDelClick`ï¼å¦ `DevFrm\BasicData\Frm_MesWorkshopLine.cs:200`ï¼ï¼
			- éè¿ `UtilityHelper.GetCurrentRow` æ¿ Guid â `MsgHelper.AskQuestion` äºæ¬¡ç¡®è®¤ â è°ç¨ `_webServiceName + "DeleteModel"`ã
			- æååéå¸¸ `getPageList(pageBar1.CurrentPage)` éæ°æååè¡¨ã
			- å·æ°æé® `btnLoadClick` é»è®¤å¤æå½åé¡µç¾ï¼å¨æç»é¡µæ§è¡ `getModel(lbGuid.Text)`ï¼å¦ååå° `getPageList`ã

			## å¸¸ç¨å·¥å·æ¹æ³éæ¥
			- `UtilityHelper.HttpPost`ï¼ç»ä¸çæ¥å£è¯·æ±ï¼èªå¨å `App.config` ä¸ç `WebApiUrl`ï¼è°è¯æ¶å¯åæå° `_webServiceName` ç¡®è®¤ URLã
			- `UtilityHelper.ReturnToTablePage` / `ReturnToDynamic`ï¼ææ¥å£ JSON è½¬ä¸º `ReturnModel<T>`ï¼å½åè¡¨æ¸²æå¼å¸¸æ¶é¦éæ£æ¥ `rtnCode` ä¸ `rtnMsg`ã
			- `UtilityHelper.GetSearchWhere`ï¼æ `FilterEntity` æ¼æ SQL çæ®µï¼ä½äº `ToolBox/UtilityHelper.cs` 1679 è¡éè¿ã
			- `UtilityHelper.JumpTab` / `SetGridViewParameter` / `SetTabParameter`ï¼è´è´£åè¡¨ä¸æç»é¡µçèå¨ï¼è¥ç¿»é¡µæåå»è¡ä¸ºå¤±æï¼åçè¿äºè®¾ç½®æ¯å¦è¢«è°ç¨ã
			- `UtilityHelper.ChangeEnableByControl`ã`SetValueByObj`ã`CleanValueByControl`ï¼è¡¨åæ§ä»¶æ¹éèµå¼/ç¦ç¨çé¦é APIã
			- `ToolBox.MsgHelper`ï¼æå¸¦ç»ä¸æ ·å¼çæç¤ºçªï¼é¿åç´æ¥ä½¿ç¨ `MessageBox.Show`ã

			## è°è¯å°è´´å£«
			- ä¸ç¥éæåè½å¨åªä¸ªçªä½ï¼ä½¿ç¨ `rg "MesXxxManager"` æ `rg "btnSaveClick"` å¿«éå®ä½ã
			- æææ¥è¯¢é½å½åä¸º `getPageList`ï¼å°å gï¼ï¼æä»¥ `rg "getPageList"` è½ä¸æ¬¡çæ¸ææçªä½çåé¡µå®ç°ã
			- `_webServiceName` åæ®µæååç«¯æ§å¶å¨åç¼ï¼å¦ `"MesWorkshopLineManager/"`ï¼ï¼å®ä½æ¥å£æ¶åªéç»å `GetListPage`ã`GetModel`ã`EditModel`ã`DeleteModel`ã
			- å·¥å·æ¡æææé®äºä»¶çåå§å®ä¹å¨ `UserControl/UcToolBarMenu.cs`ï¼å¦æéè¦æ°å¢æé®æææ¥ç¦ç¨é»è¾ï¼å¯ä»¥ä»è¿éä¸æã