wt.admin
Interface AdministrativeDomainManager

All Known Implementing Classes:

StandardAdministrativeDomainManager

public interface AdministrativeDomainManager

The AdministrativeDomainManager is an interface that contains signatures of methods that retrieve and manipulate domain objects.

Supported API: true

Extendable: false

Method Summary

EnumeratorVector	allDomainRefs() Returns an enumeration of administrative domain references.
Enumeration	allDomains() Retrieves all domains defined in the system.
wt.admin.DomainAdministered	changeAdministrativeDomain(wt.admin.DomainAdministered obj, AdminDomainRef domain_ref) Changes the domain to which the object belongs and sets domain inheritence to false.
wt.admin.DomainAdministered	changeAdministrativeDomain(wt.admin.DomainAdministered obj, AdminDomainRef domain_ref, boolean inheritedDomain) Changes the domain to which the object belongs.
WTList	changeAdministrativeDomain(WTList objs, AdminDomainRef domain_ref, boolean inheritedDomain) Multi-object version of the changeAdministrativeDomain() API.
WTList	changeAdministrativeDomain(WTList objs, WTList domain_refs, boolean inheritedDomain) Multi-object version of the changeAdministrativeDomain() API.
AdminDomainRef	createDomain(AdminDomainRef domainRef, String name, String description) Deprecated.
AdminDomainRef	createDomain(AdminDomainRef domainRef, String name, String description, WTContainerRef container_ref) Create an administrative domain with the given name and description in the specified domain and in the specified container.
void	delete(AdminDomainRef domain) Deletes the referenced administrative domain.
SortedSet	getAllEvents(Locale locale) Returns the set of all events defined in the system sorted alphabetically.
Hashtable	getClassHierarchy(String from_class) Deprecated.
String	getDisplayDomainPath(AdminDomainRef domain_ref) Retrieves the path name in displayable form for an administrative domain given the domain_ref.
String	getDisplayDomainPath(AdministrativeDomain domain) Retrieves the path name in displayable form for an administrative domain.
AdministrativeDomain	getDomain(String domain_path) Retrieves an administrative domain given its domain name or domain path name.
AdministrativeDomain	getDomain(String domain_path, WTContainerRef container_ref) Retrieves an administrative domain given its path name within a container.
String	getDomainPath(AdminDomainRef domain_ref) Retrieves the path name in external form for an administrative domain given the domain reference.
String	getDomainPath(AdministrativeDomain domain) Retrieves the path name in external form for the given administrative domain.
void	setAdministratorRule(AdminDomainRef domainRef) Creates an access control rule giving the administrator all the rights in the domain identified by the given domain reference.
void	setAdministratorRule(AdministrativeDomain domain) Creates an access control rule giving the administrator all the rights in the given domain.
void	setDomainDescription(AdminDomainRef domainRef, String newDescription) Updates the description of the referenced administrative domain.
AdminDomainRef	updateDomain(AdminDomainRef domainRef, String name, String description) Update an administrative domain with the given name and description.

Method Detail

getDomain

AdministrativeDomain getDomain(String domain_path)
                               throws WTException

Retrieves an administrative domain given its domain name or domain path name. If no such domain is found, null is returned. If an unexpected error condition occurs, an exception is thrown.

If no container information is specified within the input domain path (or if only a domain name is provided), a container is derived depending on the input value.

Valid formats for domain_path include:

1. domain name (e.g., Design)
2. domain path (e.g., /Design, /Marketing/Brochures, etc.)
3. [container-path]/domain-path (the external form of the domain path)

Resulting actions for the different input formats:

1. domain name
   If domain name is one of the special domain names configurable via wt.admin properties in the wt.properties file, the named domain whose parent is the root domain and resides in the Site container is returned. If the domain name is not one of the special domains, the named domain whose parent is the root domain and resides in the Windchill PDM Library container is returned.
2. domain path
   If domain path is the path for one of the special domains (e.g., /System) the special domain whose parent is the root domain and resides in the Site container is returned; otherwise the domain corresponding to the domain path that resides in the Windchill PDM Library container is returned. Note that in this case the domain path must be relative to the Windchill PDM Library container. This means that all domains in the path must reside in the Windchill PDM Library container.
