updateOrCreateStateValue: Update a value
In mcneilco/racas: R Package for ACAS

updateOrCreateStateValue

R Documentation

Update a value

Description

If a value with the correct lsType and lsKind exists within the provided lsState, it is updated, otherwise, it is created.

Usage

updateOrCreateStateValue(entityKind, lsState, lsType, lsKind,
  stringValue = NULL, fileValue = NULL, urlValue = NULL,
  publicData = TRUE, ignored = FALSE, dateValue = NULL,
  clobValue = NULL, blobValue = NULL, valueOperator = NULL,
  operatorType = NULL, numericValue = NULL, sigFigs = NULL,
  uncertainty = NULL, uncertaintyType = NULL, numberOfReplicates = NULL,
  valueUnit = NULL, unitType = NULL, comments = NULL,
  lsTransaction = NULL, codeValue = NULL, recordedBy = "username",
  testMode = FALSE, recordedDate = as.numeric(format(Sys.time(), "%s")) *
  1000, codeType = NULL, codeKind = NULL, codeOrigin = NULL,
  lsServerURL = racas::applicationSettings$client.service.persistence.fullpath)

Arguments

`entityKind`	the kind of parent entity, such as "experiment" or "analysisgroup", see acasEntityHierarchy
`lsState`	a state object
`lsType`	type of the value
`lsKind`	lsKind of the value
`stringValue`	string, <255 characters
`fileValue`	file code or path
`urlValue`	url
`publicData`	TRUE to be visible
`ignored`	TRUE to mark as old
`dateValue`	date in milliseconds
`clobValue`	clob
`blobValue`	blob
`valueOperator`	">" or "<"
`operatorType`	"comparison", not yet implemented
`numericValue`	numeric
`sigFigs`	integer
`uncertainty`	numeric
`uncertaintyType`	"standard deviation"
`numberOfReplicates`	integer
`valueUnit`	"uM", etc.
`unitType`	not yet implemented
`comments`	used by fileValue for a filename, flags for comments, etc.
`lsTransaction`	id of the transaction
`codeValue`	codename of something
`recordedBy`	the current username
`testMode`	used for testing
`lsServerURL`	the url for the roo server

Details

This will fail if the entity has more than one non-ignored state of entered stateKind, as it would be unclear which to update. updateValueByTypeAndKind is often easier to use.