Organizational Chart: _getParent

Organizational Chart: _getParent

Returns a list containing either the direct parent of a node or all of the node's parents up to the root of the specified node

Syntax
Example

Syntax

CALL NOTIFY (orgchart-name, '_getParent', node-id, list-of-names, list-id<, all-levels>);

Argument Type Description

node-id
N specifies the numeric identifier of the node

list-of-names
C specifies a single, quoted string containing the names of the node variables whose values are to be returned in list-id. Separate multiple node variable names with a space. Specify 'ALL' to return the value of all variables.

list-id
N returns the identifier of an SCL list containing the values of items specified in list-of-names or a list of lists if all-levels is 'Y'.

all-levels
C specifies whether to return all levels of node parents:

'N' only the direct parent (the default)

'Y' all levels of parents (ancestors)

Argument	Type	Description
node-id	N	specifies the numeric identifier of the node
list-of-names	C	specifies a single, quoted string containing the names of the node variables whose values are to be returned in list-id. Separate multiple node variable names with a space. Specify 'ALL' to return the value of all variables.
list-id	N	returns the identifier of an SCL list containing the values of items specified in list-of-names or a list of lists if all-levels is 'Y'.
all-levels	C	specifies whether to return all levels of node parents:
		'N'	only the direct parent (the default)
		'Y'	all levels of parents (ancestors)

Example

In this example, MYLIST returns a list of lists containing the displayed text of all of the node's ancestors. Assume this code is in a labeled section specified in the Select Action window:

call notify('org1','_get_selected_',
             widgetid,nodeid);
if (nodeid eq 0) then return;
call notify('org1','_get_parent_',nodeid,
            'text',mylist,'y');

Chapter Contents
Previous
Next
Top of Page