关键服务 (运营 KPI 构建基块)
以下部分列出了用于自动化的关键服务。
PTC.OperationKPI.AutomationEventsModelLogic_TS
PTC.OperationKPI.AutomationEventsModelLogic_TS 由为数据自动化而配置的定拍单元工作单元事物来实现。PTC.OperationKPI.AutomationEventsModelLogic_TS 事物形态中提供了以下关键服务：
• AddPTCAutomationMessage - 向消息的 PTCAutomationMessage 信息表属性中添加新消息。此属性中的消息数由 PTCMaxNumberOfAutomationMessages 属性控制。
• AddPTCValueStreamEntry - 用于自动属性的数据更改订阅服务中。此服务会评估是否应将自动化属性更新值写入到在定拍单元事物上设置的值流。传入属性 VTQ 的质量必须为 GOOD，并且介于 now (即在触发对数据更改事件的订阅时) 与属性更改事件时间戳之间的时间不能大于 PTCMaxTimeAllowedDisconnected 属性的值。这表示，当历史属性值更新过旧时，将忽略这些更新。
• BufferPTCAutomationEvents - 对传入事件按逻辑分组，以便在批处理过程中加快处理速度。
• GetPTCAutomationProperties - 返回在 PTCScrapEventProperties 属性中定义的自动化属性和次品属性的硬编码列表。
• PopulatePTCEventRelatedData - 从数据库查询原因信息，并使用相关信息填充事件数据。如果找不到可用性事件代码，则使用默认的 Unknown 故障原因信息。
• ProcessPTCAutomationEvents - 用于调用批处理，然后确定是否应将断开连接或停运的定拍单元设置回 Running 的 PTCAutomationEventProcessingTimerSubscription 实体的入口点。
• ProcessPTCAutomationEventsinMultiBatch - 查询定拍单元的值流，以获取要批处理的任何新的自动属性数据。这是主要的自动化事件处理服务。
• ProcessPTCAutomationJobOrderRelatedEvents - 遍历来自聚合事件参数的作业单 ID、物料主数据 ID 和目标数量值，然后将这些值发送到各自的服务以进行进一步处理。
• ProcessPTCAutomationProductionScrapAvailabilityEvents - 遍历给定的生产事件、次品事件和可用性事件，以确定应忽略这些事件还是将其添加到数据库中。如果没有正在运行的作业单，则只能忽略生产事件和次品事件。
• ProcessPTCAvailabilityEvent - 返回行由输入参数构建的信息表。
• ProcessPTCCountEvent - 根据自动化属性的滚动更新值是 true 还是 false 来处理事件计数，其中的值是针对已接收到 PTCLastAutomationProcessedValues 信息表属性更新的每个属性值而保留的。
• ProcessPTCJobOrderIDEvent - 处理作业单 ID 事件值，并确定应开始作业单还是停止作业单。
• ProcessPTCMaterialMasterIDEvent - 处理物料主数据 ID 事件值，并确定应创建作业单还是停止作业单。创建新的作业单时，PTCAutomationDefaultTargetQuantity 属性值用于默认目标数量。
• ProcessPTCProductionEvent - 使用 PTCIsProductionCountRollover 属性值调用 ProcessPTCCountEvent 服务，以指定该属性是否为滚动更新属性。使用 PTCProductionRolloverCounter 属性来定义将发生滚动更新的值。
• ProcessPTCScrapEvent - 调用 PTCScrapEventProperties 属性中找到的所有属性的 ProcessPTCCountEvent 服务。
• ProcessPTCTargetQuantityEvent - 如果存在正在运行的作业单，则处理传入目标数量事件值并更新作业单物料需求目标数量。
• SetPTCMachineStatusToRunningIfDisconnectedMoreThanAllowed - 当 PTCEnableAutoSetMachineStatusToRunning 属性设置为 true 且上次可用性事件条目为停运事件时，在断开连接的时间超过最大允许时间之后，评估是否应将定拍单元设置为 Running。
PTC.OperationKPI.AnalysisModelLogic_TS
PTC.OperationKPI.AnalysisModelLogic_TS 事物形态在模型事物模板 (例如 PTC.MfgModel.DefaultWorkunit_TT) 中实施。
PTC.OperationKPI.AnalysisModelLogic_TS 事物形态中提供了以下服务：
• GetPTCAnalysisWorkMasterMaterials - 检索工作中心的物料主数据、工作中心所属区域以及工作中心的定拍单元。
• GetPTCOEEValuesForShift - 根据计算结果检索班次的 OEE 值。
• GetPTCParetoInfos - 检索计算得到的排列图详细信息。
• GetPTCTrendInfos - 检索计算得到的趋势图详细信息。
• GetPTCWaterfallInfos - 检索瀑布图详细信息列表。
PTC.OperationKPI.ExecutionModelLogic_TS
PTC.OperationKPI.ExecutionModelLogic_TS 事物形态在 PTC.MfgModel.DefaultWorkcenter_TT 和 PTC.MfgModel.DefaultWorkunit_TT 事物模板以及 PTC.ProductionDashboard.Management_TS 事物形态中实施。
PTC.OperationKPI.ExecutionModelLogic_TS 事物形态中提供了以下服务：
• AddOrUpdatePTCEvents - 为指定型号添加或更新事件。
• AutoCreateOrEndPTCProductionBlock - 为指定型号自动创建或结束生产区块。
• DeletePTCEvents - 为指定型号删除事件。
• GetPTCAllEvents - 通过调用相应的服务来检索给定时间范围内的所有事件。
• GetPTCAllNegativeEvents - 通过调用相应的服务检索给定时间范围内的所有负值原因类型事件 (“停运”、“速度损失”和“次品”)。
• GetPTCAvailableJobOrders - 检索给定工作中心的所有作业单。还会返回分配给工作中心的父项区域或其定拍单元工作单元的作业单。
• GetPTCExecutionWorkMasterMaterials - 检索工作中心的物料主数据、工作中心分配到的区域以及工作中心的定拍单元。
• GetPTCJobOrderMaterials - 检索指定型号某一日期范围内作业单的物料主数据。
• GetPTCJobOrderTargetStatus - 检索给定作业单的有效目标分派状况。
• GetPTCJobSummary - 检索作业汇总数据。
• GetPTCProducedMaterials - 检索指定型号在某一日期范围内生成的物料主数据。
• GetPTCProductionBlockEvents - 检索所有生产区块事件。
• GetPTCProductionBlockInfo - 检索生产区块详细信息的列表。
• GetPTCProductionBlockInfos - 检索给定时间范围内所有生产区块的生产区块详细信息列表。
• GetPTCRunningJobOrders - 返回在选定日期运行的作业单。
• GetPTCScrapEventData - 返回有关给定次品事件 UID 的次品事件的信息。
• GetPTCShiftViewDetails - 检索班次视图详细信息。
• StartPTCProduction - 开始生产某个型号的指定作业单。
• StopPTCProduction - 停止生产某个型号的实际运行作业单。
PTC.OperationKPI.Management_TS
PTC.OperationKPI.Management_TS 事物形态由 PTC.OperationKPI.Manager_TT 事物模板实施。
PTC.OperationKPI.Management_TS 事物形态中提供了以下服务：
• AddEvents - 添加事件。
• AddJobOrder - 使用提供的型号、物料和数量添加作业单。
• AddOrUpdateEvents - 添加或更新事件。
• AutoCreateOrEndProductionBlock - 处理端到端的生产区块流。
• CalculateActualCycleTime - 计算已传入作业单的实际周期时间。从作业单开始之时计算，直到当前生产区块结束，或作业单结束 (即作业单处于 Completed 或 Held 状态)。
• DeleteEvents - 删除已传入的事件。
• GetAllEvents - 检索给定时间范围和型号 UID 的所有事件。
• GetAvailableJobOrders - 检索给定工作中心或工作单元的作业单。
• GetJobSummary - 检索作业汇总数据。
• GetParetoInfos - 检索计算得到的排列图详细信息。
• GetProducedMaterials - 检索指定型号在某一日期范围内生成的物料主数据。
• GetProductionBlockInfo - 检索针对指定生产区块计算得到的生产区块详细信息。
• GetProductionBlockInfos - 检索在给定时间范围内针对所有生产区块计算得到的生产区块详细信息。
• GetRunningJobOrders - 检索在选定日期运行的作业单。
• GetShiftViewDetails - 检索给定作业单的班次视图详细信息。
• GetTotalTrendInfos - 调用相关函数来检索指定时间范围和型号 UID 每天的总体趋势信息。
• GetTrendByReasonInfos - 检索指定时间范围、型号 UID 和 reasonTreeNode UID 每天的趋势信息。
• GetTrendInfos - 检索计算得到的第一层级排列图详细信息。
• GetWaterfallInfos - 检索计算得到的瀑布图详细信息。
• StartJobOrders - 开始作业单。
• StartProduction - 开始指定作业单和型号的生产。
• StopJobOrders - 停止作业单。
• StopProduction - 停止指定型号实际运行作业单的生产。
• UpdateEvents - 更新事件。