Maintaining Trees

This chapter discusses how to:

• Maintain trees.

• Maintain tree structures.

• Subscribe to TREE_CHANGE messages.

Maintaining Trees

This section discusses how to:

• Perform audits and delete trees.

• Copy trees.

• View trees.

Pages Used to Maintain Trees

Performing Audits and Deleting Trees

Access the Tree Maintenance page.

Key Type	Displays the key type associated with this tree. SetID Indirection: The tree is identified by tree name and setID. Business Unit: The tree is identified by a business unit. User Defined Node Key: The tree is identified by a user-defined key. None: The tree does not contain an additional key. It is keyed only by tree name and effective date.
User Key	Displays the user-defined node key. If the key type is None, the field is blank.
Valid Tree	Displays the status of the tree.
Perform Audits	To audit a tree, select its check box and click the button. The Last Audit field for the tree changes to Valid Tree if the tree passes the audit. If the tree fails the audit, the Last Audit field changes to Draft Tree. Note. You can get a detail listing of audit errors by running the Repair Tree batch program.
Copy	To access the Tree Definition and Properties page and copy a tree, select a tree check box and click the button.
Delete	To delete a tree, select its check box and click the button.
View	To access the Tree Viewer page and view a tree, select a tree check box and click the button.

Note. Trees secured by PeopleSoft Object Security for anything but full access are not listed and cannot be updated or deleted from the Tree Maintenance page.

See Also

Using the Repair Tree Program

Copying Trees

Access the Copy Tree page.

Make any necessary changes and click Copy.

Viewing Trees

Access the Tree Viewer page.

Note. Trees displayed in View mode do not differentiate between standard nodes and branches. All nodes expand and collapse so that you can view the whole tree. Use the Expand Node Hierarchy icon to expand all child nodes.

Click Close to return to the Tree Maintenance page.

Note. If the multi-user environment is enabled, users will not be able to delete a tree if any branch of the tree—or the tree itself—is checked out by any user.

Maintaining Tree Structures

This section discusses how to:

• Delete tree structures.

• Copy tree structures.

• View tree structures.

Pages Used to Maintain Tree Structures

Deleting Tree Structures

Access the Tree Structure Maintenance page.

Node Record Name	Displays the name of the record that stores information about the tree nodes.
Detail Record Name	Displays the name of the record definition that corresponds to the kind of detail value in the structure.
Copy	To access the Copy Tree Structure page and copy a structure, select a structure check box, then click the button.
Delete	To delete a tree structure, select its check box, then click the button. You cannot delete a structure that is currently being used by a tree.
View	To access the Tree Structure Properties page and view a structure, select a structure check box, then click the button.

Note. Tree structures secured by PeopleSoft Object Security for anything but full access are not listed and cannot be updated or deleted from the Tree Structure Maintenance page.

Copying Tree Structures

Access the Copy Tree Structure page.

To copy a tree structure:

1. Enter a new tree structure ID.

2. Change the description in the New Description field.

3. Click the Copy button.

You return to the Tree Structure Maintenance page. The new tree structure is listed.

Viewing Tree Structures

Access the Tree Structure Properties page.

Select the Levels, Nodes, and Details tabs to view additional information.

Click OK or Cancel to jump to the Tree Structure Maintenance page.

See Also

Understanding Tree Structure

Subscribing to TREE_CHANGE Messages

Every time you perform an action in PeopleSoft Tree Manager to change a tree (such as rename, delete, any kind of save, copy, branch, or unbranch), a TREE_CHANGE message is published with the Tree Key information in the PSTREEPUBSUB record. Through Application Designer, you can enter a subscription process that runs every time this message is published.

This section discusses how to:

• Enter a subscription process.

• Enter a subscription program.

Note. The field EVENT_ID is defined in the Financials database as a Char,20 field, and is used by a number of applications. In PeopleTools PSTREEPUBSUB, the field was defined as a Number,6. To avoid conflicts, EVENT_ID has been removed from PSTREEPUBSUB, and replaced with TREE_EVENT_ID.

This change may affect Apps who subscribe to the TREE_CHANGE event, and check for EVENT_ID in PeopleCode using field name.

Entering a Subscription Process

To enter a subscription process:

1. Select Go, PeopleTools, Application Designer.

2. Select File, Open.

3. Open a message as the Object Type.

4. Enter the selection criteria for the message and click Open.

   The record that is published is shown to the right. Your program can check for the following EVENT_ID numeric values:

   • TreeCopyMsg

   • TreeCreateMsg

   • TreeDeleteMsg

   • TreeRenameMsg

   • TreeChangeMsg (this includes any type of save)

Entering a Subscription Program

To enter a subscription program:

1. Right-click Message Subscription and select Insert Message Subscription.

   The Message Subscription Properties dialog box appears.

2. Enter the name of the PeopleCode program you want to run.

See Also

Creating Message Subscriptions