3. external form of the domain path ([container-path]/domain-path )
   This is the external form of the domain path. For a description of the external form see the getDomainPath APIs. In this case, the administrative domain corresponding to the domain-path and residing in the container corresponding to the container-path is returned. Note that the domain-path portion must be relative to the container specified by the container-path portion.

Supported API: true

Parameters:

domain_path - Required. Specifies the administrative domain path or the domain name.

Returns:

AdministrativeDomain

Throws:

WTException

getDomain

AdministrativeDomain getDomain(String domain_path,
                               WTContainerRef container_ref)
                               throws WTException

Retrieves an administrative domain given its path name within a container. If no such domain is found, null is returned. If an unexpected error condition occurs, an exception is thrown.

Supported API: true

Parameters:

domain_path - Required. The domain path of the administrative domain. This must be a path name (i.e., it must start with "/"). The domain path is relative to the container specified by the container_ref parameter. This means that all of the domains contained in the domain path must reside in the container specified by container_ref.

container_ref - Required. The container the domain path is relative to.

Returns:

AdministrativeDomain

Throws:

WTException

getDomainPath

String getDomainPath(AdministrativeDomain domain)
                     throws WTException

Retrieves the path name in external form for the given administrative domain. If the administrative domain isn't found, null is returned.

To get the domain path name in displayable form use the getDisplayDomainPath API.

The format for the external form of the domain path is [container-path]/domain-path (the brackets are included) where container-path is the form /containerType=name/containerType=name/.../containerType=name

For example:
[/wt.inf.container.OrgContainer=DefaultOrg/wt.inf.library.WTLibrary=Windchill PDM]/Design

See the ContainerPath.getExternalForm() API for more information about the container-path external form. The domain-path is relative to the container meaning that all of the domains in the domain path reside in the container. The external form of the domain path can be used as input to the getDomain(String domain_path) API.

Supported API: true

Parameters:

domain - Required. The administrative domain.

Returns:

String

Throws:

WTException

getDomainPath

String getDomainPath(AdminDomainRef domain_ref)
                     throws WTException

Retrieves the path name in external form for an administrative domain given the domain reference. If the administrative domain isn't found, null is returned. See the getDomainPath(AdministrativeDomain domain) API for more information.

Supported API: true

Parameters:

domain_ref - Required. The administrative domain reference.

Returns:

String

Throws:

WTException

getDisplayDomainPath

String getDisplayDomainPath(AdministrativeDomain domain)
                            throws WTException

Retrieves the path name in displayable form for an administrative domain. If the administrative domain isn't found, null is returned.

To get the domain path name in external form use the getDomainPath API.

The format for the displayable form of the domain path is container-path /domain-path where container-path is the form containerType Name,containerType Name,...,containerType Name

For example:
Site,Organization DefaultOrg,Library Windchill PDM /Marketing/Brochures

See the ContainerPath.getDisplayForm() API for more information about the container-path display form.

The domain-path is relative to the container meaning that all of the domains in the domain path reside in the container.

Note that access control is applied to the domain path before it is returned so if a user isn't allowed to see a portion of the path the String (Secured information) is inserted in the domain path. For example, from the above example if the user doesn't have access to container DefaultOrg and domain Marketing the returned domain path is:
(Secured information),Library Windchill PDM /(Secured information)/Brochures

Supported API: true

Parameters:

domain - Required. The administrative domain.

Returns:

String

Throws:

WTException

getDisplayDomainPath

String getDisplayDomainPath(AdminDomainRef domain_ref)
                            throws WTException

Retrieves the path name in displayable form for an administrative domain given the domain_ref. If the administrative domain isn't found, null is returned. See the getDisplayDomainPath(AdministrativeDomain domain) API for more information.

Supported API: true

Parameters:

domain_ref - Required. The administrative domain reference.

Returns:

String

Throws:

WTException

allDomains

Enumeration allDomains()
                       throws WTException

Retrieves all domains defined in the system.

Supported API: true

Returns:

Enumeration

Throws:

WTException

allDomainRefs

EnumeratorVector allDomainRefs()
                               throws WTException

Returns an enumeration of administrative domain references.

Supported API: true

Returns:

EnumeratorVector

Throws:

WTException

getAllEvents

SortedSet getAllEvents(Locale locale)
                       throws WTException

Returns the set of all events defined in the system sorted alphabetically.

Supported API: true

Parameters:

locale -

