OrgChart Class Methods
These methods are used by the OrgChart class. The methods are described in alphabetic order.
Syntax
SetCrumbData(&Rowset)
Description
Use the SetCrumbData method to specify the source for the data for the organization chart breadcrumbs. Use an already instantiated and populated level-1 component rowset that contains the breadcrumb data.
Parameters
Field or Control |
Definition |
---|---|
&Rowset |
A level-1 rowset populated with the breadcrumbs data. |
Returns
None.
Syntax
SetCrumbRecord(Record.Record_Name)
Description
Use the SetCrumbRecord method to specify the derived/working record name that contains the information about the breadcrumbs.
The breadcrumb record is an application-specific derived/work record created using a clone of the PTORGCRMB_SBR subrecord definition.
Parameters
Field or Control |
Definition |
---|---|
Record.Record_Name |
Specify the name of the derived/work record that contains the data for the breadcrumbs. You must include the Record keyword. |
Returns
None.
Syntax
SetDropdownData (&Rowset)
Description
Use the SetDropdownData method to specify the source for the data for the organization chart drop-down menus/lists. Use an already instantiated and populated level-1 component rowset that contains the drop-down list data.
Parameters
Field or Control |
Definition |
---|---|
&Rowset |
A level-1 rowset populated with the drop-down list data. |
Returns
None
Syntax
SetDropDownRecord(Record.RecordName)
Description
Use the SetDropdownRecord method to specify the derived/working record name that contains the information about the dropdown menus/lists.
The dropdown record is an application-specific derived/work record created using a clone of the PTORGBOXLST_SBR subrecord definition.
Parameters
Field or Control |
Definition |
---|---|
Record_Name |
Specify the name of the derived/work record that contains the data for the drop down lists. You must include the Record keyword. |
Returns
None
Syntax
SetIMData (&rsRowset)
Description
Use the SetIMData method to specify the source for the IM data for the organization chart. Use a standalone rowset that contains the IM data.
This method is required for an organization chart that implements IM presence.
Parameters
Field or Control |
Definition |
---|---|
&rsRowset |
A standalone rowset populated with the node display data. This rowset references the IM record of the organization chart. |
Returns
None.
Syntax
SetIMRecord(Record.Record_Name)
Description
Use the SetIMRecord method to specify the IM data record.
The IM data record is an application-specific derived/work record created using a clone of the PTORGIM_SBR subrecord definition.
This method is required for an organization chart that implements IM presence.
Parameters
Field or Control |
Definition |
---|---|
Record.Record_Name |
Specify the name of the derived/work record that contains the IM data for the organization chart. You must include the Record keyword. |
Returns
None.
Syntax
SetLegend(&Array_of_String)
Description
Use the SetLegend method to specify legend text. Legend text labels the images set using SetLegendImg.
If you do not specify an element for an array (that is, a blank or a null) then no legend is listed for that node.
Note: Legend text is not automatically translated. If you set your own labels, be sure to use translated text, such as message catalog entries.
Parameters
Field or Control |
Definition |
---|---|
&Array_of_String |
Specify an already instantiated array of string, containing the text that you want to use for the legend. |
Returns
None.
Example
&LegendArray = CreateArray("A", "B", C", "D ");
&ocOrgChart.SetLegend (&LegendArray);
Syntax
SetLegendImg(&Array_of_String)
Description
Use the SetLegendImg method to specify the legend image names.
Parameters
Field or Control |
Definition |
---|---|
&Array_of_String |
An already instantiated array containing the names of the images that you want to use with the legend. |
Returns
None.
Syntax
SetNodeData(&Rowset)
Description
Use the SetNodeData method to specify the source for the node data for the organization chart. Use an already instantiated and populated level-1 component rowset that contains the node data.
This is a required method to build an organization chart.
If you make a change to the underlying data of a chart, call the SetNodeData method again to update the chart.
Parameters
Field or Control |
Definition |
---|---|
&Rowset |
A level-1 component rowset populated with the node data. This rowset references the node record of the chart. |
Returns
None.
Syntax
SetNodeDisplayDataRecord(Record.Record_Name)
Description
Use the SetNodeDisplayDataRecord method to specify the node display record.
The node display record is an application-specific derived/work record created using a clone of the PTNODE_DISP_SBR subrecord definition.
This method is required for an organization chart that implements node display templates.
Parameters
Field or Control |
Definition |
---|---|
Record.Record_Name |
Specify the name of the derived/work record that contains the node display data for the organization chart. You must include the Record keyword. |
Returns
None.
Syntax
SetNodeDisplayData(&rsRowset)
Description
Use the SetNodeDisplayData method to specify the source for the node display data for the organization chart. Use an already instantiated and populated level-1 standalone rowset that contains the node display data.
This method is required for an organization chart that implements node display templates.
If you make a change to the node display data of a chart, call the SetNodeDisplayData method again to update the chart.
Parameters
Field or Control |
Definition |
---|---|
&rsRowset |
A level-1 component rowset populated with the node display data. This rowset references the node display record of the organization chart. |
Returns
None.
Syntax
SetNodeRecord(Record.Record_Name)
Description
Use the SetNodeRecord method to specify the organization node record.
The node record is an application-specific derived/work record created using a clone of the PTORGNODE_SBR subrecord definition.
This method is required to build an organization chart.
Parameters
Field or Control |
Definition |
---|---|
Record.Record_Name |
Specify the name of the derived/work record that contains the data for the organization node. You must include the Record keyword. |
Returns
None.
Syntax
SetNodeViewEntries(&NodeViewArray)
Description
Use this method to specify the array of string representing the node view IDs.
Parameters
Field or Control |
Definition |
---|---|
&NodeViewArray |
Specifies an array of string representing the node view IDs. |
Returns
None.
Example
&OrgChart.SetNodeViewEntries(&NodeViewArray);
&OrgChart.SetNodeViewText(&DataHintArray);
&OrgChart.InitialView="VIEW1";
Syntax
SetNodeViewText(&DataHintArray)
Description
Use this method to specify the array of string representing the data hint (mouse-over text) for each node view.
Parameters
Field or Control |
Definition |
---|---|
&DataHintArray |
Specifies an array of string representing the data hint (mouse-over text) for each node view. |
Returns
None.
Example
&OrgChart.SetNodeViewEntries(&NodeViewArray);
&OrgChart.SetNodeViewText(&DataHintArray);
&OrgChart.InitialView="VIEW1";
Syntax
SetPopUpNodeData(&Rowset)
Description
Use the SetPopUpNodeData method to specify the source for the pop-up node data for the organization chart. Use an already instantiated and populated level-1 component rowset that contains the pop-up node data.
This method is not required if no pop-up chart is available to be displayed in the organization chart.
If you make a change to the underlying data of a pop-up chart, call the SetPopUpNodeData method again to update the chart.
Parameters
Field or Control |
Definition |
---|---|
&Rowset |
A level-1 rowset populated with the pop-up node data. This rowset references the pop-up node record of the chart. |
Returns
None.
Syntax
SetPopUpNodeRecord(Record.Record_Name)
Description
Use the SetNodeRecord method to specify the pop-up node record.
The node record is an application-specific derived/work record created using a clone of the PTORGPOPUP_SBR subrecord definition.
This method is not required if no pop-up chart is available to be displayed in the organization chart.
Parameters
Field or Control |
Definition |
---|---|
Record.Record_Name |
Specify the name of the derived/work record that contains the data for the pop-up node. You must include the Record keyword. |
Returns
None.
Syntax
SetSchemaLevels(&Array) ;
Description
Use this method to specify the schema levels for an organization chart. Use an array of instantiated SchemalLevel instances. The size of the array is the total number of the schemas defined for this organization chart.
Parameters
Field or Control |
Definition |
---|---|
&Array |
An array of instantiated SchemalLevel instances. |
Returns
None.
Example
SchemaLevel &oSchemaLevel1 = Createobject("SchemaLevel");
SchemaLevel &oSchemaLevel2 = Createobject("SchemaLevel");
SchemaLevel &oSchemaLevel3 = Createobject("SchemaLevel");
SchemaLevel &oSchemaLevel4 = Createobject("SchemaLevel");
/*** Create an instance of of schema zoom level 1 class and instantiate it ***/
SchemaLevel &oSchemaLevel1 =Createobject("SchemaLevel");
&oSchemaLevel1.ID=1;
& oSchemaLevel1.ImageHeight=0;
.... (add code to instantiate &oSchemaLevel1, &oSchemaLevel2,
&oSchemaLevel3, &oSchemaLevel4 instances).
&SchemaLevels=CreateArray(&oSchemaLevel1, &oSchemaLevel2, &oSchemaLevel3, &oSchemaLevel4)
&ocOrgChart.SetZoomSchemaLevels(&SchemaLevls)