Importing Measurements (Meters/Analyzers)
The command line syntax and a table of parameters are provided here.
DataLoader.exe -filename=file name –afserver=Server name –afdatabase=AF database name -format=Sigmafine version -type=Meter or Analyzer –adjustment=Yes –timestamp=Date Time –dayoffset=Number of days –timeoffset=Time offset –debug=Yes or No –afmodel=AF Model name –afmodelanalysis= AF Model analysis name
Command Line Parameters – Analyzers and Meters
| Parameter | Required | Description |
|---|---|---|
| Filename = Drive:\Path\Filename | Yes | Full path name of the data file. Relative file paths are not supported. |
| AFServer = AFServerName | Yes | Name of the PI server that hosts the AF Database. |
| AFDatabase = AFDatabaseName | Yes | Name of AF database that contains the elements used for the imported data. |
| AFModel = AFModelName | No1 | Name of AF Model that contains the elements used for the imported data. If present, this argument specifies the data will be written as inputs to a case. |
| AFModelAnalysis = AFModelAnalysisName | No1 | Name of AF Model Analysis that contains Cases used for the imported data. If present, this argument specifies the data will be written as inputs to a case. |
| Format = Sigmafine3orFormat = Sigmafine4 | Yes | Use the Sigmafine3 or Sigmafine4 keyword to indicate if the file has a Sigmafine 3.x or Sigmafine 4.x format, respectively. |
| Type | Yes | To import meter data, use the Meter keyword. To import analyzer data, use the Analyzer keyword. |
| Adjustment = yes | Yes | To mark inputs as adjustments |
| Timestamp = “Timestamp” | No | Local date and time for the data. The format of the time stamp depends on the Windows regional settings.For example, for English US time stamp use:12/24/2005 14:00:00for the date December 24, 2005 at 2:00 PM.If not supplied the Data Loader uses the dayoffset and timeoffset arguments. If none of these arguments is used, the Data Loader uses the current local computer time as the time stamp. If the AFModel and AFModelAnalysis parameters are present, the time stamp then represents the start time of analysis case.If both the “timestamp” command line parameter and the time stamp specified in the file exist, then the time stamp in the file is used. |
| DayOffset = NumberOfDays | No (See Timestamp) | Use the dayoffset argument to specify the date of the data and in combination with the “TimeOffset” parameter. These parameters are not used if the “Timestamp” parameter exists.This is a relative offset from today.For example, for yesterday use –dayoffset = -1This number must be negative or zero (no writing to future times). |
| TimeOffset = HH:MM:SS | No (See Timestamp) | The "Timeoffset" argument is used in conjunction with the "DayOffset" to determine the time of the data. This is relative to midnight of the current day.For example, four hours after midnight is represented as: -timeoffset=4:00:00. |
| Debug = YesorDebug = No | No | Use the keyword “Yes” to enable debugging messaging to the PIPC Log file. Debugging allows a more detailed messaging to appear. Use “No” to disable debugging. If not present, debugging is off and only errors will be written to the PIPC log. |
| 1 The parameter is required with importing values in a Case context. |
Note: In a Case context, the data values are written as inputs to values in the case. When not in a Case context, the only data values written are those with valid PI Points configured using the PI Point Data Reference or the Component Data Reference.