Ifd:addValues
From dev.ifd-library.org
API version 2
Function public IfdValue [] addValues ( IfdValue[] values, String sessionId) throws IfdServerException
Function to add new values to the IFD Library. The function takes an array of IfdValue as input and in addition the session identifier
Input:
Returns: The updated array of values.
API version 3
Function public IfdValue [] addValues ( String sessionId, IfdValue[] values) throws IfdServerException
Express heading
QUERY_FUNCTION addValues(
values : LIST OF IfdValue): LIST OF IfdValue;
The function adds value concepts to the target IFD population.
Input:
- String - The session id for the active user.
IfdValue [] - list of fully specified value concepts to be created in target population, with the following attributes for every element:
- base – fully specified concept – base of value, see addConcepts description;
- upper_tolerance – (optional) upper bound of the value tolerance;
- lower_tolerance – (optional) lower bound of the value tolerance;
- tolerance_type – (optional) type of the tolerance, one of the following: 'REALVALUE' or ‘PERCENTAGE’;
- value_type – (optional) type of the value: 'STRING' 'INTEGER' 'REAL' 'BOOLEAN' 'LOGICAL'
- nominal_value – (optional) datum of the value concept
Returns:
IfdValue [] - List of fully specified value concepts created in the call. The values will be then identified by IfdValue.base.guid (generated by system or specified in input).
Difference with v.2.00
- (62) The last version is much more better in performance than v.2.00;
- (63) The function in one call creates fully specified IFD value concept and keep IFD population valid against ISO12006-3 constraints. In v.2.00 the function creates invalid (in terms of ISO12006-3) value concept without required names and preferences;
- (64) The function allows user manage concept’s guids and version id: just checking validity of the value if they are specified. The attributes are generated if unset in input: guid gets 22 letter string, version id is set to ‘1’. The function in v.2.00 just accepts any user input for the attributes without any checking;
- (65) If user keeps tolerance_type and value_type unset the function will unset corresponding attributes of the value concept. The function in v.2.00 by default set tolerance_type with ‘REALVALUE’ and value_type with ‘STRING’
Comments: