SavePastSample(Int32,String,String,String,DateTime,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString,DBString) Method
- Last UpdatedNov 06, 2025
- 6 minute read
The SavePastSample() method adds a new data log record whose values were collected in the past into the Data_Log table, using the passed values.
In this overload of the method, the data log group is identified by its group description and the entity is identified by its entity name and site name.
Note: This method can only add data log values from 1 to 48 to the Data_Log table. If you need to add past-collected data log values from 49 to 64, you can use the DataLog.Add() method.
'Declaration
Public Overloads Shared Sub SavePastSample( _
ByVal sessionId As Integer, _
ByVal grpDesc As String, _
ByVal entName As String, _
ByVal siteName As String, _
ByVal sampleTime As Date, _
ByVal value1 As DBString, _
ByVal value2 As DBString, _
ByVal value3 As DBString, _
ByVal value4 As DBString, _
ByVal value5 As DBString, _
ByVal value6 As DBString, _
ByVal value7 As DBString, _
ByVal value8 As DBString, _
ByVal value9 As DBString, _
ByVal value10 As DBString, _
ByVal value11 As DBString, _
ByVal value12 As DBString, _
ByVal value13 As DBString, _
ByVal value14 As DBString, _
ByVal value15 As DBString, _
ByVal value16 As DBString, _
ByVal value17 As DBString, _
ByVal value18 As DBString, _
ByVal value19 As DBString, _
ByVal value20 As DBString, _
ByVal value21 As DBString, _
ByVal value22 As DBString, _
ByVal value23 As DBString, _
ByVal value24 As DBString, _
ByVal value25 As DBString, _
ByVal value26 As DBString, _
ByVal value27 As DBString, _
ByVal value28 As DBString, _
ByVal value29 As DBString, _
ByVal value30 As DBString, _
ByVal value31 As DBString, _
ByVal value32 As DBString, _
ByVal value33 As DBString, _
ByVal value34 As DBString, _
ByVal value35 As DBString, _
ByVal value36 As DBString, _
ByVal value37 As DBString, _
ByVal value38 As DBString, _
ByVal value39 As DBString, _
ByVal value40 As DBString, _
ByVal value41 As DBString, _
ByVal value42 As DBString, _
ByVal value43 As DBString, _
ByVal value44 As DBString, _
ByVal value45 As DBString, _
ByVal value46 As DBString, _
ByVal value47 As DBString, _
ByVal value48 As DBString _
)
'Usage
Dim sessionId As Integer
Dim grpDesc As String
Dim entName As String
Dim siteName As String
Dim sampleTime As Date
Dim value1 As DBString
Dim value2 As DBString
Dim value3 As DBString
Dim value4 As DBString
Dim value5 As DBString
Dim value6 As DBString
Dim value7 As DBString
Dim value8 As DBString
Dim value9 As DBString
Dim value10 As DBString
Dim value11 As DBString
Dim value12 As DBString
Dim value13 As DBString
Dim value14 As DBString
Dim value15 As DBString
Dim value16 As DBString
Dim value17 As DBString
Dim value18 As DBString
Dim value19 As DBString
Dim value20 As DBString
Dim value21 As DBString
Dim value22 As DBString
Dim value23 As DBString
Dim value24 As DBString
Dim value25 As DBString
Dim value26 As DBString
Dim value27 As DBString
Dim value28 As DBString
Dim value29 As DBString
Dim value30 As DBString
Dim value31 As DBString
Dim value32 As DBString
Dim value33 As DBString
Dim value34 As DBString
Dim value35 As DBString
Dim value36 As DBString
Dim value37 As DBString
Dim value38 As DBString
Dim value39 As DBString
Dim value40 As DBString
Dim value41 As DBString
Dim value42 As DBString
Dim value43 As DBString
Dim value44 As DBString
Dim value45 As DBString
Dim value46 As DBString
Dim value47 As DBString
Dim value48 As DBString
DataLogGrp.SavePastSample(sessionId, grpDesc, entName, siteName, sampleTime, value1, value2, value3, value4, value5, value6, value7, value8, value9, value10, value11, value12, value13, value14, value15, value16, value17, value18, value19, value20, value21, value22, value23, value24, value25, value26, value27, value28, value29, value30, value31, value32, value33, value34, value35, value36, value37, value38, value39, value40, value41, value42, value43, value44, value45, value46, value47, value48)
public static void SavePastSample(
int sessionId,
string grpDesc,
string entName,
string siteName,
DateTime sampleTime,
DBString value1,
DBString value2,
DBString value3,
DBString value4,
DBString value5,
DBString value6,
DBString value7,
DBString value8,
DBString value9,
DBString value10,
DBString value11,
DBString value12,
DBString value13,
DBString value14,
DBString value15,
DBString value16,
DBString value17,
DBString value18,
DBString value19,
DBString value20,
DBString value21,
DBString value22,
DBString value23,
DBString value24,
DBString value25,
DBString value26,
DBString value27,
DBString value28,
DBString value29,
DBString value30,
DBString value31,
DBString value32,
DBString value33,
DBString value34,
DBString value35,
DBString value36,
DBString value37,
DBString value38,
DBString value39,
DBString value40,
DBString value41,
DBString value42,
DBString value43,
DBString value44,
DBString value45,
DBString value46,
DBString value47,
DBString value48
)
Parameters
- sessionId
- Required. Holds the session ID and thus the user who is making this method call.
- grpDesc
- Required. Holds the description of the data log group for which this sample was collected.
- entName
- Required. Holds the name of the entity where the sample was collected.
- siteName
- Required. Holds the site name of the entity where the sample was collected.
- sampleTime
- Required. Holds the date/time, in the entity's local time, when the sample was collected.
- value1
- Optional. Holds a collected sample value.
- value2
- Optional. Holds a collected sample value.
- value3
- Optional. Holds a collected sample value.
- value4
- Optional. Holds a collected sample value.
- value5
- Optional. Holds a collected sample value.
- value6
- Optional. Holds a collected sample value.
- value7
- Optional. Holds a collected sample value.
- value8
- Optional. Holds a collected sample value.
- value9
- Optional. Holds a collected sample value.
- value10
- Optional. Holds a collected sample value.
- value11
- Optional. Holds a collected sample value.
- value12
- Optional. Holds a collected sample value.
- value13
- Optional. Holds a collected sample value.
- value14
- Optional. Holds a collected sample value.
- value15
- Optional. Holds a collected sample value.
- value16
- Optional. Holds a collected sample value.
- value17
- Optional. Holds a collected sample value.
- value18
- Optional. Holds a collected sample value.
- value19
- Optional. Holds a collected sample value.
- value20
- Optional. Holds a collected sample value.
- value21
- Optional. Holds a collected sample value.
- value22
- Optional. Holds a collected sample value.
- value23
- Optional. Holds a collected sample value.
- value24
- Optional. Holds a collected sample value.
- value25
- Optional. Holds a collected sample value.
- value26
- Optional. Holds a collected sample value.
- value27
- Optional. Holds a collected sample value.
- value28
- Optional. Holds a collected sample value.
- value29
- Optional. Holds a collected sample value.
- value30
- Optional. Holds a collected sample value.
- value31
- Optional. Holds a collected sample value.
- value32
- Optional. Holds a collected sample value.
- value33
- Optional. Holds a collected sample value.
- value34
- Optional. Holds a collected sample value.
- value35
- Optional. Holds a collected sample value.
- value36
- Optional. Holds a collected sample value.
- value37
- Optional. Holds a collected sample value.
- value38
- Optional. Holds a collected sample value.
- value39
- Optional. Holds a collected sample value.
- value40
- Optional. Holds a collected sample value.
- value41
- Optional. Holds a collected sample value.
- value42
- Optional. Holds a collected sample value.
- value43
- Optional. Holds a collected sample value.
- value44
- Optional. Holds a collected sample value.
- value45
- Optional. Holds a collected sample value.
- value46
- Optional. Holds a collected sample value.
- value47
- Optional. Holds a collected sample value.
- value48
- Optional. Holds a collected sample value.
For data logs with sample values that have no entries, those value columns are returned as null.
The method converts the supplied time from the entity's local time to UTC, then uses the UTC time to retrieve the job information from the Job_History table whose job start time is immediately prior to the event UTC time (converted from the supplied local event time). If there is more than one job having the same job start time, then the job from the lowest job position is selected. The job information is then used in the sample data record that is created.