Usage
synStore(entity, used=NULL, executed=NULL, activityName=NULL, activityDescription=NULL, createOrUpdate=T, forceVersion=T, isRestricted=F, contentType=NULL)
synStore(entity, activity=NULL, createOrUpdate=T, forceVersion=T, isRestricted=F, contentType=NULL)
synStore(table, retrieveData=F, verbose=T, filePath=NULL)
Arguments
used
For entities, this is the list of other entities (URLs, objects and/or IDs) 'used' as inputs when generating the entity. For non-entities, this parameter is ignorede.g. used=list(list(entity="syn1234"), list(url="http://myawesomesite.com"))
executed
For entities, this is the list of other entities (URLs, objects and/or IDs) 'executed' as software when generating the entity. For non-entities, this parameter is ignorede.g. executed=list(list(entity="syn1234"), list(url="http://myawesomesite.com"))
activityName
For entities, this is the name of the activity generating the given entity. For non-entities, this parameter is ignored
activityDescription
For entities, this is the description of the activity generating the given entity. For non-entities, this parameter is ignored
activity
As an alternative to specifying 'used', 'executed', 'activityName', and/or 'activityDescription' you may pass an Activity object containing these items.
createOrUpdate
For entities only: If TRUE (the default) then if the entity is new (not retrieved from Synapse) but has the same name and parent, the existing Synapse object is updated with the content of the passed object
forceVersion
For versionable entities only: If TRUE new version of the object is created. Note, if FALSE this does not mean that a new version is not created: Whenever a new or modified file is attached to a File entity and stored in Synapse, then Synapse creates a new version itself, regardless of the forceVersion parameter
isRestricted
For File entities only: If TRUE then Download access by others is prevented and the Synapse Access and Compliance Team is contacted to help craft the appropriate Terms of Use. This argument is employed when uploading sensitive human data.
contentType
The (optional) contentType, stored when the File is uploaded. If omitted, it is the MIME type inferred from the file's suffix.
retrieveData
For tables: If TRUE, returns a copy of the uploaded table. Otherwise returns a RowReferenceSet, which supplies
the row IDs for the uploaded rows.
verbose
For tables: If TRUE, shows progress for uploading and retrieving data.
filePath
For tables: If retrieveData=T then this is the file path to which the retrieved result will be saves as a .csv file.
If omitted, will be downloaded to the default file cache location.