Ifd:getChildrenConcepts

API version 2
IfdConceptInRelationship[] getChildrenConcepts(                                     String concept_guid,                                      String[] context_guids,                                      IfdRelationshipTypeEnum [] relationship_types,                                      IfdLanguage[] languages,                                      String session_id) throws IfdServerException

Express heading QUERY_FUNCTION getChildrenConcepts(                                concept_guid : STRING;                                 context_guids : LIST OF STRING;                                  relationship_types : LIST OF STRING;                                 languages : LIST OF IfdLanguage) : LIST OF IfdConceptInRelationship;

''Function to list the children(related concepts) of the concept with the given guid, constrained by the given array of contexts, the given array of relationship_types and the given array of languages. The children are returned as an array of IfdConceptInRelationship''

Input:
 * - the concept_guid for which we want the parents
 * - array of context_guids in which you want to constrain the results
 * - array of relationships from enumeration of the selected IfdRelationshipTypeEnum
 * - array of languages in which you want to constrain the results
 * - the session id for the current user

Return:
 * - an array containing the requested parents

Comments: -The Concept parameter should be the guid of the Concept, not the Concept itself. (resolved) -The Context parameter is not clear, what is it used for, what content might it have? I suggest to leave it out. (declined) -The language parameter is not needed, I suggest to leave it out. (declined) -An additional parameter is needed for filtering between Definition and Specification. For this I suggest to use IfdPropertyTypeEnum. (not relevant here) -The function should only return a list of guids. (declined)

API version 3
Function public IfdConceptInRelationship[] getChildrenConcepts(                      String session_id,                       String concept_guid,                       String[] context_guids,                       IfdRelationshipTypeEnum [] relationship_types,                       IfdLanguage[] languages) throws Ifd:IfdServerException

EXPRESS heading QUERY_FUNCTION getChildrenConcepts(                      concept_guid : STRING;                        context_guids,                       relationship_types : LIST OF STRING;                       languages : LIST OF IfdLanguage): LIST OF IfdConceptInRelationship;

The function collects all child concepts related to the specified IFD concept.

Input:
 * string session_id - the session id for the current user
 * string concept_guid - global unique id of a parent IFD concept;
 * string context_guids[] - (optional) list of global unique id-s of the required relationship contexts – the function returns only children related to parent in specified contexts; the aggregate can be unset or empty if user is looking for relationships in any available for him contexts.
 * IfdRelationshipTypeEnum relationship_types[] - (optional) list of required IfdRelationshipTypeEnum types. The list can be unset or empty to get all kind children of specified concept;
 * IfdLanguage languages[] - (optional) list of languages to represent child concepts, in all languages by default

Return: IfdConceptInRelationship[] - List of children of the parent concept. Every element of the output has the following attributes:
 * base - fully specified (in all specified languages) child concept with the same attributes as in getConcept
 * relationship_type - type of the relationship (one of relationship_types if specified)
 * context_guids - list of not restricted contexts of the relationship

Difference against v.2.00
 * (69) Depending of target population structure and volume it responds 2-3 times quicker then in v.2.00;
 * (70) In v.2.00 the function did not provide any error handling;
 * (71) In v.2.00 the function did not check if any children were defined in restricted for the user context and returned everything;
 * (72) In v.2.00 the function ignored input context_guids;
 * (73) In v.2.00 the function had a bug working with 'ASSIGNS_COLLECTIONS': meeting children of the relationship the function stopped work and returned nothing;
 * (74) The function returns children in scope of 'ASSIGNS_PROPERTY_WITH_VALUES' relationship. In v.2.00 the function ignored the relationship type. To make the current version blend against the type of relationship set its internal constant SHOW_CONSTRAINED_VALUES := FALSE;
 * (75) The function maps children activities to the ISO 12006-3 xtd_activity.next_activities.RelatingActivity. The function in v.2.00 maps them in mistake to opposite arm of the relationship: xtd_activity.next_activities.RelatedActivities.