Ifd:addNamesToConcept

API version 2
public IfdName [] addNamesToConcept (                                      String concept-guid,                                       IfdName[] names,                                       String session_id ) throws IfdServerException

Function to add one or more IfdNames to a concept. The function takes an array of IfdName as input in addition to the global unique identifier for the concept itself and the session_id.

Input:
 * - The global unique identifier for the concept to which we want to add names (names may not exist in the library)
 * - Array of one or more IfdNames.
 * - The session id for the active user

Returns:in addition to the global unique identifier for the concept itself
 * - An array of IfdNames.

API version 3
Function public IfdName [] addNamesToConcept (                                       String session_id,                                       String concept_guid,                                       IfdName[] names) throws IfdServerException

EXPRESS heading QUERY_FUNCTION addNamesToConcept(                      concept_guid : STRING;                       names : LIST OF IfdName): LIST OF IfdName;

The function adds more names the specified concept.

Input: IfdName [] names - list of fully specified names to be added to the concept, with the following parameters:
 * - The session id for the active user
 * - global unique id of the target concept;
 * guid – (optional) global unique id of the name existing in database. If the item defined yet in target population the attribute shall be set (as well as other attributes) and existing name will be assigned to the concept;
 * language – (optional) language of the name (shall be defined yet in target population and specified by guid or language_code), by default it is dedicated language with code equal to internal constant DEFAULT_LANGUAGE_CODE (‘en’ in current version);
 * name – text of the name;
 * name_type – (optional) type of the name, shall be one of the following: 'FULLNAME' (default), 'SHORTNAME' or ‘LEXEME’;
 * preferred_by – (optional) aggregate of organizations which will prefer the name, by default set with home organization of the logged user;
 * descr_type - type of the descriptions to use by default: 'COMMENT' or 'DEFINITION'

Returns:

IfdName [] - List of fully specified names of the specified concept added with the function. Every element of the aggregate will have the following attributes:
 * guid - global unique id of the name;
 * language - language of the name;
 * name - 	text of the name;
 * name_type - type of the name, one of the following: 'FULLNAME', 'SHORTNAME' or ‘LEXEME’;
 * preferred_by - aggregate of organizations which prefer the name

Difference against v.2.00
 * (40)	Depending of input parameters and target population structure and volume it responds 2-3 times quicker then in v.2.00;
 * (41)	The function can accept language specification by default in contrast to v.2.00;
 * (42)	The function keeps the last date/time of concept change and cares about constraint xtdRoot.has_preferred_representations (mandatory SET[1:?]) specified by ISO12006-3. In v.2.00 the function did not care about the both;
 * (43)	The function checks type of the concept and allows adding description to the context only to its owners. In v.2.00 the function did not check the case

Comments: