EnterDataItem
Description:
For one or more SDIs (typically Samples), enters a data item value for one or more DataSets assigned to an SDI.
Input Properties
sdcid
Description:
Identifier of the SDC.
Required:
Yes
keyid1
Description:
Identifiers of the SDIs.
Required:
Yes
keyid2
Description:
Identifiers of the SDIs.
Required:
Only for multi-key SDCs.
keyid3
Description:
Identifiers of the SDIs.
Required:
Only for multi-key SDCs.
paramlistid
Description:
Identifier of the Parameter List.
Required:
Yes
paramlistversionid
Description:
Identifier of the Parameter List Version.
Required:
Yes
variantid
Description:
Identifier of the Parameter List Variant.
Required:
Yes
dataset
Description:
Data Set Number.
Required:
Yes
paramid
Description:
Identifier of the Parameter.
Required:
Yes
paramtype
Description:
Identifier of the Parameter Type.
Required:
Yes
replicateid
Description:
Replicate number of the Parameter.
Required:
Yes
enteredtext
Description:
Data Value to enter for the Data Item record once all the other values you supply for the qualifying columns are matched.
Required:
Yes
overridereleased
Description:
Whether or not (Y/N) to override Released data. Defaults to Y.
Required:
No
applylock
Description:
Determines whether or not (Y/N) data are locked during Action processing.
Required:
No
auditreason
Description:
Auditing information recorded in the "Reason" column of the TraceLog table.
Required:
No
auditactivity
Description:
Auditing information recorded in the "Activity" column of the TraceLog table.
Required:
No
auditsignedflag
Description:
Auditing information recorded in the "SignedFlag" column of the TraceLog table.
Required:
No
auditdt
Description:
Auditing information recorded in the "ModDt" column of the TraceLog table.
Required:
No
eventnotify
Description:
Determines whether or not (Y/N) an EventNotify Action is posted onto the ToDo List when this Action executes.
Deprecated:
As of version 7, Event Notify actions are no longer generated
propsmatch
Description:
Property matching is always performed. All processing is done with propsmatch = 'Y'. Setting this value to 'N' will have no effect.
Additional Information
Additional information concerning this Action:
This action always performs property matching. When multiple values are entered for the input properties, each qualifying property should have the same number of values delimited by a semicolon. Property matching is performed between the keyid1 values and the other qualifying columns. If a match is not found, the action will fail.

To enter a Data Value for multiple SDIs, use the following example as a guideline:

sdcid = Sample
keyid1 = S01;S02;S03
paramlistid = Metals;Polymers;Fluids
paramlistversionid = 1;3;5
variantid = 2;4;6
dataset = 1;2;3
paramid = Al;HDPE;IPA
paramtype = Std;Mod;Unu
replicateid = 1;1;1
enteredtext; 100;200;300

This will search the SDIDATAITEM table for a match on each set of qualifying columns. The first value for the first property is matched with the first value in the second property and so forth. When an exact match is found, the enteredtext column is provided your value. This action may also result in other columns being updated such as TransformValue, EnteredQualifier, DisplayValue, EnteredValue, and more.
Using the example values shown above, we would expect these three data items to be updated as shown in this table:

Qualifying Column Matching this value combination (all columns must match)
keyid1 S01 S02 S03
paramlistid Metals Polymers Fluids
parmlistversionid 1 3 5
variantid 2 4 6
dataset 1 3 3
paramid Al HDPE IPA
paramtype Standard Mod Unu
replicateid 1 1 1
Entered Text 100 200 300


Comments Concerning Limit Rules:
When you create a Limit Rule, you can specify two Actions:
  1. one to execute when the Limit is met/not met/either
  2. one to execute unconditionally following the first Action
This has implications when using EnterDataItem.
In a Web page, EnterDataItem executes as part of the Save transaction. This means that if the Action fails, the Save transaction also fails.
Copyright © 1999-2025 LabVantage Solutions, Inc.