平台SPC应用介绍 - .Net 平台应用与技巧

# 一、概述
基于交付项目在SPC方面有或多或少的需求，此次特针对平台SPC进行优化，主要是UI字段映射的配置，比如SPC界面上需要显示拉线、产品、工单、LotSN、客户、工序、机台等。但由于SPC组件只有固定的几个显示字段，无法满足所有的用户字段，故而在SPC项目配置中，增加“UI字段映射”配置，以满足项目的多样化需求。针对通过Socket方式运行SPC（如查询元对象），增加固定参数LotSN并支持用户自定义参数，用于动态获取UI字段值。

更新包：
[【附件】SPC20241029.rar](/media/attachment/2024/10/SPC20241029.rar)

# 二、更新内容
**2.1 UI字段映射**
**2.1.1** 按SPC图标类型配置
比如，按照X-Bar R/X-R/np Chart/p Chart等图表类型进行配置：
![](/media//202312/2023-12-22_170806.png)

**2.1.2** 按SPC任务配置
按SPC任务配置，则该任务享有专属的UI字段映射规则：
![](/media//202312/2023-12-22_171409.png)

**2.1.3** UI字段映射展示
![](/media//202312/2023-12-22_171602.png)
![](/media//202312/2023-12-22_171722.png)

# 2.2 X轴显示格式：时间格式和旋转角度
**2.2.1** 显示格式配置
![](/media//202312/2023-12-22_172151.png)

**2.2.2** 默认格式，显示组号
![](/media//202312/2023-12-22_172001.png)

**2.2.3** 时间格式
![](/media//202312/2023-12-22_172403.png)

# 三、数据源配置
**3.1 SPC基础配置数据及UI映射配置**
```sql
 SET QUOTED_IDENTIFIER ON ;
SET ANSI_NULLS ON ;
GO

-- =============================================
-- Author:		<OrBit Team benson>
-- Create date: <2021-11-12>
-- Description:	SPC-获取SPC任务数据
-- =============================================
ALTER PROCEDURE [dbo].[SPCGetTaskDataDoMethod]
    @I_Sender NVARCHAR (200) = ''                       --客户端执行按钮
  , @I_ReturnMessage NVARCHAR (MAX) = '' OUTPUT         --返回的信息,支持多语言
  , @I_ExceptionFieldName NVARCHAR (100) = '' OUTPUT    --向客户端报告引起冲突的字段
  , @I_LanguageId CHAR (1) = '1'                        --客户端传入的语言ID
  , @I_PlugInCommand VARCHAR (5) = ''                   --插件命令
  , @I_OrBitUserId CHAR (12) = ''                       --用户ID
  , @I_OrBitUserName NVARCHAR (100) = ''                --用户名
  , @I_ResourceId CHAR (12) = ''                        --资源ID(如果资源不在资源清单中，那么它将是空的)
  , @I_ResourceName NVARCHAR (100) = ''                 --资源名
  , @I_PKid CHAR (12) = ''                              --主键
  , @I_ParentPKId CHAR (12) = ''                        --父级主键
  , @I_Parameter NVARCHAR (100) = ''                    --插件参数
                                                        --以上变量为系统服务固定接口参数，必须在每一个DoEvent过程中实现.
  , @SPCTaskId CHAR (12) = ''
  , @LotSN NVARCHAR (50) = ''
  -- 以下参数为用户自定义参数
  , @A NVARCHAR (50) = ''
  , @B NVARCHAR (50) = ''
  , @C NVARCHAR (50) = ''
AS
BEGIN

SET NOCOUNT ON ;
    SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED ;

SELECT
                        ST.SPCTaskId
                      , SP.SPCProjectName
                      , ST.SPCTaskName
                      , ST.IsTimerRefresh
                      , ST.TimerInterval
                      , ST.CUSumProcessMean
                      , ST.CUSumkValue
                      , ST.CUSumhValue
                      , C.CustomerName + ' ' + C.CustomerDescription             AS CustomerName
                      , SP.SPCChartType
                      , SP.FontSize
                      , SP.VNumSamplesPerSubGroup
                      , SP.VNumDataPointsInView
                      , SP.VIsShowTableHeader
                      , SP.VSampleDecimalPrecision
                      , SP.VCalcDecimalPrecision
                      , SP.VIsFrequencyHistogram
                      , SP.IsShowSample
                      , SP.IsShowCP
                      , SP.IsShowCPK
                      , SP.IsShowCPL
                      , SP.IsShowCPM
                      , SP.IsShowCPU
                      , SP.IsShowCustom_PC
                      , SP.IsShowPP
                      , SP.IsShowPPK
                      , SP.IsShowPPL
                      , SP.IsShowPPU
                      , SP.IsAlramA
                      , SP.IsAlarmB
                      , SP.IsAlarmC
                      , SP.AlarmCPoint
                      , SP.IsAlarmD
                      , SP.AlarmDPoint
                      , SP.IsAlarmE
                      , SP.AlarmEPoint
                      , SP.IsAlarmF
                      , SP.AlarmFPoint
                      , SP.IsAlarmG
                      , SP.AlarmGPoint
                      , SP.IsAlarmH
                      , SP.AlarmHPoint
                      , SP.IsAlarmI
                      , SP.AlarmIPoint
                      , SP.IsSendMessage
                      , SP.MessageAlramA
                      , SP.MessageAlramB
                      , SP.MessageAlramC
                      , SP.IsSendEMail
                      , SP.EMailAlramA
                      , SP.EMailAlramB
                      , SP.EMailAlramC
                      , PR.ProductName + ' ' + P.ProductRevision                 AS ProductName
                      , P.ProductDescription
                      , SR.SpecificationName + ' ' + SF.SpecificationDescription AS SpecificationName
                      , ST.SPCGetDataName
                      , ST.SPCActionName
                      , EAT.AssetNumber                                          AS EquipmentNumber
                      , 'MO23120001'                                             AS MOName
                      , @LotSN                                                   AS LotSN
                      , ST.XLabelRotation                                        AS XLabelRotation
                      , ST.CustomDateTimeFormat                                  AS CustomDateTimeFormat    -- 'yy/M/d' 
                      , ST.IsUseSpecLimit
                      , ISNULL( ST.UpperSpecLimit, 0 )                           AS UpperSpecLimit
                      , ISNULL( ST.SpecTarget, 0 )                               AS SpecTarget
                      , ISNULL( ST.LowerSpecLimit, 0 )                           AS LowerSpecLimit
                      , ISNULL( ST.IsUsePControlLimit, 0 )                       AS IsUsePControlLimit
                      , ISNULL( ST.PUpperControlLimit, 0 )                       AS PUpperControlLimit
                      , ISNULL( ST.PControlTarget, 0 )                           AS PControlTarget
                      , ISNULL( ST.PLowerControlLimit, 0 )                       AS PLowerControlLimit
                      , ISNULL( ST.IsUseSControlLimit, 0 )                       AS IsUseSControlLimit
                      , ISNULL( ST.SUpperControlLimit, 0 )                       AS SUpperControlLimit
                      , ISNULL( ST.SControlTarget, 0 )                           AS SControlTarget
                      , ISNULL( ST.SLowerControlLimit, 0 )                       AS SLowerControlLimit
                      , U.UOMName
                      , W.WorkcenterName + ' ' + W.WorkcenterDescription         AS WorkcenterName
                      , SP.ANumSamplesPerSubGroup
                      , SP.ANumDataPointsInView
                      , SP.AGoodCodeId
                      , SP.ADefectGroupId
                      , SP.ADefectCodeEId
                      , SP.ADefectCodeDId
                      , SP.ADefectCodeCId
                      , SP.ADefectCodeBId
                      , SP.ADefectCodeAId
    FROM                dbo.Workcenter  W
    RIGHT OUTER JOIN    dbo.SPCTask                  ST
    INNER               JOIN          dbo.SPCProject SP ON ST.SPCProjectId = SP.SPCProjectId ON W.WorkcenterId = ST.WorkcenterId
    LEFT OUTER JOIN     dbo.Equipment   E ON E.EquipmentId = ST.EquipmentId
    LEFT OUTER JOIN     dbo.EAM_EqAsset EAT ON EAT.EAM_EqAssetId = E.EAM_EqAssetId
    LEFT OUTER JOIN     dbo.UOM         U ON ST.UOMId = U.UOMId
    LEFT OUTER JOIN     dbo.Specification                   SF
    INNER               JOIN          dbo.SpecificationRoot SR ON SF.SpecificationRootId = SR.SpecificationRootId ON ST.SpecificationId = SF.SpecificationId
    LEFT OUTER JOIN     dbo.ProductRoot           PR
    INNER               JOIN          dbo.Product P ON PR.ProductRootId = P.ProductRootId ON ST.ProductId = P.ProductId
    LEFT OUTER JOIN     dbo.Customer    C ON SP.CustomerId = C.CustomerId
    WHERE               ST.SPCTaskId = @SPCTaskId ;

-- UI字段映射 Add by Noland @2023-12-20
    EXEC [dbo].[SPCTaskUIMapTreeView]
        @I_ParentPKId = @SPCTaskId ;

RETURN 0 ;
END ;

GO
```
![](/media//202404/2024-04-02_140811.png)
**参数说明：**
SPCTaskId为运行的SPC主键；
LotSN为批号，可以用于界面展示或查询SPC的相关UI字段值；
PARA为用户自定义参数，用于查询SPC的相关UI字段值（注意：**SPC任务配置存储过程必须有相关参数**）。

**3.2 SPC样本数据源**
![](/media//202312/2023-12-23_095714.png)
其中，Chart（np Chart/p Chart/u Chart/u Chart）类图表类型为计量型，其他为计数型：

# 四、补充说明
**4.1 备注字段**
备注字段显示的内容会拼接样本数据源的列名和值：
![](/media//202312/2023-12-23_091814.png)
![](/media//202312/2023-12-23_091836.png)

**4.2 “均匀度”解释**
均匀度用来量化样本值的离散程度，该值的绝对值越接近0，说明样本越均匀（收敛）。
计算公式：(1 - （最大值-最小值） / 2 / 平均值) * 100
![](/media//202312/2023-12-22_181714.png)

**4.3 SPCD插件参数配置**
**4.3.1** 运行demo任务
![](/media//202312/2023-12-22_181653.png)

**4.3.2** 运行用户相关的任务
![](/media//202312/2023-12-22_181640.png)

**4.4 Socket方式运行SPC**
可以在数据库后台调用RealtimeMessage_DoMethod或CLR_SocketMessage运行SPC。可结合查询元对象，根据不同的的查询条件，传入相关参数运行指定的SPC：
```sql
DECLARE @return_value INT ;
DECLARE @msg NVARCHAR (1000) ;
DECLARE @I_ReturnMessage NVARCHAR (MAX) = N'' ;
DECLARE @I_OrBitUserId CHAR (12) = 'RES10000011Z' ;  -- 用户Id 或 资源Id
DECLARE @I_OrBitUserName NVARCHAR (50) = N'HG0064' ;
DECLARE @I_ResourceName NVARCHAR (50) = N'LS100' ;
DECLARE @A NVARCHAR (50) = N'A' ;
DECLARE @B NVARCHAR (50) = N'B' ;
DECLARE @C NVARCHAR (50) = N'C' ;

SET @msg
    = N'[SPCTaskId:SPCT00000001][MO:MO000112-998][LotSN:SN0008989][USER:' + @I_OrBitUserName + N'][PC:'
      + @I_ResourceName + N'][PARA:,@A=' + @A + N',@B=' + @B + N',@C=' + @C + N']' ;
EXEC @return_value = [dbo].[RealtimeMessage_DoMethod]
    @I_ReturnMessage = @I_ReturnMessage OUTPUT
  , @I_PKid = @I_OrBitUserId
  , @SPCCommand = @msg
  , @AutoOpenPlugin = N'SPC (RUN)' ;

SELECT @msg
  SELECT @I_ReturnMessage;
```

**参数说明：**
SPCTaskId为运行的SPC主键；
MO为工单，可以用于界面展示及样本数据源的过滤；
LotSN为批号，可以用于界面展示或回传SPC相关的计算结果；
USER为用户，，可以用于界面展示；
PC为资源，可以用于界面展示；
PARA为用户自定义参数，用于过滤SPC数据源（注意：**SPC数据源存储过程必须有相关参数**）。

![](/media//202404/2024-04-02_105639.png)

**4.5 SPC报警及结果回传**
![](/media//202312/2023-12-23_094430.png)

**4.5.1** 报警
SPC计算结果触发报警时，会运行配置的“报警之后执行的存储过程”，可以做一些**逻辑控制、消息推送**等；
![](/media//202312/2023-12-23_095543.png)

**4.5.1** 结果回传
SPC计算结果（CPK/CPU/CPL/），会通过配置的“报警之后执行的存储过程”回传给数据库，若有需要，用户可以将此结果绑定到相关数据，如LotSN的测试数据：
![](/media//202312/2023-12-23_095347.png)

# 最后
若文档内容有纰漏之处，请指正。或有其他相关需求问题，欢迎各位一起探讨。谢谢！