Returns:

SortedSet

Throws:

WTException

createDomain

AdminDomainRef createDomain(AdminDomainRef domainRef,
                            String name,
                            String description)
                            throws WTException,
                                   WTPropertyVetoException

Deprecated.

Create an administrative domain with the given name and description in the specified domain. Returns a reference to the new domain.

Supported API: true

Parameters:

domainRef - Domain reference of parent domain

name - Domain name

description - Domain description

Returns:

AdminDomainRef

Throws:

WTException

WTPropertyVetoException

See Also:

createDomain(AdminDomainRef, String, String, WTContainerRef)

createDomain

AdminDomainRef createDomain(AdminDomainRef domainRef,
                            String name,
                            String description,
                            WTContainerRef container_ref)
                            throws WTException,
                                   WTPropertyVetoException

Create an administrative domain with the given name and description in the specified domain and in the specified container. Returns a reference to the new domain.

Supported API: true

Parameters:

domainRef -

name -

description -

container_ref -

Returns:

AdminDomainRef

Throws:

WTException

WTPropertyVetoException

changeAdministrativeDomain

wt.admin.DomainAdministered changeAdministrativeDomain(wt.admin.DomainAdministered obj,
                                                       AdminDomainRef domain_ref)
                                                       throws WTException

Changes the domain to which the object belongs and sets domain inheritence to false. Posts PRE_CHANGE_DOMAIN and POST_CHANGE_DOMAIN events. Persists and returns the changed object. Throws an AdministrativeDomainException if the object is not persistent.

Supported API: true

Parameters:

obj - A domain administered object. If obj is null, a WTInvalidParameterException is thrown.

domain_ref - The new administrative domain reference for the domain administered object. If domain_ref is null, a WTInvalidParameterException is thrown.

Returns:

DomainAdministered

Throws:

WTException

changeAdministrativeDomain

wt.admin.DomainAdministered changeAdministrativeDomain(wt.admin.DomainAdministered obj,
                                                       AdminDomainRef domain_ref,
                                                       boolean inheritedDomain)
                                                       throws WTException,
                                                              WTPropertyVetoException

Changes the domain to which the object belongs. Posts PRE_CHANGE_DOMAIN and POST_CHANGE_DOMAIN events. Persists and returns the changed object. Throws an AdministrativeDomainException if the object is not persistent.

Supported API: true

Parameters:

obj - A domain administered object. If obj is null, a WTInvalidParameterException is thrown.

domain_ref - The new administrative domain reference for the domain administered object. If domain_ref is null, a WTInvalidParameterException is thrown.

inheritedDomain - Set to true if the domain is inherited, otherwise set to false

Returns:

DomainAdministered

Throws:

WTException

WTPropertyVetoException

changeAdministrativeDomain

WTList changeAdministrativeDomain(WTList objs,
                                  AdminDomainRef domain_ref,
                                  boolean inheritedDomain)
                                  throws WTException,
                                         WTPropertyVetoException

Multi-object version of the changeAdministrativeDomain() API. For each DomainAdministered object in the objs collection, the domain reference for the domain to which the object belongs is changed to the domain reference specified by the domain_ref parameter.

The objs collection must contain one or more DomainAdministered objects. The exception is if you want to change the domain that an AdministrativeDomain object belong to. In this case the objs collection can contain only one DomainAdministered object which is the AdministrativeDomain object being modified.

Multi-object PRE_CHANGE_DOMAIN and POST_CHANGE_DOMAIN events are posted before and after changing the DomainAdministered objects in the objs collection.

The domain changes for each DomainAdministered object in the objs collection are persisted and a collection of the modified DomainAdministered objects is returned.

If any of the DomainAdministered objects in the objs collection are not persistent, an AdministrativeDomainException is thrown.

Supported API: true

Parameters:

objs - Collection of DomainAdministered objects to be changed. If obj is null or empty, a WTInvalidParameterException is thrown.

domain_ref - The new AdminDomainRef to be assigned to each of the DomainAdministered objects in the objs collection. If domain_ref is null, a WTInvalidParameterException is thrown.

inheritedDomain - Set to true if the domain is inherited; otherwise, set to false

Returns:

WTList

Throws:

WTException

WTPropertyVetoException

changeAdministrativeDomain

WTList changeAdministrativeDomain(WTList objs,
                                  WTList domain_refs,
                                  boolean inheritedDomain)
                                  throws WTException,
                                         WTPropertyVetoException

Multi-object version of the changeAdministrativeDomain() API. For each DomainAdministered object in the objs collection, the domain reference for the domain to which the object belongs is changed to the domain reference specified by the corresponding AdminDomainRef object in the domain_refs collection.

The objs collection must contain one or more DomainAdministered objects. The exception is if you want to modify the domain that an AdministrativeDomain object belongs to. In this case the objs collection can contain only one DomainAdministered object which is the AdministrativeDomain object being modified. If objs contains multiple objects and one or more of them is an AdministrativeDomain, a AdministrativeDomainException is thrown. If objs is null or empty, a WTInvalidParameterException is thrown.

The domain_refs collection must contain either 1) a single AdminDomainRef object or 2) the same number of AdminDomainRef objects as there are DomainAdministered objects in the objs collection. If domain_refs contains one AdminDomainRef, this AdminDomainRef is assigned to each DomainAdministered object in the objs collection; otherwise, the first AdminDomainRef is assigned to the first DomainAdministered object, the second AdminDomainRef is assigned to the second DomainAdministered object, and so on. If domain_refs is null, empty, or the wrong size, a WTInvalidParameterException is thrown.

Multi-object PRE_CHANGE_DOMAIN and POST_CHANGE_DOMAIN events are posted before and after changing the DomainAdministered objects in the objs collection.

The domain changes for each DomainAdministered object in the objs collection are persisted and a collection of the modified DomainAdministered objects is returned.

If any of the DomainAdministered objects in the objs collection are not persistent, an AdministrativeDomainException is thrown.

Supported API: true

Parameters:

objs - Collection of DomainAdministered objects to be changed.

domain_refs - A collection of the new AdminDomainRef objects to be assigned to the corresponding DomainAdministered objects in the objs collection.

inheritedDomain - Set to true if the domain is inherited; otherwise, set to false

Returns:

WTList

Throws:

WTException

WTPropertyVetoException

delete

void delete(AdminDomainRef domain)
            throws WTException

Deletes the referenced administrative domain. A domain cannot be deleted if it is referenced by other objects (for example, it has children or associated policy rules).

Supported API: true

Parameters:

domain -

Throws:

WTException

getClassHierarchy

Hashtable getClassHierarchy(String from_class)
                            throws WTException

Deprecated.

Returns the class hierarchy that extends (or implements) the class (or interface) passed as parameter. The hierarchy is returned in the form of a Hashtable, where the keys are the classes that extend (implement) the argument class and the values are vectors of names of the classes that extend the class in the key. All names of the classes are full qualified.

Normally only concrete classes plus wt.fc.WTObject are returned. A list of abstract classes (that implement from_class) may be included by setting the property

wt.admin.hierarchyListAdditions.=class1,class2,...

Deprecated. Use introspection methods defined by the TypeModel (package com.ptc.core.meta.type.runtime.server) to get a type hierarchy.

Supported API: true

Parameters:

from_class -

Returns:

Hashtable

Throws:

WTException

setAdministratorRule

void setAdministratorRule(AdministrativeDomain domain)
                          throws WTException

Creates an access control rule giving the administrator all the rights in the given domain.

Supported API: true

Parameters:

domain -

Throws:

WTException

setAdministratorRule

void setAdministratorRule(AdminDomainRef domainRef)
                          throws WTException

Creates an access control rule giving the administrator all the rights in the domain identified by the given domain reference.

Supported API: true

Parameters:

domainRef -

Throws:

WTException

setDomainDescription

void setDomainDescription(AdminDomainRef domainRef,
                          String newDescription)
                          throws WTException,
                                 WTPropertyVetoException

Updates the description of the referenced administrative domain.

Supported API: true

Parameters:

domainRef -

newDescription -

Throws:

WTException

WTPropertyVetoException

updateDomain

AdminDomainRef updateDomain(AdminDomainRef domainRef,
                            String name,
                            String description)
                            throws WTException,
                                   WTPropertyVetoException

Update an administrative domain with the given name and description.

Supported API: true

Parameters:

domainRef - Domain reference of the domain to update

name - new domain name

description - new domain description

Returns:

AdminDomainRef

Throws:

WTException

WTPropertyVetoException