Interface IMasterDataRegistrationTransaction
-
- All Known Implementing Classes:
MasterDataRegistrationTransaction
public interface IMasterDataRegistrationTransaction
API for master data registration. Offers methods for creation and retrieval of openBIS types, property assignments, vocabularies etc.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description IPropertyAssignment
assignPropertyType(IEntityType entityType, IPropertyTypeImmutable propertyType)
Assigns a property type to an entity type.IDataSetType
createNewDataSetType(java.lang.String code)
Create a new data set type to register with the openBIS AS.IExperimentType
createNewExperimentType(java.lang.String code)
Create a new experiment type to register with the openBIS AS.IExternalDataManagementSystem
createNewExternalDataManagementSystem(java.lang.String code)
Create a new external data management system to register with the openBIS AS.IFileFormatType
createNewFileFormatType(java.lang.String code)
Create a new file format type to register with the openBIS AS.IMaterialType
createNewMaterialType(java.lang.String code)
Create a new material type to register with the openBIS AS.IPropertyType
createNewPropertyType(java.lang.String code, DataType dataType)
Create a new property type to register with the openBIS AS.ISampleType
createNewSampleType(java.lang.String code)
Create a new sample type to register with the openBIS AS.IVocabulary
createNewVocabulary(java.lang.String code)
Create a new sample type to register with the openBIS AS.IVocabularyTerm
createNewVocabularyTerm(java.lang.String code)
Create a new vocabulary term.IDataSetTypeImmutable
getDataSetType(java.lang.String code)
Get a data set type from the openBIS AS.IExperimentTypeImmutable
getExperimentType(java.lang.String code)
Get an experiment type from the openBIS AS.IExternalDataManagementSystemImmutable
getExternalDataManagementSystem(java.lang.String code)
Get an external data management system from the openBIS AS.IFileFormatTypeImmutable
getFileFormatType(java.lang.String code)
Get a file format type from the openBIS AS.IMaterialTypeImmutable
getMaterialType(java.lang.String code)
Get a material type from the openBIS AS.IDataSetType
getOrCreateNewDataSetType(java.lang.String code)
Gets or creates data set type from the openBIS AS.IExperimentType
getOrCreateNewExperimentType(java.lang.String code)
Gets or creates experiment type from the openBIS AS.IExternalDataManagementSystem
getOrCreateNewExternalDataManagementSystem(java.lang.String code)
Gets or creates external data management system from the openBIS AS.IFileFormatType
getOrCreateNewFileFormatType(java.lang.String code)
Gets or creates file format type from the openBIS AS.IMaterialType
getOrCreateNewMaterialType(java.lang.String code)
Gets or creates material type from the openBIS AS.IPropertyType
getOrCreateNewPropertyType(java.lang.String code, DataType dataType)
Gets or creates property type from the openBIS AS.ISampleType
getOrCreateNewSampleType(java.lang.String code)
Gets or creates sample type from the openBIS AS.IScript
getOrCreateNewScript(java.lang.String code)
Gets or creates a script from the openBIS AS.IVocabulary
getOrCreateNewVocabulary(java.lang.String code)
Gets or creates vocabulary type from the openBIS AS.IPropertyTypeImmutable
getPropertyType(java.lang.String code)
Get a property type from the openBIS AS.ISampleTypeImmutable
getSampleType(java.lang.String code)
Get a sample type from the openBIS AS.IScriptImmutable
getScript(java.lang.String code)
Get a script from the openBIS AS.IVocabularyImmutable
getVocabulary(java.lang.String code)
Get a vocabulary from the openBIS AS.IVocabularyTerm
getVocabularyTerm(IVocabularyImmutable vocabulary, java.lang.String vocabularyTermCode)
Returns the vocabulary term with specified code from the specified vocabulary.java.util.List<IDataSetTypeImmutable>
listDataSetTypes()
Return all data set types existing in the openBIS AS.java.util.List<IExperimentTypeImmutable>
listExperimentTypes()
Return all experiment types existing in the openBIS AS.java.util.List<IExternalDataManagementSystemImmutable>
listExternalDataManagementSystems()
Return all external data management systems existing in the openBIS AS.java.util.List<IFileFormatTypeImmutable>
listFileFormatTypes()
Return all file format types existing in the openBIS AS.java.util.List<IMaterialTypeImmutable>
listMaterialTypes()
Return all material types existing in the openBIS AS.java.util.List<IPropertyAssignmentImmutable>
listPropertyAssignments()
Return a list of all existing property assignments.java.util.List<IPropertyTypeImmutable>
listPropertyTypes()
Return all property types existing in the openBIS AS.java.util.List<ISampleTypeImmutable>
listSampleTypes()
Return all sample types existing in the openBIS AS.java.util.List<IScriptImmutable>
listScripts()
Return all scripts existing in the openBIS AS.java.util.List<IVocabularyImmutable>
listVocabularies()
Return all vocabularies existing in the openBIS AS.void
updateVocabularyTerm(IVocabularyTerm term)
Updates the specified vocabulary term.
-
-
-
Method Detail
-
createNewExperimentType
IExperimentType createNewExperimentType(java.lang.String code)
Create a new experiment type to register with the openBIS AS.- Parameters:
code
- the experiment type's code.
-
getExperimentType
IExperimentTypeImmutable getExperimentType(java.lang.String code)
Get an experiment type from the openBIS AS. Returns null if the experiment type does not exist.- Returns:
- An experiment type or null
-
getOrCreateNewExperimentType
IExperimentType getOrCreateNewExperimentType(java.lang.String code)
Gets or creates experiment type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listExperimentTypes
java.util.List<IExperimentTypeImmutable> listExperimentTypes()
Return all experiment types existing in the openBIS AS.
-
createNewSampleType
ISampleType createNewSampleType(java.lang.String code)
Create a new sample type to register with the openBIS AS.- Parameters:
code
- the sample type's code.
-
getSampleType
ISampleTypeImmutable getSampleType(java.lang.String code)
Get a sample type from the openBIS AS. Returns null if the sample type does not exist.- Returns:
- A sample type or null
-
getOrCreateNewSampleType
ISampleType getOrCreateNewSampleType(java.lang.String code)
Gets or creates sample type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listSampleTypes
java.util.List<ISampleTypeImmutable> listSampleTypes()
Return all sample types existing in the openBIS AS.
-
createNewDataSetType
IDataSetType createNewDataSetType(java.lang.String code)
Create a new data set type to register with the openBIS AS.- Parameters:
code
- the data set type's code.
-
getDataSetType
IDataSetTypeImmutable getDataSetType(java.lang.String code)
Get a data set type from the openBIS AS. Returns null if the data set type does not exist.- Returns:
- A data set type or null
-
getOrCreateNewDataSetType
IDataSetType getOrCreateNewDataSetType(java.lang.String code)
Gets or creates data set type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listDataSetTypes
java.util.List<IDataSetTypeImmutable> listDataSetTypes()
Return all data set types existing in the openBIS AS.
-
getScript
IScriptImmutable getScript(java.lang.String code)
Get a script from the openBIS AS. Returns null if the script does not exist.- Returns:
- A script or null
-
getOrCreateNewScript
IScript getOrCreateNewScript(java.lang.String code)
Gets or creates a script from the openBIS AS.- Returns:
- the already existing script or a freshly created one if it doesn't exist. Setter methods on the returned script are ignored if the script already exists.
-
listScripts
java.util.List<IScriptImmutable> listScripts()
Return all scripts existing in the openBIS AS.
-
createNewMaterialType
IMaterialType createNewMaterialType(java.lang.String code)
Create a new material type to register with the openBIS AS.- Parameters:
code
- the material type's code.
-
getMaterialType
IMaterialTypeImmutable getMaterialType(java.lang.String code)
Get a material type from the openBIS AS. Returns null if the material type does not exist.- Returns:
- A material type or null
-
getOrCreateNewMaterialType
IMaterialType getOrCreateNewMaterialType(java.lang.String code)
Gets or creates material type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listMaterialTypes
java.util.List<IMaterialTypeImmutable> listMaterialTypes()
Return all material types existing in the openBIS AS.
-
createNewPropertyType
IPropertyType createNewPropertyType(java.lang.String code, DataType dataType)
Create a new property type to register with the openBIS AS.- Parameters:
code
- the property type's code.dataType
- the data type of the property
-
getPropertyType
IPropertyTypeImmutable getPropertyType(java.lang.String code)
Get a property type from the openBIS AS. Returns null if the property type does not exist.- Returns:
- A property type or null
-
getOrCreateNewPropertyType
IPropertyType getOrCreateNewPropertyType(java.lang.String code, DataType dataType)
Gets or creates property type from the openBIS AS.- Parameters:
dataType
- the data type of the property in case it has to be created.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listPropertyTypes
java.util.List<IPropertyTypeImmutable> listPropertyTypes()
Return all property types existing in the openBIS AS.
-
assignPropertyType
IPropertyAssignment assignPropertyType(IEntityType entityType, IPropertyTypeImmutable propertyType)
Assigns a property type to an entity type. If the assignment is already established an object is returned where all setter method invocations are silently be ignored.- Parameters:
entityType
- One of IExperimentTypeImmutable, ISampleTypeImmutable, IDataSetTypeImmutable, or IMaterialTypeImmutable.propertyType
- The property type to assign to the entity type.- Returns:
- An object representing the assignment.
-
listPropertyAssignments
java.util.List<IPropertyAssignmentImmutable> listPropertyAssignments()
Return a list of all existing property assignments.
-
createNewFileFormatType
IFileFormatType createNewFileFormatType(java.lang.String code)
Create a new file format type to register with the openBIS AS.- Parameters:
code
- the file format type's code.
-
getFileFormatType
IFileFormatTypeImmutable getFileFormatType(java.lang.String code)
Get a file format type from the openBIS AS. Returns null if the file format type does not exist.- Returns:
- A file format type or null
-
getOrCreateNewFileFormatType
IFileFormatType getOrCreateNewFileFormatType(java.lang.String code)
Gets or creates file format type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listFileFormatTypes
java.util.List<IFileFormatTypeImmutable> listFileFormatTypes()
Return all file format types existing in the openBIS AS.
-
createNewVocabulary
IVocabulary createNewVocabulary(java.lang.String code)
Create a new sample type to register with the openBIS AS.- Parameters:
code
- the sample type's code.
-
getVocabulary
IVocabularyImmutable getVocabulary(java.lang.String code)
Get a vocabulary from the openBIS AS. Returns null if the vocabulary does not exist.- Returns:
- A vocabulary or null
-
getOrCreateNewVocabulary
IVocabulary getOrCreateNewVocabulary(java.lang.String code)
Gets or creates vocabulary type from the openBIS AS.- Returns:
- the already existing type or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listVocabularies
java.util.List<IVocabularyImmutable> listVocabularies()
Return all vocabularies existing in the openBIS AS.
-
createNewVocabularyTerm
IVocabularyTerm createNewVocabularyTerm(java.lang.String code)
Create a new vocabulary term. The resulting object can be added to a vocabulary via theIVocabulary.addTerm(IVocabularyTerm)
method.- Parameters:
code
- the vocabulary term's code
-
getVocabularyTerm
IVocabularyTerm getVocabularyTerm(IVocabularyImmutable vocabulary, java.lang.String vocabularyTermCode)
Returns the vocabulary term with specified code from the specified vocabulary.- Throws:
java.lang.IllegalArgumentException
- if the specified vocabulary or term doesn't exists.
-
updateVocabularyTerm
void updateVocabularyTerm(IVocabularyTerm term)
Updates the specified vocabulary term.
-
createNewExternalDataManagementSystem
IExternalDataManagementSystem createNewExternalDataManagementSystem(java.lang.String code)
Create a new external data management system to register with the openBIS AS.- Parameters:
code
- the external data management system's code.
-
getExternalDataManagementSystem
IExternalDataManagementSystemImmutable getExternalDataManagementSystem(java.lang.String code)
Get an external data management system from the openBIS AS. Returns null if the external data management system does not exist.- Returns:
- An external data management system or null
-
getOrCreateNewExternalDataManagementSystem
IExternalDataManagementSystem getOrCreateNewExternalDataManagementSystem(java.lang.String code)
Gets or creates external data management system from the openBIS AS.- Returns:
- the already existing system or a freshly created one if it doesn't exist. Setter methods on the returned type are ignored if the type already exists.
-
listExternalDataManagementSystems
java.util.List<IExternalDataManagementSystemImmutable> listExternalDataManagementSystems()
Return all external data management systems existing in the openBIS AS.
-
-