|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectwt.admin.AdministrativeDomainManagerFwd
The AdministrativeDomainManager is an interface that contains signatures
of methods that retrieve and manipulate domain objects.
Supported API: false
Extendable: false
Field Summary | |
private static String |
CLASSNAME
|
private static String |
FC_RESOURCE
|
(package private) static boolean |
SERVER
|
Fields inherited from interface wt.method.RemoteAccess |
versionID |
Constructor Summary | |
AdministrativeDomainManagerFwd()
|
Method Summary | |
EnumeratorVector |
allDomainRefs()
Returns an enumeration of administrative domain references. |
EnumeratorVector |
allDomainRefs(WTContainerRef container_ref,
boolean include_descendent_containers)
Retrieves references to domains of the specified container. |
Enumeration |
allDomains()
Retrieves all domains defined in the system. |
Enumeration |
allDomains(WTContainerRef container_ref,
boolean include_descendent_containers)
Retrieves all domains of the specified container. |
com.objectspace.jgl.OrderedSet |
allEvents(Locale locale)
Deprecated. |
DomainAdministered |
changeAdministrativeDomain(DomainAdministered obj,
AdminDomainRef domain_ref)
Changes the domain to which the object belongs and sets domain inheritence to false. |
DomainAdministered |
changeAdministrativeDomain(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. |
ArrayList |
getAncestorDomains(AdminDomainRef domain_ref)
Returns an ArrayList of ancestor domains and siblings of each of those domains, for the domain identified by the specified domain reference. |
ArrayList |
getAncestorDomains(AdminDomainRef domain_ref,
boolean includeSiblings)
Returns an ArrayList of ancestor domains and siblings of each of those domains, for the domain identified by the specified domain reference. |
ArrayList |
getChildDomains(AdminDomainRef domain_ref)
Returns an ArrayList of domain references for the child domains of the domain identified by the specified domain reference. |
ArrayList |
getChildDomains(AdminDomainRef domain_ref,
boolean includeChildContainers)
Returns an ArrayList of domain references for the child domains of the domain identified by the specified domain reference and residing in the same container. |
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. |
String |
getDisplayPathOfDomain(AdminDomainRef domain_ref)
Retrieves just the domain part of the path name in display form for an administrative domain given the domain reference. |
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. |
AdministrativeDomain |
getGlobalDomain(String name)
Retrieves one of the four special pre-defined domains (Root, Default, System, and User) in the Exchange container, given its name. |
private static Manager |
getManager()
|
String |
getPathOfDomain(AdminDomainRef domain_ref)
Retrieves just the domain part of the path name in external form for an administrative domain given the domain reference. |
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. |
void |
setDomainName(AdminDomainRef domainRef,
String newName)
Updates the name of the referenced administrative domain. |
AdminDomainRef |
updateDomain(AdminDomainRef domainRef,
String name,
String description)
Update an administrative domain with the given name and description. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
static final boolean SERVER
private static final String FC_RESOURCE
private static final String CLASSNAME
Constructor Detail |
public AdministrativeDomainManagerFwd()
Method Detail |
private static Manager getManager() throws WTException
WTException
public AdministrativeDomain getDomain(String domain_path) throws WTException
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:
[container-path]/domain-path
(the external form of
the domain path)
Resulting actions for the different input formats:
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.
[container-path]/domain-path
)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.
getDomain
in interface AdministrativeDomainManager
domain_path
- Required. Specifies the administrative domain path or the domain name.
WTException
public AdministrativeDomain getDomain(String domain_path, WTContainerRef container_ref) throws WTException
getDomain
in interface AdministrativeDomainManager
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.
WTException
public String getDomainPath(AdministrativeDomain domain) throws WTException
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: false
getDomainPath
in interface AdministrativeDomainManager
domain
- Required. The administrative domain.
WTException
public String getDomainPath(AdminDomainRef domain_ref) throws WTException
getDomainPath(AdministrativeDomain
domain)
API for more information.
getDomainPath
in interface AdministrativeDomainManager
domain_ref
- Required. The administrative domain reference.
WTException
public String getDisplayDomainPath(AdministrativeDomain domain) throws WTException
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: false
getDisplayDomainPath
in interface AdministrativeDomainManager
domain
- Required. The administrative domain.
WTException
public String getDisplayDomainPath(AdminDomainRef domain_ref) throws WTException
domain_ref
. If the administrative domain
isn't found, null is returned. See the getDisplayDomainPath(AdministrativeDomain
domain)
API for more information.
getDisplayDomainPath
in interface AdministrativeDomainManager
domain_ref
- Required. The administrative domain reference.
WTException
public AdministrativeDomain getGlobalDomain(String name) throws WTException
getGlobalDomain
in interface AdministrativeDomainManager
name
-
WTException
public Enumeration allDomains() throws WTException
allDomains
in interface AdministrativeDomainManager
WTException
public Enumeration allDomains(WTContainerRef container_ref, boolean include_descendent_containers) throws WTException
allDomains
in interface AdministrativeDomainManager
container_ref
- include_descendent_containers
-
WTException
public EnumeratorVector allDomainRefs() throws WTException
allDomainRefs
in interface AdministrativeDomainManager
WTException
public EnumeratorVector allDomainRefs(WTContainerRef container_ref, boolean include_descendent_containers) throws WTException
allDomainRefs
in interface AdministrativeDomainManager
container_ref
- include_descendent_containers
-
WTException
public com.objectspace.jgl.OrderedSet allEvents(Locale locale) throws WTException
allEvents
in interface AdministrativeDomainManager
locale
-
WTException
public SortedSet getAllEvents(Locale locale) throws WTException
getAllEvents
in interface AdministrativeDomainManager
locale
-
WTException
public AdminDomainRef createDomain(AdminDomainRef domainRef, String name, String description) throws WTException, WTPropertyVetoException
createDomain
in interface AdministrativeDomainManager
domainRef
- Domain reference of parent domainname
- Domain namedescription
- Domain description
WTException
WTPropertyVetoException
createDomain(AdminDomainRef, String, String, WTContainerRef)
public AdminDomainRef createDomain(AdminDomainRef domainRef, String name, String description, WTContainerRef container_ref) throws WTException, WTPropertyVetoException
createDomain
in interface AdministrativeDomainManager
domainRef
- name
- description
- container_ref
-
WTException
WTPropertyVetoException
public DomainAdministered changeAdministrativeDomain(DomainAdministered obj, AdminDomainRef domain_ref) throws WTException
PRE_CHANGE_DOMAIN
and POST_CHANGE_DOMAIN
events. Persists and returns the changed object. Throws an AdministrativeDomainException
if the object is not persistent.
changeAdministrativeDomain
in interface AdministrativeDomainManager
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.
WTException
public DomainAdministered changeAdministrativeDomain(DomainAdministered obj, AdminDomainRef domain_ref, boolean inheritedDomain) throws WTException, WTPropertyVetoException
PRE_CHANGE_DOMAIN
and POST_CHANGE_DOMAIN
events. Persists and returns the
changed object. Throws an AdministrativeDomainException
if the object is not persistent.
changeAdministrativeDomain
in interface AdministrativeDomainManager
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
WTException
WTPropertyVetoException
public WTList changeAdministrativeDomain(WTList objs, AdminDomainRef domain_ref, boolean inheritedDomain) throws WTException, WTPropertyVetoException
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: false
changeAdministrativeDomain
in interface AdministrativeDomainManager
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
WTException
WTPropertyVetoException
public WTList changeAdministrativeDomain(WTList objs, WTList domain_refs, boolean inheritedDomain) throws WTException, WTPropertyVetoException
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: false
changeAdministrativeDomain
in interface AdministrativeDomainManager
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
WTException
WTPropertyVetoException
public void delete(AdminDomainRef domain) throws WTException
delete
in interface AdministrativeDomainManager
domain
-
WTException
public ArrayList getAncestorDomains(AdminDomainRef domain_ref) throws WTException
getAncestorDomains
in interface AdministrativeDomainManager
domain_ref
-
WTException
public ArrayList getAncestorDomains(AdminDomainRef domain_ref, boolean includeSiblings) throws WTException
getAncestorDomains
in interface AdministrativeDomainManager
domain_ref
- includeSiblings
-
WTException
public ArrayList getChildDomains(AdminDomainRef domain_ref) throws WTException
getChildDomains
in interface AdministrativeDomainManager
domain_ref
-
WTException
public ArrayList getChildDomains(AdminDomainRef domain_ref, boolean includeChildContainers) throws WTException
getChildDomains
in interface AdministrativeDomainManager
domain_ref
- includeChildContainers
-
WTException
public Hashtable getClassHierarchy(String from_class) throws WTException
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.
Deprecated. Use introspection methods defined by the TypeModel
(package com.ptc.core.meta.type.runtime.server) to get a type hierarchy.
Supported API: false
getClassHierarchy
in interface AdministrativeDomainManager
from_class
-
WTException
public String getDisplayPathOfDomain(AdminDomainRef domain_ref) throws WTException
getDisplayPathOfDomain
in interface AdministrativeDomainManager
domain_ref
- Required. The administrative domain reference.
WTException
public String getPathOfDomain(AdminDomainRef domain_ref) throws WTException
getPathOfDomain
in interface AdministrativeDomainManager
domain_ref
- Required. The administrative domain reference.
WTException
public void setAdministratorRule(AdministrativeDomain domain) throws WTException
setAdministratorRule
in interface AdministrativeDomainManager
domain
-
WTException
public void setAdministratorRule(AdminDomainRef domainRef) throws WTException
setAdministratorRule
in interface AdministrativeDomainManager
domainRef
-
WTException
public void setDomainDescription(AdminDomainRef domainRef, String newDescription) throws WTException, WTPropertyVetoException
setDomainDescription
in interface AdministrativeDomainManager
domainRef
- newDescription
-
WTException
WTPropertyVetoException
public void setDomainName(AdminDomainRef domainRef, String newName) throws WTException, WTPropertyVetoException
setDomainName
in interface AdministrativeDomainManager
domainRef
- newName
-
WTException
WTPropertyVetoException
public AdminDomainRef updateDomain(AdminDomainRef domainRef, String name, String description) throws WTException, WTPropertyVetoException
updateDomain
in interface AdministrativeDomainManager
domainRef
- Domain reference of the domain to updatename
- new domain namedescription
- new domain description
WTException
WTPropertyVetoException
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |