AddTrace 方法（TrendPro 对象）

向运行时图表添加新轨迹。如果轨迹已成功添加到趋势中，则此方法返回
True
；如果未添加轨迹，则返回
False
。
语法
TrendPro1
.
AddTrace
(
String tagName
, [
String
dataLogName
],
[Boolean isHistorian
], [
Integer iType
])（
Boolean
）
其中
TrendPro1
 - 是 TrendPro 对象的名称，或是一个对 TrendPro 对象求值的表达式。
tagName
 - 是字符串类型的参数，指定要添加到趋势中的轨迹的名称。
dataLogName
 - 是字符串类型的可选参数，用于指定数据记录模型名称、DataLogPro 组名称、FactoryTalk Historian 连接名称、Asset Framework 连接名称或 PI Server 名称。
isHistorian
 - 是 Boolean 类型的可选参数。如果设置为
true
，则指定此轨迹为 FactoryTalk Historian 标签。如果未提供值，则默认值为
False
。
注意
：保留此参数以确保与早期版本的 VBA 兼容。若要指定数据源，建议使用
dataLogName
 和
iType
。
iType
 - 是
TrendTraceType
 常数的参数，用于指定轨迹类型。
注意
：对于
FactoryTalk
 Live Data、数据记录和 FactoryTalk Historian，该参数为可选项，这是为了保持与先前版本的 VBA 的兼容性。
我们建议使用以下类型来指定数据源：
  • TraceTypeEmpty
     （0）：使用默认轨迹类型，即实时数据。
  • TraceTypeLiveData
     (1)：FactoryTalk Live Data 标签。
  • TraceTypeDataLog
     (2)：FactoryTalk View SE 数据记录模型标签。
  • TraceTypeHistorian
     (3)：FactoryTalk Historian 标签（或点）。
  • TraceTypeAlarm
     (4)：FactoryTalk Alarms and Events 历史记录。
  • TraceTypeDiagnostic
     (5)：FactoryTalk AssetCentre 诊断记录。
  • TraceTypePIServer
     (6)：PI Server 标签（或点）。
  • TraceTypeDataLogProPlus
     （7）：FactoryTalk View SE DataLogPro 标签。
  • TraceTypeAF
     （8）：FactoryTalk Historian Asset Framework 标签（或属性）。
返回值
 - 如果为
True
，则为有效的联机标签。如果为
False
，则为无效或脱机标签。请注意，如果数据记录或 Historian 标签必须后退到 Live Data 标签，则返回
True
，因为它仍然是有效的联机标签。
如果提供了数据记录或 Historian 名称，并且未找到该标签，则 TrendPro 将后退以确定它是否为 Live Data 标签，如果是，则会将轨迹作为 Live Data 标签进行添加。
示例
Private Sub btnAddTrace()
Dim result As Boolean
'Add a trace for the Live Data tag system\Second.
result = TrendPro1.AddTrace("system\Second")
'Add a trace for a tag named MyTag that exists in a Data Log named MyDataLog.
result = TrendPro1.AddTrace("MyTag", "MyDataLog", , TraceTypeDataLog)
'Add a trace for a tag from Historian Server.
result = TrendPro1.AddTrace("CLX_77.DataServer:RSLinx Enterprise:clx.HartBeat_Bit", "Production Historian", , TraceTypeHistorian)
'Add a trace for a FTAE alarm from FactoryTalk Linx Server.
result = TrendPro1.AddTrace("Line1_Data:FactoryTalk Linx:[CookieLine]Program:Depositor.Depositor_BearingVibAlarm", , , TraceTypeAlarm)
'Add a trace for a FTAE alarm from Alarms and Events Server.
result = TrendPro1.AddTrace("Line1_Alarms:Line1_TagFTAE:DriveCurrent", , , TraceTypeAlarm)
'Add a trace for the Audit information from the diagnostics.
result = TrendPro1.AddTrace("Audit", , , TraceTypeDiagnostic)
'Add a trace for CDT_158 from the PI Server connection PIServer1.
result = TrendPro1.AddTrace("CDT_158", "PIServer1", , TraceTypePIServer)
'Add a trace for a tag named LogTag that exists in the DataLogPro.
result = TrendPro1.AddTrace("LogTag", "DataLogPro", , TraceTypeDataLogProPlus)
'Add a trace for a motor speed from the Asset Framework connection Production Asset Framework.
result = TrendPro1.AddTrace("Line1.Motor.Speed", "Production Asset Framework", , TraceTypeAF)
End Sub
提供反馈
对本文档有问题或反馈吗？ 请在这里提交您的反馈 。
Normal